cli/cmd/gen-docs/main.go
2020-05-12 09:51:25 -04:00

76 lines
1.4 KiB
Go

package main
import (
"fmt"
"os"
"strings"
"github.com/cli/cli/command"
"github.com/spf13/cobra/doc"
"github.com/spf13/pflag"
)
func main() {
var flagError pflag.ErrorHandling
docCmd := pflag.NewFlagSet("", flagError)
var manPage = docCmd.BoolP("man-page", "", false, "Generate manual pages")
var website = docCmd.BoolP("website", "", false, "Generate website pages")
var dir = docCmd.StringP("doc-path", "", "", "Path directory where you want generate doc files")
var help = docCmd.BoolP("help", "h", false, "Help about any command")
if err := docCmd.Parse(os.Args); err != nil {
os.Exit(1)
}
if *help {
_, err := fmt.Fprintf(os.Stderr, "Usage of %s:\n\n%s", os.Args[0], docCmd.FlagUsages())
if err != nil {
fatal(err)
}
os.Exit(1)
}
if(*dir == "") {
fatal("no dir set")
}
err := os.MkdirAll(*dir, 0755)
if err != nil {
fatal(err)
}
if *website {
err = doc.GenMarkdownTreeCustom(command.RootCmd, *dir, filePrepender, linkHandler)
if err != nil {
fatal(err)
}
}
if *manPage {
err = doc.GenManTree(command.RootCmd, nil, *dir)
if err != nil {
fatal(err)
}
}
}
func filePrepender(filename string) string {
return `---
layout: manual
permalink: /:path/:basename
---
`
}
func linkHandler(name string) string {
return fmt.Sprintf("./%s", strings.TrimSuffix(name, ".md"))
}
func fatal(msg interface{}) {
fmt.Fprintln(os.Stderr, msg)
os.Exit(1)
}