From 9de7b08142c36002b6e839b93c47ee32833620f8 Mon Sep 17 00:00:00 2001 From: Chris Colinsky <88026078+chris-colinsky@users.noreply.github.com> Date: Thu, 24 Sep 2026 21:35:11 -0700 Subject: [PATCH] Prepare release 0.1.0 Date the changelog section for 0.1.0 and open a new Unreleased one. Add the per-slide style overrides, which shipped without an entry, and word the Content-Security-Policy entry for a first release. The README and the demo deck's getting-started slide now install from PyPI, which is true once 0.1.0 is published. The README keeps the repository install for changes that aren't released yet. --- CHANGELOG.md | 11 +++++++++-- README.md | 10 +++++++++- examples/demo/deck.md | 2 +- 3 files changed, 19 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5d73526..0b803d8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,10 @@ All notable changes to this project are documented here. The format follows ## [Unreleased] +## [0.1.0] - 2026-09-24 + +The first release. + ### Added - Published on PyPI: `uv tool install akceo` or `pipx install akceo`. @@ -19,9 +23,12 @@ All notable changes to this project are documented here. The format follows diagram that would load or link to anything outside the deck, and on one longer than Mermaid's 50,000-character limit. A deck with a diagram grows by about 5.6 MB. - The built page carries a Content-Security-Policy, so the browser refuses to load anything from - outside the file. A web font or `@import` in a custom theme no longer loads; use installed - fonts, or embed one as a `data:` URI. + outside the file. A web font or `@import` in a custom theme doesn't load; use installed fonts, + or embed one as a `data:` URI. - `akceo check deck.md` runs every check a build runs, diagrams included, without writing a file. +- Per-slide style overrides: `style-h1`, `style-h2`, `style-lead`, `style-ul`, `style-ol` and + `style-sub` add inline CSS to that element, for one-off spacing fixes. They can't reference + files or URLs. - `image-frame: no`, for the whole deck or one slide, drops the white panel behind images. Mermaid diagrams without a frame are drawn in the deck theme's colors. - Deck errors name the file, line and slide; theme and image errors name the file. Content a diff --git a/README.md b/README.md index eabdd47..dafb3a2 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,15 @@ straight from disk, works offline, and survives being emailed or copied anywhere ## Install -Needs Python 3.12 or newer and [uv](https://docs.astral.sh/uv/). +Needs Python 3.12 or newer. Install the `akceo` command from PyPI with +[uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/): + +```sh +uv tool install akceo +pipx install akceo +``` + +To try changes that aren't released yet, install from the repository instead: ```sh uv tool install git+https://github.com/LunarCommand/akceo diff --git a/examples/demo/deck.md b/examples/demo/deck.md index 3b93d62..ab1a52a 100644 --- a/examples/demo/deck.md +++ b/examples/demo/deck.md @@ -68,7 +68,7 @@ kicker: Getting started Install once. After that it's a write, build, present loop. -1. Install: `uv tool install git+https://github.com/LunarCommand/akceo` +1. Install: `uv tool install akceo` 2. Write `deck.md`: a config block, then slides separated by `---`. 3. Build: `akceo build deck.md` 4. Present: open `deck.html` and use the arrow keys.