This is a mirror of http://vitali64.duckdns.org/git/utils/seen.git . Issues are accepted.

Ferass 'Vitali64' EL HAFIDI 3d5e37ba70 Change copyright 2 years ago
articles bfd21f4ff1 example article points to old readme 2 years ago
templates 09ba14c645 Add ability to display welcome text at index.html 2 years ago
.gitignore d5e389a570 Add example article 3 years ago
LICENSE f58ec195a3 Add LICENSE file 3 years ago
README.md 65810b9070 whoops! 2 years ago
rss.cfg 9c249fe503 add rss on the same seen.sh script 2 years ago
seen.sh 3d5e37ba70 Change copyright 2 years ago

README.md

seen

A simple blog generator

Facts

  • Doesn't depend on GNU extensions

  • POSIX compliant

  • Works on non-GNU distros (such as Alpine)

  • Works on BSD systems (such as MacOS and OpenBSD)

  • Depends on markdown/hoedown

  • Less than 100 SLOC

How to use

First, install markdown/hoedown because this script uses it heavily.

Put your markdown files on articles/<name of file>.md (create the directory if it doesn't exist).

You also need to create a config file. Put it in articles/<name of file>.cfg. It should use the same name your markdown file uses:

name="Hello World"
desc="Welcome to my blog!"
date="9th December 2021"

You can create RSS feeds too, just modify the rss.cfg file to your liking:

rssEnabled="y" # Enable RSS
rssBlogTitle="foobar's blog"
rssBlogDescription="foobar loves cooking!!!!!!!"

And run the following:

$ chmod +x seen.sh
$ ./seen.sh

Your blog is in the www/ directory. You can make your webserver use it. You can also use CSS files, just put them into the templates/ directory.

Feel free to customize other html files present in that directory.

Seen supports other options too, for more info, run the following:

$ ./seen.sh --help