Skip to content

jmervine/getdown

Repository files navigation

getdown

docker

# quickstart
docker run -p 3000:3000 -v /path/to/markdown:/data jmervine/getdown

# custom config example
docker run -p 3000:3000 -v /path/to/markdown:/data \
    -e GETDOWN_TITLE="My Project Docs" \
    -e GETDOWN_STYLE="https://maxcdn.bootstrapcdn.com/bootswatch/3.3.5/flatly/bootstrap.min.css" \
    jmervine/getdown

local

$ go get github.com/jmervine/getdown
$ getdown -h

NAME:
    getdown - Markdown file parser and server written in Go and designed to run on Docker.

USAGE:
    getdown [global options] command [command options] [arguments...]

VERSION:
    0.0.1

COMMANDS:
    help, h      Shows a list of commands or help for one command

GLOBAL OPTIONS:
    --addr, -a 'localhost'
         listener address [$GETDOWN_ADDR]
    --port, -p '3000'
         listener port [$GETDOWN_PORT]
    --title, -t 'getdown'
         rendered page title/header, pass empty string to use basedir name [$GETDOWN_TITLE]
    --basedir, -b '.'
         base markdown directory [$GETDOWN_BASEDIR]
    --index, -i 'README.md'
         root file default [$GETDOWN_INDEX]
    --style 'https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css'
         bootstrap compatable stylesheet url [$GETDOWN_STYLE]
    --help, -h
         show help
    --version, -v
         print the version

development

Fork and ...

git clone git@github.com/<you>/getdown.git

With Docker

Why?

Docker ensures a clean environment and that Godep's work correctly. Additionally it allows you to test changes without changing import pathing from "github.com/jmervine/getdown/..." to include your github username

Running

go get github.com/jmervine/dockme
dockme

Running Tests

go get github.com/jmervine/dockme
dockme -C Dockme.test.yml

Without Docker

Running

go run main.go

Running Tests

go test ./...

About

Markdown file parser and server written in go and designed to run on Docker

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published