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

Project Activity

See All Activity >

Categories

Text Editors

License

GNU General Public License version 3.0 (GPLv3)

Follow Ox-Hugo

Ox-Hugo Web Site

Other Useful Business Software
MongoDB Atlas runs apps anywhere Icon
MongoDB Atlas runs apps anywhere

Deploy in 115+ regions with the modern database for every enterprise.

MongoDB Atlas gives you the freedom to build and run modern applications anywhere—across AWS, Azure, and Google Cloud. With global availability in over 115 regions, Atlas lets you deploy close to your users, meet compliance needs, and scale with confidence across any geography.
Start Free
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of Ox-Hugo!

Additional Project Details

Operating Systems

Linux, Mac, Windows

Programming Language

Emacs-Lisp

Related Categories

Emacs-Lisp Text Editors

Registered

2022-10-12