I've been plugging away New User's Guide. I've also changed the name of the top-level file to *index.html*. The rest of the URL remains the same: New User's Guide <http://tompassin.net/leo/guide/docs/index.html>.
On Saturday, May 20, 2023 at 7:37:29 PM UTC-4 Thomas Passin wrote: > > > On Saturday, May 20, 2023 at 6:10:24 PM UTC-4 Ben Hancock wrote: > > [snip] > > > Hi Rob, > > Thanks. I'd be grateful for your tips. It looks like I can probably get > a good start on point 2 (creating documents) with the "Creating > Documents from Outlines" tutorial[1], but if there are particular things > you've learned that would be helpful for a newbie, please share. > > > I do have some good tips to pass on if you are using ReST and especially > Sphinx, including one or two that are probably not quite obvious. I think > that using Leo with Sphinx to generate HTML documentation - once you learn > certain key bits - is unbeatable for convenience. For pdf, the output > isn't as good. That's mostly because the pdf generator doesn't produce the > best quality output. But I haven't tried generating pdf for several years > and maybe things have improved. > > > Learning more about how to use Leo to maintain a small website would be > great too. I currenly use a mix of HTML, Go templates, and pandoc for my > own site (I'm somehow never satisfied with static site generators out of > the box), but it seems like cloned nodes in Leo could go a long way to > making maintaining things like shared ``<head>`` sections easier, if I'm > understanding things right. > > > Basically, if you can create some boilerplate that can be reused for many > sites, then clones will probably be useful. Bear in mind that clones > should normally be within a particular outline; clones between outlines > can cause update problems. Depending on the details of your workflow, it > may be possible to write a Leo script to do all the steps, or some of > them. IOW, you could finalize the files, run the script, and have > everything built. Or, if you can write a batch file that can do all the > steps, you could launch that file from within Leo. And you can write and > manage that batch file in Leo itself. > > I believe that some people have worked out ways to use Jinja templates, > but I'm not one of them. If you can write Python scripts, you can get Leo > itself to do a surprising number of things. > -- 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 leo-editor+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/leo-editor/cc23d419-c10b-4bc4-8f50-9e389a2dc264n%40googlegroups.com.