Hello World
Your first Spignite project!
Spignite projects are common Node projects. You should be familiar with JavaScript eco-system - sorry, this tool is not for faint-hearted 💪.
package.json
Create a new folder for your website. Create
package.json that looks like this (common fields are omitted):package.json
1
{
2
"scripts": {
3
"clean": "rm -rf out",
4
"dev": "node spig.js dev",
5
"build": "node spig.js"
6
},
7
"dependencies": {
8
"spignite": "^2.4.1"
9
}
10
}
Copied!
Nothing crazy, as you can see.
Spignite expects certain folder structure to be followed. We will talk more about it later; for now just keep in mind the whole site is defined in
src subfolder.Markdown content
Now, let's make some pages. Create the content for index page:
src/site/index.md
1
Hello **world**
Copied!
Templates
src/layout/base.njk
1
<!doctype html>
2
<html>
3
<body>
4
{{ content | safe }}
5
</body>
6
</html>
Copied!
spig.js
The last thing is to run Spignite. Add the
spig.js into your projects root:spig.js
1
const { Spig } = require('spignite');
2
3
Spig
4
.on('/**/*.md')
5
6
._('RENDER')
7
.pageLinks()
8
.render()
9
.applyTemplate()
10
;
11
12
Spig.run();
Copied!
This is the main program that runs Spignite. We will describe it in more details later. Still, it is quite clear that we define certain flow of operations over input files. Something like this:
- 1.On all
mdfiles... - 2.in the
RENDERphase... - 3.make page links (i.e. change
.mdto.html)... - 4.render all
.mdcontent... - 5.and apply the template.
Easy, right?
Run! 🚀
That's all - execute the following in projects root and sit and enjoy the show!
1
npm install && npm run build
Copied!
The output would be similar to this:
Check out the
out folder! The index.html awaits:out/index.html
1
<!doctype html>
2
<html>
3
<body>
4
<p>Hello <strong>world</strong></p>
5
</body>
6
</html>
7
Copied!
Great!
Last modified 8mo ago
Export as PDF
Copy link