Published by Mijingo

movie icon image

EE Insider Blog

Spend your time learning and developing sites with ExpressionEngine and we'll use this blog to keep you informed of all the news related to ExpressionEngine and CodeIgniter.

» Read more in the Archives.

» Have a tip? Send us your EE news.

Learn ExpressionEngine Today

Over a series of 8 videos, watch and learn as Ryan builds an entire ExpressionEngine website from beginning to end. Get started now.

EE Add-on Documentation Using Sphinx

I have a post planned on the new documentation from EllisLab but until then, read this tutorial from Exp:resso on how to document your CodeIgniter and EE add-ons using the same tool that EllisLab uses: Sphinx.

The beauty of using Sphinx is that you can write your documentation using ReStructuredText, a text format similar to MarkDown. You can then easily generate your docs in a variety of output formats, including HTML and PDF. It also helps to keep your content separate from design, and automatically handles repetitive tasks such as generating a table of contents / navigation, and linking between your documents.

The blog post walks you through the entire process of installing Sphinx and styling it like the official ExpressionEngine documentation.

Read the full tutorial: Documenting ExpressionEngine and CodeIgniter Add-ons

Posted on Nov 01, 2011 by Ryan Irelan

Filed Under: Development Tools, EE Add-ons