[haiku] Re: reStructuredText

  • From: "Charlie Clark" <charlie@xxxxxxxxxxxxxx>
  • To: haiku@xxxxxxxxxxxxx
  • Date: Fri, 08 Jul 2016 15:09:04 +0200

Am .07.2016, 08:10 Uhr, schrieb <pete.goodeve@xxxxxxxxxxxx>:

Yes.  I did some browsing, and that's exactly what it does.  I've stayed
away from LaTeX for many years.  I think my last brush was installing Tom
Rokicki's version on my Amiga!.  A bit too "heavyweight" for me, I guess.
Might be worth playing again.

Some people have managed to use Sphinx & LaTex to drive book-on-demand production at Amazon. But it does mean hacking the LaTex stuff. I would recommend using only Sphinx to drive documentation. This will let you use services like ReadTheDocs to generate and host your docs.

There is also compile-time option to use rst2pdf instead of LaTeX, which
uses the open source version of ReportLab to generate PDF files directly.

https://github.com/rst2pdf/rst2pdf
https://bitbucket.org/rptlab/reportlab
I found that too this afternoon.  Unfortunately my attempt to install it
-- unlike with DocUtils -- was not at all smooth (:-() First of all, although
the docs didn't mention it, setup.py immediately wanted setuputils.
Fortunately that is on HaikuDepot, but -- again unmentioned -- running
setup.py spent ages dowloading other packages, and finally failed
becaus it "couldn't find" zlib and freetype!  I guess some configuration
in missing, but at the moment I'm not motivated to track it down.

IMO users should only install Python packages using pip. Anything else is just asking for trouble. Python's distutils has no concept of dependencies which is why setuptools is a requirement (and included as part of pip in Python >= 3.4). PDF's use zlib compression and freetype so the paths to the libraries must be exported to the environment.

Charlie
--
Charlie Clark
Kronenstr. 27a
Düsseldorf
D- 40217
Tel: +49-211-938-5360
Mobile: +49-178-782-6226

Other related posts: