diff --git a/.allai/Html support b/.allai/Html support new file mode 100644 index 0000000..3c6e954 --- /dev/null +++ b/.allai/Html support @@ -0,0 +1,482 @@ +I'll help you set up HTML support for your project. Here are several ways to add HTML preview, documentation, and support features: + +## 1. HTML Preview Setup + +### Basic HTML Preview Workflow +```yaml +# .github/workflows/html-preview.yml +name: HTML Preview + +on: + push: + branches: [main, master] + pull_request: + branches: [main, master] + +permissions: + contents: read + pages: write + id-token: write + +jobs: + build: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup Pages + uses: actions/configure-pages@v3 + + - name: Build HTML documentation + run: | + # Create basic HTML structure if not exists + mkdir -p _site + cp -r docs/* _site/ 2>/dev/null || echo "No docs directory" + # Generate index.html if missing + if [ ! -f "_site/index.html" ]; then + cat > _site/index.html << EOF + + + + Project Documentation + + + + +
+

Project Documentation

+

Auto-generated documentation preview

+ +
+ + + EOF + fi + + - name: Upload artifact + uses: actions/upload-pages-artifact@v2 + with: + path: _site/ + + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v2 +``` + +## 2. Interactive HTML Comment System + +### HTML Comment Chat Interface +```html + + + + + + Project Discussion + + + +
+
+

💬 Project Discussion

+

Chat with the community and get support

+
+ +
+
+ 👋 Welcome! How can I help you today? +
+
+ +
+ + +
+ + +
+ + + + +``` + +## 3. Complete Documentation System + +### Project Documentation Structure +``` +docs/ +├── index.html +├── api/ +│ ├── index.html +│ └── reference.html +├── guides/ +│ ├── getting-started.html +│ └── advanced.html +└── assets/ + ├── css/ + │ └── style.css + └── js/ + └── app.js +``` + +### Main Documentation Page +```html + + + + + + Project Documentation + + + + + +
+

Project Documentation

+
+

🚀 Getting Started

+

Welcome to our project! This guide will help you get started.

+
+ +
+

🔧 API Reference

+

Complete API documentation and examples.

+
+ +
+

💬 Support & Community

+
+
+

GitHub Discussions

+

Join the conversation

+
+
+

Live Chat

+

Real-time support

+
+
+
+
+ + + + + + + +``` + +## 4. CSS Styling (assets/css/style.css) +```css +* { + margin: 0; + padding: 0; + box-sizing: border-box; +} + +body { + font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; + display: flex; + min-height: 100vh; + background: #f8f9fa; +} + +.sidebar { + width: 300px; + background: #2d3748; + color: white; + padding: 20px; + position: fixed; + height: 100vh; + overflow-y: auto; +} + +.content { + flex: 1; + margin-left: 300px; + padding: 40px; + max-width: 800px; +} + +.modal { + display: none; + position: fixed; + top: 0; + left: 0; + width: 100%; + height: 100%; + background: rgba(0,0,0,0.5); +} + +.modal-content { + background: white; + margin: 50px auto; + padding: 30px; + border-radius: 12px; + max-width: 600px; +} + +.tiers { + display: flex; + gap: 20px; + margin-top: 20px; +} + +.tier { + flex: 1; + padding: 20px; + border: 2px solid #e2e8f0; + border-radius: 8px; + text-align: center; +} + +.tier.featured { + border-color: #4299e1; + transform: scale(1.05); +} +``` + +## 5. Integration with Existing Workflow + +Add this to your existing CMake workflow: +```yaml +# Add to your existing cmake-multi-platform.yml +- name: Generate HTML Documentation + if: matrix.os == 'ubuntu-22.04' && matrix.compiler == 'gcc' + run: | + mkdir -p docs + # Generate Doxygen docs if available + if command -v doxygen &> /dev/null; then + doxygen Doxyfile 2>/dev/null || echo "Doxygen not configured" + fi + # Create basic HTML structure + cp -r templates/docs/* docs/ 2>/dev/null || echo "No template docs" + +- name: Upload HTML Documentation + uses: actions/upload-artifact@v4 + with: + name: html-documentation + path: docs/ + retention-days: 30 +``` + +This setup provides: +- ✅ **HTML Preview** via GitHub Pages +- ✅ **Comment Chat** interface +- ✅ **Sponsorship Tiers** display +- ✅ **Professional documentation** system +- ✅ **Integration** with your existing CI/CD + +Would you like me to customize any specific part of this HTML support system?