Add local Kroki fallback configuration for offline builds #69

New issue

Open

opened 2026-03-14 23:57:26 +00:00 by freemo · 0 comments

freemo commented

2026-03-14 23:57:26 +00:00

Owner

Metadata

Commit Message: docs: add local Kroki server fallback for offline documentation builds
Branch: feature/m3-v11-docs-kroki-fallback

Background

The Kroki plugin depends on kroki.qoto.org. If the service is down, diagrams render as raw code blocks.

Expected Behavior

Documentation on configuring a local Kroki instance as fallback, and the plugin reads the Kroki URL from an environment variable.

Acceptance Criteria

Plugin reads KROKI_URL env var with default fallback to kroki.qoto.org
Documentation explains how to run local Kroki via Docker

Subtasks

Update remark-kroki-inline.js to read KROKI_URL
Add Kroki setup instructions to developer docs
Verify build

Definition of Done

This issue is complete when all subtasks are done, commit created on the specified branch, PR submitted and merged.

## Metadata - **Commit Message**: `docs: add local Kroki server fallback for offline documentation builds` - **Branch**: `feature/m3-v11-docs-kroki-fallback` ## Background The Kroki plugin depends on `kroki.qoto.org`. If the service is down, diagrams render as raw code blocks. ## Expected Behavior Documentation on configuring a local Kroki instance as fallback, and the plugin reads the Kroki URL from an environment variable. ## Acceptance Criteria - [ ] Plugin reads `KROKI_URL` env var with default fallback to `kroki.qoto.org` - [ ] Documentation explains how to run local Kroki via Docker ## Subtasks - [ ] Update `remark-kroki-inline.js` to read `KROKI_URL` - [ ] Add Kroki setup instructions to developer docs - [ ] Verify build ## Definition of Done This issue is complete when all subtasks are done, commit created on the specified branch, PR submitted and merged.