Hey, I was just reading the docs to better understand the internals. This doc is really informative and interesting and I love the conversational writing style! I hope you don't mind, I made a few quick ten minute proofs/edits. My only question is if this rst doc is the right place to make the edits to populate the ipynb file? Thanks.
Fix the display of code samples in the Mathjax example doc, and squash
some warnings when building the docs.
This still doesn't make most of the examples display, because pandoc
makes the \begin{} & \end{} block into a raw latex block, which isn't
rendered in the HTML output. Not sure what to do about that.
The pngs could be generated from inkascape in a loop, though for reason X
or Y, inkscape 0.91 refuse it.
The command to generate the icns is
iconutil -c icns -o ipynb.icns ipynb.iconset
- yes the folder have to be named icon.iconset, because apple
- yes the file icon_111x111@2x.png is the same than icon_222x222.png
but the @2x make a difference on retina screen, because apple
right now in **some conditions** the iconutils fails with out of memory.
we should try to pngcrush some images.
Updating broken reference to notebook examples
Since the notebook directory doesn't contain a readme anymore, updating to point to the index notebook rendered via nbviewer
Added working speaker notes for slides.
To resume, I fetch the cdn containing the files we need to make speaker notes works. Then I pass this info using the resources dict to the write which output the files in the correct path...
I make some other additions to make this feature an option from the command line, ie:
if you want a simple slideshow:
ipython nbconvert your_slides.ipynb --to slides
if you want a simple served slideshow:
ipython nbconvert your_slides.ipynb --to slides --post serve
if you want to use a local copy of the reveal.js library:
ipython nbconvert your_slides.ipynb --to slides --post serve --local reveal.js
and if you want to use speaker notes:
ipython nbconvert your_slides.ipynb --to slides --post serve --notes True
or
ipython nbconvert your_slides.ipynb --to slides --post serve --notes True --local reveal.js
but this last one is redundant because if you are using a local reveal.js library the speaker notes are functional by default.
- added links to example notebooks on nbviewer
- removde unnecessary file and parts of files
- put old htmlnotebook.html redirect (for Notebook Help urls in 0.13.x)
- moved working_remotely to public_server
- re-arrangement of notebook connection stuff
- more cross-referencing of documentation sections
- made links to magic command explanation in tutorial
- and many more changes...
Renamed htmlnotebook.txt to notebook.txt. 79-char width hard wrapping imposed. Rearrangment of order and level within notebook.txt. Almost no text modified.
Equation References and Numbering are not going to be trivial to add,
so the code has been removed for now. Important fixes include
no-MathJax support (previously, the code was failing), and the
generation of unique ids for the rendering content in each cell,
tremendously speeding up MathJax rendering.
I am still not rendering placeholder text.
MathJax.InputJax.TeX.resetEquationNumbers is supposed to be available,
but isn't consistently loaded before the notebook fires off its first
re-render request. The code edits in mathjaxutils.js fix this issue.
Additionally, there was some init code in mathjaxutils.js that has been
properly excised to the html templates.
Removed some orphan rendering code so that all typesetting now goes
through mathjaxutils.js
Finally, removed an extra cell in the demo notebook.