You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
webpack-plugin/README.md

121 lines
2.4 KiB

# Site-O-Mat Webpack Plugin
2 years ago
A Webpack Plugin for generating a Website as Html-Files from a Markdown File Structure.
2 years ago
2 years ago
Why? The Main reason i had to update some Websites, but realise there were no benfit
to use a Full CMS or Headless CMS like Directus. Rendering the same pages that a rarley updated
seems like a waste of energy. Why not generate from a hierachical file structure. Luckly i
i had development a CMS that runs on Markdown File a few years ago as a proof of concept.
2 years ago
## Roadmap
Next will be,
* Some tests
2 years ago
* Better Filtering in Queries
Maybe later,
2 years ago
* Integrate Eta.js and LiquidJS
2 years ago
## Installation
2 years ago
Setup this registry in your project .npmrc file:
```
@helpers:registry=https://gitea.node001.net/api/packages/HerrHase/npm/
```
Install with npm or yarn
2 years ago
```
2 years ago
npm i --save-dev @helpers/siteomat-webpack-plugin
yarn add --dev @helpers/siteomat-webpack-plugin
2 years ago
```
## Configuration
```
const SiteomatWebpackPlugin = require('siteomat-webpack-plugin')
2 years ago
plugins: [
new SiteomatWebpackPlugin(
2 years ago
'./resources/site',
'./resources/views'
)
]
2 years ago
```
2 years ago
or
```
plugins: [
new SiteomatWebpackPlugin(
'./resources/site',
'./resources/views',
{
<options>
}
)
]
```
2 years ago
| Name | Type | Default | Description |
|-------------|-----------|---------|-------------|
| destination | {String} | null | If not set, it will use the public path |
| htmlMinify | {Boolean} | true | Minify Html and remove all Whitespace |
## Pages
2 years ago
2 years ago
Pages are Markdown-Files, they are seperates in two parts. First part is a yaml-Section,
2 years ago
```
---
title: "health goth DIY tattooed"
view: "home.njk"
meta:
description: "La"
media:
teaser:
src: "_images/test.jpeg"
alt: "cold-pressed"
---
```
2 years ago
These yaml will be parsed as a Object and available in Templates. "view" is required. Second
part will be parsed as Markdown, but could be empty.
## Nesting
```
index.md
blog
 index.md
```
## Blocks
2 years ago
2 years ago
"_blocks" in a Directory,
## Queries
### Pages
2 years ago
Basic Usage:
```
pageQuery.find()
```
or with options,
| Name | Type | Default | Description |
|-------------|-----------|---------|-------------|
2 years ago
| parent | {String} | / | Directory for start query |
| deep | {Integer} | -1 | Deep of Recursive |
| orderBy | {Array} | null | Name of field sorting, a "-" in front of the. Nested fields are also possible. |
2 years ago