pile

Table of Contents



This page is generated via scout. For now it just shows the project README. You can check the full source code here

test.svg?style=flat-square pile.svg?style=flat-square

Source code for my web site setup. pile wraps around org-publish and adds a few functions to improve the experience of generating static htmls.

The package lives on a commit-on-need basis so might not be in good shape at any point in time. The basic item here is a pile-project which can be of the wiki type (focused on having updatable set of pages, like in a regular wiki) or a blog type (a stream of posts, dated and tagged). These projects then define the kind of embellishments the pages get using a bunch of hooks and/or org level config using the org-export and org-publish infrastructure.

Overall this setup is sometimes annoying and slow but works mostly okay for me.

1. Workflow Notes

1.1. Hooks

There are two hooks that work with the pile-publish- functions. See ./pile-hook.el for example functions.

  1. pile-pre-publish-hook. Functions here are added to org-export-before-parsing-hook and run in the to-be-published Org mode buffer.
  2. pile-post-publish-hook. These are added to org-publish-after-publishing-hook.

1.2. Configuration

The overall effect on my website is strongly tied to the following components:

  1. Org Export configuration here.
  2. The CSS theme for various HTML components on the page, kept here.
  3. Package configuration here.