Skip to content
This repository was archived by the owner on Apr 24, 2020. It is now read-only.

Conversion to PDF (Edge Cases and Conversion Issues)

Anju Joon edited this page Jul 8, 2019 · 25 revisions

Conversion Issues

rst ipynb latex impacts issue description update resolved
( %28 headings Opening bracket in the heading is replaced by %28 in ipynb file for HTML conversion but a bracket in the heading is simply ignored by pandoc and thus creates undefined reference issues extension no
) %29 headings A closing bracket in the heading is replaced by %29 in ipynb file for HTML conversion but a bracket in the heading is simply ignored by pandoc and thus creates undefined reference issues extension no
🏷️ abc math equations The HTML links are completely ignored by pandoc thus creating a reference issue if the equations are referenced later in the lecture no
.. _abc sections These labels are to refer to some particular part of the lecture and since HTML links are ignored by pandoc so again reference issues no
.. figure:: path/abc.png figures Pandoc is ignoring the HTML links and thus ignoring the figures no
:ref:`abc abc Section \ref{label} internal links Anything in between [] is replaced by section and also the internal link is broken for the lecture no
:ref:`abc abc Section \ref{label} internal links Anything in between [] is replaced by section and because of \ref{} the internal link is broken for the lecture no
:cite:Rust1996 [Rus96] \href{zreferences.html#rust1996}{{[}Rus96{]}} Citations The cite key for example(Rus96) and the link is preventing pandoc to identify the exact cite label no
abc_xyz abc-xyz abc_xyz labels/citations no

Update locations should be:

  1. rst = rst files
  2. extension = sphinxcontrib-jupyter
  3. converter = ipynb-latex-pdf conversion
Clone this wiki locally