go-org-orgwiki/README.org

• go-org https://travis-ci.org/niklasfasching/go-org.svg?branch=master
• next
  • links
• differences to goorgeous
• resources

go-org https://travis-ci.org/niklasfasching/go-org.svg?branch=master

A basic Org mode parser in go. Take a look at github pages for some examples and an online org -> html demo (requires wasm support).

next

• https://ox-hugo.scripter.co/doc/examples/
• test against ox-hugo all-posts.org
• more keywords: https://orgmode.org/manual/In_002dbuffer-settings.html

• headlines

  • unique ids: see ox-hugo for auto generation

• improve list parsing

  • handle list items with empty first line
  • handle ordered list overrides [@10]

links

https://orgmode.org/manual/External-links.html https://orgmode.org/manual/Internal-links.html radio target <<<MyTarget>>> link target: <<go-org>> link: /OrgWiki/go-org-orgwiki/src/commit/ff9c077f65094aa7184f3986db3b11d1e5d0d2e9/go-org link to headline MyTarget <- this will automatically become a link - not sure i want this…

differences to goorgeous

To get a feeling take a look at goorgeous vs go-org html rendering of the examples comparison. Please note that a visual comparison is not fair to goorgeous as the stylesheet is not adapted to it. Nonetheless, the html output can be compared by taking a look in the developer console where relevant.

• no headline ids

• not changing links to .org files into links to .html files

  • do not plan to implement this, too many edge cases (e.g. mangling links to e.g. example.org.)
• org comments not rendered as html comments (same as ox-html.el)
• headline priority not exported to html (same as ox-html.el)
• goorgeous treats all `file:` links as images - go-org checks for an image file extension (same as ox-html.el)

• no support for [@10] in ordered lists https://github.com/chaseadamsio/goorgeous/issues/18

  • do not plan to implement this

resources

• https://orgmode.org/manual/
• https://orgmode.org/worg/dev/org-syntax.html

• https://code.orgmode.org/bzg/org-mode/src/master/lisp/org.el

  • https://code.orgmode.org/bzg/org-mode/src/master/lisp/org-element.el
  • mostly those & ox-html.el, but yeah, all of https://code.orgmode.org/bzg/org-mode/src/master/lisp/
• existing Org mode implementations: org, org-ruby, goorgeous, pandoc