Files
zigstar_gateways/documentation
2023-04-12 21:45:04 +01:00
..
2023-04-12 21:45:04 +01:00
2023-04-12 15:43:06 +01:00
2023-04-12 15:43:06 +01:00
2023-04-12 15:43:06 +01:00
2023-04-12 16:42:20 +01:00
2023-04-12 21:41:35 +01:00

ZigStar Gateways - Documentation

This subfolder contains the zig-star.com documentation. It is based on Mkdocs & Material for MkDocs

You are very welcome to help on improving documentation.

Directory-Structure

  • docs: The actual documentation.
  • overrides: MkDocs enhancements.
  • mkdocs.yaml: MkDocs config file
  • init_setup.sh: Prepare venv enviroment
  • requirements.txt: Mkdocs requirements

Mkdocs installation

# Install MkDocs dependencies Linux
bash init_setup.sh

Manual installation:

# Install MkDocs dependencies Windows
python3 -m venv venv
. venv/Scripts/activate
pip install mkdocs-material

Live preview of changes

From documentation folder run next commands:

# Enter in virtual enviroment
. venv/bin/activate ##For Linux
. venv/Scripts/activate  ## For windows
# Run mkdocs serve command to generate live preview
mkdocs serve

Requirements:

  • Python 3.8+
  • pip