paul@211 | 1 | Introduction
|
paul@211 | 2 | ============
|
paul@211 | 3 |
|
paul@211 | 4 | MoinLight is a distribution of libraries and tools for interpreting document
|
paul@211 | 5 | content in the MoinMoin wiki format together with other formats employed in
|
paul@211 | 6 | wiki content.
|
paul@211 | 7 |
|
paul@211 | 8 | Getting Started
|
paul@211 | 9 | ===============
|
paul@211 | 10 |
|
paul@211 | 11 | The moinconvert tool provides a convenient way of converting content from Moin
|
paul@211 | 12 | format to other formats. For example, the supplied documentation can be
|
paul@211 | 13 | converted as follows:
|
paul@211 | 14 |
|
paul@211 | 15 | ./moinconvert --all --input-dir docs/wiki --format html \
|
paul@211 | 16 | --output-dir docs/html --macros --document-index index.html
|
paul@211 | 17 |
|
paul@211 | 18 | This converts all documents in the indicated input directory to HTML format,
|
paul@211 | 19 | storing the converted documents in the indicated output directory, evaluating
|
paul@211 | 20 | all macros embedded in the input documents. A document index filename is
|
paul@211 | 21 | specified for filesystem browsing of the output documents.
|
paul@211 | 22 |
|
paul@211 | 23 | The result of the above command is a collection of documents in docs/html that
|
paul@211 | 24 | can be viewed using a Web browser, with the docs/html/index.html file being
|
paul@211 | 25 | the front page of this collection. These documents do not need to be served
|
paul@211 | 26 | using a Web browser.
|
paul@211 | 27 |
|
paul@211 | 28 | By omitting the --document-index option (and accompanying filename), a version
|
paul@211 | 29 | of the documents can be produced that is more appropriate for serving by a Web
|
paul@211 | 30 | browser, featuring links that do not include the index.html filename.
|
paul@211 | 31 |
|
paul@211 | 32 | See the bundled documentation for more details of the software and how it can
|
paul@211 | 33 | be used:
|
paul@211 | 34 |
|
paul@211 | 35 | * docs/wiki/FrontPage (and accompanying files) are the documentation files in
|
paul@211 | 36 | Moin format
|
paul@211 | 37 |
|
paul@211 | 38 | * docs/html/index.html is the front page of the documentation converted to HTML
|
paul@211 | 39 | format
|
paul@211 | 40 |
|
paul@211 | 41 | Test Suite
|
paul@211 | 42 | ==========
|
paul@211 | 43 |
|
paul@211 | 44 | A test suite is provided to exercise the toolchain and expose regressions.
|
paul@211 | 45 | More information is available by running the test_parser.py script (found in
|
paul@211 | 46 | the tests directory) with the appropriate option:
|
paul@211 | 47 |
|
paul@211 | 48 | tests/test_parser.py --help
|
paul@211 | 49 |
|
paul@211 | 50 | Running it with the --quiet option provides a quick way of verifying the
|
paul@211 | 51 | tested behaviour of the software.
|
paul@211 | 52 |
|
paul@211 | 53 | Contact, Copyright and Licence Information
|
paul@211 | 54 | ==========================================
|
paul@211 | 55 |
|
paul@211 | 56 | See the following Web pages for more information about this work:
|
paul@211 | 57 |
|
paul@211 | 58 | http://projects.boddie.org.uk/MoinLight
|
paul@211 | 59 |
|
paul@211 | 60 | The author can be contacted at the following e-mail address:
|
paul@211 | 61 |
|
paul@211 | 62 | paul@boddie.org.uk
|
paul@211 | 63 |
|
paul@211 | 64 | Copyright and licence information can be found in the docs directory - see
|
paul@211 | 65 | docs/COPYING.txt and docs/gpl-3.0.txt for more information.
|