You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Youen
bac8e34245
|
9 months ago | |
---|---|---|
src | 9 months ago | |
.gitignore | 2 years ago | |
LICENSE | 2 years ago | |
README.md | 2 years ago | |
debug.sh | 2 years ago | |
debug_config.py | 2 years ago | |
pdftoc-to-latex | 2 years ago | |
requirements.txt | 2 years ago |
README.md
Python web app to publish documentation compiled using Sphinx
Installation
cd sphinx-web
python3 -m venv venv
source venv/bin/activate # on Windows execute instead: venv\Scripts\activate.bat
pip install -U pip setuptools wheel
pip install -r requirements.txt
Executing in a producton environment
cd sphinx-web
source venv/bin/activate
pip install waitress
Create your configuration file, for example /etc/sphinx-web/config.py
:
ADMIN_PASSWORD = 'specify a strong password here'
BEHIND_REVERSE_PROXY = False # Set to True if you use a reverse proxy such as nginx
Start the application:
cd sphinx-web/src
source ../venv/bin/activate
CONFIG_PATH=/etc/sphinx-web/config.py waitress-serve --port 8080 --call "app:create_app"
Development
Update dependencies
After activating the virtual environment, run this command to update the list of dependencies with what is currently installed:
pip freeze > requirements.txt