The context links module allows you to easily create links to context-related material using a simple markup syntax. The links are indicated by either linking the text itself or by inserting a specific string or icon that links to the related information.
Site administrators can define different "classes" of context links. Each class can have a specific icon or string that is used for all instances of that class. Additionally, administrators define a default class which will be used if no class is specified.
The syntax to insert context links is as follows:
[?class:URL link text]
or, to use the default class,
[?:URL link text]
Notes:
The table below shows examples of all of the classes currently defined on this site.
| class | new window | input | output |
|---|---|---|---|
| external | Yes | An [?external:filter/tips example external] link. | An example external link. |
| info | No | An [?info:filter/tips example info] link. | An example info link. |
| info-text | No | An [?info-text:filter/tips example info-text] link. | An example info-text [info] link. |
| link *default* | Yes | An [?link:filter/tips example link] link. A [?:filter/tips link] using the default class. | An example link link. A link using the default class. |
| note | No | An [?note:filter/tips example note] link. | An example note link. |
| note-text | No | An [?note-text:filter/tips example note-text] link. | An example note-text [note] link. |
| person | No | An [?person:filter/tips example person] link. | An example person link. |
| person-text | No | An [?person-text:filter/tips example person-text] link. | An example person-text [person] link. |
| question | No | An [?question:filter/tips example question] link. | An example question link. |
| question-text | No | An [?question-text:filter/tips example question-text] link. | An example question-text [?] link. |
| warning | No | An [?warning:filter/tips example warning] link. | An example warning link. |
| warning-text | No | An [?warning-text:filter/tips example warning-text] link. | An example warning-text [warning] link. |
Allowed HTML tags: <br> </p> <p> <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd> <object> <embed> <script>
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 Description | You Type | You Get |
|---|---|---|
| By default line break tags are automatically added, so use this tag to add additional ones. Use of this tag is different because it is not used with an open/close pair like all the others. Use the extra " /" inside the tag to maintain XHTML 1.0 compatibility | Text with <br />line break | Text with line break |
| By default paragraph tags are automatically added, so use this tag to add additional ones. | <p>Paragraph one.</p> <p>Paragraph two.</p> | Paragraph one. Paragraph two. |
| Anchors are used to make links to other pages. | <a href="http://www.naspa.com">NaSPA</a> | NaSPA |
| 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> |
|
| Ordered list - use the <li> to begin each list item | <ol> <li>First item</li> <li>Second item</li> </ol> |
|
| 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> |
|
| No help provided for tag object. | ||
| No help provided for tag embed. | ||
| No help provided for tag script. | ||
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 & for an ampersand & character. For a full list of entities see HTML's entities page. Some of the available characters include:
| Character Description | You Type | You Get |
|---|---|---|
| Ampersand | & | & |
| Greater than | > | > |
| Less than | < | < |
| Quotation mark | " | " |
You can use <object>, <embed> and <script> tags from the following sites to add media to your posts:
You may quickly link to image nodes using a special syntax. Each image code will be replaced by thumbnail linked to full size image node. Syntax:
[image:node_id align=alignment hspace=n vspace=n border=n size=label width=n height=n nolink=(0|1) class=name style=style-data node=id]
Every parameter except node_id is optional.
Typically, you will specify one of size, width, or height, or none of them. If you use size=label, where label is one of the image size labels specified on the image settings page, the size associated with that label will be used. The sizes "thumbnail", "preview", and "original" are always available. If you use width=n or height=n, the image will be scaled to fit the specified width or height. If you use none of them, the thumbnail image size will be used.
If you specify nolink=1, no link will be created to the image node. The default is to create a link to the image.
Alternatively, if you specify node=id, a link will be created to the node with the given id.
The align, hspace, vspace, border, class, and style parameters set the corresponding attributes in the generated img tag.
Quoted content can be placed between [quote] tags in order to be displayed as an indented quote. Every [quote] tag must have a corresponding [/quote] tag. For example:
[quote]This is a simple quote.[/quote]is displayed as:
Additionally, there is an optional attribute which allows quotes to specify the original author.
[quote=Mr. Drupal]This is a quote with an attribution line.[/quote]
is displayed as:
Finally, multiple [quote] tags can be nested within one another. Just remember that every [quote] tag must have a corresponding [/quote] tag.
[quote]I think she says it best...
[quote=Ms. Quotation]This is a quote nested within another quote.[/quote]
but you can't argue with
[quote=Ms. Reply]The more quotes, the merrier.
Just don't get too carried away.[/quote]
And I have nothing more to say.[/quote] is displayed as:
[weblink:node_id] (to use the first link for that node), [weblink:node_id/link_id] (to use a specific link for that node) or [weblink:http://a.weblink.example.com/] (to specify a raw URL).