pylode 2.8.3__tar.gz → 2.9.1__tar.gz

pyLODE-2.9.1/.gitignore

@@ -0,0 +1,119 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit tests / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+.static_storage/
+.media/
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+
+# Jetbrains tools
+.idea/
+
+# Mac
+.DS_Store
+
+# temp dirs
+output_files/
+
+/pylode/examples/ogc/excluded/
+
+pylode/_version.py

pyLODE-2.9.1/Dockerfile

@@ -0,0 +1,27 @@
+ARG PYTHON_VERSION=3.8-slim
+FROM python:$PYTHON_VERSION
+
+MAINTAINER pyLODE Developers <https://github.com/RDFLib/pyLODE/graphs/contributors>
+
+USER root
+
+RUN apt-get update && \
+	apt-get upgrade -y --allow-downgrades --allow-remove-essential --allow-change-held-packages
+
+# install extra requirements for pyLODE-via-server
+COPY requirements.server.txt /tmp/
+RUN pip3 install -r /tmp/requirements.server.txt
+
+# copy the current directory contents
+ADD . /app
+
+WORKDIR /app
+
+# install pyLODE from source, ensures we always use the latest development branch
+RUN python3 setup.py install
+
+RUN cd ./pylode
+
+EXPOSE 8000
+
+CMD ["gunicorn"  , "-b", "0.0.0.0:8000", "--chdir", "/app/pylode", "server:api"]

{pyLODE-2.8.3 → pyLODE-2.9.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: pyLODE
-Version: 2.8.3
+Version: 2.9.1
 Summary: An OWL ontology documentation tool using Python and templating, based on LODE.
 Home-page: https://github.com/rdflib/pyLODE
 Author: Nicholas J. Car
 Author-email: nicholas.car@surroundaustralia.com
 License: LICENSE
-Download-URL: https://github.com/rdflib/pyLODE/archive/v2.8.3.tar.gz
+Download-URL: https://github.com/rdflib/pyLODE/archive/v2.9.0.tar.gz
 Project-URL: Bug Reports, https://github.com/rdflib/pyLODE/issues
 Project-URL: Source, https://github.com/rdflib/pyLODE/
 Description: .. image:: img/pyLODE-250.png
@@ -66,14 +66,14 @@ Description: .. image:: img/pyLODE-250.png
             - via the popular `Falcon framework <https://falconframework.org/>`__.
             - see server.py in the main folder
         - as-a-service online
-            - hosted at https://kurrawong.net/pylode-online
+            - hosted at https://pylode.surroundaustralia.com
         
         
         Examples
         ========
         pyLODE has been tested with all of the 30+ ontologies in `pylode/examples/ <pylode/examples/>`_ and we are trying to
         ensure it captures all of their annotations. For each example, there is the original RDF file and the corresponding
-        output, in HTML & Markdown.
+        output, in HTML & Markdown. There are some examples of ADOC too.
         
         For example, `Epimorphic's <https://www.epimorphics.com/>`__'s **Registry Ontology** is:
         
@@ -90,6 +90,9 @@ Description: .. image:: img/pyLODE-250.png
             - see `the point-of-truth rendered online <https://linked.data.gov.au/def/agrif>`__
         - **agrif.md** - Markdown output
             - see this `rendered online by GitHub <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.md>`__
+        - **agrif.md** - ASCIIDOC output
+            - `resulting ADOC source <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.adoc>`__
+            - `rendered in HTML <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.adoc.html>`__
         - **agrif.skos.html** - HTMl output, "vocpub" profile
             - see this `rendered online by GitHack <https://raw.githack.com/RDFLib/pyLODE/master/pylode/examples/agrif.vocpub.html>`__
         
@@ -145,8 +148,7 @@ Description: .. image:: img/pyLODE-250.png
             html = pylode.MakeDocco(
                 input_data_file=input_file_path,
                 outputformat="html",
-                profile="owldoc",
-                exclude_css=True
+                profile="ontdoc"
             ).document()
         
         You will now have the HTML content within the variable ``html``.
@@ -164,9 +166,11 @@ Description: .. image:: img/pyLODE-250.png
         * `pylode/bin/pylode.app <pylode/bin/pylode.app>`__ - MAC OS command line executable script
         * `pylode/bin/pylode.exe <pylode/bin/pylode.exe>`__ - Windows command line executable
         
+        All use the same command line arguments.
+        
         Additionally, there is a `Falcon framework <https://falconframework.org/>`__ local HTTP server option.
         
-        All use the same command line arguments.
+        Also, a web UI for pyLODE is available at `<https://pylode.surroundaustralia.com>`.
         
         Command line arguments
         ----------------------
@@ -176,31 +180,54 @@ Description: .. image:: img/pyLODE-250.png
             -  The RDF ontology file you wish to generate HTML for Must be in either Turtle, RDF/XML, JSON-LD or N-Triples formats indicated by the file type extensions .rdf, .owl, .ttl, .n3, .nt, .json respectively
         -  ``-u`` or ``--url``, *required if* ``-i`` *not used*
             -  The RDF ontology you wish to generate HTML for, online. Must be an absolute URL that can be resolved to RDF, preferably via Content Negotiation.
-        -  ``-c`` or ``--css``, *optional, default 'false'*
-            -  Whether (true) or not (false) to copy the default CSS file to the output directory.
+        -  ``-c`` or ``--css``, *optional, default 'true'*
+            -  Whether (true) or not (false) to include CSS in an HTML output.
         -  ``-o`` or ``--outputfile``, *optional*
-            -  A name you wish to assign to the output file. Will be postfixed with .html or .md. If not specified, the name of the input file or last segment of RDF URI will be used, + .html/.md.
+            -  A name you wish to assign to the output file. Will be postfixed with .html, .md or .adoc. If not specified, the name of the input file or last segment of RDF URI will be used, + .html/.md/.adoc.
         -  ``-f`` or ``--outputformat``, *optional, default 'html'*
-            - The output format of the documentation. 'html' or 'md' accepted.
-        -  ``-p`` or ``--profile``, *optional, default 'owl'*
-            - The profile (specification) for ontology documentation used. This has been "owl" (for OWL Ontology) only until the recent introduction of "vocpub" (according to the `Simple Knowledge Organization System (SKOS) <https://www.w3.org/TR/skos-reference/>`__). See ``-lp`` for all profiles supported.
+            - The output format of the documentation. 'html', 'md' or 'adoc' accepted.
+        -  ``-p`` or ``--profile``, *optional, default 'ontdoc'*
+            - The profile (specification) for ontology documentation used. "ontdoc" (for OWL Ontologies), "vocpub" (for `Simple Knowledge Organization System (SKOS) <https://www.w3.org/TR/skos-reference/>`__) vocabularies or SKOS versions of OWL ontologies, "prof" for `Profiles Vocabularies <https://www.w3.org/TR/dx-prof/>`__ profiles. See ``-lp`` for all profiles supported.
         -  ``-lp`` or ``--listprofiles``, *optional, no arguments*
             - Lists all the profiles (specifications) for ontology documentation supported by pyLODE
         
         Example call
         ------------
-        This call to the BASH script in `pylode/bin/ <pylode/bin/>`__ will
-        create an HTML document for an ontology called ``placenames.html`` and
-        save it with a basic CSS file into
-        `pylode/output\_files/ <pylode/output_files/>`__:
+        This basic call to the BASH script in `pylode/bin/ <pylode/bin/>`__ will
+        print to standard out an HTML document for an ontology called ``placenames.html``.
         
         ::
         
-            ./pylode -i ../example/prof.ttl --css true
+            ./pylode -i ../example/prof.ttl
+        
+        An output file could be specified by using `-o`, rather than printing to standard out.
         
         Online Service
         --------------
-        An online API to access pyLODE is now available in test mode at https://kurrawong.net/pylode-online.
+        An online version of pyLODE is now available at https://pylode.surroundaustralia.com/.
+        
+        Docker
+        ------
+        Install locally by first building the container
+        
+        ::
+        
+            docker build -t pylode:latest --build-arg PYTHON_VERSION=3.8-slim .
+        
+        Then run the container
+        
+        ::
+        
+            docker run -it -d -p 8000:8000 -e GTAGID=${Google TagID} pylode
+        
+        N.B. The Google TagID is NOT required unless Google Analytics is required.
+        It looks as follows `GTAGID=UA-168806395-1`.
+        
+        You can now access the service on localhost
+        
+        ::
+        
+            curl localhost:8000/lode?url=http://sweetontology.net/sweetAll.ttl
         
         Local server - Falcon
         ---------------------
@@ -208,13 +235,14 @@ Description: .. image:: img/pyLODE-250.png
         
         ::
         
-            cd pylode && gunicorn --chdir /path/to/pyLODE/pylode server:api
+            gunicorn --chdir /path/to/pyLODE/pylode server:api
+        
+        The server is then available at localhost:8000 and localhost:8000/pylode for the active endpoint. Note that the server must be fed a URL to an ontology to document supplied by a server capable of responding to Content Negotiation, i.e. it must supply RDF according to an HTTP `Accept` request for `text/turtle`, `application/rdf+xml` etc.
         
-        Then, in another terminal:
         
         ::
         
-            curl localhost:8000/lode?url=http://sweetontology.net/sweetAll.ttl
+            curl localhost:8000/pylode?url=http://sweetontology.net/sweetAll.ttl
         
         Windows
         -------
@@ -240,7 +268,7 @@ Description: .. image:: img/pyLODE-250.png
         
         This will output ``pylode.exe`` in the ``dist`` directory in ``pylode``. The .exe file in ``bin/`` is just the latest copy of this.
         
-        You can now run the pyLODE Command Line utility via ``pylode.exe``. 
+        You can now run the pyLODE Command Line utility via ``pylode.exe``.
         See above for the pyLODE command line util usage instructions.
         
         Mac OS
@@ -253,6 +281,7 @@ Description: .. image:: img/pyLODE-250.png
         -----
         In ``pylode/bin/``, there is a shell script ``pylode.sh``. You can run this on the command line. It just pushes queries to the Python command line ``cli.py``.
         
+        
         What pyLODE understands
         =======================
         pyLODE understands Ontologies, Taxonomies & Profiles and handles them based on the *Ontology Document*, *Vocabulary Publication* and *PROF* profiles that it contains. These three profiles share understanding of basic annotation properties.
@@ -283,7 +312,7 @@ Description: .. image:: img/pyLODE-250.png
             -  per ``rdfs:Class`` or ``owl:Class``
             -  *title* - ``rdfs:label`` or ``skos:prefLabel`` or ``dct:title``
             -  *description* - ``rdf:comment`` or ``skos:definition`` or ``dct:description`` as a string or using `Markdown <https://daringfireball.net/projects/markdown/>`__ or HTML
-            -  *usage note* - a ``skos:scopeNote`` string
+            -  *scope note* - a ``skos:scopeNote`` string
             -  *example* - a ``skos:example`` string containing RDF
             -  *super classes* - by declaring a class to be ``owl:subClassOf`` something
             -  *sub classes* - pyLODE will work these out itself
@@ -294,7 +323,7 @@ Description: .. image:: img/pyLODE-250.png
             -  *title* - ``rdfs:label`` or ``skos:prefLabel`` or ``dct:title``
             -  *description* - ``rdf:comment`` or ``skos:definition`` or ``dct:description``
             -  *usage note* - a ``skos:scopeNote`` string
-            -  *example* - a ``skos:example`` string containing RDF
+            -  *example* - a ``skos:example`` string containing RDF - this will be monospaced in outputs
             -  *super properties* - by declaring a class to be ``owl:subPropertyOf`` something
             -  *sub properties* - pyLODE will work these out itself
             -  *equivalent properties* - by declaring a class to be ``owl:equivalentProperty`` something
@@ -534,7 +563,7 @@ Description: .. image:: img/pyLODE-250.png
         **Token** **URI**
         ========= ==========================================
         prof        `<https://www.w3.org/TR/dx-prof/>`_
-        ontdoc      `<https://w3id.org/profile/ontdocp>`_
+        ontdoc      `<https://w3id.org/profile/ontdoc>`_
         vocpub      `<https://w3id.org/profile/vocpub>`_
         ========= ==========================================
         
@@ -670,7 +699,7 @@ Description: .. image:: img/pyLODE-250.png
         Current Release
         ---------------
         
-        The current release, as of July 2020, is **2.8.3**.
+        The current release, as of April, 2021, is **2.9.0**.
         
         Release Schedule
         ----------------
@@ -679,8 +708,15 @@ Description: .. image:: img/pyLODE-250.png
            :header: "Version", "Date", "Description"
            :widths: 15, 10, 30
         
-           3.0, *June 2020*, "Will include pre-testing inputs with SHACL"
-           **2.8.3**, **3 July 2020**, "Packaging bugfixes only"
+           3.0, *?*, "Will include pre-testing inputs with SHACL"
+           **2.9.1**, **28 Apr 2021**, "Support for ASCIIDOC format (OntDoc profile only)"
+           2.8.11, 28 Apr 2021, "Further changes for PyPI only"
+           2.8.10, 27 Apr 2021, "Further changes for PyPI only"
+           2.8.9, 27 Apr 2021, "PyPI enhancements only"
+           2.8.8, 27 Apr 2021, "Several small bugs fixed, auto-generation of version no. from Git tag"
+           2.8.6, 23 Feb 20201, "Fixing char encoding issues, updated examples, new test files style - per issue"
+           2.8.5, 5 Jan 20201, "Small enhancements to the Falcon server deployment option"
+           2.8.3, 3 July 2020, "Packaging bugfixes only"
            2.7, 1 July 2020, "Much refactoring for new profile creation ease"
            2.6, June 2020, "Supports PROF profiles as well as taxonomies & ontologies"
            2.4, 27 May 2020, "Small improvements over 2.0"
@@ -700,6 +736,7 @@ Description: .. image:: img/pyLODE-250.png
         
         2.0 - current
         ~~~~~~~~~~~~~~
+        - includes 3rd-party-created profile: NMPF
         - handles Named Individuals in OWL ontologies
         - implements "owldoc" & "vocpub" documentation profiles for OWL, SKOS and OWL-as-SKOS results
         - implements "prof" profile for documentation of `Profiles Vocabulary <https://www.w3.org/TR/dx-prof/>`__ profiles

{pyLODE-2.8.3 → pyLODE-2.9.1}/README.rst

@@ -55,14 +55,14 @@ The tool can be run as in these ways:
     - via the popular `Falcon framework <https://falconframework.org/>`__.
     - see server.py in the main folder
 - as-a-service online
-    - hosted at https://kurrawong.net/pylode-online
+    - hosted at https://pylode.surroundaustralia.com
 
 
 Examples
 ========
 pyLODE has been tested with all of the 30+ ontologies in `pylode/examples/ <pylode/examples/>`_ and we are trying to
 ensure it captures all of their annotations. For each example, there is the original RDF file and the corresponding
-output, in HTML & Markdown.
+output, in HTML & Markdown. There are some examples of ADOC too.
 
 For example, `Epimorphic's <https://www.epimorphics.com/>`__'s **Registry Ontology** is:
 
@@ -79,6 +79,9 @@ Another, the Australian Government's Records Interoperability Framework (AGRIF)
     - see `the point-of-truth rendered online <https://linked.data.gov.au/def/agrif>`__
 - **agrif.md** - Markdown output
     - see this `rendered online by GitHub <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.md>`__
+- **agrif.md** - ASCIIDOC output
+    - `resulting ADOC source <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.adoc>`__
+    - `rendered in HTML <https://github.com/RDFLib/pyLODE/blob/master/pylode/examples/agrif.adoc.html>`__
 - **agrif.skos.html** - HTMl output, "vocpub" profile
     - see this `rendered online by GitHack <https://raw.githack.com/RDFLib/pyLODE/master/pylode/examples/agrif.vocpub.html>`__
 
@@ -134,8 +137,7 @@ To use pyLODE within Python, try something like this:
     html = pylode.MakeDocco(
         input_data_file=input_file_path,
         outputformat="html",
-        profile="owldoc",
-        exclude_css=True
+        profile="ontdoc"
     ).document()
 
 You will now have the HTML content within the variable ``html``.
@@ -153,9 +155,11 @@ pyLODE presents natively as a Python command-line utility,
 * `pylode/bin/pylode.app <pylode/bin/pylode.app>`__ - MAC OS command line executable script
 * `pylode/bin/pylode.exe <pylode/bin/pylode.exe>`__ - Windows command line executable
 
+All use the same command line arguments.
+
 Additionally, there is a `Falcon framework <https://falconframework.org/>`__ local HTTP server option.
 
-All use the same command line arguments.
+Also, a web UI for pyLODE is available at `<https://pylode.surroundaustralia.com>`.
 
 Command line arguments
 ----------------------
@@ -165,31 +169,54 @@ These are the command line arguments to run pyLODE as a BASH or Python script on
     -  The RDF ontology file you wish to generate HTML for Must be in either Turtle, RDF/XML, JSON-LD or N-Triples formats indicated by the file type extensions .rdf, .owl, .ttl, .n3, .nt, .json respectively
 -  ``-u`` or ``--url``, *required if* ``-i`` *not used*
     -  The RDF ontology you wish to generate HTML for, online. Must be an absolute URL that can be resolved to RDF, preferably via Content Negotiation.
--  ``-c`` or ``--css``, *optional, default 'false'*
-    -  Whether (true) or not (false) to copy the default CSS file to the output directory.
+-  ``-c`` or ``--css``, *optional, default 'true'*
+    -  Whether (true) or not (false) to include CSS in an HTML output.
 -  ``-o`` or ``--outputfile``, *optional*
-    -  A name you wish to assign to the output file. Will be postfixed with .html or .md. If not specified, the name of the input file or last segment of RDF URI will be used, + .html/.md.
+    -  A name you wish to assign to the output file. Will be postfixed with .html, .md or .adoc. If not specified, the name of the input file or last segment of RDF URI will be used, + .html/.md/.adoc.
 -  ``-f`` or ``--outputformat``, *optional, default 'html'*
-    - The output format of the documentation. 'html' or 'md' accepted.
--  ``-p`` or ``--profile``, *optional, default 'owl'*
-    - The profile (specification) for ontology documentation used. This has been "owl" (for OWL Ontology) only until the recent introduction of "vocpub" (according to the `Simple Knowledge Organization System (SKOS) <https://www.w3.org/TR/skos-reference/>`__). See ``-lp`` for all profiles supported.
+    - The output format of the documentation. 'html', 'md' or 'adoc' accepted.
+-  ``-p`` or ``--profile``, *optional, default 'ontdoc'*
+    - The profile (specification) for ontology documentation used. "ontdoc" (for OWL Ontologies), "vocpub" (for `Simple Knowledge Organization System (SKOS) <https://www.w3.org/TR/skos-reference/>`__) vocabularies or SKOS versions of OWL ontologies, "prof" for `Profiles Vocabularies <https://www.w3.org/TR/dx-prof/>`__ profiles. See ``-lp`` for all profiles supported.
 -  ``-lp`` or ``--listprofiles``, *optional, no arguments*
     - Lists all the profiles (specifications) for ontology documentation supported by pyLODE
 
 Example call
 ------------
-This call to the BASH script in `pylode/bin/ <pylode/bin/>`__ will
-create an HTML document for an ontology called ``placenames.html`` and
-save it with a basic CSS file into
-`pylode/output\_files/ <pylode/output_files/>`__:
+This basic call to the BASH script in `pylode/bin/ <pylode/bin/>`__ will
+print to standard out an HTML document for an ontology called ``placenames.html``.
 
 ::
 
-    ./pylode -i ../example/prof.ttl --css true
+    ./pylode -i ../example/prof.ttl
+
+An output file could be specified by using `-o`, rather than printing to standard out.
 
 Online Service
 --------------
-An online API to access pyLODE is now available in test mode at https://kurrawong.net/pylode-online.
+An online version of pyLODE is now available at https://pylode.surroundaustralia.com/.
+
+Docker
+------
+Install locally by first building the container
+
+::
+
+    docker build -t pylode:latest --build-arg PYTHON_VERSION=3.8-slim .
+
+Then run the container
+
+::
+
+    docker run -it -d -p 8000:8000 -e GTAGID=${Google TagID} pylode
+
+N.B. The Google TagID is NOT required unless Google Analytics is required.
+It looks as follows `GTAGID=UA-168806395-1`.
+
+You can now access the service on localhost
+
+::
+
+    curl localhost:8000/lode?url=http://sweetontology.net/sweetAll.ttl
 
 Local server - Falcon
 ---------------------
@@ -197,13 +224,14 @@ You can run pyLODE using your own, local, HTTP server like this:
 
 ::
 
-    cd pylode && gunicorn --chdir /path/to/pyLODE/pylode server:api
+    gunicorn --chdir /path/to/pyLODE/pylode server:api
+
+The server is then available at localhost:8000 and localhost:8000/pylode for the active endpoint. Note that the server must be fed a URL to an ontology to document supplied by a server capable of responding to Content Negotiation, i.e. it must supply RDF according to an HTTP `Accept` request for `text/turtle`, `application/rdf+xml` etc.
 
-Then, in another terminal:
 
 ::
 
-    curl localhost:8000/lode?url=http://sweetontology.net/sweetAll.ttl
+    curl localhost:8000/pylode?url=http://sweetontology.net/sweetAll.ttl
 
 Windows
 -------
@@ -229,7 +257,7 @@ Once you have PyInstaller, use ``pyinstaller`` to generate the ``pyLODE.exe`` CL
 
 This will output ``pylode.exe`` in the ``dist`` directory in ``pylode``. The .exe file in ``bin/`` is just the latest copy of this.
 
-You can now run the pyLODE Command Line utility via ``pylode.exe``. 
+You can now run the pyLODE Command Line utility via ``pylode.exe``.
 See above for the pyLODE command line util usage instructions.
 
 Mac OS
@@ -242,6 +270,7 @@ Linux
 -----
 In ``pylode/bin/``, there is a shell script ``pylode.sh``. You can run this on the command line. It just pushes queries to the Python command line ``cli.py``.
 
+
 What pyLODE understands
 =======================
 pyLODE understands Ontologies, Taxonomies & Profiles and handles them based on the *Ontology Document*, *Vocabulary Publication* and *PROF* profiles that it contains. These three profiles share understanding of basic annotation properties.
@@ -272,7 +301,7 @@ pyLODE understands the following ontology constructs:
     -  per ``rdfs:Class`` or ``owl:Class``
     -  *title* - ``rdfs:label`` or ``skos:prefLabel`` or ``dct:title``
     -  *description* - ``rdf:comment`` or ``skos:definition`` or ``dct:description`` as a string or using `Markdown <https://daringfireball.net/projects/markdown/>`__ or HTML
-    -  *usage note* - a ``skos:scopeNote`` string
+    -  *scope note* - a ``skos:scopeNote`` string
     -  *example* - a ``skos:example`` string containing RDF
     -  *super classes* - by declaring a class to be ``owl:subClassOf`` something
     -  *sub classes* - pyLODE will work these out itself
@@ -283,7 +312,7 @@ pyLODE understands the following ontology constructs:
     -  *title* - ``rdfs:label`` or ``skos:prefLabel`` or ``dct:title``
     -  *description* - ``rdf:comment`` or ``skos:definition`` or ``dct:description``
     -  *usage note* - a ``skos:scopeNote`` string
-    -  *example* - a ``skos:example`` string containing RDF
+    -  *example* - a ``skos:example`` string containing RDF - this will be monospaced in outputs
     -  *super properties* - by declaring a class to be ``owl:subPropertyOf`` something
     -  *sub properties* - pyLODE will work these out itself
     -  *equivalent properties* - by declaring a class to be ``owl:equivalentProperty`` something
@@ -523,7 +552,7 @@ profiles include, see the profiles' definitions at:
 **Token** **URI**
 ========= ==========================================
 prof        `<https://www.w3.org/TR/dx-prof/>`_
-ontdoc      `<https://w3id.org/profile/ontdocp>`_
+ontdoc      `<https://w3id.org/profile/ontdoc>`_
 vocpub      `<https://w3id.org/profile/vocpub>`_
 ========= ==========================================
 
@@ -659,7 +688,7 @@ and change/add development priorities.
 Current Release
 ---------------
 
-The current release, as of July 2020, is **2.8.3**.
+The current release, as of April, 2021, is **2.9.0**.
 
 Release Schedule
 ----------------
@@ -668,8 +697,15 @@ Release Schedule
    :header: "Version", "Date", "Description"
    :widths: 15, 10, 30
 
-   3.0, *June 2020*, "Will include pre-testing inputs with SHACL"
-   **2.8.3**, **3 July 2020**, "Packaging bugfixes only"
+   3.0, *?*, "Will include pre-testing inputs with SHACL"
+   **2.9.1**, **28 Apr 2021**, "Support for ASCIIDOC format (OntDoc profile only)"
+   2.8.11, 28 Apr 2021, "Further changes for PyPI only"
+   2.8.10, 27 Apr 2021, "Further changes for PyPI only"
+   2.8.9, 27 Apr 2021, "PyPI enhancements only"
+   2.8.8, 27 Apr 2021, "Several small bugs fixed, auto-generation of version no. from Git tag"
+   2.8.6, 23 Feb 20201, "Fixing char encoding issues, updated examples, new test files style - per issue"
+   2.8.5, 5 Jan 20201, "Small enhancements to the Falcon server deployment option"
+   2.8.3, 3 July 2020, "Packaging bugfixes only"
    2.7, 1 July 2020, "Much refactoring for new profile creation ease"
    2.6, June 2020, "Supports PROF profiles as well as taxonomies & ontologies"
    2.4, 27 May 2020, "Small improvements over 2.0"
@@ -689,6 +725,7 @@ Expected to handle
 
 2.0 - current
 ~~~~~~~~~~~~~~
+- includes 3rd-party-created profile: NMPF
 - handles Named Individuals in OWL ontologies
 - implements "owldoc" & "vocpub" documentation profiles for OWL, SKOS and OWL-as-SKOS results
 - implements "prof" profile for documentation of `Profiles Vocabulary <https://www.w3.org/TR/dx-prof/>`__ profiles