Org-mode publish: Some questions when use it for a blog

Org-mode publish: Some questions when use it for a blog

[Sébastien Gendre]

Hello,

I try do generate a blog with Org-mode publish. 

I'm very impressed by the publishing tool. But as it's nice to do a
simple website, I have some difficulties to use it for a blog.

First, I try to customize the site map:

* Is it possible to customize the entry without writing a function ?
  Something like the preamble with escaped chars (ex %t, %d) ?

* How can I set a postamble in the sitemap different from my blog
  posts ?


Secondly, how can I put the author name and publication date just at the
bottom of the document title ? I tried with preamble, but the preamble
is inserted before the document that I cannot disable.


Finally, how can I generate the RSS feed ? I tried with ox-rss, but I
got an error about my version of Org:
Error (use-package): ox-rss/:catch: Invalid function: org-assert-version

Best regards

Re: Org-mode publish: Some questions when use it for a blog

[Ihor Radchenko]

Sébastien Gendre <seb@k-7.ch> writes:

> I try do generate a blog with Org-mode publish. 
>
> I'm very impressed by the publishing tool. But as it's nice to do a
> simple website, I have some difficulties to use it for a blog.

Note that ox-publish is very basic. There is a number of third-party
packages that simplify blog export. For example, ox-hugo. See
https://orgmode.org/worg/org-blog-wiki.html

> First, I try to customize the site map:
>
> * Is it possible to customize the entry without writing a function ?
>   Something like the preamble with escaped chars (ex %t, %d) ?

It must be a function. If someone comes up with a patch for this, it
would also be welcome.

> * How can I set a postamble in the sitemap different from my blog
>   posts ?

Sitemap is exported just as an ordinary .org file within the project.
So, you can, for example, modify sitemap generator function to add
postamble manually and set #+OPTIONS: html-postamble:nil on top to
disable default postamble.

> Secondly, how can I put the author name and publication date just at the
> bottom of the document title ? I tried with preamble, but the preamble
> is inserted before the document that I cannot disable.

May you please elaborate?

> Finally, how can I generate the RSS feed ? I tried with ox-rss, but I
> got an error about my version of Org:
> Error (use-package): ox-rss/:catch: Invalid function: org-assert-version

This indicates an issue with your Org installation. Consider
re-installing Org mode and making sure that you do not put
(require 'org) before setting `load-path'. This issue appear in several
scenarios, depending on the kind of installation method you are using.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Re: Org-mode publish: Some questions when use it for a blog

[Sébastien Gendre]

Thank you for your reply Ihor.

Ihor Radchenko <yantar92@posteo.net> writes:



Ihor Radchenko <yantar92@posteo.net> writes:
>
> May you please elaborate?

When a webpage is generated by `org-html-publish-to-html`, it put the
title of the document at top of the HTML content as an <h1>.

I wanted to modify it to put Author and date below this title but before
the rest of the content.


> This indicates an issue with your Org installation. Consider
> re-installing Org mode and making sure that you do not put
> (require 'org) before setting `load-path'. This issue appear in several
> scenarios, depending on the kind of installation method you are using.

I Found the origin of the problem: My publication script is launch with
an `emacs -q` command. And I had updated Org-mode for my installation of
Emacs.




But, generate a RSS feed with ox-rss [1] give me some problems. The
README is not really clear on what the Org-mode file should look. And it
seems to be done to generate RSS when all blog posts are a headline in
the same document. But on my blog, each blog post is on a different
document.

I guess, until I found a better way, I'm gonna write my RSS feed
manually with help of Yasnippet.


[1] https://github.com/BenedictHW/ox-rss



> Sébastien Gendre <seb@k-7.ch> writes:
>
>> I try do generate a blog with Org-mode publish. 
>>
>> I'm very impressed by the publishing tool. But as it's nice to do a
>> simple website, I have some difficulties to use it for a blog.
>
> Note that ox-publish is very basic. There is a number of third-party
> packages that simplify blog export. For example, ox-hugo. See
> https://orgmode.org/worg/org-blog-wiki.html
>
>> First, I try to customize the site map:
>>
>> * Is it possible to customize the entry without writing a function ?
>>   Something like the preamble with escaped chars (ex %t, %d) ?
>
> It must be a function. If someone comes up with a patch for this, it
> would also be welcome.
>
>> * How can I set a postamble in the sitemap different from my blog
>>   posts ?
>
> Sitemap is exported just as an ordinary .org file within the project.
> So, you can, for example, modify sitemap generator function to add
> postamble manually and set #+OPTIONS: html-postamble:nil on top to
> disable default postamble.
>
>> Secondly, how can I put the author name and publication date just at the
>> bottom of the document title ? I tried with preamble, but the preamble
>> is inserted before the document that I cannot disable.
>
> May you please elaborate?
>
>> Finally, how can I generate the RSS feed ? I tried with ox-rss, but I
>> got an error about my version of Org:
>> Error (use-package): ox-rss/:catch: Invalid function: org-assert-version
>
> This indicates an issue with your Org installation. Consider
> re-installing Org mode and making sure that you do not put
> (require 'org) before setting `load-path'. This issue appear in several
> scenarios, depending on the kind of installation method you are using.

Re: Org-mode publish: Some questions when use it for a blog

[Ihor Radchenko]

Sébastien Gendre <seb@k-7.ch> writes:

>> May you please elaborate?
>
> When a webpage is generated by `org-html-publish-to-html`, it put the
> title of the document at top of the HTML content as an <h1>.
>
> I wanted to modify it to put Author and date below this title but before
> the rest of the content.

For example, you can simply put Author and data into #+SUBTITLE
Or you can add a function to `org-export-filter-parse-tree-functions'.
That function will be called with INFO communication channel (plist) as
an argument. You can override :title property in that plist by side
effect to your liking.

> But, generate a RSS feed with ox-rss [1] give me some problems. The
> README is not really clear on what the Org-mode file should look. And it
> seems to be done to generate RSS when all blog posts are a headline in
> the same document. But on my blog, each blog post is on a different
> document.

Well. You can define a derived dackend for ox-rss. It will require some
Elisp though. Check out `org-export-define-derived-backend' call in
ox-rss.el.

Alternatively, I am pretty sure that a number of rss generators already
exist for static blogs. They are more likely to work using multiple
individual html pages as input.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Re: Org-mode publish: Some questions when use it for a blog

[Christian Moe]

>> But, generate a RSS feed with ox-rss [1] give me some problems. The
>> README is not really clear on what the Org-mode file should look. And it
>> seems to be done to generate RSS when all blog posts are a headline in
>> the same document. But on my blog, each blog post is on a different
>> document.
>
> Well. You can define a derived dackend for ox-rss. It will require some
> Elisp though. Check out `org-export-define-derived-backend' call in
> ox-rss.el.
>
> Alternatively, I am pretty sure that a number of rss generators already
> exist for static blogs. They are more likely to work using multiple
> individual html pages as input.

I've seen several people solving this by adapting the sitemap
functionality in org-publish, since the sitemap already pulls together
information about different pages. You can configure org-publish to use
a bespoke sitemap-function that formats the sitemap as an Org file
suitable for RSS export with ox-rss. This looks like a clear explainer:

  https://writepermission.com/org-blogging-rss-feed.html

Yours,
Christian