Fixes https://github.com/kaushalmodi/ox-hugo/issues/141
Regular page weight setting is same as before:
Manual:
#+hugo_weight: 100
Auto:
#+hugo_weight: auto
Taxonomy weight setting:
Manual:
#+hugo_weight: :tags 100 :categories 100 :series 100
Auto:
#+hugo_weight: :tags auto :categories auto :series auto
Regular page weight and Taxonomy weights together:
#+hugo_weight: 50 :tags 100 :categories 100 :series 100
or if *not* specifying the page weight in the very beginning, use the
:page keyword:
#+hugo_weight: :tags 100 :categories 100 :page 50 :series 100
The --recursive switch is now needed when cloning as the test site
theme hugo-bare-min-theme is now a git submodule.
Remove repeated mentions about `--navigateToChanged` switch being
introduced in Hugo v0.25.. hopefully folks using `ox-hugo` are already
on a much newer version :)
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.
* ox-hugo.el:
- 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.
- Fix the return values of org-hugo-export-as-md,
org-hugo-export-to-md, org-hugo-publish-to-md and the new
org-hugo-export-wim-to-md. Update their doc strings.
- (org-hugo-export-wim-to-md): This new function now exports using
per-file flow or per-subtree flow automatically. Improve the
messages printed during export.
- (org-hugo-export-to-md): Allow Org files exported using per-file
approach not get exported based on tags. See "Marking files to not
be exported" in documentation for details.
- (org-hugo-publish-to-md): Comment out this function. It doesn't
work (If someone was using it, please open an issue so that I can
uncomment that.)
* setup-ox-hugo.el:
- New function org-hugo-export-all-wim-to-md that uses the new
org-hugo-export-wim-to-md function.
- Stop printing too many messages when loading emacs.
- Increase org-export-headline-levels to 4.
- Don't export files and subtrees tagged
"dont_export_during_make_test" during "make test".
* Makefile:
- Now uses the new org-hugo-export-all-wim-to-md function
defined above, and thus no need to hard-code subtree-based and
file-based Org files.
- New rule do_test replaces the old test_subtree and test_file
rules.
- New rule md1 replaces the old mdtree and mdfile rules.
* ox-hugo-manual.org:
- Add section on "Marking files to not be exported"
- Update "Auto-export on Saving" to reflect the refactoring to
org-hugo-export-wim-* functions.
- Update bindings descriptions.
* Misc tests: Make changes to match the above changes.
This commit helps towards
https://github.com/kaushalmodi/ox-hugo/issues/39. Now Org files can be
exported seamlessly using the per-file or per-subtree flow using a
Makefile like one in this repo.
This commit changes the TOC style quite a bit from the earlier
version. Read the below mini-blog-in-commit for more info.
- Add new function org-hugo--get-headline-number
- org-hugo-heading - Use above.
- org-hugo--build-toc - Generate unordered list instead of ordered
- Update/add tests!
@punchagan: You are most likely one of the few affected by the
backward incompatible change in this commit. To get sort of the old
style of numbered headings in TOC (while unnumbered headings in post
body), set `num' to `onlytoc`. Let me know how it works.
=== mini blog ===
Earlier, the TOC was exported as ordered list in Markdown. That
imposed a limitation that allowed exporting only the last number from
a section number.
So instead of:
1. Section 1
1.1 Section 1.1
1.2 Section 1.2
It would export as:
1. Section 1
1. Section 1.1
2. Section 1.2
Now the TOC is generated as an *unordered* list in Markdown.
- 1. Section 1
- 1.1 Section 1.1
- 1.2 Section 1.2
That would cause both bullets and numbers to show in HTML, so I am
using a nifty little trick I discovered in
https://github.com/kaushalmodi/ox-hugo/issues/93 to hide those
bullets **if the section numbers are present**.
In addition, I also wrap the section numbers in "section-num" class so
that user can choose to format them however they like using CSS (May
be even hide them).
===
Fixes https://github.com/kaushalmodi/ox-hugo/issues/76
Kaushal Modi