php-pure/themer

A markdown based documentation

PHP Pure's Themer

A template, the converts markdown .md files into well static html page, depending on the theme you will use., _(*1)

Index

• The Factory
• Themes
• Test
• Writing your own Theme

The Factory

We have a factory that handles combines all the processes and calls the themes you need., _(*2)

$map

Just a map for our markdowns., _(*3)

$map = [
    'Prologue' => [
        'Setup' => __DIR__.'/docs/prologue/setup.md',
        'Change Log' => __DIR__.'/docs/prologue/change_log.md',
    ],
];

$view_variables

You can freely pass a variable in the factory. Please take a note that this variables will be over-written/added a new variable when you will be using a different theme., _(*4)

$view_variables = [
    'uri' => 'http://example.com',
    'title' => 'My Documentation',
    // and so on ...
];

Finally to call the factory, Please take a note that the below code is still incomplete, that we still need to review how the theme works., _(*5)

<?php

$map = [...];
$view_variables = [...];

$factory = new PhpPure\Themer\Factory($map, $theme_variables, $view_variables);

Themes

We're using Laravel's Blade Component to handle the views., _(*6)

PHP Pure has a theme that we could use for documentation, and that is the basic template that we added in the core., _(*7)

$basic = new PhpPure\Themer\Themes\Basic\Basic;
$basic->setViewsDir(__DIR__.'/views');
$basic->setCacheDir(__DIR__.'/views/.cache');

The above code, we instantiated the Basic class, we set the views folder, and also the cache folder., _(*8)

The Basic Theme requires us to inject a theme variables in the factory, we must inject the extension and landing_page., _(*9)

$theme_variables = [
    'extension' => 'html',
    'landing_page' => $map['Prologue']['Setup'],
];

To finalize the factory, check code below., _(*10)

...

$factory->theme($basic);
$factory->generate('public/'); // the folder to generate with

Test

We have a sample tests that your could try out or mimic., _(*11)

Writing your own Theme

I can't write everything here, so maybe let's move on to our wiki., _(*12)