Live data from Hacker News

Ask HN: What software should I use to write a textbook?

news.ycombinator.com

51–60 of 70 posts

Re: Ask HN: What software should I use to write a textbook?

#51
I used Latex for several books and liked it. I once wrote a single book, but in Java and Common Lisp editions, and Latex worked really well for that.

Then I switched to Leanpub.com and never looked back. With Leanpub markdown you can still use Latex for formulas.

I love to write and Leanpub takes almost all of the hassle/overhead out of the process.

Re: Ask HN: What software should I use to write a textbook?

#52
post #17

My process is to use markdown [1] (very little style related formatting) and then convert to a desired format using pandoc [2]. Building multiple books that look the same, later revisions, etc - becomes really easy. One of the benefits is that you can convert a chapter to a webpage and gauge interest in the book itself. [1] https://daringfireball.net/projects/markdown/ [2] http://pandoc.org/

+1 for this. I do this at work for documentation. Markdown presents well on github and using Pandoc with Makefiles so I don’t have to remember the options for generating PDFs, Word format, etc.

Re: Ask HN: What software should I use to write a textbook?

#54
post #4

Begin with plain ASCII text. It's very easy to get distracted by the formatting and looks. Content is what's important. So begin with a basic editor like notepad/vi/emacs. Perhaps at best markdown. Get it done, then edited, then you can typeset with something like Latex/Word.

Latex is a bad recommendation I'd say. Just use AsciiDoc. The rest I agree with.

Writing in LaTeX is a bad recommendation indeed. It's huge (my install is over 5gb) it's slow (my thesis took minutes to render), hard to work with, has terrible error messages, and it is beyond difficult placing figures where you want them.

It is the easiest syntax for equations, but not everyone needs those. It does look better than Word, but it is a very high cost for a bit of good-looking.

Re: Ask HN: What software should I use to write a textbook?

#55
I highly recommend https://github.com/softcover/softcover see dogfooded demo http://manual.softcover.io/book

You can write the text either as Markdown or LaTeX, and softcover will build PDF, HTML, ePUB, mobi versions of the book for you.

It's the only ePub generation strategy that I know of that doesn't butcher the math.

Re: Ask HN: What software should I use to write a textbook?

#58

If you have time to invest, go for a TeX variant (LaTeX or ConTeXt). That gives full control over any typesetting detail. I’d recommend ConTeXt [0] over LaTeX. A minimal document is as simple as \starttext Start writing here… \stoptext and you can go a long way from there, including making ebooks. Much better than LaTeX for layout control, language support, graphics integration, table generation, etc… It’s also intim…

Give LyX (https://www.lyx.org/) a try. It has a TeX/LaTeX backend and a handy UI.

Check a tutorial for the basic workflow and you are all set.

Many people have used it and still use it for their books, theses and such. I wrote my thesis with it back in the days. The best part was to be able to just focus on the writing, not formatting.

There is a layout mimicing the layout used by Edward Tufte in his books. That layout is awesomely readable (a highly subjective observation, I know).

Re: Ask HN: What software should I use to write a textbook?

#59
Am I allowed to advertise my own work? :) I added some features to Helpinator that make it more convenient to write textbooks, especially on programming. For example, you can add self-check quizzes, step-by-step guides, easily manage code snippets, etc. And you can export to 10+ formats, including PDF. Or export to Github-flavored markdown to submit it to Github.
Post reply on HN