You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
New wiki pages created through the GitHub wiki interface add the .rest suffix, rather than .rst
Sort of an advantage (.rest files are docutils-only)
This precludes inclusion of the wiki pages into a standard Sphinx docset as a submodule or subtree.
Sphinx ReStructuredText is a superset of GitHub ReStructuredText (docutils), so Sphinx markup is, in the best case not supported, and in the worst case breaks the wiki render
Notably: :ref:, .. index:, and .. toctree:: are only supported by Sphinx
Advantages
Challenges / Disadvantages
.rest
suffix, rather than.rst
.rest
files are docutils-only):ref:
,.. index:
, and.. toctree::
are only supported by Sphinxmake rst2html_all
make pull push
): https://github.com/westurner/wiki/blob/master/MakefileThe text was updated successfully, but these errors were encountered: