~rjpcasalino/bss

a boring static site generator written in perl
change wording in POD
rename some vars and adds a SIG handle
shell nix and README

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~rjpcasalino/bss
read/write
git@git.sr.ht:~rjpcasalino/bss

You can also use your local clone with git send-email.

this is a work in progress!

#bss - boring static site generator

A dead simple static site generator written in Perl with a little help from rsync.

#Getting Started

bss reads manifest.ini for its configuration options:

```
[build]
src=/the/path/to/your/site/src/
dest=/home/you/websites/_site/
templates_dir=src/templates
collections=posts
exclude=*.md,*.markdown,templates,junk
encoding=UTF-8
[server]
port=8090

```
Please note the lack of quotes in values.

Pages begin (as in Jekyll) with a YAML "front matter" block:  

```
---
title: Nine Stories
layout: default 
meta:
 - description: A collection of short stories by American fiction writer J. D. Salinger published in 1953. 
     - og:image
draft: true
    author: J.D. Salinger 
---
[% footer = 'partials/footer.tt' %]

The meta tags will end up nowhere. Hasn't been implemented yet. :-)

[% INCLUDE $footer %]
```

Template files can use any of the following file exts: `.tmpl, .template, .html, .tt, .tt2`.

A simple web server is included but one would be wise in using it only for local development purposes. Ensure the BSS_DOCROOT ENV var is set, like so:

$ export BSS_DOCROOT=/path/to/your/_site/ 
$ bss build --server

#TODO

  • [] meta tags

#Installing

I've been using fatpack. Although, perl has myriad other options. See fatpack examples if you wish to install it.