vdoc
Multi version documentation hosting.
Basic usage
Run vdoc with python
pip install vdoc
vdoc run
Run vdoc with docker
docker run -p 8080:8080 -v ./vdoc-docs:/srv/vdoc/docs/ voraus.jfrog.io/docker/vdoc:latest
Building vdoc
# Prepare development environment
npm ci
python -m venv venv
source venv/bin/activate
pip install --upgrade pip tox
# Build UI
npm run build
# Build docs
tox run -e docs
# Build python package
tox run -e build
# Build local docker image
docker build -t vdoc:latest .
Configuration
vdoc can be configured via environment variables. Internally, it uses
pydantic-settings for building the configuration.
All configuration environment variables are prefixed with VDOC_
:
Table 1 VDoc Configuration
Environment variable |
Explanation |
Default |
Example |
VDOC_DOCS_DIR
|
The directory to which all project documentations will be uploaded. |
/srv/vdoc/docs/
|
/path/to/your/docs/`
|
VDOC_API_USERNAME
|
The username required for uploading documentations via the API. |
admin
|
Something more secure
|
VDOC_API_PASSWORD
|
The password required for uploading documentations via the API. |
admin
|
sup3r_s3cr3t
|
VDOC_BIND_ADDRESS
|
The application bind address. |
0.0.0.0
|
127.0.0.1
|
VDOC_BIND_PORT
|
The application bind port. |
8080
|
1337
|
VDOC_LOGO_LIGHT_URL
|
The URL to the light logo. |
https://logos.vorausrobotik.com/v_rgb.png
|
https://example.com/light-mode-logo.png
|
VDOC_LOGO_DARK_URL
|
The URL to the dark logo. |
https://logos.vorausrobotik.com/v_rgb.png
|
https://example.com/dark-mode-logo.png
|
VDOC_PROJECT_DISPLAY_NAME_MAPPING
|
An optional mapping (dictionary) of project names to display names. |
{}
|
{"project-01": "Project Name", "project-02": "Another Project Name"}
|
VDOC_PROJECT_CATEGORIES
|
An optional list of project categories. |
[]
|
[{"name": "Category 1", "id": "0"}]
|
VDOC_PROJECT_CATEGORY_MAPPING
|
An optional list of of project mappings. |
{}
|
{"project-01": "Category 1"}
|