PHPackages                             themsaid/katana - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating &amp; Views](/categories/templating)
4. /
5. themsaid/katana

AbandonedArchivedLibrary[Templating &amp; Views](/categories/templating)

themsaid/katana
===============

A neat static site &amp; blog generator with markdown support.

v1.1.0(9y ago)3801.7k39[7 issues](https://github.com/themsaid/katana/issues)[1 PRs](https://github.com/themsaid/katana/pulls)MITHTMLPHP &gt;=5.5.9

Since Mar 1Pushed 8y ago14 watchersCompare

[ Source](https://github.com/themsaid/katana)[ Packagist](https://packagist.org/packages/themsaid/katana)[ RSS](/packages/themsaid-katana/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (5)Dependencies (1)Versions (8)Used By (0)

Katana static site &amp; blog generator
=======================================

[](#katana-static-site--blog-generator)

[![Latest Version on Packagist](https://camo.githubusercontent.com/950f4b04e6049e3ecea1d4e0771b45234e1f11eb638d5bb866baeb39466719e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7468656d736169642f6b6174616e612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/themsaid/katana)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.txt)[![Total Downloads](https://camo.githubusercontent.com/92771c1313c7d93811c0ddae3634806500ac878c439f836677cc37ea7357402f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7468656d736169642f6b6174616e612d636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/themsaid/katana-core)

PHP static site &amp; blog generator with markdown support.

Using the power of laravel's Blade templating engine.

[![Katana static site & blog generator](https://camo.githubusercontent.com/154fc3120568deb1bdfa72277837b347ea40bb90b876b14c343bd4aca1a6e0aa/687474703a2f2f7331342e706f7374696d672e6f72672f6131677167327a73312f6b6174616e612e6a7067)](https://camo.githubusercontent.com/154fc3120568deb1bdfa72277837b347ea40bb90b876b14c343bd4aca1a6e0aa/687474703a2f2f7331342e706f7374696d672e6f72672f6131677167327a73312f6b6174616e612e6a7067)

> Katana was inspired by [Jigsaw](https://github.com/tightenco/jigsaw) by [Adam Wathan](http://adamwathan.me/) and the folks at [Tighten](http://tighten.co/).

Requirements
------------

[](#requirements)

- PHP 5.5.9+ or newer
- Apache or Nginx server
- [Composer](https://getcomposer.org)

Installation
------------

[](#installation)

To install a fresh Katana installation you need to [install composer](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx) &amp; 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
-------------

[](#documentation)

The complete Katana documentation can be found here:

Blog generator
--------------

[](#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-templating-engine)

Blade is a simple yet powerful templating engine built for laravel, you need to [check Blade's documentation](https://laravel.com/docs/5.2/blade) if you're not already familiar with it.

Using with GitHub Pages
-----------------------

[](#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](http://themsaid.github.io/katana/).

Contribution
------------

[](#contribution)

Contributions are welcomed in this repository  where all source files exist.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 89.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Recently: every ~31 days

Total

6

Last Release

3601d ago

Major Versions

v0.2.1 → 1.0.x-dev2016-03-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/7d96f0f919e9a1fd887da3f75818b1aad4ae2e2b82a1040641c4d1b4d621b712?d=identicon)[themsaid](/maintainers/themsaid)

---

Top Contributors

[![themsaid](https://avatars.githubusercontent.com/u/4332182?v=4)](https://github.com/themsaid "themsaid (43 commits)")[![mabasic](https://avatars.githubusercontent.com/u/1839930?v=4)](https://github.com/mabasic "mabasic (2 commits)")[![alibo](https://avatars.githubusercontent.com/u/5338482?v=4)](https://github.com/alibo "alibo (1 commits)")[![JayBizzle](https://avatars.githubusercontent.com/u/340752?v=4)](https://github.com/JayBizzle "JayBizzle (1 commits)")[![mul14](https://avatars.githubusercontent.com/u/113989?v=4)](https://github.com/mul14 "mul14 (1 commits)")

---

Tags

generatorblademarkdownstaticcmssiteflat file

### Embed Badge

![Health badge](/badges/themsaid-katana/health.svg)

```
[![Health](https://phpackages.com/badges/themsaid-katana/health.svg)](https://phpackages.com/packages/themsaid-katana)
```

###  Alternatives

[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)[picocms/pico

Pico is a flat file CMS, this means there is no administration backend and database to deal with. You simply create .md files in the "content" folder and that becomes a page.

3.9k37.8k11](/packages/picocms-pico)[aschmelyun/cleaver

A blazing-fast static site generator using Laravel's Blade templating engine

2961.0k](/packages/aschmelyun-cleaver)[tightenco/jigsaw-blog-template

Blog starter template for Jigsaw static site generator by Tighten

9464.0k](/packages/tightenco-jigsaw-blog-template)[tightenco/jigsaw-docs-template

Documentation starter template for Jigsaw static site generator by Tighten

5026.9k](/packages/tightenco-jigsaw-docs-template)[picocms/pico-composer

Pico is a flat file CMS, this means there is no administration backend and database to deal with. You simply create .md files in the "content" folder and that becomes a page.

2020.6k](/packages/picocms-pico-composer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
