Deploy: Complete TekDek documentation website with all content pages, CSS, and infrastructure

publish/web1/README.md

@@ -0,0 +1,76 @@
+# TekDek Documentation Site — PHP Framework
+
+Built by **Talos** (Technical Coder, TekDek).
+
+## Structure
+
+```
+public/
+├── index.php          — Main router (all requests)
+├── config.php         — Menu structure, site settings, content mapping
+├── .htaccess          — Apache URL rewriting
+├── includes/
+│   ├── top.php        — HTML head, header, navigation
+│   ├── bottom.php     — Footer, closing tags
+│   ├── menu.php       — Navigation renderer (config-driven)
+│   └── functions.php  — Markdown renderer, utilities
+├── pages/
+│   ├── home.php       — Landing page with card grid
+│   ├── about.php      — Vision & Strategy
+│   ├── projects.php   — Active projects
+│   ├── tools.php      — Tools & Tech stack
+│   ├── team.php       — Links to team.html
+│   ├── decisions.php  — Decision checklist
+│   └── 404.php        — Error page
+├── css/
+│   ├── base.css       — Colors, typography, resets
+│   ├── components.css — Header, nav, cards, buttons, footer
+│   └── responsive.css — Mobile/tablet breakpoints
+├── js/
+│   └── main.js        — Mobile menu toggle
+├── content/           — Drop .md files here for auto-rendering
+└── assets/            — Images, icons
+```
+
+## Setup
+
+1. Point Apache/Nginx document root to `public/`
+2. Ensure `mod_rewrite` is enabled (Apache)
+3. Adjust `SITE_BASE_URL` in `config.php` if not at root
+
+### Nginx Alternative
+
+```nginx
+location / {
+    try_files $uri $uri/ /index.php?$query_string;
+}
+```
+
+## How It Works
+
+- **Routing**: All URLs go through `index.php` → matches slug against `$MENU` in `config.php` → loads `pages/{slug}.php`
+- **Content**: Pages can embed HTML directly or call `load_content('slug')` to render a markdown file from `content/`
+- **Navigation**: Rendered automatically from `$MENU` config — add/remove pages by editing one array
+- **Markdown**: Built-in renderer (no Composer, no dependencies) — supports headings, lists, code blocks, links, images, bold, italic, blockquotes
+- **404**: Unknown slugs get a clean 404 page
+
+## Adding a Page
+
+1. Add entry to `$MENU` in `config.php`
+2. Optionally add content mapping in `$CONTENT_MAP`
+3. Create `pages/{slug}.php` (or just drop a `.md` file in `content/`)
+
+## For Icarus (CSS)
+
+The CSS files are ready for customization:
+- `base.css` — CSS variables at `:root`, override colors/fonts here
+- `components.css` — All component styles, well-commented
+- `responsive.css` — Breakpoints at 768px and 480px
+
+Dark theme variables are already set. The framework uses semantic class names throughout.
+
+## Requirements
+
+- PHP 7.4+
+- Apache with mod_rewrite (or Nginx with try_files)
+- No Composer, no external dependencies