pfaciana/render-docs

Display HTML documentation pages from render-docs json data files

Maintainers

Details

github.com/pfaciana/render-docs

Homepage

Source

Issues

Installs: 6

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

1.0.2 2021-06-03 01:31 UTC

Requires

GPL-2.0-only 3184787dde290cdb1a6116565a3dda3979d2f9fa

This package is auto-updated.

Last update: 2024-12-04 15:21:16 UTC

README

Take output json files from npm package parse-php-to-json and render the docs as readable html pages.

Example Use

Install

composer require pfaciana/render-docs

Run

Place this code in on your web server. In it's simpliest form, you just need to call RenderDocs() and tell it where to find your JSON files (outputted from parse-php-to-json). Then view this page in your web browser.

<?php

require_once __DIR__ . '/vendor/autoload.php';

RenderDocs([
    'docRoot'   => __DIR__ . '/../docs/', // Required. Location of the JSON files (Projects grouped as sub-directories) 
    'editorUrl' => 'http://localhost:1234/api/file/', // Optional. If you have an IDE installed, this will prefix a link to open the file (if it exists locally) in your IDE. 
    'locationFilter' => function ($file) { /* alter filepath */ return $file; }, // Optional. Used with `editorUrl`, if the file exists in a different location locally than in the repo, this is a filter that allows you to alter the filepath so that you can link to it locally. 
]);