Kirby Paradocs
Auto-generate beautiful documentation pages from markdown files within your Kirby plugins.
Features#
- Auto-Discovery: Automatically scans installed plugins for documentation
- Beautiful Frontend: Clean, responsive documentation interface inspired by Kirby Docs
- Markdown Processing: Full markdown support with frontmatter, alerts, and code blocks
- Syntax Highlighting: Enhanced code highlighting with Phiki integration
- Access Control: Optional authentication to restrict documentation access
- Smart Caching: Built-in caching for optimal performance
- Plugin Filtering: Safelist specific plugins for documentation inclusion
How It Works#
Kirby Paradocs transforms your plugin directories into a unified documentation site. When you visit /docs (configurable), the plugin scans all installed Kirby plugins looking for documentation files. It processes README.md files, /docs directories, and optional .paradocs.json configuration files to build a comprehensive documentation hierarchy.
Each plugin's documentation is automatically organized with support for nested directories, index pages, and rich markdown content. The plugin processes markdown and provides syntax highlighting for code examples. All documentation is rendered through customizable Kirby templates and snippets.
The system respects your plugin's existing documentation structure while providing a polished interface for end users. Whether you're documenting internal tools or public plugins, Paradocs creates a quick and good looking documentation experience.
Quick Start#
Download#
Download and copy this repository to /site/plugins/kirby-paradocs.
Composer#
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
Visit your documentation:#
Navigate to /docs in your Kirby site to view the generated documentation. You have to be logged in to the Kirby Panel if not otherwise configured.
Documentation#
- Getting started - Complete setup instructions
- Writing docs - How to write documentation
- Customization - Customize to fit your site
- Custom Processors - Extend the system with custom processors
Requirements#
- Kirby CMS: 4.6+
- PHP: 8.3+
- Optional: Phiki for enhanced syntax highlighting
Support#
- Documentation: Website
- Issues: GitHub Issues
- Source Code: GitHub Repository