# HG changeset patch # User Paul Boddie # Date 1693063898 -7200 # Node ID 8403873f6493b2cf6990ec6f3af901c7df365ce0 # Parent c931727cd4aa7562b99e991d1beb365c0194f742 Updated documentation details to cover MoinLight instead of MoinMoin. diff -r c931727cd4aa -r 8403873f6493 README.txt --- a/README.txt Sat Aug 26 17:31:17 2023 +0200 +++ b/README.txt Sat Aug 26 17:31:38 2023 +0200 @@ -24,6 +24,25 @@ reconfigure such tools. However, an alternative suffix is likely to be introduced in future. +A Note about the Documentation +------------------------------ + +The original content in docs/wiki aims to be readable as plain text under most +circumstances, but the intention is that this content be translated to HTML +since it employs a formatting language based on the MoinMoin wiki format +syntax. + +The following command can be used to generate the HTML form of the +documentation from the main directory of this distribution: + +./docs/tools/make_docs.sh + +Specify the --web option for Web server deployment: + +./docs/tools/make_docs.sh --web + +To generate individual documents, specify their names after any options. + Getting Started =============== @@ -107,27 +126,3 @@ Copyright and licence information can be found in the docs directory - see docs/COPYING.txt and docs/gpl-3.0.txt for more information. - -Generating the Wiki Pages -========================= - -The docs/tools/make_pages.sh script generates a page package for MoinMoin. The -following command will generate a page package called pages.zip using the -pages directory for staging, with Lichen as the page prefix: - -docs/tools/make_pages.sh pages Lichen - -Make sure to include the page prefix where the pages are being deployed in a -wiki with other content at the top level. - -Currently, the wiki pages require the following extensions: - -ImprovedTableParser https://moinmo.in/ParserMarket/ImprovedTableParser - -MoinSupport http://hgweb.boddie.org.uk/MoinSupport - -GraphvizParser https://moinmo.in/ParserMarket/graphviz - -The GraphvizParser requires diagram-tools for the notugly.xsl stylesheet, -although a copy of the stylesheet is provided in the GraphvizParser -distribution for convenience. diff -r c931727cd4aa -r 8403873f6493 docs/wiki/Prerequisites --- a/docs/wiki/Prerequisites Sat Aug 26 17:31:17 2023 +0200 +++ b/docs/wiki/Prerequisites Sat Aug 26 17:31:38 2023 +0200 @@ -15,3 +15,6 @@ As Free Software, priority has been given to supporting Lichen on Free Software platforms, with Debian GNU/Linux being the development platform. Proprietary platforms are neither supported nor recommended. + +To generate HTML documentation, the [[https://projects.boddie.org.uk/MoinLight| +MoinLight]] distribution is required.