Initial commit: Espilon documentation

- Complete MkDocs documentation structure
- Docker multi-stage build (Python build + Nginx serve)
- Docker Compose configuration for VPS deployment
- GitHub Actions CI/CD workflow
- Material theme with dark/light mode
- Multi-language search support

Author: Eun0us

.dockerignore

@@ -0,0 +1,10 @@
+venv/
+.venv/
+__pycache__/
+*.pyc
+.git/
+.github/
+site/
+.DS_Store
+*.log
+.env

.github/workflows/docs.yml

@@ -0,0 +1,65 @@
+name: Build and Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Build documentation
+        run: mkdocs build --strict
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: docs-site
+          path: site/
+
+  deploy:
+    name: Deploy to VPS
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.VPS_HOST }}
+          username: ${{ secrets.VPS_USER }}
+          key: ${{ secrets.VPS_SSH_KEY }}
+          script: |
+            cd ${{ secrets.DOCS_PATH || '/opt/espilon-docs' }}
+            git pull origin main
+            docker-compose -f docker-compose.docs.yml build
+            docker-compose -f docker-compose.docs.yml up -d
+            docker image prune -f

.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv/
+ENV/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# MkDocs
+site/
+.cache/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# OS
+Thumbs.db
+
+# Claude
+.claude/

Dockerfile

@@ -0,0 +1,32 @@
+# Multi-stage build for MkDocs documentation
+
+# Stage 1: Build documentation
+FROM python:3.11-slim AS builder
+
+WORKDIR /docs
+
+# Copy requirements and install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy documentation source
+COPY . .
+
+# Build static documentation
+RUN mkdocs build
+
+# Stage 2: Serve with Nginx
+FROM nginx:alpine
+
+# Copy built documentation from builder stage
+COPY --from=builder /docs/site /usr/share/nginx/html
+
+# Copy custom nginx configuration if needed
+# COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# Expose port 80
+EXPOSE 80
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s \
+  CMD wget --quiet --tries=1 --spider http://localhost/ || exit 1

README.md

@@ -0,0 +1,108 @@
+# Espilon Documentation
+
+Official documentation for the Espilon ESP32 embedded agent framework.
+
+**Live Documentation**: https://docs.espilon.net
+
+**Main Project**: https://github.com/Espilon-Net
+
+## About
+
+Complete documentation for Espilon, built with [MkDocs](https://www.mkdocs.org/) and the [Material theme](https://squidfunk.github.io/mkdocs-material/).
+
+## Documentation Contents
+
+- **Getting Started**: Installation, quick start, and overview
+- **Hardware**: Supported boards and setup guides
+- **Configuration**: Menuconfig and network settings
+- **Tools**: Flasher and C2 server
+- **Modules**: Command reference and module system
+- **Security**: Best practices and encryption
+
+## Quick Start
+
+### Local Development
+
+```bash
+# Clone
+git clone https://github.com/Espilon-Net/espilon-docs.git
+cd espilon-docs
+
+# Setup
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+
+# Run
+mkdocs serve
+```
+
+Documentation available at http://localhost:8000
+
+### Docker Build
+
+```bash
+# Build
+docker build -t espilon-docs .
+
+# Run
+docker run -p 8080:80 espilon-docs
+```
+
+Access at http://localhost:8080
+
+## Deployment
+
+### Self-Hosted with Docker Compose
+
+```bash
+docker-compose -f docker-compose.docs.yml up -d
+```
+
+The service will be available on port 80 and can be proxied via Nginx.
+
+### Configuration Example (Nginx)
+
+```nginx
+server {
+    listen 443 ssl;
+    server_name docs.espilon.net;
+
+    ssl_certificate /etc/letsencrypt/live/espilon.net/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/espilon.net/privkey.pem;
+
+    location / {
+        proxy_pass http://espilon-docs:80;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+## Repository Structure
+
+```
+espilon-docs/
+├── docs/                    # Markdown files
+├── mkdocs.yml              # MkDocs config
+├── requirements.txt        # Python dependencies
+├── Dockerfile              # Multi-stage build
+├── docker-compose.docs.yml # Docker Compose config
+└── .github/workflows/      # CI/CD
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch
+3. Make changes and test locally with `mkdocs serve`
+4. Commit your changes
+5. Push and create a Pull Request
+
+## License
+
+Documentation for the Espilon project.
+
+---
+
+**Built with MkDocs Material**

docker-compose.docs.yml

@@ -0,0 +1,18 @@
+version: '3.8'
+
+services:
+  docs:
+    build: .
+    container_name: espilon-docs
+    restart: always
+    expose:
+      - "80"
+    networks:
+      - default
+    labels:
+      - "docs.espilon.net"
+
+networks:
+  default:
+    external: true
+    name: espilon_default