• v1.2.0 c4328f617b

    Version 1.2.0 Stable

    miko released this 2026-11-05 21:46:13 +01:00 | 32 commits to master since this release

    Guides get working copies with publishing and a version history, print, PDF and QR code labels, a step-by-step view, difficulty, duration, protective equipment, licenses and attachments, plus export, import and duplication of guides, Atom feeds, instance backups and a reworked guide editor.

    added

    • Print: a guide prints without the titlebar, breadcrumb and buttons, with all of a step's images and their annotations, always light, and with an attribution line at the end: the instance, the guide's address, its owner and last edit, and kataba; "Print" next to the guide opens the print dialog (#90)
    • PDF download: "Download PDF" next to a guide, for everyone who may read it, gives an A4 PDF with the logo and instance name at the top of every page, page numbers, the description and all steps with their images and annotations, and the same attribution line at the end; its text is set in Inter, with Noto Sans CJK for Chinese, Japanese and Korean (#90)
    • Difficulty and estimated duration: a guide can have a difficulty (easy, medium, hard) and an estimated duration in hours and minutes, set in its properties; both are optional and show as badges in the guide's header, on its tile in the category grid, and in print and PDF (#92)
    • Protective equipment: a guide can call for any of eight kinds of personal protective equipment (eye, face, hearing and respiratory protection, safety gloves, safety shoes, protective clothing, tied-back hair and no jewellery), ticked in its properties; each shows as a pictogram in the style of an ISO 7010 mandatory sign with its name, prominently at the top of the guide and in print and PDF (#95)
    • Working copy and publishing: edits to a published guide go to its working copy, and readers keep seeing the latest published version until someone publishes again; the editor shows "Unpublished changes" with "Publish" (with an optional note) and "Discard changes", and the guide page gives editors a link to preview the working copy. Every publish keeps a version; published guides get their first version when the server starts (#106)
    • Version History: "Version History" in a guide's editor shows every published version, read-only and complete as readers saw it, with when, by whom and with which note it was published; a slider with a mark per version (and a last mark for the working copy's unpublished changes) moves between them. "Restore this version" replaces the working copy with the selected version, asking first if that loses unpublished changes; it publishes nothing (#107)
    • License: every guide has a license, chosen in its properties from Public Domain, CC0 1.0, the six Creative Commons 4.0 licenses and "All rights reserved"; it shows, linked to its text, in the guide's header and in the attribution line of print and PDF. New guides start with the default license, a new setting ("All rights reserved" at first); changing it leaves existing guides as they are, and existing guides got "All rights reserved". The license is part of a guide's versions (#103)
    • Atom feeds: /feed lists newly published and changed guides of the whole instance, /feed/<category path> those of a category and its subcategories, e.g. to post them into a Matrix or Discord channel. Each guide is one entry with its title, cover image, description, who published it and when; every new version updates it, with its change note in the summary, while saved changes to the working copy never show. Only guides guests may see appear, the 50 most recently published; pages link to the instance's feed and category pages to theirs for feed readers (#104)
    • Attachments: files can be attached to a guide for download, such as 3D models, drawings, G-code, manuals or firmware, several per guide, each with a name and an optional description; they are added (chosen or dropped), renamed and removed in the guide's properties and are part of its versions. The guide lists them with type and size below its description, and print and PDF name them with a hint where to download them. Attachments are always downloaded, never opened in the browser; programs and scripts (by extension, and every Windows program by its header) are refused. The largest attachment is a new setting, 50 MB at first (#97)
    • Export and import of guides: "Export" in a guide's editor downloads its working copy as a ZIP with all images and attachments, for everyone who may edit it; history, owner, visibility, wiki mode and menu entries stay behind. Admins import such a package under "Import guide" in the admin menu or on a category page, into a category of their choice, as a public draft of their own without wiki mode that keeps the package's license, protective equipment and attachments. Its content is checked like typed-in content, and packages from a newer kataba are refused (#108)
    • Step-by-Step View: "Step by step" in a guide's reading view opens it one step per screen, filling the window, for a tablet or phone at the machine: a start screen like a title slide, the title large and centred over the darkened cover image, with the number of steps, difficulty, duration, protective equipment, description and attachments; then each step using the whole window, its image as large as the height allows with its annotations, and its step lines and content beside it on wide screens, below it on narrow ones. Readers move by swiping, by the arrow keys or by large buttons, with "Step 4 of 12" and a progress bar at the top, and every screen has its own address (/guides/<id>/steps/<n>). The screen stays on, the view can switch to full screen, and steps can be checked off; that progress is kept only in the browser and starts over once a new version is published. A guide titled "Steps", whose address ended in /steps, now reads at /steps-2 (#98)
    • Labels with QR codes: "QR code" next to a guide's "Print" and "Download PDF", and on every category page, downloads a label as a PDF for everyone who may see the guide or category, to stick on a machine, cabinet or tool wall: a QR code with the title, the kataba mark and the instance name, laid out beside the code on a landscape label and below it otherwise. The code leads to an address by id, /guides/<id> or the new /categories/<id>, which redirects to the category page, so it keeps working after renaming or moving; internal content needs signing in, as before. The label size is a new setting, 50 × 30 mm at first, from 30 × 20 mm. A guide titled "Label", whose address ended in /label, now reads at /label-2, and a page can no longer take the slug "categories" (#94)
    • Instance backup: "Download backup" in the admin menu downloads the whole instance as a ZIP, streamed as it is written: users with their last known role, settings, categories with their images, guides with their working copies, all versions and deleted guides, pages with their images, the menu, and every image and attachment. It shares the guide packages' format version. npm run restore -- <backup.zip> restores it on the command line in the container, only into an empty instance, keeping the ids of guides, categories and pages so links and QR code labels keep working; backups from a newer kataba are refused (#109)
    • Duplicating guides: "Duplicate" in a guide's reading view and editor copies its working copy, for every author and admin who may see the guide, with all steps, step lines, images, annotations, cover image, effort, protective equipment, license and attachments; images and attachments get files of their own, so deleting the original leaves the copy whole. The copy is a draft of whoever duplicated it, titled "Copy of …", in the same category with the same visibility and without wiki mode; versions, menu entries and the status stay with the original (#100)

    changed

    • Guide Actions Menu: in a guide's reading view, signed-in users find "QR code", "Duplicate", "Edit guide", "Unpublish" and "Delete guide" in a "…" menu next to "Print" and "Download PDF", so the row of buttons stays short; "Publish" stays a button. Guests keep "QR code" as a button (#124)
    • Saving in the guide editor: one "Save" button at the top of the sidebar (along the bottom edge on narrow screens) saves the open step, the title, language and description, and the properties together, in place of "Save step", "Save guide" and "Save properties"; Enter in a field saves too. Saving stays in the editor and says whether all changes are saved; a part that fails keeps its changes and error while the others are saved. Publishing from the editor saves first and leads to the reading view; discarding the unpublished changes shows the working copy afresh, so nothing discarded can be saved back. Leaving the editor with unsaved changes anywhere in it asks first (#125)
    • Guide editor sidebar: the properties are split into the tabs "General" (visibility, category, wiki mode, owner), "Details" (difficulty, estimated duration, protective equipment, license) and "Media" (cover image, attachments), with more whitespace between the fields; switching tabs keeps unsaved changes, a tab with unsaved changes is marked, the Save button saves all tabs together, and a failed save opens the tab with the unsaved changes (#126)
    • Media buttons in the guide editor: the buttons for the cover image (and a category's image) and for each attachment show only their icon, with their text in a small tooltip bubble on hover or keyboard focus; "Add files" keeps its text; wiki mode is a toggle switch instead of a checkbox (#130)

    fixed

    • Dialogs (publish, discard, restore, crop, annotate) now darken the page behind them, and the crop frame's corner handle has its white border: the theme has no black or white, so both were silently missing; they use the new scrim colours
    • Dropdowns in forms, such as the settings' top-level child order, default language and default license, no longer jump back to the previous value after saving until the page is reloaded (#114)
    Downloads