Re: New User's Guide To Leo
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 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/009ea6df-3513-4b00-8dea-d63e27918909n%40googlegroups.com.
Re: New User's Guide To Leo
> On Thursday, May 18, 2023 at 11:17:52 AM UTC-4 > Ben Hancock wrote: > > > [...] what I think might be really useful are some step-by-step > > examples of common user stories. > > > > For example: > > > > * I'm a developer working on a small-ish Python project that I > > collaborate on with other people. How can I effectively use Leo to > > start editing my existing code base? [...] > > > > * I'm a technical writer working on a publication. How can I start > > writing my outline in Leo, and then save/export it to be shared > > with others in a plain text format (ReST, Markdown, etc.)? > > > > * I manage a small website that's mostly just HTML and CSS. How can > > I use Leo's outlining framework to keep things more manageable and > > reduce duplication? > > On Thu, 18 May 2023 15:47:50 -0700 (PDT) > Rob wrote: > > Ben, I have used Leo successfully for many years in your examples 2 > and 3. I'd be glad to write up typical workflows that I use if that > would be useful, However, I agree w/ Thomas these probably aren't best > suited for a new user guide. 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. 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 sections easier, if I'm understanding things right. I appreciate that these might be too specific for a user guide, but I do like Thomas' idea of compling tutorials like this (similar to the "worg" tutorials for Emacs' org-mode[2]). Cheers, Ben [1]: https://leo-editor.github.io/leo-editor/tutorial-rst3.html [2]: https://orgmode.org/worg/org-tutorials/index.html -- Ben Hancock -- 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/20230520151020.6e74da5a3fa7c6576fa0c278%40benghancock.com.
