kohkimakimoto/site-generator

A simple static site generator.

SiteGenerator

A simple static site generator., _(*1)

Installation

Create composer.json for installing via composer., _(*2)

{
      "require": {
          "kohkimakimoto/site-generator": "dev-master"
      }
}

Run composer install command., _(*3)

$ composer install

Usage

Run init command to create a basic directory structure and generator.yml., _(*4)

$ php vendor/bin/site init

Created directory structure is the following, _(*5)

.
├── dest             # Root directory contains generated site resouces.
├── source           # Root directory contains source files of site.
│   ├── helpers      # Helpers contains PHP files are difined some user functions.
│   ├── layouts      # Layouts contains layout files.
│   ├── public       # Public is simply copied to dest directory.
│   └── views        # Views is processed to output files to dest directory.
└── generator.yml    # Main configuration file.

Run generate command to generate a static site from a source., _(*6)

$ php vendor/bin/site generate

Also, you can run generate command with --watch and --server options in the development stage., _(*7)

$ php vendor/bin/site generate --watch --server

If you use --server option, You can see the site at http://localhost:1234/., _(*8)

If you want to clear the dest directory, you should run clear command., _(*9)

$ php vendor/bin/site clear

TODO

• Supporting to generate asset files.

References

It's inspired the following products., _(*10)

• sculpin
• jekyll