mirror of
https://github.com/arcan1s/ahriman.git
synced 2025-04-24 07:17:17 +00:00
docs: replace svg with dot
This commit is contained in:
parent
1e7d4daf18
commit
910d178c71
@ -4,6 +4,8 @@ build:
|
||||
os: ubuntu-20.04
|
||||
tools:
|
||||
python: "3.12"
|
||||
apt_packages:
|
||||
- graphviz
|
||||
|
||||
python:
|
||||
install:
|
||||
|
1820
docs/_static/architecture.dot
vendored
Normal file
1820
docs/_static/architecture.dot
vendored
Normal file
File diff suppressed because it is too large
Load Diff
@ -12,8 +12,7 @@ Packages have strict rules of importing:
|
||||
|
||||
Full dependency diagram:
|
||||
|
||||
.. image:: _static/architecture.svg
|
||||
:target: _static/architecture.svg
|
||||
.. graphviz:: _static/architecture.dot
|
||||
:alt: architecture
|
||||
|
||||
``ahriman.application`` package
|
||||
|
16
docs/conf.py
16
docs/conf.py
@ -10,7 +10,7 @@
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
#
|
||||
import os
|
||||
import datetime
|
||||
import sys
|
||||
|
||||
from pathlib import Path
|
||||
@ -21,13 +21,11 @@ from ahriman import __version__
|
||||
basedir = Path(__file__).resolve().parent.parent / "src"
|
||||
sys.path.insert(0, str(basedir))
|
||||
|
||||
on_rtd = os.environ.get("READTHEDOCS", None) == "True"
|
||||
|
||||
|
||||
# -- Project information -----------------------------------------------------
|
||||
|
||||
project = "ahriman"
|
||||
copyright = "2021-2023, ahriman team"
|
||||
copyright = f"2021-{datetime.date.today().year}, ahriman team"
|
||||
author = "ahriman team"
|
||||
|
||||
# The full version, including alpha/beta/rc tags
|
||||
@ -41,6 +39,7 @@ release = __version__
|
||||
# ones.
|
||||
extensions = [
|
||||
"sphinx.ext.autodoc",
|
||||
"sphinx.ext.graphviz",
|
||||
"sphinx.ext.napoleon",
|
||||
"sphinx_rtd_theme",
|
||||
"sphinxarg.ext",
|
||||
@ -78,7 +77,12 @@ html_logo = "_static/logo.svg"
|
||||
|
||||
add_module_names = False
|
||||
|
||||
modindex_common_prefix = ["ahriman.application.", "ahriman.core.", "ahriman.models.", "ahriman.web."]
|
||||
modindex_common_prefix = [
|
||||
"ahriman.application.",
|
||||
"ahriman.core.",
|
||||
"ahriman.models.",
|
||||
"ahriman.web.",
|
||||
]
|
||||
|
||||
|
||||
# -- Extension configuration -------------------------------------------------
|
||||
@ -92,3 +96,5 @@ autodoc_mock_imports = ["cryptography", "pyalpm"]
|
||||
autodoc_default_options = {
|
||||
"no-undoc-members": True,
|
||||
}
|
||||
|
||||
graphviz_output_format = "svg"
|
||||
|
4
tox.ini
4
tox.ini
@ -49,13 +49,15 @@ changedir = src
|
||||
allowlist_externals =
|
||||
bash
|
||||
find
|
||||
mv
|
||||
setenv =
|
||||
SPHINX_APIDOC_OPTIONS=members,no-undoc-members,show-inheritance
|
||||
commands =
|
||||
bash -c 'shtab --shell bash --prefix ahriman --prog ahriman ahriman.application.ahriman._parser > ../package/share/bash-completion/completions/_ahriman'
|
||||
bash -c 'shtab --shell zsh --prefix ahriman --prog ahriman ahriman.application.ahriman._parser > ../package/share/zsh/site-functions/_ahriman'
|
||||
argparse-manpage --module ahriman.application.ahriman --function _parser --author "ahriman team" --project-name ahriman --author-email "" --url https://github.com/arcan1s/ahriman --output ../package/share/man/man1/ahriman.1
|
||||
pydeps ahriman -o ../docs/_static/architecture.svg --no-config --no-show --cluster
|
||||
pydeps ahriman --no-output --show-dot --dot-output architecture.dot --no-config --cluster
|
||||
mv architecture.dot ../docs/_static/architecture.dot
|
||||
# remove autogenerated modules rst files
|
||||
find ../docs -type f -name "{[tox]project_name}*.rst" -delete
|
||||
sphinx-apidoc -o ../docs .
|
||||
|
Loading…
Reference in New Issue
Block a user