gitea/vendor/github.com/chaseadamsio/goorgeous
Lunny Xiao 0d80af649a Add init support of orgmode document type on file view and readme (#2525)
* add init support of orgmode document type on file view and readme

* fix imports

* fix imports and readmeExist

* fix imports order

* fix format

* remove unnecessary convert
2017-09-21 13:20:14 +08:00
..
goorgeous.go Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00
gopher_small.gif Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00
gopher.gif Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00
header.go Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00
LICENSE Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00
README.org Add init support of orgmode document type on file view and readme (#2525) 2017-09-21 13:20:14 +08:00

chaseadamsio/goorgeous

https://travis-ci.org/chaseadamsio/goorgeous.svg?branch=master https://coveralls.io/repos/github/chaseadamsio/goorgeous/badge.svg?branch=master

goorgeous is a Go Org to HTML Parser.

/mirror/gitea/media/commit/515cdaa85d6087d91a61ebe74fae39e0c4bdf1c4/vendor/github.com/chaseadamsio/goorgeous/gopher_small.gif

Pronounced: Go? Org? Yes!

"Org mode is for keeping notes, maintaining TODO lists, planning projects, and authoring documents with a fast and effective plain-text system."

The purpose of this package is to come as close as possible as parsing an *.org document into HTML, the same way one might publish with org-publish-html from Emacs.

Installation

  go get -u github.com/chaseadamsio/goorgeous

Usage

Org Headers

To retrieve the headers from a []byte, call OrgHeaders and it will return a map[string]interface{}:

  input := "#+title: goorgeous\n* Some Headline\n"
  out := goorgeous.OrgHeaders(input)
  map[string]interface{}{ 
          "title": "goorgeous"
  }

Org Content

After importing github.com/chaseadamsio/goorgeous, you can call Org with a []byte and it will return an html version of the content as a []byte

  input := "#+TITLE: goorgeous\n* Some Headline\n"
  out := goorgeous.Org(input)

out will be:

  <h1>Some Headline</h1>/n

Why?

First off, I've become an unapologetic user of Emacs & ever since finding org-mode I use it for anything having to do with writing content, organizing my life and keeping documentation of my days/weeks/months.

Although I like Emacs & emacs-lisp, I publish all of my html sites with Hugo Static Site Generator and wanted to be able to write my content in org-mode in Emacs rather than markdown.

Hugo's implementation of templating and speed are unmatched, so the only way I knew for sure I could continue to use Hugo and write in org-mode seamlessly was to write a golang parser for org content and submit a PR for Hugo to use it.

Acknowledgements

I leaned heavily on russross' blackfriday markdown renderer as both an example of how to write a parser (with some updates to leverage the go we know today) and reusing the blackfriday HTML Renderer so I didn't have to write my own!