Markdown-generated website
Generates a markdown-based website, using Silex PHP micro-framework & your own markdown files., (*1)
, (*2)
A damn simple markdown-based website
Summary: markdown-files-based, Bootstrap-based CMS, w/ dynamic navigation menu generation., (*3)
, (*4)
Markdown files use the markdown syntax, a very easy way to add typographical enhancements in your texts.
The /resources directory contains various markdown files, prefixed with a ordered number: Just add/modify markdown files in it: they will generate links in the navigation bar of your website., (*5)
Just start creating your own markdown files in the ./resources directory, and your website is up., (*6)
Markdown philosophy reminder: "A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.", (*7)
Anyway, you can mix html, inline-css (even if it's bad) & markdown between html tags, using a markdon="1" html attribute (see muffin.md page in this demo)., (*8)
Design: The website uses the latest version of Twitter Bootrap; you can tweak it easely, following the Bootstrap documentation.
Gears: Silexmarkdown project makes use of php-markdown library & the Silex Markdown Service Provider, (*9)
Installation
$ git clone git@github.com:ronanguilloux/Silex-Markdown.git
$ curl -sS https://getcomposer.org/installer | php
$ composer.phar install --dev
Apache2 vhost example:, (*10)
<VirtualHost *:80>
ServerName silexmarkdown
DocumentRoot /path/to/SilexMarkdown/web
DirectoryIndex index.php
<Directory /path.to/SilexMarkdown/web>
AllowOverride All
Allow from all
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.silexmarkdown.log
CustomLog ${APACHE_LOG_DIR}/access.silexmarkdown.log combined
</VirtualHost>
Tests
Tests need --dev option while installing dependecing using composer:, (*11)
$ composer.phar install --dev
$ ln -s ./vendor/phpunit/phpunit/phpunit.php phpunit
$ ./phpunit
License
This Silex markdown-based website generator is released under the MIT License.
See the bundled LICENSE file for details.
You can find a copy of this software here: https://github.com/ronanguilloux/SilexMarkdown, (*12)
Credits
Wallogit.com
