tableofcontents

Documentation

Index

• Variables
• type Config
• type Header
  • func (h Header) IsZero() bool
• type Headers
• type Root
  • func (toc *Root) AddAt(h Header, row, level int)
  • func (toc Root) ToHTML(startLevel, stopLevel int, ordered bool) string

Variables

var DefaultConfig = Config{
	StartLevel: 2,
	EndLevel:   3,
	Ordered:    false,
}

DefaultConfig is the default ToC configuration.

Types

type Config

type Config struct {
	// Heading start level to include in the table of contents, starting
	// at h1 (inclusive).
	StartLevel int

	// Heading end level, inclusive, to include in the table of contents.
	// Default is 3, a value of -1 will include everything.
	EndLevel int

	// Whether to produce a ordered list or not.
	Ordered bool
}

type Header

type Header struct {
	ID   string
	Text string

	Headers Headers
}

Header holds the data about a header and its children.

func (Header) IsZero

func (h Header) IsZero() bool

IsZero is true when no ID or Text is set.

type Headers

type Headers []Header

Headers holds the top level (h1) headers.

type Root

type Root struct {
	Headers Headers
}

Root implements AddAt, which can be used to build the data structure for the ToC.

func (*Root) AddAt

func (toc *Root) AddAt(h Header, row, level int)

AddAt adds the header into the given location.

func (Root) ToHTML

func (toc Root) ToHTML(startLevel, stopLevel int, ordered bool) string

ToHTML renders the ToC as HTML.