sphinx-autobuild - Man Page

manual page for sphinx-autobuild 2024.02.04

Description

usage: sphinx-autobuild [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]

positional arguments

sourcedir

path to documentation source files

outputdir

path to output directory

filenames

a list of specific files to rebuild. Ignored if -a is specified

options

-h, ā€‰--help

show this help message and exit

--version

show program's version number and exit

general options

-b BUILDER

builder to use (default: html)

-a

write all files (default: only write new and changed files)

-E

don't use a saved environment, always read all files

-d PATH

path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)

-j N, --jobs N

build in parallel with N processes where possible (special value "auto" will set N to cpu-count)

build configuration options

-c PATH

path where configuration file (conf.py) is located (default: same as SOURCEDIR)

-C

use no config file at all, only -D options

-D setting=value

override a setting in configuration file

-A name=value

pass a value into HTML templates

-t TAG

define tag: include "only" blocks with TAG

-n

nit-picky mode, warn about all missing references

console output options

-v

increase verbosity (can be repeated)

-q

no output on stdout, just warnings on stderr

-Q

no output at all, not even warnings

--color

do emit colored output (default: auto-detect)

-N, ā€‰--no-color

do not emit colored output (default: auto-detect)

-w FILE

write warnings (and errors) to given file

-W

turn warnings into errors

--keep-going

with -W, keep going when getting warnings

-T

show full traceback on exception

-P

run Pdb on exception

autobuild options

--port PORT

port to serve documentation on. 0 means find and use a free port

--host HOST

hostname to serve documentation on

--re-ignore RE_IGNORE

regular expression for files to ignore, when watching for changes

--ignore IGNORE

glob expression for files to ignore, when watching for changes

--no-initial

skip the initial build

--open-browser

open the browser after building documentation

--delay DELAY

how long to wait before opening the browser

--watch DIR

additional directories to watch

--pre-build COMMAND

additional command(s) to run prior to building the documentation

Info

February 2024 sphinx-autobuild 2024.02.04