Sign inSign up

cl3m3nt/sphinx

By cl3m3nt

•Updated over 8 years ago

Sphinx is a tool that makes it easy to create intelligent and beautiful documentation

Image
0

562

cl3m3nt/sphinx repository overview

⁠Sphinx alpine

Docker Automated buil Docker Build Statu Docker Pulls

Info :

Require :

⁠How to start

Generate base project

docker run -it -v ${PWD}/example/mydocs:/root/docs cl3m3nt/sphinx

Answer the questions...

> Root path for the documentation [.]:
> Separate source and build directories (y/n) [n]: y
> Name prefix for templates and static dir [_]:
> Project name: Test_project
> Author name(s): Cl3m3nt
> Project version: 0.1
> Project release [0.1]:
> Project language [en]:

....

My project base sphinx

user@computer - ~/example/mydocs > tree
├── Makefile
├── build
├── make.bat
└── source
    ├── _static
    ├── _templates
    ├── conf.py
    └── index.rst

4 directories, 4 files

⁠Make docs

Add file .rest to source

example/mydocs/source
├── _static
├── _templates
├── conf.py
├── index.rst
└── test.rst

Exemple for html..

user@computer - ~/example/mydocs > docker run -it -v ${PWD}/example/mydocs:/root/docs cl3m3nt/sphinx make html
Running Sphinx v1.5.5
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 1 source files that are out of date
updating environment: 0 added, 1 changed, 0 removed
reading sources... [100%] test
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] test
generating indices... genindex
writing additional pages... search
copying static files... done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded.

Build finished. The HTML pages are in build/html.
⁠Other build
TypeDescription
htmlto make standalone HTML files
dirhtmlto make HTML files named index.html in directories
singlehtmlto make a single large HTML file
pickleto make pickle files
jsonto make JSON files
htmlhelpto make HTML files and an HTML help project
qthelpto make HTML files and a qthelp project
devhelpto make HTML files and a Devhelp project
epubto make an epub
latexto make LaTeX files, you can set PAPER=a4 or PAPER=letter
latexpdfto make LaTeX and PDF files (default pdflatex)
latexpdfjato make LaTeX files and run them through platex/dvipdfmx
textto make text files
manto make manual pages
texinfoto make Texinfo files
infoto make Texinfo files and run them through makeinfo
gettextto make PO message catalogs
changesto make an overview of all changed/added/deprecated items
xmlto make Docutils-native XML files
pseudoxmlto make pseudoxml-XML files for display purposes
linkcheckto check all external links for integrity
doctestto run all doctests embedded in the documentation (if enabled)
coverageto run coverage check of the documentation (if enabled)

⁠Env variables

⁠Sphinx-quickstart default value

Namedefault valueDescription
_SPHINX_DEFAULT_THEMEalabasterdefault theme

⁠Rewrite Sphinx-quickstart default value

Namedefault valueDescription
SPHINX_DEFAULT_THEMEsphinx_rtd_themedefault theme

Tag summary

Content type

Image

Digest

Size

47.4 MB

Last updated

over 8 years ago

docker pull cl3m3nt/sphinx