Compose tips

input formats:
  • Filtered HTML:
    • Web page addresses and e-mail addresses turn into links automatically.

    • Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>

      This site allows HTML content. While learning all of HTML may feel intimidating, learning how to use a very small number of the most basic HTML "tags" is very easy. This table provides examples for each tag that is enabled on this site.

      For more information see W3C's HTML Specifications or use your favorite search engine to find other sites that explain HTML.

      Tag DescriptionYou TypeYou Get
      Anchors are used to make links to other pages.<a href="http://www.bensommer.com">BenSommer.com</a>BenSommer.com
      Emphasized<em>Emphasized</em>Emphasized
      Strong<strong>Strong</strong>Strong
      Cited<cite>Cited</cite>Cited
      Coded text used to show programming source code<code>Coded</code>Coded
      Unordered list - use the <li> to begin each list item<ul> <li>First item</li> <li>Second item</li> </ul>
      • First item
      • Second item
      Ordered list - use the <li> to begin each list item<ol> <li>First item</li> <li>Second item</li> </ol>
      1. First item
      2. Second item
      Definition lists are similar to other HTML lists. <dl> begins the definition list, <dt> begins the definition term and <dd> begins the definition description.<dl> <dt>First term</dt> <dd>First definition</dd> <dt>Second term</dt> <dd>Second definition</dd> </dl>
      First term
      First definition
      Second term
      Second definition

      Most unusual characters can be directly entered without any problems.

      If you do encounter problems, try using HTML character entities. A common example looks like &amp; for an ampersand & character. For a full list of entities see HTML's entities page. Some of the available characters include:

      Character DescriptionYou TypeYou Get
      Ampersand&amp;&
      Greater than&gt;>
      Less than&lt;<
      Quotation mark&quot;"
    • Lines and paragraphs are automatically recognized. The <br /> line break, <p> paragraph and </p> close paragraph tags are inserted automatically. If paragraphs are not recognized simply add a couple blank lines.

    • SWF Tools Filter

      The basic syntax for embedding a flash file (.swf), flash movie (.flv) or audio file (.mp3) is:

      [swf file="filename.swf"]

      If you would like to override SWF Tools and flash player default settings, you can specify additional parameters. For example:

      [swf file="song.mp3" flashvars="backcolor=#AABBCC&&forecolor=#11AA11"]

      If you would like to output a list of files then the format is:

      [swf files="image1.jpg&&image2.jpg&&..."]
      SWF Tools Filter will accept following:
      • params : You can specify values for parameters to be passed to Flash to control the appearance of the output. Typical values are bgcolor and wmode. Example: params="wmode=true&&bgcolor="#00FF00" Alternatively you can supply each parameter individually without using params. Example wmode="true" bgcolor="#00FF00"
      • flashvars : You can specify values for output as flashvars, which become available to the Flash movie that is playing. This is often done to control a media player. Refer to the documentation of the flash player you are using to know what flashvar options are available. Example: flashvars="autostart=true&&volume=80"
      • methods : Optional information about how to display the file. The most common usage is to specify a particular media player and thus override the default specified on the settings page. Example: methods="player=onepixelout_mp3"

      WARNING: with params, flashvars and othervars, pass multiple values separated by &&.

  • Filtered HTML - no line breaks:
    • Web page addresses and e-mail addresses turn into links automatically.

    • Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>

      This site allows HTML content. While learning all of HTML may feel intimidating, learning how to use a very small number of the most basic HTML "tags" is very easy. This table provides examples for each tag that is enabled on this site.

      For more information see W3C's HTML Specifications or use your favorite search engine to find other sites that explain HTML.

      Tag DescriptionYou TypeYou Get
      Anchors are used to make links to other pages.<a href="http://www.bensommer.com">BenSommer.com</a>BenSommer.com
      Emphasized<em>Emphasized</em>Emphasized
      Strong<strong>Strong</strong>Strong
      Cited<cite>Cited</cite>Cited
      Coded text used to show programming source code<code>Coded</code>Coded
      Unordered list - use the <li> to begin each list item<ul> <li>First item</li> <li>Second item</li> </ul>
      • First item
      • Second item
      Ordered list - use the <li> to begin each list item<ol> <li>First item</li> <li>Second item</li> </ol>
      1. First item
      2. Second item
      Definition lists are similar to other HTML lists. <dl> begins the definition list, <dt> begins the definition term and <dd> begins the definition description.<dl> <dt>First term</dt> <dd>First definition</dd> <dt>Second term</dt> <dd>Second definition</dd> </dl>
      First term
      First definition
      Second term
      Second definition

      Most unusual characters can be directly entered without any problems.

      If you do encounter problems, try using HTML character entities. A common example looks like &amp; for an ampersand & character. For a full list of entities see HTML's entities page. Some of the available characters include:

      Character DescriptionYou TypeYou Get
      Ampersand&amp;&
      Greater than&gt;>
      Less than&lt;<
      Quotation mark&quot;"

    • Linodef

      Linodef is a filter for internal links. It uses a simple but unique markup so Linodef doesn't interfere with other filter modules.
      The ID of a node or of a taxonomy term and optionally a fieldname are the solely elements stored in your text. One advantage of this method in comparison to similar filter modules is the fact that the links don't break if you change the node title or term name. Furthermore, if you change the title of the node or the value of a field or the name of a term then those are automatically updated in your text, too.

      Embed elements

      To embed elements into your text, prepend the element ID with the hash key # and surround them by brackets []: [#ID]. That way a node title is inserted and linked. To embed the content of a field, add the field name: [#ID:field_name]. Moreover it is possible to add a field value number in the case you have a field with multiple values and want to use a different value than the first: [#ID:field_name:number].

      The syntax is as following:

      Tag DescriptionYou TypeYou Get
      Embed node title and link to the node.[#ID]node title
      Embed field value and link to the node.[#ID:field_name]field value
      Embed field value and link to the node.[#ID:field_name:field_value_number]certain field value of a multiple values field

      Example for nodes and fields:

      We have a node with id=8 and a title Perry Rhodan. It contains a multiple value field called firstnames. The first value is Gucky, second is Atlan. Note that the field value numbers start at 0, so first value has number "0", second has number "1" etc. If the node has a path alias then the link contains this instead of the default drupal path (the examples are limited to the default paths).
      You TypeYou Get
      [#8]Perry Rhodan
      [#8:field_firstnames]Gucky
      [#8:field_firstnames:0]Gucky
      [#8:field_firstnames:1]Atlan

      Alter embedding by tag options

      Options set the ID type (embedded element type) and the embed method. They are entered right after the ID or the field settings and are separated by a comma. The number of options a tag can have is not limited.

      Tag DescriptionYou TypeYou Get
      Embed an element with options.[#ID,option1,option2="optionvalue",...]Depends on the options used.
      Embed a field value with options.[#ID:field_name,option1,option2="optionvalue",...]Depends on the options used.
      Embed a certain field value with options.[#ID:field_name:field_value_number,option1,option2="optionvalue",...]Depends on the options used.

      Example for element (ID) type and modification options:

      Here we use the modification "nolink" to have an output without a link to the element and the ID type option "tid" to embed a taxonomy term instead of a node. The taxonomy term has the id=5 and the name Jupiter. If the term has a path alias then the link contains this instead of the default drupal path (the example is limited to the default path). Furthermore we have a node (optional option "nid") with id=5 and the title Kallisto.

      You TypeYou Get
      [#5,tid]Jupiter
      [#5,tid,nolink]Jupiter
      [#5,nid,nolink]Kallisto
      [#5,nolink]Kallisto

      Use comments to flag your tags for editors

      Comments act as an indicator for Linodef tags, to describe your tag for yourself or other editors. A comment can be inserted inside the tag prepended with a space and it may consist of all UTF-8 characters except the closing bracket ].

      Comments are visible only during editing and never appear by viewing a text. The nature of comments is that they must not modified automatically and therefore will not change unless you change it. This is important to understand since the content the tag displays can change automatically and so the comment may be outdated. So try to use a common description.

      Tag DescriptionYou TypeYou Get
      Use comments to give information about the tag during editing.[#ID comment]node title
      Comment a field content.[#ID:field_name:field_value_number comment]node title
      Comments work together with options.[#ID:field_name:field_value_number,option1,option2="optionvalue",... comment]Depends on the options used.

      Create links with own linktext

      Use the option "linktext" to create links to elements using a custom text: [#ID,linktext="your Text"]

      Example:

      You TypeYou Get
      [#8,linktext="your Text"]your Text
    • Internal paths in double quotes, written as "internal:node/99", for example, are replaced with the appropriate absolute URL or relative path. Given a site located at http://example.com/mysite, assuming clean URLs are enabled and "internal:admin/user" becomes "http://example.com/mysite/admin/user" and "internal:node/99" becomes "http://example.com/mysite/node/99". If 'node/99' has a URL alias assigned, such as 'news/latest' the alias will be substituted giving "http://example.com/mysite/news/latest".

    • SWF Tools Filter

      The basic syntax for embedding a flash file (.swf), flash movie (.flv) or audio file (.mp3) is:

      [swf file="filename.swf"]

      If you would like to override SWF Tools and flash player default settings, you can specify additional parameters. For example:

      [swf file="song.mp3" flashvars="backcolor=#AABBCC&&forecolor=#11AA11"]

      If you would like to output a list of files then the format is:

      [swf files="image1.jpg&&image2.jpg&&..."]
      SWF Tools Filter will accept following:
      • params : You can specify values for parameters to be passed to Flash to control the appearance of the output. Typical values are bgcolor and wmode. Example: params="wmode=true&&bgcolor="#00FF00" Alternatively you can supply each parameter individually without using params. Example wmode="true" bgcolor="#00FF00"
      • flashvars : You can specify values for output as flashvars, which become available to the Flash movie that is playing. This is often done to control a media player. Refer to the documentation of the flash player you are using to know what flashvar options are available. Example: flashvars="autostart=true&&volume=80"
      • methods : Optional information about how to display the file. The most common usage is to specify a particular media player and thus override the default specified on the settings page. Example: methods="player=onepixelout_mp3"

      WARNING: with params, flashvars and othervars, pass multiple values separated by &&.