none
authorPeterThoeny <PeterThoeny>
Sun, 15 Aug 2004 21:43:08 +0000 (21:43 +0000)
committerPeterThoeny <PeterThoeny>
Sun, 15 Aug 2004 21:43:08 +0000 (21:43 +0000)
TWiki/TWikiTemplates.mdwn
TWiki/TWikiTopics.mdwn
TWiki/TWikiUserAuthentication.mdwn
TWiki/TemplateWeb.mdwn
TWiki/TextEditor.mdwn
TWiki/TextFormattingFAQ.mdwn
TWiki/TimBernersLee.mdwn

index 7ee12f6..801a222 100644 (file)
@@ -107,16 +107,63 @@ Common parts, appearing in two or more templates, can be defined in a master tem
 
 ### <a name="HTML Page Templates"></a> HTML Page Templates
 
-%WIKITOOLNAME% uses HTML template files for all actions, like topic view, edit, and preview. This allows you to change the look and feel of all pages by editing just a few template files.
+TWiki uses HTML template files for all actions, like topic view, edit, and preview. This allows you to change the look and feel of all pages by editing just a few template files.
 
-Templates are in the <code>**twiki/templates**</code> directory. As an example, <code>**twiki/templates/view.tmpl**</code> is the template file for the <code>**twiki/bin/view**</code> script. Templates can be overloaded by individual webs. The following search order applies:
+Templates are stored either in the <code>**twiki/templates**</code> directory or in user topics. As an example, <code>**twiki/templates/view.tmpl**</code> is the template file for the <code>**twiki/bin/view**</code> script.
 
-1. <code>**twiki/templates/$webName/$scriptName.tmpl**</code>
-2. <code>**twiki/templates/$scriptName.tmpl**</code>
-  - `$webName` is the name of the web (ex: `Main`)
-  - `$scriptName` is the script (ex: `view`).
+%H% Templates can be overloaded by individual webs.
 
