opensource/galaxy
3
0
Fork 0
mirror of https://github.com/galaxyproject/galaxy.git synced 2026-09-24 16:30:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

Use sed instead of pandoc to insert TOC in schema doc

Browse Source 
pandoc < 1.14 adds the TOC depth as a float, which is not recognised by
Sphinx.
Also, move the TOC after the introduction, which looks nicer.
This commit is contained in:
Nicola Soranzo
2016-11-07 16:32:12 +00:00
parent 78dfb95f02
commit 7c030ebf2f
1 changed files with 3 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/Makefile
+3 -1
View File
@@ -48,8 +48,10 @@ schema.md: parse_gx_xsd.py schema_template.md ../lib/galaxy/tools/xsd/galaxy.xsd
python parse_gx_xsd.py schema_template.md ../lib/galaxy/tools/xsd/galaxy.xsd > $@
source/dev/schema.rst: schema.md ## Convert Galaxy Tool XSD Markdown docs into reStructuredText (expects pandoc in environment)
pandoc schema.md -f markdown_github-hard_line_breaks -s --toc --toc-depth=2 -o $@
pandoc schema.md -f markdown_github-hard_line_breaks -s -o $@
sed -i -e 's|.. code:: xml|.. code-block:: xml|g' $@
# Insert table of contents
sed -i -e '/^``tool``$$/i .. contents:: Table of contents\n :local:\n :depth: 1\n..\n' $@
# might also want to do
# cd source/lib; hg revert; rm *.rst.orig; or not.