Skip to main content
Ctrl+K
Logo image Logo image

Documenteer

Site Navigation

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

Site Navigation

  • Rubin user guides
  • Technical notes
  • Science Pipelines
  • 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 reference
    • documenteer.conf
      • get_asset_path
      • get_template_dir
      • DocumenteerConfig
      • ProjectModel
      • ConfigRoot
    • documenteer.ext
      • setup
      • filter_symbolmap
      • AutoCppApi
      • setup
    • documenteer.requestsutils
      • requests_retry_session
    • documenteer.sphinxconfig
      • build_package_configs
      • build_pipelines_lsst_io_configs
      • configure_technote
      • form_ltd_edition_name
      • get_filepaths_with_extension
      • get_project_content_commit_date
      • read_git_branch
      • read_git_commit_timestamp
      • read_git_commit_timestamp_for_file
    • documenteer.sphinxext
      • setup
      • 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
      • setup
      • ModuleTocTree
      • PackageTocTree
    • documenteer.sphinxrunner
      • run_sphinx
    • documenteer.stackdocs
      • build_stack_docs
      • preprocess_package_doxygen_conf
      • render_doxygen_mainpage
      • get_doxygen_default_conf_path
      • get_cpp_reference_tagfile_path
      • run_doxygen
      • DoxygenConfiguration
      • discover_setup_packages
      • find_table_file
      • list_packages_in_eups_table
      • find_package_docs
      • Package
      • NoPackageDocs
      • discover_package_doc_dir
      • discover_conf_py_directory

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 5.3.0.