zs-starter-template/index.md

102 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2023-03-21 17:15:30 +03:00
# zs-starter-template
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
2023-03-26 18:15:04 +03:00
- A basic layout using a modified version of [bahunya][bahunya] for style
- [live.js](live.js) for faster development
- Examples of several built-in extensions
2024-03-03 08:16:15 +03:00
- Editable from within the browser!
## 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
2023-03-18 10:27:10 +03:00
## 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).
2023-03-26 18:15:04 +03:00
> 💡 **Tip:** Try hovering over any of the headings on this page!
2023-03-18 10:27:10 +03:00
### 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:
![](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
### 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
2023-03-29 17:12:38 +03:00
With the [wikilink][wikilink] extension you can link to other pages more easily like [[SandBox]].
2023-03-18 10:27:10 +03:00
### We can even do slides!
2023-03-30 15:52:12 +03:00
{{ list slides }}
2023-04-02 17:25:08 +03:00
### And Kanban Boards!
- [[TODO]]
### Remember cgi scripts?
- [[TestCGI]]
## License
2023-03-18 10:27:10 +03:00
`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
2023-03-18 10:42:08 +03:00
[zs]: https://git.mills.io/prologic/zs
[bahunya]: https://github.com/Kimeiga/bahunya