12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 |
- // Copyright 2020 The Gitea Authors. All rights reserved.
- // SPDX-License-Identifier: MIT
-
- package cmd
-
- import (
- "fmt"
- "os"
- "strings"
-
- "github.com/urfave/cli"
- )
-
- // CmdDocs represents the available docs sub-command.
- var CmdDocs = cli.Command{
- Name: "docs",
- Usage: "Output CLI documentation",
- Description: "A command to output Gitea's CLI documentation, optionally to a file.",
- Action: runDocs,
- Flags: []cli.Flag{
- &cli.BoolFlag{
- Name: "man",
- Usage: "Output man pages instead",
- },
- &cli.StringFlag{
- Name: "output, o",
- Usage: "Path to output to instead of stdout (will overwrite if exists)",
- },
- },
- }
-
- func runDocs(ctx *cli.Context) error {
- docs, err := ctx.App.ToMarkdown()
- if ctx.Bool("man") {
- docs, err = ctx.App.ToMan()
- }
- if err != nil {
- return err
- }
-
- if !ctx.Bool("man") {
- // Clean up markdown. The following bug was fixed in v2, but is present in v1.
- // It affects markdown output (even though the issue is referring to man pages)
- // https://github.com/urfave/cli/issues/1040
- firstHashtagIndex := strings.Index(docs, "#")
-
- if firstHashtagIndex > 0 {
- docs = docs[firstHashtagIndex:]
- }
- }
-
- out := os.Stdout
- if ctx.String("output") != "" {
- fi, err := os.Create(ctx.String("output"))
- if err != nil {
- return err
- }
- defer fi.Close()
- out = fi
- }
-
- _, err = fmt.Fprintln(out, docs)
- return err
- }
|