moinframe/kirby-paradocs

Auto-generate beautiful documentation pages using markdown

dev-main 2025-04-11 16:41 UTC

This package is not auto-updated.

Last update: 2025-06-09 11:05:13 UTC


README

Kirby Paradocs is a plugin for Kirby CMS that allows you to create beautiful documentation pages using markdown. The plugin will scan the installed plugins in your Kirby installation and auto-generate a documentation page for each plugin.

The primary use case for this plugin is to easily provide documentation pages for your own plugins. The idea is to combine the flexibility of having the documentation in markdown inside the plugins repository itself with the ease of creating beautiful documentation pages for your users.

Features

  • Automatically generates documentation pages for all installed plugins
  • Provides frontend inspired by the Kirby Docs
  • (Optional) user authentication to restrict access
  • (Optional) syntax highlighting with Phiki

Installation

Caution

This plugin is still in development and should be considered alpha. It will change quite a bit before it reaches a stable version.

Download

Download and copy this repository to /site/plugins/kirby-paradocs.

Composer

# Basic installation
composer require moinframe/kirby-paradocs

# With enhanced syntax highlighting
composer require moinframe/kirby-paradocs phiki/phiki

Git submodule

git submodule add https://github.com/moinframe/kirby-paradocs.git site/plugins/kirby-paradocs