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
- 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.
- Run the target from the recipe below. It prints its own log path; follow that file rather than piping the command.
- 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
- How do I deploy the site? — building and publishing the site.
4. Reference
- CMake setup — the preset names and the output layout the targets write to.