Sphinx Theme for Documentation

Presented at EuroSciPy 2025 Poland
Author

Revathy Venugopal

Published

August 20, 2025

Sphinx Theme for Documentation

Presented at EuroSciPy 2025 Krakow, Poland.

Overview

A 20-minute talk on building and customizing Sphinx themes for technical documentation, sharing lessons learned and best practices for maintainable, scalable docs.

Motivation

Why documentation themes matter for usability, branding, and developer experience.

Key Points

  • Sphinx theme architecture
  • Customization strategies
  • Integration with documentation workflows
  • Demo highlights

Demo

Screenshots and code snippets from the live demo.

Images

Demo Screenshot

Video

Watch the talk on YouTube

Q&A

  • Upstream the features to the community
  • Make it easier to customize
  • Improve testing

Resources

Lessons Learned

Reflections on presenting, audience feedback, and future improvements.