Soushi (草紙 in Japanese) is a bimodal site generator powered by PHP.
In what way is Soushi bimodal?
Soushi is bimodal in terms of that it supports both generating a static Web site for GitHub Pages and serving contents dynamically via PHP scripts which can be simply put onto Web server, making HTML files from source files written in Markdown.
Soushi exploits the strength of PHP which allows us to easily deploy scripts and which is, itself, a template language, being enhanced by Plates library.
This Web site itself is built with Soushi. You can also consult the repository above to get an example of how to create a Web site with Soushi.
Firstly, create a directory for your awesome site and track a remote repository from there.
$ mkdir your-awesome-site $ cd your-awesome-site $ git init $ git remote add origin firstname.lastname@example.org:your-github-account/your-awesome-site.git
Secondly, add dependency on kentaro/soushi using composer.
$ composer require kentaro/soushi
And finally, initialise the project using
$ ./vendor/bin/soushi init
As a result, you can see some files and directories tree like below:
.gitignore config.php build/ public/ └─ .htaccess └─ index.php source/ templates/
Now you are ready to enjoy Soushi!