Nera is a really simple static site generator. It creates static html files out of
Markdown files.
Make sure you run at least Node version 10.2 on your system
git clone [email protected]:seebaermichi/nera.git
# Install dependencies
npm install
# Run local server
npm run serve
# Render the static files
npm run render
# Local development
npm start
|-- assets/
|-- config/
|-- app.yaml
|-- pages/
|-- src/
|-- plugins/
|-- nera.js
|-- views/
|-- index.js
Are all CSS, JavaScript, font and image files which are used on your website. During the render process all assets are copied to the public
directory.
Here you can define global settings for your website. All the global settings should got to the config/app.yaml
. Like lang, name, etc.
Within the pages directory you add the Markdown files which actually include the content of your page. Find more information about the Markdown files below.
The src
directory include the app itself. Here you find the nera.js
file which includes all the functionality to run the
app.
The src
folder also includes the plugins
folder. In it you would place additional functionality. There is already an
example, the main navigation. Find detailed documentation about plugins in the plugins README file.
In the views directory you put all the layout files. We use pug as a templating framework.
Each Markdown file which includes the content of a dedicated webpage needs to have some settings in the head. See an example below:
---
layout: pages/default.pug
title: Homepage
---
# Content
Content goes here...
Of course you can add many more so called meta data. It will be available in the view files as
meta
object.
In addition the basic config values are available within theapp
object.