PyCon APAC 2025

Sphinx is a powerful documentation generator widely used for creating and maintaining high-quality documents. While traditionally used for documentation purposes, it also provides an interface that allows developers to extend its functionality, including adding custom builders, directives, and roles. In this session, I will explore how Sphinx can be extended to generate presentations seamlessly, using sphinx-revealjs as a case study.

Through this talk, I will demonstrate how I extended the Sphinx document builder to create presentations by leveraging the flexibility of Sphinx’s internal structure. I'll show how key Sphinx components, such as the builder and the document tree (doctree), can be adapted to output interactive presentations. Participants will gain insights into the underlying architecture of Sphinx extensions and be inspired to explore how they can enhance Sphinx for their own needs.