ronanguilloux/silexmarkdown

Markdown-generated dynamic website, using damn simple markdown files & Silex micro-framework

dev-master / 1.0.x-dev 2013-10-16 20:54 UTC

This package is auto-updated.

Last update: 2024-10-22 20:17:20 UTC


README

Generates a markdown-based website, using Silex PHP micro-framework & your own markdown files.

Build Status Total Downloads

A damn simple markdown-based website

Summary: markdown-files-based, Bootstrap-based CMS, w/ dynamic navigation menu generation.

PC Snapshot

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.

Just start creating your own markdown files in the ./resources directory, and your website is up.

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."

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).

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

Installation

$ git clone git@github.com:ronanguilloux/Silex-Markdown.git
$ curl -sS https://getcomposer.org/installer | php
$ composer.phar install --dev

Apache2 vhost example:

<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:

$ 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

Credits