Download
ox-hugo is an Org exporter backend that exports Org to Hugo-compatible Markdown (Blackfriday) and also generates the front-matter (in TOML or YAML format). The ox-hugo backend extends from a parent backend ox-blackfriday.el. The latter is the one that primarily does the Blackfriday-friendly Markdown content generation. The main job of ox-hugo is to generate the front-matter for each exported content file, and then append that generated Markdown to it. There are, though, few functions that ox-hugo.el overrides over those by ox-blackfriday.el. The preferred way to organize the posts is as Org subtrees (also the main reason to write this package, as nothing like that was out there) as it makes the meta-data management for Hugo front-matter pretty effortless. If you are a one Org-file per post type of person, that flow works too! Just note that in this flow many of those #+hugo_ properties need to be managed manually.
Features
- One post per Org subtree (preferred)
- One post per Org file
- The ox-hugo backend extends from a parent backend
- The preferred way to organize the posts is as Org subtrees
- ox-hugo uses itself to generate its documentation!
- The test site uses a minimal theme written just for debug purposes
Project Samples
