Question Regarding Sorting Posts By Date With ox-hugo

[SamuelBanya]

Hey there,
As you requested, I made a discussion post here.

I was able to export my posts just fine into individual markdown files with ease by using the 'PROPERTIES' tag accordingly for each post, ex:

* May 12, 2022
:PROPERTIES:
:EXPORT_FILE_NAME: 05-12-2022
:CREATED: 05-12-2022
:END:
Example post

I then exported each of the individual headings containing each blog post in the main 'blog.org' file into separate Markdown files by using 'ox-hugo' with the 'C-c C-e' keybinding to go to Export mode in Org mode, and hit 'H', and then 'A'.

However, the problem I am currently facing is that the posts are in such a random order now on the actual example Hugo site I deployed locally for testing purposes.

Is there a 'PROPERTIES' tag I am missing to add to each post, or is this something that needs to be configured in the '.toml' config file for the Hugo blog itself?

I am completely new to Hugo and have been piecing together a few random guides found here, as my ultimate goal is to make sure it works locally, and then to actually deploy my entire setup on my Debian 10 VPS hosted website running 'nginx':
#654 [ ] https://dbeley.ovh/en/post/2018/08/14/create-a-blog-with-hugo-emacs-and-ox-hugo/

• https://dbeley.ovh/en/post/2018/08/14/create-a-blog-with-hugo-emacs-and-ox-hugo/
• https://gideonwolfe.com/posts/sysadmin/hugonginx/
• https://archive.baty.net/2018/posting-from-emacs-to-hugo-with-easy-hugo/
• https://www.muscaestar.xyz/en/post/emacs-ox-hugo-organize-blog/
• https://petercheng.net/publishing-a-website-from-emacs-and-hugo/
• https://umarahmad.xyz/blog/using-emacs-to-port-my-blog/
• https://gohugo.io/content-management/comments/
• https://commento.io/
• https://cactus.chat/docs/integrations/hugo/
• https://isso-comments.de/
• https://gtpedrosa.github.io/blog/using-org-mode-and-ox-hugo-to-replace-markdown-in-hugo-workflow/
• https://www.kengrimes.com/ox-hugo-tutorial/
• https://ox-hugo.scripter.co/
• https://ox-hugo.scripter.co/doc/usage/
• https://karl-voit.at/2017/09/23/orgmode-as-markup-only/
• http://xahlee.info/emacs/emacs/emacs_org_markup.html

Thanks,

Sam

[kaushalmodi]

Is there a 'PROPERTIES' tag I am missing to add to each post

Yes, you need to set the post's date. You can do that by either using EXPORT_DATE property or using the Org TODO state change to mark post subtree entries as DONE, and that will auto-insert the date stamp. See https://ox-hugo.scripter.co/doc/org-meta-data-to-hugo-front-matter/#for-subtree-based-exports and https://ox-hugo.scripter.co/doc/dates/#date.

I would suggest that you follow all the steps in the ox-hugo Quick Start. Step # 10 in that guide:

Take the cursor to the post heading and using the default Shift+left (S-) binding to mark that subtree as DONE.

is what will insert the date stamp in Org and that will export to the date front-matter in Markdown for Hugo to use.

[kaushalmodi]

To solve this problem, you need to first figure out what you need in the Markdown files (what front-matter variables, etc.) so that Hugo can sort your posts.

Once you figure that out, just the ox-hugo docs should be sufficient enough to answer everything regarding how Org mode content converts to Markdown content + TOML front-matter. There shouldn't need a need to search online for this part. [ If something is missing in the ox-hugo docs, let me know how I can improve/add that. ]

[SamuelBanya]

Right, however, these dates were in the past, so using the 'DONE' idea wouldn't work necessarily in my scenario as I am currently migrating an existing Org based blog that was exported to HTML, but now to Hugo. I'll try using the 'EXPORT_DATE' parameter value with this in mind, thanks a ton for this.

…

On Mon, Jun 13, 2022, at 10:49 PM, Kaushal Modi wrote: To solve this problem, you need to first figure out what you need in the Markdown files (what front-matter variables, etc.) so that Hugo can sort your posts. Once you figure that out, just the ox-hugo docs should be sufficient enough to answer everything regarding how Org mode content converts to Markdown content + TOML front-matter. There shouldn't need a need to search online for this part. [ If something is missing in the ox-hugo docs, let me know how I can improve/add that. ] — Reply to this email directly, view it on GitHub <#654 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVU3GXIBYJAXBXZ2KPB4XKLVO7XKVANCNFSM5YWCSFRA>. You are receiving this because you authored the thread.Message ID: ***@***.***>

