krzysztofair/blog

Flat file blog

Maintainers

Details

github.com/krzysztofair/blog

Homepage

Source

Issues

Installs: 10

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

1.0.0 2015-07-28 18:59 UTC

Requires

GPL-3.0+ 3a498776fb2001bdb20e5c3109d2df7b17258b2a

phpbloglightweightfastmodern

This package is not auto-updated.

Last update: 2025-04-16 11:57:26 UTC

README

If you can't find something that suits your needs - do it yourself

I was looking for simple and semi-lightweight blogging system with Markdown and Yaml files only. However existing ones was overloaded with plugins and functionality. So this is what I came out with.

Requirements

Get the latest PHP and composer to install dependencies.

Installation

You have two options:

composer create-project krzysztofair/blog --prefer-dist

or simply clone this repo, cd into it and install via composer:

composer install

Make sure the cache folder has 755 or 777 chmods

sudo chmod -R 777 cache

Your virtual host should point to public directory.

Customization

You can edit application views to customize the template. Put your assets into public/assets directory.

Writing posts

There are three steps for writing a new post.

  1. Add new post information in blog/blog.yaml configuration file under posts key. See sample data you can use in this file.
  2. Add new file under blog directory named slug.md, where slug is the same as in blog.yaml.
  3. git add and git push- and you're ready!