Update make site-docs to reflect latest setup

- Man pages are now placed under `/manual/`
- Use Jekyll `permalink` to avoid the `.html` extension
- Strip "SEE ALSO" and everything after it
This commit is contained in:
Mislav Marohnić 2020-01-31 15:35:57 +01:00
parent 1c1212e6e3
commit 04aff00798
2 changed files with 8 additions and 4 deletions

View file

@ -21,9 +21,11 @@ site:
site-docs: site
git -C site pull
git -C site rm 'gh*.md' 2>/dev/null || true
go run ./cmd/gen-docs site
git -C site add 'gh*.md'
git -C site rm 'manual/gh*.md' 2>/dev/null || true
go run ./cmd/gen-docs site/manual
for f in site/manual/gh*.md; do sed -i.bak -e '/^### SEE ALSO/,$$d' "$$f"; done
rm -f site/manual/*.bak
git -C site add 'manual/gh*.md'
git -C site commit -m 'update help docs'
git -C site push
.PHONY: site-docs

View file

@ -3,6 +3,7 @@ package main
import (
"fmt"
"os"
"strings"
"github.com/cli/cli/command"
"github.com/spf13/cobra/doc"
@ -28,13 +29,14 @@ func main() {
func filePrepender(filename string) string {
return `---
layout: page
permalink: /:path/:basename
---
`
}
func linkHandler(name string) string {
return fmt.Sprintf("{{site.baseurl}}{%% link %s %%}", name)
return fmt.Sprintf("./%s", strings.TrimSuffix(name, ".md"))
}
func fatal(msg interface{}) {