Merge remote-tracking branch 'remotes/upstream/master'

Bumps [symfony/http-foundation](https://github.com/symfony/http-foundation) from 5.0.2 to 5.0.7.
- [Release notes](https://github.com/symfony/http-foundation/releases)
- [Changelog](https://github.com/symfony/http-foundation/blob/master/CHANGELOG.md)
- [Commits](https://github.com/symfony/http-foundation/compare/v5.0.2...v5.0.7)

Signed-off-by: dependabot[bot] <support@github.com>

.github/workflows/php.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ${{ matrix.operating-system }}
 
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v2
 
     - name: Setup PHP
       uses: shivammathur/setup-php@master
@@ -32,10 +32,14 @@ jobs:
     - name: Install dependencies
       run: composer install --prefer-dist --no-progress --no-suggest
 
+    - name: Install tools
+      run: ./scripts/install_tools.sh
+
     - name: Run test suite
       run: composer run-script test
 
-  scrutinizer-ci:
+  sonarcloud:
+    name: "SonarCloud"
     runs-on: ubuntu-latest
     if: github.event_name != 'pull_request'
     steps:
@@ -44,30 +48,38 @@ jobs:
       uses: shivammathur/setup-php@master
       with:
         php-version: 7.4
-        extension-csv: mbstring, xdebug, dom, intl
-        coverage: xdebug
+        extension-csv: mbstring, dom, intl
+        coverage: pcov
 
     - name: Install dependencies
       run: composer install --prefer-dist --no-progress --no-suggest
 
-    - name: Run test suite
-      run: composer run-script test -- --coverage-clover=coverage.clover
+    - name: Install tools
+      run: ./scripts/install_tools.sh
 
-    - run: wget https://scrutinizer-ci.com/ocular.phar
-    - name: Upload code coverage
-      run: php ocular.phar code-coverage:upload --format=php-clover coverage.clover
+    - name: Run test suite
+      run: composer run-script test -- --coverage-clover=coverage.clover --log-junit=test-report.xml
+
+    - name: Fix reports
+      run: scripts/fix_reports.sh
+
+    - name: SonarCloud Scan
+      uses: SonarSource/sonarcloud-github-action@v1.1
+      env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
 
   documentation:
     runs-on: ubuntu-latest
     if: github.repository == 'dauxio/daux.io' && github.event_name != 'pull_request' && github.ref == 'refs/heads/master'
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v2
     - name: Install dependencies
       run: composer install --prefer-dist --no-progress --no-suggest
     - name: Generate documentation
-      run: bin/daux generate
+      run: bin/daux generate --value html.plausible_domain=daux.io
     - uses: JamesIves/github-pages-deploy-action@2.0.3
       env:
         FOLDER: "static"
         BRANCH: gh-pages
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -5,7 +5,11 @@ node_modules
 static
 
 /vendor
+/build
 .phpunit.result.cache
+.php_cs.cache
+coverage.clover
+test-report.xml
 
 /prettier.config.js
 /.eslintrc.js

.php_cs

@@ -0,0 +1,28 @@
+<?php
+
+$finder = PhpCsFixer\Finder::create()
+    ->exclude('vendor')
+    ->exclude('templates')
+    ->in(__DIR__)
+;
+
+return PhpCsFixer\Config::create()
+    ->setRules([
+        '@PSR2' => true,
+        '@PHP70Migration' => true,
+        '@PHP71Migration' => true,
+        '@PhpCsFixer' => true,
+        'explicit_string_variable' => false,
+        'single_blank_line_before_namespace' => false,
+        'no_short_echo_tag' => false,
+        'blank_line_after_opening_tag' => false,
+        'yoda_style' => false,
+        'concat_space' => ['spacing' => 'one'],
+        'php_unit_internal_class' => false,
+        'php_unit_test_class_requires_covers' => false,
+        'phpdoc_align' => false,
+        'multiline_whitespace_before_semicolons' => false,
+        'ordered_class_elements' => ['use_trait', 'constant_public', 'constant_protected', 'constant_private', 'property_public', 'property_protected', 'property_private', 'construct', 'method']
+    ])
+    ->setFinder($finder)
+;

CODE_OF_CONDUCT.md

@@ -14,22 +14,22 @@ appearance, race, religion, or sexual identity and orientation.
 Examples of behavior that contributes to creating a positive environment
 include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+-   Using welcoming and inclusive language
+-   Being respectful of differing viewpoints and experiences
+-   Gracefully accepting constructive criticism
+-   Focusing on what is best for the community
+-   Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
- advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
- address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
- professional setting
+-   The use of sexualized language or imagery and unwelcome sexual attention or
+    advances
+-   Trolling, insulting/derogatory comments, and personal or political attacks
+-   Public or private harassment
+-   Publishing others' private information, such as a physical or electronic
+    address, without explicit permission
+-   Other conduct which could reasonably be considered inappropriate in a
+    professional setting
 
 ## Our Responsibilities
 

Dockerfile

@@ -1,4 +1,4 @@
-FROM composer:1.9.3 AS composer
+FROM composer:1.10.5 AS composer
 
 FROM php:7-stretch
 

README.md

@@ -1,52 +1,48 @@
 # Daux.io
 
-
 [![Latest Version](https://img.shields.io/github/release/dauxio/daux.io.svg?style=flat-square)](https://github.com/dauxio/daux.io/releases)
 [![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](https://github.com/dauxio/daux.io/blob/master/LICENSE.md)
-[![Build Status](https://github.com/dauxio/daux.io/workflows/CI/badge.svg)](https://github.com/dauxio/daux.io/actions)
+![GitHub Workflow Status](https://img.shields.io/github/workflow/status/dauxio/daux.io/CI?style=flat-square)
 [![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/dauxio/daux.io.svg?style=flat-square)](https://scrutinizer-ci.com/g/dauxio/daux.io/code-structure)
 [![Quality Score](https://img.shields.io/scrutinizer/g/dauxio/daux.io.svg?style=flat-square)](https://scrutinizer-ci.com/g/dauxio/daux.io)
 [![Total Downloads](https://img.shields.io/packagist/dt/daux/daux.io.svg?style=flat-square)](https://packagist.org/packages/daux/daux.io)
 
-
 **Daux.io** is a documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly. It helps you create great looking documentation in a developer friendly way.
 
 ## Features
 
-* 100% Mobile Responsive
-* CommonMark compliant (a Markdown specification)
-* Supports Markdown tables
-* Auto created homepage/landing page
-* Auto Syntax Highlighting
-* Auto Generated Navigation
-* 4 Built-In Themes or roll your own
-* Functional, Flat Design Style
-* Shareable/Linkable SEO Friendly URLs
-* Built On Bootstrap
-* No Build Step
-* Git/SVN Friendly
-* Supports Google Analytics and Piwik Analytics
-* Optional code float layout
-* Static Output Generation
+-   100% Mobile Responsive
+-   CommonMark compliant (a Markdown specification)
+-   Supports Markdown tables
+-   Auto created homepage/landing page
+-   Auto Syntax Highlighting
+-   Auto Generated Navigation
+-   4 Built-In Themes or roll your own
+-   Functional, Flat Design Style
+-   Shareable/Linkable SEO Friendly URLs
+-   Built On Bootstrap
+-   No Build Step
+-   Git/SVN Friendly
+-   Supports Google Analytics and Piwik Analytics
+-   Optional code float layout
+-   Static Output Generation
 
 ## Demos
 
 This is a list of sites using Daux.io:
 
-- With a custom theme:
-    * [Crafty](https://swissquote.github.io/crafty)	
-    * [Pixolution flow](https://docs.pixolution.org)
-	* [Soisy](https://doc.soisy.it/)
-    * [Vulkan Tutorial](https://vulkan-tutorial.com)
-	* [3Q](https://docs.3q.video/)
-    * [The Advanced RSS Environment](https://thearsse.com/manual/)
-- With the default Theme
-    * [Daux.io](https://daux.io/)
-	* [DoctrineWatcher](https://dsentker.github.io/WatcherDocumentation/)
-	* [DrupalGap](http://docs.drupalgap.org/8/)
-    * [ICADMIN: An admin panel powered by CodeIgniter.](http://istocode.com/shared/ic-admin/)
-    * [Munee: Standalone PHP 5.3 Asset Optimisation & Manipulation](http://mun.ee)
-    * [Nuntius: A PHP framework for bots](https://roysegall.github.io/nuntius-bot/)
+-   With a custom theme:
+    -   [Crafty](https://swissquote.github.io/crafty)
+    -   [Pixolution flow](https://docs.pixolution.org) \* [Soisy](https://doc.soisy.it/)
+    -   [Vulkan Tutorial](https://vulkan-tutorial.com) \* [3Q](https://docs.3q.video/)
+    -   [The Advanced RSS Environment](https://thearsse.com/manual/)
+-   With the default Theme
+    -   [Daux.io](https://daux.io/)
+        _ [DoctrineWatcher](https://dsentker.github.io/WatcherDocumentation/)
+        _ [DrupalGap](http://docs.drupalgap.org/8/)
+    -   [ICADMIN: An admin panel powered by CodeIgniter.](http://istocode.com/shared/ic-admin/)
+    -   [Munee: Standalone PHP 5.3 Asset Optimisation & Manipulation](http://mun.ee)
+    -   [Nuntius: A PHP framework for bots](https://roysegall.github.io/nuntius-bot/)
 
 Do you use Daux.io? Send me a pull request or open an [issue](https://github.com/dauxio/daux.io/issues) and I will add you to the list.
 
@@ -101,18 +97,18 @@ You must use underscores instead of spaces. Here are some example file names and
 
 **Good:**
 
-* 01_Getting_Started.md = Getting Started
-* API_Calls.md = API Calls
-* 200_Something_Else-Cool.md = Something Else-Cool
-* _5_Ways_to_Be_Happy.md = 5 Ways To Be Happy
+-   01_Getting_Started.md = Getting Started
+-   API_Calls.md = API Calls
+-   200_Something_Else-Cool.md = Something Else-Cool
+-   \_5_Ways_to_Be_Happy.md = 5 Ways To Be Happy
 
 **Bad:**
 
-* File Name With Space.md = FAIL
+-   File Name With Space.md = FAIL
 
 ## Sorting
 
-To sort your files and folders in a specific way, you can prefix them with a number and underscore, e.g. `/docs/01_Hello_World.md` and `/docs/05_Features.md` This will list *Hello World* before *Features*, overriding the default alpha-numeric sorting. The numbers will be stripped out of the navigation and urls. For the file `6 Ways to Get Rich`, you can use `/docs/_6_Ways_to_Get_Rich.md`
+To sort your files and folders in a specific way, you can prefix them with a number and underscore, e.g. `/docs/01_Hello_World.md` and `/docs/05_Features.md` This will list _Hello World_ before _Features_, overriding the default alpha-numeric sorting. The numbers will be stripped out of the navigation and urls. For the file `6 Ways to Get Rich`, you can use `/docs/_6_Ways_to_Get_Rich.md`
 
 ## Landing page
 
@@ -120,9 +116,9 @@ If you want to create a beautiful landing page for your project, simply create a
 
 ```json
 {
-	"title": "Daux.io",
-	"tagline": "The Easiest Way To Document Your Project",
-	"image": "app.png"
+    "title": "Daux.io",
+    "tagline": "The Easiest Way To Document Your Project",
+    "image": "app.png"
 }
 ```
 
@@ -138,33 +134,37 @@ To customize the look and feel of your documentation, you can create a `config.j
 The `config.json` file is a simple JSON object that you can use to change some of the basic settings of the documentation.
 
 ### Title
+
 Change the title bar in the docs
 
 ```json
 {
-	"title": "Daux.io"
+    "title": "Daux.io"
 }
 ```
 
 ### Themes
+
 We have 4 built-in Bootstrap themes. To use one of the themes, just set the `theme` option to one of the following:
 
-* daux-blue
-* daux-green
-* daux-navy
-* daux-red
+-   daux-blue
+-   daux-green
+-   daux-navy
+-   daux-red
 
 ```json
 {
-  "html": { "theme": "daux-green" }
+    "html": { "theme": "daux-green" }
 }
 ```
 
 ### More options
+
 Many other options are available:
-- [Global options](http://daux.io/Configuration/index)
-- [HTML Options](http://daux.io/Configuration/Html_export)
-- [Confluence options](http://daux.io/Configuration/Confluence_upload)
+
+-   [Global options](http://daux.io/Configuration/index)
+-   [HTML Options](http://daux.io/Configuration/Html_export)
+-   [Confluence options](http://daux.io/Configuration/Confluence_upload)
 
 ## Running Remotely
 
@@ -173,7 +173,7 @@ Copy the files from the repo to a web server that can run PHP 7.2.0 or newer.
 ## Running Locally
 
 There are several ways to run the docs locally.
-The recommended way is to run `daux serve` which will execute PHP's embedded server. 
+The recommended way is to run `daux serve` which will execute PHP's embedded server.
 
 By default the server will run at: <a href="http://localhost:8085" target="_blank">http://localhost:8085</a>
 
@@ -193,8 +193,8 @@ daux --source=docs --destination=static
 
 If you have set up a local or remote IIS web site, you may need a `web.config` with:
 
-* A rewrite configuration, for handling clean urls.
-* A mime type handler for less files, if using a custom theme.
+-   A rewrite configuration, for handling clean urls.
+-   A mime type handler for less files, if using a custom theme.
 
 ### Clean URLs
 
@@ -202,20 +202,32 @@ The `web.config` needs an entry for `<rewrite>` under `<system.webServer>`:
 
 ```xml
 <configuration>
-	<system.webServer>
-		<rewrite>
-			<rules>
-				<rule name="Main Rule" stopProcessing="true">
-					<match url=".*" />
-					<conditions logicalGrouping="MatchAll">
-						<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
-						<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
-					</conditions>
-					<action type="Rewrite" url="index.php" appendQueryString="false" />
-				</rule>
-			</rules>
-		</rewrite>
-	</system.webServer>
+    <system.webServer>
+        <rewrite>
+            <rules>
+                <rule name="Main Rule" stopProcessing="true">
+                    <match url=".*" />
+                    <conditions logicalGrouping="MatchAll">
+                        <add
+                            input="{REQUEST_FILENAME}"
+                            matchType="IsFile"
+                            negate="true"
+                        />
+                        <add
+                            input="{REQUEST_FILENAME}"
+                            matchType="IsDirectory"
+                            negate="true"
+                        />
+                    </conditions>
+                    <action
+                        type="Rewrite"
+                        url="index.php"
+                        appendQueryString="false"
+                    />
+                </rule>
+            </rules>
+        </rewrite>
+    </system.webServer>
 </configuration>
 ```
 
@@ -223,7 +235,7 @@ To use clean URLs on IIS 6, you will need to use a custom URL rewrite module, su
 
 ## PHP Requirements
 
-Daux.io is compatible with the [officially supported](https://www.php.net/supported-versions.php) PHP versions;  7.2.0 and up.
+Daux.io is compatible with the [officially supported](https://www.php.net/supported-versions.php) PHP versions; 7.2.0 and up.
 
 ### Extensions
 

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "daux/daux.io",
+    "name": "d3/daux.io",
     "type": "project",
     "license": "MIT",
     "description": "Documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly",
@@ -20,7 +20,6 @@
         "php": ">=7.2",
         "guzzlehttp/guzzle": "~6.0",
         "league/commonmark": "^1.0.0",
-        "league/commonmark-ext-table": "^2.0.0",
         "league/plates": "~3.1",
         "myclabs/deep-copy": "^1.5",
         "scrivo/highlight.php": "^9.15",
@@ -29,7 +28,8 @@
         "symfony/mime": "^5.0",
         "symfony/polyfill-intl-icu": "^1.10",
         "symfony/process": "^5.0",
-        "webuni/front-matter": "^1.0.0"
+        "webuni/front-matter": "^1.0.0",
+        "ext-json": "*"
     },
     "suggest":{
         "ext-intl": "Allows to translate the modified at date"
@@ -43,10 +43,12 @@
         "justinwalsh/daux.io": "*"
     },
     "require-dev": {
-        "phpunit/phpunit": "^8.0",
         "mikey179/vfsstream": "^1.6"
     },
     "scripts": {
-        "test": "phpunit"
+        "test": "build/phpunit",
+        "test:coverage-html": "build/phpunit --coverage-html=build/coverage",
+        "lint": "build/php-cs-fixer fix --config=.php_cs --dry-run -v",
+        "lint:fix": "build/php-cs-fixer fix --config=.php_cs"
     }
 }

daux/d3processor.php

@@ -0,0 +1,192 @@
+<?php
+
+namespace Todaymade\Daux\Extension;
+
+use League\CommonMark\Block\Element\BlockQuote;
+use League\CommonMark\Block\Element\Document;
+use League\CommonMark\Block\Element\Paragraph;
+use League\CommonMark\Environment;
+use League\CommonMark\ElementRendererInterface;
+use League\CommonMark\InlineParserContext;
+use League\CommonMark\HtmlElement;
+use League\CommonMark\Inline\Parser\AbstractInlineParser;
+use League\CommonMark\Block\Renderer\BlockRendererInterface;
+use League\CommonMark\Inline\Renderer\InlineRendererInterface;
+USE League\CommonMark\Block\Element\AbstractBlock;
+USE League\CommonMark\Inline\Element\AbstractInline;
+use League\CommonMark\Inline\Element\Code;
+use League\CommonMark\Inline\Element\Text;
+use League\CommonMark\Util\Configuration;
+use Todaymade\Daux\Daux;
+use Symfony\Component\Console\Output\NullOutput;
+
+class d3Parser extends AbstractInlineParser
+{
+    public function getCharacters() {
+        return ['v', 'V'];
+    }
+
+    public function parse(InlineParserContext $inlineContext)
+    {
+        $cursor = $inlineContext->getCursor();
+
+        if ($cursor->match('/D3/')) {
+            $inlineContext->getContainer()->appendChild(new Code('d3logo'));
+            return true;
+        }
+
+        return false;
+    }
+}
+
+class d3BlockQuoteRenderer implements BlockRendererInterface
+{
+    public function render(AbstractBlock $block, ElementRendererInterface $htmlRenderer, $inTightList = false)
+    {
+        if (!($block instanceof BlockQuote)) {
+            throw new \InvalidArgumentException('Incompatible block type: ' . get_class($block));
+        }
+
+        $attrs = [];
+        foreach ($block->getData('attributes', []) as $key => $value) {
+            $attrs[$key] = $htmlRenderer->escape($value, true);
+        }
+
+        $filling = $htmlRenderer->renderBlocks($block->children());
+
+        if ($filling === '') {
+            return new HtmlElement('blockquote', $attrs, $htmlRenderer->getOption('inner_separator', "\n"));
+        }
+
+        if (stristr($filling, '[!!]')) {
+            $attrs['class'] = isset($attrs['class']) ? $attrs['class'].' alert alert-danger' : 'alert alert-danger';
+            $filling = "<i class='fas fa-exclamation-circle'></i> ".trim(str_replace('[!!]', '', $filling));
+        }
+
+        if (stristr($filling, '[!]')) {
+            $attrs['class'] = isset($attrs['class']) ? $attrs['class'].' alert alert-warning' : 'alert alert-warning';
+            $filling = "<i class='fas fa-exclamation-triangle'></i> ".trim(str_replace('[!]', '', $filling));
+        }
+
+        if (stristr($filling, '[i]')) {
+            $attrs['class'] = isset($attrs['class']) ? $attrs['class'].' alert alert-info' : 'alert alert-info';
+            $filling = "<i class='fas fa-info-circle'></i> ".trim(str_replace('[i]', '', $filling));
+        }
+
+        return new HtmlElement(
+            'blockquote',
+            $attrs,
+            $htmlRenderer->getOption('inner_separator', "\n") . $filling . $htmlRenderer->getOption('inner_separator', "\n")
+        );
+    }
+}
+
+class d3ParagraphRenderer implements BlockRendererInterface
+{
+    public function render(AbstractBlock $block, ElementRendererInterface $htmlRenderer, $inTightList = false)
+    {
+        if (!($block instanceof Paragraph)) {
+            throw new \InvalidArgumentException('Incompatible block type: ' . get_class($block));
+        }
+
+        $pattern1 = '/\[\s*?(.{3,})\s*?\]/Uis';
+        $replace1 = '<span class="navi_element">\\1</span>';
+
+        if ($inTightList) {
+            $content = $htmlRenderer->renderInlines($block->children());
+            $content = preg_replace($pattern1, $replace1, $content);
+
+            return $content;
+        } else {
+            $attrs = [];
+            foreach ($block->getData('attributes', []) as $key => $value) {
+                $attrs[$key] = $htmlRenderer->escape($value, true);
+            }
+
+            $content = $htmlRenderer->renderInlines($block->children());
+            $content = preg_replace($pattern1, $replace1, $content);
+
+            return new HtmlElement('p', $attrs, $content);
+        }
+    }
+}
+
+class d3DocumentRenderer implements BlockRendererInterface
+{
+    public function render(AbstractBlock $block, ElementRendererInterface $htmlRenderer, $inTightList = false)
+    {
+        if (!($block instanceof Document)) {
+            throw new \InvalidArgumentException('Incompatible block type: ' . get_class($block));
+        }
+
+        $wholeDoc = $htmlRenderer->renderBlocks($block->children());
+
+        $output = new NullOutput();
+        $daux = new Daux(Daux::STATIC_MODE, $output);
+
+        foreach ($_SERVER['argv'] as $arg) {
+            if (stristr($arg, '--source=')) {
+                $docsdir = trim(str_replace('--source=', '', $arg));
+                $daux->getParams()->setDocumentationDirectory($docsdir);
+            }
+        }
+
+        $daux->initializeConfiguration();
+
+        $params = $daux->getParams();
+        if (isset($params['variables'])) {
+            $variables = $params['variables'];
+            if (isset($variables) && is_array($variables) && count($variables)) {
+                foreach ($variables as $varname => $varvalue) {
+                    $pattern = '/{\$'.$varname.'}/mU';
+                    $wholeDoc = preg_replace($pattern, $varvalue, $wholeDoc);
+                }
+            }
+        }
+
+        return $wholeDoc === '' ? '' : $wholeDoc . "\n";
+    }
+}
+
+class d3TextRenderer implements InlineRendererInterface
+{
+    /**
+     * @var Configuration
+     */
+    protected $config;
+
+    /**
+     * @param AbstractInline $inline
+     * @param ElementRendererInterface $htmlRenderer
+     * @return HtmlElement|mixed|string
+     * @throws \Todaymade\Daux\Exception
+     */
+    public function render(AbstractInline $inline, ElementRendererInterface $htmlRenderer)
+    {
+        if (!($inline instanceof Text)) {
+            throw new \InvalidArgumentException('Incompatible inline type: ' . get_class($inline));
+        }
+
+        $content = $htmlRenderer->escape($inline->getContent());
+
+        $search = array(
+            'D3', 'D³', 'D&sup3;'
+        );
+        $replace = "<i class='fab fa-d3 d3fa-color-blue'></i>";
+        $content = str_replace($search, $replace, $content);
+
+        return $content;
+    }
+}
+
+class d3processor extends \Todaymade\Daux\Processor
+{
+    public function extendCommonMarkEnvironment(Environment $environment)
+    {
+        // format important and info code blocks
+        $environment->addBlockRenderer('League\CommonMark\Block\Element\BlockQuote', new d3BlockQuoteRenderer());
+        $environment->addBlockRenderer('League\CommonMark\Block\Element\Paragraph',  new d3ParagraphRenderer());
+        $environment->addBlockRenderer('League\CommonMark\Block\Element\Document',  new d3DocumentRenderer());
+        $environment->addInlineRenderer('League\CommonMark\Inline\Element\Text', new d3TextRenderer());
+    }
+}

docs/00_Getting_Started.md

@@ -6,49 +6,48 @@
 
 ### For Authors
 
-* [Auto Generated Navigation / Page sorting](01_Features/Navigation_and_Sorting.md)
-* [Internal documentation links](01_Features/Internal_links.md)
-* [CommonMark compliant](01_Features/CommonMark_compliant.md)
-* [Auto created homepage/landing page](01_Features/Landing_page.md)
-* [Multiple Output Formats](01_Features/Multiple_Output_Formats.md)
-* [Multiple Languages Support](01_Features/Multilanguage.md)
-* [No Build Step](01_Features/Live_mode.md)
-* [Static Output Generation](01_Features/Static_Site_Generation.md)
-* [Table of Contents](01_Features/Table_of_contents.md)
+-   [Auto Generated Navigation / Page sorting](01_Features/Navigation_and_Sorting.md)
+-   [Internal documentation links](01_Features/Internal_links.md)
+-   [CommonMark compliant](01_Features/CommonMark_compliant.md)
+-   [Auto created homepage/landing page](01_Features/Landing_page.md)
+-   [Multiple Output Formats](01_Features/Multiple_Output_Formats.md)
+-   [Multiple Languages Support](01_Features/Multilanguage.md)
+-   [No Build Step](01_Features/Live_mode.md)
+-   [Static Output Generation](01_Features/Static_Site_Generation.md)
+-   [Table of Contents](01_Features/Table_of_contents.md)
 
 ### For Developers
 
-* [Auto Syntax Highlighting](01_Features/Auto_Syntax_Highlight.md)
-* [Extend Daux.io with Processors](01_For_Developers/Creating_a_Processor.md)
-* Full access to the internal API to create new pages programatically
-* Work with pages metadata
+-   [Auto Syntax Highlighting](01_Features/Auto_Syntax_Highlight.md)
+-   [Extend Daux.io with Processors](01_For_Developers/Creating_a_Processor.md)
+-   Full access to the internal API to create new pages programatically
+-   Work with pages metadata
 
 ### For Marketing
 
-* 100% Mobile Responsive
-* 4 Built-In Themes or roll your own
-* Functional, Flat Design Style
-* Optional code float layout
-* Shareable/Linkable SEO Friendly URLs
-* Supports Google Analytics and Piwik Analytics
+-   100% Mobile Responsive
+-   4 Built-In Themes or roll your own
+-   Functional, Flat Design Style
+-   Optional code float layout
+-   Shareable/Linkable SEO Friendly URLs
+-   Supports Google Analytics and Piwik Analytics
 
 ## Demos
 
 This is a list of sites using Daux.io:
 
-- With a custom theme:
-    * [Crafty](https://swissquote.github.io/crafty)	
-    * [Pixolution flow](https://docs.pixolution.org)
-	* [Soisy](https://doc.soisy.it/)
-    * [Vulkan Tutorial](https://vulkan-tutorial.com)
-    * [3Q](https://docs.3q.video/)
-- With the default Theme
-    * [Daux.io](https://daux.io/)
-	* [DoctrineWatcher](https://dsentker.github.io/WatcherDocumentation/)
-	* [DrupalGap](http://docs.drupalgap.org/8/)
-    * [ICADMIN: An admin panel powered by CodeIgniter.](http://istocode.com/shared/ic-admin/)
-    * [Munee: Standalone PHP 5.3 Asset Optimisation & Manipulation](http://mun.ee)
-    * [Nuntius: A PHP framework for bots](https://roysegall.github.io/nuntius-bot/)
+-   With a custom theme:
+    -   [Crafty](https://swissquote.github.io/crafty)
+    -   [Pixolution flow](https://docs.pixolution.org) \* [Soisy](https://doc.soisy.it/)
+    -   [Vulkan Tutorial](https://vulkan-tutorial.com)
+    -   [3Q](https://docs.3q.video/)
+-   With the default Theme
+    -   [Daux.io](https://daux.io/)
+        _ [DoctrineWatcher](https://dsentker.github.io/WatcherDocumentation/)
+        _ [DrupalGap](http://docs.drupalgap.org/8/)
+    -   [ICADMIN: An admin panel powered by CodeIgniter.](http://istocode.com/shared/ic-admin/)
+    -   [Munee: Standalone PHP 5.3 Asset Optimisation & Manipulation](http://mun.ee)
+    -   [Nuntius: A PHP framework for bots](https://roysegall.github.io/nuntius-bot/)
 
 Do you use Daux.io? Send us a pull request or open an [issue](https://github.com/dauxio/daux.io/issues) and I will add you to the list.
 
@@ -81,10 +80,10 @@ docker run --rm -it -w /build -v "$PWD":/build daux/daux.io daux
 
 Any parameter valid in the PHP version is valid in the Docker version
 
-
 ### Writing pages
 
 Creating new pages is very easy:
+
 1. Create a markdown file (`*.md` or `*.markdown`)
 2. Start writing
 
@@ -98,14 +97,14 @@ You must use underscores instead of spaces. Here are some example file names and
 
 **Good:**
 
-* 01_Getting_Started.md = Getting Started
-* API_Calls.md = API Calls
-* 200_Something_Else-Cool.md = Something Else-Cool
-* _5_Ways_to_Be_Happy.md = 5 Ways To Be Happy
+-   01_Getting_Started.md = Getting Started
+-   API_Calls.md = API Calls
+-   200_Something_Else-Cool.md = Something Else-Cool
+-   \_5_Ways_to_Be_Happy.md = 5 Ways To Be Happy
 
 **Bad:**
 
-* File Name With Space.md = FAIL
+-   File Name With Space.md = FAIL
 
 ### See your pages
 
@@ -129,9 +128,9 @@ Upload your files to an apache / nginx server and see your documentation
 
 Daux.io is extendable and comes by default with three export formats:
 
-- Export to HTML, same as the website, but can be hosted without PHP.
-- Export all documentation in a single HTML page
-- Upload to your Atlassian Confluence server.
+-   Export to HTML, same as the website, but can be hosted without PHP.
+-   Export all documentation in a single HTML page
+-   Upload to your Atlassian Confluence server.
 
 [See a detailed feature comparison matrix](01_Features/Multiple_Output_Formats.md)
 
@@ -145,7 +144,7 @@ Now that you got the basics, you can also [see what you can configure](05_Config
 
 ## PHP Requirements
 
-Daux.io is compatible with the [officially supported](https://www.php.net/supported-versions.php) PHP versions;  7.2.0 and up.
+Daux.io is compatible with the [officially supported](https://www.php.net/supported-versions.php) PHP versions; 7.2.0 and up.
 
 ### Extensions
 
@@ -153,7 +152,6 @@ Daux.io needs the following PHP extensions to work : `php-mbstring` and `php-xml
 
 If you encounter an error similar to `utf8_decode() not found` this means that you're missing the `php-xml` package.
 
-
 ## Support
 
 If you need help using Daux.io, or have found a bug, please create an issue on the <a href="https://github.com/dauxio/daux.io/issues" target="_blank">GitHub repo</a>.

docs/01_Features/CommonMark_compliant.md

@@ -1,17 +1,14 @@
-
 As we support CommonMark, a broad range of markdown features is available to you.
 
 Many of the features shown below were known as Github Flavored Markdown.
 
-
-We all like making lists
-------------------------
+## We all like making lists
 
 The above header should be an H2 tag. Now, for a list of fruits:
 
-* Red Apples
-* Purple Grapes
-* Green Kiwifruits
+-   Red Apples
+-   Purple Grapes
+-   Green Kiwifruits
 
 Let's get crazy:
 
@@ -27,18 +24,17 @@ Let's get crazy:
 
 What about some code **in** a list? That's insane, right?
 
-1. In Ruby you can map like this:
+1.  In Ruby you can map like this:
 
         ['a', 'b'].map { |x| x.uppercase }
 
-2. In Rails, you can do a shortcut:
+2.  In Rails, you can do a shortcut:
 
         ['a', 'b'].map(&:uppercase)
 
 Some people seem to like definition lists
 
-I am a robot
-------------
+## I am a robot
 
 Maybe you want to print `robot` to the console 1000 times. Why not?
 
@@ -54,8 +50,7 @@ How about we throw some angle braces and ampersands in there?
         © 2004 Foo Corporation
     </div>
 
-Set in stone
-------------
+## Set in stone
 
 Preformatted blocks are useful for ASCII art:
 
@@ -73,8 +68,7 @@ Preformatted blocks are useful for ASCII art:
   ___|_____________
 </pre>
 
-Playing the blame game
-----------------------
+## Playing the blame game
 
 If you need to blame someone, the best way to do so is by quoting them:
 
@@ -92,26 +86,23 @@ Or perhaps someone a little less eloquent:
 > just put me under the spot here, and maybe I'm not as quick on my feet
 > as I should be in coming up with one.
 
-Table for two
--------------
+## Table for two
 
-ID |  Name  | Rank
----|:------:|------:
-1  | Tom Preston-Werner | Awesome
-2  | Albert Einstein | Nearly as awesome
+| ID  |        Name        |              Rank |
+| --- | :----------------: | ----------------: |
+| 1   | Tom Preston-Werner |           Awesome |
+| 2   |  Albert Einstein   | Nearly as awesome |
 
-Crazy linking action
---------------------
+## Crazy linking action
 
-I get 10 times more traffic from [Google] [1] than from
-[Yahoo] [2] or [MSN] [3].
+I get 10 times more traffic from [Google][1] than from
+[Yahoo][2] or [MSN][3].
 
-  [1]: http://google.com/        "Google"
-  [2]: http://search.yahoo.com/  "Yahoo Search"
-  [3]: http://search.msn.com/    "MSN Search"
+[1]: http://google.com/ "Google"
+[2]: http://search.yahoo.com/ "Yahoo Search"
+[3]: http://search.msn.com/ "MSN Search"
 
-Images
-------
+## Images
 
 Here's an image.
 
@@ -119,4 +110,4 @@ Here's an image.
 
 Note: to use images on a landing page (index.md), prefix the image URL with the name of the directory it appears in, omitting the numerical prefix used to order the sections. For example in this section, to display this image on the landing page (index.md), the URL for the image would be "Features/sampleimage.png" to display the same image.
 
-*View the [source of this content](https://github.com/dauxio/daux.io/blob/master/docs/01_Features/CommonMark_compliant.md).*
+_View the [source of this content](https://github.com/dauxio/daux.io/blob/master/docs/01_Features/CommonMark_compliant.md)._

docs/01_Features/Edit_on_GitHub_links.md

@@ -1,4 +1,3 @@
-
 As you can see on the top of this page, you can add "Edit on Github" links to your pages, this feature can be enabled with a single parameter.
 
 The value has to be the path to the root of your documentation folder in your repository.
@@ -7,12 +6,11 @@ In the value you see below, Daux's documentation is in the `docs` folder in the
 
 Daux.io will handle the rest
 
-
 ```json
 {
-  "html": {
-    "edit_on_github": "dauxio/daux.io/blob/master/docs"
-  }
+    "html": {
+        "edit_on_github": "dauxio/daux.io/blob/master/docs"
+    }
 }
 ```
 
@@ -22,14 +20,13 @@ While GitHub is the most popular, it isn't the only, collaborative VCS out there
 
 As long as you can refer your files by a URL, you can create an edit link for your VCS with the following configuration:
 
-
 ```json
 {
-  "html": {
-    "edit_on": {
-      "name": "Bitbucket",
-      "basepath": "https://bitbucket.org/dauxio/daux.io/src/master/docs"
+    "html": {
+        "edit_on": {
+            "name": "Bitbucket",
+            "basepath": "https://bitbucket.org/dauxio/daux.io/src/master/docs"
+        }
     }
-  }
 }
 ```

docs/01_Features/Landing_page.md

@@ -2,9 +2,9 @@ If you want to create a beautiful landing page for your project, create a `_inde
 
 ```json
 {
-  "title": "Daux.io",
-  "tagline": "The Easiest Way To Document Your Project",
-  "image": "app.png"
+    "title": "Daux.io",
+    "tagline": "The Easiest Way To Document Your Project",
+    "image": "app.png"
 }
 ```
 
@@ -14,8 +14,8 @@ To disable the automatic landing page, you can set `auto_landing` to false in th
 
 ```json
 {
-  "html": {
-    "auto_landing": false
-  }
+    "html": {
+        "auto_landing": false
+    }
 }
 ```

docs/01_Features/Live_mode.md

@@ -10,7 +10,6 @@ The easiest is to use PHP's built-in server.
 
 For that i've included a short command, run `daux serve` in the projects folder to start the local web server. By default the server will run at: <a href="http://localhost:8085" target="_blank">http://localhost:8085</a>
 
-
 ## Running Remotely
 
 ### Clean URLs configuration
@@ -20,9 +19,9 @@ To enable the same, set the toggle in the `config.json` file in the `/docs` fold
 
 ```json
 {
-  "live": {
-    "clean_urls": true
-  }
+    "live": {
+        "clean_urls": true
+    }
 }
 ```
 
@@ -70,8 +69,8 @@ server {
 
 If you have set up a local or remote IIS web site, you may need a `web.config` with:
 
-* A rewrite configuration, for handling clean urls.
-* A mime type handler for less files, if using a custom theme.
+-   A rewrite configuration, for handling clean urls.
+-   A mime type handler for less files, if using a custom theme.
 
 ### Clean URLs
 
@@ -79,20 +78,32 @@ The `web.config` needs an entry for `<rewrite>` under `<system.webServer>`:
 
 ```xml
 <configuration>
-	<system.webServer>
-		<rewrite>
-			<rules>
-				<rule name="Main Rule" stopProcessing="true">
-					<match url=".*" />
-					<conditions logicalGrouping="MatchAll">
-						<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
-						<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
-					</conditions>
-					<action type="Rewrite" url="index.php" appendQueryString="false" />
-				</rule>
-			</rules>
-		</rewrite>
-	</system.webServer>
+    <system.webServer>
+        <rewrite>
+            <rules>
+                <rule name="Main Rule" stopProcessing="true">
+                    <match url=".*" />
+                    <conditions logicalGrouping="MatchAll">
+                        <add
+                            input="{REQUEST_FILENAME}"
+                            matchType="IsFile"
+                            negate="true"
+                        />
+                        <add
+                            input="{REQUEST_FILENAME}"
+                            matchType="IsDirectory"
+                            negate="true"
+                        />
+                    </conditions>
+                    <action
+                        type="Rewrite"
+                        url="index.php"
+                        appendQueryString="false"
+                    />
+                </rule>
+            </rules>
+        </rewrite>
+    </system.webServer>
 </configuration>
 ```
 
@@ -114,4 +125,4 @@ ENTRYPOINT [ "php", "-S", "0.0.0.0:80", "index.php" ]
 
 When you add this to a `Dockerfile` and run `docker build --name my-daux-doc .` and then `docker --rm run -p 8000:80 my-daux-doc`
 
-You can access your documentation at `localhost:8000`
+You can access your documentation at `localhost:8000`

docs/01_Features/Multilanguage.md

@@ -4,11 +4,12 @@ Add this to your config.json :
 
 ```json
 {
-  "languages": { "en": "English", "de": "German" }
+    "languages": { "en": "English", "de": "German" }
 }
 ```
 
 You will the need separate directories for each language in `docs/` folder.
+
 ```
 ├── docs/
 │   ├── _index.md

docs/01_Features/Multiple_Output_Formats.md

@@ -1,21 +1,21 @@
 Daux.io is extendable and comes by default with three export formats:
 
-- Export to HTML
-- Export all documentation in a single HTML page
-- Upload to your Atlassian Confluence server
+-   Export to HTML
+-   Export all documentation in a single HTML page
+-   Upload to your Atlassian Confluence server
 
 ## Feature Matrix
 
-Feature        | HTML | Single Page HTML | Confluence
---------------:|:----:|:----------------:|:----------:
-Multilanguage  | √    | X (Planned)      | X
-Landing Pages  | √    | X                | X
-Index Pages    | √    | √                | √
-Internal Links | √    | X (Planned)      | √
-Code Highlight | √    | X (Planned)      | √ (Using macros)
-Live Mode      | √    | X                | X
-Pages Ordering | √    | √                | X (API Limitation)
-Google / Piwik analytics | √ | √         | √ (Configured on Conflence)
+|                  Feature | HTML | Single Page HTML |         Confluence          |
+| -----------------------: | :--: | :--------------: | :-------------------------: |
+|            Multilanguage |  √   |   X (Planned)    |              X              |
+|            Landing Pages |  √   |        X         |              X              |
+|              Index Pages |  √   |        √         |              √              |
+|           Internal Links |  √   |   X (Planned)    |              √              |
+|           Code Highlight |  √   |   X (Planned)    |      √ (Using macros)       |
+|                Live Mode |  √   |        X         |              X              |
+|           Pages Ordering |  √   |        √         |     X (API Limitation)      |
+| Google / Piwik analytics |  √   |        √         | √ (Configured on Conflence) |
 
 ## Confluence Example
 

docs/01_Features/Navigation_and_Sorting.md

@@ -1,4 +1,3 @@
-
 ## Navigation
 
 The navigation is generated automatically with all pages that end with `.md` or `.markdown`
@@ -12,21 +11,21 @@ For example, `/docs/02_Examples` has a landing page for that section since there
 ## Sorting
 
 To sort your files and folders in a specific way, you can prefix them with a number and underscore, e.g. `/docs/01_Hello_World.md` and `/docs/05_Features.md`.
-This will list *Hello World* before *Features*, overriding the default alpha-numeric sorting.
+This will list _Hello World_ before _Features_, overriding the default alpha-numeric sorting.
 The numbers will be stripped out of the navigation and urls. For the file `6 Ways to Get Rich`, you can use `/docs/_6_Ways_to_Get_Rich.md`
 
 You might also wish to stick certain links to the bottom of a page.
-You can do so by prefixing the file name with a '-', e.g. a new file `/docs/-Contact_Us.md` will always appear at the bottom of the current list. 
+You can do so by prefixing the file name with a '-', e.g. a new file `/docs/-Contact_Us.md` will always appear at the bottom of the current list.
 Weights can also be added to further sort the bottom entries. e.g. `/docs/-01_Coming.md` will appear before `/docs/-02_Soon.md` but both will only appear after all positive or non-weighted files.
 
 It works the same for files prefixed with `+`.
 
 Page order priorities are like this:
 
-- `+` in front of the filename and numbers in front
-- `+` in front of the filename
-- The index page
-- Numbers in the front
-- Pages without prefix
-- `-` in front of the filename and numbers in front
-- `-` in front of the filename
+-   `+` in front of the filename and numbers in front
+-   `+` in front of the filename
+-   The index page
+-   Numbers in the front
+-   Pages without prefix
+-   `-` in front of the filename and numbers in front
+-   `-` in front of the filename

docs/01_Features/Search.md

@@ -6,8 +6,8 @@ To enable the generated search, you can set `search` to true in the `html` secti
 
 ```json
 {
-  "html": {
-    "search": true
-  }
+    "html": {
+        "search": true
+    }
 }
 ```

docs/01_Features/Static_Site_Generation.md

@@ -1,9 +1,8 @@
+If you don't want to serve the live version of your site, you can also generate files, these can be one of the three supported formats :
 
-If you  don't want to serve the live version of your site, you can also generate files, these can be one of the three supported formats :
-
-- HTML output
-- Single page HTML output
-- Atlassian Confluence upload
+-   HTML output
+-   Single page HTML output
+-   Atlassian Confluence upload
 
 Generating a complete set of pages, with navigation
 
@@ -13,7 +12,7 @@ daux --destination=[Output Directory Relative Direction]
 
 ## Options
 
-For more options, run 
+For more options, run
 
 ```bash
 daux generate --help
@@ -32,7 +31,7 @@ daux --format=html
 
 ### Specify a processor
 
-A processor can be specified through the  `--processor` option, this should be the name of a class inside the `Todaymade\Daux\Extension` namespace.
+A processor can be specified through the `--processor` option, this should be the name of a class inside the `Todaymade\Daux\Extension` namespace.
 
 By running :
 

docs/01_Features/Table_of_contents.md

@@ -18,10 +18,8 @@ You can enable this feature in your configuration
 
 ```json
 {
-  "html": {
-    "auto_toc": true
-  }
+    "html": {
+        "auto_toc": true
+    }
 }
 ```
-
-

docs/02_Examples/index.md

@@ -1,2 +1,3 @@
 ### This is a landing page for the Examples section
-Adding a landing page is pretty simple, all you need to do is add an "index.md" file to the related folder.
+
+Adding a landing page is pretty simple, all you need to do is add an "index.md" file to the related folder.

docs/05_Configuration/Confluence_upload.md

@@ -1,21 +1,23 @@
-__Table of contents__
+**Table of contents**
 
 [TOC]
 
 ## Configuring the connection
+
 The connection requires three parameters `base_url`, `user` and `pass`. While `user` and `pass` don't really need an explanation, for `base_url` you need to set the path to the server without `rest/api`, this will be added automatically.
 
 ```json
 {
-  "confluence": {
-    "base_url": "http://my_confluence_server.com/",
-    "user" : "my_username",
-    "pass" : "my_password" 
-  }
+    "confluence": {
+        "base_url": "http://my_confluence_server.com/",
+        "user": "my_username",
+        "pass": "my_password"
+    }
 }
 ```
 
 ## Where to upload
+
 Now that the connection is defined, you need to tell it where you want your documentation to be uploaded.
 
 For that you need a `space_id` (name that appears at the beginning of the urls) and an `ancestor_id`; the id of the page that will be the parent of the documentation's homepage.
@@ -24,10 +26,10 @@ You can obtain the `ancestor_id` id by editing the page you want to define as a
 
 ```json
 {
-  "confluence": {
-    "space_id": "my_space",
-    "ancestor_id": 50370632
-  }
+    "confluence": {
+        "space_id": "my_space",
+        "ancestor_id": 50370632
+    }
 }
 ```
 
@@ -36,20 +38,22 @@ You can also provide a `root_id` instead of an `ancestor_id` in this case, you s
 You can use that when you're uploading your documentation to the root of a Confluence Space or if your page already exists.
 
 ## Prefix
+
 Because confluence can't have two pages with the same name in a space, I recommend you define a prefix for your pages.
 
 ```json
 {
-  "confluence": { "prefix": "DAUX -" }
+    "confluence": { "prefix": "DAUX -" }
 }
 ```
 
 ## Update threshold
+
 To make the upload quicker, we try to determine if a page changed or not, first with a strict comparison and if it's not completely identical, we compute the difference.
 
 ```json
 {
-  "confluence": { "update_threshold": 1 }
+    "confluence": { "update_threshold": 1 }
 }
 ```
 
@@ -59,22 +63,22 @@ By default the threshold is 2%.
 
 Setting the value to `0` disables the feature altogether.
 
-
 ## Delete old pages
+
 When a page is renamed, there is no way to tell it was renamed, so when uploading to Confluence, the page will be uploaded and the old page will stay here.
 
 By default, it will inform you that some pages aren't needed anymore and you can delete them by hand.
 
 ```json
 {
-  "confluence": { "delete": true }
+    "confluence": { "delete": true }
 }
 ```
 
 By setting `delete` to `true` (or running `daux` with the `--delete` flag) you tell the generator that it can safely delete the pages.
 
-
 ## Information message
+
 When you create your page. there is no indication that the upload process will override the content of the pages.
 
 It happens sometimes that users edit the pages to add / fix an information.
@@ -83,9 +87,9 @@ You can add a text in a "information" macro on top of the document by setting th
 
 ```json
 {
-  "confluence": {
-    "header": "These pages are updated automatically, your changes will be overriden."
-  }
+    "confluence": {
+        "header": "These pages are updated automatically, your changes will be overriden."
+    }
 }
 ```
 

docs/05_Configuration/Html_export.md

@@ -1,24 +1,26 @@
-__Table of contents__
+**Table of contents**
 
 [TOC]
 
 ## Analytics
 
 ### Google Analytics
+
 This will embed the google analytics tracking code.
 
 ```json
 {
-  "html": { "google_analytics": "UA-XXXXXXXXX-XX" }
+    "html": { "google_analytics": "UA-XXXXXXXXX-XX" }
 }
 ```
 
 ### Piwik Analytics
+
 This will embed the piwik tracking code.
 
 ```json
 {
-  "html": { "piwik_analytics": "my-url-for-piwik.com" }
+    "html": { "piwik_analytics": "my-url-for-piwik.com" }
 }
 ```
 
@@ -26,110 +28,130 @@ You can Also give a specific Piwik ID as well.
 
 ```json
 {
-  "html": { "piwik_analytics_id": "43" }
+    "html": { "piwik_analytics_id": "43" }
+}
+```
+
+### Plausible Analytics
+
+This will embed the https://plausible.io/ tracking code.
+
+```json
+{
+    "html": { "plausible_domain": "daux.io" }
 }
 ```
 
 ## Automatic Table of Contents
+
 You can add a table of contents on each page automatically, read about it [here](../01_Features/Table_of_contents.md)
 
-
 ## Buttons
+
 You can add buttons to the landing page.
 
 ```json
 {
-  "html": {
-    "buttons": {
-       "My Website": "http://example.com"
+    "html": {
+        "buttons": {
+            "My Website": "http://example.com"
+        }
     }
-  }
 }
 ```
 
 ## Breadcrumb titles
-Daux.io provides the option to present page titles as breadcrumb navigation. 
-You can *optionally* specify the separator used for breadcrumbs.
+
+Daux.io provides the option to present page titles as breadcrumb navigation.
+You can _optionally_ specify the separator used for breadcrumbs.
 
 ```json
 {
-  "html": {
-    "breadcrumbs": true,
-    "breadcrumb_separator" : " > "
-  }
+    "html": {
+        "breadcrumbs": true,
+        "breadcrumb_separator": " > "
+    }
 }
 ```
 
 ## Date Modified
-By default, daux.io will display the last modified time as reported by the system underneath the title for each document. 
+
+By default, daux.io will display the last modified time as reported by the system underneath the title for each document.
 To disable this, change the option in your config.json to `false`.
 
 ```json
 {
-  "html": { "date_modified": false }
+    "html": { "date_modified": false }
 }
 ```
 
 ## GitHub Repo
+
 Add a 'Fork me on GitHub' ribbon.
 
 ```json
 {
-  "html": { "repo": "dauxio/daux.io" }
+    "html": { "repo": "dauxio/daux.io" }
 }
 ```
 
 ## Inherit Index
+
 This feature will instructs the navigation generator to seek the first available file to use when there is no index in a folder.
 
 ```json
 {
-  "html": { "inherit_index": true }
+    "html": { "inherit_index": true }
 }
 ```
 
 ## Jump buttons
+
 You can have previous/next buttons on each page.
 They can be disabled by setting `jump_buttons` to `false`.
 
 ```json
 {
-  "html": { "jump_buttons": false }
+    "html": { "jump_buttons": false }
 }
 ```
 
 ## Landing page
-The automatic landing page can be disabled through the `auto_landing` option, read about it [here](../01_Features/Landing_page.md) 
+
+The automatic landing page can be disabled through the `auto_landing` option, read about it [here](../01_Features/Landing_page.md)
 
 ## Links
+
 Include custom links in the sidebar.
 
 ```json
 {
-  "html": {
-    "links": {
-      "GitHub Repo": "https://github.com/dauxio/daux.io",
-      "Help/Support/Bugs": "https://github.com/dauxio/daux.io/issues",
-      "Made by Todaymade": "http://todaymade.com"
+    "html": {
+        "links": {
+            "GitHub Repo": "https://github.com/dauxio/daux.io",
+            "Help/Support/Bugs": "https://github.com/dauxio/daux.io/issues",
+            "Made by Todaymade": "http://todaymade.com"
+        }
     }
-  }
 }
 ```
 
 ## Search
+
 Daux has an embedded search engine read all about it [here](../01_Features/Search.md)
 
 ## Themes
+
 We have 4 built-in Bootstrap themes. To use one of the themes, just set the `theme` option to one of the following:
 
-* daux-blue
-* daux-green
-* daux-navy
-* daux-red
+-   daux-blue
+-   daux-green
+-   daux-navy
+-   daux-red
 
 ```json
 {
-  "html": { "theme": "daux-blue" }
+    "html": { "theme": "daux-blue" }
 }
 ```
 
@@ -137,25 +159,27 @@ To use a custom theme, just copy over the theme folder into the `themes` directo
 
 ```json
 {
-  "html": { "theme": "new-theme" }
+    "html": { "theme": "new-theme" }
 }
 ```
 
 ## Toggling Code Blocks
-Some users might wish to hide the code blocks & view just the documentation. 
+
+Some users might wish to hide the code blocks & view just the documentation.
 By setting the `toggle_code` property to `true`, you can offer a toggle button on the page.
 
 ```json
 {
-  "html": { "toggle_code": true }
+    "html": { "toggle_code": true }
 }
 ```
 
 ## Twitter
+
 Include twitter follow buttons in the sidebar.
 
 ```json
 {
-  "html": { "twitter": ["justin_walsh", "todaymade"] }
+    "html": { "twitter": ["justin_walsh", "todaymade"] }
 }
 ```

docs/05_Configuration/_index.md

@@ -1,91 +1,100 @@
 To customize the look and feel of your documentation, you can create a `config.json` file in the of the `/docs` folder. The `config.json` file is a JSON object that you can use to change some of the basic settings of the documentation.
 
-__Table of contents__
+**Table of contents**
 
 [TOC]
 
 ### Title
+
 Change the title bar in the docs
 
 ```json
 {
-  "title": "Daux.io"
+    "title": "Daux.io"
 }
 ```
 
 ### Tagline
+
 Change the tagline bar in the docs
 
 ```json
 {
-  "tagline": "The Easiest Way To Document Your Project"
+    "tagline": "The Easiest Way To Document Your Project"
 }
 ```
 
 ### Author
+
 Change the documentation's author
 
 ```json
 {
-  "author": "Stéphane Goetz"
+    "author": "Stéphane Goetz"
 }
 ```
 
 ### Image
+
 An image to show on the landing page. A relative path from the documentation root.
 
 ```json
 {
-  "image": "image.png"
+    "image": "image.png"
 }
 ```
 
 ### Format
+
 Change the output format. It is recommended you set only formats that support the live mode as this will also
 be read by the integrated web server. And you set the other formats (like confluence) only by command line
 
 ```json
 {
-  "format": "html"
+    "format": "html"
 }
 ```
 
-- __html__ with [its options](./Html_export.md)
-- __confluence__ with [its options](./Confluence_upload.md)
+-   **html** with [its options](./Html_export.md)
+-   **confluence** with [its options](./Confluence_upload.md)
 
-Available formats are __HTML__ and __Confluence__
+Available formats are **HTML** and **Confluence**
 
 ### Ignore
+
 Set custom files and entire folders to ignore within your `/docs` folder. For files make sure to include the file extension in the name. For both files and folders, names are case-sensitive.
 
 ```json
 {
-  "ignore": {
-    "files": ["Work_In_Progress.md"],
-    "folders": ["99_Not_Ready"]
-  }
+    "ignore": {
+        "files": ["Work_In_Progress.md"],
+        "folders": ["99_Not_Ready"]
+    }
 }
 ```
 
 ### Timezone
+
 If your server does not have a default timezone set in php.ini, it may return errors when it tries to generate the last modified date/time for docs. To fix these errors, specify a timezone in your config file. Valid options are available in the [PHP Manual](http://php.net/manual/en/timezones.php).
 
 ```json
 {
-  "timezone": "America/Los_Angeles"
+    "timezone": "America/Los_Angeles"
 }
 ```
 
 ### Multi-language
+
 Enables multi-language support which needs separate directories for each language in `docs/` folder.
 
 ```json
 {
-  "languages": {"en": "English", "de": "German"}
+    "languages": { "en": "English", "de": "German" }
 }
 ```
 
 Directory structure:
+
 ```
 ├── docs/
 │   ├── _index.md
@@ -113,7 +122,7 @@ You can change the default language with the `language` option.
 
 ```json
 {
-  "language": "fr"
+    "language": "fr"
 }
 ```
 
@@ -124,27 +133,28 @@ A string that isn't found will fall back to english.
 
 ```json
 {
-  "strings": {
-    "fr": {
-      "CodeBlocks_show": "Afficher le code",
-      "Search_placeholder": "Rechercher...",
-      "Link_previous": "Précédent",
-      "Link_next": "Suivant",
-      "Edit_on": "Editer sur :name:",
-      "View_on_github": "Voir sur GitHub",
-      "View_documentation": "Voir la Documentation"
+    "strings": {
+        "fr": {
+            "CodeBlocks_show": "Afficher le code",
+            "Search_placeholder": "Rechercher...",
+            "Link_previous": "Précédent",
+            "Link_next": "Suivant",
+            "Edit_on": "Editer sur :name:",
+            "View_on_github": "Voir sur GitHub",
+            "View_documentation": "Voir la Documentation"
+        }
     }
-  }
 }
 ```
 
 ### Processor
+
 You can set the processor in the documentation or as an option to the command line. If you need it when running the server, you should add it to the configuration.
 
 More information on how to create a Processor can be found [here](!For_Developers/Creating_a_Processor).
- 
+
 ```json
 {
-  "processor": "MyProcessor"
+    "processor": "MyProcessor"
 }
 ```

docs/10_For_Developers/Creating_a_Processor.md

@@ -7,7 +7,7 @@ The main advantage, is that you can run it with the source or with `daux` indepe
 Next to your `docs` directory, you can create a `daux` directory that can contain your Processor.
 
 The classes must respect the PSR-4 Naming convention. And have `\Todaymade\Daux\Extension` as a base namespace.
- 
+
 By default, we created a `daux/Processor.php` file to get you started.
 
 ## A quick test ?
@@ -40,7 +40,7 @@ There are a few methods that you can override to add some
 
 By default, Daux.io parses your directory to find pages. but, for a reason or another, you might want to programmatically add some pages.
 
-This can be done with: 
+This can be done with:
 
 ```php
 public function manipulateTree(Root $root)
@@ -65,7 +65,7 @@ Both methods `getOrCreateDir` and `getOrCreatePage` take two parameters : `paren
 The page will automatically be treated as markdown and converted like a normal page.
 
 If you create a new ContentType, like let's say LaTeX, you would set the title `My Page.tex` it will keep the title `My Page` and use your renderer.
-  
+
 If the extension is not mapped to a Generator, it will simply create the file as-is without manipulation.
 
 ### Extend the Markdown Generator
@@ -82,9 +82,9 @@ See the details on [CommonMark's website](http://commonmark.thephpleague.com/cus
 
 ### Add new generators
 
-You can add new generators to Daux.io and use them right away, they must implement the 
-`\Todaymade\Daux\Format\Base\Generator` interface and if you want to use the live mode with your generator 
-you have to implement `\Todaymade\Daux\Format\Base\LiveGenerator`. 
+You can add new generators to Daux.io and use them right away, they must implement the
+`\Todaymade\Daux\Format\Base\Generator` interface and if you want to use the live mode with your generator
+you have to implement `\Todaymade\Daux\Format\Base\LiveGenerator`.
 
 ```php
 public function addGenerators()
@@ -92,4 +92,3 @@ public function addGenerators()
     return ['custom_generator' => '\Todaymade\Daux\Extension\MyNewGenerator'];
 }
 ```
-

docs/10_For_Developers/Creating_a_Theme.md

@@ -2,49 +2,56 @@ In its simplest form, a theme is an empty folder with a `config.json` file conta
 
 After that, every setting is optional, but you can override everything if you'd like to.
 
+> **Overriding styles**
+>
+> If you want to tweak a few styles, you can create a `style.css` file at the root of your documentation 
+> directory and it will be included automatically. By doing this, you don't need to create a new theme.
+
 ## `config.json` options
 
 Here is an example `config.json` file :
 
 ```json
 {
-  "favicon": "<theme_url>img/favicon.png",
-  "css": ["<theme_url>css/theme.min.css"],
-  "js": [],
-  "fonts": ["https://fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic"],
-  "variants": {
-    "blue": {
-      "favicon": "<theme_url>img/favicon-blue.png",
-      "css": ["<theme_url>css/theme-blue.min.css"]
-    },
-    "green": {
-      "favicon": "<theme_url>img/favicon-green.png",
-      "css": ["<theme_url>css/theme-green.min.css"]
+    "favicon": "<theme_url>img/favicon.png",
+    "css": ["<theme_url>css/theme.min.css"],
+    "js": [],
+    "fonts": [
+        "https://fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic"
+    ],
+    "variants": {
+        "blue": {
+            "favicon": "<theme_url>img/favicon-blue.png",
+            "css": ["<theme_url>css/theme-blue.min.css"]
+        },
+        "green": {
+            "favicon": "<theme_url>img/favicon-green.png",
+            "css": ["<theme_url>css/theme-green.min.css"]
+        }
     }
-  }
 }
 ```
 
 There are five options :
 
-- __`favicon`__: The URL to your favicon
-- __`css`__: An array of CSS Stylesheets to add to the page
-- __`js`__: An array of JavaScript files to load
-- __`fonts`__: An array of Font sources, these are added as stylesheets
-- __`variants`__: An object containing sub-themes. Each sub theme, can provide the same configurations as the main theme (`favicon`, `css`, `js`, `fonts`) 
+-   **`favicon`**: The URL to your favicon
+-   **`css`**: An array of CSS Stylesheets to add to the page
+-   **`js`**: An array of JavaScript files to load
+-   **`fonts`**: An array of Font sources, these are added as stylesheets
+-   **`variants`**: An object containing sub-themes. Each sub theme, can provide the same configurations as the main theme (`favicon`, `css`, `js`, `fonts`)
 
-
-You will also notice this `<theme_url>` in the url. 
+You will also notice this `<theme_url>` in the url.
 This is automatically substituted with the final url to the theme when generating the final page.
 
 There are two possible substitutions :
- - __`<theme_url>`__: The url to the current theme
- - __`<base_url>`__: The url to the documentation root
- 
+
+-   **`<theme_url>`**: The url to the current theme
+-   **`<base_url>`**: The url to the documentation root
+
 ## Theme variants
- 
+
 Like the default Daux.io theme, you might want to provide variants of your theme.
- 
+
 In the example before, there were two variants : blue and green.
 
 The configuration of a variant is added to the configuration of the main theme, it doesn't replace it.
@@ -63,10 +70,10 @@ Change the `theme` option inside `html`
 
 ```json
 {
-  "themes_directory": "/home/user/themes",
-  "html": {
-    "theme": "{theme}-{variant}"
-  }
+    "themes_directory": "/home/user/themes",
+    "html": {
+        "theme": "{theme}-{variant}"
+    }
 }
 ```
 
@@ -85,11 +92,12 @@ You can create a folder named `templates` in your theme, copy-paste the original
 You can even do it one template at a time if you wish to do only small changes.
 
 By default, we have the following templates :
-- `content.php`: The content page.
-- `home.php`: The landing page.
-- `error.php`: The page to show when a page is not found or some other error happened.
-- `partials/navbar_content.php`: The content of the top navigation bar.
-- `partials/google_analytics.php`: The script to load Google Analytics.
-- `partials/piwik_analytics.php`: The script to load Piwik Analytics.
-- `layout/00_layout.php`: The master template, containing the `<html>` tag.
-- `layout/05_page.php`: The page layout, with left navigation.
+
+-   `content.php`: The content page.
+-   `home.php`: The landing page.
+-   `error.php`: The page to show when a page is not found or some other error happened.
+-   `partials/navbar_content.php`: The content of the top navigation bar.
+-   `partials/google_analytics.php`: The script to load Google Analytics.
+-   `partials/piwik_analytics.php`: The script to load Piwik Analytics.
+-   `layout/00_layout.php`: The master template, containing the `<html>` tag.
+-   `layout/05_page.php`: The page layout, with left navigation.

docs/_index.md

@@ -13,37 +13,37 @@
 
 #### For Authors
 
-* [Auto Generated Navigation / Page sorting](01_Features/Navigation_and_Sorting.md)
-* [Internal documentation links](01_Features/Internal_links.md)
-* [CommonMark compliant](01_Features/CommonMark_compliant.md)
-* [Auto created homepage/landing page](01_Features/Landing_page.md)
-* [Multiple Output Formats](01_Features/Multiple_Output_Formats.md)
-* [Multiple Languages Support](01_Features/Multilanguage.md)
-* [No Build Step](01_Features/Live_mode.md)
-* [Static Output Generation](01_Features/Static_Site_Generation.md)
-* [Table of Contents](01_Features/Table_of_contents.md)
+-   [Auto Generated Navigation / Page sorting](01_Features/Navigation_and_Sorting.md)
+-   [Internal documentation links](01_Features/Internal_links.md)
+-   [CommonMark compliant](01_Features/CommonMark_compliant.md)
+-   [Auto created homepage/landing page](01_Features/Landing_page.md)
+-   [Multiple Output Formats](01_Features/Multiple_Output_Formats.md)
+-   [Multiple Languages Support](01_Features/Multilanguage.md)
+-   [No Build Step](01_Features/Live_mode.md)
+-   [Static Output Generation](01_Features/Static_Site_Generation.md)
+-   [Table of Contents](01_Features/Table_of_contents.md)
 
 </div>
 <div class="Row__third">
 
 #### For Developers
 
-* [Auto Syntax Highlighting](01_Features/Auto_Syntax_Highlight.md)
-* [Extend Daux.io with Processors](01_For_Developers/Creating_a_Processor.md)
-* Full access to the internal API to create new pages programatically
-* Work with pages metadata
+-   [Auto Syntax Highlighting](01_Features/Auto_Syntax_Highlight.md)
+-   [Extend Daux.io with Processors](01_For_Developers/Creating_a_Processor.md)
+-   Full access to the internal API to create new pages programatically
+-   Work with pages metadata
 
 </div>
 <div class="Row__third">
 
 #### For Marketing
 
-* 100% Mobile Responsive
-* 4 Built-In Themes or roll your own
-* Functional, Flat Design Style
-* Optional code float layout
-* Shareable/Linkable SEO Friendly URLs
-* Supports Google Analytics and Piwik Analytics
+-   100% Mobile Responsive
+-   4 Built-In Themes or roll your own
+-   Functional, Flat Design Style
+-   Optional code float layout
+-   Shareable/Linkable SEO Friendly URLs
+-   Supports Google Analytics and Piwik Analytics
 
 </div>
 </div>
@@ -52,7 +52,7 @@
 
 ### Installation and usage
 
-If you have __PHP__ and Composer installed
+If you have **PHP** and Composer installed
 
 ```bash
 composer global require daux/daux.io
@@ -61,7 +61,7 @@ composer global require daux/daux.io
 daux generate
 ```
 
-Or if you wish to use __Docker__
+Or if you wish to use **Docker**
 
 ```bash
 # Next to your `docs` folder, run
@@ -69,18 +69,3 @@ docker run --rm -it -w /build -v "$PWD":/build daux/daux.io daux generate
 ```
 
 ---
-
-<!-- Google Code -->
-<script type="text/javascript">
-var google_conversion_id = 983836026;
-var google_custom_params = window.google_tag_params;
-var google_remarketing_only = true;
-</script>
-
-<script type="text/javascript" src="//www.googleadservices.com/pagead/conversion.js">
-</script>
-<noscript>
-<div style="display:inline;">
-<img height="1" width="1" style="border-style:none;" alt="" src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/983836026/?value=0&amp;guid=ON&amp;script=0"/>
-</div>
-</noscript>

docs/config.json

@@ -21,13 +21,14 @@
         "repo": "dauxio/daux.io",
         "edit_on_github": "dauxio/daux.io/blob/master/docs",
         "twitter": ["onigoetz"],
-        "google_analytics": "UA-3551397-7",
+        "google_analytics": false,
+        "plausible_domain": false,
         "links": {
-            "Download": "https://github.com/dauxio/daux.io/archive/master.zip",
-            "GitHub Repo": "https://github.com/dauxio/daux.io",
-            "Help/Support/Bugs": "https://github.com/dauxio/daux.io/issues"
+            "GitHub Repository": "https://github.com/dauxio/daux.io",
+            "Help/Support/Bugs": "https://github.com/dauxio/daux.io/issues",
+            "Packagist": "https://packagist.org/packages/daux/daux.io",
+            "Docker Images": "https://hub.docker.com/r/daux/daux.io"
         },
-
         "powered_by": "Powered by Daux.io"
     },
     "confluence": {

libs/BaseConfig.php

@@ -5,7 +5,7 @@ use ArrayObject;
 class BaseConfig extends ArrayObject
 {
     /**
-     * Merge an array into the object
+     * Merge an array into the object.
      *
      * @param array $newValues
      * @param bool $override
@@ -17,6 +17,7 @@ class BaseConfig extends ArrayObject
             // we can simply set it.
             if (!array_key_exists($key, (array) $this)) {
                 $this[$key] = $value;
+
                 continue;
             }
 

libs/Cache.php

@@ -1,15 +1,14 @@
 <?php namespace Todaymade\Daux;
 
 use Symfony\Component\Console\Output\OutputInterface;
-use Todaymade\Daux\Daux;
 
 class Cache
 {
-    static $printed = false;
+    public static $printed = false;
 
     public static function getDirectory(): string
     {
-        $dir = sys_get_temp_dir() . DIRECTORY_SEPARATOR . "dauxio" . DIRECTORY_SEPARATOR;
+        $dir = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'dauxio' . DIRECTORY_SEPARATOR;
 
         if (!Cache::$printed) {
             Cache::$printed = true;
@@ -21,10 +20,6 @@ class Cache
 
     /**
      * Store an item in the cache for a given number of minutes.
-     *
-     * @param  string  $key
-     * @param  string  $value
-     * @return void
      */
     public static function put(string $key, string $value): void
     {
@@ -34,9 +29,6 @@ class Cache
 
     /**
      * Create the file cache directory if necessary.
-     *
-     * @param  string  $path
-     * @return void
      */
     protected static function ensureCacheDirectoryExists(string $path): void
     {
@@ -49,9 +41,6 @@ class Cache
 
     /**
      * Remove an item from the cache.
-     *
-     * @param  string  $key
-     * @return bool
      */
     public static function forget(string $key): bool
     {
@@ -67,7 +56,6 @@ class Cache
     /**
      * Retrieve an item from the cache by key.
      *
-     * @param  string $key
      * @return mixed
      */
     public static function get(string $key): ?string
@@ -83,13 +71,11 @@ class Cache
 
     /**
      * Get the full path for the given cache key.
-     *
-     * @param  string  $key
-     * @return string
      */
     protected static function path(string $key): string
     {
         $parts = array_slice(str_split($hash = sha1($key), 2), 0, 2);
+
         return Cache::getDirectory() . '/' . implode('/', $parts) . '/' . $hash;
     }
 
@@ -103,13 +89,12 @@ class Cache
         if (is_dir($dir)) {
             $objects = scandir($dir);
             foreach ($objects as $object) {
-                if ($object != "." && $object != "..") {
-                    if (is_dir($dir . "/" . $object)) {
-                        Cache::rrmdir($dir . "/" . $object);
+                if ($object != '.' && $object != '..') {
+                    if (is_dir($dir . '/' . $object)) {
+                        Cache::rrmdir($dir . '/' . $object);
                     } else {
-                        unlink($dir . "/" . $object);
+                        unlink($dir . '/' . $object);
                     }
-
                 }
             }
             rmdir($dir);

libs/Config.php

@@ -1,98 +1,120 @@
 <?php namespace Todaymade\Daux;
 
-use Todaymade\Daux\Tree\Content;
-use Todaymade\Daux\Tree\Entry;
+use Todaymade\Daux\Format\Confluence\Config as ConfluenceConfig;
 use Todaymade\Daux\Format\HTML\Config as HTMLConfig;
 use Todaymade\Daux\Format\HTML\Theme as Theme;
-use Todaymade\Daux\Format\Confluence\Config as ConfluenceConfig;
+use Todaymade\Daux\Tree\Content;
+use Todaymade\Daux\Tree\Entry;
 
 class Config extends BaseConfig
 {
-    public function getTitle() {
+    public function getTitle()
+    {
         return $this->getValue('title');
     }
 
-    public function hasAuthor(): bool {
+    public function hasAuthor(): bool
+    {
         return $this->hasValue('author');
     }
 
-    public function getAuthor() {
+    public function getAuthor()
+    {
         return $this->getValue('author');
     }
 
-    public function hasTagline(): bool {
+    public function hasTagline(): bool
+    {
         return $this->hasValue('tagline');
     }
 
-    public function getTagline() {
+    public function getTagline()
+    {
         return $this->getValue('tagline');
     }
 
-    public function getCurrentPage() {
+    public function getCurrentPage()
+    {
         return $this->getValue('current_page');
     }
 
-    public function setCurrentPage(Content $entry) {
+    public function setCurrentPage(Content $entry)
+    {
         $this->setValue('current_page', $entry);
     }
 
-    public function getDocumentationDirectory() {
+    public function getDocumentationDirectory()
+    {
         return $this->getValue('docs_directory');
     }
 
-    public function getThemesDirectory() {
+    public function getThemesDirectory()
+    {
         return $this->getValue('themes_directory');
     }
 
-    public function getThemesPath() {
+    public function getThemesPath()
+    {
         return $this->getValue('themes_path');
     }
 
-    public function getFormat() {
+    public function getFormat()
+    {
         return $this->getValue('format');
     }
 
-    public function hasTimezone(): bool {
+    public function hasTimezone(): bool
+    {
         return isset($this['timezone']);
     }
 
-    public function getTimezone() {
+    public function getTimezone()
+    {
         return $this->getValue('timezone');
     }
 
-    public function getTree() {
+    public function getTree()
+    {
         return $this->getValue('tree');
     }
 
-    public function setTree($tree) {
+    public function setTree($tree)
+    {
         $this->setValue('tree', $tree);
     }
 
-    public function isMultilanguage(): bool {
+    public function isMultilanguage(): bool
+    {
         return $this->hasValue('languages') && !empty($this->getValue('languages'));
     }
 
-    public function getLanguages(): array {
+    public function getLanguages(): array
+    {
         return $this->getValue('languages');
     }
 
-    public function getLanguage(): string {
+    public function getLanguage(): string
+    {
         return $this->getValue('language');
     }
 
-    public function getMode() {
+    public function getMode()
+    {
         return $this->getValue('mode');
     }
 
-    public function isLive() {
+    public function isLive()
+    {
         return $this->getValue('mode') == Daux::LIVE_MODE;
     }
 
-    public function isStatic() {
+    public function isStatic()
+    {
         return $this->getValue('mode') == Daux::STATIC_MODE;
     }
 
-    public function shouldInheritIndex() {
+    public function shouldInheritIndex()
+    {
         // As the global configuration is always present, we
         // need to test for the existence of the legacy value
         // first. Then use the current value.
@@ -103,35 +125,43 @@ class Config extends BaseConfig
         return $this['html']['inherit_index'];
     }
 
-    public function getIndexKey() {
+    public function getIndexKey()
+    {
         return $this->getValue('mode') == Daux::STATIC_MODE ? 'index.html' : 'index';
     }
 
-    public function getProcessor() {
+    public function getProcessor()
+    {
         return $this->getValue('processor');
     }
 
-    public function getConfluenceConfiguration(): ConfluenceConfig {
+    public function getConfluenceConfiguration(): ConfluenceConfig
+    {
         return new ConfluenceConfig($this->hasValue('confluence') ? $this->getValue('confluence') : []);
     }
 
-    public function getHTML(): HTMLConfig {
+    public function getHTML(): HTMLConfig
+    {
         return new HTMLConfig($this->hasValue('html') ? $this->getValue('html') : []);
     }
 
-    public function getTheme(): ?Theme {
+    public function getTheme(): ?Theme
+    {
         return $this->hasValue('theme') ? new Theme($this->getValue('theme')) : null;
     }
 
-    public function getValidContentExtensions() {
+    public function getValidContentExtensions()
+    {
         return $this->getValue('valid_content_extensions');
     }
 
-    public function setValidContentExtensions(array $value) {
+    public function setValidContentExtensions(array $value)
+    {
         $this->setValue('valid_content_extensions', $value);
     }
 
-    public function canCache() {
+    public function canCache()
+    {
         if ($this->hasValue('cache')) {
             return $this->getValue('cache');
         }
@@ -139,7 +169,8 @@ class Config extends BaseConfig
         return false;
     }
 
-    public function getCacheKey() {
+    public function getCacheKey()
+    {
         $cloned = [];
         foreach ($this as $key => $value) {
             $cloned[$key] = ($value instanceof Entry) ? $value->dump() : $value;
@@ -148,40 +179,48 @@ class Config extends BaseConfig
         return sha1(json_encode($cloned));
     }
 
-    public function hasTranslationKey($language, $key): bool {
+    public function hasTranslationKey($language, $key): bool
+    {
         return array_key_exists($language, $this['strings']) && array_key_exists($key, $this['strings'][$language]);
     }
 
-    public function getTranslationKey($language, $key) {
+    public function getTranslationKey($language, $key)
+    {
         return $this['strings'][$language][$key];
     }
 
-    public function hasImage(): bool {
-        return $this->hasValue('image');
+    public function hasImage(): bool
+    {
+        return $this->hasValue('image') && !empty($this->getValue('image'));
     }
 
-    public function getImage() {
+    public function getImage()
+    {
         return $this->getValue('image');
     }
 
-    public function setImage($value) {
+    public function setImage($value)
+    {
         $this->setValue('image', $value);
     }
 
-    public function getLocalBase() {
+    public function getLocalBase()
+    {
         return $this->getValue('local_base');
     }
 
-    public function getTemplates() {
+    public function getTemplates()
+    {
         return $this->getValue('templates');
     }
 
-    public function getBaseUrl() {
+    public function getBaseUrl()
+    {
         return $this->getValue('base_url');
     }
 
-    public function getBasePage() {
-
+    public function getBasePage()
+    {
         if ($this->isLive()) {
             $value = '//' . $this->getBaseUrl();
             if (!$this['live']['clean_urls']) {
@@ -190,62 +229,77 @@ class Config extends BaseConfig
 
             return $value;
         }
+
         return $this->getBaseUrl();
     }
 
-    public function hasEntryPage(): bool {
+    public function hasEntryPage(): bool
+    {
         return $this->hasValue('entry_page') && !empty($this->getValue('entry_page'));
     }
 
-    public function getEntryPage() {
+    public function getEntryPage()
+    {
         return $this->getValue('entry_page');
     }
 
-    public function setEntryPage($value) {
+    public function setEntryPage($value)
+    {
         $this->setValue('entry_page', $value);
     }
 
-    public function hasRequest(): bool {
+    public function hasRequest(): bool
+    {
         return $this->hasValue('request') && !empty($this->getValue('request'));
     }
 
-    public function getRequest() {
+    public function getRequest()
+    {
         return $this->getValue('request');
     }
 
-    public function setRequest($value) {
+    public function setRequest($value)
+    {
         $this->setValue('request', $value);
     }
 
-    public function getIndex() {
+    public function getIndex()
+    {
         return $this->getValue('index');
     }
 
-    public function setIndex($value) {
+    public function setIndex($value)
+    {
         $this->setValue('index', $value);
     }
 
-    public function hasProcessorInstance() {
+    public function hasProcessorInstance()
+    {
         return $this->hasValue('processor_instance');
     }
 
-    public function getProcessorInstance() {
+    public function getProcessorInstance()
+    {
         return $this->getValue('processor_instance');
     }
 
-    public function setProcessorInstance($value) {
+    public function setProcessorInstance($value)
+    {
         $this->setValue('processor_instance', $value);
     }
 
-    public function getIgnore() {
+    public function getIgnore()
+    {
         return $this->getValue('ignore');
     }
 
-    public function hasHost() {
+    public function hasHost()
+    {
         return $this->hasValue('host');
     }
 
-    public function getHost() {
+    public function getHost()
+    {
         return $this->getValue('host');
     }
 }

libs/ConfigBuilder.php

@@ -5,30 +5,40 @@ class ConfigBuilder
     /** @var Config */
     private $config;
 
-    private $configuration_override_file = null;
+    /** @var array */
+    private $overrideValues = [];
 
-    private function __construct(string $mode) {
+    private $configuration_override_file;
+
+    private function __construct(string $mode)
+    {
         $this->config = new Config();
         $this->config['mode'] = $mode;
         $this->config['local_base'] = dirname(__DIR__);
     }
 
-    public static function fromFile($file): Config {
+    public static function fromFile($file): Config
+    {
         return unserialize(file_get_contents($file));
     }
 
-    public static function withMode($mode = Daux::STATIC_MODE): ConfigBuilder {
+    public static function withMode($mode = Daux::STATIC_MODE): ConfigBuilder
+    {
         $builder = new ConfigBuilder($mode);
         $builder->loadBaseConfiguration();
+
         return $builder;
     }
 
-    public function with(array $values): ConfigBuilder {
+    public function with(array $values): ConfigBuilder
+    {
         $this->config->merge($values);
+
         return $this;
     }
 
-    private function setValue(&$array, $key, $value) {
+    private function setValue(Config $array, $key, $value)
+    {
         if (is_null($key)) {
             return $array = $value;
         }
@@ -41,68 +51,91 @@ class ConfigBuilder
             $array = &$array[$key];
         }
         $array[array_shift($keys)] = $value;
-        return $array;
     }
 
-    public function withValues(array $values): ConfigBuilder {
-        foreach ($values as $value) {
+    public function withValues(array $values): ConfigBuilder
+    {
+        $this->overrideValues = $values;
+
+        return $this;
+    }
+
+    public function withDocumentationDirectory($dir): ConfigBuilder
+    {
+        $this->config['docs_directory'] = $dir;
+
+        return $this;
+    }
+
+    public function withValidContentExtensions(array $value): ConfigBuilder
+    {
+        $this->config['valid_content_extensions'] = $value;
+
+        return $this;
+    }
+
+    public function withThemesPath($themePath): ConfigBuilder
+    {
+        $this->config['themes_path'] = $themePath;
+
+        return $this;
+    }
+
+    public function withThemesDirectory($directory): ConfigBuilder
+    {
+        $this->config['themes_directory'] = $directory;
+
+        return $this;
+    }
+
+    public function withCache(bool $value): ConfigBuilder
+    {
+        $this->config['cache'] = $value;
+
+        return $this;
+    }
+
+    public function withFormat($format): ConfigBuilder
+    {
+        $this->config['format'] = $format;
+
+        return $this;
+    }
+
+    public function withConfigurationOverride($file): ConfigBuilder
+    {
+        $this->configuration_override_file = $file;
+
+        return $this;
+    }
+
+    public function withProcessor($value): ConfigBuilder
+    {
+        $this->config['processor'] = $value;
+
+        return $this;
+    }
+
+    public function withConfluenceDelete($value): ConfigBuilder
+    {
+        $this->config['confluence']['delete'] = $value;
+
+        return $this;
+    }
+
+    public function build(): Config
+    {
+        $this->initializeConfiguration();
+
+        foreach ($this->overrideValues as $value) {
             $this->setValue($this->config, $value[0], $value[1]);
         }
-        return $this;
-    }
-
-    public function withDocumentationDirectory($dir): ConfigBuilder {
-        $this->config['docs_directory'] = $dir;
-        return $this;
-    }
-
-    public function withValidContentExtensions(array $value): ConfigBuilder {
-        $this->config['valid_content_extensions'] = $value;
-        return $this;
-    }
-
-    public function withThemesPath($themePath): ConfigBuilder {
-        $this->config['themes_path'] = $themePath;
-        return $this;
-    }
-
-    public function withThemesDirectory($directory): ConfigBuilder {
-        $this->config['themes_directory'] = $directory;
-        return $this;
-    }
-
-    public function withCache(bool $value): ConfigBuilder {
-        $this->config['cache'] = $value;
-        return $this;
-    }
-
-    public function withFormat($format): ConfigBuilder {
-        $this->config['format'] = $format;
-        return $this;
-    }
-
-    public function withConfigurationOverride($file): ConfigBuilder {
-        $this->configuration_override_file = $file;
-        return $this;
-    }
-
-    public function withProcessor($value): ConfigBuilder {
-        $this->config['processor'] = $value;
-        return $this;
-    }
-
-    public function withConfluenceDelete($value): ConfigBuilder {
-        $this->config['confluence']['delete'] = $value;
-        return $this;
-    }
-
-    public function build(): Config {
-        $this->initializeConfiguration();
 
         return $this->config;
     }
 
-    private function resolveThemeVariant() {
+    private function resolveThemeVariant()
+    {
         $theme = $this->config->getHTML()->getTheme();
         $themesPath = $this->config->getThemesPath() . DIRECTORY_SEPARATOR;
 
@@ -129,9 +162,11 @@ class ConfigBuilder
 
     /**
      * @param string $override_file
+     *
      * @throws Exception
      */
-    private function initializeConfiguration() {
+    private function initializeConfiguration()
+    {
         // Validate and set theme path
         $docs_path = $this->normalizeDocumentationPath($this->config->getDocumentationDirectory());
         $this->config['docs_directory'] = $docs_path;
@@ -163,10 +198,11 @@ class ConfigBuilder
         // Text search would be too slow on live server
         if ($this->config->isLive()) {
             $this->config['html']['search'] = false;
-        } 
+        }
     }
 
-    private function normalizeThemePath($path) {
+    private function normalizeThemePath($path)
+    {
         $validPath = $this->findLocation($path, $this->config->getLocalBase(), 'dir');
 
         if (!$validPath) {
@@ -176,7 +212,8 @@ class ConfigBuilder
         return $validPath;
     }
 
-    private function normalizeDocumentationPath($path) {
+    private function normalizeDocumentationPath($path)
+    {
         $validPath = $this->findLocation($path, $this->config->getLocalBase(), 'dir');
 
         if (!$validPath) {
@@ -187,11 +224,12 @@ class ConfigBuilder
     }
 
     /**
-     * Load and validate the global configuration
+     * Load and validate the global configuration.
      *
      * @throws Exception
      */
-    private function loadBaseConfiguration() {
+    private function loadBaseConfiguration()
+    {
         // Set the default configuration
         $this->config->merge([
             'docs_directory' => 'docs',
@@ -210,9 +248,11 @@ class ConfigBuilder
     /**
      * @param string $config_file
      * @param bool $optional
+     *
      * @throws Exception
      */
-    private function loadConfiguration($config_file, $optional = true) {
+    private function loadConfiguration($config_file, $optional = true)
+    {
         if (!file_exists($config_file)) {
             if ($optional) {
                 return;
@@ -229,13 +269,16 @@ class ConfigBuilder
     }
 
     /**
-     * Get the file requested for configuration overrides
+     * Get the file requested for configuration overrides.
+     *
+     * @param null|string $path
      *
-     * @param string|null $path
-     * @return string|null the path to a file to load for configuration overrides
      * @throws Exception
+     *
+     * @return null|string the path to a file to load for configuration overrides
      */
-    private function getConfigurationOverride($path) {
+    private function getConfigurationOverride($path)
+    {
         $validPath = $this->findLocation($path, $this->config->getLocalBase(), 'file');
 
         if ($validPath === null) {
@@ -250,23 +293,24 @@ class ConfigBuilder
     }
 
     /**
-     * @param string|null $path
+     * @param null|string $path
      * @param string $basedir
      * @param string $type
-     * @return false|null|string
+     *
+     * @return null|false|string
      */
-    private function findLocation($path, $basedir, $type) {
+    private function findLocation($path, $basedir, $type)
+    {
         // If Path is explicitly null, it's useless to go further
         if ($path === null) {
             return null;
         }
 
         // VFS, used only in tests
-        if (substr($path, 0, 6) == "vfs://") {
+        if (substr($path, 0, 6) == 'vfs://') {
             return $path;
         }
 
-
         // Check if it's relative to the current directory or an absolute path
         if (DauxHelper::is($path, $type)) {
             return DauxHelper::getAbsolutePath($path);
@@ -280,4 +324,4 @@ class ConfigBuilder
 
         return false;
     }
-}
+}

libs/Console/Application.php

@@ -12,16 +12,16 @@ class Application extends SymfonyApplication
         $this->add(new Serve());
         $this->add(new ClearCache());
 
-        $app_name = "daux/daux.io";
+        $app_name = 'daux/daux.io';
 
         $up = '..' . DIRECTORY_SEPARATOR;
         $composer = __DIR__ . DIRECTORY_SEPARATOR . $up . $up . $up . $up . $up . 'composer.lock';
-        $version = "unknown";
+        $version = 'unknown';
 
         if (file_exists($composer)) {
             $app = json_decode(file_get_contents($composer));
             $packages = $app->packages;
-            
+
             foreach ($packages as $package) {
                 if ($package->name == $app_name) {
                     $version = $package->version;

libs/Console/ClearCache.php

@@ -18,7 +18,7 @@ class ClearCache extends SymfonyCommand
     {
         $output->writeln("Clearing cache at '" . Cache::getDirectory() . "'");
         Cache::clear();
-        $output->writeln("<info>Cache cleared</info>");
+        $output->writeln('<info>Cache cleared</info>');
 
         return 0;
     }

libs/Console/DauxCommand.php

@@ -9,7 +9,7 @@ use Todaymade\Daux\Daux;
 
 class DauxCommand extends SymfonyCommand
 {
-    protected function configure() 
+    protected function configure()
     {
         $this
             ->addOption('configuration', 'c', InputOption::VALUE_REQUIRED, 'Configuration file')
@@ -46,8 +46,8 @@ class DauxCommand extends SymfonyCommand
 
         if ($input->hasOption('value')) {
             $values = array_map(
-                function($value) {
-                    return array_map("trim", explode('=', $value));
+                function ($value) {
+                    return array_map('trim', explode('=', $value));
                 },
                 $input->getOption('value')
             );

libs/Console/Generate.php

@@ -6,8 +6,8 @@ use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console\Terminal;
-use Todaymade\Daux\Daux;
 use Todaymade\Daux\ConfigBuilder;
+use Todaymade\Daux\Daux;
 
 class Generate extends DauxCommand
 {
@@ -61,7 +61,7 @@ class Generate extends DauxCommand
         $builder = $this->prepareConfig(Daux::STATIC_MODE, $input, $output);
         $daux = new Daux($builder->build(), $output);
 
-        $width = (new Terminal)->getWidth();
+        $width = (new Terminal())->getWidth();
 
         // Instiantiate the processor if one is defined
         $this->prepareProcessor($daux, $width);

libs/Console/RunAction.php

@@ -5,7 +5,8 @@ use Todaymade\Daux\Daux;
 
 trait RunAction
 {
-    protected function getLength($content) {
+    protected function getLength($content)
+    {
         return function_exists('mb_strlen') ? mb_strlen($content) : strlen($content);
     }
 
@@ -19,12 +20,13 @@ trait RunAction
         $padding = $width - $this->getLength($title) - 10;
 
         try {
-            $response = $closure(function($content) use (&$padding, $verbose) {
+            $response = $closure(function ($content) use (&$padding, $verbose) {
                 $padding -= $this->getLength($content);
                 Daux::write($content, $verbose);
             });
         } catch (\Exception $e) {
             $this->status($padding, '[ <fg=red>FAIL</fg=red> ]');
+
             throw $e;
         }
         $this->status($padding, '[  <fg=green>OK</fg=green>  ]');

libs/Console/Serve.php

@@ -1,14 +1,11 @@
 <?php namespace Todaymade\Daux\Console;
 
-use Exception;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Process\PhpExecutableFinder;
-use Symfony\Component\Process\ProcessUtils;
 use Symfony\Component\Console\Terminal;
+use Symfony\Component\Process\PhpExecutableFinder;
 use Todaymade\Daux\Daux;
-use Todaymade\Daux\Server\Server;
 
 class Serve extends DauxCommand
 {
@@ -36,7 +33,7 @@ class Serve extends DauxCommand
 
         $daux = new Daux($builder->build(), $output);
 
-        $width = (new Terminal)->getWidth();
+        $width = (new Terminal())->getWidth();
 
         // Instiantiate the processor if one is defined
         $this->prepareProcessor($daux, $width);
@@ -45,11 +42,12 @@ class Serve extends DauxCommand
         $file = tmpfile();
 
         if ($file === false) {
-            $output->writeln("<fg=red>Failed to create temporary file for configuration</fg=red>");
+            $output->writeln('<fg=red>Failed to create temporary file for configuration</fg=red>');
+
             return 1;
         }
 
-        $path = stream_get_meta_data($file)['uri']; 
+        $path = stream_get_meta_data($file)['uri'];
         fwrite($file, serialize($daux->getConfig()));
 
         chdir(__DIR__ . '/../../');
@@ -59,7 +57,7 @@ class Serve extends DauxCommand
         putenv('DAUX_EXTENSION=' . DAUX_EXTENSION);
 
         $base = escapeshellarg(__DIR__ . '/../../');
-        $binary = escapeshellarg((new PhpExecutableFinder)->find(false));
+        $binary = escapeshellarg((new PhpExecutableFinder())->find(false));
 
         echo "Daux development server started on http://{$host}:{$port}/\n";
 

libs/ContentTypes/ContentType.php

@@ -8,7 +8,7 @@ interface ContentType
     public function __construct(Config $config);
 
     /**
-     * Get the file extensions supported by this Content Type
+     * Get the file extensions supported by this Content Type.
      *
      * @return string[]
      */
@@ -17,6 +17,7 @@ interface ContentType
     /**
      * @param string $raw The raw text to render
      * @param Content $node The original node we are converting
+     *
      * @return string The generated output
      */
     public function convert($raw, Content $node);

libs/ContentTypes/ContentTypeHandler.php

@@ -18,7 +18,7 @@ class ContentTypeHandler
     }
 
     /**
-     * Get all valid content file extensions
+     * Get all valid content file extensions.
      *
      * @return string[]
      */
@@ -33,9 +33,8 @@ class ContentTypeHandler
     }
 
     /**
-     * Get the ContentType able to handle this node
+     * Get the ContentType able to handle this node.
      *
-     * @param Content $node
      * @return ContentType
      */
     public function getType(Content $node)

libs/ContentTypes/Markdown/CommonMarkConverter.php

@@ -1,9 +1,10 @@
 <?php namespace Todaymade\Daux\ContentTypes\Markdown;
 
-use League\CommonMark\DocParser;
 use League\CommonMark\Environment;
-use League\CommonMark\HtmlRenderer;
-use League\CommonMark\Ext\Table\TableExtension;
+use League\CommonMark\Extension\Autolink\AutolinkExtension;
+use League\CommonMark\Extension\SmartPunct\SmartPunctExtension;
+use League\CommonMark\Extension\Strikethrough\StrikethroughExtension;
+use League\CommonMark\Extension\Table\TableExtension;
 use League\CommonMark\Inline\Element as InlineElement;
 use Todaymade\Daux\Config;
 
@@ -11,13 +12,14 @@ class CommonMarkConverter extends \League\CommonMark\CommonMarkConverter
 {
     /**
      * Create a new commonmark converter instance.
-     *
-     * @param array $config
      */
     public function __construct(array $config = [])
     {
         $environment = Environment::createCommonMarkEnvironment();
         $environment->mergeConfig($config);
+        $environment->addExtension(new AutolinkExtension());
+        $environment->addExtension(new SmartPunctExtension());
+        $environment->addExtension(new StrikethroughExtension());
         $environment->addExtension(new TableExtension());
 
         // Table of Contents

libs/ContentTypes/Markdown/ContentType.php

@@ -19,11 +19,13 @@ class ContentType implements \Todaymade\Daux\ContentTypes\ContentType
         $this->config = $config;
     }
 
-    protected function createConverter() {
+    protected function createConverter()
+    {
         return new CommonMarkConverter(['daux' => $this->config]);
     }
 
-    protected function getConverter() {
+    protected function getConverter()
+    {
         if (!$this->converter) {
             $this->converter = $this->createConverter();
         }
@@ -41,7 +43,8 @@ class ContentType implements \Todaymade\Daux\ContentTypes\ContentType
 
     protected function doConversion($raw)
     {
-        Daux::writeln("Running conversion", OutputInterface::VERBOSITY_VERBOSE);
+        Daux::writeln('Running conversion', OutputInterface::VERBOSITY_VERBOSE);
+
         return $this->getConverter()->convertToHtml($raw);
     }
 
@@ -57,17 +60,17 @@ class ContentType implements \Todaymade\Daux\ContentTypes\ContentType
         $payload = Cache::get($cacheKey);
 
         if ($can_cache && $payload) {
-            Daux::writeln("Using cached version", OutputInterface::VERBOSITY_VERBOSE);
+            Daux::writeln('Using cached version', OutputInterface::VERBOSITY_VERBOSE);
         }
 
         if (!$can_cache || !$payload) {
-            Daux::writeln($can_cache ? "Not found in the cache, generating..." : "Cache disabled, generating...", OutputInterface::VERBOSITY_VERBOSE);
+            Daux::writeln($can_cache ? 'Not found in the cache, generating...' : 'Cache disabled, generating...', OutputInterface::VERBOSITY_VERBOSE);
             $payload = $this->doConversion($raw);
         }
 
         if ($can_cache) {
             Cache::put($cacheKey, $payload);
-        } 
+        }
 
         return $payload;
     }

libs/ContentTypes/Markdown/LinkRenderer.php

@@ -10,7 +10,6 @@ use League\CommonMark\Util\ConfigurationInterface;
 use Todaymade\Daux\Config;
 use Todaymade\Daux\DauxHelper;
 use Todaymade\Daux\Exception\LinkNotFoundException;
-use Todaymade\Daux\Tree\Entry;
 
 class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterface
 {
@@ -32,9 +31,10 @@ class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterfa
 
     /**
      * @param AbstractInline|Link $inline
-     * @param ElementRendererInterface $htmlRenderer
-     * @return HtmlElement
+     *
      * @throws LinkNotFoundException
+     *
+     * @return HtmlElement
      */
     public function render(AbstractInline $inline, ElementRendererInterface $htmlRenderer)
     {
@@ -55,6 +55,7 @@ class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterfa
         // Absolute urls, shouldn't either
         if (DauxHelper::isExternalUrl($url)) {
             $element->setAttribute('class', 'Link--external');
+            $element->setAttribute('rel', 'noopener noreferrer');
 
             return $element;
         }
@@ -72,14 +73,14 @@ class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterfa
         } catch (LinkNotFoundException $e) {
             // For some reason, the filename could contain a # and thus the link needs to resolve to that.
             try {
-                if (strlen($urlAndHash[1] ?? "") > 0) {
+                if (strlen($urlAndHash[1] ?? '') > 0) {
                     $file = DauxHelper::resolveInternalFile($this->daux, $url . '#' . $urlAndHash[1]);
                     $url = DauxHelper::getRelativePath($this->daux->getCurrentPage()->getUrl(), $file->getUrl());
                     $foundWithHash = true;
                 }
             } catch (LinkNotFoundException $e2) {
-                // If it's still not found here, we'll only 
-                // report on the first error as the second 
+                // If it's still not found here, we'll only
+                // report on the first error as the second
                 // one will tell the same.
             }
 
@@ -87,7 +88,7 @@ class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterfa
                 if ($this->daux->isStatic()) {
                     throw $e;
                 }
-    
+
                 $element->setAttribute('class', 'Link--broken');
             }
         }
@@ -101,9 +102,6 @@ class LinkRenderer implements InlineRendererInterface, ConfigurationAwareInterfa
         return $element;
     }
 
-    /**
-     * @param ConfigurationInterface $configuration
-     */
     public function setConfiguration(ConfigurationInterface $configuration)
     {
         $this->parent->setConfiguration($configuration);

libs/ContentTypes/Markdown/TableOfContents.php

@@ -6,11 +6,7 @@ use League\CommonMark\Cursor;
 class TableOfContents extends AbstractBlock
 {
     /**
-     * Returns true if this block can contain the given block as a child node
-     *
-     * @param AbstractBlock $block
-     *
-     * @return bool
+     * Returns true if this block can contain the given block as a child node.
      */
     public function canContain(AbstractBlock $block): bool
     {
@@ -18,20 +14,13 @@ class TableOfContents extends AbstractBlock
     }
 
     /**
-     * Whether this is a code block
-     *
-     * @return bool
+     * Whether this is a code block.
      */
     public function isCode(): bool
     {
         return false;
     }
 
-    /**
-     * @param Cursor $cursor
-     *
-     * @return bool
-     */
     public function matchesNextLine(Cursor $cursor): bool
     {
         return false;

libs/ContentTypes/Markdown/TableOfContentsParser.php

@@ -6,12 +6,6 @@ use League\CommonMark\Cursor;
 
 class TableOfContentsParser implements BlockParserInterface
 {
-    /**
-     * @param ContextInterface $context
-     * @param Cursor $cursor
-     *
-     * @return bool
-     */
     public function parse(ContextInterface $context, Cursor $cursor): bool
     {
         if ($cursor->isIndented()) {

libs/Daux.php

@@ -4,8 +4,6 @@ use Symfony\Component\Console\Output\NullOutput;
 use Symfony\Component\Console\Output\OutputInterface;
 use Todaymade\Daux\ContentTypes\ContentTypeHandler;
 use Todaymade\Daux\Tree\Builder;
-use Todaymade\Daux\Tree\Content;
-use Todaymade\Daux\Tree\Directory;
 use Todaymade\Daux\Tree\Root;
 
 class Daux
@@ -15,6 +13,12 @@ class Daux
 
     public static $output;
 
+    /** @var Tree\Root */
+    public $tree;
+
+    /** @var Config */
+    public $config;
+
     /** @var \Todaymade\Daux\Format\Base\Generator */
     protected $generator;
 
@@ -27,12 +31,6 @@ class Daux
     /** @var Processor */
     protected $processor;
 
-    /** @var Tree\Root */
-    public $tree;
-
-    /** @var Config */
-    public $config;
-
     /** @var bool */
     private $merged_tree = false;
 
@@ -40,12 +38,11 @@ class Daux
     {
         Daux::$output = $output;
 
-        
         $this->config = $config;
     }
 
     /**
-     * Generate the tree that will be used
+     * Generate the tree that will be used.
      */
     public function generateTree()
     {
@@ -96,6 +93,7 @@ class Daux
 
     /**
      * @return Config
+     *
      * @deprecated Use getConfig instead
      */
     public function getParams()
@@ -115,9 +113,6 @@ class Daux
         return $this->processor;
     }
 
-    /**
-     * @param Processor $processor
-     */
     public function setProcessor(Processor $processor)
     {
         $this->processor = $processor;
@@ -161,7 +156,8 @@ class Daux
         return $class;
     }
 
-    protected function findAlternatives($input, $words) {
+    protected function findAlternatives($input, $words)
+    {
         $alternatives = [];
 
         foreach ($words as $word) {
@@ -233,7 +229,7 @@ class Daux
     }
 
     /**
-     * Get all content file extensions
+     * Get all content file extensions.
      *
      * @return string[]
      */
@@ -246,7 +242,8 @@ class Daux
         return $this->validExtensions = $this->getContentTypeHandler()->getContentExtensions();
     }
 
-    public static function getOutput() {
+    public static function getOutput()
+    {
         if (!Daux::$output) {
             Daux::$output = new NullOutput();
         }
@@ -257,25 +254,28 @@ class Daux
     /**
      * Writes a message to the output.
      *
-     * @param string|array $messages The message as an array of lines or a single string
+     * @param array|string $messages The message as an array of lines or a single string
      * @param bool         $newline  Whether to add a newline
      * @param int          $options  A bitmask of options (one of the OUTPUT or VERBOSITY constants), 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
      */
-    public static function write($messages, $newline = false, $options = 0) {
+    public static function write($messages, $newline = false, $options = 0)
+    {
         Daux::getOutput()->write($messages, $newline, $options);
     }
 
     /**
      * Writes a message to the output and adds a newline at the end.
      *
-     * @param string|array $messages The message as an array of lines of a single string
+     * @param array|string $messages The message as an array of lines of a single string
      * @param int          $options  A bitmask of options (one of the OUTPUT or VERBOSITY constants), 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
      */
-    public static function writeln($messages, $options = 0) {
+    public static function writeln($messages, $options = 0)
+    {
         Daux::getOutput()->write($messages, true, $options);
     }
 
-    public static function getVerbosity() {
+    public static function getVerbosity()
+    {
         return Daux::getOutput()->getVerbosity();
     }
 }

libs/DauxHelper.php

@@ -8,9 +8,8 @@ use Todaymade\Daux\Tree\Entry;
 class DauxHelper
 {
     /**
-     * Set a new base_url for the configuration
+     * Set a new base_url for the configuration.
      *
-     * @param Config $config
      * @param string $base_url
      */
     public static function rebaseConfiguration(Config $config, $base_url)
@@ -27,17 +26,24 @@ class DauxHelper
     }
 
     /**
-     * @param Config $config
      * @param string $current_url
+     *
      * @return array
      */
     protected static function getTheme(Config $config, $current_url)
     {
+        static $cache = [];
+
         $htmlTheme = $config->getHTML()->getTheme();
 
         $theme_folder = $config->getThemesPath() . DIRECTORY_SEPARATOR . $htmlTheme;
         $theme_url = $config->getBaseUrl() . 'themes/' . $htmlTheme . '/';
 
+        $cache_key = "$current_url-$htmlTheme";
+        if (array_key_exists($cache_key, $cache)) {
+            return $cache[$cache_key];
+        }
+
         $theme = [];
         if (is_file($theme_folder . DIRECTORY_SEPARATOR . 'config.json')) {
             $theme = json_decode(file_get_contents($theme_folder . DIRECTORY_SEPARATOR . 'config.json'), true);
@@ -46,7 +52,7 @@ class DauxHelper
             }
         }
 
-        //Default parameters for theme
+        // Default parameters for theme
         $theme += [
             'name' => $htmlTheme,
             'css' => [],
@@ -55,6 +61,7 @@ class DauxHelper
             'favicon' => '<base_url>themes/daux/img/favicon.png',
             'templates' => $theme_folder . DIRECTORY_SEPARATOR . 'templates',
             'variants' => [],
+            'with_search' => $config->getHTML()->hasSearch()
         ];
 
         if ($config->getHTML()->hasThemeVariant()) {
@@ -78,6 +85,14 @@ class DauxHelper
             }
         }
 
+        if ($theme['with_search']) {
+            $theme['css'][] = '<base_url>daux_libraries/search.css';
+        }
+
+        if (is_file($config->getDocumentationDirectory() . DIRECTORY_SEPARATOR . 'style.css')) {
+            $theme['css'][]= '<base_url>style.css';
+        }
+
         $substitutions = [
             '<local_base>' => $config->getLocalBase(),
             '<base_url>' => $current_url,
@@ -94,13 +109,16 @@ class DauxHelper
             }
         }
 
+        $cache[$cache_key] = $theme;
+
         return $theme;
     }
 
     /**
-     * Remove all '/./' and '/../' in a path, without actually checking the path
+     * Remove all '/./' and '/../' in a path, without actually checking the path.
      *
      * @param string $path
+     *
      * @return string
      */
     public static function getCleanPath($path)
@@ -125,8 +143,8 @@ class DauxHelper
     /**
      * Get the possible output file names for a source file.
      *
-     * @param Config $config
      * @param string $part
+     *
      * @return string[]
      */
     public static function getFilenames(Config $config, $part)
@@ -140,11 +158,12 @@ class DauxHelper
     }
 
     /**
-     * Locate a file in the tree. Returns the file if found or false
+     * Locate a file in the tree. Returns the file if found or false.
      *
      * @param Directory $tree
      * @param string $request
-     * @return Tree\Content|Tree\Raw|false
+     *
+     * @return false|Tree\Content|Tree\Raw
      */
     public static function getFile($tree, $request)
     {
@@ -163,6 +182,7 @@ class DauxHelper
 
             if ($node == '..') {
                 $tree = $tree->getParent();
+
                 continue;
             }
 
@@ -171,6 +191,7 @@ class DauxHelper
             // node and proceed to the next url part
             if (isset($tree->getEntries()[$node])) {
                 $tree = $tree->getEntries()[$node];
+
                 continue;
             }
 
@@ -178,6 +199,7 @@ class DauxHelper
             $node = DauxHelper::slug(urldecode($node));
             if (isset($tree->getEntries()[$node])) {
                 $tree = $tree->getEntries()[$node];
+
                 continue;
             }
 
@@ -187,6 +209,7 @@ class DauxHelper
             foreach (static::getFilenames($tree->getConfig(), $node) as $filename) {
                 if (isset($tree->getEntries()[$filename])) {
                     $tree = $tree->getEntries()[$filename];
+
                     continue 2;
                 }
             }
@@ -219,17 +242,18 @@ class DauxHelper
      * Taken from Stringy
      *
      * @param  string $title
+     *
      * @return string
      */
     public static function slug($title)
     {
         // Convert to ASCII
-        if (function_exists("transliterator_transliterate")) {
-            $title = transliterator_transliterate("Any-Latin; NFD; [:Nonspacing Mark:] Remove; NFC;", $title);
+        if (function_exists('transliterator_transliterate')) {
+            $title = transliterator_transliterate('Any-Latin; NFD; [:Nonspacing Mark:] Remove; NFC;', $title);
         }
-        
-        $title = iconv("utf-8", "ASCII//TRANSLIT//IGNORE", $title);
-        
+
+        $title = iconv('utf-8', 'ASCII//TRANSLIT//IGNORE', $title);
+
         // Remove unsupported characters
         $title = preg_replace('/[^\x20-\x7E]/u', '', $title);
 
@@ -237,7 +261,7 @@ class DauxHelper
         // Convert all dashes into underscores
         $title = preg_replace('![' . preg_quote('-') . ']+!u', $separator, $title);
 
-        // Remove all characters that are not valid in a URL: 
+        // Remove all characters that are not valid in a URL:
         // $-_.+!*'(), separator, letters, numbers, or whitespace.
         $title = preg_replace('![^-' . preg_quote($separator) . '\!\'\(\),\.\+\*\$\pL\pN\s]+!u', '', $title);
 
@@ -250,6 +274,7 @@ class DauxHelper
     /**
      * @param string $from
      * @param string $to
+     *
      * @return string
      */
     public static function getRelativePath($from, $to)
@@ -276,10 +301,10 @@ class DauxHelper
                     // add traversals up to first matching dir
                     $padLength = (count($relPath) + $remaining - 1) * -1;
                     $relPath = array_pad($relPath, $padLength, '..');
+
                     break;
-                } else {
-                    //$relPath[0] = './' . $relPath[0];
                 }
+                //$relPath[0] = './' . $relPath[0];
             }
         }
 
@@ -290,11 +315,13 @@ class DauxHelper
     {
         if (!is_string($path)) {
             $mess = sprintf('String expected but was given %s', gettype($path));
+
             throw new \InvalidArgumentException($mess);
         }
 
         if (!ctype_print($path)) {
             $mess = 'Path can NOT have non-printable characters or be empty';
+
             throw new \DomainException($mess);
         }
 
@@ -310,13 +337,15 @@ class DauxHelper
         $parts = [];
         if (!preg_match($regExp, $path, $parts)) {
             $mess = sprintf('Path is NOT valid, was given %s', $path);
+
             throw new \DomainException($mess);
         }
 
         return '' !== $parts['root'];
     }
 
-    public static function getAbsolutePath($path) {
+    public static function getAbsolutePath($path)
+    {
         if (DauxHelper::isAbsolutePath($path)) {
             return $path;
         }
@@ -324,15 +353,18 @@ class DauxHelper
         return getcwd() . '/' . $path;
     }
 
-    public static function is($path, $type) {
+    public static function is($path, $type)
+    {
         return ($type == 'dir') ? is_dir($path) : file_exists($path);
     }
 
     /**
      * @param Config $config
      * @param string $url
-     * @return Entry
+     *
      * @throws LinkNotFoundException
+     *
+     * @return Entry
      */
     public static function resolveInternalFile($config, $url)
     {

libs/Format/Base/EmbedImages.php

@@ -3,7 +3,7 @@
  * Created by IntelliJ IDEA.
  * User: onigoetz
  * Date: 06/11/15
- * Time: 20:27
+ * Time: 20:27.
  */
 namespace Todaymade\Daux\Format\Base;
 
@@ -25,7 +25,7 @@ class EmbedImages
     {
         return preg_replace_callback(
             "/<img\\s+[^>]*src=['\"]([^\"]*)['\"][^>]*>/",
-            function($matches) use ($file, $callback) {
+            function ($matches) use ($file, $callback) {
                 if ($result = $this->findImage($matches[1], $matches[0], $file, $callback)) {
                     return $result;
                 }
@@ -67,7 +67,6 @@ class EmbedImages
         //Get any file corresponding to the right one
         $file = DauxHelper::getFile($this->tree, $url);
 
-
         if ($file === false) {
             return false;
         }

libs/Format/Base/Generator.php

@@ -6,15 +6,11 @@ use Todaymade\Daux\Daux;
 
 interface Generator
 {
-    /**
-     * @param Daux $daux
-     */
     public function __construct(Daux $daux);
 
     /**
-     * @param InputInterface $input
-     * @param OutputInterface $output
      * @param int $width
+     *
      * @return mixed
      */
     public function generateAll(InputInterface $input, OutputInterface $output, $width);

libs/Format/Base/LiveGenerator.php

@@ -6,8 +6,6 @@ use Todaymade\Daux\Tree\Entry;
 interface LiveGenerator extends Generator
 {
     /**
-     * @param Entry $node
-     * @param Config $config
      * @return \Todaymade\Daux\Format\Base\Page
      */
     public function generateOne(Entry $node, Config $config);

libs/Format/Base/Page.php

@@ -3,14 +3,14 @@
 interface Page
 {
     /**
-     * Get the converted content, without any template
+     * Get the converted content, without any template.
      *
      * @return string
      */
     public function getPureContent();
 
     /**
-     * Get the full content
+     * Get the full content.
      *
      * @return mixed
      */

libs/Format/Confluence/Api.php

@@ -24,7 +24,8 @@ class Api
     }
 
     /**
-     * This method is public due to test purposes
+     * This method is public due to test purposes.
+     *
      * @return Client
      */
     public function getClient()
@@ -39,9 +40,8 @@ class Api
 
     /**
      * The standard error message from guzzle is quite poor in informations,
-     * this will give little bit more sense to it and return it
+     * this will give little bit more sense to it and return it.
      *
-     * @param BadResponseException $e
      * @return \Exception
      */
     protected function handleError(BadResponseException $e)
@@ -101,10 +101,11 @@ class Api
     }
 
     /**
-     * Get a list of pages
+     * Get a list of pages.
      *
      * @param int $rootPage
      * @param bool $recursive
+     *
      * @return array
      */
     public function getList($rootPage, $recursive = false)
@@ -153,6 +154,7 @@ class Api
      * @param int $parent_id
      * @param string $title
      * @param string $content
+     *
      * @return int
      */
     public function createPage($parent_id, $title, $content)
@@ -224,7 +226,7 @@ class Api
         }
 
         $start = max($lineNumber - 3, 0);
-        $end   = min($lineNumber + 2, count($lines));
+        $end = min($lineNumber + 2, count($lines));
 
         $maxWidth = strlen("$end");
 
@@ -232,12 +234,11 @@ class Api
 
         $prepared = [];
         foreach ($filtered as $index => $line) {
-
             $number = $start + 1 + $index;
             $gutter = substr(' ' . (' ' . $number), -$maxWidth) . ' | ';
 
             if ($number == $lineNumber) {
-                $spacing = str_repeat(" ", strlen($gutter) + $column - 2);
+                $spacing = str_repeat(' ', strlen($gutter) + $column - 2);
                 $prepared[] = '>' . $gutter . $line . "\n " . $spacing . '^';
             } else {
                 $prepared[] = ' ' . $gutter . $line;
@@ -248,9 +249,10 @@ class Api
     }
 
     /**
-     * Delete a page
+     * Delete a page.
      *
      * @param int $page_id
+     *
      * @return mixed
      */
     public function deletePage($page_id)
@@ -268,6 +270,7 @@ class Api
         // this name is uploaded
         try {
             $url = "content/$id/child/attachment?filename=" . urlencode($attachment['filename']);
+
             return json_decode($this->getClient()->get($url)->getBody(), true);
         } catch (BadResponseException $e) {
             throw $this->handleError($e);
@@ -318,9 +321,9 @@ class Api
         // If the attachment is already uploaded,
         // the update URL is different
         if (count($result['results'])) {
-
             if ($this->getFileSize($attachment) == $result['results'][0]['extensions']['fileSize']) {
-                $write(" ( An attachment of the same size already exists, skipping. )");
+                $write(' ( An attachment of the same size already exists, skipping. )');
+
                 return;
             }
 

libs/Format/Confluence/Config.php

@@ -4,7 +4,8 @@ use Todaymade\Daux\BaseConfig;
 
 class Config extends BaseConfig
 {
-    public function shouldAutoDeleteOrphanedPages() {
+    public function shouldAutoDeleteOrphanedPages()
+    {
         if ($this->hasValue('delete')) {
             return $this->getValue('delete');
         }
@@ -12,55 +13,68 @@ class Config extends BaseConfig
         return false;
     }
 
-    public function getUpdateThreshold() {
+    public function getUpdateThreshold()
+    {
         return $this->hasValue('update_threshold') ? $this->getValue('update_threshold') : 2;
     }
 
-    public function getPrefix() {
+    public function getPrefix()
+    {
         return $this->getValue('prefix');
     }
 
-    public function getBaseUrl() {
+    public function getBaseUrl()
+    {
         return $this->getValue('base_url');
     }
 
-    public function getUser() {
+    public function getUser()
+    {
         return $this->getValue('user');
     }
 
-    public function getPassword() {
+    public function getPassword()
+    {
         return $this->getValue('pass');
     }
 
-    public function getSpaceId() {
+    public function getSpaceId()
+    {
         return $this->getValue('space_id');
     }
 
-    public function hasAncestorId() {
+    public function hasAncestorId()
+    {
         return $this->hasValue('ancestor_id');
     }
 
-    public function getAncestorId() {
+    public function getAncestorId()
+    {
         return $this->getValue('ancestor_id');
     }
 
-    public function setAncestorId($value) {
+    public function setAncestorId($value)
+    {
         $this->setValue('ancestor_id', $value);
     }
 
-    public function hasRootId() {
+    public function hasRootId()
+    {
         return $this->hasValue('root_id');
     }
 
-    public function getRootId() {
+    public function getRootId()
+    {
         return $this->getValue('root_id');
     }
 
-    public function hasHeader() {
+    public function hasHeader()
+    {
         return $this->hasValue('header');
     }
 
-    public function getHeader() {
+    public function getHeader()
+    {
         return $this->getValue('header');
     }
 }

libs/Format/Confluence/ContentPage.php

@@ -19,13 +19,12 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
             ->embed(
                 $content,
                 $this->file,
-                function($src, array $attributes, Entry $file) {
-
+                function ($src, array $attributes, Entry $file) {
                     //Add the attachment for later upload
                     if ($file instanceof Raw) {
                         $filename = basename($file->getPath());
                         $this->attachments[$filename] = ['filename' => $filename, 'file' => $file];
-                    } else if ($file instanceof ComputedRaw) {
+                    } elseif ($file instanceof ComputedRaw) {
                         $filename = $file->getUri();
                         $this->attachments[$filename] = ['filename' => $filename, 'content' => $file->getContent()];
                     } else {
@@ -45,10 +44,11 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
     }
 
     /**
-     * Create an image tag for the specified filename
+     * Create an image tag for the specified filename.
      *
      * @param string $filename
      * @param array $attributes
+     *
      * @return string
      */
     private function createImageTag($filename, $attributes)
@@ -60,7 +60,7 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
                 $re = '/float:\s*?(left|right);?/';
                 if (preg_match($re, $value, $matches)) {
                     $img .= ' ac:align="' . $matches[1] . '"';
-                    $value = preg_replace($re, "", $value, 1);
+                    $value = preg_replace($re, '', $value, 1);
                 }
             }
 

libs/Format/Confluence/ContentTypes/Markdown/CodeRenderer.php

@@ -5,10 +5,9 @@ use League\CommonMark\HtmlElement;
 
 abstract class CodeRenderer implements BlockRendererInterface
 {
-
     public function escapeCDATA($content)
     {
-        return str_replace("]]>", "]]]]><![CDATA[>", $content);
+        return str_replace(']]>', ']]]]><![CDATA[>', $content);
     }
 
     public function getHTMLElement($body, $language)

libs/Format/Confluence/ContentTypes/Markdown/CommonMarkConverter.php

@@ -1,7 +1,7 @@
 <?php namespace Todaymade\Daux\Format\Confluence\ContentTypes\Markdown;
 
-use League\CommonMark\Environment;
 use League\CommonMark\Block\Element as BlockElement;
+use League\CommonMark\Environment;
 use League\CommonMark\Inline\Element as InlineElement;
 use Todaymade\Daux\Config;
 use Todaymade\Daux\ContentTypes\Markdown\TableOfContents;

libs/Format/Confluence/ContentTypes/Markdown/ContentType.php

@@ -1,10 +1,9 @@
 <?php namespace Todaymade\Daux\Format\Confluence\ContentTypes\Markdown;
 
-use Todaymade\Daux\Config;
-
 class ContentType extends \Todaymade\Daux\ContentTypes\Markdown\ContentType
 {
-    protected function createConverter() {
+    protected function createConverter()
+    {
         return new CommonMarkConverter(['daux' => $this->config]);
     }
 }

libs/Format/Confluence/ContentTypes/Markdown/FencedCodeRenderer.php

@@ -36,8 +36,6 @@ class FencedCodeRenderer extends CodeRenderer
     protected $known_conversions = ['html' => 'html/xml', 'xml' => 'html/xml', 'js' => 'javascript'];
 
     /**
-     * @param AbstractBlock $block
-     * @param ElementRendererInterface $htmlRenderer
      * @param bool $inTightList
      *
      * @return HtmlElement|string

libs/Format/Confluence/ContentTypes/Markdown/ImageRenderer.php

@@ -20,13 +20,13 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
      */
     protected $parent;
 
-    public function __construct() {
+    public function __construct()
+    {
         $this->parent = new \League\CommonMark\Inline\Renderer\ImageRenderer();
     }
 
     /**
      * @param Image                    $inline
-     * @param ElementRendererInterface $htmlRenderer
      *
      * @return HtmlElement
      */
@@ -48,9 +48,6 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
         return $this->parent->render($inline, $htmlRenderer);
     }
 
-    /**
-     * @param ConfigurationInterface $configuration
-     */
     public function setConfiguration(ConfigurationInterface $configuration)
     {
         $this->parent->setConfiguration($configuration);

libs/Format/Confluence/ContentTypes/Markdown/IndentedCodeRenderer.php

@@ -8,8 +8,6 @@ use League\CommonMark\HtmlElement;
 class IndentedCodeRenderer extends CodeRenderer
 {
     /**
-     * @param AbstractBlock $block
-     * @param ElementRendererInterface $htmlRenderer
      * @param bool $inTightList
      *
      * @return HtmlElement
@@ -20,6 +18,6 @@ class IndentedCodeRenderer extends CodeRenderer
             throw new \InvalidArgumentException('Incompatible block type: ' . get_class($block));
         }
 
-        return $this->getHTMLElement($block->getStringContent(), "");
+        return $this->getHTMLElement($block->getStringContent(), '');
     }
 }

libs/Format/Confluence/ContentTypes/Markdown/LinkRenderer.php

@@ -10,7 +10,6 @@ class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
 {
     /**
      * @param AbstractInline|Link $inline
-     * @param ElementRendererInterface $htmlRenderer
      *
      * @return HtmlElement
      */
@@ -31,15 +30,25 @@ class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
             return $element;
         }
 
+        // if there's a hash component in the url, ensure we
+        // don't put that part through the resolver.
+        $urlAndHash = explode('#', $url);
+        $url = $urlAndHash[0];
+
         //Internal links
         $file = DauxHelper::resolveInternalFile($this->daux, $url);
 
-        $link_props = [
+        $link_props = [];
+        if (isset($urlAndHash[1])) {
+            $link_props["ac:anchor"] = $urlAndHash[1];
+        }
+
+        $page_props = [
             'ri:content-title' => trim(trim($this->daux['confluence']['prefix']) . ' ' . $file->getTitle()),
             'ri:space-key' => $this->daux['confluence']['space_id'],
         ];
 
-        $page = strval(new HtmlElement('ri:page', $link_props, '', true));
+        $page = strval(new HtmlElement('ri:page', $page_props, '', true));
         $children = $htmlRenderer->renderInlines($inline->children());
         if (strpos($children, '<') !== false) {
             $children = '<ac:link-body>' . $children . '</ac:link-body>';
@@ -47,6 +56,6 @@ class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
             $children = '<ac:plain-text-link-body><![CDATA[' . $children . ']]></ac:plain-text-link-body>';
         }
 
-        return new HtmlElement('ac:link', [], $page . $children);
+        return new HtmlElement('ac:link', $link_props, $page . $children);
     }
 }

libs/Format/Confluence/Generator.php

@@ -18,9 +18,6 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
     /** @var Daux */
     protected $daux;
 
-    /**
-     * @param Daux $daux
-     */
     public function __construct(Daux $daux)
     {
         $this->daux = $daux;
@@ -80,7 +77,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
         $tree = $this->runAction(
             'Generating Tree ...',
             $width,
-            function() use ($config) {
+            function () use ($config) {
                 $tree = $this->generateRecursive($this->daux->tree, $config);
                 $tree['title'] = $this->prefix . $config->getTitle();
 

libs/Format/Confluence/Publisher.php

@@ -7,16 +7,6 @@ class Publisher
 {
     use RunAction;
 
-    /**
-     * @var Api
-     */
-    protected $client;
-
-    /**
-     * @var Config
-     */
-    protected $confluence;
-
     /**
      * @var int terminal width
      */
@@ -27,6 +17,16 @@ class Publisher
      */
     public $output;
 
+    /**
+     * @var Api
+     */
+    protected $client;
+
+    /**
+     * @var Config
+     */
+    protected $confluence;
+
     /**
      * @param $confluence
      */
@@ -54,7 +54,7 @@ class Publisher
 
         $this->run(
             'Getting already published pages...',
-            function() use (&$published) {
+            function () use (&$published) {
                 if ($published != null) {
                     $published['children'] = $this->client->getList($published['id'], true);
                 }
@@ -62,8 +62,8 @@ class Publisher
         );
 
         $published = $this->run(
-            "Create placeholder pages...",
-            function() use ($tree, $published) {
+            'Create placeholder pages...',
+            function () use ($tree, $published) {
                 return $this->createRecursive($this->confluence->getAncestorId(), $tree, $published);
             }
         );
@@ -89,6 +89,7 @@ class Publisher
         if ($this->confluence->hasRootId()) {
             $published = $this->client->getPage($this->confluence->getRootId());
             $this->confluence->setAncestorId($published['ancestor_id']);
+
             return $published;
         }
 
@@ -142,7 +143,7 @@ class Publisher
 
     protected function createRecursive($parent_id, $entry, $published)
     {
-        $callback = function($parent_id, $entry, $published) {
+        $callback = function ($parent_id, $entry, $published) {
             // nothing to do if the ID already exists
             if (array_key_exists('id', $published)) {
                 return $published;
@@ -163,7 +164,7 @@ class Publisher
 
     protected function updateRecursive($parent_id, $entry, $published)
     {
-        $callback = function($parent_id, $entry, $published) {
+        $callback = function ($parent_id, $entry, $published) {
             if (array_key_exists('id', $published) && array_key_exists('page', $entry)) {
                 $this->updatePage($parent_id, $entry, $published);
             }
@@ -181,7 +182,7 @@ class Publisher
 
         $this->run(
             '- ' . PublisherUtilities::niceTitle($entry['file']->getUrl()),
-            function() use ($entry, $published, $parent_id, $updateThreshold) {
+            function () use ($entry, $published, $parent_id, $updateThreshold) {
                 $generated_content = $entry['page']->getContent();
                 if (PublisherUtilities::shouldUpdate($entry['page'], $generated_content, $published, $updateThreshold)) {
                     $this->client->updatePage(
@@ -199,7 +200,7 @@ class Publisher
             foreach ($entry['page']->attachments as $attachment) {
                 $this->run(
                     "  With attachment: $attachment[filename]",
-                    function($write) use ($published, $attachment) {
+                    function ($write) use ($published, $attachment) {
                         $this->client->uploadAttachment($published['id'], $attachment, $write);
                     }
                 );

libs/Format/Confluence/PublisherDelete.php

@@ -13,7 +13,7 @@ class PublisherDelete
     protected $deletable;
 
     /**
-     * @var boolean should delete ?
+     * @var bool should delete ?
      */
     protected $delete;
 
@@ -28,7 +28,6 @@ class PublisherDelete
         $this->delete = $delete;
         $this->client = $client;
 
-
         $this->deletable = [];
     }
 
@@ -60,7 +59,8 @@ class PublisherDelete
         }
     }
 
-    protected function doDelete() {
+    protected function doDelete()
+    {
         $this->output->writeLn('Deleting obsolete pages...');
         foreach ($this->deletable as $id => $title) {
             $this->output->writeLn("- $title");
@@ -68,10 +68,11 @@ class PublisherDelete
         }
     }
 
-    protected function displayDeletable() {
+    protected function displayDeletable()
+    {
         $this->output->writeLn('Listing obsolete pages...');
-        $this->output->writeLn("> The following pages will not be deleted, but just listed for information.");
-        $this->output->writeLn("> If you want to delete these pages, you need to set the --delete flag on the command.");
+        $this->output->writeLn('> The following pages will not be deleted, but just listed for information.');
+        $this->output->writeLn('> If you want to delete these pages, you need to set the --delete flag on the command.');
         foreach ($this->deletable as $id => $title) {
             $this->output->writeLn("- $title");
         }

libs/Format/HTML/Config.php

@@ -10,7 +10,7 @@ class Config extends BaseConfig
 
         return [
             'name' => 'GitHub',
-            'basepath' => (strpos($url, 'https://github.com/') === 0 ? '' : 'https://github.com/') . trim($url, '/')
+            'basepath' => (strpos($url, 'https://github.com/') === 0 ? '' : 'https://github.com/') . trim($url, '/'),
         ];
     }
 
@@ -20,11 +20,10 @@ class Config extends BaseConfig
             $edit_on = $this->getValue('edit_on');
             if (is_string($edit_on)) {
                 return $this->prepareGithubUrl($edit_on);
-            } else {
-                $edit_on['basepath'] = rtrim($edit_on['basepath'], '/');
-
-                return $edit_on;
             }
+            $edit_on['basepath'] = rtrim($edit_on['basepath'], '/');
+
+            return $edit_on;
         }
 
         if ($this->hasValue('edit_on_github')) {
@@ -34,7 +33,8 @@ class Config extends BaseConfig
         return null;
     }
 
-    public function hasSearch() {
+    public function hasSearch()
+    {
         return $this->hasValue('search') && $this->getValue('search');
     }
 
@@ -68,7 +68,7 @@ class Config extends BaseConfig
 
     public function hasGoogleAnalytics()
     {
-        return $this->hasValue('google_analytics');
+        return $this->hasValue('google_analytics') && $this->getValue('google_analytics');
     }
 
     public function getGoogleAnalyticsId()
@@ -76,6 +76,16 @@ class Config extends BaseConfig
         return $this->getValue('google_analytics');
     }
 
+    public function hasPlausibleAnalyticsDomain()
+    {
+        return $this->hasValue('plausible_domain') && $this->getValue('plausible_domain');
+    }
+
+    public function getPlausibleAnalyticsDomain()
+    {
+        return $this->getValue('plausible_domain');
+    }
+
     public function hasPiwikAnalytics()
     {
         return $this->getValue('piwik_analytics') && $this->hasValue('piwik_analytics_id');

libs/Format/HTML/ContentPage.php

@@ -4,6 +4,10 @@ use Todaymade\Daux\Tree\Root;
 
 class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
 {
+    /**
+     * @var Template
+     */
+    public $templateRenderer;
     /**
      * @var string
      */
@@ -14,11 +18,6 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
      */
     private $homepage;
 
-    /**
-     * @var Template
-     */
-    public $templateRenderer;
-
     private function isHomepage(): bool
     {
         // If the current page isn't the index, no chance it is the landing page
@@ -30,7 +29,8 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
         return $this->file->getParent() instanceof Root;
     }
 
-    private function isLanding(): bool {
+    private function isLanding(): bool
+    {
         return $this->config->getHTML()->hasLandingPage() && $this->homepage;
     }
 
@@ -48,6 +48,7 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
     /**
      * @param \Todaymade\Daux\Tree\Directory[] $parents
      * @param bool $multilanguage
+     *
      * @return array
      */
     private function getBreadcrumbTrail($parents, $multilanguage)
@@ -97,7 +98,7 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
             'breadcrumbs' => $config->getHTML()->hasBreadcrumbs(),
             'prev' => $this->file->getPrevious(),
             'next' => $this->file->getNext(),
-            'attributes' => $this->file->getAttribute()
+            'attributes' => $this->file->getAttribute(),
         ];
 
         if ($page['breadcrumbs']) {
@@ -111,13 +112,13 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
 
         $context = ['page' => $page, 'config' => $config];
 
-        $template = "theme::content";
+        $template = 'theme::content';
         if ($this->isLanding()) {
-            $template = "theme::home";
+            $template = 'theme::home';
         }
 
         if (array_key_exists('template', $page['attributes'])) {
-            $template = "theme::" . $page['attributes']['template'];
+            $template = 'theme::' . $page['attributes']['template'];
         }
 
         return $this->templateRenderer->render($template, $context);

libs/Format/HTML/ContentTypes/Markdown/CommonMarkConverter.php

@@ -1,9 +1,9 @@
 <?php namespace Todaymade\Daux\Format\HTML\ContentTypes\Markdown;
 
-use League\CommonMark\Environment;
 use League\CommonMark\Block\Element as BlockElement;
-use League\CommonMark\Inline\Element as InlineElement;
+use League\CommonMark\Environment;
 use League\CommonMark\Event\DocumentParsedEvent;
+use League\CommonMark\Inline\Element as InlineElement;
 use Todaymade\Daux\Config;
 use Todaymade\Daux\ContentTypes\Markdown\TableOfContents;
 

libs/Format/HTML/ContentTypes/Markdown/ContentType.php

@@ -1,10 +1,9 @@
 <?php namespace Todaymade\Daux\Format\HTML\ContentTypes\Markdown;
 
-use Todaymade\Daux\Config;
-
 class ContentType extends \Todaymade\Daux\ContentTypes\Markdown\ContentType
 {
-    protected function createConverter() {
+    protected function createConverter()
+    {
         return new CommonMarkConverter(['daux' => $this->config]);
     }
 }

libs/Format/HTML/ContentTypes/Markdown/FencedCodeRenderer.php

@@ -15,13 +15,12 @@ class FencedCodeRenderer implements BlockRendererInterface
      */
     private $hl;
 
-    public function __construct() {
+    public function __construct()
+    {
         $this->hl = new Highlighter();
     }
 
     /**
-     * @param AbstractBlock $block
-     * @param ElementRendererInterface $htmlRenderer
      * @param bool $inTightList
      *
      * @return HtmlElement|string

libs/Format/HTML/ContentTypes/Markdown/ImageRenderer.php

@@ -35,9 +35,12 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
     }
 
     /**
-     * Relative URLs can be done using either the folder with 
+     * Relative URLs can be done using either the folder with
      * number prefix or the final name (with prefix stripped).
      * This ensures that we always use the final name when generating.
+     *
+     * @param mixed $url
+     *
      * @throws LinkNotFoundException
      */
     protected function getCleanUrl($url)
@@ -55,6 +58,7 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
 
         try {
             $file = DauxHelper::resolveInternalFile($this->daux, $url);
+
             return DauxHelper::getRelativePath($this->daux->getCurrentPage()->getUrl(), $file->getUrl());
         } catch (LinkNotFoundException $e) {
             if ($this->daux->isStatic()) {
@@ -67,11 +71,10 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
 
     /**
      * @param Image                    $inline
-     * @param ElementRendererInterface $htmlRenderer
+     *
+     * @throws LinkNotFoundException
      *
      * @return HtmlElement
-     * 
-     * @throws LinkNotFoundException
      */
     public function render(AbstractInline $inline, ElementRendererInterface $htmlRenderer)
     {
@@ -84,9 +87,6 @@ class ImageRenderer implements InlineRendererInterface, ConfigurationAwareInterf
         return $this->parent->render($inline, $htmlRenderer);
     }
 
-    /**
-     * @param ConfigurationInterface $configuration
-     */
     public function setConfiguration(ConfigurationInterface $configuration)
     {
         $this->config = $configuration;

libs/Format/HTML/ContentTypes/Markdown/TOC/Entry.php

@@ -6,7 +6,7 @@ class Entry
 {
     protected $content;
     protected $level;
-    protected $parent = null;
+    protected $parent;
     protected $children = [];
 
     public function __construct(Heading $content)
@@ -56,7 +56,6 @@ class Entry
     }
 
     /**
-     * @param Entry $parent
      * @param bool $addChild
      */
     public function setParent(Entry $parent, $addChild = true)
@@ -67,9 +66,6 @@ class Entry
         }
     }
 
-    /**
-     * @param Entry $child
-     */
     public function addChild(Entry $child)
     {
         $child->setParent($this, false);

libs/Format/HTML/ContentTypes/Markdown/TOC/Processor.php

@@ -28,11 +28,6 @@ class Processor
         $this->config = $config;
     }
 
-    /**
-     * @param DocumentParsedEvent $event
-     *
-     * @return void
-     */
     public function onDocumentParsed(DocumentParsedEvent $event)
     {
         $document = $event->getDocument();
@@ -48,6 +43,7 @@ class Processor
 
             if ($node instanceof TableOfContents && !$event->isEntering()) {
                 $tocs[] = $node;
+
                 continue;
             }
 
@@ -72,28 +68,27 @@ class Processor
         }
     }
 
-    protected function getUniqueId(Document $document, $proposed) {
-        if ($proposed == "page_") {
-            $proposed = "page_section_" . (count($document->heading_ids) + 1);
+    protected function getUniqueId(Document $document, $proposed)
+    {
+        if ($proposed == 'page_') {
+            $proposed = 'page_section_' . (count($document->heading_ids) + 1);
         }
 
         // Quick path, it's a unique ID
         if (!in_array($proposed, $document->heading_ids)) {
             $document->heading_ids[] = $proposed;
+
             return $proposed;
         }
 
         $extension = 1; // Initialize the variable at one, so on the first iteration we have 2
         do {
-            $extension++;
+            ++$extension;
         } while (in_array("$proposed-$extension", $document->heading_ids));
 
         return "$proposed-$extension";
     }
 
-    /**
-     * @param Heading $node
-     */
     protected function ensureHeadingHasId(Document $document, Heading $node)
     {
         // If the node has an ID, no need to generate it, just check it's unique
@@ -128,9 +123,10 @@ class Processor
     }
 
     /**
-     * Make a tree of the list of headings
+     * Make a tree of the list of headings.
      *
      * @param Entry[] $headings
+     *
      * @return RootEntry
      */
     public function generate($headings)
@@ -146,19 +142,21 @@ class Processor
 
                 $parent->addChild($heading);
                 $previous = $heading;
+
                 continue;
             }
 
-
             if ($heading->getLevel() > $previous->getLevel()) {
                 $previous->addChild($heading);
                 $previous = $heading;
+
                 continue;
             }
 
             //if ($heading->getLevel() == $previous->getLevel()) {
             $previous->getParent()->addChild($heading);
             $previous = $heading;
+
             continue;
             //}
         }
@@ -168,6 +166,7 @@ class Processor
 
     /**
      * @param Entry[] $entries
+     *
      * @return ListBlock
      */
     protected function render(array $entries)
@@ -219,7 +218,6 @@ class Processor
     }
 
     /**
-     * @param Heading $node
      * @return Node[]
      */
     protected function cloneChildren(Heading $node)

libs/Format/HTML/ContentTypes/Markdown/TOC/Renderer.php

@@ -25,6 +25,7 @@ class Renderer implements BlockRendererInterface
         }
 
         $content = $htmlRenderer->renderBlocks($block->children());
+
         return $this->config->templateRenderer
             ->getEngine($this->config)
             ->render('theme::partials/table_of_contents', ['content' => $content]);

libs/Format/HTML/Generator.php

@@ -16,7 +16,8 @@ use Todaymade\Daux\Tree\Raw;
 
 class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
 {
-    use RunAction, HTMLUtils;
+    use RunAction;
+    use HTMLUtils;
 
     /** @var Daux */
     protected $daux;
@@ -26,9 +27,6 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
 
     protected $indexed_pages = [];
 
-    /**
-     * @param Daux $daux
-     */
     public function __construct(Daux $daux)
     {
         $config = $daux->getConfig();
@@ -60,7 +58,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
         $this->runAction(
             'Copying Static assets ...',
             $width,
-            function() use ($destination, $config) {
+            function () use ($destination, $config) {
                 $this->ensureEmptyDestination($destination);
 
                 $this->copyThemes($destination, $config->getThemesPath());
@@ -78,8 +76,8 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
 
         if ($config->getHTML()->hasSearch()) {
             file_put_contents(
-                $destination . DIRECTORY_SEPARATOR . 'daux_search_index.json',
-                json_encode(['pages' => $this->indexed_pages])
+                $destination . DIRECTORY_SEPARATOR . 'daux_search_index.js',
+                'load_search_index(' . json_encode(['pages' => $this->indexed_pages]) . ');'
             );
 
             if (json_last_error()) {
@@ -93,9 +91,10 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
      * script code, and embedded objects.  Add line breaks around
      * block-level tags to prevent word joining after tag removal.
      * Also collapse whitespace to single space and trim result.
-     * modified from: http://nadeausoftware.com/articles/2007/09/php_tip_how_strip_html_tags_web_page
+     * modified from: http://nadeausoftware.com/articles/2007/09/php_tip_how_strip_html_tags_web_page.
      *
      * @param string $text
+     *
      * @return string
      */
     private function sanitize($text)
@@ -133,21 +132,18 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
 
         // Sometimes strings are detected as invalid UTF-8 and json_encode can't treat them
         // iconv can fix those strings
-        $text = iconv('UTF-8', 'UTF-8//IGNORE', $text);
-
-        return $text;
+        return iconv('UTF-8', 'UTF-8//IGNORE', $text);
     }
 
     /**
-     * Recursively generate the documentation
+     * Recursively generate the documentation.
      *
-     * @param Directory $tree
      * @param string $output_dir
-     * @param GlobalConfig $config
      * @param OutputInterface $output
      * @param int $width
      * @param bool $index_pages
      * @param string $base_url
+     *
      * @throws \Exception
      */
     private function generateRecursive(Directory $tree, $output_dir, GlobalConfig $config, $output, $width, $index_pages, $base_url = '')
@@ -170,7 +166,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
                 $this->runAction(
                     '- ' . $node->getUrl(),
                     $width,
-                    function() use ($node, $output_dir, $key, $config, $index_pages) {
+                    function () use ($node, $output_dir, $key, $config, $index_pages) {
                         if ($node instanceof Raw) {
                             copy($node->getPath(), $output_dir . DIRECTORY_SEPARATOR . $key);
 
@@ -185,7 +181,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
                             $this->indexed_pages[] = [
                                 'title' => $node->getTitle(),
                                 'text' => $this->sanitize($generated->getPureContent()),
-                                'tags' =>  '',
+                                'tags' => '',
                                 'url' => $node->getUrl(),
                             ];
                         }
@@ -196,8 +192,6 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator, LiveGenerator
     }
 
     /**
-     * @param Entry $node
-     * @param GlobalConfig $config
      * @return \Todaymade\Daux\Format\Base\Page
      */
     public function generateOne(Entry $node, GlobalConfig $config)

libs/Format/HTML/HTMLUtils.php

@@ -2,7 +2,8 @@
 
 use Todaymade\Daux\GeneratorHelper;
 
-trait HTMLUtils {
+trait HTMLUtils
+{
     public function ensureEmptyDestination($destination)
     {
         if (is_dir($destination)) {
@@ -13,7 +14,7 @@ trait HTMLUtils {
     }
 
     /**
-     * Copy all files from $local to $destination
+     * Copy all files from $local to $destination.
      *
      * @param string $destination
      * @param string $local_base
@@ -26,4 +27,4 @@ trait HTMLUtils {
             $destination . DIRECTORY_SEPARATOR . 'themes'
         );
     }
-}
+}

libs/Format/HTML/Template.php

@@ -55,7 +55,7 @@ class Template
 
     /**
      * @param string $name
-     * @param array $data
+     *
      * @return string
      */
     public function render($name, array $data = [])
@@ -78,13 +78,13 @@ class Template
 
     protected function registerFunctions($engine)
     {
-        $engine->registerFunction('get_navigation', function($tree, $path, $current_url, $base_page, $mode) {
+        $engine->registerFunction('get_navigation', function ($tree, $path, $current_url, $base_page, $mode) {
             $nav = $this->buildNavigation($tree, $path, $current_url, $base_page, $mode);
 
             return $this->renderNavigation($nav);
         });
 
-        $engine->registerFunction('translate', function($key) {
+        $engine->registerFunction('translate', function ($key) {
             $language = $this->config->getLanguage();
 
             if (isset($this->engine->getData('page')['page'])) {
@@ -105,7 +105,7 @@ class Template
             return "Unknown key $key";
         });
 
-        $engine->registerFunction('get_breadcrumb_title', function($page, $base_page) {
+        $engine->registerFunction('get_breadcrumb_title', function ($page, $base_page) {
             $title = '';
             $breadcrumb_trail = $page['breadcrumb_trail'];
             $separator = $this->getSeparator($page['breadcrumb_separator']);
@@ -196,6 +196,7 @@ class Template
 
     /**
      * @param string $separator
+     *
      * @return string
      */
     private function getSeparator($separator)

libs/Format/HTML/Theme.php

@@ -4,23 +4,28 @@ use Todaymade\Daux\BaseConfig;
 
 class Theme extends BaseConfig
 {
-    public function getFonts() {
+    public function getFonts()
+    {
         return $this->getValue('fonts');
     }
 
-    public function getCSS() {
+    public function getCSS()
+    {
         return $this->getValue('css');
     }
 
-    public function getJS() {
+    public function getJS()
+    {
         return $this->getValue('js');
     }
 
-    public function getFavicon() {
+    public function getFavicon()
+    {
         return $this->getValue('favicon');
     }
 
-    public function getTemplates() {
+    public function getTemplates()
+    {
         return $this->getValue('templates');
     }
 }

libs/Format/HTMLFile/Book.php

@@ -1,6 +1,5 @@
 <?php namespace Todaymade\Daux\Format\HTMLFile;
 
-use RuntimeException;
 use Todaymade\Daux\Tree\Content;
 use Todaymade\Daux\Tree\Directory;
 
@@ -24,7 +23,7 @@ class Book
 
     protected function getPageUrl($page)
     {
-        return "file_" . str_replace('/', '_', $page->getUrl());
+        return 'file_' . str_replace('/', '_', $page->getUrl());
     }
 
     protected function buildNavigation(Directory $tree)
@@ -38,7 +37,7 @@ class Book
 
                 $nav[] = [
                     'title' => $node->getTitle(),
-                    'href' => "#" . $this->getPageUrl($node),
+                    'href' => '#' . $this->getPageUrl($node),
                 ];
             } elseif ($node instanceof Directory) {
                 if (!$node->hasContent()) {
@@ -49,7 +48,7 @@ class Book
 
                 $nav[] = [
                     'title' => $node->getTitle(),
-                    'href' => "#" . $this->getPageUrl($page_index),
+                    'href' => '#' . $this->getPageUrl($page_index),
                     'children' => $this->buildNavigation($node),
                 ];
             }
@@ -89,7 +88,7 @@ class Book
 
     protected function generateCover()
     {
-        return "<div>" .
+        return '<div>' .
         "<h1 style='font-size:40pt; margin-bottom:0;'>{$this->cover['title']}</h1>" .
         "<p><strong>{$this->cover['subject']}</strong> by {$this->cover['author']}</p>" .
         '</div><div class="PageBreak">&nbsp;</div>';

libs/Format/HTMLFile/ContentPage.php

@@ -13,11 +13,11 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
 
         // Embed images
         // We do it after generation so we can catch the images that were in html already
-        $content = (new EmbedImages($this->config->getTree()))
+        return (new EmbedImages($this->config->getTree()))
             ->embed(
                 $content,
                 $this->file,
-                function($src, array $attributes, Raw $file) {
+                function ($src, array $attributes, Raw $file) {
                     // TODO :: ignore absolute paths
                     $content = base64_encode(file_get_contents($file->getPath()));
                     $attr = '';
@@ -29,7 +29,5 @@ class ContentPage extends \Todaymade\Daux\Format\Base\ContentPage
                     return "<img $attr src=\"data:image/png;base64,$content\"/>";
                 }
             );
-
-        return $content;
     }
 }

libs/Format/HTMLFile/ContentTypes/Markdown/CommonMarkConverter.php

@@ -1,7 +1,6 @@
 <?php namespace Todaymade\Daux\Format\HTMLFile\ContentTypes\Markdown;
 
 use League\CommonMark\Environment;
-use Todaymade\Daux\Config;
 
 class CommonMarkConverter extends \Todaymade\Daux\Format\HTML\ContentTypes\Markdown\CommonMarkConverter
 {

libs/Format/HTMLFile/ContentTypes/Markdown/ContentType.php

@@ -1,10 +1,9 @@
 <?php namespace Todaymade\Daux\Format\HTMLFile\ContentTypes\Markdown;
 
-use Todaymade\Daux\Config;
-
 class ContentType extends \Todaymade\Daux\ContentTypes\Markdown\ContentType
 {
-    protected function createConverter() {
+    protected function createConverter()
+    {
         return new CommonMarkConverter(['daux' => $this->config]);
     }
 }

libs/Format/HTMLFile/ContentTypes/Markdown/LinkRenderer.php

@@ -4,18 +4,17 @@ use League\CommonMark\ElementRendererInterface;
 use League\CommonMark\HtmlElement;
 use League\CommonMark\Inline\Element\AbstractInline;
 use League\CommonMark\Inline\Element\Link;
-use Todaymade\Daux\Config;
 use Todaymade\Daux\DauxHelper;
 use Todaymade\Daux\Exception\LinkNotFoundException;
-use Todaymade\Daux\Tree\Entry;
 
 class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
 {
     /**
      * @param AbstractInline|Link $inline
-     * @param ElementRendererInterface $htmlRenderer
-     * @return HtmlElement
+     *
      * @throws LinkNotFoundException
+     *
+     * @return HtmlElement
      */
     public function render(AbstractInline $inline, ElementRendererInterface $htmlRenderer)
     {
@@ -44,7 +43,7 @@ class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
         $urlAndHash = explode('#', $url);
         if (isset($urlAndHash[1])) {
             $element->setAttribute('href', '#' . $urlAndHash[1]);
-            
+
             return $element;
         }
 
@@ -64,4 +63,4 @@ class LinkRenderer extends \Todaymade\Daux\ContentTypes\Markdown\LinkRenderer
 
         return $element;
     }
-}
+}

libs/Format/HTMLFile/Generator.php

@@ -4,13 +4,14 @@ use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
 use Todaymade\Daux\Console\RunAction;
 use Todaymade\Daux\Daux;
-use Todaymade\Daux\Format\HTML\Template;
 use Todaymade\Daux\Format\HTML\HTMLUtils;
+use Todaymade\Daux\Format\HTML\Template;
 use Todaymade\Daux\Format\HTMLFile\ContentTypes\Markdown\ContentType;
 
 class Generator implements \Todaymade\Daux\Format\Base\Generator
 {
-    use RunAction, HTMLUtils;
+    use RunAction;
+    use HTMLUtils;
 
     /** @var Daux */
     protected $daux;
@@ -18,9 +19,6 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
     /** @var Template */
     protected $templateRenderer;
 
-    /**
-     * @param Daux $daux
-     */
     public function __construct(Daux $daux)
     {
         $config = $daux->getConfig();
@@ -55,7 +53,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
         $this->runAction(
             'Cleaning destination folder ...',
             $width,
-            function() use ($destination) {
+            function () use ($destination) {
                 $this->ensureEmptyDestination($destination);
             }
         );
@@ -63,7 +61,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
         $data = [
             'author' => $config->getAuthor(),
             'title' => $config->getTitle(),
-            'subject' => $config->getTagline()
+            'subject' => $config->getTagline(),
         ];
 
         $book = new Book($this->daux->tree, $data);
@@ -73,7 +71,7 @@ class Generator implements \Todaymade\Daux\Format\Base\Generator
             $this->runAction(
                 'Generating ' . $current->getTitle(),
                 $width,
-                function() use ($book, $current, $config) {
+                function () use ($book, $current, $config) {
                     $contentType = $this->daux->getContentTypeHandler()->getType($current);
                     $content = ContentPage::fromFile($current, $config, $contentType);
                     $content->templateRenderer = $this->templateRenderer;

libs/FormatDate.php

@@ -4,13 +4,14 @@ use IntlDateFormatter;
 
 class FormatDate
 {
-    public static function format($config, $date) {
+    public static function format($config, $date)
+    {
         $locale = $config->getLanguage();
         $datetype = IntlDateFormatter::LONG;
         $timetype = IntlDateFormatter::SHORT;
         $timezone = null;
 
-        if (!extension_loaded("intl")) {
+        if (!extension_loaded('intl')) {
             $locale = 'en';
             $timezone = 'GMT';
         }
@@ -19,4 +20,4 @@ class FormatDate
 
         return $formatter->format($date);
     }
-}
+}

libs/GeneratorHelper.php

@@ -5,7 +5,7 @@ use RuntimeException;
 class GeneratorHelper
 {
     /**
-     * Remove a directory recursively
+     * Remove a directory recursively.
      *
      * @param string $dir
      */
@@ -26,7 +26,7 @@ class GeneratorHelper
     }
 
     /**
-     * Copy files recursively
+     * Copy files recursively.
      *
      * @param string $source
      * @param string $destination
@@ -43,14 +43,22 @@ class GeneratorHelper
             throw new RuntimeException("Cannot copy '$source' to '$destination'");
         }
 
+        $aExclDirs = array(
+            'scss',
+            'templates'
+        );
+        $aExclFiles = array(
+            'config.json'
+        );
+
         while (false !== ($file = readdir($dir))) {
             if ($file != '.' && $file != '..') {
-                if (is_dir($source . DIRECTORY_SEPARATOR . $file)) {
+                if (is_dir($source . DIRECTORY_SEPARATOR . $file) && false == in_array($file, $aExclDirs)) {
                     static::copyRecursive(
                         $source . DIRECTORY_SEPARATOR . $file,
                         $destination . DIRECTORY_SEPARATOR . $file
                     );
-                } else {
+                } elseif (false == in_array($file, $aExclFiles)) {
                     copy($source . DIRECTORY_SEPARATOR . $file, $destination . DIRECTORY_SEPARATOR . $file);
                 }
             }

libs/Processor.php

@@ -22,8 +22,6 @@ class Processor
     protected $width;
 
     /**
-     * @param Daux $daux
-     * @param OutputInterface $output
      * @param int $width
      */
     public function __construct(Daux $daux, OutputInterface $output, $width)
@@ -37,10 +35,8 @@ class Processor
      * With this connection point, you can transform
      * the tree as you want, move pages, modify
      * pages and even add new ones.
-     *
-     * @param Root $root
      */
-    public function manipulateTree(/** @scrutinizer ignore-unused */ Root $root)
+    public function manipulateTree(/* @scrutinizer ignore-unused */ Root $root)
     {
     }
 
@@ -48,10 +44,8 @@ class Processor
      * This connection point provides
      * a way to extend the Markdown
      * parser and renderer.
-     *
-     * @param Environment $environment
      */
-    public function extendCommonMarkEnvironment(/** @scrutinizer ignore-unused */ Environment $environment)
+    public function extendCommonMarkEnvironment(/* @scrutinizer ignore-unused */ Environment $environment)
     {
     }
 

libs/Server/ExtensionMimeTypeGuesser.php

@@ -3,7 +3,7 @@
 use Symfony\Component\Mime\MimeTypeGuesserInterface;
 
 /**
- * Guesses the mime type using the file's extension
+ * Guesses the mime type using the file's extension.
  */
 class ExtensionMimeTypeGuesser implements MimeTypeGuesserInterface
 {
@@ -22,12 +22,12 @@ class ExtensionMimeTypeGuesser implements MimeTypeGuesserInterface
     {
         $extension = pathinfo($path, PATHINFO_EXTENSION);
 
-        if ($extension == "css") {
-            return "text/css";
+        if ($extension == 'css') {
+            return 'text/css';
         }
 
-        if ($extension == "js") {
-            return "application/javascript";
+        if ($extension == 'js') {
+            return 'application/javascript';
         }
 
         return null;

libs/Server/Server.php

@@ -5,8 +5,8 @@ use Symfony\Component\HttpFoundation\BinaryFileResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Mime\MimeTypes;
-use Todaymade\Daux\Daux;
 use Todaymade\Daux\ConfigBuilder;
+use Todaymade\Daux\Daux;
 use Todaymade\Daux\DauxHelper;
 use Todaymade\Daux\Exception;
 use Todaymade\Daux\Format\Base\ComputedRawPage;
@@ -25,8 +25,16 @@ class Server
      */
     private $request;
 
+    public function __construct(Daux $daux)
+    {
+        $this->daux = $daux;
+
+        $this->request = Request::createFromGlobals();
+        $this->base_url = $this->request->getHttpHost() . $this->request->getBaseUrl() . '/';
+    }
+
     /**
-     * Serve the documentation
+     * Serve the documentation.
      *
      * @throws Exception
      */
@@ -63,24 +71,18 @@ class Server
         $server->createResponse($page)->prepare($server->request)->send();
     }
 
-    public function __construct(Daux $daux)
-    {
-        $this->daux = $daux;
-
-        $this->request = Request::createFromGlobals();
-        $this->base_url = $this->request->getHttpHost() . $this->request->getBaseUrl() . "/";
-    }
-
     /**
      * Create a temporary file with the file suffix, for mime type detection.
      *
      * @param string $postfix
+     *
      * @return string
      */
-    private function getTemporaryFile($postfix) {
+    private function getTemporaryFile($postfix)
+    {
         $sysFileName = tempnam(sys_get_temp_dir(), 'daux');
         if ($sysFileName === false) {
-            throw new \RuntimeException("Could not create temporary file");
+            throw new \RuntimeException('Could not create temporary file');
         }
 
         $newFileName = $sysFileName . $postfix;
@@ -92,14 +94,14 @@ class Server
             return $newFileName;
         }
 
-        throw new \RuntimeException("Could not create temporary file");
+        throw new \RuntimeException('Could not create temporary file');
     }
 
     /**
-     * @param Page $page
      * @return Response
      */
-    public function createResponse(Page $page) {
+    public function createResponse(Page $page)
+    {
         // Add a custom MimeType guesser in case the default ones are not available
         // This makes sure that at least CSS and JS work fine.
         $mimeTypes = MimeTypes::getDefault();
@@ -112,6 +114,7 @@ class Server
         if ($page instanceof ComputedRawPage) {
             $file = $this->getTemporaryFile($page->getFilename());
             file_put_contents($file, $page->getContent());
+
             return new BinaryFileResponse($file);
         }
 
@@ -127,16 +130,16 @@ class Server
 
         DauxHelper::rebaseConfiguration($config, '//' . $this->base_url);
 
-
         return $config;
     }
 
     /**
-     * Handle an incoming request
+     * Handle an incoming request.
      *
-     * @return \Todaymade\Daux\Format\Base\Page
      * @throws Exception
      * @throws NotFoundException
+     *
+     * @return \Todaymade\Daux\Format\Base\Page
      */
     public function handle()
     {
@@ -156,11 +159,13 @@ class Server
     }
 
     /**
-     * Handle a request on custom themes
+     * Handle a request on custom themes.
      *
      * @param string $request
-     * @return \Todaymade\Daux\Format\Base\Page
+     *
      * @throws NotFoundException
+     *
+     * @return \Todaymade\Daux\Format\Base\Page
      */
     public function serveTheme($request)
     {
@@ -170,13 +175,15 @@ class Server
             return new RawPage($file);
         }
 
-        throw new NotFoundException;
+        throw new NotFoundException();
     }
 
     /**
      * @param string $request
-     * @return \Todaymade\Daux\Format\Base\Page
+     *
      * @throws NotFoundException
+     *
+     * @return \Todaymade\Daux\Format\Base\Page
      */
     private function getPage($request)
     {

libs/Tree/Builder.php

@@ -14,7 +14,7 @@ class Builder
         '.DS_Store', 'Thumbs.db',
     ];
 
-    protected static function isIgnored(\SplFileInfo $file, $ignore)
+    protected static function isIgnored(SplFileInfo $file, $ignore)
     {
         $filename = $file->getFilename();
 
@@ -34,9 +34,10 @@ class Builder
     }
 
     /**
-     * Get name for a file
+     * Get name for a file.
      *
      * @param string $path
+     *
      * @return string
      */
     protected static function getName($path)
@@ -52,7 +53,7 @@ class Builder
     }
 
     /**
-     * Build the initial tree
+     * Build the initial tree.
      *
      * @param Directory $node
      * @param array $ignore
@@ -96,8 +97,6 @@ class Builder
     }
 
     /**
-     * @param Directory $parent
-     * @param SplFileInfo $file
      * @return Content|Raw
      */
     public static function createContent(Directory $parent, SplFileInfo $file)
@@ -141,6 +140,7 @@ class Builder
 
     /**
      * @param string $filename
+     *
      * @return string
      */
     public static function removeSortingInformations($filename)
@@ -154,8 +154,8 @@ class Builder
     }
 
     /**
-     * @param Directory $parent
      * @param string $title
+     *
      * @return Directory
      */
     public static function getOrCreateDir(Directory $parent, $title)
@@ -173,8 +173,8 @@ class Builder
     }
 
     /**
-     * @param Directory $parent
      * @param string $path
+     *
      * @return ContentAbstract
      */
     public static function getOrCreatePage(Directory $parent, $path)
@@ -214,11 +214,10 @@ class Builder
     }
 
     /**
-     * Sort the tree recursively
-     *
-     * @param Directory $current
+     * Sort the tree recursively.
      */
-    public static function sortTree(Directory $current) {
+    public static function sortTree(Directory $current)
+    {
         $current->sort();
         foreach ($current->getEntries() as $entry) {
             if ($entry instanceof Directory) {
@@ -228,10 +227,10 @@ class Builder
     }
 
     /**
-     * Calculate next and previous for all pages
+     * Calculate next and previous for all pages.
      *
-     * @param Directory $current
      * @param null|Content $prev
+     *
      * @return null|Content
      */
     public static function finalizeTree(Directory $current, $prev = null)
@@ -251,5 +250,4 @@ class Builder
 
         return $prev;
     }
-
 }

libs/Tree/Content.php

@@ -24,8 +24,8 @@ class Content extends ContentAbstract
     {
         if ($this->manuallySetContent) {
             $content = $this->content;
-        } else if (!$this->getPath()) {
-            throw new RuntimeException("Empty content");
+        } elseif (!$this->getPath()) {
+            throw new RuntimeException('Empty content');
         } else {
             $content = file_get_contents($this->getPath());
         }
@@ -40,9 +40,6 @@ class Content extends ContentAbstract
         return $frontMatter->parse($content);
     }
 
-    /**
-     * @return string
-     */
     public function getContent(): string
     {
         if ($this->attributes === null) {
@@ -52,9 +49,6 @@ class Content extends ContentAbstract
         return $this->content;
     }
 
-    /**
-     * @param string $content
-     */
     public function setContent(string $content): void
     {
         $this->manuallySetContent = true;
@@ -69,9 +63,6 @@ class Content extends ContentAbstract
         return $this->previous;
     }
 
-    /**
-     * @param Content $previous
-     */
     public function setPrevious(Content $previous)
     {
         $this->previous = $previous;
@@ -85,9 +76,6 @@ class Content extends ContentAbstract
         return $this->next;
     }
 
-    /**
-     * @param Content $next
-     */
     public function setNext(Content $next)
     {
         $this->next = $next;
@@ -130,10 +118,11 @@ class Content extends ContentAbstract
     }
 
     /**
-     * Get one or all attributes for the content
+     * Get one or all attributes for the content.
      *
-     * @param string|null $key
-     * @return array|mixed|null
+     * @param null|string $key
+     *
+     * @return null|array|mixed
      */
     public function getAttribute($key = null)
     {

libs/Tree/ContentAbstract.php

@@ -5,17 +5,11 @@ abstract class ContentAbstract extends Entry
     /** @var string */
     protected $content;
 
-    /**
-     * @return string
-     */
     public function getContent(): string
     {
         return $this->content;
     }
 
-    /**
-     * @param string $content
-     */
     public function setContent(string $content): void
     {
         $this->content = $content;

libs/Tree/Directory.php

@@ -44,6 +44,7 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
 
             if ($name == 'index' || $name == '_index') {
                 $buckets['index'][$key] = $entry;
+
                 continue;
             }
 
@@ -51,10 +52,12 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
                 if (is_numeric($name[1])) {
                     $exploded = explode('_', $name);
                     $buckets['down_numeric'][abs(substr($exploded[0], 1))][$key] = $entry;
+
                     continue;
                 }
 
                 $buckets['down'][$key] = $entry;
+
                 continue;
             }
 
@@ -62,16 +65,19 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
                 if (is_numeric($name[1])) {
                     $exploded = explode('_', $name);
                     $buckets['up_numeric'][abs(substr($exploded[0], 1))][$key] = $entry;
+
                     continue;
                 }
 
                 $buckets['up'][$key] = $entry;
+
                 continue;
             }
 
             if (is_numeric($name[0])) {
                 $exploded = explode('_', $name);
                 $buckets['numeric'][abs($exploded[0])][$key] = $entry;
+
                 continue;
             }
 
@@ -95,7 +101,7 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
 
     private function sortBucket($bucket, $final)
     {
-        uasort($bucket, function(Entry $a, Entry $b) {
+        uasort($bucket, function (Entry $a, Entry $b) {
             return strcasecmp($a->getName(), $b->getName());
         });
 
@@ -124,9 +130,6 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
         unset($this->children[$entry->getUri()]);
     }
 
-    /**
-     * @return Config
-     */
     public function getConfig(): Config
     {
         if (!$this->parent) {
@@ -136,7 +139,8 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
         return $this->parent->getConfig();
     }
 
-    public function getLocalIndexPage() {
+    public function getLocalIndexPage()
+    {
         $index_key = $this->getConfig()->getIndexKey();
 
         if (isset($this->children[$index_key])) {
@@ -146,9 +150,6 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
         return false;
     }
 
-    /**
-     * @return Content|null
-     */
     public function getIndexPage(): ?Content
     {
         $indexPage = $this->getLocalIndexPage();
@@ -165,8 +166,7 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
     }
 
     /**
-     * Seek the first available page from descendants
-     * @return Content|null
+     * Seek the first available page from descendants.
      */
     public function seekFirstPage(): ?Content
     {
@@ -190,9 +190,6 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
         return null;
     }
 
-    /**
-     * @return Content|null
-     */
     public function getFirstPage(): ?Content
     {
         if ($this->first_page) {
@@ -225,9 +222,6 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
         return null;
     }
 
-    /**
-     * @param Content $first_page
-     */
     public function setFirstPage(Content $first_page)
     {
         $this->first_page = $first_page;
@@ -235,16 +229,15 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
 
     /**
      * Used when creating the navigation.
-     * Hides folders without showable content
-     *
-     * @return bool
+     * Hides folders without showable content.
      */
     public function hasContent(): bool
     {
         foreach ($this->getEntries() as $node) {
             if ($node instanceof Content) {
                 return true;
-            } elseif ($node instanceof self) {
+            }
+            if ($node instanceof self) {
                 if ($node->hasContent()) {
                     return true;
                 }
@@ -269,9 +262,11 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
     }
 
     /**
-     * Whether a offset exists
-     * @param mixed $offset An offset to check for.
-     * @return bool true on success or false on failure.
+     * Whether a offset exists.
+     *
+     * @param mixed $offset an offset to check for
+     *
+     * @return bool true on success or false on failure
      */
     public function offsetExists($offset): bool
     {
@@ -279,9 +274,11 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
     }
 
     /**
-     * Offset to retrieve
-     * @param mixed $offset The offset to retrieve.
-     * @return Entry Can return all value types.
+     * Offset to retrieve.
+     *
+     * @param mixed $offset the offset to retrieve
+     *
+     * @return Entry can return all value types
      */
     public function offsetGet($offset)
     {
@@ -289,10 +286,10 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
     }
 
     /**
-     * Offset to set
-     * @param mixed $offset The offset to assign the value to.
-     * @param Entry $value The value to set.
-     * @return void
+     * Offset to set.
+     *
+     * @param mixed $offset the offset to assign the value to
+     * @param Entry $value the value to set
      */
     public function offsetSet($offset, $value)
     {
@@ -304,9 +301,9 @@ class Directory extends Entry implements \ArrayAccess, \IteratorAggregate
     }
 
     /**
-     * Offset to unset
+     * Offset to unset.
+     *
      * @param string $offset the offset to unset
-     * @return void
      */
     public function offsetUnset($offset)
     {

libs/Tree/Entry.php

@@ -23,7 +23,6 @@ abstract class Entry
     protected $path;
 
     /**
-     * @param Directory $parent
      * @param string $uri
      * @param SplFileInfo $info
      */
@@ -86,9 +85,6 @@ abstract class Entry
         return $this->title;
     }
 
-    /**
-     * @param string $title
-     */
     public function setTitle(string $title)
     {
         $this->title = $title;
@@ -103,7 +99,7 @@ abstract class Entry
     }
 
     /**
-     * Return all parents starting with the root
+     * Return all parents starting with the root.
      *
      * @return Directory[]
      */
@@ -118,9 +114,6 @@ abstract class Entry
         return $parents;
     }
 
-    /**
-     * @param Directory $parent
-     */
     protected function setParent(Directory $parent)
     {
         if ($this->parent) {
@@ -140,9 +133,7 @@ abstract class Entry
     }
 
     /**
-     * Get the path to the file from the root of the documentation
-     *
-     * @return string
+     * Get the path to the file from the root of the documentation.
      */
     public function getRelativePath(): string
     {
@@ -154,17 +145,11 @@ abstract class Entry
         return substr($this->path, strlen($root->getPath()) + 1);
     }
 
-    /**
-     * @return SplFileInfo
-     */
     public function getFileinfo(): SplFileInfo
     {
         return $this->info;
     }
 
-    /**
-     * @return string
-     */
     public function getUrl(): string
     {
         $url = '';
@@ -190,7 +175,8 @@ abstract class Entry
         ];
     }
 
-    public function isHotPath(Entry $node = null) {
+    public function isHotPath(Entry $node = null)
+    {
         return $this->parent->isHotPath($node ?: $this);
     }
 }

libs/Tree/Root.php

@@ -11,7 +11,7 @@ class Root extends Directory
     protected $activeNode;
 
     /**
-     * The root doesn't have a parent
+     * The root doesn't have a parent.
      */
     public function __construct(Config $config)
     {
@@ -21,23 +21,18 @@ class Root extends Directory
         $this->path = $config->getDocumentationDirectory();
     }
 
-    /**
-     * @return Config
-     */
     public function getConfig(): Config
     {
         return $this->config;
     }
 
-    /**
-     * @param Config $config
-     */
     public function setConfig(Config $config)
     {
         $this->config = $config;
     }
 
-    public function isHotPath(Entry $node = null): bool {
+    public function isHotPath(Entry $node = null): bool
+    {
         if ($node == null) {
             return true;
         }
@@ -59,7 +54,8 @@ class Root extends Directory
         return false;
     }
 
-    public function setActiveNode(Entry $node) {
+    public function setActiveNode(Entry $node)
+    {
         $this->activeNode = $node;
     }
 }

libs/bootstrap.php

@@ -1,6 +1,7 @@
 <?php
 
-function loadApp() {
+function loadApp()
+{
     // Loaded as a dependency
     if (file_exists(__DIR__ . '/../../../autoload.php')) {
         return require_once __DIR__ . '/../../../autoload.php';
@@ -10,7 +11,7 @@ function loadApp() {
     if (file_exists(__DIR__ . '/../vendor/autoload.php')) {
         return require_once __DIR__ . '/../vendor/autoload.php';
     }
-    
+
     throw new Exception('Impossible to load Daux, missing vendor/');
 }
 
@@ -20,16 +21,16 @@ $loader = loadApp();
 // find the daux processor extensions
 if ($loader) {
     $ext = __DIR__ . '/../daux';
-    if (is_dir(getcwd() . "/daux")) {
-        $ext = getcwd() . "/daux";
+    if (is_dir(getcwd() . '/daux')) {
+        $ext = getcwd() . '/daux';
     }
-    
+
     $env = getenv('DAUX_EXTENSION');
     if ($env && is_dir($env)) {
         $ext = $env;
     }
-    
+
     define('DAUX_EXTENSION', $ext);
 
-    $loader->setPsr4("Todaymade\\Daux\\Extension\\", $ext);
+    $loader->setPsr4('Todaymade\\Daux\\Extension\\', $ext);
 }