72 lines
1.8 KiB
Markdown
72 lines
1.8 KiB
Markdown
# Neeldhara Blogs
|
|
|
|
This repository is a monorepo for seven Astro blogs. Each site lives under
|
|
`sites/<name>` and can evolve independently with its own theme, dependencies,
|
|
RSS feed, and Dokploy application.
|
|
|
|
## Sites
|
|
|
|
- `sites/research`
|
|
- `sites/vibes`
|
|
- `sites/puzzles`
|
|
- `sites/reflections`
|
|
- `sites/poetry`
|
|
- `sites/reviews`
|
|
- `sites/art`
|
|
|
|
## Local Development
|
|
|
|
```bash
|
|
npm install
|
|
|
|
# Run the default research site
|
|
npm run dev:research
|
|
|
|
# Or run a specific site directly
|
|
npm run dev --prefix sites/puzzles
|
|
```
|
|
|
|
Open [http://localhost:4321](http://localhost:4321) with your browser to see the result.
|
|
|
|
Build every site:
|
|
|
|
```bash
|
|
npm run build:sites
|
|
```
|
|
|
|
Build one site:
|
|
|
|
```bash
|
|
npm run build --prefix sites/research
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
- Astro 5.x
|
|
- Tailwind 4
|
|
- shadcn/ui
|
|
|
|
## Deploy
|
|
|
|
Deployment is via Forgejo + Dokploy. See [DEPLOYMENT.md](./DEPLOYMENT.md).
|
|
|
|
## Coral Comments
|
|
|
|
Post pages embed Coral with `customCSSURL: "/coral-transparent.css"`. Each
|
|
site keeps its own copy at `sites/<name>/public/coral-transparent.css`.
|
|
|
|
That CSS is the durable customization point for Coral UI changes: it is served
|
|
by the blog site and loaded by Coral at runtime, so it survives Coral container
|
|
rebuilds and image upgrades. It currently makes the embed background
|
|
transparent, hides the redundant single "Comments" tab, and suppresses Coral's
|
|
fixed-position floating notification bell so it cannot drift over article text.
|
|
|
|
## Obsidian Content Bridge
|
|
|
|
The seven blog content folders are synced from the public Obsidian vault. See
|
|
[CONTENT_BRIDGE.md](./CONTENT_BRIDGE.md) for conventions, preview/publish
|
|
commands, and the Quarto import workflow. See [IMPORT_REPORT.md](./IMPORT_REPORT.md)
|
|
for the current imported post mapping.
|
|
|
|
For the reusable Markdown parser contract shared by Astro HTML and Pandoc/PDF,
|
|
see [docs/PARSER.md](./docs/PARSER.md).
|