19 lines
1.0 KiB
Markdown
Executable File
19 lines
1.0 KiB
Markdown
Executable File
# Introduction
|
|
|
|
This repository contains code for the website https://zainezq.com, which serves as a central familial hub for me.
|
|
|
|
The site is written using Emacs and Org-mode, and exported using the `org-publish` functionality. See the `build-site.el` script for details on how the site is built and published.
|
|
|
|
## Local authoring UI
|
|
|
|
Run `make author` and open `http://127.0.0.1:8765` to create or edit blog and post Org files from a browser. When deployed behind the reverse proxy, use `https://author.zainezq.com`.
|
|
|
|
The editor writes normal `.org` pages with the metadata used by the publishing pipeline:
|
|
|
|
- blogs default to `blogs/YYYY/MM-month/slug.org`
|
|
- posts default to `posts/slug.org`, or `posts/section/slug.org` when a section is provided
|
|
- new pages can use an explicit path under `blogs/` or `posts/`
|
|
- saving a page starts `emacs -Q --script build-site.el` and then regenerates the search index
|
|
|
|
Saves enqueue builds. The editor remains usable while publishing runs, and the queue section shows the current build, pending builds, and recent build results.
|