none
authorMikeMannix <MikeMannix>
Tue, 2 Oct 2001 07:38:10 +0000 (07:38 +0000)
committerMikeMannix <MikeMannix>
Tue, 2 Oct 2001 07:38:10 +0000 (07:38 +0000)
TWiki/TWikiMetaData.mdwn
TWiki/TWikiTopics.mdwn
TWiki/TextFormattingRules.mdwn

index 5a2f0cc..1b1b30a 100644 (file)
@@ -1,6 +1,6 @@
 <div>
   <ul>
-    <li><a href="#TWiki Meta Data"> TWiki Meta Data</a><ul>
+    <li><a href="#Appendix B: TWiki Meta Data"> Appendix B: TWiki Meta Data</a><ul>
         <li><a href="#Overview"> Overview</a></li>
         <li><a href="#Meta Data Syntax"> Meta Data Syntax</a></li>
         <li><a href="#Meta Data Specifications"> Meta Data Specifications</a><ul>
@@ -23,7 +23,7 @@
 
 <a name="MetaDataDefinition"></a>
 
-# <a name="TWiki Meta Data"></a> TWiki Meta Data
+# <a name="Appendix B: TWiki Meta Data"></a> Appendix B: TWiki Meta Data
 
 _Additional topic data, not editable from main freeform text box, stored in `META` variable name/value pairs_
 
@@ -317,4 +317,4 @@ Current support covers:
 
 At present, there is no Meta Data support for Plugins. However, the format is readily extendable and the `Meta.pm` code that supports the format needs only minor alteration.
 
--- [[JohnTalintyre]] - 29 Aug 2001 <br />
+-- [[JohnTalintyre]] - 29 Aug 2001 <br /> -- [[MikeMannix]] - 02 Oct 2001 <br />
index 8904b5b..e7257ab 100644 (file)
@@ -14,50 +14,52 @@ Each page in a TWiki web is called a **_topic_**, defined by its meaningful, des
 
 ## <a name="Page Features"></a> Page Features
 
-A TWiki topic is a self-contained information unit rich in features:
+A TWiki topic is a self-contained information unit, rich in features that include:
 
 - a [[WikiWord]] title that lets you:
   - instantly identify what the page is about
-  - automatically link to it from other pages
+  - autolink to it from other pages simply by typing it in
 - an edit-anywhere collaboration area where you can:
