Org keywords: #+HUGO_TAGS, #+HUGO_CATEGORIES, #+KEYWORDS
or
Org properties: :EXPORT_HUGO_TAGS:, :EXPORT_HUGO_CATEGORIES:, :EXPORT_KEYWORDS:
!! This is a breaking change !!
Earlier, strings with spaces in those keywords had to be written as
abc__def. Now strings with spaces need to be written as "abc def"
instead, which is more intuitive.
This *does not* change the abc__def style required in Org
tags (e.g. :abc__def:), because Org tags cannot contain spaces. Note
that the same applies to the #+FILETAGS keyword too! In the
abc__def.
For many keywords like #+HUGO_TAGS, it is useful to merge multiple
values when this is done:
#+HUGO_TAGS: value1
#+HUGO_TAGS: value2
This merging did not happen as expected for these keywords; this
commit fixes that.
#+AUTHOR:
#+HUGO_CUSTOM_FRONT_MATTER:
#+HUGO_BLACKFRIDAY:
#+HUGO_MENU:
#+HUGO_MENU_OVERRIDE:
#+HUGO_OUTPUTS:
#+HUGO_RESOURCES:
Add test case for the same.
(Note that this fix was needed only for Org keyword values merging, not
subtree property merging.)
By default, ox-hugo interprets Org tags without "@" prefix as "tags"
and those with the "@" prefix as "categories".
But if you prefer to do the opposite i.e. have "tags" with the "@"
prefix, simply add:
#+HUGO_FRONT_MATTER_KEY_REPLACE: tags>categories categories>tags
That's it! :)
The org-hugo--replace-keys-maybe function is optimized, gotten rid of
redundant code, and made more robust.
Now it won't puke if user make an error in the "oldkey>newkey"
replacement syntax (like spaces around ">" and stuff like that). It
will now silently prevent doing replacements if the replacement syntax
is invalid.
New Org keyword/property:
#+HUGO_FRONT_MATTER_KEY_REPLACE
:EXPORT_HUGO_FRONT_MATTER_KEY_REPLACE:
This commit obsoletes the 2 new keywords/properties pairs introduced
in an earlier commit today:
e5e6e87e71
Earlier approach was hard-coded to replace only tags and categories
keys in the front-matter.
This new approach used in this commit can replace *any* front-matter
key with the string the user wants.
The syntax is:
#+HUGO_FRONT_MATTER_KEY_REPLACE: oldkey>newkey
You can also do multiple key replacements:
#+HUGO_FRONT_MATTER_KEY_REPLACE: oldkey1>newkey1 oldkey2>newkey2
Note that:
1. There are no spaces around the special character ">".
2. Spaces are used to only separate multiple replacements are shown in
the second example above.
3. The replacements are literal.. there are no regular expressions
involved.
- Optimize org-hugo--get-yaml-toml-list-string
- Re-write org-hugo--transform-org-tags-2 as
org-hugo--delim-str-to-list, with better documentation.
- Keywords front-matter parsing is now on par with the parsing of tags
and categories (multiple keywords, keywords with spaces, hyphens,
underscores).
- Add test cases for keywords parsing.
New keywords/properties:
#+HUGO_FRONT_MATTER_KEY_ORG_TAGS
:EXPORT_HUGO_FRONT_MATTER_KEY_ORG_TAGS:
#+HUGO_FRONT_MATTER_KEY_ORG_CATEGORIES
:EXPORT_HUGO_FRONT_MATTER_KEY_ORG_CATEGORIES:
Add test cases / examples for this new feature.
Now you can "C-c . RET" to set values for HUGO_PUBLISHDATE and
HUGO_EXPIRYDATE properties too (just like you can already do that for
DATE and HUGO_LASTMOD properties).
Added test cases for "lastmod", "publishdate" and "expirydate"
front-matter variables.
Consolidate the date formatting logic into a separate new function
`org-hugo--format-date', and use it to derive all the Hugo date
front-matter variable values: "date", "lastmod", "publishdate", and
"expirydate".
- Now number types are recognized
- .Resources is recognized as a slice
- Horizontal rule is drawn automatically after printing a resource or Page type
- New property HUGO_BUNDLE, used to specify the bundle URL.
- If the HUGO_BUNDLE is non-nil, it is auto-appended to the full page URL.
- Attachment rewrite now "does the right thing".. copied the
attachments to the bundle dir instead of to the static/ dir.
- Added a page bundle example, with images, "resources" front-matter.
- Updated the test site "single.html" template with debug info for
.Resources.
Fixes https://github.com/kaushalmodi/ox-hugo/issues/111
Kaushal Modi
Shimmy Xu