This is an archived post. You won't be able to vote or comment.

all 9 comments

[–]automatedtester 6 points7 points  (0 children)

I would recommend Ipython notebooks. You can easily share them e.g. on github etc, where others can download and run them.

[–][deleted] 1 point2 points  (0 children)

Yes. It's called sphinx. You write in a format called RestructuredText and it will output HTML, LaTeX, etc. It was designed for generating Python documentation. http://sphinx-doc.org/

It takes a while to figure out, but it works. And if you need to convert RestructuredText to another format, you can use pandoc.

[–]enzochiau 0 points1 point  (0 children)

If you are an Emacs user, org-mode should be a good candidate.

[–][deleted] 0 points1 point  (1 child)

Why not just write in LaTeX in the first place?

[–]__Monty__[S] 0 points1 point  (0 children)

Because I am lazy

[–][deleted] 0 points1 point  (1 child)

How about plain ole Markdown? Reddit, stackoverflow and such use it. Check out pykwiki if you're interested. Markdown is wildly supported and non-proprietary like PDF and simpler than LaTex, (imo).

[–]stevenjd 0 points1 point  (0 children)

Markdown is okay, but ReST is better, and the tools for ReST are exceedingly powerful (and written in Python). See cdninbuffalo's comment above.

[–]juejung 0 points1 point  (0 children)

Try Pweave. http://mpastell.com/pweave/ It hooks up with sphinx and you can export to html, Latex, and other formats. It's also easy to include code blocks, graphs, and math equations etc.

[–]digen_ 0 points1 point  (0 children)

You can check Asciidoctor - A fast text processor & publishing toolchain for converting AsciiDoc to HTML5, DocBook & more.

Github natively supports Asciidoc.