Updated documentation.

This commit is contained in:
Franco Masotti 2022-01-27 18:03:45 +01:00
parent 66058fe84e
commit bf2693adc9
Signed by: frnmst
GPG Key ID: 24116ED85666780A
5 changed files with 99 additions and 126 deletions

View File

@ -28,8 +28,6 @@ Compatibility table
Key
^^^
.. note:: This color system is subjective.
============ ===========
Color Meaning
============ ===========
@ -47,9 +45,9 @@ Status
======================= ===================== ============ ======================================================================================================== =============================================
Parser Status Alias of Supported parser version Source
======================= ===================== ============ ======================================================================================================== =============================================
``cmark`` |most| Version 0.29 (2019-04-06) https://github.com/commonmark/cmark
``cmark`` |most| Version 0.30 (2021-06-19) https://github.com/commonmark/cmark
``commonmarker`` |most| ``github`` https://github.com/gjtorikian/commonmarker
``github`` |most| Version 0.29-gfm (2019-04-06) https://github.com/github/cmark
``github`` |most| Version 0.29-gfm (2019-04-06) https://github.com/github/cmark-gfm
``goldmark`` |most| ``cmark`` https://github.com/yuin/goldmark
``gitlab`` |partial| Latest unknown version https://docs.gitlab.com/ee/user/markdown.html
``redcarpet`` |low| `Redcarpet v3.5.0 <https://github.com/vmg/redcarpet/tree/6270d6b4ab6b46ee6bb57a6c0e4b2377c01780ae>`_ https://github.com/vmg/redcarpet
@ -70,68 +68,68 @@ Key
============ ==============================================================
Word Meaning
============ ==============================================================
``L`` latest version available at the time. Implies ``U``.
``N`` not implemented
``U`` unavailable version number
``C`` Commonmark
``R`` Redcarpet
``G`` GitLab modified Redcarpet
\- not implemented
C Commonmark
G GitLab modified Redcarpet
============ ==============================================================
Status history
^^^^^^^^^^^^^^
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| md-toc | ``standard`` |``cmark`` |``commonmarker``| ``github`` | ``gitlab`` | ``goldmark`` | ``redcarpet`` |
+=================+================+================+================+==============+================+==================+==================+
| 0.0.1 | ``N`` | ``N`` | ``N`` | ``U`` | ``N`` | ``N`` | ``N`` |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 1.0.0 | ``U`` | ``N`` | ``N`` | ``L`` | ``G`` | ``N`` | |r1| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 2.0.0 | ``N`` | ``L`` | ``L`` | ``C`` | ``G`` | ``N`` | |r2| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 2.0.1 | ``N`` | ``L`` | ``L`` | ``C`` | ``G`` | ``N`` | |r2| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 3.0.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 3.1.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 4.0.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 5.0.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 5.0.1 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 6.0.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 6.0.1 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 6.0.2 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.1 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.2 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.3 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.4 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.0.5 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | |r3| |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.1.0 | ``N`` | ``github`` | ``github`` | 0.28-gfm | ``github`` | ``N`` | v3.5.0 |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 7.2.0 | ``N`` | 0.28 [#f1]_ | 0.28-gfm | 0.28-gfm | ``github`` | ``N`` | v3.5.0 |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 8.0.0 | ``N`` | 0.29 | ``github`` | 0.29-gfm | ``L`` | ``cmark`` | v3.5.0 |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 8.0.1 | ``N`` | 0.29 | ``github`` | 0.29-gfm | ``L`` | ``cmark`` | v3.5.0 |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
| 8.1.0 | ``N`` | 0.29 | ``github`` | 0.29-gfm | ``L`` | ``cmark`` | v3.5.0 |
+-----------------+----------------+----------------+----------------+--------------+----------------+------------------+------------------+
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| md-toc | ``standard`` | ``cmark`` | ``commonmarker`` | ``github`` | ``gitlab`` | ``goldmark`` | ``redcarpet`` |
+=================+==================+==================+==================+=================+=================+==================+==================+
| 0.0.1 | \- | \- | \- | unknown version | \- | \- | \- |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 1.0.0 | unknown version | \- | \- | lastest version | G | \- | |r1| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 2.0.0 | \- | lastest version | lastest version | C | G | \- | |r2| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 2.0.1 | \- | lastest version | lastest version | C | G | \- | |r2| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 3.0.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 3.1.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 4.0.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 5.0.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 5.0.1 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 6.0.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 6.0.1 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 6.0.2 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.1 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.2 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.3 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.4 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.0.5 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | |r3| |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.1.0 | \- | ``github`` | ``github`` | 0.28-gfm | ``github`` | \- | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 7.2.0 | \- | 0.28 [#f1]_ | 0.28-gfm | 0.28-gfm | ``github`` | \- | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 8.0.0 | \- | 0.29 | ``github`` | 0.29-gfm | lastest version | ``cmark`` | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 8.0.1 | \- | 0.29 | ``github`` | 0.29-gfm | lastest version | ``cmark`` | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 8.1.0 | \- | 0.29 | ``github`` | 0.29-gfm | lastest version | ``cmark`` | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
| 8.1.1 | \- | 0.30 | ``github`` | 0.29-gfm [#f2]_ | lastest version | ``cmark`` | v3.5.0 |
+-----------------+------------------+------------------+------------------+-----------------+-----------------+------------------+------------------+
.. [#f1] used alias ``github``
.. [#f2] when this version was released GFM still needed to catch up with cmark
.. |r1| replace:: https://github.com/vmg/redcarpet/tree/26c80f05e774b31cd01255b0fa62e883ac185bf3
.. |r2| replace:: https://github.com/vmg/redcarpet/tree/e3a1d0b00a77fa4e2d3c37322bea66b82085486f

View File

@ -1,4 +1,4 @@
Contributing
============
`Contributing [common] <https://docs.franco.net.eu.org/fpydocs/contributing_common.html>`_ version `4.1.2 <https://software.franco.net.eu.org/frnmst/fpydocs/src/tag/4.1.2>`_
`Contributing [common] <https://docs.franco.net.eu.org/fpydocs/contributing_common.html>`_ version `4.2.0 <https://software.franco.net.eu.org/frnmst/fpydocs/src/tag/4.2.0>`_

View File

@ -8,7 +8,7 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Most of md-toc's API | all |
+-----------------------------------------+-----------------------------------------------+
@ -20,7 +20,7 @@ Text
::
Copyright (C) 2017-2021 Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com)
Copyright (C) 2017-2022 Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com)
md-toc is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
@ -43,7 +43,7 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Headers | ``redcarpet`` |
| Anchor link types and behaviours | ``redcarpet`` |
@ -84,7 +84,7 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Anchor link types and behaviours | ``cmark``, ``github`` |
+-----------------------------------------+-----------------------------------------------+
@ -127,9 +127,9 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Emphasis | ``cmark``, ``github``, ``gitlab`` |
| Most ``md_toc/cmark.py`` code | ``cmark``, ``github``, ``gitlab`` |
+-----------------------------------------+-----------------------------------------------+
Text
@ -139,7 +139,7 @@ Text
Copyright (c) 2014, John MacFarlane
Copyright (c) 2021, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
Copyright (c) 2021-2022, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
All rights reserved.
@ -174,7 +174,7 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Emphasis | ``cmark``, ``github``, ``gitlab`` |
+-----------------------------------------+-----------------------------------------------+
@ -190,7 +190,7 @@ Text
are derived from utf8proc
(<http://www.public-software-group.org/utf8proc>),
(C) 2009 Public Software Group e. V., Berlin, Germany.
Copyright (C) 2021, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
Copyright (C) 2021-2022, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
@ -218,7 +218,7 @@ Scope
`````
+-----------------------------------------+-----------------------------------------------+
| Name | Parsers |
| Applies to | Parsers |
+-----------------------------------------+-----------------------------------------------+
| Emphasis | ``cmark``, ``github``, ``gitlab`` |
+-----------------------------------------+-----------------------------------------------+
@ -232,7 +232,7 @@ Text
buffer.h, buffer.c, chunk.h
are derived from code (C) 2012 Github, Inc.
Copyright (C) 2021, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
Copyright (C) 2021-2022, Franco Masotti (franco \D\o\T masotti {-A-T-} tutanota \D\o\T com) (for md-toc only)
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

View File

@ -50,7 +50,7 @@ Supported markdown parsers
- ``goldmark``:
- this parser claims to be compliant with CommonMark: `goldmark is compliant with CommonMark 0.29.`.
- this parser claims to be compliant with CommonMark: `goldmark is compliant with CommonMark 0.30.`.
For this reason ``goldmark`` is an alias of ``cmark``.
- ``redcarpet``:
@ -69,23 +69,23 @@ Only ATX-style headings are supported in md-toc.
- ``cmark``, ``github``, ``gitlab``: the code used in md-toc is a reverse engineering of the
behavour described in the following:
- https://spec.commonmark.org/0.29/#atx-heading
- https://spec.commonmark.org/0.30/#atx-heading
The escape character ``\`` will be left as-is since they are parsed by
Github's markdown parser already:
- https://spec.commonmark.org/0.29/#backslash-escapes
- https://spec.commonmark.org/0.30/#backslash-escapes
A line ending character is ``U+000A`` or the ``U+000D`` character,
respectively ``\n`` and ``\r`` or ``\r\n``.
respectively ``\n`` and ``\r`` (or ``\r\n`` if combined).
Everything following those characters is ignored.
This has also the benefit to automatically remove
the trailing newline or carriage return at the end of each line. This also
includes ATX headers with line endings only as main content, such as
``#\n`` or ``#\r``. See also:
- https://spec.commonmark.org/0.29/#line
- https://spec.commonmark.org/0.29/#line-ending
- https://spec.commonmark.org/0.30/#line
- https://spec.commonmark.org/0.30/#line-ending
Every other rule for ATX headings is applied.
@ -170,16 +170,17 @@ Indentation
^^^^^^^^^^^
- ``cmark``, ``github``, ``gitlab``: list indentation for sublists with this parser is based on the
previous state, as stated in the GitHub Flavored Markdown document, at
previous state, as stated in the Commonmark spec, at
section 5.2:
"The most important thing to notice is that the position of the text after the
list marker determines how much indentation is needed in subsequent blocks in
the list item. If the list marker takes up two spaces, and there are three
spaces between the list marker and the next non-whitespace character, then
blocks must be indented five spaces in order to fall under the list item."
the list item. If the list marker takes up two spaces of indentation,
and there are three spaces between the list marker and the next character
other than a space or tab, then blocks must be indented five spaces in order
to fall under the list item."
- https://github.github.com/gfm/#list-items
- https://spec.commonmark.org/0.30/#list-items
This is also true with the specular case: if our new list element needs less
indentation than the one processed currently, we have to use the same number
@ -465,7 +466,7 @@ Overflows
the following. If that is the case then a ``GithubOverflowOrderedListMarker``
exception is raised:
- https://spec.commonmark.org/0.29/#ordered-list-marker
- https://spec.commonmark.org/0.30/#ordered-list-marker
- ``redcarpet``: apparently there are no cases of ordered list marker
overflows:
@ -478,7 +479,7 @@ Notes on ordered lists
- ``cmark``, ``github``, ``gitlab``: ordered list markers may start with any integer (except special cases).
any following number is ignored and subsequent numeration is progressive:
- https://spec.commonmark.org/0.29/#start-number
- https://spec.commonmark.org/0.30/#start-number
However, when you try this in practice this is not always true: nested lists
do not follow the specifications. See:
@ -487,7 +488,7 @@ Notes on ordered lists
Markers cannot be negative:
- https://spec.commonmark.org/0.29/#example-239
- https://spec.commonmark.org/0.30/#example-239
- ``redcarpet``: ordered lists do not use the ``start`` HTML attribute:
any number is ignored and lists starts from 1. See:
@ -502,7 +503,7 @@ then link label rules will be applied.
- ``cmark``, ``github``, ``gitlab``:
- https://spec.commonmark.org/0.29/#link-label
- https://spec.commonmark.org/0.30/#link-label
If a line ends in 1 or more '\' characters, this disrupts the anchor
title. For example ``- [xdmdmsdm\](#xdmdmsdm)`` becomes
@ -520,8 +521,8 @@ then link label rules will be applied.
If the headers contains ``[`` or ``]``, these characters
are treated with the following rules.
- https://spec.commonmark.org/0.29/#link-text
- https://spec.commonmark.org/0.29/#link-destination
- https://spec.commonmark.org/0.30/#link-text
- https://spec.commonmark.org/0.30/#link-destination
According to a function in the source code, balanced square brackets do not
work, however they do when interpeted by the web interface. It is however
@ -753,7 +754,7 @@ link destination.
- ``cmark``, ``github``, ``gitlab``: At the moment the implementation of the removal is incomplete
because of its complexity. See:
- https://spec.commonmark.org/0.29/#emphasis-and-strong-emphasis
- https://spec.commonmark.org/0.30/#emphasis-and-strong-emphasis
The core functions for this feature have been translated directly
from the original cmark source in C to Python, with some differences:
@ -800,7 +801,11 @@ link destination.
- https://docs.python.org/3/howto/unicode.html#comparing-strings
The licenses used for all functions with name starting with ``_cmark`` are
licenses C, D and E.
licenses:
- C
- D
- E
Code fence
``````````
@ -815,7 +820,7 @@ get parsed as an element of the TOC.
- ``cmark``, ``github``, ``gitlab``: the rules followed are the ones reported on the
documentation:
- https://spec.commonmark.org/0.29/#code-fence
- https://spec.commonmark.org/0.30/#code-fence
- ``redcarpet``: needs to be implemented:
@ -834,7 +839,7 @@ comments seem to be a better solution.
- ``cmark``, ``github``, ``gitlab``:
- https://spec.commonmark.org/0.29/#html-comment
- https://spec.commonmark.org/0.30/#html-comment
- ``redcarpet``:
@ -855,43 +860,13 @@ implement them while others don't; some act on the duplicate entry problem
while others don't; some strip consecutive dash characters while others don't.
And it's not just about anchor links, as you have read earlier. For example:
- Gitea apparently uses ``goldmark`` as markdown parser. This parser claims
to be compliant with CommonMark: *goldmark is compliant with CommonMark 0.29.*.
See:
- Gitea apparently uses ``goldmark`` as markdown parser. See:
- https://github.com/go-gitea/gitea
- https://github.com/yuin/goldmark
- https://github.com/go-gitea/gitea/blob/71aca93decc10253133dcd77b64dae5d311d7163/modules/markup/markdown/goldmark.go
Gitea adds an annoying ``user-content`` substring in the TOC's anchor links. This is true for versions (git tags):
- v1.13.7
- v1.13.6
- v1.13.5
- v1.13.4
- v1.13.3
- v1.13.2
- v1.13.1
- v1.13.0
- v1.12.6
- v1.12.5
- v1.12.4
- v1.12.3
- v1.12.2
- v1.12.1
- v1.11.8
- v1.12.0
- v1.11.8
- v1.11.7
- v1.11.6
- v1.11.5
- v1.11.4
- v1.11.3
- v1.11.2
- v1.11.1
- v1.11.0
See:
Gitea adds an annoying ``user-content`` substring in the TOC's anchor links. This is true
for versions since git tag v1.11.0. See:
- https://github.com/go-gitea/gitea/blob/71aca93decc10253133dcd77b64dae5d311d7163/modules/markup/markdown/goldmark.go#L230
- https://github.com/go-gitea/gitea/issues/12062

View File

@ -1,4 +1,4 @@
Workflow
========
`Workflow [common] <https://docs.franco.net.eu.org/fpydocs/workflow_common.html>`_ version `4.1.2 <https://software.franco.net.eu.org/frnmst/fpydocs/src/tag/4.1.2>`_
`Workflow [common] <https://docs.franco.net.eu.org/fpydocs/workflow_common.html>`_ version `4.2.0 <https://software.franco.net.eu.org/frnmst/fpydocs/src/tag/4.2.0>`_