Pufferfish is an extensible html templating engine that generates raw html, meaning that it will not affect load times of websites.
A full-blown javascript framework is sometimes a bit overkill for a static website. Pufferfish adds some simple templating to html so you don't have to use such a framework for small projects or for pages that require fast loading. Pufferfish will compile your files to raw html.
Pufferfish is still under heavy development - A 1.0 release is currently being developped in the 1.0 branch. This is a restructure of the project and will implement a lot of new features
Table of contents
To include a template file inside of html, simply write %filename%.
Example
<html>
<body>
%menu%
%header.html%
%footer.handlebars%
</body>
</html>If the filename does not include a file extension, .html will be used. You can also specify files with other file extensions.
When compiled, the html above will expand to include the menu.html, header.html and footer.handlebars file contents.
In the future, Pufferfish will support passing variabls to html. Pufferfish is still in early development. If you have any suggestions for its future, please suggest them by opening an issue!
The recommended folder structure for a Pufferfish project is the followng:
project_name
├── assets
├── html
├── output
├── templates
└── pufferfish.toml
html: contains the html of your website (like the file shown in the Syntax section as example).output: contains the output of pufferfish.templates: contains the files to be used as templates (e.g.menu.htmlin the example)Pufferfish.toml: the configuration file for the project
These directories can also be set using the config file.
Inside of the directory of the project, run puf build. This will take into account the the config file and build html to the output directory.
Every Pufferfish project needs a pufferfish.toml file.
The minimum config file looks like this:
[project]Here is a complete config file with all possible settings and their default values:
[project]
html_dir = "html"
template_dir = "templates"
output_dir = "output"
assets_dir = "assets"
pretty = false
minify = false
verbose = false
[minify]
method = "default" # values: (default | onepass)
minify_doctype = true
ensure_spec_compliant_unquoted_attribute_values = true
keep_closing_tags = true
keep_html_and_head_opening_tags = true
keep_spaces_between_attributes = false
keep_comments = false
minify_css = true
minify_js = true
remove_bangs = false
remove_processing_instructions = false
[server]
port = "8080"Go to the dedicated documentation or tutorial for more information on Pufferfish.
You can download Pufferfish with the following command:
curl "https://raw.githubusercontent.com/Jomy10/pufferfish/master/installation/install.sh" | shOr, you can download Pufferfish from npm:
npm i -g pufferfish-htmlTest if the package was installed using puf --version.
Head over to the Github releases page and download the correct build for your operating system. You now have an executable which can be moved to the correct directory (e.g. /usr/local/bin).
Pufferfish can be compiled for any platform, to do so, copy this repository:
git clone https://github.com/Jomy10/pufferfish.gitThen, go into the directory containing the project:
cd pufferfish/pufferfishRun cargo build --release and the executable will be put in the target directory.
Pufferfish is made so it can be included in other build processes. It also includes integrations with htmlbeautifier and minify-html (and minify-html-onepass).
Contributions are always welcome. Read the CONTRIBUTING file for more information!
Pufferfish is licensed under the MIT license.
© Jonas Everaert 2022