org_web/README.md

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

Lima pages are Markdown files under lima/. Selecting the Lima page type shows a Markdown toolbar for common formatting and an attachment button. Uploaded images and videos are stored under assets/images/hzone/YYYY/MM/ and inserted into the Markdown page.

Saves enqueue builds. The editor remains usable while publishing runs, and the queue section shows the current build, pending builds, and recent build results.