68 lines
2.1 KiB
Markdown
68 lines
2.1 KiB
Markdown
# Mathew — a wiki for mathematics
|
|
|
|
A modern math-concept wiki. Articles are written in **Markdown** (with **LaTeX** via KaTeX)
|
|
and stored in MongoDB through an Express API.
|
|
|
|
```
|
|
mathew/
|
|
├── backend/ Express 5 + Mongoose API (port 5000)
|
|
└── frontend/ Nuxt 4 wiki UI (port 3000/3001)
|
|
```
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
# 1. API (requires MongoDB on localhost:27017)
|
|
cd backend
|
|
npm install
|
|
npm run seed # optional: 6 sample articles (LaTeX included)
|
|
npm run dev # → http://localhost:5000
|
|
|
|
# 2. UI
|
|
cd ../frontend
|
|
npm install
|
|
npm run dev # → http://localhost:3000
|
|
```
|
|
|
|
## Pages
|
|
|
|
| Route | What it does |
|
|
| --- | --- |
|
|
| `/` | Search + recently updated articles |
|
|
| `/wiki/<slug>` | Rendered article with table of contents |
|
|
| `/wiki/<slug>/edit` | Markdown editor with live preview |
|
|
| `/new` | Create a new article |
|
|
|
|
## Markdown + LaTeX
|
|
|
|
Articles support GitHub-ish Markdown (headings, tables, lists, blockquotes, fenced
|
|
code with highlighting) plus LaTeX: `$E = mc^2$` inline and `$$ ... $$` in display
|
|
mode. Rendered server-side with `markdown-it` + `markdown-it-texmath` + KaTeX and
|
|
sanitized with DOMPurify (raw HTML in articles is escaped).
|
|
|
|
Handy macros: `\R`, `\N`, `\Z`, `\Q`, `\C` for the number sets.
|
|
|
|
## API
|
|
|
|
| Method | Endpoint |
|
|
| --- | --- |
|
|
| GET | `/api/articles?q=&tag=` — search / filter, no content body |
|
|
| GET | `/api/articles/slug/:slug` — one article |
|
|
| POST | `/api/articles` — create (`title` required; slug auto-generated & uniquified) |
|
|
| PUT | `/api/articles/slug/:slug` — update |
|
|
| DELETE | `/api/articles/slug/:slug` — delete |
|
|
|
|
## Configuration
|
|
|
|
| Where | Variable | Default | Meaning |
|
|
| --- | --- | --- | --- |
|
|
| `backend/.env` | `PORT` | `5000` | API port |
|
|
| `backend/.env` | `MONGO_URI` | `mongodb://127.0.0.1:27017/mathew` | Mongo connection |
|
|
| `frontend` env | `NUXT_PUBLIC_API_BASE` | `http://localhost:5000` | Where the UI calls the API |
|
|
|
|
## Editing tips
|
|
|
|
- `/` focuses the search box on the home page; `Ctrl/Cmd+S` saves in the editor.
|
|
- The editor has Write / Split / Preview modes; LaTeX and code highlight update live.
|
|
- Changing an article's title may change its slug (old links 404 — redirect not implemented).
|