Working in TWiki is as easy as typing in text - exactly like email. You don't need to know HTML, though you can use it if you prefer. Links to topics are created automatically when you enter a WikiWord. And TWiki shorthand gives you all the power of HTML with a simple coding system that takes no time to learn. It's all laid out below - refer back to this page in a pop-up window from the Edit screen.
Formatting Command: | Example: You write: | You get: | |||||||||||||||
Paragraphs: Blank lines will create new paragraphs. |
1st paragraph |
1st paragraph
2nd paragraph |
|||||||||||||||
Headings: At least three dashes at the beginning of a line, followed by plus signs and the heading text. One plus creates a level 1 heading (most important), two pluses a level 2 heading; the maximum is level 6. Note: A Table of Content can be created automatically with the % |
|
SushiMaguro |
|||||||||||||||
Bold Text: Words get bold by enclosing them in * asterisks. |
*Bold* | Bold | |||||||||||||||
Italic Text: Words get italic by enclosing them in _ underscores. |
_Italic_ | Italic | |||||||||||||||
Bold Italic: Words get bold italic by enclosing them in _ double-underscores. |
__Bold italic__ | Bold italic | |||||||||||||||
Fixed Font: Words get shown in fixed font by enclosing them in |
=Fixed font= | Fixed font | |||||||||||||||
Bold Fixed Font: Words get shown in bold fixed font by enclosing them in |
==Bold fixed== | Bold fixed | |||||||||||||||
Note: Make sure to "stick" the * _ = |
_This works_, _this not _ | This works, _this not _ | |||||||||||||||
Verbatim Mode: Surround code excerpts and other formatted text with <verbatim> and </verbatim> tags. Note: Use <pre> and </pre> tags instead if you want that HTML code is interpreted. Note: Each tag must be on a line by itself. |
<verbatim> class CatAnimal { void purr() { <code here> } } </verbatim> |
class CatAnimal { void purr() { <code here> } } |
|||||||||||||||
Separator: At least three dashes at the beginning of a line. |
------- |
|
|||||||||||||||
List Item: Three spaces and an asterisk. |
* bullet item |
|
|||||||||||||||
Nested List Item: Six, nine, ... spaces and an asterisk. |
* nested stuff |
|
|||||||||||||||
Ordered List: Three spaces and a number. |
1 Sushi 1 Dim Sum |
|
|||||||||||||||
Definition List: Three spaces, the term, a colon, a space, followed by the definition. Note: Terms with spaces are not supported. In case you do have a term with more then one word, separate the words with dashes or with the non-breaking-space entity. |
Sushi: Japan Dim Sum: S.F. |
|
|||||||||||||||
Table: Optional spaces followed by the cells enclosed in vertical bars. Note: | Note: | spaced | cells are rendered center aligned. Note: | spaced | cells are rendered right aligned. Note: | 2 colspan || cells are rendered as multi-span columns. Note: In case you have a long row and you want it to be more readable when you edit the table you can split the row into lines that end with a '\' backslash character. |
| *L* | *C* | *R* | | A2 | 2 | 2 | | A3 | 3 | 3 | | multi span ||| | A4 | next | next | |
|
|||||||||||||||
WikiWord Links: Note: In case you want to link to a topic in a different PodWiki web write Webname.TopicName. |
WebNotify |
WebNotify?
Know.ReadmeFirst? |
|||||||||||||||
Forced Links: You can create a forced internal link by enclosing words in double square brackets. Note: You can also refer to anchors. |
[[PodWikiFormatterTWiki]] | PodWikiFormatterTWiki | |||||||||||||||
Specific Links: Create a link where you can specify the link text and the link reference separately, using nested square brackets like [ Note: The same Forced Links rules apply for internal link references. Note: For external link references, you can simply use a space instead of ][ to separate the link URL from the descriptive text. Note: Anchor names can be added as well, like [ |
[[PodWikiFormatterTWiki][TWiki Formatter]] | TWiki Formatter | |||||||||||||||
Anchors: You can define a link reference inside a PodWiki topic (called an anchor name) and link to that. To define an anchor write #AnchorName at the beginning of a line. The anchor name must be a WikiWord. To link to an anchor name use the [ |
[[WebHome#NotThere]] | WebHomeWebHome?" href="podwiki?page=WebHome&state=edit&inherit=PodWikiFormatterTWiki#NotThere">? | |||||||||||||||
Prevent a Link: Prevent a WikiWord from being linked by prepending it with the <nop> tag. |
<nop>SunOS |
|
|||||||||||||||
Disable Links: You can disable automatic linking of a WikiWord by surrounding text with <noautolink> and </noautolink> tags. Note: Each tag must be on a line by itself. Note: This also works for TWiki tables, but only if you add a blank line between the end of the table and the closing </noautolink> tag. |
<noautolink> RedHat & SuSE </noautolink> |
|
|||||||||||||||
Mailto: Links: To create 'mailto:' links that have more descriptive link text, specify subject lines or message bodies, or omit the email address, you can write [ |
[[mailto:a@z.com Mail]] | a@z.com |
You can use just about any HTML tag without a problem - however, there are a few usability and technical considerations to keep in mind:
Being able to create links without any formatting required is a core wiki feature, made possible with WikiWord
Variables are names that are enclosed in percent signs % that are expanded on the fly.
TWiki plugins are not supported under
%PLUGINNAME{"Parameter1","Parameter2",...}%If such a call is encountered in a page, it will be rendered as plain text.
TWiki formatting rules are fairly simple to use and quick to type. However, there are some things to watch out for: