md

Documentation

Overview

Package md provides common markdown utilities, used by build-tools and learn platform.

Index

• func Copy(srcDir, destDir string) ([]string, error)
• func FindFiles(root string) ([]string, error)
• func HTMLFilename(mdf string) string
• func RewriteLink(n Node)
• func ToRoot(filename string) string
• func Walk(node Node, f func(Node))
• type Node

Functions

func Copy

func Copy(srcDir, destDir string) ([]string, error)

Copy copies the contents of the `src` directory to the `dest` directory. It skips over *.md files and returns their files names in a string slice, typically to generate HTML files from it.

func FindFiles

func FindFiles(root string) ([]string, error)

FindFiles finds recursively all file with .md extension in given directory and returns a slice of their names.

func HTMLFilename

func HTMLFilename(mdf string) string

HTMLFilename returns the HTML filename for a given markdown filename. README.md is converted to index.html, and all other .md files are converted .html file names with the same base name stem.

func RewriteLink

func RewriteLink(n Node)

RewriteLink replace a relative link to a .md file the HTML filename equivalent, see HTMLFilename.

func ToRoot

func ToRoot(filename string) string

ToRoot returns a relative path to the root of the given filename. It requires a final slash to be concatenated with further paths, so it can be used in templates more directly, e.g.:

<link rel="stylesheet" href="{{.Root}}/css/index.css" type="text/css" />

func Walk

func Walk(node Node, f func(Node))

Walk visits a markdown AST node, executes function f on it and recursively visits all children.

Types

type Node

type Node interface {
	PrintHTML(*bytes.Buffer)
}

Node is a subset of markdown.Block and markdown.Inline interfaces.