Feature Request: Save As (latex, html,..etc) as a menu option in Notebook rather than explicit need to invoke nbconvert

[nipunbatra]

[Carreau]

Don't worry, that's (more or less) the all point of 1.0 release.

The time to do it is starting to be tight, and we need nbconvert to be finished and tested to do it.

[Norfeldt]

Where can I find the most current guide on how to use nbconvert to get my notebooks as pdf files ?

[Carreau]

here, rendered as html, in our dev doc.
here in github repository.

Comment /Questions (and fixes) welcomed.

[Norfeldt]

That was a fast response! Thank you.

I tried "ipython nbconvert --to latex myNotebook.ipynb" but got the error that some pandoc is missing..

Bonus info:
I just upgraded to the newest RC by
pip install http://archive.ipython.org/testing/1.0.0/ipython-1.0.0-rc1.tar.gz

I'm trying to install the pandoc manually now... I just thought that it came shipped with IPython nbconvert

[Carreau]

I guess you need to install pandoc... which not a python dependency so pip cannot install it.

[Norfeldt]

I installed the pandoc and had to restart windows in order for ipython to find it.

A .tex was succesfull genereated by the call
ipython nbconvert --to latex myNotebook.ipynb

But using this call
ipython nbconvert --to latex --post PDF myNotebook.ipynb

gave me this error:

[NbConvertApp] Converting notebook myNotebook.ipynb to latex
[NbConvertApp] Support files will be in myNotebook_files\
[NbConvertApp] Loaded template latex_article.tplx
[NbConvertApp] Writing 116664 bytes to .\myNotebook.tex
[NbConvertApp] Building PDF: pdflatex .\myNotebook.tex
This is pdfTeX, Version 3.1415926-2.4-1.40.13 (MiKTeX 2.9)
entering extended mode
(C:\Users\Norfeldt\Desktop\myNotebook.tex
LaTeX2e <2011/06/27>
Babel <v3.8m> and hyphenation patterns for english, afrikaans, ancientgreek, ar
abic, armenian, assamese, basque, bengali, bokmal, bulgarian, catalan, coptic,
croatian, czech, danish, dutch, esperanto, estonian, farsi, finnish, french, ga
lician, german, german-x-2012-05-30, greek, gujarati, hindi, hungarian, iceland
ic, indonesian, interlingua, irish, italian, kannada, kurmanji, latin, latvian,
lithuanian, malayalam, marathi, mongolian, mongolianlmc, monogreek, ngerman, n
german-x-2012-05-30, nynorsk, oriya, panjabi, pinyin, polish, portuguese, roman
ian, russian, sanskrit, serbian, slovak, slovenian, spanish, swedish, swissgerm
an, tamil, telugu, turkish, turkmen, ukenglish, ukrainian, uppersorbian, usengl
ishmax, welsh, loaded.
! Undefined control sequence.
<argument> C:\Python
27\lib \site -packages\sphinx \texinputs /sphinxhowto
l.11

?

[jakobgager]

There is currently an issue with escaping backslashes during the conversion to tex see #3588.
Seems like you met it 😕
I just wonder why this happens in the preamble as well (line 11) ...

Moreover, there is a mixture of / and \ in this path
C:\Python27\lib\site-packages\sphinx\texinputs/sphinxhowto

[Norfeldt]

How do I fix it?

The ? is like waiting for an input so I pasted the real address to sphinxhowto

I tried both the ENTER, R and Q but no luck

it still gives the ! Undefined control sequence.

[jakobgager]

You can try to change the preamble line in the tex file to point to the correct address (only as a workaround).
I have no Win system to try, sorry.

[jakobgager]

I found a Win and you can solve your problem (no fix!) by changing the \s in the paths in the .tex file to /.
A respective fix was merged as #3888 - however in current master only - not in rc1.
You can upgrade (pip install https://github.com/ipython/ipython/archive/master.zip) and test it.

[Norfeldt]

Thank you jakob!

It is working now.. It downloaded a lot of libs and gave me a bunch of missing } which I just forced to ignored by typing Q and ENTER.

I can see now that the nbconvert is not fully finished since a lot of text spans out of the code blocks and the caption images does not display..

[jakobgager]

Caption images? Can you post your notebook somewhere?

[Norfeldt]

Not this one.. sorry

But I'll make one I can post as an example - it will however have to wait until tomorrow

[ivanov]

@Norfeldt actually, the fix for the issue you were seeing on windows was addressed in #3901. You can see here that it was just a one line code change, so you can apply the fix yourself, but it is now in master.

[Norfeldt]

@ivanov thank you.. I however don't know how to do this.. Do I change it in the python27 directory or do I have to change it in the downloaded zip I used for pipand then run it again pip install local/dir/to/manually/adjusted/source/code/master.zip

@jakobgager and @Carreau I tried opening the notebook with the 1.0.0-dev (pip install https://github.com/ipython/ipython/archive/master.zip) but then I got the white screen of dead again in the browser when starting the notebook (ipython notebook).

I then reversed "back" to the RC pip install http://archive.ipython.org/testing/1.0.0/ipython-1.0.0-rc1.zip

I have made you an example notebook which you can download from here:
https://dl.dropboxusercontent.com/u/3216968/nbConvertExample.zip

It should look like this:

---

---