Beautiful, Modern & Opinionated Linux by DHH.
See https://github.com/basecamp/omarchy for more.
Add posts as Markdown under content/news/YYYY/MM/post-slug.md. A post may
start with YAML front matter containing title, date, author, author_url,
and description; only the title is required, either there or as the first #
heading. Images stored beside the post are published with it. Regenerate the
pages under news/ with:
bin/build-news
The pages under manual/ are generated from the authoritative markdown chapters
in the omarchy repo.
Regenerate them (then commit the result) with:
bin/build-manual
It needs gem install kramdown kramdown-parser-gfm and imagemagick on first run. Pass a local
checkout to build without hitting GitHub: bin/build-manual ../omarchy/manual.
The same build writes manual/search-index.json — one entry per heading, so results link
straight to the section that matched. assets/js/modules/search.js fetches it the first
time someone reaches for the box in the header and matches in the browser; there is no
search service and nothing to run. Press / anywhere in the manual to search.