Skip to content

Commit

Permalink
DOC: Create objects.inv
Browse files Browse the repository at this point in the history
  • Loading branch information
has2k1 committed Feb 23, 2024
1 parent e73947b commit 9280c8c
Show file tree
Hide file tree
Showing 4 changed files with 25 additions and 22 deletions.
20 changes: 0 additions & 20 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -71,10 +71,6 @@ examples/.ipynb_checkpoints
# Django stuff
*.log

# Sphinx documentation
doc/_build/
doc/generated/

# PyBuilder
target/

Expand All @@ -89,19 +85,3 @@ benchmarks

# version file generated by setuptools-scm
plotnine/_version.py


# Documentation
doc/examples
doc/reference/
doc/_site/
doc/_inv/
doc/_extensions/
doc/.quarto/
doc/gallery/thumbnails
doc/objects.json
doc/objects.txt
doc/.luarc.json
doc/_environment
doc/_variables.yml
doc/site_libs
15 changes: 14 additions & 1 deletion doc/.gitignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,15 @@
/.quarto/
.quarto/
_extensions/
_site/
site_libs/
_environment
_variables.yml

# quartodoc
_inv/
reference/
qrenderer.scss
objects.json
objects.txt
objects.inv
gallery/thumbnails
10 changes: 10 additions & 0 deletions doc/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,13 @@ for line in sys.stdin:
endef
export PRINT_HELP_PYSCRIPT

define CREATE_OBJECTS_INV
import sphobjinv as soi
inv = soi.Inventory(source="objects.txt")
soi.writebytes("objects.inv", soi.compress(inv.data_file()))
endef
export CREATE_OBJECTS_INV

QRENDERER_STYLE_FILE=qrenderer.scss
QRENDERER_STYLE_URL=https://raw.githubusercontent.com/has2k1/qrenderer/main/doc/qrenderer.scss

Expand All @@ -27,6 +34,8 @@ clean: ## Remove build artefacts
rm -rf reference/
rm -rf _site/
rm -rf _inv/
rm -f objects.txt
rm -f objects.inv

readme-images:
cd images; python readme_images.py
Expand All @@ -49,6 +58,7 @@ config: ## Configure project for quartodoc and quarto

docstrings: config ## Generate qmd files from the docstrings
quartodoc build --config _quartodoc.yml
@python -c "$$CREATE_OBJECTS_INV"

html: docstrings download_qrenderer_style ## Build html site
quarto render
Expand Down
2 changes: 1 addition & 1 deletion doc/_quarto.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
project:
type: website
resources:
- objects.txt
- objects.inv
render:
- "reference/**.qmd"
- "*.qmd"
Expand Down

0 comments on commit 9280c8c

Please sign in to comment.