added the ability to generate the pgo cli markdown for inclusion into the documentation (#601)

* updated links to gh-pages and added generated cli documents

* add the ability to generate the pgo cli markdown for inclusion into the  documentation

* removed extra go get line

Author: cahoonpwork

Makefile

@@ -83,6 +83,8 @@ repo-client-image:	check-go-vars
 foo:	check-go-vars
 	go install foo/foo.go
 	mv $(GOBIN)/foo ./bin/foo/
+cli-docs:	check-go-vars
+	cd $(COROOT)/hugo/content/cli && go run $(COROOT)/pgo/generatedocs.go
 pgo:	check-go-vars
 	cd pgo && go install pgo.go
 clean:	check-go-vars

bin/get-deps.sh

@@ -40,6 +40,11 @@ fi
 echo "getting expenv go library..."
 go get github.com/blang/expenv
 
+echo "getting go dependencies for cli markdown generation"
+go get github.com/cpuguy83/go-md2man/md2man
+go get github.com/spf13/cobra
+
+
 # uncomment only if you want to develop on the project
 #echo "getting all libraries for project..."
 #dep ensure

pgo/generatedocs.go

@@ -0,0 +1,43 @@
+package main
+
+import (
+	"fmt"
+	log "github.com/Sirupsen/logrus"
+	"path/filepath"
+	"path"
+	"strings"
+	"github.com/spf13/cobra/doc"
+	"github.com/crunchydata/postgres-operator/pgo/cmd"
+	
+)
+
+const fmTemplate = `---
+title: "%s"
+---
+`
+
+func main() {
+	
+	fmt.Println("generate CLI markdown")
+
+	filePrepender := func(filename string) string {
+		// now := time.Now().Format(time.RFC3339)
+		name := filepath.Base(filename)
+		base := strings.TrimSuffix(name, path.Ext(name))
+		fmt.Println(base);
+		// url := "/commands/" + strings.ToLower(base) + "/"
+		return fmt.Sprintf(fmTemplate, base)
+	}
+
+	linkHandler := func(name string) string {
+		base := strings.TrimSuffix(name, path.Ext(name))
+		return "/commands/" + strings.ToLower(base) + "/"
+	}
+
+	err := doc.GenMarkdownTreeCustom(cmd.RootCmd, "./", filePrepender, linkHandler)
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+