-  - enter plain or fully-HTML formatted text
-  - work with simple TWiki editing shorthand (that includes HTML mark-up and special TWiki functions)
-  - include Web links, images, anything else you can put on a Web page
-- an extra [[forms input|Main/TWikiDocumentation#TWiki_Form_Templates]] option:
-  - store structured info alongside the free-form page content
+  - enter plain or HTML-formatted text
+  - work with simple [[TWikiShorthand]] (the power of HTML plus special TWiki tags)
+  - include links, images, anything else you can put on a regular Web page
+- an optional [[form|Main/TWikiDocumentation#TWiki_Form_Templates]] feature to:
+  - store structured info along with the freeform page content
   - use text fields and boxes, radio buttons, pulldown selector menus, checkboxes
-  - select from one or many different input forms, with all data preserved
-- a [[FileAttachment]] feature that lets you:
+  - select the right input template for each page from a choice of multiple form
+- a [[FileAttachment]] function that allows you to:
   - upload files through your browser to the TWiki server
-  - attach any type of file (documents, images, applications) for viewing or downloading
+  - attach any size and type of file (documents, images, applications) for viewing or downloading
   - make changes and update existing files
-- [[TWiki Skins|Main/TWikiDocumentation#TWiki_Skins]] work on the web level, but can also be used to customize the look of headers and footers on a single pages
+- [[TWiki Skins|Main/TWikiDocumentation#TWiki_Skins]] that work on the web level, but can also be used to customize the look of headers and footers on a single page
 - browser-based controls for [[renaming, moving, and deleting|Main/WebHome#RenamingTopics]] pages:
-  - rename a page and automatically update all the references to it, site-wide
+  - rename a page and automatically update all the links referring to it, site-wide
   - move a page from one TWiki web to another
   - safely delete a topic to a special Trash web (invisible, but accessible to the TWiki administrators if needed)
 - flexible [[access control|Main/TWikiDocumentation#TWiki_Access_Control]]:
-  - independently determine who can see, edit, rename, move or delete topics
+  - independently determine who can view, edit, rename, move or delete topics
   - set permissions by individual users and user groups
 
-Depending on the set-up of your TWiki site and your own user account, you have several or all of the above.
+The configuration of your TWiki site and your own user account determine which of these features you can use.
 
 <a name="RenamingTopics"></a>
 
 ## <a name="How to rename, move or delete a"></a><a name="How to rename, move or delete a "></a> How to rename, move or delete a page
 
-You can now rename, move and delete individual topics from your browser. All three options are available by clicking **More** on the control strip at the bottom of every page. The access settings for a topic, web or entire site may be disabled for one or more of the three options. In any case, all three are similar and extremely self-explanatory.
+You can now rename, move and delete individual topics from your browser. All three options are available by clicking **More** on the control strip at the bottom of every page. Access to one or more of these three options, for a topic, a web or an entire site, may be available to administrators only. In any case, all three are similar and extremely self-explanatory.
 
-1. On the topic you want to change, click **More** &gt; **Rename/move**
+1. On the page you want to change, click **More** &gt; **Rename/move**
 2. To move or delete: select the target web (`Trash` for delete)from the pull-down menu; otherwise, leave on the current web
 3. To rename: fill in a new [[WikiName]] (otherwise, leave the current topic name)
 4. To update occurrences of the topic name on other pages: From the list of pages that link to the topic, check or uncheck each entry as you desire - only checked links will be updated;
 5. Click **Rename/move**: the topic will be renamed and links to the topic updated.
-  - Any problems are listed ; you can change them later.
-  - If a referring page can't be update because it's locked (ex: someone's editing), it appears on an alert. You can missed pages later by again pressing **Rename/move**.
+  - Any problems are listed; you can change them later.
+  - If a referring page can't be update because it's locked (ex: someone is editing), it appears on an alert. You can update missed pages later by again pressing **Rename/move**.
 
-**Note:** Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up.
+%H% Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up.
 
-**Note:** Keep in mind that moving a topic from a view restricted web to a public web or the Trash web will compromize security.
+%X% **NOTE:** Keep in mind that moving a topic from a view-restricted web to a public web or the Trash web will compromise security.
 
 See [[ManagingTopics|Main/TWikiDocumentation#Managing_Topics]] for more details.
+
+-- [[MikeMannix]] - 02 Oct 2001 <br />
index 6879f19..571346c 100644 (file)
@@ -1,6 +1,6 @@
 <div>
   <ul>
-    <li><a href="#TWiki Text Formatting"> TWiki Text Formatting</a><ul>
+    <li><a href="#Appendix C: Text Formatting Rule"> Appendix C: Text Formatting Rules</a><ul>
         <li><a href="#TWiki Editing Shorthand"> TWiki Editing Shorthand</a></li>
         <li><a href="#Using HTML"> Using HTML</a></li>
         <li><a href="#Hyperlinks"> Hyperlinks</a><ul>
@@ -16,7 +16,7 @@
   </ul>
 </div>
 
-# <a name="TWiki Text Formatting"></a> TWiki Text Formatting
+# <a name="Appendix C: Text Formatting Rule"></a> Appendix C: Text Formatting Rules
 
 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 [[WikiWords]]. And TWiki shorthand gives you all the power of HTML with a simple coding system that takes no time to learn. It's all layed out below - refer back to this page in a pop-up window from the **Edit** screen.
 
@@ -319,7 +319,7 @@ TWiki formatting rules are fairly simple to use and quick to type. However, ther
   - **A:** The `'<'` and `'>'` characters have a special meaning in HTML, they define HTML tags. You need to escape them, so write `'&lt;'` instead of `'<'`, and `'&gt;'` instead of `'>'`. <br /> Example: Type `'prog &lt;filename&gt;'` to get `'prog <filename>'`.
 
 - **Q:** Why is the `'&'` character sometimes not displayed?
-  - **A:** The `'&'` character has a special meaning in HTML, it starts a so called character entity, i.e. `'&copy;'` is the `©` copyright character. You need to escape `'&'` to see it as it is, so write `'&amp;'` instead of `'&'`. <br /> Example: Type `'This &amp; that'` to get `'This & that'`.
+  - **A:** The `'&'` character has a special meaning in HTML, it starts a so called character entity, ex: `'&copy;'` is the `©` copyright character. You need to escape `'&'` to see it as it is, so write `'&amp;'` instead of `'&'`. <br /> Example: Type `'This &amp; that'` to get `'This & that'`.
 
 ## <a name="TWiki Plugins"></a> TWiki Plugins
 
@@ -337,4 +337,4 @@ Plugins provide additional text formatting capabilities and can extend the funct
 
 Check on current Plugin status and settings for this site in [[TWikiPreferences]].
 
--- [[MikeMannix]] - 30 Aug 2001
+-- [[MikeMannix]] - 02 Oct 2001 <br />