Dannex Download Manager
  1. Inicio
  2. Contribuir

Contribuir a Dannex Download Manager

Se agradecen los informes de errores, las ideas, las correcciones de traducción y las solicitudes de cambios. Todo se hace de forma abierta en GitHub.

Configuración

Necesitas Windows 10 u 11 y Rust estable 1.98 o posterior (la cadena de herramientas MSVC), además de CMake, LLVM y NASM para BoringSSL, que el motor de conexión tipo navegador compila desde el código fuente (winget install Kitware.CMake LLVM.LLVM NASM.NASM).

cargo build
cargo run -p mdm-app

Para probar los cambios sin afectar tus propias descargas, asigna a la aplicación una carpeta de datos separada:

set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app

cargo run -p mdm-labserver -- --faults "rate=2M"inicia un servidor de pruebas local que sirve archivos generados con los problemas que elijas (conexiones lentas, cortes, respuestas de servidor ocupado, sin rangos; GET / los enumera), para que puedas probar las descargas sin conexión a internet.

Antes de abrir una solicitud de extracción

Estas son las comprobaciones que ejecuta CI; todas funcionan en una copia limpia del repositorio:

cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
python tools/i18n/extract.py      # then: git diff --exit-code i18n/en.tsv
node tools/extension/test.mjs

Limita los cambios a lo necesario y sigue el estilo del código que los rodea. Estas reglas se aplican en todas partes:

Traducciones

La interfaz está disponible en todos los idiomas que ofrece Windows 11. Los catálogos de i18n/ se tradujeron automáticamente, y cada fila marcada con #, machine está pendiente de revisión por un hablante nativo:

  1. Abre i18n/<code>.tsv (los códigos están en i18n/languages.tsv).
  2. Corrige la traducción en la tercera columna de la fila y elimina su línea #, machine.
  3. Mantén {placeholders} y la & (la letra del atajo de teclado) tal como están.

A partir de ese momento, la fila sin su línea #, machine queda a tu cargo: tools/i18n/translate.py no volverá a traducirla automáticamente, y CI (tools/i18n/reviewed_guard.py) rechazará cualquier solicitud de cambios que la elimine o vuelva a marcarla como #, machine.

cargo test -p mdm-app every_catalogcomprueba todos los catálogos. Para ver si tus textos encajan, establece MDM_FIT_AUDIT en un archivo y toma las capturas de pantalla en tu idioma (tools\lab\docs-shots.ps1 ... -Lang <code>): cada texto que se sale de su ventana o se superpone a otro se lista allí. Consulta Idiomas para saber cómo encajan la lista de idiomas, el instalador y el diseño de derecha a izquierda.

La web también está disponible en 21 idiomas y se ha traducido automáticamente. Sus textos están en i18n/site/<code>.json, con una fila por frase: corrige el "text" de una fila (mantén etiquetas como <g1>…</g1> y <x2/> tal como están; son los enlaces y los iconos). python tools/website/translate_site.py --status muestra qué le falta a cada idioma, y la misma herramienta, con --langs <code>, traduce solo lo que falta.

Informar de problemas

Usa Ayuda → Informar de un problema en la aplicación: se abrirá el formulario de informe de errores con tu versión, sistema, método de instalación de DDM e idioma ya rellenados. El formulario te pedirá los mismos datos si lo abres por tu cuenta. Para informar de problemas de seguridad, consulta SECURITY.md.

Las solicitudes de cambios se aceptan según la licencia del proyecto: la GNU GPL, versión 3 o posterior.