Sphinx Seems Good

I’ve been going over the Sphinx docs, not in depth but just trying to get the sense of it. So far I’m impressed.

  • It’s Restructured Text with (most of?) the missing parts filled in. There are lots of additional features and tags that will be useful in creating this book.
  • The output options seem much better, and it provides templating for a custom look.
  • It’s been road-tested on the new python documentation.
  • The structure of a multi-chapter project has already been decided, so it doesn’t need to be figured out for this book.
Advertisements

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


%d bloggers like this: