dcdbd7bca6
docs: Add GitHub Wiki and Pages setup automation
...
Add comprehensive documentation publishing infrastructure with two deployment
options: GitHub Wiki (quick) and GitHub Pages (professional).
## New Files
### Setup Scripts
- **scripts/setup-wiki.sh** - Automated GitHub Wiki deployment
* Clones wiki repository
* Creates Home page with navigation
* Creates sidebar (_Sidebar.md)
* Copies all DOCS/ files
* Fixes internal links for wiki format
* Auto-commits and pushes
- **scripts/setup-github-pages.sh** - GitHub Pages with MkDocs Material
* Checks/installs dependencies (Python, MkDocs)
* Creates mkdocs.yml configuration
* Generates docs/ directory structure
* Creates professional home page with cards
* Copies and transforms all DOCS/ files
* Adds custom CSS matching SecuBox design
* Builds preview site
* Ready for GitHub Pages deployment
### Documentation
- **WIKI-SETUP-GUIDE.md** - Complete setup guide
* Comparison of Wiki vs GitHub Pages
* Step-by-step instructions for both options
* Customization guides
* Troubleshooting section
* CI/CD automation examples
- **scripts/README.md** - Scripts documentation
* Quick start for both options
* Feature comparison
* Update procedures
* Troubleshooting
## Features
### GitHub Wiki Option
✅ 2-minute setup
✅ No dependencies (Git only)
✅ Auto-sync from DOCS/
✅ Sidebar navigation
✅ Archive organization
✅ Link fixing automation
### GitHub Pages Option (Recommended)
✅ MkDocs Material theme
✅ Dark/Light mode support
✅ Professional navigation (tabs + sidebar)
✅ Search functionality
✅ Mermaid diagram support
✅ Mobile responsive
✅ Custom domain support
✅ SEO optimized
✅ Custom CSS matching SecuBox design
✅ Archive section
## Deployment Options
**Quick (Wiki):**
```bash
./scripts/setup-wiki.sh
# → https://github.com/gkerma/secubox-openwrt/wiki
```
**Professional (Pages):**
```bash
./scripts/setup-github-pages.sh
mkdocs serve # Test locally
# → https://gkerma.github.io/secubox-openwrt/
```
## Benefits
✅ One-command documentation publishing
✅ Two deployment options (quick vs professional)
✅ Automated link fixing for both formats
✅ Complete documentation coverage
✅ Professional appearance (Pages option)
✅ Easy updates (re-run script)
✅ CI/CD ready
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-28 10:00:05 +01:00
