"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
docs: add automatic alias redirects for command pages
albertony3e12612aae04
diff --git a/cmd/gendocs/gendocs.go b/cmd/gendocs/gendocs.goindex 295eef595..1003e7691 100644--- a/cmd/gendocs/gendocs.go+++ b/cmd/gendocs/gendocs.go@@ -30,12 +30,19 @@ type frontmatter struct {Title stringDescription stringSource string+ Aliases []stringAnnotations map[string]string}var frontmatterTemplate = template.Must(template.New("frontmatter").Parse(`---title: "{{ .Title }}"description: "{{ .Description }}"+{{- if .Aliases }}+aliases:+{{- range $value := .Aliases }}+ - {{ $value }}+{{- end }}+{{- end }}{{- range $key, $value := .Annotations }}{{ $key }}: {{ $value }}{{- end }}@@ -82,23 +89,37 @@ rclone.org website.`,// Look up name => details for prependertype commandDetails struct {Short string+ Aliases []stringAnnotations map[string]string}var commands = map[string]commandDetails{}- var aliases []string- var addCommandDetails func(root *cobra.Command)- addCommandDetails = func(root *cobra.Command) {+ var addCommandDetails func(root *cobra.Command, parentAliases []string)+ addCommandDetails = func(root *cobra.Command, parentAliases []string) {name := strings.ReplaceAll(root.CommandPath(), " ", "_") + ".md"+ var aliases []string+ for _, p := range parentAliases {+ aliases = append(aliases, p+" "+root.Name())+ for _, v := range root.Aliases {+ aliases = append(aliases, p+" "+v)+ }+ }+ for _, v := range root.Aliases {+ if root.HasParent() {+ aliases = append(aliases, root.Parent().CommandPath()+" "+v)+ } else {+ aliases = append(aliases, v)+ }+ }commands[name] = commandDetails{Short: root.Short,+ Aliases: aliases,Annotations: root.Annotations,}- aliases = append(aliases, root.Aliases...)for _, c := range root.Commands() {- addCommandDetails(c)+ addCommandDetails(c, aliases)}}- addCommandDetails(cmd.Root)+ addCommandDetails(cmd.Root, []string{})// markup for the docs filesprepender := func(filename string) string {@@ -109,8 +130,12 @@ rclone.org website.`,Title: strings.ReplaceAll(base, "_", " "),Description: commands[name].Short,Source: strings.ReplaceAll(strings.ReplaceAll(base, "rclone", "cmd"), "_", "/") + "/",+ Aliases: []string{},Annotations: map[string]string{},}+ for _, v := range commands[name].Aliases {+ data.Aliases = append(data.Aliases, "/commands/"+strings.ReplaceAll(v, " ", "_")+"/")+ }// Filter out annotations that confuse hugo from the frontmatterfor k, v := range commands[name].Annotations {if k != "groups" {@@ -145,12 +170,6 @@ rclone.org website.`,name := filepath.Base(path)cmd, ok := commands[name]if !ok {- // Avoid man pages which are for aliases. This is a bit messy!- for _, alias := range aliases {- if strings.Contains(name, alias) {- return nil- }- }return fmt.Errorf("didn't find command for %q", name)}b, err := os.ReadFile(path)