python-docs-theme/Makefile at 2026.7 · python/python-docs-theme · GitHub

Repository navigation

# You can set these variables from the command line.

CPYTHON_PATH = ../cpython

PYTHON = python3

SPHINXOPTS =

.PHONY: help

help:

@echo "Please use \`make <target>' where <target> is one of"

@echo " venv to create a venv with necessary tools at $(CPYTHON_PATH)/Doc/venv"

@echo " html to make standalone CPython HTML files"

@echo " htmlview to open the index page built by the html target in your browser"

.PHONY: venv

venv:

$(PYTHON) -m pip install build

rm -rf dist/

$(PYTHON) -m build

cd $(CPYTHON_PATH)/Doc \

&& make venv \

&& ./venv/bin/pip install $(CURDIR)/dist/python_docs_theme-*.tar.gz

.PHONY: html

html: venv

cd $(CPYTHON_PATH)/Doc && \

make SPHINXOPTS="$(SPHINXOPTS)" html

.PHONY: htmlview

htmlview: html

$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('$(CPYTHON_PATH)/Doc/build/html/index.html'))"