kalaj.org

The Markdown source for www.kalaj.org, built with Hugo and the Congo theme.

Write with Obsidian

1. Clone this repository and open its root directory as an Obsidian vault.
2. Create each article as content/posts/article-name/index.md.
3. Put images and other media in the same directory as index.md.
4. Link media with standard relative Markdown, for example ![Alt text](photo.jpg).
5. Set draft: false in the front matter and push to main when it is ready.

The optional Obsidian Git community plugin can commit and push without leaving Obsidian. Use standard Markdown links rather than Obsidian wikilinks so Hugo can render the same files.

Write with Forgejo

Navigate to a Markdown file and use its edit button. Every published article also includes an Edit this page link. Forgejo's editor is suitable for text changes; Obsidian is easier when adding several media files.

Preview locally

Run Hugo through Docker:

docker run --rm -it -p 1313:1313 -v "$PWD:/src" hugomods/hugo:debian-go-0.165.0 hugo server --bind 0.0.0.0 --buildDrafts

Open http://localhost:1313. Stop the server with Ctrl-C.

Publish

Forgejo Actions builds and pushes git.kalaj.org/sat/kalaj.org:latest after each push to main. The repository needs an Actions secret named REGISTRY_TOKEN containing a Forgejo access token with package write permission.