Help:Tags
From QED
| Help |
|
| Related topics |
On this web site, text markup can be accomplished both by using "wikimarkup" and by using tags.
Wikimarkup is designed to be easy to read and to write and is generally to be preferred over more complex alternatives. Sometimes, however, HTML or similar special-purpose tags are needed, for example for footnotes and complex mathematical formulae.
Contents |
Basic Tags
To specify that some text is to be processed in a special way, the text is enclosed by a start tag and an end tag, as illustrated by the following line using a fictitious label "tagName":
<tagName>Some text to be processed</tagName>
For example:
| Content creation should not be recondite.<ref>Brendan Eich, Innovators of the Net.</ref> |
If the sole purpose of a tag is to provide a directive, a single tag of the form <tagName/> may be specified. For example, to signal the position of all pending footnotes, one might write:
==Footnotes== <references/>
HTML Tags
The use of unrestricted HTML raises certain privacy and security issues and a distinction is therefore drawn between "safe" and "potentially unsafe" HTML:
- "Safe" HTML can be used in an unrestricted way. A list of safe HTML tags is provided here.
- "Unsafe" HTML must be enclosed within an "html" tag as illustrated in the following:
| <html><script>alert("Hello")</script></html> |
This allows the QED administrators to disable the processing of unsafe HTML should security considerations so require.
Special-Purpose Tags
The list of special-purpose tags that are available on QED is growing over time as additional modules are added. Here is the current list:
| Tag | Further Details | Comment |
|---|---|---|
| <nowiki> | [1] | Wiki markup between the nowiki start and end tags is left as-is |
| <categorytree> | CategoryTree | AJAX-based browser of category hierarchy |
| <ref> | Cite | Create a footnote |
| <references> | Cite | Insert pending footnotes |
| <gallery> | Gallery | Create a gallery of images |
| <gnuplot> | Gnuplot | Works with inline or uploaded data |
| <math> | Math | TeX markup for mathematical formulae |
| <googlemap> | Googlemap | Embed a Google Map |
| <googlevideo> | Video | Embed a Google video using Flash. |
| <graphviz> | Graphviz | Markup for generating graphs with hot spots defined as hyperlinks |
| <calendar> | Calendar | Calendar with hyperlinks and support for a iframes. |
| <flash> | QED:Flash | View uploaded .swf Flash files |
| <gflash> | QED:Gflash | View .swf Flash files using an http: URL |
| <flyover> | flyover | Flyover images (images that appear when the cursor hovers over a
hotspot |
| <image> | QED:image | a single tag for both internal and external images |
| <jmol> | Jmol | view 3D images of molecules interactively and stereoscopically |
| <kmz> | QED:KMZ | a tag for use with Google Earth and Google Maps |
| <memorize> | Memorize | Create an interactive flashcard quiz or memory game. |
| <mov> | mov | Embed QuickTime video |
| <ram> | ram | Embed RealMedia video |
| <sharethis> | Share this |           
|
| <DPL> | QED:Dynamic Page List | A simple query language for finding QED pages matching namespace/category criteria |
| <ListSubPages> | QED:List Subpages | List the subpages of a top-level page. Use Template:ls |
In addition, the following tags are currently supported but may be temporarily disabled if security considerations so require:
- the <javascript> tag for executing Javascript — see Help:Javascript;
- the <php> tag for executing PHPwp (currently restricted to protected pages) — see phpinfo for an example.
Tags in Templates
To define a template using a tag containing template variables, the #macro parser function should be used.
