feat: initialize Grav multi-site project
- Add AGENTS.md with project requirements and site inventory
- Add JOURNAL.md for project tracking
- Add etc-hosts-entries.txt for local testing (22 domains)
- Add setup.php for Grav multi-site routing configuration
This project migrates 21 mdbook sites to a single Grav multi-site
installation. Each site will have its own environment directory under
user/env/{fqdn}/ with independent config, pages, and themes.
Development runs in Docker on port 12000 (container: tsysstatic-dev-grav).
Production target: Cloudron Grav app at staticsites.turnsys.com.
🤖 Generated with [Crush](https://crush.cbhops.com)
Assisted-by: GLM-5 via Crush <crush@charm.land>
This commit is contained in:
55
AGENTS.md
Normal file
55
AGENTS.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# TSYS Static Sites - Grav Multi-Site Project
|
||||
|
||||
## Requirements
|
||||
|
||||
### Infrastructure
|
||||
- Grav CMS multi-site installation for hosting static content
|
||||
- Currently migrating from mdbook-based sites
|
||||
- Target production: Cloudron LAMP app at staticsites.turnsys.com
|
||||
- Development: Docker container on port 12000, named with prefix `tsysstatic-dev-`
|
||||
|
||||
### Source Content
|
||||
- 21 mdbook repositories in `/home/charles/Projects/tsysstatic/`
|
||||
- Directory name = FQDN for the site
|
||||
- All sites use standard mdbook structure (book.toml, src/, SUMMARY.md)
|
||||
|
||||
### Multi-Site Strategy
|
||||
- Single Grav installation hosting multiple domains
|
||||
- Each site can have its own git repository for content (per-site repos preferred)
|
||||
- Use Grav's environment-based multi-site feature (user/env/{fqdn}/)
|
||||
- Domain-based routing via setup.php
|
||||
|
||||
### Sites to Migrate
|
||||
1. governance.turnsys.com (substantial content - governance docs)
|
||||
2. plan.ap4ap.org
|
||||
3. plan.ezeda.org
|
||||
4. plan.afabn.org
|
||||
5. plan.ezpodstack.org
|
||||
6. plan.hfnoc.net
|
||||
7. plan.knownelement.com (substantial content - KNEL docs)
|
||||
8. plan.meetmorse.com
|
||||
9. plan.merchantsofhope.org
|
||||
10. plan.rackrental.net
|
||||
11. plan.redwfo.com
|
||||
12. plan.rwscp.net
|
||||
13. plan.sidedoorgroup.org
|
||||
14. plan.sol-calc.com
|
||||
15. plan.suborbital-systems.com (has chapter content)
|
||||
16. plan.teamrental.net
|
||||
17. plan.thecampustradingcompany.com
|
||||
18. plan.thepeernet.com
|
||||
19. plan.turnsys.com
|
||||
20. plan.yourdreamnamehere.com
|
||||
21. startinglineproductions.com-bizopprodplan (substantial content - STLP plans)
|
||||
|
||||
### Development Workflow
|
||||
1. Local Docker container for development/testing
|
||||
2. /etc/hosts entries for local domain testing
|
||||
3. Git repository for Grav configuration and content
|
||||
4. Sync to Cloudron Grav instance for production
|
||||
|
||||
### Technical Constraints
|
||||
- Use only: docker, git, and unix utilities on host
|
||||
- No AI/ML tools or language servers for file manipulation
|
||||
- Container naming: `tsysstatic-dev-*` prefix
|
||||
- Port: 12000
|
||||
Reference in New Issue
Block a user