Hacker News new | ask | show | jobs
by jonathanpoulter 2742 days ago
Thanks for your advice, I'm currently starting down the path of writing (what I hope will become) a book. I'm at your piece of advice I). I'm working on a framework which links LaTeX and Python notebooks in a dynamic compilation setup [1], so reading your first point of advice makes me think I might have started on the wrong path.

Did your setup ultimately prove useful in writing your book? Or did you give up part way through and that helped you get to the task of actually writing?

[1] https://github.com/poulter7/ipynb-tex

2 comments

I have written three scholarly history books [0] where custom Python code was used to generate TeX files (not LaTeX) that were then typeset into PDF.

Python's main purpose was to enable thousands of cross-references across the books, and to transform a large, every-changing text database into a pleasing output, where different parts of the database had different output formats.

Perhaps a TeX wizard could have done it all in pure TeX, but I never could have. Besides, who wants to learn all the intricacies of TeX/LaTeX when the task in Python is so straightforward? To this day, I can't imagine a different approach.

Joining the Python and TeX pieces together into simple scripts was trivial. The Python code evolved as I got into the books, so I would recommend a rapid-iteration model of code development, rather than building a perfect edifice before starting.

[0] http://www.physical-lincoln.com

whenever i hid a rough patch during writing i started enhancing, debugging my setup. it was beautiful. it was a beautiful distraction. a beautiful, interresting timesink. my linux skills improved - a lot, but otherwise no, it did not prove usefull. i could have written a book about pandoc in the end, but that was not the goal.

in the end it was sublime (the software) and focus (not a software).

after the manuscript phase it went to google docs (one doc for each chapter) for structure and work together with the editor. then indesign for the triumvirate of me, the designer and the editor.

update: just looked at your https://github.com/poulter7/ipynb-tex, damn that looks familiar... I stand with my I) recommendation