New Crowdin updates

docs/books/nvchad/additional_software.es.md

@@ -0,0 +1,67 @@
+---
+title: Software adicional
+author: Franco Colussi
+contributors: Steven Spencer
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+---
+
+# Se necesita software adicional
+
+Hay varias piezas de software adicionales que, aunque no son necesarias, ayudarán en el uso general de NvChad. Las secciones que se muestran a continuación le guiarán a través de ese software y sus usos.
+
+## RipGrep
+
+`ripgrep` es una herramienta de búsqueda orientada a líneas que busca recursivamente en el directorio actual un patrón _regex_ (expresión regular). Por defecto, _ripgrep_ respeta las reglas de _gitignore_ y automáticamente omite archivos/directorios ocultos y los binarios. Ripgrep ofrece un excelente soporte en Windows, macOS y Linux, con binarios disponibles para cada versión.
+
+Ripgrep es un software escrito en _Rust_ que puede instalar con la utilidad `cargo`. Sin embargo, tenga en cuenta que `cargo` no se instala por defecto con la instalación predeterminada de _Rust_ por lo que tiene que instalarlo explícitamente.
+
+```bash
+dnf install rust cargo
+```
+
+Una vez instalado el software necesario, podemos instalar `ripgrep` ejecutando el siguiente comando:
+
+```bash
+cargo install ripgrep
+```
+
+La instalación guardará el ejecutable `rg` en la carpeta `~/.cargo/bin` que se encuentra fuera del PATH, para utilizarlo a nivel de usuario lo enlazaremos a `~/.local/bin/`.
+
+```bash
+ln -s ~/.cargo/bin/rg ~/.local/bin/
+```
+
+En este punto podemos comprobar que todo está correcto mediante la ejecución del siguiente comando:
+
+```bash
+rg --version
+ripgrep 13.0.0
+-SIMD -AVX (compiled)
++SIMD +AVX (runtime)
+```
+
+Para poder realizar búsquedas recursivas con `:Telescopio` es necesario tener instalado RipGrep.
+
+## Lazygit
+
+[LazyGit](https://github.com/jesseduffield/lazygit) es una interfaz de estilo ncurses que le permite realizar todas las operaciones de `git` de una manera fácil. Es requerido por el plugin _lazygit.nvim_. Este plugin permite utilizar LazyGit directamente desde NvChad, abre una ventana flotante desde la que puede realizar todas las operaciones sobre sus repositorios, por lo tanto, le permite hacer todos los cambios en un _ repositorio git_ sin salir del editor.
+
+Para instalarlo podemos utilizar el repositorio de Fedora. En Rocky Linux 9 funciona perfectamente.
+
+```bash
+sudo dnf copr enable atim/lazygit -y
+sudo dnf install lazygit
+```
+
+Una vez instalado abrimos un terminal y tecleamos el comando `lazygit`, aparecerá una interfaz similar:
+
+![Interfaz de usuario de LazyGit](images/lazygit_ui.png)
+
+Con la tecla <kbd>x</kbd> , podemos abrir el menú con todos los comandos disponibles.
+
+![Interfaz de usuario de LazyGit](images/lazygit_menu.png)
+
+Ahora que tenemos todo el software de apoyo necesario instalado en nuestro sistema, podemos pasar a instalar el software básico. Empezaremos con el editor en el que se basa toda la configuración, [Neovim](install_nvim.md).

docs/books/nvchad/custom/init_lua.es.md

@@ -0,0 +1,37 @@
+---
+title: init.lua
+author: Franco Colussi
+contributors: Steven Spencer, Pedro Garcia
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+  - editor
+---
+
+# `init.lua`
+
+El archivo `nvim/lua/custom/init.lua` se utiliza para sobrescribir las opciones de configuración por defecto de NvChad, que se encuentran definidas en el archivo `lua/core/options.lua` y establecer sus propias opciones. También se utiliza para la ejecución de Auto-Comandos.
+
+La escritura de documentos en Markdown no requiere mucha modificación. Vamos a establecer algunos comportamientos como el número de espacios al tabular, una configuración que hace que el formato de los archivos Markdown sea más fluido y agradable.
+
+Nuestro archivo se verá así:
+
+```lua
+vim.cmd [[autocmd BufWritePre * lua vim.lsp.buf.formatting_sync()]]
+-- on 0.8, you should use vim.lsp.buf.format({ bufnr = bufnr }) instead
+
+local opt = vim.opt
+
+opt.tabstop = 4
+opt.softtabstop = 4
+opt.shiftwidth = 4
+opt.shiftround = false
+opt.expandtab = true
+opt.autoindent = true
+opt.smartindent = true
+```
+
+En nuestro ejemplo hemos utilizado un auto-comando para el formateo síncrono del buffer y de las opciones.
+
+Para resumir, el archivo `init.lua` que se encuentra en nuestra carpeta `custom` se utiliza para sobrescribir la configuración predeterminada. Esto funciona porque este fichero se lee después del archivo `core/init.lua`, reemplazando todas las opciones anteriores con las nuevas que hemos establecido.

docs/books/nvchad/custom/override_lua.es.md

@@ -0,0 +1,95 @@
+---
+title: override.lua
+author: Franco Colussi
+contributors: Steven Spencer, Pedro Garcia
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+  - editor
+---
+
+# `override.lua`
+
+El archivo `custom/override.lua` se utiliza para reemplazar la configuración de los plugins definidos en el archivo `chadrc.lua`, permite que se instalen varios *analizadores* al inicio, extiende la funcionalidad de *nvimtree* ademas de otras modificaciones.
+
+El archivo utilizado para nuestro ejemplo es el siguiente:
+
+```lua
+local M = {}
+
+M.treesitter = {
+  ensure_installed = {
+    "html",
+    "markdown",
+    "yaml",
+    "lua",
+  },
+}
+
+M.nvimtree = {
+  git = {
+    enable = true,
+  },
+  renderer = {
+    highlight_git = true,
+    icons = {
+      show = {
+        git = true,
+      },
+    },
+  },
+  view = {
+    side = "right",
+  },
+}
+
+M.blankline = {
+  filetype_exclude = {
+    "help",
+    "terminal",
+    "alpha",
+    "packer",
+    "lspinfo",
+    "TelescopePrompt",
+    "TelescopeResults",
+    "nvchad_cheatsheet",
+    "lsp-installer",
+    "",
+  },
+}
+
+M.mason = {
+  ensure_installed = {
+    "lua-language-server",
+    "marksman",
+    "html-lsp",
+    "yaml-language-server",
+  },
+}
+
+return M
+```
+
+Echemos un vistazo a toda la configuración. En la primera parte se comprueban los analizadores de *treesitter*> definidos en la tabla y se instala todo necesario. En nuestro ejemplo, sólo añadimos aquellos que son útiles para escribir documentos en Markdown. Puede consultar [esta página web](https://github.com/nvim-treesitter/nvim-treesitter#supported-languages) para obtener una lista completa de los analizadores disponibles.
+
+![NvimTree Git](../images/nvimtree_git.png){ align=right }
+
+La segunda parte enriquece nuestro explorador de archivos (*nvimtree*) con decoraciones para el estado de los archivos con respecto al repositorio *Git*, y mueve la vista hacia la derecha.
+
+Luego tenemos una sección que se encarga de eliminar las líneas que indican anidamiento en el código. Finalmente, se encarga de informar a *Mason* qué servidores de idioma son necesarios en el IDE, mediante la función `ensure_installed`.
+
+El control e instalación eventual del *analizador* y de *LSP* es muy útil para gestionar las modificaciones en diferentes estaciones de trabajo. Al guardar la carpeta *custom* en un repositorio de Git, uno tiene la capacidad de clonar los ajustes personalizados en cualquier máquina en la que NvChad esté instalado, y cualquier cambio puede sincronizarse entre todas las máquinas en las que se está trabajando.
+
+Resumir el archivo `custom/override.lua` se utiliza para reemplazar partes de la configuración predeterminada del plugin. Las personalizaciones establecidas en este archivo se tienen en cuenta *sólo* si el plugin está definido en el archivo `custom/chadrc.lua` en la sección *plugin override*.
+
+```lua
+M.plugins = {
+  user = require("custom.plugins"),
+  override = {
+    ["kyazdani42/nvim-tree.lua"] = override.nvimtree,
+    ["nvim-treesitter/nvim-treesitter"] = override.treesitter,
+    ["lukas-reineke/indent-blankline.nvim"] = override.blankline,
+    ["williamboman/mason.nvim"] = override.mason,
+...
+```

docs/gemstones/bash_stub.es.md

@@ -0,0 +1,105 @@
+---
+title: bash - Script Stub
+author: Steven Spencer
+contributors: Ezequiel Bruni, Pedro Garcia
+---
+
+# Bash - Script Stub
+
+En el lugar en el que trabajé anteriormente, teníamos un programador experto que conocía un montón de lenguajes. También era la persona a la que se recurría cuando se tenía alguna duda sobre cómo realizar algo con un script. Finalmente creó un pequeño <0>stub</0>, un archivo lleno de ejemplos de scripting que podías desmontar y editar según la necesidad. Con el tiempo, llegué a ser lo suficientemente bueno en estas rutinas como para no tener que mirar el <0>stub</0>, pero fue una herramienta de aprendizaje buena, y algo que otros pueden encontrar útil.
+
+## El Stub
+
+¡El stub está bien documentado, pero ten en cuenta que no se trata en absoluto de un script exhaustivo! Se podrían añadir muchas más rutinas. Si **usted** tiene ejemplos que encajen bien en este stub siéntase libre de sugerir/añadir algunos cambios:
+
+```
+#!/bin/sh
+
+# By exporting the path, this keeps you from having to enter full paths for commands that exist in those paths:
+
+export PATH="$PATH:/bin:/usr/bin:/usr/local/bin"
+
+# Determine and save absolute path to program directory.
+# Attention! In bash, the ' 'represents the string itself; But " " is a little different. $, ` `, and \ represent call variable values, reference commands, and escape characters, respectively
+# When done will be in same directory as script:
+
+PGM=`basename $0`               # Name of the program
+CDIR=`pwd`                  # Save directory program was run from
+
+PDIR=`dirname $0`
+cd $PDIR
+PDIR=`pwd`
+
+# If a program accepts filenames as arguments, this will put us back where we started.
+# (Needed so references to files using relative paths work.):
+
+cd $CDIR
+
+# Use this if script must be run by certain user:
+
+runby="root"
+iam=`/usr/bin/id -un`
+if [ $iam != "$runby" ]
+then
+    echo "$PGM : program must be run by user \"$runby\""
+    exit
+fi
+
+# Check for missing parameter.
+# Display usage message and exit if it is missing:
+
+if [ "$1" = "" ]
+then
+    echo "$PGM : parameter 1 is required"
+    echo "Usage: $PGM param-one"
+    exit
+fi
+
+# Prompt for data (in this case a yes/no response that defaults to "N"):
+
+/bin/echo -n "Do you wish to continue? [y/N] "
+read yn
+if [ "$yn" != "y" ] && [ "$yn" != "Y" ]
+then
+    echo "Cancelling..."
+    exit;
+fi
+
+# If only one copy of your script can run at a time, use this block of code.
+# Check for lock file.  If it doesn't exist create it.
+# If it does exist, display error message and exit:
+
+LOCKF="/tmp/${PGM}.lock"
+if [ ! -e $LOCKF ]
+then
+    touch $LOCKF
+else
+    echo "$PGM: cannot continue -- lock file exists"
+    echo
+    echo "To continue make sure this program is not already running, then delete the"
+    echo "lock file:"
+    echo
+    echo "    rm -f $LOCKF"
+    echo
+    echo "Aborting..."
+    exit 0
+fi
+
+script_list=`ls customer/*`
+
+for script in $script_list
+do
+    if [ $script != $PGM ]
+    then
+        echo "./${script}"
+    fi
+done
+
+# Remove the lock file
+
+rm -f $LOCKF
+```
+
+## Conclusión
+
+El scripting es el amigo del administrador del sistema. La posibilidad de realizar rápidamente ciertas tareas en un script agiliza la finalización del proceso. Aunque no es en absoluto un conjunto exhaustivo de rutinas de script, este stub ofrece algunos ejemplos de uso común.

docs/gemstones/docker.es.md

@@ -1,6 +1,8 @@
 ---
 title: Instalar Docker Engine
 author: wale soyinka
+contributors:
+date: 04-08-2021
 ---