Do not use Edit(GUI) button.

?TableOfContents(4)

Copyright 2007 Osamu Aoki GPL, (Please agree to GPL, GPL, and any GPL compatible with DSFG if you update any part of wiki page)

Guide for contributing to Debian Reference

Rules

Here are the rules.

 ... commands examples ...

This ensures (eventually) clean conversion to DocBook XML and makes my work easy. :-)


If funny things happen, look for single quote repeats, etc. in wiki source.

Code sections marked as "{ { { \n } } }" without using spaces will cause XML export errors; thus, always use spaces around \n.

List export has <para> markup bugs; after conversion, review and correct them, please.


This Wiki page to Docbook conversion examples step-by-step:

Hints for tools to help updating this document

Examples

Table

Always assumes the first line is <title>, the second line is <thead> and the rest lines are <tbody> <row>s. (hello)

Example of table 1

TITLE1

TITLE2

DATA 11

DATA 12

DATA 21

DATA 22

Special paragraphs

Here are examples of Wiki marking used.

/!\  /!\  for "Warning" (alert)

<!>  <!>  for "Caution" (attention)

{*}  {*}  for "Important" (star_on) "rslash-n": "\n"

'rslash-n': '\n'

{i}  {i}  for "Tip" (icon-info)

(!)  (!)  for "Note" (idea)

{OK}  {OK}  for "Note" (thumbs-up)

(./)  (./)  for "Note" (check-mark)

Line foldings

line1 starting line break examples line2 w/o space from previous line

line3 w 1 line space from previous line

line2 w 2 space from previous line

line2 w 3 space from previous line line with ampersand & &

Data for popcon data and package size

The following packages are referred in the main text.

List of additional packages for popcon and package size

1

2

3

package

popcon

package size

dummy

gksu

-

-

-

screen

-

-

-

rutebook

-

-

-

These entry let you access these values in main text of generated html.

Escape confusion

MoinMoin conversion bug for " \n " needs to be worked around by placing space around it.

srslash-n:  \n rslash-ns: \n  rslash-n: \n : this

can be referred as @{@internallinks@}@ which will create correct reference in HTML.

Do not use " [[Anchor(internalLinks)]] " for now in the main text used by building final HTML files. (It may be a good idea but you need to do it for entire document.)

The normal anchor feature of MoinMoin wiki is not supported by the XML conversion tool now.