Quick setup utility for sphinx
Project description
sphinx-express
Install
$ git clone https://github.com/iisaka51/sphinx-express.git
$ cd sphinx-express
$ python setup.py install
Setup
$ sphinx-express --setup
You should install follows packages.
python -m pip install sphinx-rtd-theme sphinx-charts pallets_sphinx_themes sphinxcontrib-runcmd sphinxcontrib-napoleon
your configfile: /Users/goichiiisaka/.sphinx/quickstartrc
your templatedir: /Users/goichiiisaka/.sphinx/templates/quickstart
quickstart templates of sphinx into your templatedir.
Here is default quickstartrc.
sep: true
language: ja
suffix: .rst
master: index
makefile: true
batchfile: true
autodoc: true
doctest: false
intersphinx: false
todo: false
coverage: false
imgmath: true
mathjax: true
ifconfig: true
viewcode: true
project: sample
version: 0.0.1
release: 0.0.1
lang: ja
make_mode: true
ext_mathjax: true
extensions:
- pallets_sphinx_themes
- sphinx_rtd_theme
- sphinx.ext.autodoc
- sphinx.ext.mathjax
- sphinx.ext.autosectionlabel
- sphinxcontrib.blockdiag
- sphinxcontrib.seqdiag
- sphinxcontrib.blockdiag
- sphinxcontrib.nwdiag
- sphinxcontrib.rackdiag
- sphinxcontrib.httpdomain
- sphinxcontrib.runcmd
- recommonmark
mastertocmaxdepth: 2
project_underline: ======
You can change above settings. and run sphinx-express again.
$ sphinx-express sample
Welcome to the Sphinx 3.2.1 quickstart utility.
Please enter values for the following settings (just press Enter to
accept a default value, if one is given in brackets).
Selected root path: sample
Creating file /Users/goichiiisaka/docs/sample/source/conf.py.
Creating file /Users/goichiiisaka/docs/sample/source/index.rst.
Creating file /Users/goichiiisaka/docs/sample/Makefile.
Creating file /Users/goichiiisaka/docs/sample/make.bat.
Finished: An initial directory structure has been created.
You should now populate your master file /Users/goichiiisaka/docs/sample/source/index.rst and create other documentation
source files. Use the Makefile to build the docs, like so:
make builder
where "builder" is one of the supported builders, e.g. html, latex or linkcheck.
Usage:
$ sphinx-express --help
Usage: sphinx-express [OPTIONS] PROJECT_DIR
Create required files for a Sphinx project.
Arguments:
PROJECT_DIR [required]
Options:
-p, --project PROJECT_NAME project name. default is basename of
PROJECT_DIR.
-a, --author AUTHOR_NAME author name. default is "goichiiisaka"
[default: goichiiisaka]
-v, --ver VERSION version of project. [default: 0.0.1]
-l, --lang LANG document language. [default: ja]
-t, --templatedir TEMPLATE_DIR template directory for template files.
[default: /Users/goichiiisaka/.sphinx/templa
tes/quickstart]
-d, --define NAE=VALUE define a template variable.
-c, --configfile CONFIG_FILEPATH
sphinx-express configfile. [default:
/Users/goichiiisaka/.sphinx/quickstartrc]
-N, --new Ignore least configures. [default: False]
--setup Copy templates and exit. [default: False]
--version Show version and exit. [default: False]
--help Show this message and exit.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sphinx-express-0.2.4.tar.gz
(9.4 kB
view hashes)
Built Distribution
Close
Hashes for sphinx_express-0.2.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c5e65f72ce4d66f959a450d07703901108ba242cc8e8b101c9a8dd19f83f6642 |
|
MD5 | b9272a23a09db38ff5640f35eef64555 |
|
BLAKE2b-256 | b6ed4dd1c11d1f89303bddc90744b6cd956f7331db4a38b4be9ba40bc28a7cd8 |