create-static-web
v0.9.5
Published
Create static websites easily with the expected defaults
Downloads
31
Maintainers
franciscopReadme
Create-Static-Web
Another static site generator:
$ npm install create-static-web -g
$ web|Transformations |Features |
|------------------------------------|-------------------------------------|
|.liquid .hbs → .html |• Works out of the box |
|.md + layout: → .html |• Livereload |
|.scss .sass → .min.css |• Extensible with hooks [WIP] |
|.src.js → .min.js [WIP] |• Basic compatibility with Jekyll |
Getting Started
Create your readme.md:
---
layout: hello.hbs
---
Front-matter enabled websiteAlso your _hello.hbs file:
<main>{{ body }}</main>Voila! Your site should be ready to go:
<main>
<p>Front-matter enabled website</p>
</main>Demo
Clone this repo and run web:
$ npm install create-static-web -g
$ git clone https://github.com/franciscop/create-static-web.git
$ cd create-static-web
$ web # The browser will open with this readmeAutomatic compilation
The command web will automatically compile some extensions (explained below). Except if they also start by an underscore. Then they will be considered partials and not be rendered by default.
Liquid template
These will be rendered (excluding Partials) into a file with the same name and the extension html:
./index.liquid→./index.html./demo.liquid→./demo.html./blog/index.liquid→./blog/index.html
They will receive the data as specified in the Data Specification:
// index.liquid
<!DOCTYPE html>
<html>
<head>
<title>{{title}}</title>
...
</head>
...
</html>SASS and SCSS
The style files (excluding Partials) will be compiled to a file with the same name in the same folder, with the extension .min.css:
./style.scss→./style.min.css./demo.scss→./demo.min.css./blog/style.scss→./blog/style.min.css
Then you have to include it in your template as normal:
// index.hbs
<!DOCTYPE html>
<html>
<head>
...
<link rel="stylesheet" href="/style.min.css">
</head>
...
</html>Files ending with these extensions will be automatically compiled:
.liquid, .hbs, .sass, .scss
They are compiled to the same folder with the same filename. SASS and SCSS will add a .min to the extension to differentiate in case you have any .css.
Partials
Partials are useful in two situation: as layouts and to be included in another files.
Data Specification
A file called static.config.js in the same folder where the script is being run will be loaded as a configuration script.
Front Matter
There is a special variable called content (aliased as body) which represents the Markdown content as html into your template:
// index.liquid
<!DOCTYPE html>
<html>
<head>
<title>{{title}}</title>
...
</head>
<body>
{{ body }}
</body>
</html>