README

PHP static site & blog generator with markdown support.

Using the power of laravel's Blade templating engine.

Katana was inspired by Jigsaw by Adam Wathan and the folks at Tighten.

Requirements

PHP 5.5.9+ or newer
Apache or Nginx server
Composer

Installation

To install a fresh Katana installation you need to install composer & run the following command:

composer create-project themsaid/katana my-new-site

Once the installation is done you may build your website using the command:

php katana build

Katana is shipped with sample content to help you get started immediately, and after this command runs your site will be generated in the /public directory.

Documentation

The complete Katana documentation can be found here: http://themsaid.github.io/katana/

Blog generator

Katana is shipped with a static blog generator, all you need to do is create a new .blade.php file in the /content/_blog directory and Katana will compile all the posts and present them in a view of your choice.

Blog posts list is paginated based on the configuration options in config.php. There's also a $blogPosts variable available in all your blade views that contains an array of posts.

Blade templating engine

Blade is a simple yet powerful templating engine built for laravel, you need to check Blade's documentation if you're not already familiar with it.

Using with GitHub Pages

You can use Katana to publish a website over GitHub Pages using subtrees, the idea is to deploy the public directory as the master branch of your user GitHub pages repository or the gh-pages branch of your project repository.

You can find the full details in the documentation.

Contribution

Contributions are welcomed in this repository https://github.com/themsaid/katana-core where all source files exist.

themsaid / katana

Maintainers

Details