Devops Deploy Site

Table of Contents

1. When to use this skill

Building and publishing the documentation website from the org-roam graph — also the local check that no id-links are broken before pushing doc changes.

2. How to use this skill

  1. Build before you publish. The site build is where a broken id-link surfaces, and publishing a build you have not read means the broken link ships.
  2. Run the target from the recipe below. It prints its own log path; follow that file rather than piping the command.
  3. Read the tail, not the exit code alone. The build reports success while still naming files it skipped, and a skipped file is a page that silently did not update.

3. Recipes

4. Reference

  • CMake setup — the preset names and the output layout the targets write to.

Emacs 29.3 (Org mode 9.6.15)