{"id":1680,"date":"2016-02-10T18:57:50","date_gmt":"2016-02-10T23:57:50","guid":{"rendered":"http:\/\/unitstep.net\/?p=1680"},"modified":"2016-02-10T18:57:50","modified_gmt":"2016-02-10T23:57:50","slug":"converting-an-ipython-notebook-to-pdf","status":"publish","type":"post","link":"https:\/\/unitstep.net\/blog\/2016\/02\/10\/converting-an-ipython-notebook-to-pdf\/","title":{"rendered":"Converting an IPython Notebook to PDF"},"content":{"rendered":"<p>If you have an IPython Notebook (<code>*.ipynb<\/code> file), you may want to convert to <acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym> for distribution. If you read the <a href=\"https:\/\/ipython.org\/ipython-doc\/3\/notebook\/nbconvert.html\">documentation for <code>ipython nbconvert<\/code><\/a>, it seems fairly straightforward:<\/p>\n<pre><code>$ ipython nbconvert --to <acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym> &lt;your notebook&gt;.ipynb<\/code><\/pre>\n<p>However, if you run that, you&#8217;re likely to run into an error asking to you install Pandoc; this is because <code>nbconvert<\/code> relies on an intermediate conversion to LaTeX first, and then to the final <acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym> output. Pandoc is used for this. To install on OS X:<\/p>\n<pre><code>$ brew install pandoc<\/code><\/pre>\n<p>Running the conversion again yields another error, suggesting you need the <code>pdflatex<\/code> command; Pandoc doesn&#8217;t include any built-in support for LaTeX-><acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym>, so you&#8217;ll need a LaTeX install. The <a href=\"http:\/\/pandoc.org\/installing.html\">Pandoc documentation<\/a> suggests BasicTeX:<\/p>\n<pre><code>$ brew cask install basictex<\/code><\/pre>\n<p>Trying conversion results in another failure. Turns out, you need to <a href=\"https:\/\/github.com\/ipython\/ipython\/issues\/8814\">install some more LaTeX packages<\/a>:<\/p>\n<pre><code>$ sudo tlmgr update --self\r\n$ sudo tlmgr install adjustbox\r\n$ sudo tlmgr install collectbox\r\n$ sudo tlmgr install ucs<\/code><\/pre>\n<p>After this, you should be able to do your conversion and have a fairly-decent <acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym> output based on your IPython Notebook:<\/p>\n<pre><code>$ ipython nbconvert --to <acronym class=\"uttInitialism\" title=\"Portable Document Format\">PDF<\/acronym> &lt;your notebook&gt;.ipynb<\/code><\/pre>","protected":false},"excerpt":{"rendered":"<p>If you have an IPython Notebook (*.ipynb file), you may want to convert to PDF for distribution. If you read the documentation for ipython nbconvert, it seems fairly straightforward: $ ipython nbconvert &#8211;to PDF &lt;your notebook&gt;.ipynb However, if you run that, you&#8217;re likely to run into an error asking to you install Pandoc; this is [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[403,277],"tags":[],"_links":{"self":[{"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/posts\/1680"}],"collection":[{"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/comments?post=1680"}],"version-history":[{"count":4,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/posts\/1680\/revisions"}],"predecessor-version":[{"id":1734,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/posts\/1680\/revisions\/1734"}],"wp:attachment":[{"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/media?parent=1680"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/categories?post=1680"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/unitstep.net\/wp-json\/wp\/v2\/tags?post=1680"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}