Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

**Abstracted from:** Customer-specific `./vault` CLI (bash) and `credentials-ui` (FastAPI) into a generalized open-source tool.

**Landschaften:** [vaultctl](docs/landscapes/vaultctl/LANDSCAPE.md) — design decision records and cross-cutting design notes live here.

## Build and Development Commands

```bash
Expand Down
Binary file added docs/assets/cdds-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 13 additions & 1 deletion docs/build_manual.sh
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@
# via the system package manager (`pandoc`, `texlive-xetex`, plus the Noto and
# DejaVu font packages). All settings (fonts, layout, classoptions) live in
# the YAML metadata block at the top of manual.md — no separate template.
#
# The vaultctl version is read from ../pyproject.toml at build time and
# injected into the manual's subtitle, so the rendered PDF always carries
# the version it documents.

set -euo pipefail

Expand All @@ -19,9 +23,17 @@ if ! command -v xelatex >/dev/null 2>&1; then
exit 1
fi

# Extract `version = "X.Y.Z"` from the [project] section of pyproject.toml.
VERSION="$(grep -E '^version\s*=' ../pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')"
if [[ -z "${VERSION}" ]]; then
echo "Error: could not extract version from ../pyproject.toml" >&2
exit 1
fi

pandoc manual.md \
--pdf-engine=xelatex \
--highlight-style=tango \
--metadata=subtitle:"User Manual · vaultctl v${VERSION}" \
--output=manual.pdf

echo "Built: $(pwd)/manual.pdf"
echo "Built: $(pwd)/manual.pdf (vaultctl v${VERSION})"
45 changes: 0 additions & 45 deletions docs/landscapes/vaultctl/LANDSCAPE.md

This file was deleted.

This file was deleted.

3 changes: 3 additions & 0 deletions docs/manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,16 @@ header-includes:
- \usepackage{microtype}
- \usepackage{fancyhdr}
- \usepackage{xcolor}
- \usepackage{graphicx}
- \definecolor{codebg}{HTML}{F4F4F2}
- \usepackage{fvextra}
- \DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,commandchars=\\\{\}}
- \fvset{breaklines=true,breaknonspaceingroup=true,breakanywhere=true}
- \renewcommand{\sfdefault}{\familydefault}
- \addtokomafont{disposition}{\rmfamily}
- \setkomafont{descriptionlabel}{\rmfamily\bfseries}
- \titlehead{\centering\includegraphics[width=3.5cm]{assets/cdds-logo.png}}
- \publishers{\normalsize cdds-ab · \texttt{github.com/cdds-ab/vaultctl}}
---

# Introduction
Expand Down
Binary file modified docs/manual.pdf
Binary file not shown.
Loading