ceeff7e911
- Mako is now a core dependency
- therefore no more 'email' extra
- add `get_install_handler()` method for app handler
- add `render_mako_template()` method for app handler
- add `resource_path()` method for app handler
- install handler thus far can:
- confirm db connection
- make appdir plus config/scripts:
- wutta.conf
- web.conf
- upgrade.sh
- upgrade db schema to create tables
- from there web app can run, create admin user
- quick start docs now describe "generated code" option
49 lines
1.8 KiB
Python
49 lines
1.8 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
#
|
|
# For the full list of built-in configuration values, see the documentation:
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html
|
|
|
|
# -- Project information -----------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
|
|
|
|
from importlib.metadata import version as get_version
|
|
|
|
project = 'WuttJamaican'
|
|
copyright = '2023-2024, Lance Edgar'
|
|
author = 'Lance Edgar'
|
|
release = get_version('WuttJamaican')
|
|
|
|
# -- General configuration ---------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
|
|
|
|
extensions = [
|
|
'sphinx.ext.autodoc',
|
|
'sphinx.ext.intersphinx',
|
|
'sphinxcontrib.programoutput',
|
|
'sphinx.ext.viewcode',
|
|
'sphinx.ext.todo',
|
|
'enum_tools.autoenum',
|
|
]
|
|
|
|
templates_path = ['_templates']
|
|
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
|
|
|
|
intersphinx_mapping = {
|
|
'mako': ('https://docs.makotemplates.org/en/latest/', None),
|
|
'packaging': ('https://packaging.python.org/en/latest/', None),
|
|
'python': ('https://docs.python.org/3/', None),
|
|
'python-configuration': ('https://python-configuration.readthedocs.io/en/latest/', None),
|
|
'rattail': ('https://rattailproject.org/docs/rattail/', None),
|
|
'rattail-manual': ('https://rattailproject.org/docs/rattail-manual/', None),
|
|
'rich': ('https://rich.readthedocs.io/en/latest/', None),
|
|
'sqlalchemy': ('http://docs.sqlalchemy.org/en/latest/', None),
|
|
'wutta-continuum': ('https://rattailproject.org/docs/wutta-continuum/', None),
|
|
}
|
|
|
|
|
|
# -- Options for HTML output -------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
|
|
|
|
html_theme = 'furo'
|
|
html_static_path = ['_static']
|