Awestruct Requests

This page documents the change we would like to see in Awestruct.

• Support transformers for content, which would allow transformers to prepare data for layout template

  Note	This is needed by the guides extension to create and link the TOC

  Tip	This can be accomplished by using the Object#extend(module), where Module has method of same name, calls super

• Don’t require empty front matter (two consecutive --- lines) in content (layout could be provided by extension)

• move content() method in *able.rb to parent

• add site config option for setting asciidoc backend (xhtml11 or html5)

• add more sane way of getting the images directory for the site

• add support for slim as alternate to haml

• make markup types extensible like github markup rather than an explicit regex in engine

• Support grabbing vendor/assets from gem (like Rails asset pipeline)

• Support loading assets from CDN in production, but from local in development

• blog index & home page does not refresh after writing new blog entry (need to touch files)

• don’t try to generate page ending in ~ (solved by changing vim backupdir or adding the line *~ to .awestruct_ignore) - perhaps include .awestruct_ignore in generated site?

• support specifying required gems for site and downloading them automatically on first run (or through a command)

• awestruct --init should put site title and description in site.yml and reference in layout

• Use Tilt to manage templating

• Support idea of vendor/assets to separate JavaScript libraries, CSS & images from application code

• Consider using rbst to run rst2html rather than low-level stdin/stdout: https://github.com/alphabetum/rbst

• notifier should use -h int:transient:1 and urgency critical; only need to be notified of first error

• add ext.helper(@helpers) if ext.respond_to?('helper') to pipeline.rb

• posts extension should allow output file date path to be customized (e.g., "%Y/%m/%d/")

• post page should have property "current_post_index" for index in posts array

• something is wrong that we can’t pass metadata upwards to layouts

• adapt tag cloud to compass tag-cloud mixin (uses xxs, xs, s, m, l, xl, xxl)

• # of entries per tag in tag model

• partial extension should set reference to parent page as "parent"

• atom feed should include url of author, if available

• atom feed should accept tags to filter

• atom feed posting items up to 24hrs in the past based on updated date

• option to not generate all tags and blog pages when in development, or even filtering blogs by a threshold date