ONEPAGE

Overview

A simple static site genertor, convert md posts to html.

Read markdown files
Parse md to html by pulldown cmark
Render into tera template
styled by picocss and highlightjs

Online demo

Usage

from repo

clone this repo, and:
cargo run -- build to build pages
cargo run -- serve to build pages, and make a server at localhost

from cargo

cargo install onepage
onepage init [dir] : download template files from github
onepage serve
onepage build
onepage new {filename}: create new post

Structure

/pages: markdown source file
- index.md => index page
- /posts/*.md => post page
- /image images used in markdown file
/dist: generated site
/static: static resources
- /assets: img/css/font
- /favicon favicon files
/templates: html templates
/src: rust src

New post

make a .md file in /pages/posts/
you can copy from demo md files
at present, post page must have a fontmatter header, including title(required),date(required),tags(optional)
or you can use onepage new {filename} to create new post.

```

title: hello world

date: 2020-03-15 10:54:39

```

```

title: hello world date: 2020-03-15 10:54:39 tags: - awesome-tag

- more-awesome-tag

```

Todo

[ ] custom site config file (maybe not)
[x] generate new page
[x] live reload
[x] site initialize to new path
[x] css style
[x] add command line
[x] serve /dist
[x] watch /pages and rebuild

reference