youen
/
sphinx-web
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Python web app to publish documentation compiled using Sphinx
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.
34 Commits
1 Branch
0 Tags
898 KiB
 
 
 
 
 
 
Tree: 914c5c43f9
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '914c5c43f9'
${ noResults }
Youen 914c5c43f9
Fixed issue where task resources were not freed in case of error during the task 		10 months ago
src Fixed issue where task resources were not freed in case of error during the task 10 months ago
.gitignore implemented authentication to access admin pages 2 years ago
LICENSE Initial commit 2 years ago
README.md Added instructions to run the application in production 2 years ago
debug.sh refactored configuration system 2 years ago
debug_config.py refactored configuration system 2 years ago
pdftoc-to-latex Added code to generate PDF 2 years ago
requirements.txt Added modules for PDF compilation 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