source: other-projects/gs2-manuals-dokuwiki/trunk/pages/wiki/manuals.txt@ 25081

Last change on this file since 25081 was 25081, checked in by jmt12, 12 years ago

Storing the original dokuwiki files in SVN just in case someone later wants to do further development on the GS2 manuals wiki system

File size: 1.8 KB
Line 
1====== Greenstone Manuals ======
2
3===== Editing The Manuals =====
4
5 * You need to be registered and login
6 * You can only edit English versions of manuals - due to limitation of translation process software
7 * Feel free to 'discuss' any non-English change requests
8 * In general use the [[wiki:syntax|Dokuwiki syntax]]
9 * There are a number of rules that must be followed when editing
10 * All text strings that require translation should be preceded by a unique identifier, of the form:<code><!-- id:uniqueidentifier -->Text string</code>If not provided the export system will do its best to generate one, and will also ensure that any identifier given is indeed unique (by adding a numeric suffix as necessary)
11 * If you want HTML comment markers to appear verbatim in the displayed text you have to use a special notation to prevent them being confused with actual HTML comments (that are hidden in the text), like so:<code>%!-- The comment uses percents instead of angle brackets --%</code>
12 * Special notation for figure captions:<code><imgcaption figure_x|The caption></code>The caption may also include subcaptions, which are assumed to start with (a), (b), (c) etc:<code><imgcaption figure_y|Another caption (a) with subcaption></code>Finally, you can include unique identifiers for caption strings using the same notation as for HTML comments:<code><imgcaption figure_z|%!-- id:cap8 --%Last caption %!-- id:cap8sub1 --%(z) and its subcaption></code>
13 * Table captions have a special notation similar to figures:<code><tblcaption table_x|The caption></code>
14 * To reference a figure you link to its caption using the notation:<code><imgref figure_x></code>The reference to a table caption is once again similar:<code><tblref table_x></code>Please note that references to figures and tables only work within the same page
Note: See TracBrowser for help on using the repository browser.