datasektionen / taitan

Git-powered content management for Bawang

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.