code.pfad.fr/vanitydoc

vanitydoc command

go install code.pfad.fr/vanitydoc

vanitydoc generates go documentation as a static site (HTML and Gemtext). When hosted at the package URL, it makes the package importable by the Go tools ("vanity import path").

For instance the import path for this command is code.pfad.fr/vanitydoc and the documentation is hosted at the following URL: https://code.pfad.fr/vanitydoc

Usage:

vanitydoc [flags] <forgeURL>

The forgeURL must specify the forge in the scheme. See autodiscovery.ParseURL

gitea://git.example.com/folder
gitsrht://git.example.com/folder

The flags are:

-gemtext string
		Output folder for Gemtext
-html string
		Output folder for HTML (default "dist")
-moduleDir string
		Local path to the module to generate the documenation for (default ".")
-modulePath string
		Module path (will be read from go.mod if empty)

Example to generate the documentation for this module:

go run code.pfad.fr/vanitydoc@latest -html=dist/html -gemtext=dist/gmi gitea://codeberg.org/pfad.fr/vanitydoc

Most of the templates originate from gddo. The CSS styling is achieved using simple.css by default. It includes the go-import meta tag as well as the meta tags proposed by the VCS Autodiscovery RFC

Index

Bugs

module version is not displayed (see ideas.go)

Source Files

ideas.go main.go

Directories

Path Synopsis
autodiscovery package autodiscovery is an implementation of the [VCS Autodiscovery RFC].
pkg package pkg computes and generate documentation for a given package.

Forge

https://codeberg.org/pfad.fr/vanitydoc

git clone
https://codeberg.org/pfad.fr/vanitydoc
git@codeberg.org:pfad.fr/vanitydoc