Haozhe Wu
25b6ee5d72
First-party, anonymous analytics for the public wiki — no client-side telemetry in the pip package. Pages Function middleware classifies each page request (AI agent / bot / human) by User-Agent server-side and counts it into D1; /api/stats serves the footer's aggregate counts alongside public PyPI install and GitHub star numbers.
35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# Vibe-Trading Wiki
|
|
|
|
Static source for `https://vibetrading.wiki`.
|
|
|
|
## Local preview
|
|
|
|
```bash
|
|
cd wiki
|
|
python3 -m http.server 8088
|
|
```
|
|
|
|
Open `http://localhost:8088/home/` for the landing page and these wiki sections:
|
|
|
|
- `http://localhost:8088/docs/`
|
|
- `http://localhost:8088/tutorials/`
|
|
- `http://localhost:8088/alpha-library/`
|
|
- `http://localhost:8088/research-lab/`
|
|
|
|
Direct docs URLs such as `/docs/latest/getting-started/vibe-trading-overview` are handled by Cloudflare Pages via `_redirects`. The simple Python preview server does not apply those rewrite rules, so use `/docs/` as the local entry point.
|
|
|
|
## Cloudflare Pages
|
|
|
|
- Project root: `wiki`
|
|
- Build command: leave empty
|
|
- Output directory: `.`
|
|
- Custom domain: `vibetrading.wiki`
|
|
|
|
The site is static and needs no build step. The only dynamic piece is a small
|
|
analytics layer in `functions/` (Cloudflare Pages Functions): `_middleware.js`
|
|
classifies each page request as AI-agent / bot / human by User-Agent and counts
|
|
it into a D1 database (`vibetrading-analytics`, binding `DB`), and
|
|
`api/stats.js` serves the footer's aggregate counts alongside public PyPI and
|
|
GitHub numbers. The counter is anonymous and first-party — no cookies, no
|
|
per-visitor identifier, no IP retention.
|