Static site build system for datagirl.xyz.
https://datagirl.xyz/
snow flurry
fb0d94a2c0
- Per-image classes, to restrict what images a CSS selector acts on (in-post vs out-of-post) - Fenced aside blocks (`!!!`-enclosed, like code blocks) - Footnotes are handled by the Markdown parser, instead of manually |
||
|---|---|---|
| lib | ||
| build.pl | ||
| LICENSE | ||
| ptouch.pl | ||
| README.md | ||
dg-x
Static site build system for datagirl.xyz.
Dependencies
build.pl uses the following modules:
- Cwd
- File::Copy::Recursive
- File::Path
- File::Slurp
- Text::FrontMatter::YAML
- Text::MultiMarkdown
- Text::Template
ptouch.pl uses the following modules:
- Tie::File
- Getopt::Std
How to use
Make an initial directory with the following structure:
- site_dir/
- posts/
- pages/ - Templated pages
- assets/ - Static assets
- templates/ - Templates you can call with
include_tmpl
Either clone this repository to site_dir/scripts/, or add this repository as a git submodule.
To make a new post, create a file with the following format in the posts/ folder:
title=Your blog title
desc=[Not yet implemented] Description for the RSS feed
---
This is some content.
## About this content
Markdown is supported.
There is no set schema for tags, so you can put whatever you want as a tag. However, it may not be used by the build script.
Once you're happy with your post, use the ptouch script to set the created tag:
$ ./scripts/ptouch.pl -n posts/your_new_post
And then compile the site:
$ ./scripts/build.pl
The site can then be pushed with rsync, sftp, netcat, etc.