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

[Nicolas P. R. <Nic...@in...>]

> On 23 Dec 2016, at 18:25, Guenter Milde <mi...@us...> wrote:
> 
> Dear Nicolas,
> 
> On 2016-12-22, Nicolas P. Rougier wrote:
> 
>> 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.


> 
> 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

> 
> 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
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
> 
> Please use "Reply All" to reply to the list.