<div dir="ltr"><div>Hi Jonathan,</div><div><br></div><div>I can't answer whether there's any particular RST flavour behind. What I know is that we rely on Sphinx [0] and most of the rules/syntaxes we use are picked from them. The docs guidelines [1] also provide some explanation on the choice made.<br></div><div></div><div>So, in the Sphinx docs, you can find :ref: [2] and .. only:: [3]</div><div><br></div><div>[0] <a href="https://www.sphinx-doc.org/en/master/">https://www.sphinx-doc.org/en/master/</a></div><div>[1] <a href="https://docs.qgis.org/3.16/en/docs/documentation_guidelines/index.html">https://docs.qgis.org/3.16/en/docs/documentation_guidelines/index.html</a></div><div>[2] <a href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-arbitrary-locations">https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-arbitrary-locations</a></div><div><div>[3] <a href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only">https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only</a></div></div><div><br></div><div>Hope that clarifies,</div><div>Harrissou<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le mer. 31 mars 2021 à 14:21, Jonathan Moules <<a href="mailto:jonathan-lists@lightpear.com">jonathan-lists@lightpear.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi List,<br>
<br>
What flavour is the RST behind the QGIS docs? There are quite a few <br>
things in here that are syntax erroring all the parsers I'm trying and <br>
aren't in the basic RST spec either <br>
(<a href="https://docutils.sourceforge.io/docs/user/rst/cheatsheet.txt" rel="noreferrer" target="_blank">https://docutils.sourceforge.io/docs/user/rst/cheatsheet.txt</a>).<br>
<br>
For example using ":ref:" for internal hyperlinks when the spec says <br>
they should be done like this: <br>
<a href="https://docutils.sourceforge.io/docs/user/rst/quickref.html#internal-hyperlink-targets" rel="noreferrer" target="_blank">https://docutils.sourceforge.io/docs/user/rst/quickref.html#internal-hyperlink-targets</a> <br>
(there is no "ref" in the specs). Or the `.. only:: html` that starts <br>
some files.<br>
<br>
I tried looking at the QGIS Docs page but I couldn't see anything about <br>
what RST standard the docs should be written to. Where can I find the spec?<br>
<br>
Cheers,<br>
<br>
Jonathan<br>
<br>
_______________________________________________<br>
QGIS-Developer mailing list<br>
<a href="mailto:QGIS-Developer@lists.osgeo.org" target="_blank">QGIS-Developer@lists.osgeo.org</a><br>
List info: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
Unsubscribe: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
</blockquote></div></div>