Releases: TimboKZ/blitz
Release list
v0.1.5 Release
Refer to the official changelog for more info.
- Removed unnecessary files from the
portfoliotemplate. - Made
portfoliothe default template.
v0.1.4 Release
Refer to the official changelog for more info.
- Made
assetsfolder optional. Now, if the Blitz attempts to build the website and theassetsfolder does not exist, Blitz simply carries on without copying any assets. - Made use of the
site_urlparameter in the config (it was previously unused). Now,site_urlis placed in front of all absolute URLs generated by Blitz. To avoid this behaviour and get absolute URLs without the host specified, simply setsite_urlto an empty string or remove it completely. - Added
menusproperty to child directories. Now, if you want all pages imported from a directory to appear in a specific menu, you can do something like this:
`yamlIn the config
pages:- template: 'blog.pug'
child_directories:- uri: '/'
name: 'posts'
template: 'post.pug'
directory: 'posts'Now you can specify menus:
menus:- name: 'name_of_menu_1'
- name: 'name_of_menu_2'
title: 'name_of_the_property_in_front_matter_to_use_as_title'
Here's where Blitz looks for thetitle` of a menu item (first property at the top, if none of the above exist the last one is used):
- uri: '/'
menu_titleproperty specified in content file's front matter.- Checks if
titlefor the menu was defined in the config. If so, uses the value oftitleas the property name to look for in the config. If property with such name was not defined in front matter, moves on to the next source. titleproperty specified in content file's front matter.- Finally, if none of the above exist, the file name of the content file is used.
- template: 'blog.pug'
- Refactored the
minimaltemplate, now it contains just theblitz.ymland a single Pug template. - Added new templates called
configandportfolio. Former contains just an example Blitz config and the latter is a simple portfolio website using Bootstrap. - Added integration tests for templates.
v0.1.3 Release
Refer to the official changelog for more info.
- Added config property validation. Blitz will now check the config for required properties and add them using default values if said properties are missing, or throw an error if the type of the property is invalid.
- Made
contentfor pages optional. Ifcontentis empty, Blitz is just going to render the file specified intemplateas if thecontentpointed to an empty file. Keep in mind, sinceuriis also optional you can now create pages using only 1 line, like so:
`yamlIn the config:
pages:- template: 'index.pug'
- template: 'help.pug'
`
v0.1.2 Release
-
Begun using front-matter package to extract front matter from files. As a consequence, the structure of Blitz content files has switched from:
` To: ` --- --- `
`
v0.1.1 Release
Refer to the official changelog for more info.
- Changed project homepage to https://getblitz.io/.
- Fix the bug where
contentfor content files with empty front matter (i.e. no YAML before---) would not be generated. - Added Travis CI config for easier unit/integration testing.
v0.1.0 Release
Refer to the official changelog for more info.
-
Added
hashto Pug locals available on every page. It's generated randomly every timeblitz buildis run, and can
be used to bypass browser's cache, like so:link(rel='stylesheet', href=asset('style.css?' + hash)) //- Will force browser to ignore cache and download the file again, result: //- <link rel="stylesheet" href="/assets/style.css?kNP2xjPl5Atk">
-
Added
url()function to Pug locals. If called with no arguments, it returns the URL of the current page. Accepts
page ID as the only argument, more about it below. -
Added
indexpage ID by default, available viaurl('index')in Pug. It points to the website root directory if
explicit_html_extensionsis set to false or to rootindex.htmlfile otherwise. It's useful for Home/Index links.
Keep in mind that index is produced regardless of whether the index page exists or not. This ID can be overwritten
from the config. -
Added page IDs to the config and the
url()function to Pug locals. Now, you can specify an ID for a page and then
reference it in your templates usingurl(<id>). Consider the example below:# In the config: pages: # ... - uri: '/docs' id: 'docs' # ...
//- Somewhere in your Pug template: a(href=url(docs))= 'Link to documentation'
-
Made the
templateproperty of directories specified inchild_directoriesoptional. If it is not present, no files
will be generated. This is useful if you just want to pass the content from all files in a directory without actually
creating the pages. -
Added
child_pagesandchild_directoriesto Pug locals. Contain all named child pages and all named child directories
respectively. Since both are arrays, one could iterate over them to retrieve content. If you're looking for an object that has all pages and directories named, usenamed_child_pagesandnamed_child_directories. -
Fixed order of menu items. Now items should appear in the same order as they were defined in the config.
v0.0.1 Alpha Release
Refer to the official changelog for more info.
- Initial release
- Blitz config
- Root pages
- Child pages and directories
- Menu with active menu points
- Relative or absolute links supported
- Explicit HTML extensions or directories (useful for offline browsing)
- Project initialisation from a template
- Assets support
- Parent page support
- Global variable support