S.Lott -- Software Architect
  • Other Articles
  • Publications
  • S.Lott Biography

Tragedy Averted

Date Tue 09 August 2022 Tags sphinx / #python / literate programming / docutils / plantuml / pyWeb

I almost made a terrible blunder.

See https://github.com/slott56/py-web-tool for some background. This is a "Literate Programming" tool. I started fooling around with this kind of thing back in '05 (maybe even earlier.) This is not the blunder. The whole idea of literate programming is not very …

more ...

Writing Tools

Date Tue 07 February 2017 Tags RST / docutils / writing / epub / tools

Read this: http://thesweetsetup.com/apps/our-favorite-pro-writing-app-for-mac/

What I have been doing instead of using these sophisticated, integrated writing tools?

I use OmniOutliner. https://www.omnigroup.com/omnioutliner I've used it for years. It does a lot of things. Most notably, I can create multiple columns so that I can …

more ...

That Feeling When... You're reading your own documentation because it's useful and (mostly) correct

Date Tue 09 August 2016 Tags RST / sphinx / docutils

I'm looking at code (as a man does) and I can't remember if there's a class that does X. There's a lot of code. I wrote almost all of it. And -- maybe it's the gin -- but I just can't recall if there's an X. It seems like there should be …

more ...

Using SCons

Date Wed 01 September 2010 Tags RST / scons / #python / docutils / continuous integration

In looking at Application Lifecycle Management (see "ALM Tools"), I had found that SCons appears to be pretty popular. It's not as famous as all the make variants, or Apache Ant or Apache Maven, but it seems to have a niche in the forest of Build Automation Software.

While it …

more ...

Building Documentation

Date Wed 31 December 2008 Tags open-source / documentation / docutils / sphinx

For years, I've written documentation using ReStructured Text (RST). It's just one of several "lightweight markup languages ". For others, look at Markdown , StructuredText , Setext , among many others.

I generally use the rst2html utility that comes with Docutils . It works fine for small things.

I just read about the Sphinx documentation …

more ...

  • Social

    • Mastodon
    • Github
    • StackOverflow
    • LinkedIn
    • O'Reilly
    • Amazon
  • Categories

    • Architecture & Design
    • Books
    • FOSS
    • Management
    • News
    • Python
    • Technologies
  • Links

    • Pelican
    • Python.org
    • Jinja2
  • Archive

    • August 2022 (1)
    • February 2017 (1)
    • August 2016 (1)
    • September 2010 (1)
    • December 2008 (1)

© 2022 S.Lott · Powered by pelican-bootstrap3, Pelican, Bootstrap

Back to top