Skip to content

map5nl/map5topo.nl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

map5topo.nl website

The files and dirs below contain the map5topo website/docs source.

The documentation is powered by MkDocs which facilitates easy management of content and publishing. Content is written in Markdown.

Using GitHub Workflows the website is automatically rebuilt and deployed (to the gh-pages branch on GitHub) on commit/pushes to the main branch. The site is hosted as a static html website on GitHub using GitHub Pages.

Build/test locally

# build a virtual Python environment in isolation
# For example, or use pyenv.
python3 -m venv .
. bin/activate

# fork or clone from GitHub
git clone https://github.com/map5/map5topo.nl.git
cd docs

# install required dependencies

# Optional: install lxml quickly using package
apt-get install -y python3-lxml

# install Python libs 
pip install -r requirements.txt

# build the website
mkdocs build

# serve locally
mkdocs serve  # website is made available on http://localhost:8000
 
# or locally on specific port
mkdocs serve -a localhost:8001

Deploying to live site

Website updates are automatically published via GitHub Actions.

Or to publish manually, but basically not needed:

# NOTE: you require access privileges to the GitHub repository
# to publish live updates
mkdocs gh-deploy -m 'add new page on topic x'