💾 Archived View for code.pfad.fr › vanitydoc › template captured on 2023-12-28 at 15:28:51. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
import "code.pfad.fr/vanitydoc/template"
package template generates documentation for a given package.
func WriteCSS(w io.Writer) error
WriteCSS writes the default CSS to the given writer.
type Directory struct {
Name string
Synopsis string
}
Directory represents the sub-packages of a given package.
type GemtextRenderer struct{}
GemtextRenderer provides the generation of [gemtext] documentation.
func (gr GemtextRenderer) Execute(out io.Writer, td TemplateData) error
Execute applies a parsed template to the template data, and writes the output to w.
type HTMLRenderer struct {
Stylesheets []string
// AdditionalFS and AdditionalPattern can be optionally provided
// to override some components
AdditionalFS fs.FS
AdditionalPatterns []string
}
HTMLRenderer provides the generation of HTML documentation.
func (hr HTMLRenderer) Execute(out io.Writer, td TemplateData) error
Execute applies a parsed template to the template data, and writes the output to w.
type TemplateData struct {
Package *doc.Package
FileSet *token.FileSet
ModulePath string
PackageChain []string
Directories []Directory
VCS autodiscovery.VCS
Ref string
}
TemplateData stores all the data needed to render the documentation templates.
func NewTemplateData( pkgFS fs.FS, modulePath string, packageChain []string, directories []Directory, vcs autodiscovery.VCS, ref string, ) (TemplateData, error)
NewTemplateData parses the provided pkgFS to prepare the template data.
func (td TemplateData) PageName() string
PageName returns the page name ("*** package" or "*** command" depending on the package name).