From bf91b638d23e8951e7c7cf0f021211fa9368e275 Mon Sep 17 00:00:00 2001 From: "adamlui@protonmail.com" Date: Sun, 21 Apr 2024 04:35:22 -0700 Subject: [PATCH] Added Spanish docs --- node.js/docs/es/LICENSE.md | 27 ++++ node.js/docs/es/README.md | 290 ++++++++++++++++++++++++++++++++++++ node.js/docs/es/SECURITY.md | 23 +++ 3 files changed, 340 insertions(+) create mode 100644 node.js/docs/es/LICENSE.md create mode 100644 node.js/docs/es/README.md create mode 100644 node.js/docs/es/SECURITY.md diff --git a/node.js/docs/es/LICENSE.md b/node.js/docs/es/LICENSE.md new file mode 100644 index 0000000..a412f73 --- /dev/null +++ b/node.js/docs/es/LICENSE.md @@ -0,0 +1,27 @@ +
+
+ + + + +  Español | + English | + 简体中文 | + 繁體中文 | + हिंदी | + বাংলা | + मराठी | + ਪੰਜਾਬੀ | + Deutsch +
+
+ +# 🏛️ Licencia MIT + +**Derechos de autor © 2024 [Adam Lui](https://github.com/adamlui) y colaboradores** + +Por el presente se otorga permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para operar con el Software sin restricciones, incluidos, entre otros, los derechos de uso, copia, modificación, fusión. , publicar, distribuir, sublicenciar y/o vender copias del Software, y permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones: + +El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software. + +EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, PERO NO LIMITADO A, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, AGRAVIO O DE OTRA MANERA, QUE SURJA DE, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIOS EN EL SOFTWARE. diff --git a/node.js/docs/es/README.md b/node.js/docs/es/README.md new file mode 100644 index 0000000..13f16bf --- /dev/null +++ b/node.js/docs/es/README.md @@ -0,0 +1,290 @@ +
+
+ + + + +  Español | + English | + 简体中文 | + 繁體中文 | + हिंदी | + বাংলা | + मराठी | + ਪੰਜਾਬੀ | + Deutsch +
+
+ +# minify.js + +### Minimiza recursivamente todos los archivos JavaScript. + + + + + + + + + + + +
+ + + +## ⚡ Instalación + +Como **utilidad global**: + +``` +$ npm install -g @adamlui/minify.js +``` + +Como **dependencia del desarrollador** (por ejemplo, para scripts de compilación), desde la raíz de tu proyecto: + +``` +$ npm install -D @adamlui/minify.js +``` + +Como **dependencia del tiempo de ejecución** (por ejemplo, para minificación sobre la marcha), desde la raíz de tu proyecto: + +``` +$ npm install @adamlui/minify.js +``` + +
+ + + +## 💻 Uso de la línea de comando + +El **comando global** básico es: + +``` +$ minify-js +``` + +**💡 Nota:** Pase `-n` o `--dry-run` para ver solo qué archivos se procesarán. + +# + +Para especificar rutas de **entrada/salida**: + +``` +$ minify-js [ruta_entrada] [ruta_salida] +``` + +- `[ruta_entrada]`: Ruta al archivo JS o al directorio que contiene los archivos JS que se van a minimizar, en relación con el directorio de trabajo actual. +- `[ruta_salida]`: Ruta al archivo o directorio donde se almacenarán los archivos minimizados, en relación con la ubicación del archivo original (si no se proporciona, se utiliza `min/`). + +**💡 Nota:** Si se pasan carpetas, los archivos se procesarán de forma recursiva a menos que se pase `-R` o `--no-recursion`. + +# + +Para usarlo como **script de paquete**, en `package.json` de tu proyecto: + +```json + "scripts": { + "build:js": "" + }, +``` + +Reemplace `` con `minify-js` + argumentos opcionales. Luego, se puede usar `npm run build:js` para ejecutar el comando. + +# + +### Comandos de ejemplo + +Minimice todos los archivos JavaScript en el **directorio actual** (salidas a `min/`): + +``` +$ minify-js +``` + +Minimice todos los archivos JavaScript en un **directorio específico** (salidas a `ruta/a/su/directorio/min/`): + +``` +$ minify-js ruta/a/su/directorio +``` + +Minimice un **archivo específico** (salidas a `ruta/a/su/min/archivo.min.js`): + +``` +$ minify-js ruta/a/su/archivo.js +``` + +Especifique los directorios **entrada y salida** (salidas a `carpeta_salida/`): + +``` +$ minify-js carpeta_entrada carpeta_salida +``` + +# + +### Opciones de línea de comando + +``` +Opciones booleanas: + -n, --dry-run En realidad, no minimice los archivos, solo muestre si se procesarán. + -d, --include-dotfolders Incluya carpetas de puntos en la búsqueda de archivos. + -D, --include-dotfiles Incluya archivos de puntos en la búsqueda de archivos. + -R, --no-recursion Deshabilite la búsqueda recursiva de archivos. + -M, --no-mangle Disable mangling names. + -q, --quiet Suprime todos los registros excepto los errores. + +Opciones de parámetros: + --comment="comment" Anteponer comentario al código minimizado. Separe por línea usando '\n'. + +Comandos de información: + -h, --help Mostrar pantalla de ayuda. + -v, --version Mostrar número de versión. +``` + +
+ + + +## 🔌 Uso de API + +También puede importar **minify.js** a su aplicación para usar sus métodos API, tanto como módulo ECMAScript como módulo CommonJS. + +#### ESM*: + +```js +import * as minifyJS from '@adamlui/minify.js'; +``` + +#### CJS: + +```js +const minifyJS = require('@adamlui/minify.js'); +``` + +###### _*Se requiere Node.js versión 14 o superior_ + +# + +### `minify(entrada[, opciones])` + +Minimiza el código JavaScript según la entrada de cadena proporcionada. + +Si se pasa **código fuente**, se minimiza directamente, luego se devuelve un objeto que contiene `srcPath` + `code` + `error`: + +```js +const códigoFuente = 'function add(first, second) { return first + second; }', + minificarResultado = minifyJS.minify(códigoFuente); + +console.log(minificarResultado.error); // genera un error de tiempo de ejecución, o `undefined` si no hay error +console.log(minificarResultado.code); // salidas JS minimizadas: 'function add(n,d){return n+d}' +``` + +Si se pasa una **ruta de archivo**, el código del archivo se carga y luego se minimiza, devolviendo un objeto como el anterior. + +Si se pasa una **ruta de directorio**, se buscan archivos JavaScript (de forma recursiva de forma predeterminada), el código de cada uno se carga, luego se minimiza y luego se devuelve una matriz de objetos que contiene `srcPath` + `code` + `error`: + +```js +// Genera rutas a los archivos JS de origen en el directorio de trabajo + todos los directorios anidados +const minificarResultados = minifyJS.minify('.'); +minificarResultados.forEach(resultado => console.log(resultado.srcPath)); + +// Genera código minimizado del segundo archivo JS si se encuentra, o `undefined` si no se encuentra +console.log(minificarResultados[1].code); +``` + +Las opciones son booleanas y se pasan como propiedades del objeto. Por ejemplo: + +```js +// Devuelve una matriz de objetos de datos donde también se procesan archivos de puntos si `entrada` es una ruta +minifyJS.minify(entrada, { dotFiles: true }); +``` + +Los parámetros disponibles (y sus configuraciones predeterminadas) son: + +Nombre | Tipo | Descripción | Valor por defecto +-------------|----------|-------------------------------------------------------------------------------|------------------- +`recursive` | Booleano | Busque recursivamente archivos anidados si se pasa la ruta del directorio. | `true` +`verbose` | Booleano | Mostrar registros en la consola/terminal. | `true` +`dotFolders` | Booleano | Incluya carpetas de puntos en la búsqueda de archivos. | `false` +`dotFiles` | Booleano | Incluya archivos de puntos en la búsqueda de archivos. | `false` +`mangle` | Booleano | Acorte los nombres de las variables (normalmente a un carácter). | `true` +`comment` | Cadena | Comentario para anteponer al código minimizado. Separe por línea usando '\n'. | `''` + +# + +### `findJS(dirBúsqueda[, opciones])` + +Busca todos los archivos JavaScript no minificados dentro de la cadena `searchDir` pasada (útil para descubrir qué archivos procesará [`minify()`](#minifyentrada-opciones)) y devuelve una matriz que contiene sus rutas de archivo. + +Las opciones son booleanas y se pasan como propiedades del objeto. Por ejemplo: + +```js +// Busque archivos JS no minificados exactamente en assets/js +const resultadosBúsqueda = minifyJS.findJS('assets/js', { recursive: false }); +console.log(resultadosBúsqueda); + +/* salida de muestra: + +findJS() » Searching for unminified JS files... +findJS() » Search complete! 2 files found. +findJS() » Check returned array. +[ + 'E:\\js\\utils\\minify.js\\assets\\js\\foo.js', + 'E:\\js\\utils\\minify.js\\assets\\js\\bar.js' +] +*/ +``` + +Los parámetros disponibles (y sus configuraciones predeterminadas) son: + +Nombre | Tipo | Descripción | Valor por defecto +-------------|----------|-------------------------------------------------------------------------------|------------------- +`recursive` | Booleano | Busque recursivamente archivos anidados si se pasa la ruta del directorio. | `true` +`verbose` | Booleano | Mostrar registros en la consola/terminal. | `true` +`dotFolders` | Booleano | Incluya carpetas de puntos en la búsqueda de archivos. | `false` +`dotFiles` | Booleano | Incluya archivos de puntos en la búsqueda de archivos. | `false` + +
+ + + +## 🏛️ Licencia MIT + +**Derechos de autor © 2024 [Adam Lui](https://github.com/adamlui) y colaboradores** + +Por el presente se otorga permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para operar con el Software sin restricciones, incluidos, entre otros, los derechos de uso, copia, modificación, fusión. , publicar, distribuir, sublicenciar y/o vender copias del Software, y permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones: + +El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software. + +EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, PERO NO LIMITADO A, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, AGRAVIO O DE OTRA MANERA, QUE SURJA DE, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIOS EN EL SOFTWARE. + +
+ + + +## 🛠️ Utilidades relacionadas + +### [ minify.js (Gulp)](https://gulp.minify-js.org) + +> Complemento Gulp para minimizar recursivamente todos los archivos JavaScript. +
[Instalar](https://gulp.minify-js.org/#-installation) / +[Léame](http://gulp.minify-js.org/#readme) / +[Conversar](https://github.minify-js.org/discussions) + +### [{ } scss-to-css](https://github.com/adamlui/scss-to-css) + +> Recursively compile all SCSS files into minified CSS. +
[Instalar](https://github.com/adamlui/scss-to-css/#-installation) / +[Léame](https://github.com/adamlui/scss-to-css/#readme) / +[Uso de CLI](https://github.com/adamlui/scss-to-css/#-command-line-usage) / +[Uso de API](https://github.com/adamlui/scss-to-css/#-api-usage) / +[Conversar](https://github.com/adamlui/scss-to-css/discussions) + +
+ + + + **Más utilidades de JavaScript** / +Conversar / +Volver arriba ↑ diff --git a/node.js/docs/es/SECURITY.md b/node.js/docs/es/SECURITY.md new file mode 100644 index 0000000..79bf0e7 --- /dev/null +++ b/node.js/docs/es/SECURITY.md @@ -0,0 +1,23 @@ +
+
+ + + + +  Español | + English | + 简体中文 | + 繁體中文 | + हिंदी | + বাংলা | + मराठी | + ਪੰਜਾਬੀ | + Deutsch +
+
+ +# 🛡️ Politica de seguridad + +Si encuentra una vulnerabilidad, abra un [borrador de aviso de seguridad](https://github.com/adamlui/minify.js/security/advisories/new). + +Las solicitudes de extracción también son bienvenidas, pero por razones de seguridad, envíe un correo electrónico a y espere una respuesta antes de hacerla pública.