caption tags should not be used outside table tags -
https://www.w3schools.com/tags/tag_caption.asp
Because of the hugo/blackfriday limitation, we'll live with the table
caption staying in a plain div just before the table.
The org-hugo--sanitize-title function is re-written, now with added
test cases for even apparently pathological cases.
Now it is possible to have *, _ and ` characters in the post title.
This gets around the limitation where the Blackfriday smartDashes
feature does not work on post titles as Hugo does not render the
titles as Markdown by default.
https://github.com/gohugoio/hugo/issues/4175
It doesn't make sense to encode the Hugo version at the time of the
Markdown file generation, because the generation of that has almost no
relation to the then Hugo version.
And the Hugo version is anyways encoded in the generator meta tags in
the HTML pages (unless a theme intentionally chooses to not to do so).
Also allow disabling author export.
This commit might be a big behavior change for some as now the author
name is auto-exported to the post front matter.
To disable that, simply put "#+AUTHOR:" or "#+OPTIONS: author:nil" at
the top of your Org file.
With this commit, ox-hugo now supports one more implicit ox.el
feature.
Part of solution to https://github.com/kaushalmodi/ox-hugo/issues/106
* 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.
- Add test for JSON output creation
- Add single.json in bare_min layouts/_default for this testing purpose
- Update debugprint.html partial to pretty-print the outputs Param
- Add <!--endtoc--> comment at end of Org-inserted TOC's.
That acts as an aid to help filter out the TOC from Hugo
summaries. See the new test added in this commit for example:
https://ox-hugo.scripter.co/test/posts/no-toc-in-summary
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
- Add new defcustom org-hugo-export-with-section-numbers
- Default of this option is set to 'onlytoc
- So there will be no numbers in the body of the exported post. But
if TOC (Org) is enabled, the items will be numbered.
This is part 1 of a multi-part patch series to make the num and toc
options work together the "right way".
Kaushal Modi