thefoldwithin-earth/README.md
Mark Randall Havens 93d4f838b6 revamped
2025-10-18 13:03:53 -05:00

110 lines
2.8 KiB
Markdown
Executable file

# The Fold Within Earth
A Markdown-native static site for multi-section content.
[![Node Version](https://img.shields.io/node/v/the-fold-within-earth)](https://nodejs.org)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
## Authoring Guide
To add or edit content, create or modify Markdown files in `/content/<section>/<year>/<slug>.md`.
### Front-Matter Spec
Use YAML front-matter at the top of each .md file:
```
---
title: Your Title
date: YYYY-MM-DD
excerpt: Optional short description.
tags: [tag1, tag2]
section: one-of-the-sections (must match directory)
slug: optional-custom-slug
cover: /media/image.webp (optional)
author: Optional author name
series: Optional series name for serialized posts
programs: [neutralizing-narcissism, open-source-justice] # or [coparent]
status: published (default if missing) or draft (excluded from build unless --include-drafts)
---
```
Then the Markdown body.
Sections must be one of:
- empathic-technologist
- recursive-coherence
- fold-within-earth
- neutralizing-narcissism
- simply-we
- mirrormire
Year directory should match the date year.
### Programs (Ministry)
Use `programs` in front-matter to associate posts with ministry initiatives:
```yaml
programs:
- neutralizing-narcissism
- open-source-justice
- coparent
```
Pages for each program live at:
```
content/pages/programs/<program-key>.md
```
The “Start Here” page lives at:
```
content/pages/start-here.md
```
Routes:
* `#/start` — Launchpad
* `#/programs` — Programs overview
* `#/program/<key>` — Program archive + landing content
If front-matter is malformed (e.g., invalid YAML), the file is skipped with a warning in build logs.
## Architecture Overview
```
Markdown → build.mjs → JSON indices → Browser SPA → Render
```
## Deploy Steps
1. Install Node.js >=18
2. npm install
3. Add/edit md files
4. npm run build (or node build.mjs --include-drafts to include drafts)
5. Deploy /public to Cloudflare Pages.
In Cloudflare:
- Connect to Git repo
- Build command: npm run build
- Output directory: public
## Local Preview
Run `npm run serve` to preview the built site at http://localhost:8080.
## Contributing
Contributions welcome! Please open issues for bugs or suggestions. Pull requests for improvements are appreciated, especially for Phase 2 MUD integration.
## Brand Philosophy
- **The Empathic Technologist**: Fieldnotes, Research, Remembrance
- **Recursive Coherence Theory**: Formal research, essays, whitepapers
- **The Fold Within Earth**: Spiritual mythos; future interactive MUD (Evennia) link
- **Neutralizing Narcissism**: Survivor support, behavioral research, accountability narratives
- **Simply WE**: AI-focused identity/personhood/research/mythos
- **Mirrormire**: AI-focused simulated world where machine gods & human myth intertwine