Difference between revisions of "Blogging"

From WikEmacs
Jump to navigation Jump to search
(jekyll and org-mode)
(Add ox-hugo Real World Examples)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Modes ==
+
== With org-mode ==
  
 
Each of these modes is effectively an in-emacs application.
 
Each of these modes is effectively an in-emacs application.
Line 6: Line 6:
 
* [[ org-mode ]] can be used for blogging
 
* [[ org-mode ]] can be used for blogging
  
=== Jekyll and org-mode ===
+
=== Blog-minimal ===
 +
 
 +
[https://github.com/thiefuniverse/blog-minimal blog-minimal] is built on org-mode and well integrated into Emacs.
 +
 
 +
=== Hakyll ===
 +
 
 +
Being based on [http://pandoc.org/ Pandoc], [https://github.com/jaspervdj/hakyll Hakyll] has built-in support for org-mode files.  The only limitation is the absence of support for org-mode metadata (#+TITLE, etc): Hakyll still requires a Jekyll-like YAML metadata block.
 +
 
 +
=== Jekyll ===
  
 
Jekyll is a static website and blog engine. It's possible to write everything in org-mode in a single org file, as described in this blog post: http://endlessparentheses.com/how-i-blog-one-year-of-posts-in-a-single-org-file.html
 
Jekyll is a static website and blog engine. It's possible to write everything in org-mode in a single org file, as described in this blog post: http://endlessparentheses.com/how-i-blog-one-year-of-posts-in-a-single-org-file.html
 +
 +
Technically, it's needed to use [https://github.com/Malabarba/ox-jekyll-subtree his package ox-jekyll-subtree] and then we just need to call '''M-x endless/export-to-blog''' to export the current org subtree as a jekyll entry post.
 +
 +
=== Pelican ===
 +
 +
[https://github.com/ardekantur/pelican-plugins/tree/org_reader/org_reader org_reader] is a Pelican plugin to write posts in org-mode.
 +
 +
=== blog-admin ===
 +
 +
[https://github.com/CodeFalling/blog-admin blog-admin] works with hexo or [[org-page]] and provides an admin table, presenting the list of our posts, to which we can take actions, like toggling the 'publish' state.
 +
 +
=== Hugo ===
 +
 +
[https://ox-hugo.scripter.co ox-hugo] implements a Markdown backend for Org exporter. It exports to Blackfriday Markdown with [https://gohugo.io Hugo] front-matter in TOML or YAML.
 +
 +
'''ox-hugo''' supports two common Org blogging flows:
 +
 +
* exporting multiple Org sub-trees from a single file to multiple Hugo posts
 +
* exporting a single Org file to a single Hugo post
 +
 +
It also leverages the Org tag and property inheritance features.
 +
 +
See [https://ox-hugo.scripter.co/doc/why-ox-hugo/ Why ox-hugo?] to learn what motivated this package development inspite of Hugo being advertised as being able to support Org directly.
 +
 +
See [https://ox-hugo.scripter.co/doc/examples/ Real World Example sites] generated using '''ox-hugo''', and their sources too, in Org.
 +
 +
=== Nikola ===
 +
 +
[[Nikola]] can handle org-mode files with the extension org2nikola.
  
 
== See also ==
 
== See also ==
  
See more options within the Blog category:
+
=== Hublo ===
 +
 
 +
[[Hublo]] uses elisp to write configuration and the phases of build.
 +
 
 +
See more options within the Blog category.
 +
 
 +
=== org html themes - readthedoc theme ===
 +
 
 +
These [https://github.com/fniessen/org-html-themes org html themes] allow to export to beautiful html in 2 minutes.
  
 
[[Category:Blog]]
 
[[Category:Blog]]

Latest revision as of 19:35, 27 April 2018

With org-mode

Each of these modes is effectively an in-emacs application.

Blog-minimal

blog-minimal is built on org-mode and well integrated into Emacs.

Hakyll

Being based on Pandoc, Hakyll has built-in support for org-mode files. The only limitation is the absence of support for org-mode metadata (#+TITLE, etc): Hakyll still requires a Jekyll-like YAML metadata block.

Jekyll

Jekyll is a static website and blog engine. It's possible to write everything in org-mode in a single org file, as described in this blog post: http://endlessparentheses.com/how-i-blog-one-year-of-posts-in-a-single-org-file.html

Technically, it's needed to use his package ox-jekyll-subtree and then we just need to call M-x endless/export-to-blog to export the current org subtree as a jekyll entry post.

Pelican

org_reader is a Pelican plugin to write posts in org-mode.

blog-admin

blog-admin works with hexo or org-page and provides an admin table, presenting the list of our posts, to which we can take actions, like toggling the 'publish' state.

Hugo

ox-hugo implements a Markdown backend for Org exporter. It exports to Blackfriday Markdown with Hugo front-matter in TOML or YAML.

ox-hugo supports two common Org blogging flows:

  • exporting multiple Org sub-trees from a single file to multiple Hugo posts
  • exporting a single Org file to a single Hugo post

It also leverages the Org tag and property inheritance features.

See Why ox-hugo? to learn what motivated this package development inspite of Hugo being advertised as being able to support Org directly.

See Real World Example sites generated using ox-hugo, and their sources too, in Org.

Nikola

Nikola can handle org-mode files with the extension org2nikola.

See also

Hublo

Hublo uses elisp to write configuration and the phases of build.

See more options within the Blog category.

org html themes - readthedoc theme

These org html themes allow to export to beautiful html in 2 minutes.