Как обслуживать документацию, используя godoc вместе с модулями go? - PullRequest
0 голосов
/ 28 февраля 2019

Похоже, что инструмент godoc не Go модулей осведомлен.

Простой godoc -goroot=. обслуживает файлы проекта, но не генерирует документацию для пакетов.Я проверил это в директории с исходными текстами проектов, где также хранятся файлы модулей go.mod и go.sum.

Как создать документацию для всех пакетов внутри модуля Go - за пределами $GOPATH?

В примечаниях к выпуску Go 1.12 написано, что инструмент godoc не будет включен в будущие выпуски Go и будет толькодоступно через go get после Go 1.12 .Нужно использовать команду Go go doc .Однако go doc не генерирует «хорошие для чтения» HTML-страницы. Есть ли альтернатива для генерации документации из исходного кода Go, которая выводит HTML или Markdown?

...