Files

T

Publish Docs Site / build (push) Failing after 5s

Details

feat: initial itpp-docs setup with MkDocs Material

- mkdocs.yml with dark slate theme, nav for 12 ITPP projects
- build-docs.sh aggregates docs from all project repos
- .gitea/workflows/docs-publish.yml for nightly rebuild+deploy
- README and CHANGELOG for the itpp-docs repo itself
- docs-source/ populated from all 12 repos
- site/ ready for deployment to docs.itpropartner.com

2026-08-09 23:49:45 -04:00

1.4 KiB

Raw Permalink Blame History

ITPP Docs

Owner: Germaine | Status: LIVE Last Updated: 2026-08-09

Aggregated MkDocs documentation site for all IT Pro Partner projects. Pulls READMEs, CHANGELOGs, and docs/ directories from every project repo and builds a unified Material-for-MkDocs site served at docs.itpropartner.com.

How It Works

build-docs.sh clones/fetches every project repo listed in REPOS
Copies each repo's docs/, README.md, and CHANGELOG.md into docs-source/<project>/
mkdocs build renders the entire site to site/
Gitea Actions (nightly) or manual rsync deploys to app3

Tech Stack

Site generator: MkDocs + Material for MkDocs theme
CI/CD: Gitea Actions (.gitea/workflows/docs-publish.yml)
Hosting: Nginx on app3 (152.53.241.111)

Quick Start

git clone https://git.itpropartner.com/ippadmin/itpp-docs.git
cd itpp-docs
pip install mkdocs mkdocs-material
bash build-docs.sh
mkdocs serve

Deploy

# Manual deploy
bash build-docs.sh && mkdocs build && rsync -avz site/ root@152.53.241.111:/home/ippadmin/htdocs/docs.itpropartner.com/

# Or push to main — Gitea Actions handles rebuild + deploy nightly

itpp-infrastructure — server inventory, DNS
itpp-standards — docs standards and templates

1.4 KiB Raw Permalink Blame History