.\" Man page generated from reStructuredText.
.
.TH "SPHINX-BUILD" "1" "Dec 27, 2016" "1.4.9" "Sphinx"
.SH NAME
sphinx-build \- Sphinx documentation generator tool
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBsphinx\-build\fP [\fIoptions\fP] <\fIsourcedir\fP> <\fIoutdir\fP> [\fIfilenames\fP ...]
.SH DESCRIPTION
.sp
\fBsphinx\-build\fP generates documentation from the files in
\fB<sourcedir>\fP and places it in the \fB<outdir>\fP\&.
.sp
\fBsphinx\-build\fP looks for \fB<sourcedir>/conf.py\fP for the configuration
settings.  \fBsphinx\-quickstart(1)\fP may be used to generate template
files, including \fBconf.py\fP\&.
.sp
\fBsphinx\-build\fP can create documentation in different formats.  A format
is selected by specifying the builder name on the command line; it defaults to
HTML.  Builders can also perform other tasks related to documentation
processing.
.sp
By default, everything that is outdated is built.  Output only for selected
files can be built by specifying individual filenames.
.sp
List of available builders:
.INDENT 0.0
.TP
.B html
HTML file generation.  This is the default builder.
.TP
.B dirhtml
HTML file generation with every HTML file named "index.html" in a separate
directory.
.TP
.B singlehtml
HTML file generation with all content in a single HTML file.
.TP
.B htmlhelp
Generates files for CHM (compiled help files) generation.
.TP
.B qthelp
Generates files for Qt help collection generation.
.TP
.B devhelp
Generates files for the GNOME Devhelp help viewer.
.TP
.B latex
Generates LaTeX output that can be compiled to a PDF document.
.TP
.B man
Generates manual pages.
.TP
.B texinfo
Generates Texinfo output that can be processed by \fBmakeinfo\fP to
generate an Info document.
.TP
.B epub
Generates an ePub e\-book version of the HTML output.
.TP
.B text
Generates a plain\-text version of the documentation.
.TP
.B gettext
Generates Gettext message catalogs for content translation.
.TP
.B changes
Generates HTML files listing changed/added/deprecated items for
the current version of the documented project.
.TP
.B linkcheck
Checks the integrity of all external links in the source.
.TP
.B pickle / json
Generates serialized HTML files for use in web applications.
.TP
.B xml
Generates Docutils\-native XML files.
.TP
.B pseudoxml
Generates compact pretty\-printed "pseudo\-XML" files displaying the
internal structure of the intermediate document trees.
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-b \ <builder>
Builder to use; defaults to html. See the full list
of builders above.
.TP
.B \-a
Generate output for all files; without this option only
output for new and changed files is generated.
.TP
.B \-E
Ignore cached files, forces to re\-read all source files
from disk.
.TP
.BI \-d \ <path>
Path to cached files; defaults to <outdir>/.doctrees.
.TP
.BI \-j \ <N>
Build in parallel with N processes where possible.
.TP
.BI \-c \ <path>
Locate the conf.py file in the specified path instead of
<sourcedir>.
.TP
.B \-C
Specify that no conf.py file at all is to be used.
Configuration can only be set with the \-D option.
.TP
.BI \-D \ <setting=value>
Override a setting from the configuration file.
.TP
.BI \-t \ <tag>
Define \fItag\fP for use in "only" blocks.
.TP
.BI \-A \ <name=value>
Pass a value into the HTML templates (only for HTML
builders).
.TP
.B \-n
Run in nit\-picky mode, warn about all missing references.
.TP
.B \-v
Increase verbosity (can be repeated).
.TP
.B \-N
Prevent colored output.
.TP
.B \-q
Quiet operation, just print warnings and errors on stderr.
.TP
.B \-Q
Very quiet operation, don\(aqt print anything except for
errors.
.TP
.BI \-w \ <file>
Write warnings and errors into the given file, in addition
to stderr.
.TP
.B \-W
Turn warnings into errors.
.TP
.B \-T
Show full traceback on exception.
.TP
.B \-P
Run Pdb on exception.
.UNINDENT
.SH SEE ALSO
.sp
\fBsphinx\-quickstart(1)\fP
.SH AUTHOR
.sp
Georg Brandl <\fI\%georg@python.org\fP>, Armin Ronacher <\fI\%armin.ronacher@active\-4.com\fP> et
al.
.sp
This manual page was initially written by Mikhail Gusarov
<\fI\%dottedmag@dottedmag.net\fP>, for the Debian project.
.SH COPYRIGHT
2007-2016, Georg Brandl and the Sphinx team
.\" Generated by docutils manpage writer.
.