Dannex Download Manager
  1. Home
  2. Bijdragen

Bijdragen aan Dannex Download Manager

Bugrapporten, ideeën, vertaalcorrecties en pull-aanvragen zijn allemaal welkom. Alles gebeurt openbaar op GitHub.

Instellen

U hebt Windows 10 of 11 en Rust stable 1.98 of nieuwer (de MSVC-toolchain) nodig, en CMake, LLVM en NASM voor BoringSSL, die de browserachtige verbinding van de engine vanuit de bron bouwt (winget install Kitware.CMake LLVM.LLVM NASM.NASM).

cargo build
cargo run -p mdm-app

Om wijzigingen uit te proberen zonder uw eigen downloads aan te raken, geeft u de app een aparte gegevensmap:

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

cargo run -p mdm-labserver -- --faults "rate=2M"start een lokale testserver die gegenereerde bestanden aanbiedt met de problemen die u opgeeft (trage verbindingen, onderbrekingen, drukke antwoorden, geen bereikondersteuning; GET / geeft een overzicht), zodat downloads zonder internet kunnen worden getest.

Voordat u een pull-aanvraag opent

Dit zijn de controles die CI uitvoert; ze werken allemaal op een schone kloon:

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

Houd wijzigingen gericht en laat ze aansluiten bij de omringende code. Enkele regels gelden overal:

Vertalingen

De interface is beschikbaar in alle talen die Windows 11 aanbiedt. De catalogi in i18n/ zijn met machinevertaling gemaakt. Elke rij met #, machine moet nog door een moedertaalspreker worden gecontroleerd:

  1. Open i18n/<code>.tsv (de codes staan in i18n/languages.tsv).
  2. Verbeter de vertaling in de derde kolom van de rij en verwijder de regel met #, machine.
  3. Laat {placeholders} en de ene & (de letter voor de sneltoets) ongewijzigd.

Vanaf dat moment is een rij zonder de regel met #, machine door u vertaald: tools/i18n/translate.py stuurt die nooit meer naar de machinevertaling, en CI (tools/i18n/reviewed_guard.py) laat geen pull-aanvraag toe die de rij verwijdert of opnieuw als #, machine markeert.

cargo test -p mdm-app every_catalogcontroleert elke catalogus. Stel MDM_FIT_AUDIT in op een bestand en maak schermafbeeldingen in uw taal (tools\lab\docs-shots.ps1 ... -Lang <code>) om te zien of uw teksten passen: alle teksten die buiten hun venster vallen of over een ander venster heen lopen, worden vermeld. Zie Talen voor informatie over hoe de talenlijst, het installatieprogramma en de lay-out van rechts naar links op elkaar aansluiten.

Ook de website is beschikbaar in 21 talen en is met machinevertaling vertaald. De teksten staan in i18n/site/<code>.json, één zin per rij: verbeter de "text" van een rij (laat tags zoals <g1>…</g1> en <x2/> ongewijzigd; dit zijn de links en pictogrammen). python tools/website/translate_site.py --status laat zien wat er in elke taal nog ontbreekt. Met dezelfde tool en --langs <code> wordt alleen dat vertaald.

Problemen melden

Gebruik Help → Een probleem melden in de app. Hiermee opent u het bugrapportformulier, waarin uw versie, systeem, installatiemethode van DDM en taal al zijn ingevuld. Als u het formulier zelf opent, wordt u om dezelfde gegevens gevraagd. Raadpleeg voor beveiligingsproblemen SECURITY.md.

Pull-aanvragen worden geaccepteerd onder de projectlicentie: de GNU GPL, versie 3 of hoger.