[kaushalmodi]

Right, however, these dates were in the past

In that case, EXPORT_DATE property will work.

[SamuelBanya]

When I tried to do that aka I replaced all the ':CREATED:' tags with ":EXPORTED_DATE", I received this message that repeated a ton of times for each of the exported Markdown files in the '*Messages*' buffer in Emacs: [ox-hugo] 165/ Exporting ‘April 27, 2018’ .. [ox-hugo] Date will not be set in the front-matter: Not an Org time string: [04-27-2018] The related example post at the end of the blog file was: * April 27, 2018 :PROPERTIES: :EXPORT_FILE_NAME: 04-27-2018 :EXPORT_DATE: [04-27-2018] :END: Blog contents I'm wondering what I did wrong here, or if I have to correct this to the RPC date format? Sincerely, Sam

…

On Tue, Jun 14, 2022, at 10:04 AM, Kaushal Modi wrote: > Right, however, these dates were in the past > In that case, `EXPORT_DATE` property will work. — Reply to this email directly, view it on GitHub <#654 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVU3GXPO6IFKEYVZKD6KAULVPCGPPANCNFSM5YWCSFRA>. You are receiving this because you authored the thread.Message ID: ***@***.***>

[kaushalmodi]

I think the date format needs to be YYYY-MM-DD, and the square brackets around them are optional.

You'll find a lot of examples in https://raw.githubusercontent.com/kaushalmodi/ox-hugo/main/test/site/content-org/all-posts.org.

[SamuelBanya]

Just changed this over to this for all of my posts in the 'blog.org' file: * May 12, 2022 :PROPERTIES: :EXPORT_FILE_NAME: 2022-05-12 :EXPORT_DATE: [2022-05-12] :END: Worked like a charm, now the posts on the Hugo site display in the correct order from soonest post to furthest post in the past. Total side note, what are some good themes you would recommend for a programming type blog? I ask because I was trying to use the 'hyde-hyde' theme, which looks OK but the 'pre' tags could look better. Thanks a ton by the way, Sam

…

On Tue, Jun 14, 2022, at 7:57 PM, Kaushal Modi wrote: I think the date format needs to be YYYY-MM-DD, and the square brackets around them are optional. You'll find a lot of examples in https://raw.githubusercontent.com/kaushalmodi/ox-hugo/main/test/site/content-org/all-posts.org. — Reply to this email directly, view it on GitHub <#654 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVU3GXKKGZIIM6AD42A652LVPEL5HANCNFSM5YWCSFRA>. You are receiving this because you authored the thread.Message ID: ***@***.***>

[kaushalmodi]

I haven't explored many themes. I found a Lanyon themes many years back and have since been tinkering on it to make it my own.

But I believe the PaperMod theme is one of the popular ones, and so I use that in the ox-hugo Quick Start guide.

[kaushalmodi]

I was trying to use the 'hyde-hyde' theme, which looks OK but the 'pre' tags could look better.

If you find a theme that you like even remotely, just start using that. You can always tinker with the theme as you find time or swap the theme if you like something else better later on. That's the beauty of Hugo: focus on content writing in Org mode, and tweak the theme in Hugo if and when you get time 😀

[SamuelBanya]

Sweet, gotcha. Thanks for this, will tweak the 'hyde' one in that case.

…

On Tue, Jun 14, 2022, at 8:37 PM, Kaushal Modi wrote: > I was trying to use the 'hyde-hyde' theme, which looks OK but the 'pre' tags could look better. > If you find a theme that you like even remotely, just start using that. You can always tinker with the theme as you find time or swap the theme if you like something else better later on. That's the beauty of Hugo: focus on content writing in Org mode, and tweak the theme in Hugo if and when you get time 😀 — Reply to this email directly, view it on GitHub <#654 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVU3GXJJZZX7O5Q5MZTY6H3VPEQV7ANCNFSM5YWCSFRA>. You are receiving this because you authored the thread.Message ID: ***@***.***>