On Thu, Apr 8, 2021 at 7:55 AM Steve Litt <[email protected]> wrote:
Hi Steve. Thanks for the summary. I'm not sure I have the attributions correct below, but here are my comments. > I'm also looking into something called Restructured Text and a program called Sphinx that seems to be a front end for Restructured Text. It's complicated and I don't think would be appropriate for Lindsey. Imo, Sphinx + rST are relatively easy to learn. Those tools should suffice to write almost any book. > There's also an outliner called Leo, which you can author entirely as an outline with headlines that do or don't contain body text, and then (I think) you can run a converter program, possibly one you'd need to create yourself, to turn it into a ready made book, probably either PDF or HTML/ePub. Hmm. It would be nice if commentators tried out the tools they are describing. Leo's rst3 command is the "converter" program. rst3 complements rST/sphinx as follows: - Can generate multiple documents from a single outline: one per @rst node en. - Automagically creates rST section markup using outline structure. This means you can reorganize your paper or book freely, a huge advantage. - Optionally generates intermediate files for sphinx. > As we have been describing on leo-editor, rst3 supports a very few frills, including ignoring parts of the @rst tree entirely, or not generating section markup for one or more nodes, thereby allowing authors to organize long sections using suboutline. > This isn't appropriate for Lindsey, because it's a huge system with huge capabilities requiring a lot of knowledge: It's a commitment. I'm copying the Leo list on this email. Did the commentator mean that Leo itself is a huge system? True enough, but working through Leo's tutorials <http://leoeditor.com/tutorial.html> is all someone needs to do to start writing their opus. > I feel everybody's pain. As far as I know, there's not a single piece of software out there that authors quickly and yet does consistent, styles-based formatting and outputs to both PDF and HTML. But I'll keep searching. To summarize my responses to such discussions: 1. You're screwed if you insist on wysiwyg. How do you create a table of contents? 2. Some people spend their whole life complaining about missing tools, without any clear idea of what they want. Others use the tools that do exist. Some people even help improve the tools they use :-) Edward -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/leo-editor/CAMF8tS3rtrbAWrwh7MbHi1sPSBWWLaceoXpJWHShJ%3Dbkd1qCGQ%40mail.gmail.com.
