matks/markdown-blog-bundle

Markdown files based Bundle to integrate a simple blog in your Symfony application

MarkdownBlogBundle

, _(*1)

Markdown files based Bundle to integrate a simple blog in your Symfony application, _(*2)

, _(*3)

Installation

Require the bundle, _(*4)

$ composer require matks/markdown-blog-bundle

Enable the bundle in your Symfony application, _(*5)

<?php
    // app/AppKernel.php

    public function registerBundles()
    {
        $bundles = array(
            // ...
            new \Matks\MarkdownBlogBundle\MarkdownBlogBundle(),
        )
    }

Configure the bundle, _(*6)

markdown_blog:
    posts_directory: 'path_to_my_markdown_docs'

Usage

Write your Markdown posts using your favorite Markdown Editor. Then copy them in your folder posts_directory., _(*7)

The post title will be parsed from the file name., _(*8)

Write a library_register.yml file in the folder posts_directory which will provide your posts metadata., _(*9)

Example:, _(*10)

library_entries:

    My-first-post:
        date: '2016-04-01'
        category: Blog

    Constructive-thoughts:
        date: '2016-04-01'
        category: Blog

    A-dev-tale:
        date: '2016-05-01'
        category: Dev
        tags: ['github', 'open-source']

For each blog entry, the entry name must match the Markdown file name. Available metadata is * date (string, format YYYY-MM-DD) * category (string) * tags (array of strings) * alias (string) ; overrides your post name, _(*11)

If there is a file but no entry in the register, the Post will still be available, however the publish date will be computed from the file creation timestamp., _(*12)

That's it ! Your blog data structure is available through the service markdown_blog.library (class Library)., _(*13)

You can get your posts using the following functions:, _(*14)

$library = $this->get('markdown_blog.library');

/** @var Post[] $allPosts */
$allPosts = $library->getAllPosts();

/** @var boolean $isPostRegistered */
$isPostRegistered = $library->isPostRegistered();

/** @var Post $post */
$post = $library->getPostByName();

/** @var Post[] $posts */
$posts = $library->getPostsByName();

/** @var Post[] $posts */
$posts = $library->getPostsByDate();

/** @var Post[] $posts */
$posts = $library->getPostsByCategory();

/** @var Post[] $posts */
$posts = $library->getPostsByTag();

You can now display your blog using any template you want. Example:, _(*15)

<?php

namespace AppBundle\Controller;

use Matks\MarkdownBlogBundle\Blog\Library;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;

class BlogController extends Controller
{
    public function indexAction(Request $request)
    {
        $library = $this->getLibrary();
        $allPosts = $library->getAllPosts();

        return $this->render(
            'default/index.html.twig',
            ['posts' => $allPosts]
        );
    }

    /**
     * @return Library
     */
    private function getLibrary()
    {
        return $this->get('markdown_blog.library');
    }
}

You can have a look at the markdown-blog-bundle-example. It displays a blog using bootstrap templates., _(*16)

Tests

Stand alone context

In a bundle isolation context, just install the dev dependencies with composer, _(*17)

$ composer install

Run the unit tests suite with atoum binary, _(*18)

$ vendor/bin/atoum -bf vendor/autoload.php -d Tests/Unit/

Run functional tests with behat binary using the Symfony2 fixture application, _(*19)

$ vendor/bin/behat -c behat.ci.yml