[Docutils-users] Book using rst2html: From Python to Numpy

[Paolo Cavallini]

I've put online a book (From Python to Numpy) that has been written in rst and transformed using rst2html.py.
I find the result quite nice but of course, it's a matter of personal taste...
The book can be read at: http://www.labri.fr/perso/nrougier/from-python-to-numpy/
Sources are available at: https://github.com/rougier/from-python-to-numpy

Thanks Nicolas, very inspiring.
All the best.
--
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html
https://www.google.com/trends/explore?date=all&geo=IT&q=qgis,arcgis

------------------------------------------------------------------------------
Developer Access Program for Intel Xeon Phi Processors
Access to Intel Xeon Phi processor-based developer platforms.
With one year of Intel Parallel Studio XE.
Training and support from Colfax.
Order your platform today.http://sdm.link/intel
_______________________________________________
Docutils-users mailing list
Docutils-***@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-users

Please use "Reply All" to reply to the list.

[Guenter Milde]

Dear Nicolas,

I've put online a book (From Python to Numpy) that has been written in
rst and transformed using rst2html.py. I find the result quite nice but
of course, it's a matter of personal taste...
The book can be read at: http://www.labri.fr/perso/nrougier/from-python-to-numpy/
Sources are available at: https://github.com/rougier/from-python-to-numpy

Thank you for sharing the work.

Did you also try to get a LaTeXed version? I would be interested to see
the mileage of such a larger work with the latex writer. It should be
possible to use the tufte class (or any other suitable one) with
rst2latex.py or rst2xetex.py (the latter can also be used together with
lualatex, despite the name).

Also, it would be interesting to see whether the html5 writer results in
improvements. However, this would require some work to get the custom CSS
adapted.

Joyeux Noël !

Günter

[Nicolas P. Rougier]

Post by Guenter Milde
Dear Nicolas,

I've put online a book (From Python to Numpy) that has been written in
rst and transformed using rst2html.py. I find the result quite nice but
of course, it's a matter of personal taste...
The book can be read at: http://www.labri.fr/perso/nrougier/from-python-to-numpy/
Sources are available at: https://github.com/rougier/from-python-to-numpy

Thank you for sharing the work.
Did you also try to get a LaTeXed version? I would be interested to see
the mileage of such a larger work with the latex writer. It should be
possible to use the tufte class (or any other suitable one) with
rst2latex.py or rst2xetex.py (the latter can also be used together with
lualatex, despite the name).

I did not try the latex writer yet because I introduced some html-tricks into my rst.
I wanted to have figure legends on the side at the level of the image and the syntax
I came up is:

.. admonition:: **Figure**

Figure caption

.. image:: some-image.png
:width:100%

I did not yet managed to do the same with the figure environment. This would make a mess
in latex.

Post by Guenter Milde
Also, it would be interesting to see whether the html5 writer results in
improvements. However, this would require some work to get the custom CSS
adapted.

Currently the output of rst2html5.py is quite broken but I need to investigate.
Most probably some of my css needs to be rewritten.


If you want to try, you can fork the github repo and compare:


rst2html.py --link-stylesheet --toc-top-backlinks --cloak-email-addresses --stylesheet=book.css book.rst book-1.html

vs
rst2html5.py --link-stylesheet --toc-top-backlinks --cloak-email-addresses --stylesheet=book.css book.rst book-2.html


Merry Christmas,
Nicolas

Post by Guenter Milde
Joyeux Noël !
Günter
------------------------------------------------------------------------------
Developer Access Program for Intel Xeon Phi Processors
Access to Intel Xeon Phi processor-based developer platforms.
With one year of Intel Parallel Studio XE.
Training and support from Colfax.
Order your platform today.http://sdm.link/intel
_______________________________________________
Docutils-users mailing list
https://lists.sourceforge.net/lists/listinfo/docutils-users
Please use "Reply All" to reply to the list.