Back to top

Changelog

v0.8 <2018-01-26 Fri> #

Features #

Support exporting content files and attachments (images, documents) to Page Bundles organization structure (Hugo v0.32+) – #111.
Support exporting resources front-matter (Hugo v0.33+) – #115.
Support exporting headless front-matter (Hugo v0.35+).
Advanced table styling is now possible by specifying #+attr_html and #+attr_css (this one is unique to ox-hugo) above Org tables. See its documentation – #93.
- Similarly, support #+attr_html and #+attr_css for paragraphs, example blocks, source blocks, plain lists and quote blocks too – #113.
Now publishDate and expiryDate front-matter properties get auto-derived from SCHEDULED and DEADLINE special properties if associated with the valid Hugo post subtree – commit 0807f42d.
- Date values can now be easily set using the C-c . binding in the HUGO_PUBLISHDATE and HUGO_EXPIRYDATE properties too.

Export source blocks and table captions – #38. Here’s a suggested CSS for the captions:

figcaption,
.src-block-caption,
.table-caption {
    font-style: italic;
    text-align: center;
}

Export descriptive or definition lists in Blackfriday-friendly Markdown format – #114.
Support Org Special Blocks like in HTML and LaTeX exports – #105. Here’s one little example:
```
#+begin_mark
/Some/ *marked* text
#+end_mark
```
Allow setting :EXPORT_HUGO_SECTION: in the valid Hugo post subtree itself.
Enable replacing any key in the front-matter with anything; it’s even possible to swap the keys now (tags↔categories: commit fb21e82c). New keyword: HUGO_FRONT_MATTER_KEY_REPLACE – see commit b72a5fb0.
Now all the Org keyword values that should get merged, get merged – commit 38eba6d5.
Add title as a valid property of menu front-matter (Hugo v0.32+).

Backward-incompatible changes #

A “better user-experience” change.. now you do not need to use double-underscores as space replacement in #+hugo_tags, #+hugo_categories and #+keywords. See this commit for details and examples – commit 319435db.

Fixes #

