Closer to home, maybe: explain how to create Sphinx documents with the Leo-editor but don't explain what Leo, Sphinx, or ReStructured text are
To create Sphinx documents with the Leo editor, follow these steps: 1. Install Sphinx: Use a package manager like pip to install Sphinx on your system. 2. Create a new Leo outline: Open the Leo editor and create a new outline file with a .leo extension. 3. Configure Sphinx: Add a section at the top of the outline file to specify Sphinx configuration. Begin with @settings and include @language rst to set the language as reStructuredText. 4. Add document content: Below the configuration section, create nodes or sections to represent the document content. Use Leo's outlining features to structure the content hierarchically. 5. Use reStructuredText markup: Within each node, write the content using reStructuredText markup. This markup language offers various formatting options for headings, bullet points, code blocks, tables, etc. 6. Generate Sphinx documentation: Save the Leo outline file. 7. Generate the Sphinx documentation: Open the command prompt or terminal, navigate to the directory where the Leo outline file is saved, and run sphinx-build -b html sourcedir outputdir. Replace sourcedir with the path to the directory containing the Leo outline file, and outputdir with the path to the directory where the Sphinx documentation should be generated. 8. View the generated documentation: After the documentation is generated, open the HTML files in a web browser to view the Sphinx documentation. Start with the index.html file or any other entry point file generated by Sphinx. By following these steps, you can create and organize Sphinx documents using the Leo editor's outlining capabilities, and then generate the final documentation using Sphinx. On Thursday, May 18, 2023 at 11:13:40 AM UTC-4 Edward K. Ream wrote: > On Wed, May 17, 2023 at 2:51 PM Paul S. Wilson <[email protected]> wrote: > >> Thought this might be of wide interest. >> > > Thanks for this Paul. > > I still prefer google for most of my reference needs. I seem to be in a > minority. > > 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/a6d73759-f0b9-4280-b6c2-c7ee2155fa1fn%40googlegroups.com.
