Skip to content

oigarash/docker-sphinx-rtd-theme

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sphinx documentation with Docker

Quickstart

To start suttang/sphinx-rtd-theme, You can use sphinx-quickstart

http://docs.readthedocs.io/en/latest/getting_started.html

docker run --rm -it -v $(pwd)/documents:/documents suttang/sphinx-rtd-theme sphinx-quickstart
docker run --rm -it -v $(pwd)/documents:/documents suttang/sphinx-rtd-theme sphinx-quickstart -q -p "YourProjectName" -a "suttang <suttang@gmail.com>" -v 1.0.0 --sep --no-batchfile

Build your documents

The default CMD of suttang/sphinx-rtd-theme is make html.

docker run --rm -it -v $(pwd)/documents:/documents suttang/sphinx-rtd-theme

Your can use your favorite build commands.

# make html
docker run --rm -it -v $(pwd)/documents:/documents suttang/sphinx-rtd-theme make html

# sphinx-build
docker run --rm -it -v $(pwd)/documents:/documents suttang/sphinx-rtd-theme sphinx-build -b html source build

This dockerfile include sphinx-autobuild

# use autobuild with make
docker run --rm -it -v $(pwd)/documents:/documents -p 8000:8000 suttang/sphinx-rtd-theme make livehtml

# use autobuild with sphinx-autobuild
docker run --rm -it -v $(pwd)/documents:/documents -p 8000:8000 suttang/sphinx-rtd-theme sphinx-autobuild -b html $SOURCE $OUTPUT -H 0.0.0.0

Build dockerfile

docker build -t "suttang/sphinx-rtd-theme" .

Thank you.

About

Sphinx documentation with RTD theme in Alpine docker container.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 57.6%
  • Python 30.3%
  • Dockerfile 10.0%
  • Shell 2.1%