• v1.3.0 b1856da41d

    Version 1.3.0 Stable

    miko released this 2026-11-06 15:21:32 +01:00 | 0 commits to master since this release

    Version 1.3.0

    A handbook for readers, authors and admins, problem reports on guides, and references to other guides, categories and pages.

    added

    • Problem reports: readers, guests included, report that a guide or one of its steps is wrong or unclear, with the flag beside a step's heading or the link at the end of the guide; authors find the reports on the guides they may edit under Problem reports in the menu under their name, admins all of them in the admin menu, each with the number still open, and mark them resolved; spam is kept out by a hidden honeypot field and a limit of five reports per fifteen minutes per guest address or user (#99)
    • Emails: with an SMTP server set in the settings' new section Email, which sends a test email to check it, a guide's owner gets an email about every new problem report, in their language, or the admins once the owner is no longer an author; without one, kataba sends no mail; the SMTP password is stored encrypted with AUTH_SECRET (#99)
    • Handbook: kataba has a handbook at https://pages.mike-ochmann.de/kataba/, with a user handbook for readers and authors and an administration handbook for admins and for running an instance, in kataba's look in light and dark mode; it is built from handbook/ with Zensical and published with every release (#138)
    • Help: signed-in users find Help in the menu under their name, opening the user handbook, and admins find the administration handbook in the admin menu; both open in a new tab, guests see neither (#142)
    • References: in a guide's description and step content, a category's description and a page's content, authors turn selected words into a reference to a guide, category or page they pick by searching, with the new bookmark in the inline toolbar; readers see the target's current title, with a card of its image and title on hover, and the plain text where the target is gone or hidden from them; PDFs link to the full address, and exported guides keep their references (#101)

    changed

    • Backups also hold the problem reports; older backups are restored without any (#99)
    • The address /reports now belongs to kataba: a page with the slug reports is no longer reachable there (#99)
    • README: installing, Docker, configuration, Authentik, roles and backup and restore moved into the handbook's administration part, which is now the single place for them; the README keeps a short Docker Compose quickstart and links into the handbook (#139)
    • Settings: the settings page is split into the tabs General, Content, Email and Access, each saving only its own settings, with more space between fields and sections (#149)

    fixed

    • Rich text editor: in dark mode, the buttons of the inline toolbar (italic, link, inline code, reference) no longer turn white on white under the pointer
    • References: the list of guides, categories and pages to pick from in the inline toolbar is three times as wide, so their titles no longer wrap early; on a phone it takes the screen's width (#152)
    Downloads