taitan

Taitan is a RESTful markdown to HTML supplier of pages for bawang.

Taitan(タイタン) is romaji for Titan.

API

Retrieve a markdown document.

GET /:path

Response

{
  "title": "Om Oss",
  "slug": "om-oss",
  "updated_at": "2015-11-06T02:04:58Z",

  "image": "unimplemented",

  "body": "<h1>...",
  "sidebar": "<ul>...",
  "anchors": [{"id":"id", "value":"asdf"}],
}

Running

Environment variables

Name	Description
PORT	The port to listen to requests on
TOKEN	GitHub Personal Access Token used for authorization when pulling the content repository. (Only needed if the content repo is private)
CONTENT_URL	The repository to get content from
CONTENT_DIR	Directory to serve contents from. Setting this disables the automatic fetching using git and makes the `TOKEN` and `CONTENT_URL` unused.
DARKMODE_URL	URL to the darkmode system, or `true` or `false` to use that value instead of sending an http request.

Flags

Name	Description
-v	Print info messages
-vv	Print more info messages
-w	Reload the contents when they change on disk

Docker

If you have docker installed, you can also run the repo using docker-compose up --build

Make sure to copy .env.example to .env first, and populate TOKEN with you personal github token if needed.

API documentation

http://godoc.org/github.com/datasektionen/taitan http://godoc.org/github.com/datasektionen/taitan/parse

Public domain

I hereby release this code into the public domain.