docs: review project information in all seven translations

2026-11-02 10:52:22 +00:00 · 2026-10-17 15:08:53 +02:00
parent ce1a3de719
commit f36b5e22a8
40 changed files with 3111 additions and 45 deletions
@@ -1,12 +1,13 @@
 {
  "meta": {
-    "title": "Código de conducta | ProxMenux Documentation",
+    "title": "Código de conducta | Documentación de ProxMenux",
    "description": "Código de conducta y buenas prácticas de ProxMenux para colaboradores, testers y usuarios.",
-    "ogTitle": "Código de conducta | ProxMenux Documentation",
+    "ogTitle": "Código de conducta | Documentación de ProxMenux",
    "ogDescription": "Expectativas sobre responsabilidad del código, divulgación de problemas de seguridad y alcance de los PRs para el proyecto ProxMenux."
  },
  "errors": {
    "notFound": "Error: archivo CODE_OF_CONDUCT.md no encontrado.",
    "loadFailed": "Error: no se pudo cargar el contenido del código de conducta."
-  }
+  },
+  "contentMarkdown": "# 📝 Código de conducta y buenas prácticas\n\nEste documento define los **principios y las pautas** de uso de **ProxMenux** para promover el **respeto, la colaboración y la seguridad** durante el desarrollo.\n\n## 📌 1. Autoría del código y reconocimiento\n\n- Si se utilizan **scripts, fragmentos de código o ideas** de otros repositorios o desarrolladores, se reconocerá siempre la autoría original.\n- Se añadirá un comentario en el código o la documentación que indique la fuente y, si es posible, enlace al repositorio original.\n- Al utilizar código con una **licencia** concreta, se deben respetar sus condiciones.\n\n### ✅ Ejemplo de reconocimiento de autoría en el código:\n\n```bash\n# Script basado en el trabajo de [Autor] en [Enlace al repositorio]\n```\n\n## 🔒 2. Seguridad y responsabilidad del código\n\n- Todo el código de este repositorio sigue las buenas prácticas de desarrollo seguro.\n- No se permiten contribuciones que introduzcan vulnerabilidades intencionadas o prácticas inseguras.\n- Los scripts nunca deben comprometer la seguridad del sistema ni los datos de los usuarios.\n- Las contribuciones deben revisarse antes de implementarlas para comprobar su seguridad y estabilidad.\n\n### ⚠️ Divulgación responsable de vulnerabilidades\n\nSi descubres una vulnerabilidad de seguridad, NO la notifiques en incidencias o foros públicos.\n\nComunícala en privado por correo electrónico:\n\n📧 proxmenux@macrimi.pro\n\nPara más información sobre las vulnerabilidades y cómo notificarlas, consulta nuestra [política de seguridad](./SECURITY.md).\n\n## 🤝 3. Normas de la comunidad\n\nPara mantener un entorno respetuoso y profesional, todos los usuarios deben seguir estas pautas:\n\n- ✅ Sé respetuoso y constructivo en las discusiones.\n- ❌ No se tolerarán el acoso, el discurso de odio ni las conductas ofensivas.\n- ✅ Aporta comentarios de forma profesional, sin ataques personales.\n- ❌ El incumplimiento puede dar lugar a advertencias o expulsiones, según la gravedad.\n\n##\n\nEste documento promueve un uso ético del código, la conciencia de seguridad y una comunidad respetuosa.\n\n📢 ¡Construyamos algo grande juntos!\n"
 }
