~sircmpwn/gddo

Fork of godoc.org
internal/server: fix dropped fetch error
95b944e0 — Adnan Maolood 4 months ago
templates: Disable file links for pseudo-versions
5d05e1e5 — Adnan Maolood 4 months ago
Update dependencies

clone

read-only
https://git.sr.ht/~sircmpwn/gddo
read/write
git@git.sr.ht:~sircmpwn/gddo

You can also use your local clone with git send-email.

#gddo

Go Documentation

gddo is a maintained fork of the software that once powered godoc.org, and you can use it to browse documentation for Go packages.

A hosted instance is available at godocs.io.

#Installation

First install the dependencies:

  • Go 1.16 or above

Then compile and install:

$ make
# make install

#Viewing documentation locally

gddo can be used to view documentation locally. Simply run:

gddo --http :8080

Then navigate your web browser to http://localhost:8080.

gddo will look for a Go module in the current directory and serve documentation for it, allowing you to preview documentation locally. gddo will also serve documentation for standard library packages in GOROOT, as well as modules in your local Go module cache. To add a module to the cache, run:

go mod download example.com/module@latest

You can then type the import path into the search bar to view its documentation.

See go help mod download for more information.

#Using a database

gddo can optionally be used with a PostgreSQL database. Note that the following features require a database:

  • Package search
  • Import graphs

Install the runtime dependencies:

  • PostgreSQL 13
  • Graphviz (required for import graphs)

Initialize the PostgreSQL database:

psql -f schema.sql

Then run:

gddo --db "postgres://localhost" --http :8080

#Go module proxy

gddo can also fetch and serve documentation from a Go module proxy:

gddo \
	--db "postgres://localhost" \
	--http :8080 \
	--goproxy "https://proxy.golang.org"

When viewing documentation from a Go module proxy, it is recommended to use a database as well since fetching modules from the proxy can be slow.

#Gemini support

gddo can also serve documentation over the Gemini protocol.

To serve documentation over Gemini only, run:

gddo --gemini :1965 --certs /var/lib/gemini/certs --hostname example.com

See the documentation for more information.

#Questions? Patches?

Send them to the mailing list.