doc2go

command module
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 19, 2023 License: Apache-2.0 Imports: 24 Imported by: 0

README

doc2go

CI codecov

doc2go is a command line tool that generates static HTML documentation from your Go code. It is a self-hosted static alternative to https://pkg.go.dev/ and https://godocs.io/.

Documentation for the tool is available at https://abhinav.github.io/doc2go/.

Installation

See https://abhinav.github.io/doc2go/docs/install/, but in short, use one of the following methods:

# Homebrew/Linuxbrew:
brew install abhinav/tap/doc2go

# ArchLinux User Repository
yay -S doc2go-bin

# Build from source
go install go.abhg.dev/doc2go@latest

Getting Started

To get started with doc2go, see https://abhinav.github.io/doc2go/docs/start/.

If you just want a copy-paste-friendly setup to publish your documentation to GitHub Pages, see https://abhinav.github.io/doc2go/docs/publish/github-pages/.

License

This software is licensed under the Apache 2.0 License with the exception of the following files.

internal/godoc/synopsis.go
internal/godoc/synopsis_test.go

The license for those files is noted inside them.

Documentation

Overview

doc2go generates static HTML documentation from one or more Go packages.

Directories

Path Synopsis
internal
flagvalue
Package flagvalue provides flag.Value implementations.
Package flagvalue provides flag.Value implementations.
godoc
Package godoc provides the means of converting parsed Go source information into a documentation subset of it.
Package godoc provides the means of converting parsed Go source information into a documentation subset of it.
html
Package html renders HTML from godoc.Package.
Package html renders HTML from godoc.Package.
pathtree
Package pathtree provides a data structure that stores values organized under a tree-like hierarchy where values from higher levels cascade down to lower levels unless the lower levels define their own values.
Package pathtree provides a data structure that stores values organized under a tree-like hierarchy where values from higher levels cascade down to lower levels unless the lower levels define their own values.
ptr
relative
Package relative turns paths and file paths relative with string manipulation exclusively.
Package relative turns paths and file paths relative with string manipulation exclusively.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL