data/TWiki/TWikiMetaData.txt,v
changeset 0 414e01d06fd5
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/data/TWiki/TWikiMetaData.txt,v	Sat Jan 26 15:50:53 2008 +0100
     1.3 @@ -0,0 +1,1051 @@
     1.4 +head	1.20;
     1.5 +access;
     1.6 +symbols;
     1.7 +locks; strict;
     1.8 +comment	@# @;
     1.9 +
    1.10 +
    1.11 +1.20
    1.12 +date	2008.01.22.03.21.34;	author TWikiContributor;	state Exp;
    1.13 +branches;
    1.14 +next	1.19;
    1.15 +
    1.16 +1.19
    1.17 +date	2007.01.16.04.11.57;	author TWikiContributor;	state Exp;
    1.18 +branches;
    1.19 +next	1.18;
    1.20 +
    1.21 +1.18
    1.22 +date	2006.04.01.05.55.13;	author TWikiContributor;	state Exp;
    1.23 +branches;
    1.24 +next	1.17;
    1.25 +
    1.26 +1.17
    1.27 +date	2006.02.01.12.01.19;	author TWikiContributor;	state Exp;
    1.28 +branches;
    1.29 +next	1.16;
    1.30 +
    1.31 +1.16
    1.32 +date	2004.08.15.09.54.47;	author PeterThoeny;	state Exp;
    1.33 +branches;
    1.34 +next	1.15;
    1.35 +
    1.36 +1.15
    1.37 +date	2004.01.25.02.24.09;	author PeterThoeny;	state Exp;
    1.38 +branches;
    1.39 +next	1.14;
    1.40 +
    1.41 +1.14
    1.42 +date	2004.01.16.07.10.44;	author PeterThoeny;	state Exp;
    1.43 +branches;
    1.44 +next	1.13;
    1.45 +
    1.46 +1.13
    1.47 +date	2003.07.26.20.52.23;	author PeterThoeny;	state Exp;
    1.48 +branches;
    1.49 +next	1.12;
    1.50 +
    1.51 +1.12
    1.52 +date	2003.06.18.21.19.00;	author PeterThoeny;	state Exp;
    1.53 +branches;
    1.54 +next	1.11;
    1.55 +
    1.56 +1.11
    1.57 +date	2002.12.11.07.30.00;	author PeterThoeny;	state Exp;
    1.58 +branches;
    1.59 +next	1.10;
    1.60 +
    1.61 +1.10
    1.62 +date	2002.01.12.23.23.53;	author MikeMannix;	state Exp;
    1.63 +branches;
    1.64 +next	1.9;
    1.65 +
    1.66 +1.9
    1.67 +date	2001.12.03.12.53.00;	author MikeMannix;	state Exp;
    1.68 +branches;
    1.69 +next	1.8;
    1.70 +
    1.71 +1.8
    1.72 +date	2001.10.02.07.38.10;	author MikeMannix;	state Exp;
    1.73 +branches;
    1.74 +next	1.7;
    1.75 +
    1.76 +1.7
    1.77 +date	2001.09.16.05.57.08;	author MikeMannix;	state Exp;
    1.78 +branches;
    1.79 +next	1.6;
    1.80 +
    1.81 +1.6
    1.82 +date	2001.09.14.09.05.09;	author PeterThoeny;	state Exp;
    1.83 +branches;
    1.84 +next	1.5;
    1.85 +
    1.86 +1.5
    1.87 +date	2001.09.12.06.56.27;	author MikeMannix;	state Exp;
    1.88 +branches;
    1.89 +next	1.4;
    1.90 +
    1.91 +1.4
    1.92 +date	2001.09.08.14.30.25;	author MikeMannix;	state Exp;
    1.93 +branches;
    1.94 +next	1.3;
    1.95 +
    1.96 +1.3
    1.97 +date	2001.09.07.13.13.06;	author MikeMannix;	state Exp;
    1.98 +branches;
    1.99 +next	1.2;
   1.100 +
   1.101 +1.2
   1.102 +date	2001.08.30.20.50.27;	author MikeMannix;	state Exp;
   1.103 +branches;
   1.104 +next	1.1;
   1.105 +
   1.106 +1.1
   1.107 +date	2001.08.30.16.20.58;	author MikeMannix;	state Exp;
   1.108 +branches;
   1.109 +next	;
   1.110 +
   1.111 +
   1.112 +desc
   1.113 +@none
   1.114 +@
   1.115 +
   1.116 +
   1.117 +1.20
   1.118 +log
   1.119 +@buildrelease
   1.120 +@
   1.121 +text
   1.122 +@%META:TOPICINFO{author="TWikiContributor" date="1168737391" format="1.1" version="20"}%
   1.123 +%STARTINCLUDE%
   1.124 +#TWikiMetaData
   1.125 +---+ TWiki Meta Data
   1.126 +
   1.127 +_Additional topic data, program-generated or from TWikiForms, is stored embedded in the topic text using =META:= tags_
   1.128 +
   1.129 +%TOC%
   1.130 +
   1.131 +---++ Overview
   1.132 +
   1.133 +By default, TWiki stores topics in files on disk, in a really simple and obvious directory structure. The big advantage of this approach is that it makes it really easy to manipulate topics from outside TWiki, and is also very safe; there are no complex binary indexes to maintain, and moving a topic from one TWiki to another is as simple as copying a couple of text files.
   1.134 +
   1.135 +To keep eveything together in one place, TWiki uses a simple method for embedding additional data (program-generated or from TWikiForms) in topics. It does this using =META:= tags.
   1.136 +
   1.137 +=META:= data includes program-generated info like FileAttachment and topic movement data, and user-defined TWikiForms info.
   1.138 +
   1.139 +---++ Meta Data Syntax
   1.140 +
   1.141 +   * Format is the same as in TWikiVariables, except all fields have a key.
   1.142 +      * =%<nop>META:&lt;type&gt;{key1="value1" key2="value2" ...}%=
   1.143 +
   1.144 +   * Order of fields within the meta variables is not defined, except that if there is a field with key =name=, this appears first for easier searching (note the order of the variables themselves is defined).
   1.145 +
   1.146 +   * Each meta variable is on one line.
   1.147 +
   1.148 +   * Values in meta-data are URL encoded so that characters such as \n can be stored.
   1.149 +
   1.150 +<blockquote>
   1.151 +*Example of Format*
   1.152 +<pre>
   1.153 +%<nop>META:TOPICINFO{version="1.6" date="976762663" author="LastEditorWikiName" format="1.0"}%
   1.154 +   text of the topic
   1.155 +%<nop>META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName"
   1.156 +   by="TopicMoverWikiName" date="976762680"}%
   1.157 +%<nop>META:TOPICPARENT{name="NavigationByTopicContext"}%
   1.158 +%<nop>META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }%
   1.159 +%<nop>META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }%
   1.160 +%<nop>META:FORM{name="WebFormTemplate"}%
   1.161 +%<nop>META:FIELD{name="OperatingSystem" value="OsWin"}%
   1.162 +%<nop>META:FIELD{name="TopicClassification" value="PublicFAQ"}%
   1.163 +</pre>
   1.164 +</blockquote>
   1.165 +
   1.166 +---++ Meta Data Specifications
   1.167 +
   1.168 +The current version of Meta Data is 1.0, with support for the following variables.
   1.169 +
   1.170 +---+++ META:TOPICINFO
   1.171 +
   1.172 +|  *Key*  |  *Comment*          |
   1.173 +| version | Same as RCS version |
   1.174 +| date    | integer, unix time, seconds since start 1970 |
   1.175 +| author  | last to change topic, is the REMOTE_USER |
   1.176 +| format  | Format of this topic, will be used for automatic format conversion |
   1.177 +
   1.178 +---+++ META:TOPICMOVED
   1.179 +
   1.180 +This is optional, exists if topic has ever been moved.  If a topic is moved more than once, only the most recent META:TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history.
   1.181 +
   1.182 +=%<nop>META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName" by="talintj" date="976762680"}%=
   1.183 +
   1.184 +|  *Key*  |  *Comment*          |
   1.185 +| from | Full name, i.e., web.topic |
   1.186 +| to   | Full name, i.e., web.topic |
   1.187 +| by   | Who did it, is the REMOTE_USER, not <nop>WikiName |
   1.188 +| date | integer, unix time, seconds since start 1970 |
   1.189 +
   1.190 +Notes: 
   1.191 +   * at present version number is not supported directly, it can be inferred from the RCS history.
   1.192 +   * there is only one META:TOPICMOVED in a topic, older move information can be found in the RCS history.
   1.193 + 
   1.194 +---+++ META:TOPICPARENT
   1.195 +
   1.196 +| *Key*   | *Comment* |
   1.197 +| name    | The topic from which this was created, typically when clicking on a =?= questionmark link, or by filling out a form.  Normally just =TopicName=, but it can be a full =Web.TopicName= format if the parent is in a different Web. |
   1.198 +
   1.199 +---+++ META:FILEATTACHMENT
   1.200 +
   1.201 +| *Key*   | *Comment* |
   1.202 +| name    | Name of file, no path.  Must be unique within topic |
   1.203 +| version | Same as RCS revision  |
   1.204 +| path    | Full path file was loaded from |
   1.205 +| size    | In bytes |
   1.206 +| date    | integer, unix time, seconds since start 1970 |
   1.207 +| user    | the REMOTE_USER, not <nop>WikiName |
   1.208 +| comment | As supplied when file uploaded |
   1.209 +| attr    | =h= if hidden, optional |
   1.210 +
   1.211 +Extra fields that are added if an attachment is moved:
   1.212 +
   1.213 +| *Key*   | *Comment* |
   1.214 +| movedfrom | full topic name - web.topic |
   1.215 +| movedby   | the REMOTE_USER, not <nop>WikiName |
   1.216 +| movedto   | full topic name - web.topic |
   1.217 +| moveddate | integer, unix time, seconds since start 1970 |
   1.218 +
   1.219 +---+++ META:FORM
   1.220 +
   1.221 +| *Key*   | *Comment* |
   1.222 +| name    | A topic name - the topic represents one of the TWikiForms.  Can optionally include the web name (i.e., web.topic), but doesn't normally |
   1.223 +
   1.224 +---+++ META:FIELD
   1.225 +
   1.226 +Should only be present if there is a META:FORM entry.  Note that this data is used when viewing a topic, the form template definition is not read.
   1.227 +
   1.228 +| *Key*   | *Name*   |
   1.229 +| name    | Ties to entry in TWikiForms template, is title with all bar alphanumerics and . removed |
   1.230 +| title   | Full text from TWikiForms template |
   1.231 +| value   | Value user has supplied via form |
   1.232 +
   1.233 +---+++ Recommended Sequence
   1.234 +
   1.235 +There is no absolute need for Meta Data variables to be listed in a specific order within a topic, but it makes sense to do so a couple of good reasons:
   1.236 +
   1.237 +   * form fields remain in the order they are defined
   1.238 +   * the =diff= function output appears in a logical order
   1.239 +
   1.240 +The recommended sequence is:
   1.241 +
   1.242 +   * =META:TOPICINFO=
   1.243 +   * =META:TOPICPARENT= (optional)
   1.244 +   * text of topic
   1.245 +   * =META:TOPICMOVED= (optional)
   1.246 +   * =META:FILEATTACHMENT= (0 or more entries)
   1.247 +   * =META:FORM= (optional)
   1.248 +   * =META:FIELD= (0 or more entries; FORM required)
   1.249 +
   1.250 +---++ Viewing Meta Data in Page Source
   1.251 +
   1.252 +When viewing a topic the ==Raw Text== link can be clicked to show the text of a topic (i.e., as seen when editing).  This is done by adding <code>raw=on</code> to URL.  <code>raw=debug</code> shows the meta data as well as the topic data, ex: <a href="%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?raw=debug">debug view for this topic</a>
   1.253 +
   1.254 +#MetaDataRendering
   1.255 +---++ Rendering Meta Data
   1.256 +
   1.257 +Meta Data is rendered with the %<nop>META% variable. This is mostly used in the =view=, =preview= and =edit= scripts.
   1.258 +
   1.259 +You can render form fields in topic text by using the FORMFIELD variable. Example:%BR%
   1.260 +=%<nop>FORMFIELD{"TopicClassification"}%= %BR%
   1.261 +For details, see VarFORMFIELD.
   1.262 +
   1.263 +Current support covers:
   1.264 +
   1.265 +| *Variable usage:*   | *Comment:*  |
   1.266 +| =%<nop>META{"form"}%= | Show form data, see TWikiForms. |
   1.267 +| =%<nop>META{"formfield"}%= | Show form field value. Parameter: ==name="field_name"==. Example:%BR% =%<nop>META{ "formfield" name="TopicClassification" }%= |
   1.268 +| =%<nop>META{"attachments"}%= | Show attachments, except for hidden ones. Options: <br /> \
   1.269 +    ==all="on"==: Show all attachments, including hidden ones. |
   1.270 +| =%<nop>META{"moved"}%= | Details of any topic moves. |
   1.271 +| =%<nop>META{"parent"}%= | Show topic parent. Options: <br /> \
   1.272 +    ==dontrecurse="on"==: By default recurses up tree, at some cost. <br /> \
   1.273 +    ==nowebhome="on"==: Suppress <nop>%HOMETOPIC%. <br /> \
   1.274 +    ==prefix="..."==: Prefix for parents, only if there are parents, default =""=. <br /> \
   1.275 +    ==suffix="..."==: Suffix, only appears if there are parents, default =""=. <br /> \
   1.276 +    ==separator="..."==: Separator between parents, default is =" &gt; "=. |
   1.277 +
   1.278 +__Note:__ SEARCH can also be used to render meta data, see examples in FormattedSearch and SearchPatternCookbook.
   1.279 +
   1.280 +__Related Topics:__ DeveloperDocumentationCategory, UserDocumentationCategory
   1.281 +
   1.282 +@
   1.283 +
   1.284 +
   1.285 +1.19
   1.286 +log
   1.287 +@buildrelease
   1.288 +@
   1.289 +text
   1.290 +@d1 1
   1.291 +a1 2
   1.292 +%META:TOPICINFO{author="TWikiContributor" date="1168737391" format="1.1" version="19"}%
   1.293 +%TOC%
   1.294 +d4 3
   1.295 +a6 1
   1.296 +---# TWiki Meta Data
   1.297 +d8 1
   1.298 +a8 1
   1.299 +_Additional topic data, program-generated or from TWikiForms, is stored in =META= variable name/value pairs_
   1.300 +d12 5
   1.301 +a16 1
   1.302 +TWikiMetaData uses =META= variables to store topic data that's separate from the main free-form content. This includes program-generated info like FileAttachment and topic movement data, and user-defined TWikiForms info. Use =META= variables to format and display Meta Data.  
   1.303 +d27 1
   1.304 +a27 1
   1.305 +   * =\n= (new line) is represented in values by =%<nop>_<nop>N_<nop>= and ="= (double-quotes) by =%<nop>_Q_%=.
   1.306 +a158 5
   1.307 +---++ Known Issues
   1.308 +
   1.309 +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.
   1.310 +
   1.311 +
   1.312 +a160 1
   1.313 +-- __Contributors:__ TWiki:Main.JohnTalintyre, TWiki:Main.MikeMannix, TWiki:Main.PeterThoeny, TWiki:Main.CrawfordCurrie
   1.314 +@
   1.315 +
   1.316 +
   1.317 +1.18
   1.318 +log
   1.319 +@buildrelease
   1.320 +@
   1.321 +text
   1.322 +@d1 1
   1.323 +a1 1
   1.324 +%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="18"}%
   1.325 +d24 1
   1.326 +a24 1
   1.327 +<blockquote style="background-color:#f0f0f0">
   1.328 +d71 1
   1.329 +a71 1
   1.330 +| name    | The topic from which this was created, %HOMETOPIC% if done from =Go=, othewise topic where =?= or form used.  Normally just topic, but is full web.topic format if parent is in a different Web.  Renaming a Web will then only break a few of these references or they can be scanned and fixed. |
   1.331 +d152 2
   1.332 +d161 1
   1.333 +a161 1
   1.334 +
   1.335 +@
   1.336 +
   1.337 +
   1.338 +1.17
   1.339 +log
   1.340 +@buildrelease
   1.341 +@
   1.342 +text
   1.343 +@d1 1
   1.344 +a1 1
   1.345 +%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="17"}%
   1.346 +d15 2
   1.347 +a16 2
   1.348 +	* Format is the same as in TWikiVariables, except all fields have a key.
   1.349 +		* =%<nop>META:&lt;type&gt;{key1="value1" key2="value2" ...}%=
   1.350 +d18 1
   1.351 +a18 1
   1.352 +	* Order of fields within the meta variables is not defined, except that if there is a field with key =name=, this appears first for easier searching (note the order of the variables themselves is defined).
   1.353 +d20 1
   1.354 +a20 1
   1.355 +	* Each meta variable is on one line.
   1.356 +d22 1
   1.357 +a22 1
   1.358 +	* =\n= (new line) is represented in values by =%<nop>_<nop>N_<nop>= and ="= (double-quotes) by =%<nop>_Q_%=.
   1.359 +d28 1
   1.360 +a28 1
   1.361 +	text of the topic
   1.362 +d30 1
   1.363 +a30 1
   1.364 +	by="TopicMoverWikiName" date="976762680"}%
   1.365 +d46 1
   1.366 +a46 1
   1.367 +|  *Key*  |  *Comment*			 |
   1.368 +d48 1
   1.369 +a48 1
   1.370 +| date	 | integer, unix time, seconds since start 1970 |
   1.371 +d58 1
   1.372 +a58 1
   1.373 +|  *Key*  |  *Comment*			 |
   1.374 +d60 2
   1.375 +a61 2
   1.376 +| to	| Full name, i.e., web.topic |
   1.377 +| by	| Who did it, is the REMOTE_USER, not <nop>WikiName |
   1.378 +d65 2
   1.379 +a66 2
   1.380 +	* at present version number is not supported directly, it can be inferred from the RCS history.
   1.381 +	* there is only one META:TOPICMOVED in a topic, older move information can be found in the RCS history.
   1.382 +d70 2
   1.383 +a71 2
   1.384 +| *Key*	| *Comment* |
   1.385 +| name	 | The topic from which this was created, %HOMETOPIC% if done from =Go=, othewise topic where =?= or form used.  Normally just topic, but is full web.topic format if parent is in a different Web.  Renaming a Web will then only break a few of these references or they can be scanned and fixed. |
   1.386 +d75 2
   1.387 +a76 2
   1.388 +| *Key*	| *Comment* |
   1.389 +| name	 | Name of file, no path.  Must be unique within topic |
   1.390 +d78 4
   1.391 +a81 4
   1.392 +| path	 | Full path file was loaded from |
   1.393 +| size	 | In bytes |
   1.394 +| date	 | integer, unix time, seconds since start 1970 |
   1.395 +| user	 | the REMOTE_USER, not <nop>WikiName |
   1.396 +d83 1
   1.397 +a83 1
   1.398 +| attr	 | =h= if hidden, optional |
   1.399 +d87 1
   1.400 +a87 1
   1.401 +| *Key*	| *Comment* |
   1.402 +d89 2
   1.403 +a90 2
   1.404 +| movedby	| the REMOTE_USER, not <nop>WikiName |
   1.405 +| movedto	| full topic name - web.topic |
   1.406 +d95 2
   1.407 +a96 2
   1.408 +| *Key*	| *Comment* |
   1.409 +| name	 | A topic name - the topic represents one of the TWikiForms.  Can optionally include the web name (i.e., web.topic), but doesn't normally |
   1.410 +d102 4
   1.411 +a105 4
   1.412 +| *Key*	| *Name*	|
   1.413 +| name	 | Ties to entry in TWikiForms template, is title with all bar alphanumerics and . removed |
   1.414 +| title	| Full text from TWikiForms template |
   1.415 +| value	| Value user has supplied via form |
   1.416 +d111 2
   1.417 +a112 2
   1.418 +	* form fields remain in the order they are defined
   1.419 +	* the =diff= function output appears in a logical order
   1.420 +d116 7
   1.421 +a122 7
   1.422 +	* =META:TOPICINFO=
   1.423 +	* =META:TOPICPARENT= (optional)
   1.424 +	* text of topic
   1.425 +	* =META:TOPICMOVED= (optional)
   1.426 +	* =META:FILEATTACHMENT= (0 or more entries)
   1.427 +	* =META:FORM= (optional)
   1.428 +	* =META:FIELD= (0 or more entries; FORM required)
   1.429 +d135 1
   1.430 +a135 1
   1.431 +For details, see TWikiVariables#VarFORMFIELD.
   1.432 +d139 1
   1.433 +a139 1
   1.434 +| *Variable usage:*	| *Comment:*  |
   1.435 +d143 1
   1.436 +a143 1
   1.437 +	 ==all="on"==: Show all attachments, including hidden ones. |
   1.438 +d146 5
   1.439 +a150 5
   1.440 +	 ==dontrecurse="on"==: By default recurses up tree, at some cost. <br /> \
   1.441 +	 ==nowebhome="on"==: Suppress <nop>%HOMETOPIC%. <br /> \
   1.442 +	 ==prefix="..."==: Prefix for parents, only if there are parents, default =""=. <br /> \
   1.443 +	 ==suffix="..."==: Suffix, only appears if there are parents, default =""=. <br /> \
   1.444 +	 ==separator="..."==: Separator between parents, default is =" &gt; "=. |
   1.445 +@
   1.446 +
   1.447 +
   1.448 +1.16
   1.449 +log
   1.450 +@none
   1.451 +@
   1.452 +text
   1.453 +@d1 1
   1.454 +a1 2
   1.455 +%META:TOPICINFO{author="PeterThoeny" date="1092563687" format="1.0" version="1.16"}%
   1.456 +%META:TOPICPARENT{name="WebHome"}%
   1.457 +d4 1
   1.458 +a4 1
   1.459 +#MetaDataDefinition
   1.460 +d27 1
   1.461 +a27 1
   1.462 +%<nop>META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}%
   1.463 +d30 1
   1.464 +a30 1
   1.465 +	by="JohnTalintyre" date="976762680"}%
   1.466 +d126 1
   1.467 +a126 1
   1.468 +When viewing a topic the ==Raw Text== link can be clicked to show the text of a topic (i.e., as seen when editing).  This is done by adding <code>raw=on</code> to URL.  <code>raw=debug</code> shows the meta data as well as the topic data, ex: <a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?raw=debug">debug view for this topic</a>
   1.469 +d133 3
   1.470 +a135 1
   1.471 +__Note:__ Rendering meta data is currently not supported in topic text. As a workaround, use FormattedSearch on the current topic only to render form fields.
   1.472 +d142 1
   1.473 +a142 1
   1.474 +| =%<nop>META{"attachments"}%= | Show attachments, except for hidden ones. Options: <br > \
   1.475 +d156 3
   1.476 +a158 3
   1.477 +-- TWiki:Main.JohnTalintyre - 29 Aug 2001 %BR%
   1.478 +-- TWiki:Main.MikeMannix - 03 Dec 2001 %BR%
   1.479 +-- TWiki:Main.PeterThoeny - 15 Aug 2004
   1.480 +@
   1.481 +
   1.482 +
   1.483 +1.15
   1.484 +log
   1.485 +@none
   1.486 +@
   1.487 +text
   1.488 +@d1 1
   1.489 +a1 1
   1.490 +%META:TOPICINFO{author="PeterThoeny" date="1074997449" format="1.0" version="1.15"}%
   1.491 +d3 156
   1.492 +a158 155
   1.493 +%TOC%
   1.494 +%STARTINCLUDE%
   1.495 +#MetaDataDefinition
   1.496 +---# TWiki Meta Data
   1.497 +
   1.498 +_Additional topic data, program-generated or from TWikiForms, is stored in =META= variable name/value pairs_
   1.499 +
   1.500 +---++ Overview
   1.501 +
   1.502 +TWikiMetaData uses =META= variables to store topic data that's separate from the main free-form content. This includes program-generated info like FileAttachment and topic movement data, and user-defined TWikiForms info. Use =META= variables to format and display Meta Data.  
   1.503 +
   1.504 +---++ Meta Data Syntax
   1.505 +
   1.506 +	* Format is the same as in TWikiVariables, except all fields have a key.
   1.507 +		* =%<nop>META:&lt;type&gt;{key1="value1" key2="value2" ...}%=
   1.508 +
   1.509 +	* Order of fields within the meta variables is not defined, except that if there is a field with key =name=, this appears first for easier searching (note the order of the variables themselves is defined).
   1.510 +
   1.511 +	* Each meta variable is on one line.
   1.512 +
   1.513 +	* =\n= (new line) is represented in values by =%<nop>_<nop>N_<nop>= and ="= (double-quotes) by =%<nop>_Q_%=.
   1.514 +
   1.515 +<blockquote style="background-color:#f0f0f0">
   1.516 +*Example of Format*
   1.517 +<pre>
   1.518 +%<nop>META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}%
   1.519 +	text of the topic
   1.520 +%<nop>META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName"
   1.521 +	by="JohnTalintyre" date="976762680"}%
   1.522 +%<nop>META:TOPICPARENT{name="NavigationByTopicContext"}%
   1.523 +%<nop>META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }%
   1.524 +%<nop>META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }%
   1.525 +%<nop>META:FORM{name="WebFormTemplate"}%
   1.526 +%<nop>META:FIELD{name="OperatingSystem" value="OsWin"}%
   1.527 +%<nop>META:FIELD{name="TopicClassification" value="PublicFAQ"}%
   1.528 +</pre>
   1.529 +</blockquote>
   1.530 +
   1.531 +---++ Meta Data Specifications
   1.532 +
   1.533 +The current version of Meta Data is 1.0, with support for the following variables.
   1.534 +
   1.535 +---+++ META:TOPICINFO
   1.536 +
   1.537 +|  *Key*  |  *Comment*			 |
   1.538 +| version | Same as RCS version |
   1.539 +| date	 | integer, unix time, seconds since start 1970 |
   1.540 +| author  | last to change topic, is the REMOTE_USER |
   1.541 +| format  | Format of this topic, will be used for automatic format conversion |
   1.542 +
   1.543 +---+++ META:TOPICMOVED
   1.544 +
   1.545 +This is optional, exists if topic has ever been moved.  If a topic is moved more than once, only the most recent META:TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history.
   1.546 +
   1.547 +=%<nop>META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName" by="talintj" date="976762680"}%=
   1.548 +
   1.549 +|  *Key*  |  *Comment*			 |
   1.550 +| from | Full name, i.e., web.topic |
   1.551 +| to	| Full name, i.e., web.topic |
   1.552 +| by	| Who did it, is the REMOTE_USER, not <nop>WikiName |
   1.553 +| date | integer, unix time, seconds since start 1970 |
   1.554 +
   1.555 +Notes: 
   1.556 +	* at present version number is not supported directly, it can be inferred from the RCS history.
   1.557 +	* there is only one META:TOPICMOVED in a topic, older move information can be found in the RCS history.
   1.558 + 
   1.559 +---+++ META:TOPICPARENT
   1.560 +
   1.561 +| *Key*	| *Comment* |
   1.562 +| name	 | The topic from which this was created, %HOMETOPIC% if done from =Go=, othewise topic where =?= or form used.  Normally just topic, but is full web.topic format if parent is in a different Web.  Renaming a Web will then only break a few of these references or they can be scanned and fixed. |
   1.563 +
   1.564 +---+++ META:FILEATTACHMENT
   1.565 +
   1.566 +| *Key*	| *Comment* |
   1.567 +| name	 | Name of file, no path.  Must be unique within topic |
   1.568 +| version | Same as RCS revision  |
   1.569 +| path	 | Full path file was loaded from |
   1.570 +| size	 | In bytes |
   1.571 +| date	 | integer, unix time, seconds since start 1970 |
   1.572 +| user	 | the REMOTE_USER, not <nop>WikiName |
   1.573 +| comment | As supplied when file uploaded |
   1.574 +| attr	 | =h= if hidden, optional |
   1.575 +
   1.576 +Extra fields that are added if an attachment is moved:
   1.577 +
   1.578 +| *Key*	| *Comment* |
   1.579 +| movedfrom | full topic name - web.topic |
   1.580 +| movedby	| the REMOTE_USER, not <nop>WikiName |
   1.581 +| movedto	| full topic name - web.topic |
   1.582 +| moveddate | integer, unix time, seconds since start 1970 |
   1.583 +
   1.584 +---+++ META:FORM
   1.585 +
   1.586 +| *Key*	| *Comment* |
   1.587 +| name	 | A topic name - the topic represents one of the TWikiForms.  Can optionally include the web name (i.e., web.topic), but doesn't normally |
   1.588 +
   1.589 +---+++ META:FIELD
   1.590 +
   1.591 +Should only be present if there is a META:FORM entry.  Note that this data is used when viewing a topic, the form template definition is not read.
   1.592 +
   1.593 +| *Key*	| *Name*	|
   1.594 +| name	 | Ties to entry in TWikiForms template, is title with all bar alphanumerics and . removed |
   1.595 +| title	| Full text from TWikiForms template |
   1.596 +| value	| Value user has supplied via form |
   1.597 +
   1.598 +---+++ Recommended Sequence
   1.599 +
   1.600 +There is no absolute need for Meta Data variables to be listed in a specific order within a topic, but it makes sense to do so a couple of good reasons:
   1.601 +
   1.602 +	* form fields remain in the order they are defined
   1.603 +	* the =diff= function output appears in a logical order
   1.604 +
   1.605 +The recommended sequence is:
   1.606 +
   1.607 +	* META:TOPICINFO
   1.608 +	* =text of topic=
   1.609 +	* META:TOPICMOVED (optional)
   1.610 +	* META:TOPICPARENT (optional)
   1.611 +	* META:FILEATTACHMENT (0 or more entries)
   1.612 +	* META:FORM (optional)
   1.613 +	* META:FIELD (0 or more entries; FORM required)
   1.614 +
   1.615 +---++ Viewing Meta Data in Page Source
   1.616 +
   1.617 +When viewing a topic the ==Raw Text== link can be clicked to show the text of a topic (i.e., as seen when editing).  This is done by adding <code>raw=on</code> to URL.  <code>raw=debug</code> shows the meta data as well as the topic data, ex: <a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?raw=debug">debug view for this topic</a>
   1.618 +
   1.619 +#MetaDataRendering
   1.620 +---++ Rendering Meta Data
   1.621 +
   1.622 +Meta Data is rendered with the %<nop>META% variable. This is mostly used in the =view=, =preview= and =edit= scripts.
   1.623 +
   1.624 +__Note:__ Rendering meta data is currently not supported in topic text. As a workaround, use FormattedSearch on the current topic only to render form fields.
   1.625 +
   1.626 +Current support covers:
   1.627 +
   1.628 +| *Variable usage:*	| *Comment:*  |
   1.629 +| =%<nop>META{"form"}%= | Show form data, see TWikiForms. |
   1.630 +| =%<nop>META{"formfield"}%= | Show form field value. Parameter: ==name="field_name"==. Example:%BR% =%<nop>META{ "formfield" name="TopicClassification" }%= |
   1.631 +| =%<nop>META{"attachments"}%= | Show attachments, except for hidden ones. Options: <br > \
   1.632 +	 ==all="on"==: Show all attachments, including hidden ones. |
   1.633 +| =%<nop>META{"moved"}%= | Details of any topic moves. |
   1.634 +| =%<nop>META{"parent"}%= | Show topic parent. Options: <br /> \
   1.635 +	 ==dontrecurse="on"==: By default recurses up tree, at some cost. <br /> \
   1.636 +	 ==nowebhome="on"==: Suppress <nop>%HOMETOPIC%. <br /> \
   1.637 +	 ==prefix="..."==: Prefix for parents, only if there are parents, default =""=. <br /> \
   1.638 +	 ==suffix="..."==: Suffix, only appears if there are parents, default =""=. <br /> \
   1.639 +	 ==separator="..."==: Separator between parents, default is =" &gt; "=. |
   1.640 +
   1.641 +---++ Known Issues
   1.642 +
   1.643 +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.
   1.644 +
   1.645 +-- TWiki:Main.JohnTalintyre - 29 Aug 2001 <br />
   1.646 +-- TWiki:Main.MikeMannix - 03 Dec 2001 <br />
   1.647 +-- TWiki:Main.PeterThoeny - 10 Jan 2002
   1.648 +@
   1.649 +
   1.650 +
   1.651 +1.14
   1.652 +log
   1.653 +@none
   1.654 +@
   1.655 +text
   1.656 +@d1 1
   1.657 +a1 1
   1.658 +%META:TOPICINFO{author="PeterThoeny" date="1074237044" format="1.0" version="1.14"}%
   1.659 +d49 1
   1.660 +a49 1
   1.661 +| date	 | integer, unx time, seconds since start 1970 |
   1.662 +d63 1
   1.663 +a63 1
   1.664 +| date | integer, unx time, seconds since start 1970 |
   1.665 +d81 1
   1.666 +a81 1
   1.667 +| date	 | integer, unx time, seconds since start 1970 |
   1.668 +d92 1
   1.669 +a92 1
   1.670 +| moveddate | integer, unx time, seconds since start 1970 |
   1.671 +@
   1.672 +
   1.673 +
   1.674 +1.13
   1.675 +log
   1.676 +@none
   1.677 +@
   1.678 +text
   1.679 +@d1 1
   1.680 +a1 1
   1.681 +%META:TOPICINFO{author="PeterThoeny" date="1059252743" format="1.0" version="1.13"}%
   1.682 +d155 3
   1.683 +a157 3
   1.684 +-- JohnTalintyre - 29 Aug 2001 <br />
   1.685 +-- MikeMannix - 03 Dec 2001 <br />
   1.686 +-- Main.PeterThoeny - 10 Jan 2002
   1.687 +@
   1.688 +
   1.689 +
   1.690 +1.12
   1.691 +log
   1.692 +@none
   1.693 +@
   1.694 +text
   1.695 +@d1 1
   1.696 +a1 1
   1.697 +%META:TOPICINFO{author="PeterThoeny" date="1055971140" format="1.0" version="1.12"}%
   1.698 +d72 1
   1.699 +a72 1
   1.700 +| name	 | The topic from which this was created, WebHome if done from =Go=, othewise topic where =?= or form used.  Normally just topic, but is full web.topic format if parent is in a different Web.  Renaming a Web will then only break a few of these references or they can be scanned and fixed. |
   1.701 +@
   1.702 +
   1.703 +
   1.704 +1.11
   1.705 +log
   1.706 +@none
   1.707 +@
   1.708 +text
   1.709 +@d1 1
   1.710 +a1 1
   1.711 +%META:TOPICINFO{author="PeterThoeny" date="1039591800" format="1.0" version="1.11"}%
   1.712 +d134 2
   1.713 +d140 1
   1.714 +@
   1.715 +
   1.716 +
   1.717 +1.10
   1.718 +log
   1.719 +@none
   1.720 +@
   1.721 +text
   1.722 +@d1 1
   1.723 +a1 1
   1.724 +%META:TOPICINFO{author="MikeMannix" date="1010877833" format="1.0" version="1.10"}%
   1.725 +d48 4
   1.726 +a51 4
   1.727 +	| version | Same as RCS version |
   1.728 +	| date	 | integer, unx time, seconds since start 1970 |
   1.729 +	| author  | last to change topic, is the REMOTE_USER |
   1.730 +	| format  | Format of this topic, will be used for automatic format conversion |
   1.731 +d60 4
   1.732 +a63 4
   1.733 +	| from | Full name i.e. web.topic |
   1.734 +	| to	| Full name i.e. web.topic |
   1.735 +	| by	| Who did it, is the REMOTE_USER, not <nop>WikiName |
   1.736 +	| date | integer, unx time, seconds since start 1970 |
   1.737 +d72 1
   1.738 +a72 1
   1.739 +	| name	 | The topic from which this was created, WebHome if done from =Go=, othewise topic where =?= or form used.  Normally just topic, but is full web.topic format if parent is in a different Web.  Renaming a Web will then only break a few of these references or they can be scanned and fixed. |
   1.740 +d77 8
   1.741 +a84 8
   1.742 +	| name	 | Name of file, no path.  Must be unique within topic |
   1.743 +	| version | Same as RCS revision  |
   1.744 +	| path	 | Full path file was loaded from |
   1.745 +	| size	 | In bytes |
   1.746 +	| date	 | integer, unx time, seconds since start 1970 |
   1.747 +	| user	 | the REMOTE_USER, not <nop>WikiName |
   1.748 +	| comment | As supplied when file uploaded |
   1.749 +	| attr	 | =h= if hidden, optional |
   1.750 +d89 4
   1.751 +a92 4
   1.752 +	| movedfrom | full topic name - web.topic |
   1.753 +	| movedby	| the REMOTE_USER, not <nop>WikiName |
   1.754 +	| movedto	| full topic name - web.topic |
   1.755 +	| moveddate | integer, unx time, seconds since start 1970 |
   1.756 +d97 1
   1.757 +a97 1
   1.758 +	| name	 | A topic name - the topic represents one of the TWikiForms.  Can optionally include the web name i.e. web.topic, but doesn't normally |
   1.759 +d103 4
   1.760 +a106 4
   1.761 +	| *Key*	| *Name*	|
   1.762 +	| name	 | Ties to entry in TWikiForms template, is title with all bar alphanumerics and . removed |
   1.763 +	| title	| Full text from TWikiForms template |
   1.764 +	| value	| Value user has supplied via form |
   1.765 +d127 1
   1.766 +a127 1
   1.767 +When viewing a topic the ==Raw Text== link can be clicked to show the text of a topic (ie: as seen when editing).  This is done by adding <code>raw=on</code> to URL.  <code>raw=debug</code> shows the meta data as well as the topic data, ex: <a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?raw=debug">debug view for this topic</a>
   1.768 +d136 3
   1.769 +a138 3
   1.770 +  | *Variable usage:*	| *Comment:*  |
   1.771 +  | =%<nop>META{"form"}%= | Show form data, see TWikiForms. |
   1.772 +  | =%<nop>META{"attachments"}%= | Show attachments, except for hidden ones. Options: <br > \
   1.773 +d140 2
   1.774 +a141 2
   1.775 +  | =%<nop>META{"moved"}%= | Details of any topic moves. |
   1.776 +  | =%<nop>META{"parent"}%= | Show topic parent. Options: <br /> \
   1.777 +d154 1
   1.778 +a154 1
   1.779 +-- Main.PeterThoeny - 10 Jan 2002
   1.780 +@
   1.781 +
   1.782 +
   1.783 +1.9
   1.784 +log
   1.785 +@none
   1.786 +@
   1.787 +text
   1.788 +@d1 1
   1.789 +a1 1
   1.790 +%META:TOPICINFO{author="MikeMannix" date="1007383980" format="1.0" version="1.9"}%
   1.791 +d137 10
   1.792 +a146 11
   1.793 +  | %<nop>META{"form"}% | Show form data, see TWikiForms |
   1.794 +  | %<nop>META{"attachments"}% | Show attachments, exclude hidden |
   1.795 +  | Options for [[FileAttachments][Attachments]]: | |
   1.796 +  | all="on" | Show ALL attachments (including hidden) |
   1.797 +  | %<nop>META{"moved"}% | Details of any topic moves |
   1.798 +  | %<nop>META{"parent [options]"}% | Show topic parent |
   1.799 +  | Options for parent: | |
   1.800 +  | dontrecurse="on" | By default recurses up tree, at some cost |
   1.801 +  | prefix="..." | Prefix for parents, only if there are parents; default "" |
   1.802 +  | suffix="..." | Suffix, only appears if there are parents; default "" |
   1.803 +  | separator="..." | Separator between parents, default is " > " |
   1.804 +d153 2
   1.805 +a154 1
   1.806 +-- MikeMannix - 03 Dec 2001	
   1.807 +@
   1.808 +
   1.809 +
   1.810 +1.8
   1.811 +log
   1.812 +@none
   1.813 +@
   1.814 +text
   1.815 +@d1 1
   1.816 +a1 1
   1.817 +%META:TOPICINFO{author="MikeMannix" date="1002008290" format="1.0" version="1.8"}%
   1.818 +d6 1
   1.819 +a6 1
   1.820 +---# Appendix B: TWiki Meta Data
   1.821 +d8 1
   1.822 +a8 1
   1.823 +_Additional topic data, not editable from main freeform text box, stored in =META= variable name/value pairs_
   1.824 +d12 1
   1.825 +a12 1
   1.826 +<nop>TWikiMetaData uses =META= variables to store topic data that's separate from the main free-form content. This includes program-generated info like FileAttachment data, and user-defined TWikiForms info.
   1.827 +d154 1
   1.828 +a154 1
   1.829 +-- MikeMannix - 02 Oct 2001 <br />
   1.830 +@
   1.831 +
   1.832 +
   1.833 +1.7
   1.834 +log
   1.835 +@none
   1.836 +@
   1.837 +text
   1.838 +@d1 1
   1.839 +a1 1
   1.840 +%META:TOPICINFO{author="MikeMannix" date="1000619828" format="1.0" version="1.7"}%
   1.841 +d6 1
   1.842 +a6 1
   1.843 +---# TWiki Meta Data
   1.844 +d153 2
   1.845 +a154 1
   1.846 +-- JohnTalintyre - 29 Aug 2001 <br />
   1.847 +@
   1.848 +
   1.849 +
   1.850 +1.6
   1.851 +log
   1.852 +@none
   1.853 +@
   1.854 +text
   1.855 +@d1 1
   1.856 +a1 1
   1.857 +%META:TOPICINFO{author="PeterThoeny" date="1000458670" format="1.0" version="1.6"}%
   1.858 +d8 1
   1.859 +a8 1
   1.860 +_Topic data not editable from main freeform text box, stored in name/value =META= variable pairs_
   1.861 +d153 1
   1.862 +a153 1
   1.863 +-- JohnTalintyre - 29 Aug 2001 <br />
   1.864 +@
   1.865 +
   1.866 +
   1.867 +1.5
   1.868 +log
   1.869 +@none
   1.870 +@
   1.871 +text
   1.872 +@d1 1
   1.873 +a1 1
   1.874 +%META:TOPICINFO{author="MikeMannix" date="1000277787" format="1.0" version="1.5"}%
   1.875 +a2 2
   1.876 +%INCLUDE{"UtilTempDocNote"}%
   1.877 +
   1.878 +d12 1
   1.879 +a12 1
   1.880 +<nop>TWikiMetaData uses =META= variables to store topic data that's separate from the main free-form content. This includes program-generated info like FileAttachment data, and user-defined [[TWikiDocumentation#TWiki_Form_Templates][Form Template]] info.
   1.881 +d16 2
   1.882 +a17 2
   1.883 +	* Format is the same as in [[TWikiDocumentation#TWiki_Variables][TWikiVariables]], except all fields have a key.
   1.884 +		* %<nop>META:&lt;type&gt;{key1="value1" [key2="value2" [...]]}%
   1.885 +d27 1
   1.886 +a27 1
   1.887 +<verbatim>
   1.888 +d30 1
   1.889 +a30 1
   1.890 +%<nop>META:TOPICMOVED{from="Codev.OldName" to="CoDev.NewName"
   1.891 +d38 1
   1.892 +a38 1
   1.893 +</verbatim>
   1.894 +d41 1
   1.895 +a41 1
   1.896 +---+++ Specifications
   1.897 +d45 1
   1.898 +a45 1
   1.899 +---++++ TOPICINFO
   1.900 +d47 5
   1.901 +a51 5
   1.902 +	|  *Key*  |  *Comment*			 |
   1.903 +	| version	| Same as RCS version |
   1.904 +	| date		| integer, unx time, seconds since start 1970 |
   1.905 +	| author	 | last to change topic, is the REMOTE_USER |
   1.906 +	| format	 | Format of this topic, will be used for automatic format conversion |
   1.907 +d53 1
   1.908 +a53 1
   1.909 +---++++ TOPICMOVED
   1.910 +d55 1
   1.911 +a55 1
   1.912 +This is optional, exists if topic has ever been moved.  If a topic is moved more than once, only the most recent TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history.
   1.913 +d57 1
   1.914 +a57 1
   1.915 +%<nop>META:TOPICMOVED{from="Codev.OldName" to="CoDev.NewName" by="talintj" date="976762680"}%
   1.916 +d59 5
   1.917 +a63 5
   1.918 +	|  *Key*  |  *Comment*			 |
   1.919 +	| from		| Full name i.e. web.topic |
   1.920 +	| to		  | Full name i.e. web.topic |
   1.921 +	| by		  | Who did it, is the REMOTE_USER, not <nop>WikiName |
   1.922 +	| date		| integer, unx time, seconds since start 1970 |
   1.923 +d69 1
   1.924 +a69 1
   1.925 +---++++ TOPICPARENT
   1.926 +d71 1
   1.927 +a71 1
   1.928 +	| *Key*	| *Comment* |
   1.929 +d74 1
   1.930 +a74 1
   1.931 +---++++ FILEATTACHMENT
   1.932 +d76 1
   1.933 +a76 1
   1.934 +	| *Key*	| *Comment* |
   1.935 +d88 1
   1.936 +d94 1
   1.937 +a94 1
   1.938 +---++++ FORM
   1.939 +d96 2
   1.940 +a97 2
   1.941 +	| *Key*	| *Comment* |
   1.942 +	| name	 | A topic name - the topic is a [[TWikiDocumentation#Form_Template][Form Template]].  Can optionally include the web name i.e. web.topic, but doesn't normally |
   1.943 +d99 1
   1.944 +a99 1
   1.945 +---++++ FIELD
   1.946 +d101 1
   1.947 +a101 1
   1.948 +Should only be present if there is a FORM entry.  Note that this data is used when viewing a topic, the form template definition is not read.
   1.949 +d104 2
   1.950 +a105 2
   1.951 +	| name	 | Ties to entry in [[TWikiDocumentation#Form_Template][Form Template]], is title with all bar alphanumerics and . removed |
   1.952 +	| title	| Full text from [[TWikiDocumentation#Form_Template][Form Template]] |
   1.953 +d117 1
   1.954 +a117 1
   1.955 +	* TOPICINFO
   1.956 +d119 5
   1.957 +a123 5
   1.958 +	* TOPICMOVED (optional)
   1.959 +	* TOPICPARENT (optional)
   1.960 +	* FILEATTACHMENT (0 or more entries)
   1.961 +	* FORM (optional)
   1.962 +	* FIELD (0 or more entries; FORM required)
   1.963 +d137 1
   1.964 +a137 1
   1.965 +  | %<nop>META{"form"}% | Show form data, see [[TWikiDocumentation#Form_Templates][Form Templates]] |
   1.966 +d147 1
   1.967 +a147 5
   1.968 +  | seperator="..." | Separator between parents, default is " > " |
   1.969 +
   1.970 +	* *Future Development:* There are numerous development directions and specific features to consider. A couple of obvious possibilities:	
   1.971 +		* Rendering to formats other than tables: bullet lists, formatted body text; 
   1.972 +		* Specifying templates to be used for rendering.
   1.973 +@
   1.974 +
   1.975 +
   1.976 +1.4
   1.977 +log
   1.978 +@none
   1.979 +@
   1.980 +text
   1.981 +@d1 1
   1.982 +a1 1
   1.983 +%META:TOPICINFO{author="MikeMannix" date="999959425" format="1.0" version="1.4"}%
   1.984 +d3 2
   1.985 +@
   1.986 +
   1.987 +
   1.988 +1.3
   1.989 +log
   1.990 +@none
   1.991 +@
   1.992 +text
   1.993 +@d1 1
   1.994 +a1 1
   1.995 +%META:TOPICINFO{author="MikeMannix" date="999868902" format="1.0" version="1.3"}%
   1.996 +d109 6
   1.997 +a114 7
   1.998 +There no absolute need for meta data variables to be in a specific order, however, it does for the following reasons:
   1.999 +	* Keep (form) fields in the order they are defined
  1.1000 +	* Allow diff command to give output in a logically sensible order
  1.1001 +
  1.1002 +These could be done in other ways, but this adds complexity
  1.1003 +	* Order fields - definition could be read on each rendering (expensive)
  1.1004 +	* Diff - render data before doing diff, has something to offer, but not likely to be available for next TWiki release
  1.1005 +a115 1
  1.1006 +So the order is:
  1.1007 +d117 6
  1.1008 +a122 6
  1.1009 +	* text of topic
  1.1010 +	* TOPICMOVED - optional
  1.1011 +	* TOPICPARENT - optional
  1.1012 +	* FILEATTACHMENT - 0 or more entries
  1.1013 +	* FORM - optional
  1.1014 +	* FIELD - 0 or more entries (FORM required)
  1.1015 +d131 1
  1.1016 +a131 1
  1.1017 +Meta Data is rendered with the %<nop>META% variable. This is mostly used in the ==view==, ==preview== and ==edit== scripts.
  1.1018 +d133 1
  1.1019 +a133 1
  1.1020 +Current support is fairly basic:
  1.1021 +d138 1
  1.1022 +a138 1
  1.1023 +  | Options for attachments: | |
  1.1024 +d154 1
  1.1025 +a154 1
  1.1026 +There is currently no support for meta data for Plugins.  However, the format is readily extendable and the =Meta.pm= code that supports the format needs only minor alteration.
  1.1027 +@
  1.1028 +
  1.1029 +
  1.1030 +1.2
  1.1031 +log
  1.1032 +@none
  1.1033 +@
  1.1034 +text
  1.1035 +@d1 1
  1.1036 +a1 1
  1.1037 +%META:TOPICINFO{author="MikeMannix" date="999204627" format="1.0" version="1.2"}%
  1.1038 +d5 154
  1.1039 +a158 1
  1.1040 +%INCLUDE{"%TWIKIWEB%.MetaDataDefinition"}%
  1.1041 +@
  1.1042 +
  1.1043 +
  1.1044 +1.1
  1.1045 +log
  1.1046 +@none
  1.1047 +@
  1.1048 +text
  1.1049 +@d1 1
  1.1050 +a1 1
  1.1051 +%META:TOPICINFO{author="MikeMannix" date="999188491" format="1.0" version="1.1"}%
  1.1052 +a4 1
  1.1053 +---# TWiki Meta Data
  1.1054 +@