X-Git-Url: https://www.kengrimes.com/gitweb/?p=kengrimes.com%2Fcontent.git;a=blobdiff_plain;f=content%2Fox-hugo-tutorial.md;fp=content%2Fox-hugo-tutorial.md;h=c4f40f71fd949e22813980c7bf445521ba7d8d5a;hp=ebcfa37d828e6a612f16bc42f9d1ab01fd58fac6;hb=1ddd694c976a3f69f4a83097fa5bac61c0037947;hpb=da64a29051ce833c22d7ef26207713ae672a76cd diff --git a/content/ox-hugo-tutorial.md b/content/ox-hugo-tutorial.md index ebcfa37..c4f40f7 100644 --- a/content/ox-hugo-tutorial.md +++ b/content/ox-hugo-tutorial.md @@ -699,6 +699,34 @@ To do this on a per-heading basis, simply add the and the replacements will only occur within that heading. +## Why not use Hugo's internal Org parser? {#why-not-use-hugo-s-internal-org-parser} + +It's true that Hugo has an internal Org parser that is well maintained. It +provides this as an alternative to markdown files. You may wonder, then, why +someone would use Org mode to export to markdown instead of just letting Hugo +parse the Org files itself. The answer is two-fold: + +1. Hugo's Org format is currently less feature complete than markdown, so + exporting from Org mode to the Hugo Org Format would limit potential output. +2. Org mode is a lot more than just a file format, and its integration with your + system allows all kinds of benefits you can never get out of a simple Org + file parser. + +Therefore, supporting the Org format in another tool will give you a superior +text format for organizing information, but it will be crippled when compared to +an actual Org mode implementation. Ox-hugo gives you the ability to use Org mode +itself to generate content. + +If Hugo's Org parser gains parity with, or eclipses, the Blackfriday Markdown +format currently used by Hugo, ox-hugo could certainly be used to output those +Org-Hugo files instead of the current markdown. This would be nice because it +would allow Org mode users to view their output content more easily, but the +advantages of ox-hugo and a real, bona fide Org mode would still remain. + +So you see, Hugo's Org parser isn't really in competition with ox-hugo, it's in +competition with the _other_ Hugo formats (e.g. markdown). + + # Thanks {#thanks} Thanks to Kaushal Modi, who found this article on the googs within days of me