# ONEPAGE

### Overview

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

- Read markdown files
- Parse md to html by [pulldown cmark](https://docs.rs/pulldown-cmark/latest/pulldown_cmark/)
- Render into [tera template](https://github.com/Keats/tera)
- styled by [picocss](https://picocss.com/) and [highlightjs](https://highlightjs.org/)

#### Online demo

[My blog](https://blog.nexts.top)

### 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

- [Build Your Own Static Site Generator](https://blog.hamaluik.ca/posts/build-your-own-static-site-generator/)
- [Building a static site generator in 100 lines of Rust](https://kerkour.com/rust-static-site-generator)
- [mdblog](https://github.com/FuGangqiang/mdblog.rs)