Skip to main content
Ctrl+K
Logo image Logo image

Documenteer

Site Navigation

  • Rubin user guides
  • Technical notes
  • Sphinx extensions
  • Change Log
  • Development
  • Rubin docs

Site Navigation

  • Rubin user guides
  • Technical notes
  • Sphinx extensions
  • Change Log
  • Development
  • Rubin docs

Section Navigation

Guides

  • Development guide
  • Release procedure

Architecture

  • Theming architecture overview
    • Handling CSS, JavaScript, and image assets
    • Handling Jinja HTML templates

Reference

  • Python API
    • documenteer.conf
      • get_asset_path
      • extend_static_paths_with_asset_extension
      • extend_excludes_for_non_index_source
      • get_template_dir
      • DocumenteerConfig
      • ConfigRoot
      • ProjectModel
      • PythonPackageModel
      • OpenApiDocsModel
      • OpenApiGeneratorModel
      • SphinxModel
      • IntersphinxModel
      • LinkCheckModel
      • ThemeModel
    • documenteer.ext
      • setup
      • generate_openapi_spec
      • setup
      • LsstBibtexStyle
      • jira_bracket_role
      • jira_parens_role
      • jira_role
      • setup
      • lsst_doc_shortlink_role
      • lsst_doc_shortlink_titlecase_display_role
      • lsstio_doc_shortlink_role
      • setup
      • mock_code_ref_role
      • setup
    • documenteer.requestsutils
      • requests_retry_session

Theming architecture overview¶

One of Documenteer’s roles for Rubin Observatory’s Sphinx documentation is customizing and branding Sphinx themes. Documenteer uses two base Sphinx themes: pydata-sphinx-theme for user guides and Technote for technotes. These pages provide an overview of how these these themes are customized by Documenteer.

  • Handling CSS, JavaScript, and image assets
  • Handling Jinja HTML templates
    • Directory structure
      • pydata layout
      • technote layout

previous

Release procedure

next

Handling CSS, JavaScript, and image assets

Edit this page

© Copyright 2015-2022 Association of Universities for Research in Astronomy, Inc. (AURA).

Built with the PyData Sphinx Theme 0.12.0.

Created using Sphinx 8.1.3.