moinlight 0.4.5__tar.gz

moinlight-0.4.5/.gitignore

@@ -0,0 +1,24 @@
+mok-private
+00notes.org
+README.org
+chroot*
+consume.py
+create-xml.py
+do.sh
+docs/html/
+fetch-moinmoin-raw.sh
+imports-for-ipython.ipy
+interwiki-moin-default.json
+languages.py
+logger.py
+make-dummy-moin-page.py
+mediawiki-config.json
+pages/
+pretty_title.py
+tests/parsers/test_moin_parser.py.mok0
+tests/serialisers/test_serialisers_mediawiki.py.mok0
+tests/serialisers/test_serialisers_mediawiki.py.save
+tmp.py
+try2-convert-chroot.py
+try3-simple.py
+try4-simple+serialiser.py

moinlight-0.4.5/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: moinlight
+Version: 0.4.5
+Summary: Parse and convert MoinMoin markup documents
+Project-URL: Homepage, https://projects.boddie.org.uk/MoinLight/
+Project-URL: Repository, https://salsa.debian.org/mok0/moinlight.git
+Author-email: Paul Boddie <paul@boddie.org.uk>, Morten Kjeldgaard <mok0@mailbox.org>
+License-Expression: GPL-2.0-or-later
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Wiki
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=3.11.2
+Description-Content-Type: text/markdown
+
+
+# Table of Contents
+
+1.  [Introduction](#org84b31e8)
+2.  [Getting Started](#org40d49b0)
+3.  [Test Suite](#org8a0a7f4)
+4.  [Contact, Copyright and Licence Information](#org0d159da)
+
+
+<a id="org84b31e8"></a>
+
+# Introduction
+
+MoinLight is a distribution of libraries and tools for interpreting
+document content in the MoinMoin wiki format together with other
+formats employed in wiki content.
+
+
+<a id="org40d49b0"></a>
+
+# Getting Started
+
+The moinconvert tool provides a convenient way of converting content
+from Moin format to other formats. For example, the supplied
+documentation can be converted as follows:
+
+    ./moinconvert --input-dir docs/wiki \
+                  --output-dir docs/html \
+                  --root MoinLight \
+                  --document-index index.html \
+                  --theme mercurial \
+                  --macros --all
+
+This converts all documents in the indicated input directory to HTML
+format, storing the converted documents in the indicated output
+directory, evaluating all macros embedded in the input documents. A
+document index filename is specified for filesystem browsing of the
+output documents.
+
+The result of the above command is a collection of documents in
+`docs/html` that can be viewed using a Web browser, with the
+`docs/html/index.html` file being the front page of this collection.
+These documents do not need to be served using a Web browser.
+
+By omitting the `--document-index` option (and accompanying filename), a
+version of the documents can be produced that is more appropriate for
+serving by a Web browser, featuring links that do not include the
+index.html filename.
+
+See the bundled documentation for more details of the software and how
+it can be used:
+
+-   `docs/wiki/MoinLight` (and accompanying files) are the documentation
+    files in `Moin format`
+-   `docs/html/index.html` is the front page of the documentation converted
+    to `HTML format`
+
+A more convenient way of generating the documentation is to use the
+following command:
+
+    ./makedoc.py
+
+For Web server deployment, add the `--web` option for cleaner links:
+
+    docs/tools/make_docs.sh --web
+
+
+<a id="org8a0a7f4"></a>
+
+# Test Suite
+
+A test suite is provided to exercise the toolchain and expose
+regressions. More information is available by running the
+`test_parser.py` script (found in the tests directory) with the
+appropriate option:
+
+    tests/test_parser.py --help
+
+Running it with the `--quiet` option provides a quick way of verifying
+the tested behaviour of the software.
+
+
+<a id="org0d159da"></a>
+
+# Contact, Copyright and Licence Information
+
+See the following Web pages for more information about this work:
+
+<http://projects.boddie.org.uk/MoinLight>
+
+The author can be contacted at the following e-mail address:
+
+paul@boddie.org.uk
+
+Copyright and licence information can be found in the docs directory -
+see docs/COPYING.txt and docs/gpl-3.0.txt for more information.
+

moinlight-0.4.5/README.md

@@ -0,0 +1,97 @@
+
+# Table of Contents
+
+1.  [Introduction](#org84b31e8)
+2.  [Getting Started](#org40d49b0)
+3.  [Test Suite](#org8a0a7f4)
+4.  [Contact, Copyright and Licence Information](#org0d159da)
+
+
+<a id="org84b31e8"></a>
+
+# Introduction
+
+MoinLight is a distribution of libraries and tools for interpreting
+document content in the MoinMoin wiki format together with other
+formats employed in wiki content.
+
+
+<a id="org40d49b0"></a>
+
+# Getting Started
+
+The moinconvert tool provides a convenient way of converting content
+from Moin format to other formats. For example, the supplied
+documentation can be converted as follows:
+
+    ./moinconvert --input-dir docs/wiki \
+                  --output-dir docs/html \
+                  --root MoinLight \
+                  --document-index index.html \
+                  --theme mercurial \
+                  --macros --all
+
+This converts all documents in the indicated input directory to HTML
+format, storing the converted documents in the indicated output
+directory, evaluating all macros embedded in the input documents. A
+document index filename is specified for filesystem browsing of the
+output documents.
+
+The result of the above command is a collection of documents in
+`docs/html` that can be viewed using a Web browser, with the
+`docs/html/index.html` file being the front page of this collection.
+These documents do not need to be served using a Web browser.
+
+By omitting the `--document-index` option (and accompanying filename), a
+version of the documents can be produced that is more appropriate for
+serving by a Web browser, featuring links that do not include the
+index.html filename.
+
+See the bundled documentation for more details of the software and how
+it can be used:
+
+-   `docs/wiki/MoinLight` (and accompanying files) are the documentation
+    files in `Moin format`
+-   `docs/html/index.html` is the front page of the documentation converted
+    to `HTML format`
+
+A more convenient way of generating the documentation is to use the
+following command:
+
+    ./makedoc.py
+
+For Web server deployment, add the `--web` option for cleaner links:
+
+    docs/tools/make_docs.sh --web
+
+
+<a id="org8a0a7f4"></a>
+
+# Test Suite
+
+A test suite is provided to exercise the toolchain and expose
+regressions. More information is available by running the
+`test_parser.py` script (found in the tests directory) with the
+appropriate option:
+
+    tests/test_parser.py --help
+
+Running it with the `--quiet` option provides a quick way of verifying
+the tested behaviour of the software.
+
+
+<a id="org0d159da"></a>
+
+# Contact, Copyright and Licence Information
+
+See the following Web pages for more information about this work:
+
+<http://projects.boddie.org.uk/MoinLight>
+
+The author can be contacted at the following e-mail address:
+
+paul@boddie.org.uk
+
+Copyright and licence information can be found in the docs directory -
+see docs/COPYING.txt and docs/gpl-3.0.txt for more information.
+

moinlight-0.4.5/README.txt

@@ -0,0 +1,78 @@
+Introduction
+============
+
+MoinLight is a distribution of libraries and tools for interpreting document
+content in the MoinMoin wiki format together with other formats employed in
+wiki content.
+
+Getting Started
+===============
+
+The moinconvert tool provides a convenient way of converting content from Moin
+format to other formats. For example, the supplied documentation can be
+converted as follows:
+
+./moinconvert --input-dir docs/wiki \
+              --output-dir docs/html \
+              --root MoinLight \
+              --document-index index.html \
+              --theme mercurial \
+              --macros --all
+
+This converts all documents in the indicated input directory to HTML format,
+storing the converted documents in the indicated output directory, evaluating
+all macros embedded in the input documents. A document index filename is
+specified for filesystem browsing of the output documents.
+
+The result of the above command is a collection of documents in docs/html that
+can be viewed using a Web browser, with the docs/html/index.html file being
+the front page of this collection. These documents do not need to be served
+using a Web browser.
+
+By omitting the --document-index option (and accompanying filename), a version
+of the documents can be produced that is more appropriate for serving by a Web
+browser, featuring links that do not include the index.html filename.
+
+See the bundled documentation for more details of the software and how it can
+be used:
+
+ * docs/wiki/MoinLight (and accompanying files) are the documentation files in
+                       Moin format
+
+ * docs/html/index.html is the front page of the documentation converted to
+                        HTML format
+
+A more convenient way of generating the documentation is to use the following
+command:
+
+docs/tools/make_docs.sh
+
+For Web server deployment, add the --web option for cleaner links:
+
+docs/tools/make_docs.sh --web
+
+Test Suite
+==========
+
+A test suite is provided to exercise the toolchain and expose regressions.
+More information is available by running the test_parser.py script (found in
+the tests directory) with the appropriate option:
+
+tests/test_parser.py --help
+
+Running it with the --quiet option provides a quick way of verifying the
+tested behaviour of the software.
+
+Contact, Copyright and Licence Information
+==========================================
+
+See the following Web pages for more information about this work:
+
+http://projects.boddie.org.uk/MoinLight
+
+The author can be contacted at the following e-mail address:
+
+paul@boddie.org.uk
+
+Copyright and licence information can be found in the docs directory - see
+docs/COPYING.txt and docs/gpl-3.0.txt for more information.

moinlight-0.4.5/docs/COPYING.txt

@@ -0,0 +1,48 @@
+Licence Agreement
+-----------------
+
+All original work in this distribution is covered by the following copyright
+and licensing information:
+
+Copyright (C) 2017-2026 Paul Boddie <paul@boddie.org.uk>
+
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation; either version 3 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+details.
+
+You should have received a copy of the GNU General Public License along with
+this program.  If not, see <http://www.gnu.org/licenses/>.
+
+----
+
+Other code has been incorporated into this distribution and is covered by the
+following copyrights:
+
+moinformat/resources/notugly.xsl:
+
+Copyright (c) 2012 Vidar Hokstad <vidar@hokstad.com>
+Copyright (c) 2016, 2019 Paul Boddie <paul@boddie.org.uk>
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.