Skip to content

canonical/sphinx-docs-starter-pack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Canonical's Sphinx Starter Pack

A pre-configured repository to build and publish documentation with Sphinx.

Description

The Documentation starter pack includes:

  • A bundled Sphinx theme, configuration, and extensions
  • Support for both reStructuredText (reST) and MyST Markdown
  • Build checks for links, spelling, and inclusive language
  • Customisation support layered over a core configuration

See the full documentation: https://canonical-starter-pack.readthedocs-hosted.com/

Structure

This section outlines the structure of this repository, and some key files.

docs

This directory contains the documentation for the starter pack itself. To view it in your browser, change to this directory and type make run.

tests

This directory contains files used to test the functionality of the starter pack project.