Peakium Documentation Viewer
Peakium Documentation Viewer is built to display multi-format documentation in a beautiful presenter. It is built to require no maintenance. It can version track documentation, thus making it easy to maintain and update documentation in git repositories and archive files.
Composer
Warning: require(/path/to/documentation/viewer/vendor/autoload.php): failed to open stream: No such file or directory
The documentation viewer requires Composer to work. Install composer and run composer inside the directory. Composer will download and install all required dependencies in the vendor
directory.
$ composer install
Installation guide for Linux and Windows.
Setup
You need to create the file config.json
and add the appropriate configuration values. Use config.json.default
as example.
You install (and update) the documentation files by running
$ php bin/install
This command will download and install (or update) from all documentation URL's specified in the documentation
key in config.json
, into the directory docs
.
Configuration Parameters
Global
Key | Description |
---|---|
title |
The base HTML page title. |
layout-dir |
The layout directory to use, default used by default. |
Pages
The pages
key consists of a directory with one or more page(s). The order of each page in the configuration, will be the order they are displayed in the sidebar menu, including the section.
The page can contain following parameters:
Key | Description |
---|---|
title |
The title for the page, displayed in the menu. |
section |
The section the page should be categorised in. |
format |
The type of documentation. view means that it will be loaded from the view directory. markdown means that it will parse a markdown file. |
reference |
The location of the documentation. For format view this would be in the view directory. For markdown this would be in the docs directory. |
Markdown specific values
Key | Description |
---|---|
default_file |
The file to load first in a documentation directory. Default is README . |
file_extension |
The extension of the documentation files. Default is .md . |
depth |
The depth that a markdown file should display. When not reaching maximum depth the documentation viewer will include any subsequent linked file in the same page, in the order they are found. |
Documentation
The documentation
key consists of a directory with one or more documentation location(s). They are used to download and version track documentations. The format are as below:
"directory-name": "url"
The directory-name will be the actual name that the directory will be installed in under docs
, and this is also the reference
value for the pages
.
Custom Controllers
You can add custom controllers in the controller/ directory. Read more
The custom controller will be loaded first, thus if you access http://localhost/my_controller_name/
it will try to load the MyControllerName
class first (filename would be my_controller_name.php
). If no class or file is found, the documentation viewer will try find the appropriate page in the pages
key of config.json
.
Layout
Layout can be modified in view
. The best way to make your custom layout is to create a new directory in view
. default
is used as an example layout.
Any assets (images, css, etc) can be added in public/assets
directory. This directory also contains a default
directory as example assets.
Requirements
- PHP 5.3+
- Composer
- Git for git documentation