| SPHINX-QUICKSTART(1) | Sphinx | SPHINX-QUICKSTART(1) | 
NAME¶
sphinx-quickstart - Sphinx documentation template generator
SYNOPSIS¶
sphinx-quickstart
DESCRIPTION¶
sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build(1).
OPTIONS¶
- -q, --quiet
 - Quiet mode that skips the interactive wizard for specifying options. This option requires -p, -a and -v options.
 
- -h, --help, --version
 - Display usage summary or Sphinx version.
 
Structure Options
- --sep
 - If specified, separate source and build directories.
 
- --no-sep
 - If specified, create build directroy under source directroy.
 
- --dot=DOT
 - Inside the root directory, two more directories will be created; “_templates” for custom HTML templates and “_static” for custom stylesheets and other static files. You can enter another prefix (such as “.”) to replace the underscore.
 
Project Basic Options
- -p PROJECT, --project=PROJECT
 - Project name will be set. (see project).
 
- -a AUTHOR, --author=AUTHOR
 - Author names. (see copyright).
 
- -v VERSION
 - Version of project. (see version).
 
- -r RELEASE, --release=RELEASE
 - Release of project. (see release).
 
- -l LANGUAGE, --language=LANGUAGE
 - Document language. (see language).
 
- --suffix=SUFFIX
 - Source file suffix. (see source_suffix).
 
- --master=MASTER
 - Master document name. (see master_doc).
 
Extension Options
- --ext-autodoc
 - Enable sphinx.ext.autodoc extension.
 
- --ext-doctest
 - Enable sphinx.ext.doctest extension.
 
- --ext-intersphinx
 - Enable sphinx.ext.intersphinx extension.
 
- --ext-todo
 - Enable sphinx.ext.todo extension.
 
- --ext-coverage
 - Enable sphinx.ext.coverage extension.
 
- --ext-imgmath
 - Enable sphinx.ext.imgmath extension.
 
- --ext-mathjax
 - Enable sphinx.ext.mathjax extension.
 
- --ext-ifconfig
 - Enable sphinx.ext.ifconfig extension.
 
- --ext-viewcode
 - Enable sphinx.ext.viewcode extension.
 
- --ext-githubpages
 - Enable sphinx.ext.githubpages extension.
 
- --extensions=EXTENSIONS
 - Enable arbitrary extensions.
 
Makefile and Batchfile Creation Options
- --use-make-mode (-m), --no-use-make-mode (-M)
 - Makefile/make.bat uses (or doesn’t use) make-mode. Default
      is use, which generates a more concise Makefile/make.bat.
    
Changed in version 1.5: make-mode is default.
 
- --makefile, --no-makefile
 - Create (or not create) makefile.
 
- --batchfile, --no-batchfile
 - Create (or not create) batchfile
 
Project templating
New in version 1.5: Project templating options for sphinx-quickstart
- -t, --templatedir=TEMPLATEDIR
 - Template directory for template files. You can modify the templates of sphinx project files generated by quickstart. Following Jinja2 template files are allowed:
 
- master_doc.rst_t
 - conf.py_t
 - Makefile_t
 - Makefile.new_t
 - make.bat_t
 - make.bat.new_t
 
In detail, please refer the system template files Sphinx provides. (sphinx/templates/quickstart)
- -d NAME=VALUE
 - Define a template variable
 
SEE ALSO¶
COPYRIGHT¶
2007-2023, Georg Brandl and the Sphinx team
| November 21, 2023 | 3.4.3 |