Add travis checks for spaces and table of contents

Author: Slamdunk

Diff for: .travis-build.php

@@ -0,0 +1,70 @@
+<?php
+
+$readMeFilepath = __DIR__ . '/README.md';
+$readMeFile = new SplFileObject($readMeFilepath);
+$readMeFile->setFlags(SplFileObject::DROP_NEW_LINE);
+
+$cliRedBackground = "\033[37;41m";
+$cliReset = "\033[0m";
+$exitStatus = 0;
+
+$indentationSteps = 3;
+$manIndex = 0;
+$linesWithSpaces = [];
+$tableOfContentsStarted = null;
+$currentTableOfContentsChapters = [];
+$chaptersFound = [];
+foreach ($readMeFile as $lineNumber => $line) {
+    if (preg_match('/\s$/', $line)) {
+        $linesWithSpaces[] = sprintf('%5s: %s', 1 + $lineNumber, $line);
+    }
+    if (preg_match('/^(?<depth>##+)\s(?<title>.+)/', $line, $matches)) {
+        if (null === $tableOfContentsStarted) {
+            $tableOfContentsStarted = true;
+            continue;
+        }
+        $tableOfContentsStarted = false;
+
+        $chaptersFound[] = sprintf('%s [%s](#%s)',
+            strlen($matches['depth']) === 2
+                ? sprintf('  %s.', ++$manIndex)
+                : '     *'
+            ,
+            $matches['title'],
+            preg_replace(['/ /', '/[^-\w]+/'], ['-', ''], strtolower($matches['title']))
+        );
+    }
+    if ($tableOfContentsStarted === true && isset($line[0])) {
+        $currentTableOfContentsChapters[] = $line;
+    }
+}
+
+if (count($linesWithSpaces)) {
+    fwrite(STDERR, sprintf("${cliRedBackground}The following lines end with a space character:${cliReset}\n%s\n\n",
+        implode(PHP_EOL, $linesWithSpaces)
+    ));
+    $exitStatus = 1;
+}
+
+$currentTableOfContentsChaptersFilename = __DIR__ . '/current-chapters';
+$chaptersFoundFilename = __DIR__ . '/chapters-found';
+
+file_put_contents($currentTableOfContentsChaptersFilename, implode(PHP_EOL, $currentTableOfContentsChapters));
+file_put_contents($chaptersFoundFilename, implode(PHP_EOL, $chaptersFound));
+
+$tableOfContentsDiff = shell_exec(sprintf('diff --unified %s %s',
+    escapeshellarg($currentTableOfContentsChaptersFilename),
+    escapeshellarg($chaptersFoundFilename)
+));
+
+@ unlink($currentTableOfContentsChaptersFilename);
+@ unlink($chaptersFoundFilename);
+
+if (!empty($tableOfContentsDiff)) {
+    fwrite(STDERR, sprintf("${cliRedBackground}The table of contents is not aligned:${cliReset}\n%s\n\n",
+        $tableOfContentsDiff
+    ));
+    $exitStatus = 1;
+}
+
+exit($exitStatus);

Diff for: .travis.yml

@@ -0,0 +1,11 @@
+language: php
+
+sudo: false
+
+php:
+  - nightly
+
+script: php .travis-build.php
+
+notifications:
+  email: false