-%H% **NOTE:** [[TWikiSkins]] can be defined to overload the standard templates.
+%H% [[TWikiSkins]] can overload the standard templates.
+
+TWiki uses the following search order to determine which template to use:
+
+> <table border="1" cellpadding="0" cellspacing="0">
+>   <tr>
+>     <th bgcolor="#99CCCC"><strong> If a skin is specified </strong></th>
+>     <th bgcolor="#99CCCC"><strong> If no skin is specified </strong></th>
+>   </tr>
+>   <tr>
+>     <td><code>templates/%WEB%/%RED%script.%RED%skin%ENDCOLOR%.tmpl</code></td>
+>     <td><code>templates/%WEB%/%RED%script%ENDCOLOR%.tmpl</code></td>
+>   </tr>
+>   <tr>
+>     <td><code>templates/%RED%script%ENDCOLOR%.%RED%skin%ENDCOLOR%.tmpl</code></td>
+>     <td><code>templates/%RED%script%ENDCOLOR%.tmpl</code></td>
+>   </tr>
+>   <tr>
+>     <td><code>data/%WEB%/%RED%Skin%ENDCOLOR%Skin%RED%Script%ENDCOLOR%Template.txt</code></td>
+>     <td><code>data/%WEB%/%RED%Script%ENDCOLOR%Template.txt</code></td>
+>   </tr>
+>   <tr>
+>     <td><code>data/TWiki/%RED%Skin%ENDCOLOR%Skin%RED%Script%ENDCOLOR%Template.txt</code></td>
+>     <td><code>data/TWiki/%RED%Script%ENDCOLOR%Template.txt</code></td>
+>   </tr>
+>   <tr>
+>     <td colspan="2"><strong>Legend:</strong> %BB% %RED%script%ENDCOLOR% refers to the script name, e.g <code>view</code>, <code>edit</code> %BB% %RED%Script%ENDCOLOR% refers to the same, but with the first character capitalized, e.g <code>View</code> %BB% %RED%skin%ENDCOLOR% refers to the skin name, e.g <code>dragon</code>, <code>pattern</code> %BB% %RED%Skin%ENDCOLOR% refers to the same, but with the first character capitalized, e.g <code>Dragon</code> %BB% <code>%WEB%</code> refers to the current web </td>
+>   </tr>
+> </table>
+
+Additionally (and primarily for use in `%TMPL:INCLUDE{}%`) the template name may be a wiki topic name, specified as `%RED%Web%ENDCOLOR%.%RED%Topic%ENDCOLOR%`, in which case the search is:
+
+> <table border="1" cellpadding="0" cellspacing="0">
+>   <tr>
+>     <th bgcolor="#99CCCC"><strong> If a skin is specified </strong></th>
+>     <th bgcolor="#99CCCC"><strong> If no skin is specified </strong></th>
+>   </tr>
+>   <tr>
+>     <td><code>templates/%RED%web%ENDCOLOR%/%RED%Web%ENDCOLOR%.%RED%Topic%ENDCOLOR%.%RED%skin%ENDCOLOR%.tmpl</code></td>
+>     <td><code>templates/%RED%web%ENDCOLOR%/%RED%Web%ENDCOLOR%.%RED%Topic%ENDCOLOR%.tmpl</code></td>
+>   </tr>
+>   <tr>
+>     <td><code>templates/%RED%Web%ENDCOLOR%.%RED%Topic%ENDCOLOR%.%RED%skin%ENDCOLOR%.tmpl</code></td>
+>     <td><code>templates/%RED%Web%ENDCOLOR%.%RED%Topic%ENDCOLOR%.tmpl</code></td>
+>   </tr>
+>   <tr>
+>     <td align="center" colspan="2"><code>data/%RED%Web%ENDCOLOR%/%RED%Topic%ENDCOLOR%.txt</code></td>
+>   </tr>
+> </table>
+
+If %RED%Web%ENDCOLOR% is not specified in the INCLUDE, it defaults to TWiki, and the search to the first type.
 
 Special variables are used in templates, especially in `view`, to display [[meta data|Main/TWikiMetaData#MetaDataRendering]].
 
@@ -252,6 +299,10 @@ The `edit` scipt understands the following parameters, typically supplied by HTM
 >     <td> Assuming the template topic has a form with a field called "TopicClassification", it will set the value of the field </td>
 >   </tr>
 >   <tr>
+>     <td><code>contenttype</code></td>
+>     <td> Optional parameter that defines the application type to write into the CGI header. Defaults to <code>text/html</code>. May be used to invoke alternative client applications </td>
+>   </tr>
+>   <tr>
 >     <td><code>anyname</code></td>
 >     <td> Any parameter can passed to the new topic; if the template topic contains <code>%URLPARAM{"anyname"}%</code>, it will be replaced by its value </td>
 >   </tr>
@@ -357,4 +408,4 @@ With URL: <code>**.../bin/oops/Sandbox/TestTopic2?template=oopstest&amp;param1=W
 
 - A drawback of referring to a master template is that you can only test a template from within TWiki, where the include variables are resolved. In the previous system, each template was a structurally complete HTML document with a `.tmpl` filename extension - it contained unresolved `%VARIABLES%`, but could still be previewed directly in a browser.
 
--- TWiki:Main.PeterThoeny - 25 Apr 2004 %BR% -- TWiki:Main.MikeMannix - 14 Sep 2001 %BR% -- TWiki:Main.DavidLeBlanc - 11 Mar 2002
+-- TWiki:Main.CrawfordCurrie - 30 Jun 2004 %BR% -- TWiki:Main.PeterThoeny - 15 Aug 2004 %BR% -- TWiki:Main.MikeMannix - 14 Sep 2001 %BR% -- TWiki:Main.DavidLeBlanc - 11 Mar 2002
index 5298fa7..032795d 100644 (file)
@@ -152,4 +152,4 @@ RCS revision control automatically saves all topic changes. To look at earlier v
 
 See: [[ManagingTopics|Main/TWikiDocumentation#Managing_Topics]] for more details.
 
--- [[MikeMannix]] - 22 May 2002 %BR% -- [[GrantBow]] - 17 Jan 2003 %BR%
+-- TWiki:MikeMannix - 22 May 2002 %BR% -- TWiki::Main.GrantBow - 17 Jan 2003 %BR%
index 7c8afa5..aaea2df 100644 (file)
@@ -27,7 +27,7 @@ No special installation steps are required if the server is already authenticate
 1. **No login at all:** Forget about authentication to make your site completely public - anyone can browse and edit freely, in classic Wiki mode. All visitors are assigned the [[TWikiGuest]] default identity, so you can't track individual user activity.
   - **How:** Default, no web server configuration necessary
 2. **No login to view; require login to edit:** Keeping track of who changed what and when, while keeping view access unrestricted is desirable in most TWiki deployments. This option is not suitable if you need [[TWikiAccessControl]] for view restricted content since TWiki does not know who a user is when looking at content.
-  - **How:** Use Basic Authentication (`.htaccess`) to control access by protecting key scripts: `attach`, `edit`, `installpasswd`, `manage`, `preview`, `rename`, `save`, `upload` using the <code>**.htaccess file**</code>. The [[TWikiInstallationGuide]] has step-by-step instructions.
+  - **How:** Use Basic Authentication to control access by protecting key scripts: `attach`, `edit`, `installpasswd`, `manage`, `preview`, `rename`, `save`, `upload`. The [[TWikiInstallationGuide]] has step-by-step instructions.
 3. **No login to view _unless necessary_; require login to edit:** You prefer not to bother the user with login for unrestricted content, but you need [[TWikiAccessControl]] for view restricted content. There are two ways to accomplish this:
   - **How 1:** Use Basic Authentication with Partial Authentication (described below)
   - **How 2:** Use one of the Session TWiki:Plugins where you give the user the option to login and logout.
@@ -98,4 +98,4 @@ Change and reset passwords using forms on regular pages. Use [[TWikiAccessContro
 
 >
 
--- [[MikeMannix]] - 19 May 2002 %BR% -- [[PeterThoeny]] - 25 Apr 2004
+-- TWiki:Main.MikeMannix - 19 May 2002 %BR% -- TWiki:Main.PeterThoeny - 25 Apr 2004
index 8d446dc..463c57c 100644 (file)
@@ -1,18 +1,15 @@
 <div>
   <ul>
-    <li><a href="#Template Web"> Template Web</a><ul>
-        <li><a href="#Purpose"> Purpose</a></li>
-        <li><a href="#Customizing"> Customizing</a></li>
-      </ul>
-    </li>
+    <li><a href="#Purpose"> Purpose</a></li>
+    <li><a href="#Customizing"> Customizing</a></li>
   </ul>
 </div>
 
-# <a name="Template Web"></a> Template Web
+# <a name="Template Web"></a><a name=" Template Web"></a> Template Web
 
 ## <a name="Purpose"></a> Purpose
 
-Template webs were created to act as templates in creating webs. It is now possible to creation webs via the [[ManagingWebs]] topic. In the not so distant past TWiki webs were created by hand. The data directory contains the different webs such as **Main** and **TWiki**. A web that begins with an underscore "\_" character is considered invisible and a template. All files in the **\_default** (or any other web that begins with an underscore) template web will be copied into your new web. The **\_default** web template contains the following topics: `WebHome, WebChanges, WebIndex, WebNotify, WebPreferences, WebSearch, WebStatistics and WebTopicList.`
+Template webs were created to act as templates in creating webs. It is now possible to creation webs via the [[ManagingWebs]] topic. In the not so distant past TWiki webs were created by hand. The data directory contains the different webs such as **Main** and **TWiki**. A web that begins with an underscore "\_" character is considered invisible and a template. All files in the **\_default** (or any other web that begins with an underscore) template web will be copied into your new web. The [[_default|_default/WebHome]] web template contains the following topics: `WebHome, WebChanges, WebIndex, WebNotify, WebPreferences, WebSearch, WebStatistics and WebTopicList.`
 
 ## <a name="Customizing"></a> Customizing
 
@@ -20,4 +17,4 @@ The web template is useful for administrators to design for creating webs of a c
 
 Simply create a web with an underscore for the first character. These can be used by authorized users to create webs from this template.
 
--- [[GrantBow]] - 16 Jan 2003
+-- TWiki:Main.GrantBow - 16 Jan 2003 %BR% -- TWiki:Main.PeterThoeny - 15 Aug 2004
index db8d55d..98b7369 100644 (file)
@@ -6,4 +6,4 @@ HTML editors are text editors with built-in formatting functions.
 
 Windows **Notepad** is a simple text editor, designed to be small and fast loading, for taking quick notes.
 
--- [[MikeMannix]] - 12 May 2002
+-- TWiki:Main.MikeMannix - 12 May 2002
index 8f987c9..e60ff0d 100644 (file)
-## <a name="Text Formatting FAQ"></a><a name=" Text Formatting FAQ"></a> Text Formatting FAQ
+## <a name="Text Formatting FAQ"></a> 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.
 
 <div>
   <ul>
-    <li><a href="#How do I make a separator?"> How do I make a separator?</a></li>
-    <li><a href="#How do I create a heading?"> How do I create a heading?</a></li>
-    <li><a href="#Text enclosed in angle brackets"> Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?</a></li>
-    <li><a href="#Some words appear highlighted, w"> Some words appear highlighted, with a "?" link at the end. How can I prevent that?</a></li>
-    <li><a href="#How can I write fixed font text?"> How can I write fixed font text?</a></li>
-    <li><a href="#Text I enter gets wrapped around"> Text I enter gets wrapped around. How can I keep the formatting as it is?</a></li>
-    <li><a href="#How do I create tables?"> How do I create tables?</a></li>
-    <li><a href="#Can I include images on a page?"> Can I include images on a page?</a></li>
-    <li><a href="#Can I write colored text?"> Can I write colored text?</a></li>
+    <li><a href="#Text Formatting FAQ"> Text Formatting FAQ</a><ul>
+        <li><a href="#How do I make a separator?"> How do I make a separator?</a></li>
+        <li><a href="#How do I create a heading?"> How do I create a heading?</a></li>
+        <li><a href="#Text enclosed in angle brackets"> Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?</a></li>
+        <li><a href="#Some words appear highlighted, w"> Some words appear highlighted, with a "?" link at the end. How can I prevent that?</a></li>
+        <li><a href="#How can I write fixed font text?"> How can I write fixed font text?</a></li>
+        <li><a href="#Text I enter gets wrapped around"> Text I enter gets wrapped around. How can I keep the formatting as it is?</a></li>
+        <li><a href="#How do I create tables?"> How do I create tables?</a></li>
+        <li><a href="#Can I include images on a page?"> Can I include images on a page?</a></li>
+        <li><a href="#Can I write colored text?"> Can I write colored text?</a></li>
+      </ul>
+    </li>
   </ul>
 </div>
 
-> ----
->
-> ### <a name="How do I make a separator?"></a> How do I make a separator?
->
-> 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 />`--------------`
->
-> ----
->
-> ### <a name="How do I create a heading?"></a> How do I create a heading?
->
-> 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?`.
->
-> - You can insert a nested table of contents, generated from headings, by placing `%TOC%` wherever you like on a page (see [[TWikiVariables]] for more `%TOC%` options).
->
-> ----
->
-> <a name="TextEnclosed"></a>
->
-> ### <a name="Text enclosed in angle brackets"></a><a name="Text enclosed in angle brackets "></a> Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?
->
-> 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.
->
-> If you want to display angle brackets, enter them as HTML codes instead of typing them in directly:
->
-> - `&lt;` = `<`<br />`&gt;` = `>`
->
-> - **_You enter:_** `(a &gt; 0)`
->     **_Result:_** `(a > 0)`
->
-> ----
->
-> ### <a name="Some words appear highlighted, w"></a> Some words appear highlighted, with a "?" link at the end. How can I prevent that?
->
-> 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.
->
-> To prevent auto-linking - say you want to enter a word like JavaScript (the proper spelling!) - prefix the [[WikiStyleWord]] with the special TWiki HTML tag `<nop>`:
->
-> - `<nop>WikiStyleWord` displays as WikiStyleWord
->
-> ----
->
-> ### <a name="How can I write fixed font text?"></a> How can I write fixed font text?
->
-> The quickest way is to enclose the text in equal signs:
->
-> - **_You enter:_** `Proportional text, =fixed font=, proportional again.`
->     **_Result:_** Proportional text, `fixed font`, proportional again.
->
-> ----
->
-> <a name="VerbatimText"></a>
->
-> ### <a name="Text I enter gets wrapped around"></a> 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 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:
->
->     This text will keep its format as it is:
->     <verbatim>
->       Unit     Price Qty  Cost
->       -------  ------  ---  ------
->       aaa             12.00   3      36.00
->     </verbatim>
->
-> 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.
->
-> ----
->
-> ### <a name="How do I create tables?"></a> How do I create tables?
->
-> There are three possibilities:
->
-> 1. Use Wiki rule with "|" vertical bars.
-> 2. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags.
-> 3. Use preformatted text with &lt;verbatim&gt; tags.
->
-> **1\. Use Wiki rule with "|" vertical bars**
->
-> - Example text: <br />`| cell A1 | cell B1 | cell C1 |`<br />`| cell A2 | cell B2 | cell C2 |`
-> - Example output: <table border="1" cellpadding="0" cellspacing="0">
->   <tr>
->     <td> cell A1 </td>
->     <td> cell B1 </td>
->     <td> cell C1 </td>
->   </tr>
->   <tr>
->     <td> cell A2 </td>
->     <td> cell B2 </td>
->     <td> cell C2 </td>
->   </tr>
-> </table>
->
-> **2\. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags**
->
-> This is a manual process using HTML commands.
->
-> **_You enter:_**
->
->     <table border="1">
->       <tr>
->       <th> Head A  </th> <th> Head B  </th>
->       </tr><tr>
->       <td> Cell A2 </td> <td> Cell B2 </td>
->       </tr><tr>
->       <td> Cell A3 </td> <td> Cell B3 </td>
->       </tr>
->     </table>
->
-> **_Result:_**
->
-> <table border="1">
->   <tr>
->     <th> Head A </th>
->     <th> Head B </th>
->   </tr>
->   <tr>
->     <td> Cell A2 </td>
->     <td> Cell B2 </td>
->   </tr>
->   <tr>
->     <td> Cell A3 </td>
->     <td> Cell B3 </td>
->   </tr>
-> </table>
->
-> **3\. Use preformatted text with &lt;verbatim&gt; tags**
->
-> See [["Text I enter gets wrapped around..."|Main/WebHome#VerbatimText]]
->
-> ----
->
-> ### <a name="Can I include images on a page?"></a> Can I include images on a page?
->
-> Yes. The easiest way is to [[attach|Main/FileAttachment]] 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.
->
-> 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|Main/WebHome#ImgUpload]] as a URL.
->
-> - **_You enter:_** ` TWiki http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif logo.`<br />**_Result:_** TWiki ![twikilogo88x31.gif](http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif) logo.
->
-> <a name="ImgUpload"></a> You can upload images directly to your server with FTP access. You can also [[attach|Main/FileAttachment]] 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`<br /> Display with <code>http://www.dementia.org/twiki//view/Someweb/SomeTopic/pic.gif</code>
->
-> **2\. Using &lt;img&gt; tag**
->
-> 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.
->
-> - **_You enter:_** `TWiki <img src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /> logo.`<br />**_Result:_**<br /> TWiki <img src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif" width="88" height="31" alt="logo" /> logo.
->
-> ----
->
-> ### <a name="Can I write colored text?"></a> Can I write colored text?
->
-> [[TWikiPreferences]] defines some commonly used colors: **%YELLOW% %YELLOW%%ENDCOLOR%, %RED% %RED%%ENDCOLOR%, %PINK% %PINK%%ENDCOLOR%, %PURPLE% %PURPLE%%ENDCOLOR%, %TEAL% %TEAL%%ENDCOLOR%, %NAVY% %NAVY%%ENDCOLOR%, %BLUE% %BLUE%%ENDCOLOR%, %AQUA% %AQUA%%ENDCOLOR%, %LIME% %LIME%%ENDCOLOR%, %GREEN% %GREEN%%ENDCOLOR%, %OLIVE% %OLIVE%%ENDCOLOR%, %MAROON% %MAROON%%ENDCOLOR%, %BLACK% %BLACK%%ENDCOLOR%, %GRAY% %GRAY%%ENDCOLOR%, %SILVER% %SILVER%%ENDCOLOR%** and **%ENDCOLOR%**.
->
-> - **_You enter:_** `%RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%`
->     **_Result:_** %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%
->
-> **_Note:_** `%<color>%` text must end with `%ENDCOLOR%` . If you want to switch from one color to another one you first need to end the active color with `%ENDCOLOR%`, e.g. write `%RED% some text %ENDCOLOR% %GREEN% more text %ENDCOLOR%`.
->
-> If you need more colors you can use HTML, like `<font color="#ff0000"> red text </font>`. 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 &amp; NS) browsers have a problem with `style`.
->
-> 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.
->
-> ----
-
--- TWiki:Main.PeterThoeny - 16 Mar 2004 <br /> -- TWiki:Main.MikeMannix - 14 Sep 2001 <br />
+----
+
+### <a name="How do I make a separator?"></a> How do I make a separator?
+
+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 />`--------------`
+
+----
+
+### <a name="How do I create a heading?"></a> How do I create a heading?
+
+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?`.
+
+- You can insert a nested table of contents, generated from headings, by placing `%TOC%` wherever you like on a page (see [[TWikiVariables]] for more `%TOC%` options).
+
+----
+
+<a name="TextEnclosed"></a>
+
+### <a name="Text enclosed in angle brackets"></a><a name="Text enclosed in angle brackets "></a> Text enclosed in angle brackets like &lt;filename&gt; is not displayed. How can I show it as it is?
+
+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.
+
+If you want to display angle brackets, enter them as HTML codes instead of typing them in directly:
+
+- `&lt;` = `<`<br />`&gt;` = `>`
+
+- **_You enter:_** `(a &gt; 0)`
+    **_Result:_** `(a > 0)`
+
+----
+
+### <a name="Some words appear highlighted, w"></a> Some words appear highlighted, with a "?" link at the end. How can I prevent that?
+
+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.
+
+To prevent auto-linking - say you want to enter a word like JavaScript (the proper spelling!) - prefix the [[WikiStyleWord]] with an exclamation point:
+
+- `!WikiStyleWord` displays as WikiStyleWord
+
+----
+
+### <a name="How can I write fixed font text?"></a> How can I write fixed font text?
+
+The quickest way is to enclose the text in equal signs:
+
+- **_You enter:_** `Proportional text, =fixed font=, proportional again.`
+    **_Result:_** Proportional text, `fixed font`, proportional again.
+
+----
+
+<a name="VerbatimText"></a>
+
+### <a name="Text I enter gets wrapped around"></a> 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 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:
+
+    This text will keep its format as it is:
+    <verbatim>
+      Unit       Price Qty  Cost
+      -------  ------  ---  ------
+      aaa               12.00   3      36.00
+    </verbatim>
+
+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.
+
+----
+
+### <a name="How do I create tables?"></a> How do I create tables?
+
+There are three possibilities:
+
+1. Use Wiki rule with "|" vertical bars.
+2. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags.
+3. Use preformatted text with &lt;verbatim&gt; tags.
+
+**1\. Use Wiki rule with "|" vertical bars**
+
+- Example text: <br />`| cell A1 | cell B1 | cell C1 |`<br />`| cell A2 | cell B2 | cell C2 |`
+- Example output: <table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <td> cell A1 </td>
+    <td> cell B1 </td>
+    <td> cell C1 </td>
+  </tr>
+  <tr>
+    <td> cell A2 </td>
+    <td> cell B2 </td>
+    <td> cell C2 </td>
+  </tr>
+</table>
+
+**2\. Use HTML tables with &lt;table&gt;, &lt;tr&gt;, &lt;td&gt; tags**
+
+This is a manual process using HTML commands.
+
+**_You enter:_**
+
+    <table border="1">
+      <tr>
+        <th> Head A  </th> <th> Head B  </th>
+      </tr><tr>
+        <td> Cell A2 </td> <td> Cell B2 </td>
+      </tr><tr>
+        <td> Cell A3 </td> <td> Cell B3 </td>
+      </tr>
+    </table>
+
+**_Result:_**
+
+<table border="1">
+  <tr>
+    <th> Head A </th>
+    <th> Head B </th>
+  </tr>
+  <tr>
+    <td> Cell A2 </td>
+    <td> Cell B2 </td>
+  </tr>
+  <tr>
+    <td> Cell A3 </td>
+    <td> Cell B3 </td>
+  </tr>
+</table>
+
+**3\. Use preformatted text with &lt;verbatim&gt; tags**
+
+See [["Text I enter gets wrapped around..."|Main/WebHome#VerbatimText]]
+
+----
+
+### <a name="Can I include images on a page?"></a> Can I include images on a page?
+
+Yes. The easiest way is to [[attach|Main/FileAttachment]] 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.
+
+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|Main/WebHome#ImgUpload]] as a URL.
+
+- **_You enter:_** ` TWiki http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif logo.`<br />**_Result:_** TWiki ![twikilogo88x31.gif](http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif) logo.
+
+<a name="ImgUpload"></a> You can upload images directly to your server with FTP access. You can also [[attach|Main/FileAttachment]] 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`<br /> Display with <code>http://www.dementia.org/twiki//view/Someweb/SomeTopic/pic.gif</code>
+
+**2\. Using &lt;img&gt; tag**
+
+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.
+
+- **_You enter:_** `TWiki <img src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif" width="88" height="31" border="0" alt="logo" /> logo.`<br />**_Result:_**<br /> TWiki <img src="http://www.dementia.org/twiki//view/TWiki/TWikiLogos/twikilogo88x31.gif" width="88" height="31" alt="logo" /> logo.
+
+----
+
+### <a name="Can I write colored text?"></a> Can I write colored text?
+
+[[TWikiPreferences]] defines some commonly used colors: **%YELLOW% %YELLOW%%ENDCOLOR%, %RED% %RED%%ENDCOLOR%, %PINK% %PINK%%ENDCOLOR%, %PURPLE% %PURPLE%%ENDCOLOR%, %TEAL% %TEAL%%ENDCOLOR%, %NAVY% %NAVY%%ENDCOLOR%, %BLUE% %BLUE%%ENDCOLOR%, %AQUA% %AQUA%%ENDCOLOR%, %LIME% %LIME%%ENDCOLOR%, %GREEN% %GREEN%%ENDCOLOR%, %OLIVE% %OLIVE%%ENDCOLOR%, %MAROON% %MAROON%%ENDCOLOR%, %BLACK% %BLACK%%ENDCOLOR%, %GRAY% %GRAY%%ENDCOLOR%, %SILVER% %SILVER%%ENDCOLOR%** and **%ENDCOLOR%**.
+
+- **_You enter:_** `%RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%`
+    **_Result:_** %RED% red text %ENDCOLOR% and %GREEN% green text %ENDCOLOR%
+
+**_Note:_** `%<color>%` text must end with `%ENDCOLOR%` . If you want to switch from one color to another one you first need to end the active color with `%ENDCOLOR%`, e.g. write `%RED% some text %ENDCOLOR% %GREEN% more text %ENDCOLOR%`.
+
+If you need more colors you can use HTML, like `<font color="#ff0000"> red text </font>`. 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 &amp; NS) browsers have a problem with `style`.
+
+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.
+
+----
+
+-- TWiki:Main.PeterThoeny - 15 Aug 2004 %BR% -- TWiki:Main.MikeMannix - 14 Sep 2001 %BR%
index b95ef74..296dd43 100644 (file)
@@ -1,3 +1,3 @@
 Tim Berners-Lee invented the World Wide Web while working at CERN in 1989. See his biography at <http://www.w3.org/People/Berners-Lee/>
 
--- [[PeterThoeny]] - 12 Jan 2003
+-- TWiki:Main.PeterThoeny - 12 Jan 2003