| | Text Formatting FAQ
The most frequently asked questions about text formatting are answered. Also, TextFormattingRules contains the complete TWiki shorthand system on one quick reference page. |
| |
How do I make a separator? |
|
<
< | You can make a horizontal separator by entering three dashes at the beginning of a line: ---. |
>
> | Create a separator - a horizontal rule - by entering three dashes at the beginning of a blank line: ---. You can enter more than three if you like, for a more visible separator in edit mode:
-------------- |
| | |
|
<
< |
|
>
> |
|
| | How do I create a heading?
You can create six sizes of headings - <h1>...<h6> in HTML - by typing, from the beginning of a line, three dashes (-), from one to six plus signs (+), a space, and your heading text. The FAQ questions on this page are created with: ---+++ Have a question?. |
| |
Text enclosed in angle brackets like <filename> is not displayed. How can I show it as it is? |
|
<
< | TWiki interprets text as HTML. The '<' and '>' characters are used to define HTML commands. Text contained in angle brackets is interpreted by the browser if it's a valid HTML instruction, or ignored if it isn't - either way, the brackets and its contents are not displayed. |
>
> | TWiki interprets text as HTML, and the '<' and '>' characters define where HTML commands start and end. Text inside angle brackets is treated as HTML, and ignored if it doesn't actually do anything - either way, the brackets and its contents are not displayed. |
| | If you want to display angle brackets, enter them as HTML codes instead of typing them in directly: |
| |
Text I enter gets wrapped around. How can I keep the formatting as it is? |
|
<
< | TWiki interprets text as HTML, so you can use the preformatted HTML text option to keep the new line of text as is. Enclose the text in <pre> </pre>, or in TWiki's own <verbatim> </verbatim> tags: |
>
> | TWiki interprets text as HTML, so you can use the preformatted HTML option to keep the new line of text as is. Enclose the text in <pre> </pre>, or in TWiki's own <verbatim> </verbatim> tag: |
| |
This text will keep its format as it is:
<verbatim>
|
| | </verbatim>
|
|
<
< | The pre tag is standard HTML; verbatim is a special TWiki tag that also forces text to fixed font mode, and also prevents other tags and TWiki shortcuts from being expanded. |
>
> | The pre tag is standard HTML; verbatim is a special TWiki tag that forces text to fixed font mode, and also prevents other tags and TWiki shortcuts from being expanded. |
| |
How do I create tables? |
| | See "Text enclosed..."
|
|
<
< | Can I include images and pictures? |
>
> | Can I include images on a page? |
| | |
|
<
< | Yes, this is possible. The easiest way of including images is to attach a GIF, JPG or PNG file to a topic and then to include it with text %ATTACHURL%/myImage.gif . FileAttachment has more. |
>
> | Yes. The easiest way is to attach a GIF, JPG or PNG file to a topic and then to place it with: %ATTACHURL%/myImage.gif. This works only for the page that the image is attached to. |
| | |
|
<
< | There are actually two ways of including inline images. |
>
> | To place an image on any page, ther are two ways of including inline images. |
| | 1. Using URL ending in .gif, .jpg, .jpeg, .png |
|
<
< | This is a simple and automatic way of including inline images. Simply write the URL of the image file, this will create the inline image for you. Note: The images must be accessible as a URL. |
>
> | This is a simple and automatic way of including inline images. Simply write the URL of the image file, this will create the inline image for you. NOTE: The images must be accessible as a URL. |
| |
- You enter:
TWiki http://moglen.law.columbia.edu/twiki/pub/wikiHome.gif logo.
Result: TWiki  logo.
|
|
>
> |
You can upload images directly to your server with FTP access. You can also attach image files to a topic - you could even create a dedicated image topic, like ImageLibrary - and then link to the images directly:
- Attach
pic.gif to Someweb.SomeTopic
Display with http://moglen.law.columbia.edu/twiki/pub/Someweb/SomeTopic/pic.gif
|
| | 2. Using <img> tag |
|
<
< | This is a manual process where you have more control over the rendering of the image. Use the <img> tag of HTML to include GIF, JPG and PNG files. Note: The display of the topic is faster if you include the WIDTH and HEIGHT parameters that have the actual image size. http://www.htmlhelp.com/reference/wilbur/special/img.html has more on inline images. |
>
> | This is a manual process where you have more control over the rendering of the image. Use the <img> tag of HTML to include GIF, JPG and PNG files. Note: The display of the topic is faster if you include the WIDTH and HEIGHT parameters that have the actual image size. http://www.htmlhelp.com/reference/wilbur/special/img.html has more on inline images. |
| | |
|
<
< |
- You enter:
TWiki <img src="http://moglen.law.columbia.edu/twiki/pub/wikiHome.gif" width="46" height="50" /> logo.
Result:
TWiki logo.
|
>
> |
- You enter:
TWiki <img src="http://moglen.law.columbia.edu/twiki/pub/wikiHome.gif" width="46" height="50" border="0" alt="logo" /> logo.
Result:
TWiki logo.
|
| |
Can I write colored text? |
|
<
< | Sure. The quickest way is to use the <font color="colorCode"> and </font> tags - they're HTML tags that work in any browser, (although they've been phased in the latest version). |
>
> | Sure. The quickest way is to go <font color="colorCode">colorize</font> - font is an HTML tag that works in any browser, although it's been phased out in the latest HTML specs. |
| | |
|
<
< | You can also use a style attribute: style="color:#ff0000", placed in most HTML tags - span is an all-purpose choice: "<span style="color:#ff0000">. |
>
> | You can also use the up-to-date style attribute - ex: style="color:#ff0000" - placed in most HTML tags. span is an all-purpose choice: "<span style="color:#ff0000">CoLoR</span>. Only old (like 3.x IE & NS) browsers have a problem with style. |
| | "colorCode" is the hexadecimal RGB color code, which is simply Red, Green and Blue values in hex notation (base 16, 0-F). For pure red, the RGB components are 255-0-0 - full red (255), no green or blue. That's FF-0-0 in hex, or "#ff000=" for Web page purposes. For a basic color selection (you can StandardColor names instead of hex code in the =font tag only): |
logo.