Sphinx #2
Open
Sphinx #2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
$ for f in *.tex; do pandoc -f latex -t rst -o ${f%.*}.rst $f; done
(A) Initial approach:
$ for f in *.tex; do pandoc -f latex -t rst -o ../${f%.*}.rst $f; done
This does not handle the references (e.g. to chapters) properly.
(B) However, this does - it just needs cutting up again:
$ pandoc -f latex -t rst -o Tutorial.rst Tutorial.tex
Wrote a simple script to do this (after earlier standardising the
chapter labels to help):
$ pandoc -f latex -t rst Tutorial.tex | ../.github/rst_chunk.py
Fixes the chapter numbers, but dumps the references to the
end of the appendix (poorly formatted anyway).
This then fixes links to other chapters (since pandoc was writing
a single large RST file, it made all the links internal HTML style
starting with hash):
$ sed -i.bak "s/<#chapter:/<chapter:/g" chapter_*.rst
(C) Wrote a script to convert the links to :ref: style instead,
First, hack the comment lines which otherwise pandoc ignores,
the convert to RST:
$ sed -i.bak "s#^%doctest#\\\pandocignoreme .. doctest#g" *.tex
$ sed -i.bak "s#^%cont-doctest#\\\pandocignoreme .. cont-doctest#g" *.tex
$ for f in *.tex; do pandoc -f latex -t rst -o ../${f%.*}.rst $f; done
$ git checkout *.tex
Then fix links:
$ ../.github/ref_fix.py chapter_*.rst
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I hereby agree to dual licence this and any previous contributions under both
the Biopython License Agreement AND the BSD 3-Clause License.
I have read the
CONTRIBUTING.rstfile, have runpre-commitlocally, and understand that continuous integration checks will be used to
confirm the Biopython unit tests and style checks pass with these changes.
I have added my name to the alphabetical contributors listings in the files
NEWS.rstandCONTRIB.rstas part of this pull request, am listedalready, or do not wish to be listed. (This acknowledgement is optional.)
Closes #...