A little static site generator, built specifically to build little sites with blog posts.
composer require jeremyharris/build
- Stupid dumb easy setup (no config files)
- Concatenates assets
- Builds only modified files
- Some tools for basic blog functionality
$build = new \JeremyHarris\Build\Build('/path/to/site_target', 'path/to/build_target'); $build->build();
Only files that have been modified since you last built will be built. You can
build() to force build all files. You can then get
full paths to newly built files:
$newlyBuiltFiles = $build->getBuiltFiles(); // now deploy them!
If you want to manually add build files that aren't within the expected structure, you can do so:
// add a file to the build root $build->addFileToBuild('/full/path/to/file.html'); // add a file to a new directory within the build $build->addFileToBuild('/full/path/to/file.html', 'some/directory'); // render a file as a view (wrap it in the layout) $build->addFileToBuild('/path/to/my.php', 'some/directory', true); $build->addFileToBuild('/path/to/my.md', '/', true);
Some blogging functionality is provided in the
It assumes a
YYYY/MM structure. The
Blog class is helpful for building an
archive page or getting the latest post. Items returned are
objects that contain some helpful methods.
$Blog = new Blog('/path/to/site_target'); $latest = $Blog->getLatest(); $allPosts = $Blog->getPosts(); $linkToLatest = $latest->link(); $latestTitle = $latest->title();
To create an RSS feed, you must tell the builder that you want one and pass some required settings that the feed needs in order to generate:
$build = new \JeremyHarris\Build\Build('/path/to/site_target', 'path/to/build_target'); $build->addRss('My Blog', 'https://example.com', 'Description of site'); $build->build();
The generator will then automatically create a basic RSS feed for you. The file will be in the root of your built site. Only the last 20 blog posts will be included in the feed.
Site target structure
The site target should have a layout like the one below. Anything in
is copied directly to webroot, allowing flexibility in not using views. Items
/views are wrapped in
layout.php and placed into the directories they
reside in. Views can be php or markdown.
Titles are assumed from the filename slug, so
is titled "Interesting Article About Things".
site |_ views | | | |_ about.php | |_ contact.md | |_ sub | |_ article.php |_ assets | |_ css | | |_ css1.css | | |_ css2.css | | | |_ js | |_ script1.js | |_ script2.js | |_ webroot | |_ robots.txt | |_ fonts | |_ font1.otf | |_ layout.php
And builds it into a site like this:
build |_ fonts | |_ font1.otf | |_ sub | |_ article.html | |_ styles.css |_ scripts.js |- rss.xml |_ about.html |_ contact.html |_ robots.txt
rss.xml will only exist if you added an RSS feed before build.