/cl-github-page

Static Blog Generator——静态博客生成器

Primary LanguageCommon Lisp

Akashic - Static Blog Generator

Introduction

Akashic is a tool for generating the static blog based on GitHub Pages, written in Common Lisp.

Its original name is cl-github-page.

At the beginning, it was developed for simplifying the management of my blog built on the GitHub Pages. It just handles the generation of posts(.html files) and the update of the index.html file. The user can classify the posts into different categories and categories can be nesting. The categories is implemented by directories.

Features

  • Classify posts by categories
  • Atom file generation

Installation And Usage

In REPL, run the commands:

(push "/path/to/cl-github-page/directory/" asdf:*central-registry*) (asdf:load-system 'cl-github-page)

After loading the ASDF system, you can run the CL-GITHUB-PAGE:MAIN function for generating a static blog. There must be a directory for storing the directories and files of the blog, the default is directory `src/blog/' at your home directory.

Please ensure the blog directory contains the following sub-directories and files:

  • src/ -- For storing the Markdown source text files.
  • posts/ -- For storing the HTML files generated from corresponding Markdown files with same file name.
  • friends.lisp -- Contains the pairs of URLs and website names.

Author

Liutos(mat.liutos@gmail.com)

TODOs

  • convenience for debugging
  • use array for storing posts instead of list
  • use 3rd-party library for generating RSS and Atom
  • remove the categories bar in post page