This fixes link nesting, and resolves some issues around links not closing
correctly. There were a few changes required to support the autotoc feature, and
the auto ref feature has be deprecated. This feature no longer is required, as
we are doing pending_xref natively. The functionality was breaking Sphinx
altogether, so it doesn't make sense to keep it and deprecate the feature.
* Moves changes from #61 into this PR
* Drops basic testing from #61
* Adds to implementation pending_xref back down to reference
The implementation in #61 breaks a number of cases, like "/example" and
"example.html", etc. Instead of trying to enumerate case we want an xref instead
of a pending_xref, just pin the xref on the pending_xref to back down.
pending_xref replaces itself with it's children if the reference isn't resolved.
This was already dealing with a rewrite due to the spec change on CommonMark, so
I took the opportunity to modernize the code and clean things up as well.
* Updates to support CommonMark==0.7.3
* Reworks pattern for handling CommonMark nodes, mimic docutils visit/depart
pattern
* Drops SectionHandler class, as it was only used in one place. Merge into the
parser class, where it is used
* Drops requirements file for setup.py config, as this is a package requirements
is superfluous
* Adds a number of more detailed test cases
* Adds test runner for 3.5, 3.6
* Updates strictness on prospector, cleans up linting errors and docstring
problems
At the moment it is passing source as node.rawsource. This is always
going to be the empty string as it is getting it from a newly created
node.
This patch saves a reference to the original node and parses down the
correct source. This patch along with #52 means that eval_rst blocks will
internationalize correctly fixing [#47]. Sphinx will not translate
nodes with a blank source.
Currently the priority for the Autostructify is set to 1000. I think it
was the intention to set it so that it runs before any other transforms.
However the ordering in docutils is confusing and setting it to 1
actually means it will be run first.
This was causing a problem for i18n in sphinx as it would not translate
anything in ```eval_rst`` blocks or ``` directive:: ``` blocks as these were
not converted to the node tree before gettext was meant to translate
them.
with the ```eval_rst style, blocks, certain directives such as 'sidebar'
failed with an error saying: "ERROR: The "sidebar" directive may not be
used within topics or body elements". The sidebar directive works using
this added style. The new style is: ```sidebar:: Sidebar title. The
double colon denotes that it is an rst directive and renders it
correctly. No code-block languages have double colons, so this is a safe
method to distinguish between code literals and rst directives.
