data/TWiki/TextFormattingFAQ.txt,v
author Colas Nahaboo <colas@nahaboo.net>
Sat, 26 Jan 2008 15:50:53 +0100
changeset 0 414e01d06fd5
permissions -rw-r--r--
RELEASE 4.2.0 freetown
     1 head	1.20;
     2 access;
     3 symbols;
     4 locks; strict;
     5 comment	@# @;
     6 
     7 
     8 1.20
     9 date	2008.01.22.03.21.23;	author TWikiContributor;	state Exp;
    10 branches;
    11 next	1.19;
    12 
    13 1.19
    14 date	2006.04.01.05.55.17;	author TWikiContributor;	state Exp;
    15 branches;
    16 next	1.18;
    17 
    18 1.18
    19 date	2006.02.01.12.01.20;	author TWikiContributor;	state Exp;
    20 branches;
    21 next	1.17;
    22 
    23 1.17
    24 date	2004.08.15.21.42.19;	author PeterThoeny;	state Exp;
    25 branches;
    26 next	1.16;
    27 
    28 1.16
    29 date	2004.03.17.06.43.22;	author PeterThoeny;	state Exp;
    30 branches;
    31 next	1.15;
    32 
    33 1.15
    34 date	2003.08.22.05.19.29;	author PeterThoeny;	state Exp;
    35 branches;
    36 next	1.14;
    37 
    38 1.14
    39 date	2003.01.09.04.59.29;	author PeterThoeny;	state Exp;
    40 branches;
    41 next	1.13;
    42 
    43 1.13
    44 date	2002.06.28.08.07.00;	author PeterThoeny;	state Exp;
    45 branches;
    46 next	1.12;
    47 
    48 1.12
    49 date	2002.02.22.08.42.00;	author PeterThoeny;	state Exp;
    50 branches;
    51 next	1.11;
    52 
    53 1.11
    54 date	2002.02.22.06.16.13;	author PeterThoeny;	state Exp;
    55 branches;
    56 next	1.10;
    57 
    58 1.10
    59 date	2001.09.15.05.12.41;	author MikeMannix;	state Exp;
    60 branches;
    61 next	1.9;
    62 
    63 1.9
    64 date	2001.09.14.02.09.03;	author MikeMannix;	state Exp;
    65 branches;
    66 next	1.8;
    67 
    68 1.8
    69 date	2001.09.13.08.44.04;	author PeterThoeny;	state Exp;
    70 branches;
    71 next	1.7;
    72 
    73 1.7
    74 date	2001.09.10.07.20.37;	author MikeMannix;	state Exp;
    75 branches;
    76 next	1.6;
    77 
    78 1.6
    79 date	2001.09.07.04.04.37;	author MikeMannix;	state Exp;
    80 branches;
    81 next	1.5;
    82 
    83 1.5
    84 date	2000.11.10.02.17.09;	author PeterThoeny;	state Exp;
    85 branches;
    86 next	1.4;
    87 
    88 1.4
    89 date	2000.08.18.07.50.29;	author PeterThoeny;	state Exp;
    90 branches;
    91 next	1.3;
    92 
    93 1.3
    94 date	2000.02.09.03.37.45;	author PeterThoeny;	state Exp;
    95 branches;
    96 next	1.2;
    97 
    98 1.2
    99 date	99.08.09.06.38.25;	author PeterThoeny;	state Exp;
   100 branches;
   101 next	1.1;
   102 
   103 1.1
   104 date	99.06.13.07.43.27;	author thoeny;	state Exp;
   105 branches;
   106 next	;
   107 
   108 
   109 desc
   110 @none
   111 @
   112 
   113 
   114 1.20
   115 log
   116 @buildrelease
   117 @
   118 text
   119 @%META:TOPICINFO{author="TWikiContributor" date="1197351701" format="1.1" version="20"}%
   120 ---++ Text Formatting FAQ
   121 
   122 The most frequently asked questions about text formatting are answered. Also, TextFormattingRules contains the complete TWiki shorthand system on one quick reference page.
   123 
   124 %TOC%
   125 
   126 ---
   127 ---+++ How do I make a separator?
   128 
   129 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: <br />
   130 =--------------=
   131 
   132 --------------
   133 ---+++ How do I create a heading?
   134 
   135 You can create six sizes of headings - &lt;h1&gt;...&lt;h6&gt; 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?=.
   136    * You can insert a nested table of contents, generated from headings, by placing =%<nop>TOC%= wherever you like on a page (see %SYSTEMWEB%.TWikiVariables for more =%<nop>TOC%= options).
   137 
   138 -----
   139 #TextEnclosed
   140 ---+++ Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?
   141 
   142 TWiki interprets text as HTML, and the '&lt;' and '&gt;' 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.
   143 
   144 If you want to display angle brackets, enter them as HTML codes instead of typing them in directly:
   145    * =&amp;lt;= = =&lt;= <br />
   146      =&amp;gt;= = =&gt;=
   147 
   148    * __You enter:__ =(a &amp;gt; 0)= <p /> 
   149      __Result:__ =(a &gt; 0)=
   150 
   151 ---
   152 ---+++ Some words appear highlighted, with a "?" link at the end. How can I prevent that?
   153 
   154 A question mark after a word is a link to a topic that doesn't yet exist - click it to create the new page. This is a TWiki feature - typing a MeaningfulTitle in a comment is an invitation for someone else to add a new branch to the topic.  
   155 
   156 To prevent auto-linking - say you want to enter a word like <nop>JavaScript - prefix the WikiStyleWord with an exclamation point: 
   157 
   158    * =!WikiStyleWord= displays as !WikiStyleWord
   159 
   160 ---
   161 ---+++ How do I start a word with an exclamation mark?
   162 
   163 A leading exclamation point is used to escape wiki formatting, as we have learned in the previous question. Sometimes it has an unwanted effect, such as when you want to write "!=" (e.g. "not equal"), you will not see the exclamation mark.
   164 
   165 To escape the exclamation mark escape, try prefixing a =&lt;nop>=, e.g. write =A &lt;nop>!=<nop> B= to get "A <nop>!= B". Alternatively, use the HTML entity =&amp;#33;=, which renders as an exclamation mark, e.g. write =A &amp;#33;=<nop> B= to get "A &#33;= B". 
   166 
   167 ---
   168 ---+++ How can I write fixed font text?
   169 
   170 The quickest way is to enclose the text in equal signs:
   171 
   172    * __You enter:__ =Proportional text, <nop>=fixed font=<nop>, proportional again.= <p />
   173      __Result:__ Proportional text, =fixed font=, proportional again.
   174 
   175 ---
   176 #VerbatimText
   177 ---+++ Text I enter gets wrapped around. How can I keep the formatting as it is?
   178 
   179 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 &lt;pre&gt; &lt;/pre&gt;, or in TWiki's own &lt;verbatim&gt; &lt;/verbatim&gt; tag:
   180 <pre>
   181 This text will keep its format as it is:
   182 &lt;verbatim&gt;
   183   Unit     Price   Qty  Cost
   184   -------  ------  ---  ------
   185   aaa       12.00    3   36.00
   186 &lt;/verbatim&gt;
   187 </pre>
   188 
   189 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.
   190 
   191 __NOTE:__ VARIABLES are still Set within verbatim tags (this is a historical peculiarity)
   192 
   193 __NOTE:__ The =verbatim= opening and closing tags are converted into =pre= tags; any HTML attributes (e.g., =class=, =id=) in the opening =verbatim= tag are included in the corresponding =pre= tag.
   194 
   195 ---
   196 ---+++ How do I create tables?
   197 
   198 There are three possibilities:
   199    1 Use Wiki rule with "|" vertical bars.
   200    2 Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags.
   201    3 Use preformatted text with &lt;verbatim&gt; tags.
   202 
   203 *1. Use Wiki rule with "|" vertical bars*
   204 
   205    * Example text: %BR%
   206      =| cell A1 | cell B1 | cell C1 |= %BR%
   207      =| cell A2 | cell B2 | cell C2 |=
   208    * Example output: 
   209      | cell A1 | cell B1 | cell C1 |
   210      | cell A2 | cell B2 | cell C2 |
   211 
   212 *2. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags*
   213 
   214 This is a manual process using HTML commands. 
   215 
   216 __You enter:__
   217 
   218 <pre>
   219 &lt;table border="1"&gt;
   220   &lt;tr&gt;
   221     &lt;th&gt; Head A  &lt;/th&gt; &lt;th&gt; Head B  &lt;/th&gt;
   222   &lt;/tr&gt;&lt;tr&gt;
   223     &lt;td&gt; Cell A2 &lt;/td&gt; &lt;td&gt; Cell B2 &lt;/td&gt;
   224   &lt;/tr&gt;&lt;tr&gt;
   225     &lt;td&gt; Cell A3 &lt;/td&gt; &lt;td&gt; Cell B3 &lt;/td&gt;
   226   &lt;/tr&gt;
   227 &lt;/table&gt;
   228 </pre>
   229 
   230 __Result:__
   231 
   232 <table border="1">
   233   <tr>
   234     <th> Head A  </th> <th> Head B  </th>
   235   </tr><tr>
   236     <td> Cell A2 </td> <td> Cell B2 </td>
   237   </tr><tr>
   238     <td> Cell A3 </td> <td> Cell B3 </td>
   239   </tr>
   240 </table>
   241 
   242 *3. Use preformatted text with &lt;verbatim&gt; tags*
   243 
   244 See [[#VerbatimText]["Text I enter gets wrapped around..."]] 
   245 
   246 
   247 ---
   248 
   249 ---+++ Can I include images on a page?
   250 
   251 Yes. The easiest way is to [[FileAttachment][attach]] a GIF, JPG or PNG file to a topic and then to place it with: =%<nop>ATTACHURL%/myImage.gif=. This works only for the topic where the image is attached to.
   252 
   253 To place an image on any topic, there are two ways of including inline images.
   254 
   255 *1. Using URL ending in .gif, .jpg, .jpeg, .png*
   256 
   257 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 [[#ImgUpload][accessible]] as a URL.
   258 
   259    * __You enter:__ <code> %<nop>PUBURL%/%SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif logo.</code> <br />
   260      __Result:__ %PUBURL%/%SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif logo.
   261 
   262 #ImgUpload
   263 You can upload images directly to your server with FTP access. You can also [[FileAttachment][attach]] image files to a topic - you could even create a dedicated image topic, like =ImageLibrary= - and then link to the images directly:
   264    * Attach =pic.gif= to =Someweb.SomeTopic= <br />
   265      Display with =%<nop>PUBURL%/Someweb/SomeTopic/pic.gif=
   266 
   267 *2. Using &lt;img&gt; tag*
   268 
   269 This is a manual process where you have more control over the rendering of the image. Use the &lt;img&gt; tag of HTML to include GIF, JPG and PNG files. __Note:__ The rendering 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.
   270 
   271    * __You enter:__ <code> &lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /&gt; logo.</code><br />
   272     __Result:__ <br /> <img src="%PUBURLPATH%/%SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /> logo.
   273 
   274 -----
   275 ---+++ Can I write colored text?
   276 
   277 TWikiPreferences defines some commonly used colors: *%YELLOW% %<nop>YELLOW%%ENDCOLOR%, %RED% %<nop>RED%%ENDCOLOR%, %PINK% %<nop>PINK%%ENDCOLOR%, %PURPLE% %<nop>PURPLE%%ENDCOLOR%, %TEAL% %<nop>TEAL%%ENDCOLOR%, %NAVY% %<nop>NAVY%%ENDCOLOR%, %BLUE% %<nop>BLUE%%ENDCOLOR%, %AQUA% %<nop>AQUA%%ENDCOLOR%, %LIME% %<nop>LIME%%ENDCOLOR%, %GREEN% %<nop>GREEN%%ENDCOLOR%, %OLIVE% %<nop>OLIVE%%ENDCOLOR%, %MAROON% %<nop>MAROON%%ENDCOLOR%, %BLACK% %<nop>BLACK%%ENDCOLOR%, %GRAY% %<nop>GRAY%%ENDCOLOR%, %SILVER% %<nop>SILVER%%ENDCOLOR%* and *%<nop>ENDCOLOR%*.
   278 
   279    * __You enter:__ =%<nop>RED% red text %<nop>ENDCOLOR% and %<nop>GREEN% green text %<nop>ENDCOLOR%= <p /> 
   280      __Result:__ %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%
   281 
   282 __Note:__ =%&lt;color&gt;%= text must end with =%<nop>ENDCOLOR%= . If you want to switch from one color to another one you first need to end the active color with =%<nop>ENDCOLOR%=, e.g. write =%<nop>RED% some text %<nop>ENDCOLOR% %<nop>GREEN% more text %<nop>ENDCOLOR%=.
   283 
   284 If you need more colors you can use HTML, like =&lt;font color="#ff0000"&gt; red text &lt;/font&gt;=. 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: =&lt;span style="color:#ff0000"&gt;CoLoR&lt;/span&gt;=. Only old (like 3.x IE &amp; NS) browsers have a problem with =style=.
   285 
   286 The code 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 ="#ff0000"= for Web page purposes. StandardColors lists basic colors.
   287 
   288 -----
   289 %STOPINCLUDE%
   290 -- __Contributors:__ TWiki:Main.PeterThoeny,  TWiki:Main.MikeMannix
   291 @
   292 
   293 
   294 1.19
   295 log
   296 @buildrelease
   297 @
   298 text
   299 @d1 1
   300 a1 1
   301 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="19"}%
   302 d18 1
   303 a18 1
   304    * You can insert a nested table of contents, generated from headings, by placing =%<nop>TOC%= wherever you like on a page (see %TWIKIWEB%.TWikiVariables for more =%<nop>TOC%= options).
   305 d38 1
   306 a38 1
   307 To prevent auto-linking - say you want to enter a word like <nop>JavaScript (the proper spelling!) - prefix the WikiStyleWord with an exclamation point: 
   308 d43 7
   309 d73 3
   310 a75 1
   311 *NOTE:* VARIABLES are still Set within verbatim tags (this is a historical peculiarity)
   312 d141 2
   313 a142 2
   314    * __You enter:__ <code> %<nop>PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif logo.</code> <br />
   315      __Result:__ %PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif logo.
   316 d151 1
   317 a151 1
   318 This is a manual process where you have more control over the rendering of the image. Use the &lt;img&gt; tag of HTML to include GIF, JPG and PNG files. *Note:* The rendering 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.
   319 d153 2
   320 a154 2
   321    * __You enter:__ <code> &lt;img src="%<nop>PUBURLPATH%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /&gt; logo.</code><br />
   322     __Result:__ <br /> <img src="%PUBURLPATH%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /> logo.
   323 d171 2
   324 a172 1
   325 
   326 @
   327 
   328 
   329 1.18
   330 log
   331 @buildrelease
   332 @
   333 text
   334 @d1 1
   335 a1 1
   336 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="18"}%
   337 d18 1
   338 a18 1
   339 	* You can insert a nested table of contents, generated from headings, by placing =%<nop>TOC%= wherever you like on a page (see %TWIKIWEB%.TWikiVariables for more =%<nop>TOC%= options).
   340 d27 2
   341 a28 2
   342 	* =&amp;lt;= = =&lt;= <br />
   343 	  =&amp;gt;= = =&gt;=
   344 d30 2
   345 a31 2
   346 	* __You enter:__ =(a &amp;gt; 0)= <p /> 
   347 	  __Result:__ =(a &gt; 0)=
   348 d40 1
   349 a40 1
   350 	* =!WikiStyleWord= displays as !WikiStyleWord
   351 d47 2
   352 a48 2
   353 	* __You enter:__ =Proportional text, <nop>=fixed font=<nop>, proportional again.= <p />
   354 	  __Result:__ Proportional text, =fixed font=, proportional again.
   355 d58 1
   356 a58 1
   357   Unit	  Price	Qty  Cost
   358 d60 1
   359 a60 1
   360   aaa		 12.00	 3	36.00
   361 d72 3
   362 a74 3
   363 	1 Use Wiki rule with "|" vertical bars.
   364 	2 Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags.
   365 	3 Use preformatted text with &lt;verbatim&gt; tags.
   366 d78 6
   367 a83 6
   368 	* Example text: %BR%
   369 	  =| cell A1 | cell B1 | cell C1 |= %BR%
   370 	  =| cell A2 | cell B2 | cell C2 |=
   371 	* Example output: 
   372 	  | cell A1 | cell B1 | cell C1 |
   373 	  | cell A2 | cell B2 | cell C2 |
   374 d94 1
   375 a94 1
   376 	 &lt;th&gt; Head A  &lt;/th&gt; &lt;th&gt; Head B  &lt;/th&gt;
   377 d96 1
   378 a96 1
   379 	 &lt;td&gt; Cell A2 &lt;/td&gt; &lt;td&gt; Cell B2 &lt;/td&gt;
   380 d98 1
   381 a98 1
   382 	 &lt;td&gt; Cell A3 &lt;/td&gt; &lt;td&gt; Cell B3 &lt;/td&gt;
   383 d107 1
   384 a107 1
   385 	 <th> Head A  </th> <th> Head B  </th>
   386 d109 1
   387 a109 1
   388 	 <td> Cell A2 </td> <td> Cell B2 </td>
   389 d111 1
   390 a111 1
   391 	 <td> Cell A3 </td> <td> Cell B3 </td>
   392 d132 2
   393 a133 2
   394 	* __You enter:__ <code> %<nop>PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif logo.</code> <br />
   395 	  __Result:__ %PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif logo.
   396 d137 2
   397 a138 2
   398 	* Attach =pic.gif= to =Someweb.SomeTopic= <br />
   399 	  Display with =%<nop>PUBURL%/Someweb/SomeTopic/pic.gif=
   400 d144 2
   401 a145 2
   402 	* __You enter:__ <code> &lt;img src="%<nop>PUBURLPATH%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /&gt; logo.</code><br />
   403 	 __Result:__ <br /> <img src="%PUBURLPATH%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" width="80" height="15" border="0" alt="logo" /> logo.
   404 d152 2
   405 a153 2
   406 	* __You enter:__ =%<nop>RED% red text %<nop>ENDCOLOR% and %<nop>GREEN% green text %<nop>ENDCOLOR%= <p /> 
   407 	  __Result:__ %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%
   408 @
   409 
   410 
   411 1.17
   412 log
   413 @none
   414 @
   415 text
   416 @d1 1
   417 a1 1
   418 %META:TOPICINFO{author="PeterThoeny" date="1092606139" format="1.0" version="1.17"}%
   419 d66 2
   420 d78 2
   421 a79 2
   422 	* Example text: <br>
   423 	  =| cell A1 | cell B1 | cell C1 |= <br>
   424 d124 1
   425 a124 1
   426 Yes. The easiest way is to [[FileAttachment][attach]] a GIF, JPG or PNG file to a topic and then to place it with: =%<nop>ATTACHURL%/myImage.gif=. This works only for the page that the image is attached to.
   427 d126 1
   428 a126 1
   429 To place an image on any page, ther are two ways of including inline images.
   430 d132 2
   431 a133 2
   432 	* __You enter:__ <code> TWiki <nop>%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif logo.</code> <br />
   433 	  __Result:__ TWiki %PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif logo.
   434 d138 1
   435 a138 1
   436 	  Display with =<no>%PUBURL%/Someweb/<nop>SomeTopic/pic.gif=
   437 d142 1
   438 a142 1
   439 This is a manual process where you have more control over the rendering of the image. Use the &lt;img&gt; 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.
   440 d144 2
   441 a145 2
   442 	* __You enter:__ <code>TWiki &lt;img src="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /&gt; logo.</code><br />
   443 	  __Result:__ <br /> TWiki <img src="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /> logo.
   444 a162 3
   445 -- TWiki:Main.PeterThoeny - 15 Aug 2004 %BR%
   446 -- TWiki:Main.MikeMannix - 14 Sep 2001 %BR%	
   447 
   448 @
   449 
   450 
   451 1.16
   452 log
   453 @none
   454 @
   455 text
   456 @d1 163
   457 a163 162
   458 %META:TOPICINFO{author="PeterThoeny" date="1079505802" format="1.0" version="1.16"}%
   459 ---++!! Text Formatting FAQ
   460 
   461 The most frequently asked questions about text formatting are answered. Also, TextFormattingRules contains the complete TWiki shorthand system on one quick reference page.
   462 
   463 %TOC%
   464 
   465 <blockquote>
   466 ---
   467 ---+++ How do I make a separator?
   468 
   469 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: <br />
   470 =--------------=
   471 
   472 --------------
   473 ---+++ How do I create a heading?
   474 
   475 You can create six sizes of headings - &lt;h1&gt;...&lt;h6&gt; 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?=.
   476 	* You can insert a nested table of contents, generated from headings, by placing =%<nop>TOC%= wherever you like on a page (see %TWIKIWEB%.TWikiVariables for more =%<nop>TOC%= options).
   477 
   478 -----
   479 #TextEnclosed
   480 ---+++ Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?
   481 
   482 TWiki interprets text as HTML, and the '&lt;' and '&gt;' 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.
   483 
   484 If you want to display angle brackets, enter them as HTML codes instead of typing them in directly:
   485 	* =&amp;lt;= = =&lt;= <br />
   486 	  =&amp;gt;= = =&gt;=
   487 
   488 	* __You enter:__ =(a &amp;gt; 0)= <p /> 
   489 	  __Result:__ =(a &gt; 0)=
   490 
   491 ---
   492 ---+++ Some words appear highlighted, with a "?" link at the end. How can I prevent that?
   493 
   494 A question mark after a word is a link to a topic that doesn't yet exist - click it to create the new page. This is a TWiki feature - typing a MeaningfulTitle in a comment is an invitation for someone else to add a new branch to the topic.  
   495 
   496 To prevent auto-linking - say you want to enter a word like <nop>JavaScript (the proper spelling!) - prefix the WikiStyleWord with the special TWiki HTML tag =&lt;nop&gt;=: 
   497 
   498 	* =&lt;nop&gt;WikiStyleWord= displays as <nop>WikiStyleWord
   499 
   500 ---
   501 ---+++ How can I write fixed font text?
   502 
   503 The quickest way is to enclose the text in equal signs:
   504 
   505 	* __You enter:__ =Proportional text, <nop>=fixed font=<nop>, proportional again.= <p />
   506 	  __Result:__ Proportional text, =fixed font=, proportional again.
   507 
   508 ---
   509 #VerbatimText
   510 ---+++ Text I enter gets wrapped around. How can I keep the formatting as it is?
   511 
   512 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 &lt;pre&gt; &lt;/pre&gt;, or in TWiki's own &lt;verbatim&gt; &lt;/verbatim&gt; tag:
   513 <pre>
   514 This text will keep its format as it is:
   515 &lt;verbatim&gt;
   516   Unit	  Price	Qty  Cost
   517   -------  ------  ---  ------
   518   aaa		 12.00	 3	36.00
   519 &lt;/verbatim&gt;
   520 </pre>
   521 
   522 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.
   523 
   524 ---
   525 ---+++ How do I create tables?
   526 
   527 There are three possibilities:
   528 	1 Use Wiki rule with "|" vertical bars.
   529 	2 Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags.
   530 	3 Use preformatted text with &lt;verbatim&gt; tags.
   531 
   532 *1. Use Wiki rule with "|" vertical bars*
   533 
   534 	* Example text: <br>
   535 	  =| cell A1 | cell B1 | cell C1 |= <br>
   536 	  =| cell A2 | cell B2 | cell C2 |=
   537 	* Example output: 
   538 	  | cell A1 | cell B1 | cell C1 |
   539 	  | cell A2 | cell B2 | cell C2 |
   540 
   541 *2. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags*
   542 
   543 This is a manual process using HTML commands. 
   544 
   545 __You enter:__
   546 
   547 <pre>
   548 &lt;table border="1"&gt;
   549   &lt;tr&gt;
   550 	 &lt;th&gt; Head A  &lt;/th&gt; &lt;th&gt; Head B  &lt;/th&gt;
   551   &lt;/tr&gt;&lt;tr&gt;
   552 	 &lt;td&gt; Cell A2 &lt;/td&gt; &lt;td&gt; Cell B2 &lt;/td&gt;
   553   &lt;/tr&gt;&lt;tr&gt;
   554 	 &lt;td&gt; Cell A3 &lt;/td&gt; &lt;td&gt; Cell B3 &lt;/td&gt;
   555   &lt;/tr&gt;
   556 &lt;/table&gt;
   557 </pre>
   558 
   559 __Result:__
   560 
   561 <table border="1">
   562   <tr>
   563 	 <th> Head A  </th> <th> Head B  </th>
   564   </tr><tr>
   565 	 <td> Cell A2 </td> <td> Cell B2 </td>
   566   </tr><tr>
   567 	 <td> Cell A3 </td> <td> Cell B3 </td>
   568   </tr>
   569 </table>
   570 
   571 *3. Use preformatted text with &lt;verbatim&gt; tags*
   572 
   573 See [[#VerbatimText]["Text I enter gets wrapped around..."]] 
   574 
   575 ---
   576 ---+++ Can I include images on a page?
   577 
   578 Yes. The easiest way is to [[FileAttachment][attach]] a GIF, JPG or PNG file to a topic and then to place it with: =%<nop>ATTACHURL%/myImage.gif=. This works only for the page that the image is attached to.
   579 
   580 To place an image on any page, ther are two ways of including inline images.
   581 
   582 *1. Using URL ending in .gif, .jpg, .jpeg, .png*
   583 
   584 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 [[#ImgUpload][accessible]] as a URL.
   585 
   586 	* __You enter:__ <code> TWiki <nop>%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif logo.</code> <br />
   587 	  __Result:__ TWiki %PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif logo.
   588 
   589 #ImgUpload
   590 You can upload images directly to your server with FTP access. You can also [[FileAttachment][attach]] image files to a topic - you could even create a dedicated image topic, like =ImageLibrary= - and then link to the images directly:
   591 	* Attach =pic.gif= to =Someweb.SomeTopic= <br />
   592 	  Display with =<no>%PUBURL%/Someweb/<nop>SomeTopic/pic.gif=
   593 
   594 *2. Using &lt;img&gt; tag*
   595 
   596 This is a manual process where you have more control over the rendering of the image. Use the &lt;img&gt; 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.
   597 
   598 	* __You enter:__ <code>TWiki &lt;img src="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /&gt; logo.</code><br />
   599 	  __Result:__ <br /> TWiki <img src="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /> logo.
   600 
   601 -----
   602 ---+++ Can I write colored text?
   603 
   604 TWikiPreferences defines some commonly used colors: *%YELLOW% %<nop>YELLOW%%ENDCOLOR%, %RED% %<nop>RED%%ENDCOLOR%, %PINK% %<nop>PINK%%ENDCOLOR%, %PURPLE% %<nop>PURPLE%%ENDCOLOR%, %TEAL% %<nop>TEAL%%ENDCOLOR%, %NAVY% %<nop>NAVY%%ENDCOLOR%, %BLUE% %<nop>BLUE%%ENDCOLOR%, %AQUA% %<nop>AQUA%%ENDCOLOR%, %LIME% %<nop>LIME%%ENDCOLOR%, %GREEN% %<nop>GREEN%%ENDCOLOR%, %OLIVE% %<nop>OLIVE%%ENDCOLOR%, %MAROON% %<nop>MAROON%%ENDCOLOR%, %BLACK% %<nop>BLACK%%ENDCOLOR%, %GRAY% %<nop>GRAY%%ENDCOLOR%, %SILVER% %<nop>SILVER%%ENDCOLOR%* and *%<nop>ENDCOLOR%*.
   605 
   606 	* __You enter:__ =%<nop>RED% red text %<nop>ENDCOLOR% and %<nop>GREEN% green text %<nop>ENDCOLOR%= <p /> 
   607 	  __Result:__ %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%
   608 
   609 __Note:__ =%&lt;color&gt;%= text must end with =%<nop>ENDCOLOR%= . If you want to switch from one color to another one you first need to end the active color with =%<nop>ENDCOLOR%=, e.g. write =%<nop>RED% some text %<nop>ENDCOLOR% %<nop>GREEN% more text %<nop>ENDCOLOR%=.
   610 
   611 If you need more colors you can use HTML, like =&lt;font color="#ff0000"&gt; red text &lt;/font&gt;=. 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: =&lt;span style="color:#ff0000"&gt;CoLoR&lt;/span&gt;=. Only old (like 3.x IE &amp; NS) browsers have a problem with =style=.
   612 
   613 The code 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 ="#ff0000"= for Web page purposes. StandardColors lists basic colors.
   614 
   615 -----
   616 </blockquote>
   617 
   618 -- TWiki:Main.PeterThoeny - 16 Mar 2004 <br />
   619 -- TWiki:Main.MikeMannix - 14 Sep 2001 <br />	
   620 @
   621 
   622 
   623 1.15
   624 log
   625 @none
   626 @
   627 text
   628 @d1 1
   629 a1 1
   630 %META:TOPICINFO{author="PeterThoeny" date="1061529569" format="1.0" version="1.15"}%
   631 d156 1
   632 a156 1
   633 The code 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. StandardColors lists basic colors.
   634 d161 2
   635 a162 2
   636 -- PeterThoeny - 21 Feb 2002 <br />
   637 -- MikeMannix - 14 Sep 2001 <br />	
   638 @
   639 
   640 
   641 1.14
   642 log
   643 @none
   644 @
   645 text
   646 @d1 1
   647 a1 1
   648 %META:TOPICINFO{author="PeterThoeny" date="1042088369" format="1.0" version="1.14"}%
   649 d52 1
   650 d116 1
   651 a116 1
   652 See [[#TextEnclosed]["Text enclosed..."]] 
   653 @
   654 
   655 
   656 1.13
   657 log
   658 @none
   659 @
   660 text
   661 @d1 2
   662 a2 2
   663 %META:TOPICINFO{author="PeterThoeny" date="1025251620" format="1.0" version="1.13"}%
   664 <font size="+3"><b>Text Formatting FAQ</b></font>
   665 @
   666 
   667 
   668 1.12
   669 log
   670 @none
   671 @
   672 text
   673 @d1 1
   674 a1 1
   675 %META:TOPICINFO{author="PeterThoeny" date="1014367320" format="1.0" version="1.12"}%
   676 d128 2
   677 a129 2
   678 	* __You enter:__ <code> TWiki <nop>%PUBURL%/wikiHome.gif logo.</code> <br />
   679 	  __Result:__ TWiki %PUBURL%/wikiHome.gif logo.
   680 d140 2
   681 a141 2
   682 	* __You enter:__ <code>TWiki &lt;img src="%PUBURL%/wikiHome.gif" width="46" height="50" border="0" alt="logo" /&gt; logo.</code><br />
   683 	  __Result:__ <br /> TWiki <img src="%PUBURL%/wikiHome.gif" width="46" height="50" border="0" alt="logo" /> logo.
   684 @
   685 
   686 
   687 1.11
   688 log
   689 @none
   690 @
   691 text
   692 @d1 1
   693 a1 1
   694 %META:TOPICINFO{author="PeterThoeny" date="1014358573" format="1.0" version="1.11"}%
   695 d146 1
   696 a146 1
   697 Sure. The quickest way is to go &lt;font color="colorCode"&gt;colorize&lt;/font&gt; - =font= is an HTML tag that works in any browser, although it's been phased out in the latest HTML specs. 
   698 d148 2
   699 a149 1
   700 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: "&lt;span style="color:#ff0000"&gt;CoLoR&lt;/span&gt;. Only old (like 3.x IE &amp; NS) browsers have a problem with =style=.
   701 d151 1
   702 a151 1
   703 "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 [[StandardColors][StandardColor]] names instead of hex code in the =font= tag only):
   704 d153 1
   705 a153 23
   706 <table>
   707 <tr bgcolor="#e0e0e0">
   708   <td><font color="#000000"> *Black:* </font></td><td> ="#000000"= </td>
   709   <td><font color="#008000"> *Green:* </font></td><td> ="#008000"= </td>
   710   <td><font color="#c0c0c0"> *Silver:* </font></td><td> ="#c0c0c0"= </td>
   711   <td><font color="#00ff00"> *Lime:* </font></td><td> ="#00ff00"= </td>
   712 </tr><tr bgcolor="#c0c0c0">
   713   <td><font color="#808080"> *Gray:* </font></td><td> ="#808080"= </td>
   714   <td><font color="#808000"> *Olive:* </font></td><td> ="#808000"= </td>
   715   <td><font color="#ffffff"> *White:* </font></td><td> ="#ffffff"= </td>
   716   <td><font color="#ffff00"> *Yellow:* </font></td><td> ="#ffff00"= </td>
   717 </tr><tr bgcolor="#e0e0e0">
   718   <td><font color="#800000"> *Maroon:* </font></td><td> ="#800000"= </td>
   719   <td><font color="#000080"> *Navy:* </font></td><td> ="#000080"= </td>
   720   <td><font color="#ff0000"> *Red:* </font></td><td> ="#ff0000"= </td>
   721   <td><font color="#0000ff"> *Blue:* </font></td><td> ="#0000ff"= </td>
   722 </tr><tr bgcolor="#c0c0c0">
   723   <td><font color="#800080"> *Purple:* </font></td><td> ="#800080"= </td>
   724   <td><font color="#008080"> *Teal:* </font></td><td> ="#008080"= </td>
   725   <td><font color="#ff00ff"> *Fuchsia:* </font></td><td> ="#ff00ff"= </td>
   726   <td><font color="#00ffff"> *Aqua:* </font></td><td> ="#00ffff"= </td>
   727 </tr>
   728 </table>
   729 d155 1
   730 a155 2
   731 	* __You enter:__ <code> &lt;font color="#ff0000"&gt; Red color &lt;/font&gt; draws attention. </code><p>
   732 	  __Result:__ <font color="#ff0000"> Red color </font> draws attention.
   733 d160 1
   734 a160 1
   735 -- PeterThoeny - 13 Sep 2001 <br />
   736 @
   737 
   738 
   739 1.10
   740 log
   741 @none
   742 @
   743 text
   744 @d1 1
   745 a1 1
   746 %META:TOPICINFO{author="MikeMannix" date="1000530761" format="1.0" version="1.10"}%
   747 d169 1
   748 a169 1
   749   <td><font color="#800080"> *Purple:* </font></td><td>="#800080"= </td>
   750 @
   751 
   752 
   753 1.9
   754 log
   755 @none
   756 @
   757 text
   758 @d1 1
   759 a1 1
   760 %META:TOPICINFO{author="PeterThoeny" date="1000464173" format="1.0" version="1.9"}%
   761 d12 2
   762 a13 1
   763 You can make a horizontal separator by entering three dashes at the beginning of a line: =---=.
   764 d15 1
   765 a15 1
   766 ---
   767 d25 1
   768 a25 1
   769 TWiki interprets text as HTML. The '&lt;' and '&gt;' 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.
   770 d54 1
   771 a54 1
   772 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 &lt;pre&gt; &lt;/pre&gt;, or in TWiki's own &lt;verbatim&gt; &lt;/verbatim&gt; tags:
   773 d64 1
   774 a64 1
   775 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.
   776 d118 1
   777 a118 1
   778 ---+++ Can I include images and pictures?
   779 d120 1
   780 a120 1
   781 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 =%<nop>ATTACHURL%/myImage.gif= . FileAttachment has more.
   782 d122 1
   783 a122 1
   784 There are actually two ways of including inline images.
   785 d126 1
   786 a126 1
   787 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.
   788 d131 5
   789 d138 1
   790 a138 1
   791 This is a manual process where you have more control over the rendering of the image. Use the &lt;img&gt; 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.
   792 d140 2
   793 a141 2
   794 	* __You enter:__ <code>TWiki &lt;img src="%PUBURL%/wikiHome.gif" width="46" height="50" /&gt; logo.</code><br />
   795 	  __Result:__ <br /> TWiki <img src="%PUBURL%/wikiHome.gif" width="46" height="50" /> logo.
   796 d146 1
   797 a146 1
   798 Sure. The quickest way is to use the &lt;font color="colorCode"&gt; and &lt;/font&gt; tags - they're HTML tags that work in any browser, (although they've been phased in the latest version). 
   799 d148 1
   800 a148 1
   801 You can also use a =style= attribute: =style="color:#ff0000"=, placed in most HTML tags - =span= is an all-purpose choice: "&lt;span style="color:#ff0000">.
   802 @
   803 
   804 
   805 1.8
   806 log
   807 @none
   808 @
   809 text
   810 @d1 1
   811 a1 1
   812 %META:TOPICINFO{author="PeterThoeny" date="1000370644" format="1.0" version="1.8"}%
   813 d4 1
   814 a4 2
   815 	* The most frequently asked questions about text formatting are answered here. 
   816 		* TextFormattingRules has the complete system in a handy quick reference format.
   817 d12 1
   818 a12 1
   819 You can make a horizontal separator by writing three or more dashes at the beginning of a line.
   820 d27 5
   821 a31 3
   822 		* =&amp;lt;= = =&lt;=
   823 		* =&amp;gt;= = =&gt;=
   824 		* Enter: =(a &amp;gt; 0)= to get =(a &gt; 0)=
   825 d34 1
   826 a34 1
   827 ---+++ Some words (like WinAPI) have an unwanted question mark at the end. How can I prevent that?
   828 d36 1
   829 a36 1
   830 A question mark after a word is a link to a topic that doesn't yet exist - click it to create the new page. This is a TWiki feature - typing a MeaningfulTitle in a comment is an invitation for someone else to add to the topic.  
   831 d38 1
   832 a38 1
   833 To prevent auto-linking - you may simply want to enter a word like <nop>JavaScript (the proper spelling!) - prefix it with the special TWiki HTML tag =&lt;nop&gt;=: 
   834 d40 1
   835 a40 1
   836 	* =&lt;nop&gt;WikiWord= displays as <nop>WikiWord
   837 d45 1
   838 a45 4
   839 Enclose text in "=" equal signs:
   840 
   841 	* =Proportional text, <nop>=fixed font text=<nop>, proportional again.= appears as...
   842 	  <br /> Proportional text, =fixed font text= , proportional again.
   843 d47 2
   844 a48 1
   845 Alternatively you could also use preformatted text, see next question for details.
   846 d53 1
   847 a53 1
   848 TWiki interprets text as HTML. It is possible to use preformatted text to workaround this. Use the preformatted HTML tags to keep the new line of text as it is. Do so by enclosing text in either &lt;pre&gt; &lt;/pre&gt; or &lt;verbatim&gt; &lt;/verbatim&gt; tags:
   849 d73 1
   850 a73 1
   851 __1. Use Wiki rule with "|" vertical bars__
   852 d82 1
   853 a82 1
   854 __2. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags__
   855 d84 3
   856 a86 1
   857 This is a manual process using HTML commands. Here is an example. If you enter this:
   858 d100 1
   859 a100 1
   860 It is displayed as a table like this:
   861 d112 1
   862 a112 1
   863 __3. Use preformatted text with &lt;verbatim&gt; tags__
   864 d114 1
   865 a114 1
   866 Text I enter gets wrapped around. How can I keep the formatting as it is? See [[#TextEnclosed]["Text enclosed..."]] 
   867 d123 1
   868 a123 1
   869 __1. Using URL ending in .gif, .jpg, .jpeg, .png__
   870 d127 2
   871 a128 2
   872 	* Example text: <br /> <code> TWiki <nop>%PUBURL%/wikiHome.gif logo.</code>
   873 	* Example output: <br /> TWiki %PUBURL%/wikiHome.gif logo.
   874 d130 1
   875 a130 1
   876 __2. Using &lt;img&gt; tag__
   877 d134 2
   878 a135 2
   879 	* Example text: <br /> <code>TWiki &lt;img src="%PUBURL%/wikiHome.gif" width="46" height="50" /&gt; logo.</code>
   880 	* Example output: <br /> TWiki <img src="%PUBURL%/wikiHome.gif" width="46" height="50" /> logo.
   881 d140 3
   882 a142 1
   883 Place text you would like to specify a color inside &lt;font color="colorCode"&gt; and &lt;/font&gt; tags. 
   884 d144 1
   885 a144 3
   886 "colorCode" is the hexadecimal RGB color code. The color is composed
   887 by specifying the red, green and blue components of the color in
   888 hexadecimal notation. For example, to specify white, the red, green and blue components are 255, 255, 255, so you would use ="#ffffff=". You can use StandardColors or common color codes:
   889 d170 2
   890 a171 2
   891 	* Example text: <br /> <code> &lt;font color="#ff0000"&gt; Red color &lt;/font&gt; draws attention. </code>
   892 	* Example output: <br /> <font color="#ff0000"> Red color </font> draws attention.
   893 d176 2
   894 a177 2
   895 -- Main.MikeMannix - 10 Sep 2001 <br />
   896 -- Main.PeterThoeny - 13 Sep 2001 <br />
   897 @
   898 
   899 
   900 1.7
   901 log
   902 @none
   903 @
   904 text
   905 @d1 1
   906 a1 1
   907 %META:TOPICINFO{author="MikeMannix" date="1000108590" format="1.0" version="1.7"}%
   908 d18 1
   909 a18 1
   910 You can create six sizes of headings - &lt;H1&gt;...&lt;H6&gt; 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?=.
   911 d47 1
   912 a47 1
   913 	  <br> Proportional text, =fixed font text= , proportional again.
   914 d54 1
   915 a54 1
   916 TWiki interprets text as HTML. It is possible to use preformatted text to workaround this. Use the preformatted HTML tags to keep the new line of text as it is. Do so by enclosing text in either &lt;pre&gt; &lt;/pre&gt; or &lt;verbatim&gt; &lt;verbatim&gt; tags:
   917 d57 1
   918 a57 1
   919 &lt;pre&gt;
   920 d61 1
   921 a61 1
   922 &lt;/pre&gt;
   923 d72 1
   924 a72 1
   925 	3 Use preformatted text with &lt;PRE&gt; tags.
   926 d74 1
   927 a74 1
   928 *_1. Use Wiki rule with "|" vertical bars_*
   929 d83 1
   930 a83 1
   931 *_2. Use HTML tables with &lt;TABLE&gt;, &lt;TR&gt;, &lt;TD&gt; tags_*
   932 d88 9
   933 a96 9
   934 &lt;TABLE BORDER=1&gt;
   935   &lt;TR&gt;
   936 	 &lt;TH&gt; Head A  &lt;/TH&gt; &lt;TH&gt; Head B  &lt;/TH&gt;
   937   &lt;/TR&gt;&lt;TR&gt;
   938 	 &lt;TD&gt; Cell A2 &lt;/TD&gt; &lt;TD&gt; Cell B2 &lt;/TD&gt;
   939   &lt;/TR&gt;&lt;TR&gt;
   940 	 &lt;TD&gt; Cell A3 &lt;/TD&gt; &lt;TD&gt; Cell B3 &lt;/TD&gt;
   941   &lt;/TR&gt;
   942 &lt;/TABLE&gt;
   943 d101 9
   944 a109 9
   945 <TABLE BORDER=1>
   946   <TR>
   947 	 <TH> Head A  </TH> <TH> Head B  </TH>
   948   </TR><TR>
   949 	 <TD> Cell A2 </TD> <TD> Cell B2 </TD>
   950   </TR><TR>
   951 	 <TD> Cell A3 </TD> <TD> Cell B3 </TD>
   952   </TR>
   953 </TABLE>
   954 d111 1
   955 a111 1
   956 *_3. Use preformatted text with &lt;PRE&gt; tags_*
   957 d118 1
   958 a118 1
   959 Yes, this is possible. The easiest way of including images is to attach a GIF or JPG file to a topic and then to include it with text =%<nop>ATTACHURL%/myImage.gif= . FileAttachment has more.
   960 d122 1
   961 a122 1
   962 *_1. Using URL ending in .gif, .jpg, .jpeg_*
   963 d126 2
   964 a127 2
   965 	* Example text: <br> <code> TWiki <nop>%PUBURL%/wikiHome.gif logo.</code>
   966 	* Example output: <br> TWiki %PUBURL%/wikiHome.gif logo.
   967 d129 1
   968 a129 1
   969 *_2. Using &lt;IMG&gt; tag_*
   970 d131 1
   971 a131 1
   972 This is a manual process where you have more control over the rendering of the image. Use the &lt;IMG&gt; tag of HTML to include JPEG and GIF 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.
   973 d133 2
   974 a134 2
   975 	* Example text: <br> <code>TWiki &lt;IMG SRC="%PUBURL%/wikiHome.gif" WIDTH=46 HEIGHT=50&gt; logo.</code>
   976 	* Example output: <br> TWiki <IMG SRC="%PUBURL%/wikiHome.gif" WIDTH=46 HEIGHT=50> logo.
   977 d139 1
   978 a139 1
   979 Place text you would like to specify a color inside &lt;FONT COLOR="colorCode"&gt; and &lt;/FONT&gt; tags. 
   980 d143 1
   981 a143 1
   982 hexadecimal notation. For example, to specify white, the red, green and blue components are 255, 255, 255, so you would use "#FFFFFF". You can use StandardColors or common color codes:
   983 d145 23
   984 a167 23
   985 <TABLE>
   986 <TR BGCOLOR="#E0E0E0">
   987   <TD><FONT COLOR="#000000"> *Black:* </FONT></TD><TD>"#000000" </TD>
   988   <TD><FONT COLOR="#008000"> *Green:* </FONT></TD><TD>"#008000" </TD> 
   989   <TD><FONT COLOR="#C0C0C0"> *Silver:* </FONT></TD><TD>"#C0C0C0" </TD>
   990   <TD><FONT COLOR="#00FF00"> *Lime:* </FONT></TD><TD>"#00FF00" </TD>
   991 </TR><TR BGCOLOR="#C0C0C0">
   992   <TD><FONT COLOR="#808080"> *Gray:* </FONT></TD><TD>"#808080" </TD>
   993   <TD><FONT COLOR="#808000"> *Olive:* </FONT></TD><TD>"#808000" </TD>
   994   <TD><FONT COLOR="#FFFFFF"> *White:* </FONT></TD><TD>"#FFFFFF" </TD>
   995   <TD><FONT COLOR="#FFFF00"> *Yellow:* </FONT></TD><TD>"#FFFF00" </TD>
   996 </TR><TR BGCOLOR="#E0E0E0">
   997   <TD><FONT COLOR="#800000"> *Maroon:* </FONT></TD><TD>"#800000" </TD>
   998   <TD><FONT COLOR="#000080"> *Navy:* </FONT></TD><TD>"#000080" </TD>
   999   <TD><FONT COLOR="#FF0000"> *Red:* </FONT></TD><TD>"#FF0000" </TD>
  1000   <TD><FONT COLOR="#0000FF"> *Blue:* </FONT></TD><TD>"#0000FF" </TD>
  1001 </TR><TR BGCOLOR="#C0C0C0">
  1002   <TD><FONT COLOR="#800080"> *Purple:* </FONT></TD><TD>"#800080" </TD>
  1003   <TD><FONT COLOR="#008080"> *Teal:* </FONT></TD><TD>"#008080" </TD>
  1004   <TD><FONT COLOR="#FF00FF"> *Fuchsia:* </FONT></TD><TD>"#FF00FF"</TD>
  1005   <TD><FONT COLOR="#00FFFF"> *Aqua:* </FONT></TD><TD>"#00FFFF" </TD>
  1006 </TR>
  1007 </TABLE>
  1008 d169 2
  1009 a170 2
  1010 	* Example text: <br> <code> &lt;FONT COLOR="#FF0000"&gt; Red color &lt;/FONT&gt; draws attention. </code>
  1011 	* Example output: <br> <FONT COLOR="#FF0000"> Red color </FONT> draws attention.
  1012 d176 1
  1013 @
  1014 
  1015 
  1016 1.6
  1017 log
  1018 @none
  1019 @
  1020 text
  1021 @d1 1
  1022 a1 1
  1023 %META:TOPICINFO{author="MikeMannix" date="999835477" format="1.0" version="1.6"}%
  1024 d10 1
  1025 a10 1
  1026 -----
  1027 d13 1
  1028 a13 6
  1029 You can make a horizontal separator by writing 4 or more dashes at the beginning of a line.
  1030 
  1031 -----
  1032 ---+++ How do I create a title or a heading?
  1033 
  1034 The most simple way is to enclose it in '*' Asterisk characters or '_' Underscore characters. 
  1035 d15 2
  1036 a16 1
  1037 *This is an example header enclosed in Asterisk characters*
  1038 d18 2
  1039 a19 5
  1040 _This is an example header enclosed in Underscore characters_
  1041 
  1042 You could use also HTML tags for headings, e.g. <code>&lt;H4&gt;This is an HTML heading&lt;/H4&gt;</code> will show up as:
  1043 
  1044 <H4>This is an HTML heading</H4>
  1045 d25 1
  1046 a25 3
  1047 TWiki interprets text as HTML. The '&lt;' and '&gt;' characters are used to define HTML commands. Any valid text within angle brackets gets interpreted by the browser as an HTML command. Invalid text is ignored, that's why it doesn't show up.
  1048 
  1049 There are two work arounds if you want to display angle brackets:
  1050 d27 4
  1051 a30 6
  1052 	* Do an escape sequence in HTML:
  1053 		* Write <code>&amp;lt;</code> instead of <code>&lt;</code>
  1054 		* Write <code>&amp;gt;</code> instead of <code>&gt;</code>
  1055 		* Example: Write <code>(a &amp;gt; 0)</code> instead of <code>(a &gt; 0)</code>
  1056 	* Replace angle brackets with curly brackets.
  1057 		* Example: Write <code>{is-writable}</code> instead of <code>&lt;is-writable&gt;</code>
  1058 d32 1
  1059 a32 1
  1060 -----
  1061 d35 1
  1062 a35 1
  1063 A question mark after a word is a link to a not yet existing topic. For example, WinAPI is a valid WikiName, but the actual topic _WinAPI_ does not exist.
  1064 d37 1
  1065 a37 1
  1066 If you do not intend to create a topic for a valid WikiWord, you can prevent it being linked by putting an HTML tag in front of it. I usually use &lt;nop&gt;. This is a non existing HTML tag, so a browser just ignores it.
  1067 d39 1
  1068 a39 2
  1069 	* Example text: <br> <code><nop>WinAPI as it is, &lt;nop&gt;WinAPI with preceding NOP.</code>
  1070 	* Example output: <br> WinAPI as it is, <nop>WinAPI with preceding NOP.
  1071 d41 1
  1072 a41 1
  1073 -----
  1074 d44 1
  1075 a44 1
  1076 Enclose text in "=" equal signs.
  1077 d46 2
  1078 a47 2
  1079 	* Example text: <br> =Proportional text, <nop>=fixed font text=<nop> , proportional again.=
  1080 	* Example output: <br> Proportional text, =fixed font text= , proportional again.
  1081 d51 1
  1082 a51 1
  1083 -----
  1084 d54 1
  1085 a54 1
  1086 TWiki interprets text as HTML. It is possible to use preformatted text to work around this. Use the preformatted HTML tags to keep the new line of text as it is. Do so by enclosing the text with &lt;PRE&gt; and &lt;/PRE&gt; tags, e.g.
  1087 d57 1
  1088 a57 1
  1089 &lt;PRE&gt;
  1090 d61 1
  1091 a61 1
  1092 &lt;/PRE&gt;
  1093 d64 1
  1094 a64 1
  1095 It is recommended to use preformatting for tables and source code.
  1096 d66 1
  1097 a66 1
  1098 -----
  1099 d71 1
  1100 a71 1
  1101 	2 Use HTML tables with &lt;TABLE&gt;, &lt;TR&gt;, &lt;TD&gt; tags.
  1102 a110 4
  1103 You can copy the example from &lt;TABLE&gt; to &lt;/TABLE&gt; and change it to your needs.
  1104 
  1105 More information about HTML tables can be found at http://www.htmlhelp.com/reference/wilbur/table/table.html
  1106 
  1107 d115 1
  1108 a115 1
  1109 -----
  1110 d175 1
  1111 a175 1
  1112 -- Main.PeterThoeny - 18 Aug 2000
  1113 @
  1114 
  1115 
  1116 1.5
  1117 log
  1118 @none
  1119 @
  1120 text
  1121 @d1 2
  1122 a2 1
  1123 *Text Formatting FAQ*
  1124 d4 2
  1125 a5 1
  1126 This topic has answers to frequently asked questions about text formatting. TextFormattingRules has more on formatting rules in general. It also has links to HTML documentation.
  1127 d7 1
  1128 a7 9
  1129 	* <A HREF="#sepa">Q:</A> How do I make a separator?
  1130 	* <A HREF="#head">Q:</A> How do I create a title or a heading?
  1131 	* <A HREF="#brac">Q:</A> Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?
  1132 	* <A HREF="#ques">Q:</A> Some words (like WinAPI) have an unwanted question mark at the end. How can I prevent that?
  1133 	* <A HREF="#fixe">Q:</A> How can I write fixed font text?
  1134 	* <A HREF="#wrap">Q:</A> Text I enter gets wrapped around. How can I keep the formatting as it is?
  1135 	* <A HREF="#tabl">Q:</A> How do I create tables?
  1136 	* <A HREF="#imag">Q:</A> Can I include images and pictures?
  1137 	* <A HREF="#colo">Q:</A> Can I write colored text?
  1138 d9 1
  1139 d11 1
  1140 a11 2
  1141 <A NAME="sepa">Q:</A>
  1142 *How do I make a separator?*
  1143 d16 1
  1144 a16 2
  1145 <A NAME="head">Q:</A>
  1146 *How do I create a title or a heading?*
  1147 d18 1
  1148 a18 1
  1149 The most simple way is to enclose it in '*' Asterisk characters or '_' Underscore charcters. 
  1150 d29 2
  1151 a30 2
  1152 <A NAME="brac">Q:</A>
  1153 *Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?*
  1154 d44 1
  1155 a44 2
  1156 <A NAME="ques">Q:</A>
  1157 *Some words (like WinAPI) have an unwanted question mark at the end. How can I prevent that?*
  1158 d50 2
  1159 a51 2
  1160 	* Example text: <br> <code><nop>WinAPI as it is, &lt;nop&gt;WinAPI with preceeding NOP.</code>
  1161 	* Example output: <br> WinAPI as it is, <nop>WinAPI with preceeding NOP.
  1162 d54 1
  1163 a54 2
  1164 <A NAME="fixe">Q:</A>
  1165 *How can I write fixed font text?*
  1166 d64 1
  1167 a64 2
  1168 <A NAME="wrap">Q:</A>
  1169 *Text I enter gets wrapped around. How can I keep the formatting as it is?*
  1170 d79 1
  1171 a79 2
  1172 <A NAME="tabl">Q:</A>
  1173 *How do I create tables?*
  1174 d129 1
  1175 a129 1
  1176 See <A HREF="#wrap">Q:</A> Text I enter gets wrapped around. How can I keep the formatting as it is?
  1177 d132 1
  1178 a132 2
  1179 <A NAME="imag">Q:</A>
  1180 *Can I include images and pictures?*
  1181 d153 1
  1182 a153 2
  1183 <A NAME="colo">Q:</A>
  1184 *Can I write colored text?*
  1185 d189 1
  1186 @
  1187 
  1188 
  1189 1.4
  1190 log
  1191 @none
  1192 @
  1193 text
  1194 @d172 1
  1195 a172 1
  1196 hexadecimal notation. For example, to specify white, the red, green and blue components are 255, 255, 255, so you would use "#FFFFFF". Common color codes are:
  1197 @
  1198 
  1199 
  1200 1.3
  1201 log
  1202 @none
  1203 @
  1204 text
  1205 @d54 1
  1206 a54 1
  1207 A question mark after a word is a link to a not yet existing topic. For example, WinAPI is a valid WikiTopic name in WikiNotation, but the actual topic _WinAPI_ does not exist.
  1208 d56 1
  1209 a56 1
  1210 If you do not intend to create a topic for a valid TWiki topic name, you can prevent it being linked by putting an HTML tag in front of it. I usually use &lt;NOP&gt;. This is a non existing HTML tag, so a browser just ignores it.
  1211 d58 2
  1212 a59 2
  1213 	* Example text: <br> <code><nop>WinAPI as it is, &lt;NOP&gt;WinAPI with preceeding NOP.</code>
  1214 	* Example output: <br> WinAPI as it is, <NOP>WinAPI with preceeding NOP.
  1215 d203 1
  1216 a203 1
  1217 -- Main.PeterThoeny - 08 Aug 1999
  1218 @
  1219 
  1220 
  1221 1.2
  1222 log
  1223 @none
  1224 @
  1225 text
  1226 @d161 2
  1227 a162 2
  1228 	* Example text: <br> <code>TWiki &lt;IMG SRC="../../../pub/wikiHome.gif" WIDTH=46 HEIGHT=50&gt; logo.</code>
  1229 	* Example output: <br> TWiki <IMG SRC="../../../pub/wikiHome.gif" WIDTH=46 HEIGHT=50> logo.
  1230 @
  1231 
  1232 
  1233 1.1
  1234 log
  1235 @none
  1236 @
  1237 text
  1238 @d65 1
  1239 a65 1
  1240 Enclose text in &lt;CODE&gt; and &lt;/CODE&gt; HTML tags.
  1241 d67 2
  1242 a68 2
  1243 	* Example text: <br> <code>Proportional text, &lt;CODE&gt; fixed font text, &lt;/CODE&gt; proportional again.</code>
  1244 	* Example output: <br> Proportional text, <CODE> fixed font text, </CODE> proportional again.
  1245 d92 2
  1246 a93 2
  1247 There are two possibilities:
  1248 	1 Use preformatted text with &lt;PRE&gt; tags.
  1249 d95 1
  1250 d97 1
  1251 a97 1
  1252 *_1. Use preformatted text with &lt;PRE&gt; tags_*
  1253 d99 6
  1254 a104 1
  1255 See <A HREF="#wrap">Q:</A> Text I enter gets wrapped around. How can I keep the formatting as it is?
  1256 d138 4
  1257 d203 1
  1258 a203 1
  1259 -- Main.PeterThoeny - 26 Oct 1998
  1260 @