Fix HUGO_LEVEL_OFFSET not getting set – #117, thanks @shimmy1996!
Fix internal subtree counter not getting reset after a file-based export.
Fix clickable image links with #+name – commit fef0ec50.
Make title text rendering more robust.. now Markdown markup characters like *, _ and ` show up fine, verbatim, in the title.
Make em dash, en dash, horizontal ellipsis render in post titles too – Hugo #4175 (Upstream bug fix), and in source block captions and table captions too.
Fix double-escaping of # and ![ in Markdown export – #110 (fix in upstream ox-md.el).

Meta #

Re-write the logic for parsing meta-data for various kinds of dates, and optimize the logic for parsing newline separated lists like tags and categories.
The hugo-bare-min-theme used for the test site is made more portable (at some point, that theme might be moved to a separate repo).

v0.7 <2017-12-18 Mon> #

Features #

Now C-c C-e H H works for both per-subtree and per-file flows – commit b1b5d28b.
Support Org heading based internal links – #88.
Support list values for custom front-matter variables – #99.
Support specifying multiple hugo output formats .. Now the outputs front-matter variable is a list.
Support the Org #+author and #+creator keywords and their respective Org Export Options – #106.
Support Org Export Snippets and Export Blocks – commit 1149f20cd.
Now post titles can be set to nil i.e. be not be a part of the front-matter .. because you can.
Improve the messages printed by ox-hugo on doing per-subtree or per-file exports.. the progress of files exported using per-subtree flow is now clearer, and the name of the file exported using per-file flow is now explicit.. Helps when you batch export a dozen files with a mix of these 2 flows.

Backward-incompatible changes #

Obsolete org-hugo-export-subtree-∗ functions and replace them with org-hugo-export-wim-∗ (What I Mean) functions. See the doc string of org-hugo-export-wim-to-md for details.

If you are using the Auto-export on saving flow, note the function name change there too!

Fixes #

Fix number of backticks in code fence when code contains code fence (pathological corner case).
Better document the HUGO_CODE_FENCE keyword – #102.
Don’t render (c), (r), (tm) inside Latex equations – #104 (Upstream bug workaround).
Better recognition of TOML-compatible integers and floats in meta data for front-matter so that valid integers/floats don’t get unnecessarily double-quoted.

Meta #

Add a debugprint.html partial to help pretty-print various Hugo objects like Page Params, File and SiteInfo for debug on the test site.
The test site now has tags and categories pages.
Add few real world example posts containing complex Latex equations: 1, 2.
Turns out ox-hugo works on emacs 24.4 too (but please upgrade to the latest Emacs and Org stable versions!).

v0.6 <2017-11-09 Thu> #

Features #

Support the num export option. Now you can prefix all post headings (or some not.. the ones with UNNUMBERED property set to t) with their section numbers – #76.
Org TOC’s are now exported as unordered Markdown lists. This allows having TOC’s with unnumbered headings too! This also enables prefixing the section headings with their full section numbers, and also having only selected headings unnumbered (both in the post body and the TOC).
Add support for exporting internal links to source blocks, tables and images by their block names! – #29.
Org table column alignment markers (<l>, <r>, <c>) are now exported to equivalent Markdown tables.. so a center-aligned column in Org buffer will remain center-aligned in the final HTML too! – #95.
Allow setting multiple Hugo aliases for a post. Also infer the section name from inherited HUGO_SECTION values (subtree-based exports) for those alias prefixes.
Prevent a footnote ref to appear by itself on a newline (based on wrapping) in the browser – #96.
If Hugo shortcodes are used specifically in Markdown (md) source blocks, they will be auto-escaped (useful when you want to document/talk about some Hugo shortcode in a blog post) – #94.
If an Org table has just 1 row, don’t make it render as a header row in the final HTML.
If you have a case where you need to have an Org source block instead a quote block, and then a source block after that quote block (I know, a very common case.. 😉), Blackfriday barfs (Blackfriday #407). But we now have a workaround, which just works – #98.
Now ATTR_HTML above even hyper-linked images works (earlier it worked only above non-hyper-linked images).

Backward-incompatible changes #

Org TOC’s are exported as unordered Markdown lists instead of ordered Markdown lists, and now full section numbers (like 1.2.3) are shown in the TOC instead of just the last digit (like 3.) – commit 4be378e7.
The num Org export option is default to nil (only for ox-hugo). So Org TOC’s are exported without section numbers by default. To get section numbers, set num to t or onlytoc.

Fixes #

Now exporting 1-row Org tables works too.
Add missing http/https/ftp prefix for hyper-linked images.

Meta #

Add documentation on how you can have Images live in the same directory as Org source – #91.
Now only Org files for the documentation site need to be committed to git. ox-hugo then exports those to Markdown, and then Hugo publishes those to HTML (as before) — all on Netlify.
Be sure to check out the moderately revamped Test Site. That might be of interest even if you want to check out what the new features and changes look like, without first installing/updating ox-hugo yourself 😄.

v0.5 <2017-11-06 Mon> #

Features #

Export TOC as a Markdown ordered list. See Table of Contents – #88.
#+attr_html above http/https/ftp links is now supported (useful for specifying the target, rel, attributes, for example).

v0.4.1 <2017-10-29 Sun> #

Features #

Support specifying the :height parameter in the #+attr_html above image links. That eventually gets transformed to the height parameter in the figure tag in the HTML generated by Hugo. This feature requires building Hugo from its master branch with commit 488631fe (or Hugo v0.31+).

Fixes #

Fix EXPORT_HUGO_SECTION not getting inherited #90.

v0.4 <2017-10-28 Sat> #

Backward-incompatible changes #

Restore the default Org behavior of #+tags. Now that keyword (and the EXPORT_TAGS property) is not used by ox-hugo. Fixes #89.
File-based exports must now use #+hugo_tags to set the post tags.
Subtree-based exports can use the EXPORT_HUGO_TAGS property to override Org-style tags on the same headline (and the ones inherited from Org-style tags from any of the parent subtrees and #+filetags).
- Note that for subtree-based exports, #+filetags can be used to set tags globally in the file. Earlier #+tags was used for that purpose.
Subtree-based exports can use the EXPORT_HUGO_CATEGORIES property to override Org-style categories (tags with “@” prefix) on the same headline (and the ones inherited from Org-style categories from any of the parent subtrees and #+filetags).
- Note that for subtree-based exports, #+filetags can be used to set categories (tags with “@”) globally in the file.

See the new section added to documentation: Tags and Categories

Features #

Support specifying the :width parameter in the #+attr_html above image links. That eventually gets transformed to the width parameter in the figure tag in the HTML generated by Hugo.

v0.3.2 <2017-10-24 Tue> #

Fixes #

Fix issue with headline metadata parsing (ALLTAGS, CLOSED, TODO) when a post Org heading was immediately followed by that post’s sub-heading. This issue was seen in subtree-based exports #87.

v0.3.1 <2017-10-19 Thu> #

Fixes #

Fix the source block line number annotation when the line numbers increased in number of digits in the same code block.

v0.3 <2017-10-18 Wed> #

Features #

Source blocks can now be exported with line numbers and/or highlighting!

See Source Blocks for details.

v0.2.3 <2017-10-11 Wed> #

Fixes #

org-hugo-slug earlier stripped off only the code HTML tag (<code> .. </code>) from the input string, if present. Now it does that for any HTML tag, like span. For example, this HTML gets stripped off from the above heading (only inside org-hugo-slug when deriving the slug string): <2017-10-11 Wed>.

v0.2.2 <2017-10-10 Tue> #

Backward-incompatible changes #

Now ox-hugo by default requires text, to be sub/super-scripted, to be wrapped in {}. So now a_b will be exported as a_b, but a_{b} will be exported as ab. To revert back to the earlier behavior, user needs to add #+options: ^:t to their Org file.

v0.2.1 <2017-09-28 Thu> #

Fixes #

Single column tables now export correctly #84.
Ignore HUGO_WEIGHT set to auto for per-file exports #83.

v0.2 <2017-09-27 Wed> #

Features #

Add support for all Hugo figure shortcode parameters #79.
New option org-hugo-delete-trailing-ws defaults to t; now Hugo deletes trailing white-spaces by default.
New options org-hugo-default-static-subdirectory-for-externals and org-hugo-external-file-extensions-allowed-for-copying (related to #69).

Fixes #

Remove HUGO_STATIC_IMAGE option; fix attachment re-write #69.
Fix incorrectly inserted hard line-breaks #72. Added a new option HUGO_PRESERVE_FILLING.
Fix error happening when a post title was set to an empty string [ba9e8365].

Backward-incompatible changes #

Switch the default value of org-hugo-use-code-for-kbd option to nil [88ba15ae].

v0.1.3 <2017-09-13 Wed> #

Now a HUGO key value set to "nil", like #+hugo_code_fence: nil, will evaluate as nil instead of t, as now org-hugo--plist-get-true-p is used to parse boolean keys instead of plist-get.

v0.1.2 <2017-09-12 Tue> #

Make DateTime matching better; new internal variable org-hugo--date-time-regexp. Earlier time zones ahead of UTC (with + sign) were not detected as dates in org-hugo--quote-string and thus were unnecessarily quoted.

v0.1.1 <2017-09-11 Mon> #

Use CLOSED log drawer info if available to set the date in front-matter #68.
Code optimization: Use of org-entry-get at places instead of maintaining global variables.