@@ -1,6 +1,6 @@
 {
  "meta": {
-    "title": "Contribuir a ProxMenux | ProxMenux Documentation",
+    "title": "Contribuir a ProxMenux | Documentación de ProxMenux",
    "description": "Cómo contribuir a ProxMenux — modelo de ramas (main / develop / feature/*), flujo de pull requests, plantilla de cabecera de script con atribución de autor y enlace opcional de patrocinio, política de diseño UI en dos fases, funciones de mensajes y el camino desde una rama de función hasta un release estable.",
    "ogTitle": "Contribuir a ProxMenux",
    "ogDescription": "Modelo de ramas, flujo de trabajo, atribución en la cabecera del script y política de diseño UI en dos fases que los colaboradores deben seguir."
@@ -129,7 +129,7 @@
    "intro": "Todas definidas en <code>utils.sh</code>. Úsalas como el valor por defecto para cualquier salida visible para el usuario — visuales coherentes entre scripts es la idea. Si tu script necesita una función nueva que no encaja en el conjunto existente (un nuevo nivel de severidad, un nuevo helper de layout, etc.), propónla en tu Pull Request — se revisará y se añadirá a <code>utils.sh</code> si es útil de forma amplia.",
    "headerFunction": "Función",
    "headerWhen": "Cuándo usar",
-    "headerSpinner": "Spinner",
+    "headerSpinner": "Indicador de progreso",
    "rows": [
      {
        "function": "msg_info \"text\"",
@@ -163,7 +163,7 @@
      },
      {
        "function": "msg_success \"text\"",
-        "whenRich": "Prompt final \"Press Enter to return\" al final de la fase 2.",
+        "whenRich": "Mensaje final «Pulsa Intro para volver» al terminar la fase 2.",
        "spinner": "Para"
      },
      {
@@ -1,32 +1,32 @@
 {
  "meta": {
-    "title": "Colaboradores | ProxMenux Documentation",
-    "description": "Reconocimiento a las personas que hacen posible ProxMenux — testers, revisores y desarrolladores que dan forma a cada release.",
-    "ogTitle": "Colaboradores | ProxMenux Documentation",
+    "title": "Colaboradores | Documentación de ProxMenux",
+    "description": "Reconocimiento a las personas que hacen posible ProxMenux: quienes prueban, revisan y desarrollan cada versión.",
+    "ogTitle": "Colaboradores | Documentación de ProxMenux",
    "ogDescription": "Conoce a los colaboradores detrás de ProxMenux."
  },
  "header": {
    "title": "Colaboradores",
-    "description": "El proyecto ProxMenux crece y prospera gracias a la contribución de sus colaboradores. Este es el merecido reconocimiento a su trabajo — probando builds antes del release, cazando regresiones, revisando PRs y dando forma a la dirección de las nuevas funciones.",
+    "description": "ProxMenux crece gracias a sus colaboradores. Esta página reconoce su trabajo: probar versiones antes de publicarlas, detectar regresiones, revisar PR y ayudar a orientar las nuevas funciones.",
    "section": "Acerca de"
  },
  "beyond": {
    "title": "Más allá de esta lista",
-    "body": "Mucha más gente contribuye vía reportes de bugs, ideas de funciones en Discussions, pruebas beta y traducciones. La lista completa de colaboradores de código vive en el <extlink>grafo de colaboradores de GitHub</extlink>. La página de abajo destaca a las personas que han estado más activamente involucradas en probar y revisar releases de ProxMenux."
+    "body": "Muchas más personas contribuyen notificando errores, proponiendo funciones en Discussions, probando versiones beta y traduciendo el proyecto. La lista completa de colaboradores del código está en el <extlink>gráfico de colaboradores de GitHub</extlink>. Esta página destaca a quienes participan más activamente en las pruebas y la revisión de las versiones de ProxMenux."
  },
  "testers": {
-    "heading": "Testers y revisores",
-    "intro": "Estas personas fueron de las primeras en contribuir al proyecto, probando, reportando incidencias y proponiendo mejoras que ayudaron a que ProxMenux haya crecido hasta convertirse en lo que es hoy.",
+    "heading": "Pruebas y revisión",
+    "intro": "Estas personas estuvieron entre las primeras en contribuir al proyecto. Sus pruebas, avisos de errores y propuestas de mejora ayudaron a convertir ProxMenux en lo que es hoy.",
    "roles": {
      "testing": "Pruebas",
-      "testingReviewer": "Pruebas y revisor"
+      "testingReviewer": "Pruebas y revisión"
    },
    "youtube": "YouTube"
  },
  "contribute": {
    "heading": "¿Quieres colaborar?",
    "intro": "Cualquier contribución es bienvenida — código, pruebas, diseño, documentación o simplemente compartir tus ideas:",
-    "tester": "<strong>Tester</strong> — prueba el <beta>canal beta</beta> y reporta qué funciona y qué no antes de los releases estables.",
+    "tester": "<strong>Pruebas</strong>: prueba el <beta>canal beta</beta> y comunica qué funciona y qué no antes de que se publiquen las versiones estables.",
    "developer": "<strong>Desarrollador</strong> — Bash + Next.js (TypeScript) + un poco de Python para el venv de traducción. Los PRs son bienvenidos en <gh>GitHub</gh>.",
    "designer": "<strong>Diseñador</strong> — mejoras de UI, iconos, capturas para la documentación.",
    "ideas": "<strong>Ideas</strong> — abre un hilo en <disc>GitHub Discussions</disc> antes de abrir una incidencia de petición de función."
@@ -1,8 +1,8 @@
 {
  "meta": {
-    "title": "FAQ | ProxMenux Documentation",
+    "title": "Preguntas frecuentes | Documentación de ProxMenux",
    "description": "Preguntas frecuentes sobre ProxMenux: qué es, instalación, compatibilidad (solo PVE 8+), personalización, actualizaciones, seguridad, uso en producción, seguridad de archivos del sistema, contribuir, desinstalación.",
-    "ogTitle": "FAQ | ProxMenux Documentation",
+    "ogTitle": "Preguntas frecuentes | Documentación de ProxMenux",
    "ogDescription": "Preguntas frecuentes sobre instalación, compatibilidad, seguridad y contribución a ProxMenux."
  },
  "header": {
@@ -19,12 +19,12 @@
    "uninstallLabel": "Desinstalación",
    "uninstallSuffix": " — eliminación limpia.",
    "issuesLabel": "GitHub Issues",
-    "discussionsLabel": "Discussions"
+    "discussionsLabel": "Discusiones"
  },
  "q1": {
    "question": "¿Qué es ProxMenux y para qué sirve?",
    "p1Rich": "<strong>ProxMenux</strong> es una herramienta interactiva basada en menús diseñada para hacer <strong>Proxmox VE</strong> accesible a todos los usuarios, independientemente de su experiencia técnica. Simplifica la ejecución de comandos, permitiendo a los usuarios realizar acciones en su sistema sin necesidad de conocimientos avanzados de Linux.",
-    "p2": "Para usuarios menos experimentados, ProxMenux ofrece una forma intuitiva de ejecutar comandos mediante una interfaz de menús estructurada, reduciendo la necesidad de entrada manual por terminal. Para administradores con experiencia, recorta pulsaciones para flujos repetitivos (hardening post-instalación, passthrough de GPU, importación de VMs OVF, rotaciones de snapshots ZFS).",
+    "p2": "Para quienes tienen menos experiencia, ProxMenux ofrece menús estructurados que reducen la necesidad de escribir comandos a mano. A los administradores con experiencia les ahorra pasos en tareas repetitivas: reforzar la seguridad tras instalar, pasar una GPU, importar VM en formato OVF o gestionar la rotación de snapshots ZFS.",
    "p3": "Proxmox VE se usa ampliamente para:",
    "items": [
      "Virtualización de nivel empresarial",
@@ -34,7 +34,7 @@
  },
  "q2": {
    "question": "¿Cómo instalo ProxMenux?",
-    "p1Rich": "Sigue la <installlink>guía de instalación</installlink>. En corto:",
+    "p1Rich": "Sigue la <installlink>guía de instalación</installlink>. En resumen:",
    "stableInstall": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\"",
    "p2": "Una vez instalado, simplemente arráncalo con:",
    "menuCmd": "menu"
@@ -45,7 +45,7 @@
  },
  "q4": {
    "question": "¿Puedo personalizar ProxMenux?",
-    "p1Rich": "Los scripts del núcleo no se pueden modificar directamente porque están alojados en GitHub y se refrescan con el flujo de auto-actualización. Lo que <em>sí</em> puedes personalizar:",
+    "p1Rich": "Las actualizaciones pueden sobrescribir los cambios locales en los scripts principales, así que evita editar esos archivos directamente. Lo que <em>sí</em> puedes personalizar:",
    "items": [
      "El banner de la consola vía la herramienta <strong>FastFetch</strong> en las opciones de post-instalación.",
      "Qué componentes opcionales se instalan (Monitor, Fail2Ban, Lynis…) — elige durante la instalación o vía el menú correspondiente más tarde."
@@ -53,8 +53,8 @@
  },
  "q5": {
    "question": "¿Cómo actualizo ProxMenux?",
-    "p1Rich": "Cuando hay una nueva versión disponible, ProxMenux la detecta en el siguiente lanzamiento de <code>menu</code> y te pide actualizar. Aceptar reemplaza los archivos de utilidad y las configuraciones en sitio. No hace falta descarga manual.",
-    "p2Rich": "Los usuarios estables reciben releases estables; los usuarios beta reciben releases beta. Cuando se publica una versión estable, ProxMenux notifica a los usuarios beta en el siguiente lanzamiento y ofrece cambiar automáticamente — mira la página del <betalink>programa beta</betalink>."
+    "p1Rich": "Cuando hay una nueva versión, ProxMenux la detecta la próxima vez que ejecutas <code>menu</code> y te propone actualizar. Si aceptas, sustituye los archivos de la herramienta y su configuración en la instalación existente; no necesitas descargar nada a mano.",
+    "p2Rich": "Los usuarios de la versión estable reciben las actualizaciones estables y los de la beta, las actualizaciones beta. Cuando se publica una versión estable, la beta avisa al volver a abrir el menú y ofrece cambiar automáticamente a la estable. Consulta el <betalink>programa beta</betalink>."
  },
  "q6": {
    "question": "¿Dónde puedo reportar incidencias?",
@@ -63,19 +63,19 @@
  },
  "q7": {
    "question": "¿Puedo contribuir a ProxMenux?",
-    "p1Rich": "<strong>Absolutamente.</strong> ProxMenux es de código abierto y colaborativo. Las contribuciones pueden ser código (bash, Next.js / TypeScript, el venv de Python de traducción), pruebas, documentación, diseño o simplemente ideas.",
+    "p1Rich": "<strong>Por supuesto.</strong> ProxMenux es un proyecto de código abierto y colaborativo. Puedes contribuir con código (Bash, Next.js/TypeScript y herramientas de traducción en Python), pruebas, documentación, diseño o ideas.",
    "item1Rich": "Discute ideas en <discusslink>GitHub Discussions</discusslink> antes de abrir una petición de función.",
    "item2Rich": "Para PRs, lee primero el <coclink>código de conducta y buenas prácticas</coclink>.",
    "item3Rich": "Mira la <contriblink>página de colaboradores</contriblink> para los testers y revisores actuales."
  },
  "q8": {
    "question": "¿ProxMenux modifica archivos críticos del sistema?",
-    "p1Rich": "<strong>No.</strong> ProxMenux instala:",
-    "item1Rich": "Dependencias vía apt: <code>dialog</code>, <code>curl</code>, <code>jq</code>, <code>git</code> (y <code>python3</code> + <code>googletrans</code> en la instalación con traducción).",
+    "p1Rich": "<strong>La instalación de ProxMenux añade los siguientes componentes.</strong>",
+    "item1Rich": "Dependencias mediante apt: <code>dialog</code>, <code>curl</code>, <code>jq</code> y <code>git</code>. Las traducciones usan catálogos JSON pregenerados; el instalador no añade al host un entorno virtual de traducción.",
    "item2Rich": "El árbol de scripts en <code>/usr/local/share/proxmenux/</code>.",
    "item3Rich": "El lanzador en <code>/usr/local/bin/menu</code>.",
    "item4Rich": "Opcional: el servicio systemd del Monitor en <code>proxmenux-monitor.service</code>.",
-    "p2Rich": "ProxMenux <em>no</em> toca la configuración del núcleo de Proxmox a menos que se lo pidas explícitamente vía un menú dedicado (p. ej. el flujo de reparación de red edita <code>/etc/network/interfaces</code> — pero solo después de que confirmes y se haga un backup)."
+    "p2Rich": "ProxMenux <em>no</em> modifica la configuración principal de Proxmox salvo que lo solicites expresamente desde un menú específico. Por ejemplo, la reparación de red edita <code>/etc/network/interfaces</code>, pero solo después de tu confirmación y de crear una copia de seguridad."
  },
  "q9": {
    "question": "¿Es seguro usar ProxMenux en producción?",
@@ -83,12 +83,12 @@
  },
  "q10": {
    "question": "¿Cómo desinstalo ProxMenux?",
-    "p1Rich": "Desde dentro de ProxMenux: <strong>Settings → Desinstalar ProxMenux</strong>. El desinstalador elimina el árbol de scripts, el lanzador y el servicio del Monitor, opcionalmente elimina las dependencias seleccionadas y restaura los backups de <code>/root/.bashrc</code> y <code>/etc/motd</code> tomados en el momento de la instalación.",
+    "p1Rich": "Desde ProxMenux: <strong>Configuración → Desinstalar ProxMenux</strong>. El desinstalador elimina el árbol de scripts, el lanzador y el servicio Monitor, permite eliminar dependencias seleccionadas y restaura <code>/root/.bashrc</code> y <code>/etc/motd</code> desde las copias de la instalación, si existen.",
    "p2Rich": "Paso a paso completo: <uninstalllink>Desinstalar ProxMenux</uninstalllink>."
  },
  "q11": {
    "question": "VirusTotal marca la URL de instalación — ¿es seguro?",
-    "p1Rich": "Una detección 1/95 por motores heurísticos (p. ej. <em>Chong Lua Dao</em>) es un falso positivo conocido. El instalador usa el patrón estándar <code>curl | bash</code> y descarga binarios legítimos (como <code>jq</code> desde su release oficial en GitHub), que los escáneres agresivos marcan basándose en el <em>comportamiento</em> y no en código realmente malicioso.",
+    "p1Rich": "El resultado de 1/95 notificado en el issue #162, de <em>Chong Lua Dao</em>, fue identificado por el mantenedor como un falso positivo. El instalador usa el patrón <code>curl | bash</code> y puede descargar <code>jq</code> desde su versión oficial de GitHub. Este <em>comportamiento</em> puede activar análisis heurísticos; aquel informe histórico no determina la seguridad de futuras descargas.",
    "p2Rich": "ProxMenux es 100% código abierto y el script de instalación es revisable línea por línea: <scriptlink>install_proxmenux.sh</scriptlink>. Más contexto en la <issuelink>Issue #162</issuelink>."
  }
 }
@@ -1,8 +1,8 @@
 {
  "meta": {
-    "title": "Acerca de | ProxMenux Documentation",
+    "title": "Acerca del proyecto | Documentación de ProxMenux",
    "description": "Acerca de ProxMenux: objetivos del proyecto, colaboradores, FAQ y código de conducta. Herramienta de gestión basada en menús, de código abierto, para Proxmox VE 8+, construida y mantenida por MacRimi con un pequeño equipo de testers y colaboradores.",
-    "ogTitle": "Acerca de | ProxMenux Documentation",
+    "ogTitle": "Acerca del proyecto | Documentación de ProxMenux",
    "ogDescription": "Acerca de ProxMenux — herramienta de gestión basada en menús, de código abierto, para Proxmox VE 8+."
  },
  "header": {
@@ -27,7 +27,7 @@
        "icon": "Users",
        "href": "/docs/about/contributors",
        "title": "Colaboradores",
-        "description": "Reconocimiento a las personas que hacen posible ProxMenux — testers, revisores y desarrolladores que dan forma a cada release."
+        "description": "Reconocimiento a las personas que hacen posible ProxMenux: quienes prueban, revisan y desarrollan cada versión."
      },
      {
        "icon": "ScrollText",
@@ -38,7 +38,7 @@
    ]
  },
  "involved": {
-    "heading": "Implicarse",
+    "heading": "Participa",
    "intro": "Tres lugares para participar en el proyecto:",
    "cards": [
      {