mirror of
https://git.mills.io/prologic/zs-starter-template.git
synced 2024-11-24 22:36:04 +03:00
90 lines
2.3 KiB
Markdown
90 lines
2.3 KiB
Markdown
---
|
|
title: zs starter template
|
|
description: A starter template for the Zen Static (zs) site generator
|
|
keywords: zen, static, zs, starter, template, site, website, template, generator, ssg
|
|
---
|
|
|
|
This is a [zs](https://git.mills.io/prologic/zs) starter template. A live version of this site can be found [here](https://zs.mills.io).
|
|
|
|
## Features
|
|
|
|
- A basic index page with the content you see here
|
|
- A basic layout using [SimpleCSS](https://simplecss.org/) for style
|
|
- Uses [live.js](https://livejs.com/) to automatically reload pages when they change
|
|
- Examples of several extensions built-in to `zss
|
|
|
|
## Quick Start
|
|
|
|
```console
|
|
git clone https://git.mills.io/prologic/zs-starter-template.git
|
|
cd zs-starter-template
|
|
make dev
|
|
```
|
|
|
|
Open your browser to http://localhost:8000
|
|
|
|
## Examples
|
|
|
|
Aside from the regular Markdown [[TestPage]] that demonstrates the full capabilities of the Markdown support for [zs][zs], there are a number of additional extensions enabled by default:
|
|
|
|
### Anchors
|
|
|
|
With the [anchors][anchors] extension so you can link to any section(s) on the page like [Quick Start](#quick-start).
|
|
|
|
### D2 Diagrams
|
|
|
|
With the [d2][d2] extension you can draw and diagrams such as:
|
|
|
|
```d2
|
|
x -> y
|
|
```
|
|
|
|
### Embed
|
|
|
|
With the [embed][embed] extension you can embed [Youtube][youtube] videos like:
|
|
|
|
|
|
|
|
### Fences
|
|
|
|
With the [fences][fences] extension you can
|
|
:::{.blue}
|
|
## Life Inside Fences
|
|
|
|
We are now inside a div with the css-class "blue". This can be used to style this block
|
|
|
|
:::{#insideme .red data="important"}
|
|
fences can be nested and given ids as well as classes
|
|
:::
|
|
:::
|
|
|
|
### Highlighting
|
|
|
|
With the [highlighting][highlighting] extension you can syntax highlight code samples:
|
|
|
|
```go
|
|
package main
|
|
|
|
import "fm"
|
|
|
|
func main() {
|
|
fmt.Println("Hello World!");
|
|
}
|
|
```
|
|
|
|
### Wiki Links
|
|
|
|
With the [wikilinks][wikilinks] extension you can link to other pages more easily like [[SandBox]].
|
|
|
|
## License
|
|
|
|
`zs-starter-template` is licensed under the terms of the [WTFPL License](/LICENSE)
|
|
|
|
[anchor]: https://github.com/abhinav/goldmark-anchor
|
|
[d2]: https://github.com/FurqanSoftware/goldmark-d2
|
|
[embed]: https://github.com/13rac1/goldmark-embed
|
|
[fences]: https://github.com/stefanfritsch/goldmark-fences
|
|
[highlighting]: https://github.com/yuin/goldmark-highlighting
|
|
[wikilink]: https://github.com/abhinav/goldmark-wikilink
|
|
[zs]: https://git.mills.io/prologic/zs
|