diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index b0e1e61..8dc7968 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -168,11 +168,13 @@ jobs: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | gh release upload "v$VERSION" artifacts/release-*/SHA256SUMS-*.txt --clobber - # The user manuals (built with docs/manual/build/build.ps1 and committed) are - # downloadable next to the installers. + # The English and Traditional Chinese user manuals (built with + # docs/manual/build/build.ps1 and committed) are downloadable next to the installers. + # The other languages are only in docs/manual. - name: User manuals env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | - ls docs/manual/QRcode-tool-User-Manual-*.pdf docs/manual/QRcode-tool-User-Manual-*.docx - gh release upload "v$VERSION" docs/manual/QRcode-tool-User-Manual-*.pdf docs/manual/QRcode-tool-User-Manual-*.docx --clobber + files="docs/manual/QRcode-tool-User-Manual-en.pdf docs/manual/QRcode-tool-User-Manual-en.docx docs/manual/QRcode-tool-User-Manual-zh-TW.pdf docs/manual/QRcode-tool-User-Manual-zh-TW.docx" + ls $files + gh release upload "v$VERSION" $files --clobber diff --git a/AGENTS.md b/AGENTS.md index 7e25a05..c322844 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -73,11 +73,13 @@ triggered from one of their own callbacks. ## User manual -`docs/manual` holds the user manual (PDF + Word, English and Traditional Chinese). Its text is in -`docs/manual/build/content.*.js`; the screenshots are rendered from the real `.slint` files. When a -visible feature or window changes, update the text and rebuild with -`docs/manual/build/build.ps1` (Windows, Node.js, Microsoft Word). The release workflow attaches -the committed `.pdf`/`.docx` files to every GitHub release. +`docs/manual` holds the user manual (PDF + Word) in all ten UI languages. Its text is in +`docs/manual/build/content..js`; the screenshots are rendered from the real `.slint` files. +When a visible feature or window changes, update the text in every language and rebuild with +`docs/manual/build/build.ps1` (Windows, Node.js, Microsoft Word; `-Langs ja,ko` limits the +languages). The release workflow attaches only the English and Traditional Chinese +`.pdf`/`.docx` files to every GitHub release. The READMEs in `docs/i18n` follow the English +`README.md`; keep their language links in sync. **Screenshots are stored in `docs/manual/screenshots//.png`.** That folder is git-ignored: never commit or push it. `build.ps1` reuses these files and only takes the missing @@ -88,7 +90,8 @@ powershell -ExecutionPolicy Bypass -File docs\manual\build\build.ps1 -Shots tool ``` `-Shots all` retakes everything (needed on a fresh checkout or after changing `Theme`/widgets -used everywhere); `-SkipShots` only rebuilds the documents. Retaking `desktop` also retakes the +used everywhere); `-SkipShots` only rebuilds the documents. Texts of the mock desktop and menus +in the screenshots are in `docs/manual/build/docscenes/strings..json`. Retaking `desktop` also retakes the scan and detail screenshots drawn on it, and `camera-source` retakes `camera`. Names (defined in `NAMES` in `docs/manual/build/shoot.js`, cropped in `figures.js`): diff --git a/CHANGELOG.md b/CHANGELOG.md index 0104d47..9bc29d5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +### Added + +- README and user manual (PDF and Word) in Simplified Chinese, Spanish, Portuguese (Brazil), Japanese, Korean, French, German and Russian, in `docs/i18n` and `docs/manual`. Release downloads still carry only the English and Traditional Chinese manuals. + +### Changed + +- The **?** button on the floating toolbar opens the manual in the language of the UI. + ## [1.0.1] - 2026-10-15 ### Changed diff --git a/README.md b/README.md index 367360c..842a4c6 100644 --- a/README.md +++ b/README.md @@ -12,13 +12,13 @@ ![Languages](https://img.shields.io/badge/languages-10-informational) ![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) - · **English** · [繁體中文](docs/i18n/README.zh-TW.md) · + · **English** · [繁體中文](docs/i18n/README.zh-TW.md) · [简体中文](docs/i18n/README.zh-CN.md) · [Español](docs/i18n/README.es.md) · [Português (Brasil)](docs/i18n/README.pt-BR.md) · [日本語](docs/i18n/README.ja.md) · [한국어](docs/i18n/README.ko.md) · [Français](docs/i18n/README.fr.md) · [Deutsch](docs/i18n/README.de.md) · [Русский](docs/i18n/README.ru.md) · Press a shortcut → every QR code on your screen gets a label → press Enter. Works with your webcam too. Free, open source and private. -📘 **User manual:** [PDF](docs/manual/QRcode-tool-User-Manual-en.pdf) · [.docx](docs/manual/QRcode-tool-User-Manual-en.docx) — also attached to every [release](https://github.com/naritaroad/qrcode-tool/releases/latest). +📘 **User manual:** [PDF](docs/manual/QRcode-tool-User-Manual-en.pdf) · [.docx](docs/manual/QRcode-tool-User-Manual-en.docx) — also attached to every [release](https://github.com/naritaroad/qrcode-tool/releases/latest). Other languages are in [docs/manual](docs/manual/README.md). ![Screen scan: every code on the screen gets a pill with its site name](docs/assets/screen-scan.png) @@ -201,7 +201,7 @@ qrcode-tool/ ├─ assets/icons/ # App and tray icons ├─ packaging/ # MSIX, Linux desktop entry, macOS bundle info ├─ docs/ # Architecture, building, FAQ, privacy, translations -│ └─ manual/ # User manual (PDF + Word, English and 繁體中文) and its build scripts +│ └─ manual/ # User manual (PDF + Word, 10 languages) and its build scripts └─ .github/workflows/ # CI and release pipeline ``` diff --git a/crates/qrtool-core/src/lib.rs b/crates/qrtool-core/src/lib.rs index 3324d90..a70f6a4 100644 --- a/crates/qrtool-core/src/lib.rs +++ b/crates/qrtool-core/src/lib.rs @@ -42,9 +42,13 @@ pub mod app_info { pub const VERSION: &str = env!("CARGO_PKG_VERSION"); /// The PDF user manual in the repository for a UI language code ("zh-TW", "en", …). - /// Chinese UI languages get the Traditional Chinese manual, every other one English. + /// Every UI language has its own manual; unknown codes get the English one. pub fn manual_url(language: &str) -> String { - let file = if language.starts_with("zh") { "zh-TW" } else { "en" }; + let file = if crate::locale::is_supported(language) { + language + } else { + "en" + }; format!("{REPO_URL}/blob/main/docs/manual/QRcode-tool-User-Manual-{file}.pdf") } @@ -58,9 +62,11 @@ pub mod app_info { manual_url("zh-TW"), "https://github.com/naritaroad/qrcode-tool/blob/main/docs/manual/QRcode-tool-User-Manual-zh-TW.pdf" ); - assert!(manual_url("zh-CN").ends_with("-zh-TW.pdf")); + assert!(manual_url("zh-CN").ends_with("-zh-CN.pdf")); assert!(manual_url("en").ends_with("-en.pdf")); - assert!(manual_url("ja").ends_with("-en.pdf")); + assert!(manual_url("ja").ends_with("-ja.pdf")); + assert!(manual_url("pt-BR").ends_with("-pt-BR.pdf")); + assert!(manual_url("xx").ends_with("-en.pdf")); assert!(crate::url_safety::analyze_url(&manual_url("de")).is_ok()); } } diff --git a/docs/TRANSLATING.md b/docs/TRANSLATING.md index 0e3c435..7261ab1 100644 --- a/docs/TRANSLATING.md +++ b/docs/TRANSLATING.md @@ -39,7 +39,17 @@ Language*. The language switches immediately. (`Language`, `Plural-Forms`) and translate. 3. Add the language to `LANGUAGES` in `crates/qrtool-core/src/locale.rs` (code and native name) and to `locale::resolve` if the system locale needs mapping. -4. Add the language to the table above and to the README. +4. Add the language to the table above and to the language links at the top of every README. +5. Optionally add `docs/i18n/README..md` and a user manual (see below). + +## README and user manual + +Each language has a README in `docs/i18n/README..md` and a user manual built from +`docs/manual/build/content..js` (text) and `docs/manual/build/docscenes/strings..json` +(texts of the mock desktop in the screenshots). Keep the README sections and the manual blocks in +the same order as the English ones. Rebuild one manual with +`docs\manual\build\build.ps1 -Langs ` (see `docs/manual/README.md`). Only the English and +Traditional Chinese manuals are attached to releases; the others are linked from `docs/manual`. ## For developers: changing UI text diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md new file mode 100644 index 0000000..172edd3 --- /dev/null +++ b/docs/i18n/README.de.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · **Deutsch** · [Русский](README.ru.md) · + +Tastenkombination drücken → jeder QR-Code auf dem Bildschirm bekommt ein Etikett → Enter drücken. + +Funktioniert auch mit der Webcam. Kostenlos, quelloffen und privat. + +📘 **Benutzerhandbuch:** [PDF](../manual/QRcode-tool-User-Manual-de.pdf) · [Word](../manual/QRcode-tool-User-Manual-de.docx) + +![Bildschirmscan: Jeder Code bekommt ein Etikett mit dem Namen seiner Website](../assets/screen-scan.png) + +--- + + + +## Funktionen + + +| | | +| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ⚡ **Einfach zu bedienen** | Drücken Sie Ctrl+Alt+Q (Strg+Alt+Q) oder klicken Sie auf das Symbol im Infobereich, um den Bildschirm einzufrieren. Ein kurzer Scan-Durchlauf findet jeden Code automatisch. | +| 🏷️ **Link-Etiketten** | Jeder Code zeigt den tatsächlichen Websitenamen. Enter öffnet ihn, Tab springt zum nächsten, C kopiert. | +| ✂️ **Bereich auswählen** | Ist ein Code winzig, unscharf oder schräg, ziehen Sie wie mit dem Snipping Tool einen Rahmen darum. | +| 📷 **Webcam** | Halten Sie einen gedruckten Code oder einen Smartphone-Bildschirm vor die Kamera; die Ergebnisse erscheinen live. | +| 🛡️ **Linksicherheit** | Öffnet nie unerwartet einen Link. Warnt vor ähnlich aussehenden Buchstaben, getarnten Adressen (`bank.com@evil.io`), IP-Adressen, unverschlüsseltem `http`, Kurzlinks und mehr – alles offline. | +| 📶 **Versteht den Inhalt** | WLAN (Verbinden mit einem Klick), Kontakte (als vCard speichern), E-Mail, Telefon, SMS, Kartenpositionen, Schlüssel für die zweistufige Überprüfung, taiwanische E-Rechnungen (beide Codes zusammengeführt) und Text. | +| 🧾 **Barcodes** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **Bilder und Zwischenablage** | Scannen Sie einen kopierten Screenshot oder eine beliebige Bilddatei. | +| 🔳 **Einfacher QR-Generator** | Machen Sie aus einem Link oder Text einen QR-Code; kopieren Sie ihn oder speichern Sie ihn als PNG/SVG. | +| 🧰 **Symbolleiste und Blase** | Eine aufgeräumte schwebende Symbolleiste – als Zeile oben oder als Spalte am rechten oder linken Rand –, die sich zur Blase zusammenklappt und bei Vollbild-Apps automatisch verschwindet. | +| 🎨 **Natives Aussehen** | Windows-Stil, folgt dem hellen/dunklen Modus und Ihrer Akzentfarbe. | +| 🌍 **10 Sprachen** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **Privat** | Alles läuft auf Ihrem Computer. Kein Konto, keine Telemetrie, keine Online-Prüfung von Links. Der Verlauf ist standardmäßig aus. | +| ☁️ **Leicht und schnell** | Ein nativer Rust-Kern mit mehr Leistung und weniger Speicherbedarf. | + + + + +## Demo + + +| | | +| -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | +| ![Ein kurzer http-Link wird vor dem Öffnen markiert](../assets/link-warning.png) Verdächtige Links nennen den Grund – und warten auf Sie. | ![WLAN-Code mit Verbinden-Schaltfläche](../assets/wifi-details.png) WLAN-Codes verbinden mit einem Klick; das Kennwort bleibt verborgen. | +| ![Ein Bild aus der Zwischenablage scannen](../assets/image-scan.png) Scannen Sie die Zwischenablage oder eine Bilddatei. | ![Einen QR-Code erstellen](../assets/create-qr.png) Erstellen Sie einen QR-Code. | +| ![Einstellungen](../assets/settings.png) Einstellungen im Stil von Windows 11. | ![Dunkler Modus](../assets/link-warning-dark.png) Folgt dem dunklen Modus und Ihrer Akzentfarbe. | + + + + +## Architektur + +```mermaid +flowchart LR + subgraph Auslöser + HK[Globale Tastenkombination] --> D + TR[Infobereich-Symbol / Menü] --> D + TB[Symbolleiste / Blase] --> D + CLI["qrcode-tool scan-screen
(IPC, z. B. Wayland)"] --> D + end + D{{Verteiler}} --> CAP[Alle Monitore aufnehmen
xcap] + D --> CAM[Webcam
nokhwa] + D --> IMG[Bild / Zwischenablage] + CAP --> OV[Eingefrorene Vollbild-Überlagerung
pro Monitor] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[Decodieren
zxing-cpp + Vergrößern + Kacheln] --> CLS[Inhalt einordnen
URL · WLAN · vCard · E-Rechnung…] + CLS --> SAFE[Sicherheitsanalyse des Links
offline] + SAFE --> UI[Etiketten und Detailkarte
Slint] + UI -->|Enter / Klick| ACT[Im Browser öffnen · WLAN verbinden · Kontakt speichern · Kopieren] +``` + + + +Die App ist ein Cargo-Workspace: ein schlankes UI-Crate auf kleinen, gut testbaren Bibliotheken. +Threads, Datenfluss und Designentscheidungen beschreibt **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)** (Englisch). + +**Technische Details** + +#### Decodierstrategie + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) liest den eingefrorenen Screenshot jedes Monitors parallel. +- Kleine Bildschirme werden zusätzlich in doppelter Größe gelesen; große Bildschirme werden außerdem in überlappende 900-px-Kacheln geteilt, sodass auch ein kleiner Code auf einem 4K-Monitor gefunden wird. +- Die Bereichsauswahl fügt einen Leerraum hinzu und vergrößert den Ausschnitt 2- bis 3-fach. +- Die Webcam decodiert in einem eigenen Thread das neueste Bild, und ein Code muss in drei aufeinanderfolgenden Bildern gesehen werden, bevor er zählt. + + + +#### DPI und mehrere Monitore + +- Der Bildschirm wird zuerst aufgenommen, und jede Überlagerung zeigt dieses eingefrorene Bild. Alle Koordinaten bleiben in Screenshot-Pixeln und werden in der Oberfläche skaliert, sodass gemischte DPI-Umgebungen ohne Umrechnungsfehler funktionieren. + + + +#### Regeln für die Linksicherheit + +- Nur `http`-/`https`-Links lassen sich öffnen; jedes andere Schema wird angezeigt und kann nur kopiert werden. +- Nichts wird an eine Shell übergeben. Links öffnen sich über die Browser-API des Systems. +- Warnungen: unverschlüsseltes `http`, Tarnung mit Benutzerinformationen (`a.com@b.com`), internationale Domänen (zeigt den Punycode), gemischte Alphabete in einem Namensteil, IP-Adressen, ungewöhnliche Ports, Kurzlinks, sehr lange oder stark codierte URLs, tiefe Subdomänen-Ketten. +- Links öffnen sich nie automatisch, außer sie sind der *einzige* gefundene Code, haben *keine* Warnung, und die Website steht auf Ihrer *Vertrauensliste*. +- Kurzlinks werden **nicht** online aufgelöst (das würde dem Kurzlink-Dienst verraten, was Sie gescannt haben). + + + +#### Hinweise zu den Plattformen + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ------------------------------ | --------------------- | ------------------------------------------- | ------------------- | ------------------------------------------------------------------- | +| Bildschirmscan | ✅ | ✅ (Berechtigung „Bildschirmaufnahme“) | ✅ | ⚠️ über Portal / Compositor | +| Globale Tastenkombination | ✅ | ✅ | ✅ | ➖ `qrcode-tool scan-screen` in den Systemeinstellungen zuweisen | +| Bei Vollbild-Apps ausblenden | ✅ | ➖ | ➖ | ➖ | +| Updates | in der App (Velopack) | in der App | in der App (AppImage) | in der App (AppImage) | + + + + +#### Sensible Daten + +- Geheimnisse für die zweistufige Überprüfung und WLAN-Kennwörter werden nie in den Verlauf geschrieben und nie automatisch kopiert. +- Protokolle enthalten nur Ereignisse und Fehler, nie gescannte Inhalte. + + + +## Installation + + + +### Windows 10 (21H2+) / 11 — x64 und ARM64 + +1. Laden Sie `QRcodeTool-win-x64-Setup.exe` (oder `…-arm64-…`) von der [neuesten Version](https://github.com/naritaroad/qrcode-tool/releases/latest) herunter. +2. Führen Sie die Datei aus. QRcode tool wird nur für Ihren Benutzer installiert (ohne Administratorrechte) und startet im Infobereich. +3. Drücken Sie Ctrl+Alt+Q zum Scannen (ändern Sie die Kombination unter *Einstellungen › Tastenkombinationen*, falls eine andere App sie bereits verwendet). Ein Rechtsklick auf den Desktop oder ein Bild bietet dieselben Funktionen (*Einstellungen › Allgemein › Rechtsklickmenü*). Öffnen Sie unter Windows 11 **Weitere Optionen anzeigen**. + +> **„Der Computer wurde durch Windows geschützt“?** Frühe Versionen sind noch nicht codesigniert, daher kann SmartScreen vor einem unbekannten Herausgeber warnen. Klicken Sie auf **Weitere Informationen → Trotzdem ausführen**. Sie können den Download mit den SHA-256-Prüfsummen prüfen, die mit jeder Version veröffentlicht werden. Siehe [FAQ](../FAQ.md#windows-smartscreen) (Englisch). + +Es gibt auch eine **portable** `.zip` (ohne Installationsprogramm, ohne automatische Updates). + +### macOS 13+ (Apple Silicon und Intel) + +Laden Sie die `.pkg` von der [neuesten Version](https://github.com/naritaroad/qrcode-tool/releases/latest) herunter. Erlauben Sie beim ersten Scan unter *Systemeinstellungen › Datenschutz & Sicherheit* die **Bildschirmaufnahme** (und **Kamera** für das Scannen mit der Webcam). Die Versionen sind noch nicht notariell beglaubigt – klicken Sie beim ersten Mal mit der rechten Maustaste auf die App und wählen Sie **Öffnen**. + +### Linux + +Laden Sie das `.AppImage` herunter, machen Sie es ausführbar und starten Sie es. Unter Wayland legen Sie in den Desktop-Einstellungen eine Tastenkombination an, die `qrcode-tool scan-screen` ausführt. + +### Aus dem Quellcode bauen + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Sie brauchen Rust 1.85+, CMake und einen C++-Compiler (für zxing-cpp). Details für jede Plattform: **[docs/BUILDING.md](../BUILDING.md)** (Englisch). + +### Befehlszeile + +```text +qrcode-tool starten (oder die Symbolleiste zeigen, wenn es schon läuft) +qrcode-tool scan-screen den Bildschirm scannen +qrcode-tool scan-region den Bildschirm einfrieren und einen Rahmen ziehen +qrcode-tool scan-camera mit der Webcam scannen +qrcode-tool scan-clipboard das Bild in der Zwischenablage scannen +qrcode-tool scan-file DATEI eine Bilddatei scannen +qrcode-tool show-toolbar die schwebende Symbolleiste zeigen +qrcode-tool generate "TEXT" einen QR-Code erstellen +qrcode-tool decode DATEI… [--json] Bilder ohne Oberfläche decodieren +``` + + + +## Projektstruktur + +```text +qrcode-tool/ +├─ app/ # Die Desktop-App (Slint-Oberfläche + Verbindungscode) +│ ├─ src/ # Infobereich, Tastenkombinationen, Überlagerung, Vorschau, Einstellungen, Updater… +│ ├─ ui/ # .slint-Fenster, Widgets, Symbole +│ └─ translations/ # .po-Dateien für 9 Sprachen +├─ crates/ +│ ├─ qrtool-core/ # Inhaltsanalyse, Linksicherheit, Einstellungen, Verlauf (reines Rust) +│ ├─ qrtool-decode/ # zxing-cpp-Decodierstrategie + QR-Erzeugung +│ ├─ qrtool-capture/ # Screenshots aller Monitore (xcap) +│ ├─ qrtool-camera/ # Webcam-Aufnahme + Live-Decodierung (nokhwa) +│ └─ qrtool-platform/ # Systemintegration: Öffnen, Autostart, Design, WLAN, IPC, Zwischenablage, Kontextmenü +├─ assets/icons/ # App- und Infobereich-Symbole +├─ packaging/ # MSIX, Linux-Desktop-Eintrag, macOS-Bundle-Infos +├─ docs/ # Architektur, Bauen, FAQ, Datenschutz, Übersetzungen +│ └─ manual/ # Benutzerhandbuch (PDF + Word, 10 Sprachen) und seine Build-Skripte +└─ .github/workflows/ # CI und Release-Pipeline +``` + + + +## Mitwirken + +Beiträge sind willkommen – Fehlerberichte, Übersetzungen, Code und Ideen. + +- Lesen Sie zum Einstieg **[CONTRIBUTING.md](../../CONTRIBUTING.md)**. +- Eine Übersetzung verbessern: **[docs/TRANSLATING.md](../TRANSLATING.md)** (die aktuellen Übersetzungen sind geprüfte maschinelle Übersetzungen; Muttersprachler sind sehr willkommen). +- Ein Sicherheitsproblem gefunden? Bitte folgen Sie **[SECURITY.md](../../SECURITY.md)**, statt ein öffentliches Issue zu eröffnen. +- Von allen Beteiligten wird erwartet, dass sie den **[Verhaltenskodex](../../CODE_OF_CONDUCT.md)** einhalten. + +Wenn Ihnen QRcode tool Zeit spart, können Sie [das Projekt unterstützen](https://github.com/sponsors/naritaroad). ❤️ + +## Lizenz + +Lizenziert nach Ihrer Wahl unter einer der folgenden Lizenzen: + +- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license ([LICENSE-MIT](../../LICENSE-MIT)) + +Sofern Sie nicht ausdrücklich etwas anderes angeben, steht jeder Beitrag, den Sie zur Aufnahme in dieses Projekt einreichen, ohne zusätzliche Bedingungen unter der obigen Doppellizenz. + +Komponenten von Drittanbietern und ihre Lizenzen sind in [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md) aufgeführt. Die Oberfläche ist mit [Slint](https://slint.dev) unter der Slint Royalty-free Desktop License gebaut. + +### Verwandte Projekte + +QRcode tool wurde von diesen Projekten inspiriert. Es wurde kein Code daraus übernommen; danke, dass sie gezeigt haben, was QR-Scannen am Desktop sein kann: + +- [qrpeek](https://github.com/dzoffice/qrpeek) — Werkzeug zur Erkennung von QR-Codes auf dem Bildschirm +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — QR-Code-Scanner für den Bildschirm +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — Lesegerät auf Basis von Snipping Tool und ZXing.Net +- [NormCap](https://github.com/dynobo/normcap) — Bildschirmaufnahme mit OCR +- [ShareX](https://github.com/ShareX/ShareX) — Screenshot-Suite mit QR-Code-Werkzeug +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — kostenloser Desktop-Reader + +Aufgebaut auf [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack) und [qrcode](https://github.com/kennytm/qrcode-rust). + +--- + +QR Code ist eine eingetragene Marke der DENSO WAVE INCORPORATED. QRcode tool steht in keiner Verbindung zu DENSO WAVE, Google oder Microsoft. diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md new file mode 100644 index 0000000..fdcca4f --- /dev/null +++ b/docs/i18n/README.es.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · **Español** · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +Pulsa un atajo → cada código QR de la pantalla recibe una etiqueta → pulsa Enter. + +También funciona con la cámara web. Gratis, de código abierto y privado. + +📘 **Manual de usuario:** [PDF](../manual/QRcode-tool-User-Manual-es.pdf) · [Word](../manual/QRcode-tool-User-Manual-es.docx) + +![Escaneo de pantalla: cada código recibe una etiqueta con el nombre de su sitio](../assets/screen-scan.png) + +--- + + + +## Funciones + + +| | | +| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| ⚡ **Fácil de usar** | Pulsa Ctrl+Alt+Q, o haz clic en el icono de la bandeja, para congelar la pantalla. Un barrido rápido encuentra todos los códigos automáticamente. | +| 🏷️ **Etiquetas de enlace** | Cada código muestra el nombre real del sitio. Enter lo abre, Tab pasa al siguiente y C copia. | +| ✂️ **Seleccionar un área** | Si un código es diminuto, borroso o está inclinado, arrastra un recuadro a su alrededor como con una herramienta de recorte. | +| 📷 **Cámara web** | Acerca a la cámara un código impreso o la pantalla de un teléfono; los resultados aparecen en directo. | +| 🛡️ **Seguridad de enlaces** | Nunca abre un enlace por sorpresa. Avisa de letras parecidas, direcciones disfrazadas (`bank.com@evil.io`), direcciones IP, `http` sin cifrar, enlaces acortados y más, todo sin conexión. | +| 📶 **Entiende el contenido** | Wi-Fi (conexión con un clic), contactos (se guardan como vCard), correo, teléfono, SMS, ubicaciones, claves de verificación en dos pasos, facturas electrónicas de Taiwán (los dos códigos se combinan) y texto. | +| 🧾 **Códigos de barras** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **Imágenes y portapapeles** | Escanea una captura que hayas copiado o cualquier archivo de imagen. | +| 🔳 **Generador de QR sencillo** | Convierte un enlace o un texto en un código QR; cópialo o guárdalo como PNG/SVG. | +| 🧰 **Barra y burbuja** | Una barra flotante limpia (una fila arriba o una columna en el borde derecho o izquierdo) que se contrae en una burbuja y se oculta sola con las aplicaciones a pantalla completa. | +| 🎨 **Aspecto nativo** | Estilo de Windows; sigue el modo claro/oscuro y tu color de énfasis. | +| 🌍 **10 idiomas** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **Privado** | Todo se ejecuta en tu computadora. Sin cuenta, sin telemetría, sin comprobaciones de enlaces en línea. El historial está desactivado de forma predeterminada. | +| ☁️ **Ligero y rápido** | Un núcleo nativo en Rust, con más rendimiento y menos uso de memoria. | + + + + +## Demostración + + +| | | +| ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | +| ![Un enlace http corto se marca antes de abrirlo](../assets/link-warning.png) Los enlaces sospechosos explican por qué y te esperan. | ![Código Wi-Fi con botón de conexión](../assets/wifi-details.png) Los códigos Wi-Fi se conectan con un clic; la contraseña queda oculta. | +| ![Escaneo de una imagen del portapapeles](../assets/image-scan.png) Escanea el portapapeles o un archivo de imagen. | ![Crear un código QR](../assets/create-qr.png) Crea un código QR. | +| ![Configuración](../assets/settings.png) Configuración al estilo de Windows 11. | ![Modo oscuro](../assets/link-warning-dark.png) Sigue el modo oscuro y tu color de énfasis. | + + + + +## Arquitectura + +```mermaid +flowchart LR + subgraph Activadores + HK[Atajo global] --> D + TR[Icono / menú de la bandeja] --> D + TB[Barra / burbuja] --> D + CLI["qrcode-tool scan-screen
(IPC, p. ej. Wayland)"] --> D + end + D{{Despachador}} --> CAP[Captura de todos los monitores
xcap] + D --> CAM[Cámara web
nokhwa] + D --> IMG[Imagen / portapapeles] + CAP --> OV[Superposición congelada a pantalla completa
por monitor] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[Decodificación
zxing-cpp + ampliación + mosaicos] --> CLS[Clasificar contenido
URL · Wi-Fi · vCard · factura electrónica…] + CLS --> SAFE[Análisis de seguridad del enlace
sin conexión] + SAFE --> UI[Etiquetas y tarjeta de detalles
Slint] + UI -->|Enter / clic| ACT[Abrir en el navegador · Conectar Wi-Fi · Guardar contacto · Copiar] +``` + + + +La aplicación es un workspace de Cargo: un crate de interfaz delgado sobre bibliotecas pequeñas y fáciles de probar. +Consulta **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)** (en inglés) para ver los hilos, el flujo de datos y las decisiones de diseño. + +**Detalles técnicos** + +#### Estrategia de decodificación + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) lee en paralelo la captura congelada de cada monitor. +- Las pantallas pequeñas se leen también al doble de tamaño; las grandes se dividen además en mosaicos solapados de 900 px, así que un código pequeño en un monitor 4K se sigue encontrando. +- La selección de área añade una zona en blanco y amplía el recorte 2–3 veces. +- La cámara web decodifica el fotograma más reciente en su propio hilo, y un código tiene que verse en tres fotogramas seguidos para contar. + + + +#### DPI y varios monitores + +- Primero se captura la pantalla y cada superposición muestra esa imagen congelada. Todas las coordenadas se quedan en píxeles de la captura y se escalan dentro de la interfaz, así que las configuraciones con DPI mixtos funcionan sin errores de conversión. + + + +#### Reglas de seguridad de enlaces + +- Solo se pueden abrir enlaces `http`/`https`; cualquier otro esquema se muestra y solo se puede copiar. +- Nada se pasa a un shell. Los enlaces se abren con la API del navegador del sistema. +- Advertencias: `http` sin cifrar, disfraz con información de usuario (`a.com@b.com`), dominios internacionales (se muestra el punycode), alfabetos mezclados en una misma etiqueta, direcciones IP, puertos inusuales, enlaces acortados, URL muy largas o muy codificadas y cadenas profundas de subdominios. +- Los enlaces nunca se abren automáticamente salvo que sean el *único* código encontrado, no tengan *ninguna* advertencia y el sitio esté en tu *lista de confianza*. +- Los enlaces acortados **no** se expanden en línea (eso le diría al acortador qué escaneaste). + + + +#### Notas por plataforma + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| --------------------------------- | --------------------- | ------------------------------------------ | ----------------- | -------------------------------------------------------------- | +| Escaneo de pantalla | ✅ | ✅ (permiso de Grabación de pantalla) | ✅ | ⚠️ vía portal / compositor | +| Atajo global | ✅ | ✅ | ✅ | ➖ asigna `qrcode-tool scan-screen` en la configuración del sistema | +| Ocultar con apps a pantalla completa | ✅ | ➖ | ➖ | ➖ | +| Actualizaciones | en la app (Velopack) | en la app | en la app (AppImage) | en la app (AppImage) | + + + + +#### Datos sensibles + +- Los secretos de verificación en dos pasos y las contraseñas Wi-Fi nunca se escriben en el historial ni se copian automáticamente. +- Los registros solo contienen eventos y errores, nunca contenido escaneado. + + + +## Instalación + + + +### Windows 10 (21H2+) / 11 — x64 y ARM64 + +1. Descarga `QRcodeTool-win-x64-Setup.exe` (o `…-arm64-…`) desde la [última versión](https://github.com/naritaroad/qrcode-tool/releases/latest). +2. Ejecútalo. QRcode tool se instala solo para tu usuario (sin permisos de administrador) y se inicia en la bandeja. +3. Pulsa Ctrl+Alt+Q para escanear (cámbialo en *Configuración › Métodos abreviados* si otra aplicación ya lo usa). Haz clic derecho en el escritorio o en una imagen para usar las mismas herramientas (*Configuración › General › Menú del clic derecho*). En Windows 11, abre **Mostrar más opciones**. + +> **¿“Windows protegió su PC”?** Las primeras versiones aún no tienen firma de código, así que SmartScreen puede advertir de un editor desconocido. Haz clic en **Más información → Ejecutar de todas formas**. Puedes verificar la descarga con las sumas SHA-256 publicadas en cada versión. Consulta las [preguntas frecuentes](../FAQ.md#windows-smartscreen) (en inglés). + +También hay un `.zip` **portátil** (sin instalador ni actualizaciones automáticas). + +### macOS 13+ (Apple silicon e Intel) + +Descarga el `.pkg` desde la [última versión](https://github.com/naritaroad/qrcode-tool/releases/latest). En el primer escaneo, permite **Grabación de pantalla** (y **Cámara** para escanear con la cámara web) en *Ajustes del Sistema › Privacidad y seguridad*. Las versiones aún no están notarizadas: la primera vez, haz clic derecho en la app y elige **Abrir**. + +### Linux + +Descarga el `.AppImage`, hazlo ejecutable y ejecútalo. En Wayland, añade en la configuración del escritorio un atajo de teclado que ejecute `qrcode-tool scan-screen`. + +### Compilar desde el código fuente + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Necesitas Rust 1.85+, CMake y un compilador de C++ (para zxing-cpp). Detalles para cada plataforma: **[docs/BUILDING.md](../BUILDING.md)** (en inglés). + +### Línea de comandos + +```text +qrcode-tool iniciar (o mostrar la barra si ya se está ejecutando) +qrcode-tool scan-screen escanear la pantalla +qrcode-tool scan-region congelar la pantalla y arrastrar un recuadro +qrcode-tool scan-camera escanear con la cámara web +qrcode-tool scan-clipboard escanear la imagen del portapapeles +qrcode-tool scan-file ARCHIVO escanear un archivo de imagen +qrcode-tool show-toolbar mostrar la barra de herramientas flotante +qrcode-tool generate "TEXTO" crear un código QR +qrcode-tool decode ARCHIVO… [--json] decodificar imágenes sin la interfaz +``` + + + +## Estructura del proyecto + +```text +qrcode-tool/ +├─ app/ # La aplicación de escritorio (interfaz Slint + código de unión) +│ ├─ src/ # bandeja, atajos, superposición, vista previa, configuración, actualizador… +│ ├─ ui/ # ventanas .slint, widgets, iconos +│ └─ translations/ # archivos .po de 9 idiomas +├─ crates/ +│ ├─ qrtool-core/ # Análisis de contenido, seguridad de enlaces, configuración, historial (Rust puro) +│ ├─ qrtool-decode/ # Estrategia de decodificación con zxing-cpp + generación de QR +│ ├─ qrtool-capture/ # Capturas de varios monitores (xcap) +│ ├─ qrtool-camera/ # Captura de la cámara web + decodificación en directo (nokhwa) +│ └─ qrtool-platform/ # Integración con el sistema: abrir, inicio automático, tema, Wi-Fi, IPC, portapapeles, menú contextual +├─ assets/icons/ # Iconos de la aplicación y de la bandeja +├─ packaging/ # MSIX, entrada de escritorio de Linux, información del paquete de macOS +├─ docs/ # Arquitectura, compilación, preguntas frecuentes, privacidad, traducciones +│ └─ manual/ # Manual de usuario (PDF + Word, 10 idiomas) y sus scripts de generación +└─ .github/workflows/ # CI y proceso de publicación +``` + + + +## Contribuir + +Las contribuciones son bienvenidas: informes de errores, traducciones, código e ideas. + +- Lee **[CONTRIBUTING.md](../../CONTRIBUTING.md)** para empezar. +- Mejora una traducción: **[docs/TRANSLATING.md](../TRANSLATING.md)** (las traducciones actuales son traducciones automáticas revisadas; la ayuda de hablantes nativos es muy bienvenida). +- ¿Encontraste un problema de seguridad? Sigue **[SECURITY.md](../../SECURITY.md)** en lugar de abrir una incidencia pública. +- Se espera que todas las personas participantes sigan el **[código de conducta](../../CODE_OF_CONDUCT.md)**. + +Si QRcode tool te ahorra tiempo, puedes [patrocinar el proyecto](https://github.com/sponsors/naritaroad). ❤️ + +## Licencia + +Se distribuye bajo cualquiera de estas licencias, a tu elección: + +- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license ([LICENSE-MIT](../../LICENSE-MIT)) + +Salvo que indiques expresamente lo contrario, cualquier contribución que envíes para incluirla en este proyecto tendrá la doble licencia anterior, sin términos ni condiciones adicionales. + +Los componentes de terceros y sus licencias se enumeran en [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md). La interfaz está hecha con [Slint](https://slint.dev) bajo la Slint Royalty-free Desktop License. + +### Proyectos relacionados + +QRcode tool se inspiró en estos proyectos. No se copió código de ninguno de ellos; gracias por mostrar lo que puede ser el escaneo de QR en el escritorio: + +- [qrpeek](https://github.com/dzoffice/qrpeek) — herramienta de reconocimiento de códigos QR en pantalla +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — escáner de códigos QR en pantalla +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — lector basado en la Herramienta Recortes y ZXing.Net +- [NormCap](https://github.com/dynobo/normcap) — captura de pantalla con OCR +- [ShareX](https://github.com/ShareX/ShareX) — suite de captura de pantalla con herramienta de códigos QR +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — lector de escritorio gratuito + +Construido sobre [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack) y [qrcode](https://github.com/kennytm/qrcode-rust). + +--- + +QR Code es una marca registrada de DENSO WAVE INCORPORATED. QRcode tool no está afiliado a DENSO WAVE, Google ni Microsoft. diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md new file mode 100644 index 0000000..d903254 --- /dev/null +++ b/docs/i18n/README.fr.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · **Français** · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +Appuyez sur un raccourci → chaque code QR à l’écran reçoit une étiquette → appuyez sur Entrée. + +Fonctionne aussi avec votre webcam. Gratuit, open source et respectueux de la vie privée. + +📘 **Manuel d’utilisation :** [PDF](../manual/QRcode-tool-User-Manual-fr.pdf) · [Word](../manual/QRcode-tool-User-Manual-fr.docx) + +![Scan de l’écran : chaque code reçoit une étiquette avec le nom de son site](../assets/screen-scan.png) + +--- + + + +## Fonctionnalités + + +| | | +| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ⚡ **Simple à utiliser** | Appuyez sur Ctrl+Alt+Q, ou cliquez sur l’icône de notification, pour figer l’écran. Un balayage rapide trouve automatiquement tous les codes. | +| 🏷️ **Étiquettes de lien** | Chaque code affiche le vrai nom du site. Entrée l’ouvre, Tab passe au suivant, C copie. | +| ✂️ **Sélectionner une zone** | Quand un code est minuscule, flou ou incliné, tracez un cadre autour, comme avec l’Outil Capture. | +| 📷 **Webcam** | Présentez à la caméra un code imprimé ou l’écran d’un téléphone ; les résultats s’affichent en direct. | +| 🛡️ **Sécurité des liens** | N’ouvre jamais un lien par surprise. Signale les lettres similaires, les adresses déguisées (`bank.com@evil.io`), les adresses IP, le `http` non chiffré, les liens raccourcis et plus encore — entièrement hors ligne. | +| 📶 **Comprend le contenu** | Wi-Fi (connexion en un clic), contacts (enregistrés en vCard), e-mail, téléphone, SMS, positions, clés de vérification en deux étapes, factures électroniques de Taïwan (les deux codes fusionnés) et texte. | +| 🧾 **Codes-barres** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **Images et Presse-papiers** | Scannez une capture d’écran copiée ou n’importe quel fichier image. | +| 🔳 **Générateur de QR simple** | Transformez un lien ou un texte en code QR ; copiez-le ou enregistrez-le en PNG/SVG. | +| 🧰 **Barre et bulle** | Une barre flottante épurée — une rangée en haut ou une colonne sur le bord droit ou gauche — qui se réduit en bulle et se masque d’elle-même pendant les applications en plein écran. | +| 🎨 **Aspect natif** | Style Windows ; suit le mode clair/sombre et votre couleur d’accentuation. | +| 🌍 **10 langues** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **Confidentiel** | Tout s’exécute sur votre ordinateur. Pas de compte, pas de télémétrie, pas de vérification de liens en ligne. L’historique est désactivé par défaut. | +| ☁️ **Léger et rapide** | Un cœur natif en Rust, pour plus de performances et moins de mémoire utilisée. | + + + + +## Démonstration + + +| | | +| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| ![Un lien http court est signalé avant l’ouverture](../assets/link-warning.png) Les liens suspects expliquent pourquoi — et vous attendent. | ![Code Wi-Fi avec bouton de connexion](../assets/wifi-details.png) Les codes Wi-Fi se connectent en un clic ; le mot de passe reste masqué. | +| ![Scan d’une image du Presse-papiers](../assets/image-scan.png) Scannez le Presse-papiers ou un fichier image. | ![Créer un code QR](../assets/create-qr.png) Créez un code QR. | +| ![Paramètres](../assets/settings.png) Paramètres dans le style de Windows 11. | ![Mode sombre](../assets/link-warning-dark.png) Suit le mode sombre et votre couleur d’accentuation. | + + + + +## Architecture + +```mermaid +flowchart LR + subgraph Déclencheurs + HK[Raccourci global] --> D + TR[Icône / menu de notification] --> D + TB[Barre / bulle] --> D + CLI["qrcode-tool scan-screen
(IPC, p. ex. Wayland)"] --> D + end + D{{Répartiteur}} --> CAP[Capture de tous les écrans
xcap] + D --> CAM[Webcam
nokhwa] + D --> IMG[Image / Presse-papiers] + CAP --> OV[Superposition figée en plein écran
par écran] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[Décodage
zxing-cpp + agrandissement + tuiles] --> CLS[Classer le contenu
URL · Wi-Fi · vCard · facture électronique…] + CLS --> SAFE[Analyse de sécurité du lien
hors ligne] + SAFE --> UI[Étiquettes et fiche de détails
Slint] + UI -->|Entrée / clic| ACT[Ouvrir dans le navigateur · Connecter le Wi-Fi · Enregistrer le contact · Copier] +``` + + + +L’application est un workspace Cargo : un crate d’interface fin au-dessus de petites bibliothèques faciles à tester. +Voir **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)** (en anglais) pour les threads, le flux de données et les choix de conception. + +**Détails techniques** + +#### Stratégie de décodage + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) lit en parallèle la capture figée de chaque écran. +- Les petits écrans sont aussi lus à l’échelle 2× ; les grands écrans sont en plus découpés en tuiles de 900 px qui se chevauchent, si bien qu’un petit code sur un écran 4K est quand même trouvé. +- La sélection de zone ajoute une marge blanche et agrandit la découpe 2 à 3 fois. +- La webcam décode l’image la plus récente dans son propre thread, et un code doit être vu sur trois images consécutives pour compter. + + + +#### DPI et écrans multiples + +- L’écran est d’abord capturé, puis chaque superposition affiche cette image figée. Toutes les coordonnées restent en pixels de capture et sont mises à l’échelle dans l’interface : les configurations à DPI mixtes fonctionnent sans erreurs de conversion. + + + +#### Règles de sécurité des liens + +- Seuls les liens `http`/`https` peuvent être ouverts ; tout autre schéma est affiché et peut seulement être copié. +- Rien n’est transmis à un shell. Les liens s’ouvrent avec l’API de navigateur du système. +- Avertissements : `http` non chiffré, déguisement par informations d’utilisateur (`a.com@b.com`), domaines internationaux (affiche le punycode), alphabets mélangés dans un même libellé, adresses IP, ports inhabituels, liens raccourcis, URL très longues ou très encodées, longues chaînes de sous-domaines. +- Les liens ne s’ouvrent jamais automatiquement, sauf s’ils sont le *seul* code trouvé, n’ont *aucun* avertissement et que le site est dans votre *liste de confiance*. +- Les liens raccourcis ne sont **pas** dépliés en ligne (cela révélerait au service de raccourcissement ce que vous avez scanné). + + + +#### Notes par plateforme + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ----------------------------------- | --------------------- | ------------------------------------------- | ---------------------- | -------------------------------------------------------------- | +| Scan de l’écran | ✅ | ✅ (autorisation d’enregistrement de l’écran) | ✅ | ⚠️ via portail / compositeur | +| Raccourci global | ✅ | ✅ | ✅ | ➖ associez `qrcode-tool scan-screen` dans les réglages système | +| Masquer en plein écran | ✅ | ➖ | ➖ | ➖ | +| Mises à jour | dans l’app (Velopack) | dans l’app | dans l’app (AppImage) | dans l’app (AppImage) | + + + + +#### Données sensibles + +- Les secrets de vérification en deux étapes et les mots de passe Wi-Fi ne sont jamais écrits dans l’historique ni copiés automatiquement. +- Les journaux ne contiennent que des événements et des erreurs, jamais de contenu scanné. + + + +## Installation + + + +### Windows 10 (21H2+) / 11 — x64 et ARM64 + +1. Téléchargez `QRcodeTool-win-x64-Setup.exe` (ou `…-arm64-…`) depuis la [dernière version](https://github.com/naritaroad/qrcode-tool/releases/latest). +2. Lancez-le. QRcode tool s’installe pour votre seul utilisateur (sans droits d’administrateur) et démarre dans la zone de notification. +3. Appuyez sur Ctrl+Alt+Q pour scanner (changez-le dans *Paramètres › Raccourcis* si une autre application l’utilise déjà). Faites un clic droit sur le Bureau ou sur une image pour accéder aux mêmes outils (*Paramètres › Général › Menu contextuel*). Sous Windows 11, ouvrez **Afficher d’autres options**. + +> **« Windows a protégé votre ordinateur » ?** Les premières versions ne sont pas encore signées numériquement ; SmartScreen peut donc signaler un éditeur inconnu. Cliquez sur **Informations complémentaires → Exécuter quand même**. Vous pouvez vérifier le téléchargement grâce aux sommes SHA-256 publiées avec chaque version. Voir la [FAQ](../FAQ.md#windows-smartscreen) (en anglais). + +Un `.zip` **portable** est aussi disponible (sans installateur ni mises à jour automatiques). + +### macOS 13+ (Apple silicon et Intel) + +Téléchargez le `.pkg` depuis la [dernière version](https://github.com/naritaroad/qrcode-tool/releases/latest). Au premier scan, autorisez **Enregistrement de l’écran** (et **Caméra** pour le scan par webcam) dans *Réglages Système › Confidentialité et sécurité*. Les versions ne sont pas encore notariées : la première fois, faites un clic droit sur l’app et choisissez **Ouvrir**. + +### Linux + +Téléchargez l’`.AppImage`, rendez-la exécutable et lancez-la. Sous Wayland, ajoutez dans les réglages du bureau un raccourci clavier qui exécute `qrcode-tool scan-screen`. + +### Compiler depuis les sources + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Il faut Rust 1.85+, CMake et un compilateur C++ (pour zxing-cpp). Détails pour chaque plateforme : **[docs/BUILDING.md](../BUILDING.md)** (en anglais). + +### Ligne de commande + +```text +qrcode-tool démarrer (ou afficher la barre s’il tourne déjà) +qrcode-tool scan-screen scanner l’écran +qrcode-tool scan-region figer l’écran et tracer un cadre +qrcode-tool scan-camera scanner avec la webcam +qrcode-tool scan-clipboard scanner l’image du Presse-papiers +qrcode-tool scan-file FICHIER scanner un fichier image +qrcode-tool show-toolbar afficher la barre d’outils flottante +qrcode-tool generate "TEXTE" créer un code QR +qrcode-tool decode FICHIER… [--json] décoder des images sans l’interface +``` + + + +## Structure du projet + +```text +qrcode-tool/ +├─ app/ # L’application de bureau (interface Slint + code de liaison) +│ ├─ src/ # zone de notification, raccourcis, superposition, aperçu, paramètres, mises à jour… +│ ├─ ui/ # fenêtres .slint, widgets, icônes +│ └─ translations/ # fichiers .po pour 9 langues +├─ crates/ +│ ├─ qrtool-core/ # Analyse du contenu, sécurité des liens, paramètres, historique (Rust pur) +│ ├─ qrtool-decode/ # Stratégie de décodage zxing-cpp + génération de QR +│ ├─ qrtool-capture/ # Captures multi-écrans (xcap) +│ ├─ qrtool-camera/ # Capture webcam + décodage en direct (nokhwa) +│ └─ qrtool-platform/ # Intégration au système : ouverture, démarrage auto, thème, Wi-Fi, IPC, Presse-papiers, menu contextuel +├─ assets/icons/ # Icônes de l’application et de la zone de notification +├─ packaging/ # MSIX, entrée de bureau Linux, informations du paquet macOS +├─ docs/ # Architecture, compilation, FAQ, confidentialité, traductions +│ └─ manual/ # Manuel d’utilisation (PDF + Word, 10 langues) et ses scripts de génération +└─ .github/workflows/ # CI et chaîne de publication +``` + + + +## Contribuer + +Les contributions sont les bienvenues : rapports de bogues, traductions, code et idées. + +- Lisez **[CONTRIBUTING.md](../../CONTRIBUTING.md)** pour commencer. +- Améliorer une traduction : **[docs/TRANSLATING.md](../TRANSLATING.md)** (les traductions actuelles sont des traductions automatiques relues ; les locuteurs natifs sont les bienvenus). +- Vous avez trouvé un problème de sécurité ? Suivez **[SECURITY.md](../../SECURITY.md)** au lieu d’ouvrir une issue publique. +- Toutes les personnes qui participent doivent respecter le **[code de conduite](../../CODE_OF_CONDUCT.md)**. + +Si QRcode tool vous fait gagner du temps, vous pouvez [soutenir le projet](https://github.com/sponsors/naritaroad). ❤️ + +## Licence + +Distribué, au choix, sous l’une de ces licences : + +- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license ([LICENSE-MIT](../../LICENSE-MIT)) + +Sauf mention contraire explicite de votre part, toute contribution que vous soumettez pour inclusion dans ce projet est placée sous la double licence ci-dessus, sans conditions supplémentaires. + +Les composants tiers et leurs licences sont listés dans [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md). L’interface est construite avec [Slint](https://slint.dev) sous la Slint Royalty-free Desktop License. + +### Projets apparentés + +QRcode tool s’inspire de ces projets. Aucun code n’en a été copié ; merci à eux d’avoir montré ce que peut être la lecture de QR codes sur ordinateur : + +- [qrpeek](https://github.com/dzoffice/qrpeek) — outil de reconnaissance de codes QR à l’écran +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — scanner de codes QR à l’écran +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — lecteur basé sur l’Outil Capture et ZXing.Net +- [NormCap](https://github.com/dynobo/normcap) — capture d’écran avec OCR +- [ShareX](https://github.com/ShareX/ShareX) — suite de capture d’écran avec un outil QR code +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — lecteur de bureau gratuit + +Construit grâce à [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack) et [qrcode](https://github.com/kennytm/qrcode-rust). + +--- + +QR Code est une marque déposée de DENSO WAVE INCORPORATED. QRcode tool n’est affilié ni à DENSO WAVE, ni à Google, ni à Microsoft. diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md new file mode 100644 index 0000000..d91ea0b --- /dev/null +++ b/docs/i18n/README.ja.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · **日本語** · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +ショートカット キーを押す → 画面上のすべての QR コードにラベルが付く → Enter を押す。 + +Web カメラでも使えます。無料、オープンソース、プライバシー重視。 + +📘 **ユーザーマニュアル:**[PDF](../manual/QRcode-tool-User-Manual-ja.pdf) · [Word](../manual/QRcode-tool-User-Manual-ja.docx) + +![画面スキャン:すべてのコードにサイト名入りのラベルが付く](../assets/screen-scan.png) + +--- + + + +## 機能 + + +| | | +| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | +| ⚡ **かんたん操作** | Ctrl+Alt+Q を押すかトレイ アイコンをクリックすると画面が固定され、すばやいスキャン アニメーションですべてのコードを自動で見つけます。 | +| 🏷️ **リンク ラベル** | 各コードに実際のサイト名を表示します。Enter で開き、Tab で次へ、C でコピー。 | +| ✂️ **範囲を選択** | コードが小さい、ぼやけている、傾いているときは、切り取りツールのように枠で囲みます。 | +| 📷 **Web カメラ** | 印刷されたコードやスマートフォンの画面をカメラに向けると、結果がリアルタイムで表示されます。 | +| 🛡️ **リンクの安全チェック** | 勝手にリンクを開くことはありません。よく似た文字、偽装されたアドレス(`bank.com@evil.io`)、IP アドレス、暗号化されていない `http`、短縮リンクなどを警告します。すべてオフラインで行います。 | +| 📶 **内容を理解** | Wi-Fi(ワン クリックで接続)、連絡先(vCard で保存)、メール、電話、SMS、地図上の位置、2 段階認証のキー、台湾の電子インボイス(2 つのコードを結合)、テキスト。 | +| 🧾 **バーコード** | EAN、UPC、Code 128、Data Matrix、PDF417、Aztec… | +| 🖼️ **画像とクリップボード** | コピーしたスクリーンショットや任意の画像ファイルをスキャンします。 | +| 🔳 **シンプルな QR コード作成** | リンクやテキストを QR コードに変換し、コピーまたは PNG / SVG で保存できます。 | +| 🧰 **ツールバーとバブル** | すっきりしたフローティング ツールバー。上部に横一列、または左右の端に縦一列で置けます。バブルに折りたためて、全画面アプリの使用中は自動で隠れます。 | +| 🎨 **ネイティブな見た目** | Windows のスタイルで、ライト / ダーク モードとアクセント カラーに追従します。 | +| 🌍 **10 言語** | English、繁體中文、简体中文、Español、Português (Brasil)、日本語、한국어、Français、Deutsch、Русский。 | +| 🔒 **プライバシー** | すべてお使いのパソコンの中で動きます。アカウント不要、テレメトリなし、オンラインでのリンク照会なし。履歴は既定でオフです。 | +| ☁️ **軽くて速い** | ネイティブの Rust コアで、高いパフォーマンスと少ないメモリ使用量を実現しています。 | + + + + +## デモ + + +| | | +| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | +| ![短い http リンクは開く前に警告される](../assets/link-warning.png) 不審なリンクは理由を表示し、あなたの操作を待ちます。 | ![接続ボタン付きの Wi-Fi コード](../assets/wifi-details.png) Wi-Fi コードはワン クリックで接続。パスワードは隠れたままです。 | +| ![クリップボードの画像をスキャン](../assets/image-scan.png) クリップボードや画像ファイルをスキャンできます。 | ![QR コードを作成](../assets/create-qr.png) QR コードを作成できます。 | +| ![設定](../assets/settings.png) Windows 11 スタイルの設定画面。 | ![ダーク モード](../assets/link-warning-dark.png) ダーク モードとアクセント カラーに追従します。 | + + + + +## アーキテクチャ + +```mermaid +flowchart LR + subgraph 起動方法 + HK[グローバル ショートカット] --> D + TR[トレイ アイコン / メニュー] --> D + TB[ツールバー / バブル] --> D + CLI["qrcode-tool scan-screen
(IPC、例:Wayland)"] --> D + end + D{{ディスパッチャー}} --> CAP[全モニターをキャプチャ
xcap] + D --> CAM[Web カメラ
nokhwa] + D --> IMG[画像 / クリップボード] + CAP --> OV[固定した全画面オーバーレイ
モニターごと] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[デコード
zxing-cpp + 拡大 + タイル分割] --> CLS[内容を分類
URL · Wi-Fi · vCard · 電子インボイス…] + CLS --> SAFE[リンクの安全分析
オフライン] + SAFE --> UI[ラベルと詳細カード
Slint] + UI -->|Enter / クリック| ACT[ブラウザーで開く · Wi-Fi に接続 · 連絡先を保存 · コピー] +``` + + + +アプリは Cargo ワークスペースです。小さくテストしやすいライブラリの上に、薄い UI クレートが載っています。 +スレッド、データの流れ、設計上の判断については **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)**(英語)を参照してください。 + +**技術的な詳細** + +#### デコードの方法 + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) で、各モニターの固定したスクリーンショットを並列に読み取ります。 +- 小さい画面は 2 倍に拡大してもう一度読み取ります。大きい画面はさらに 900 px の重なり合うタイルに分割するので、4K モニター上の小さなコードも見つかります。 +- 範囲選択では周囲に余白を加え、切り出した部分を 2~3 倍に拡大します。 +- Web カメラは専用スレッドで最新のフレームをデコードし、3 フレーム連続で読み取れたコードだけを結果とします。 + + + +#### DPI と複数モニター + +- 先に画面をキャプチャし、各オーバーレイはその固定画像を表示します。座標はすべてスクリーンショットのピクセルのまま扱い、UI の中で拡大縮小するため、DPI が混在する環境でも変換のずれが起きません。 + + + +#### リンクの安全ルール + +- 開けるのは `http`/`https` のリンクだけです。それ以外のスキームは表示のみで、コピーしかできません。 +- シェルには何も渡しません。リンクはシステムのブラウザー API で開きます。 +- 警告の対象:暗号化されていない `http`、ユーザー情報による偽装(`a.com@b.com`)、国際化ドメイン(punycode を表示)、1 つのラベル内での文字体系の混在、IP アドレス、通常と異なるポート、短縮リンク、非常に長い・エンコードの多い URL、深いサブドメインの連なり。 +- 見つかったコードが*1 つだけ*で、警告が*まったくなく*、サイトが*信頼済みリスト*にある場合を除き、リンクが自動で開くことはありません。 +- 短縮リンクはオンラインで展開**しません**(展開すると、何をスキャンしたかが短縮サービスに伝わるためです)。 + + + +#### プラットフォームごとの注意 + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ---------------- | --------------------- | ------------------ | ------------------ | ------------------------------------------------- | +| 画面スキャン | ✅ | ✅(画面収録の許可が必要) | ✅ | ⚠️ portal / コンポジター経由 | +| グローバル ショートカット | ✅ | ✅ | ✅ | ➖ システム設定で `qrcode-tool scan-screen` を割り当てる | +| 全画面アプリの使用中は非表示 | ✅ | ➖ | ➖ | ➖ | +| 更新 | アプリ内(Velopack) | アプリ内 | アプリ内(AppImage) | アプリ内(AppImage) | + + + + +#### 機密データ + +- 2 段階認証の秘密の値と Wi-Fi のパスワードは、履歴に書き込まれず、自動でコピーされることもありません。 +- ログに記録されるのはイベントとエラーだけで、読み取った内容は含まれません。 + + + +## インストール + + + +### Windows 10(21H2 以降)/ 11 — x64 と ARM64 + +1. [最新リリース](https://github.com/naritaroad/qrcode-tool/releases/latest)から `QRcodeTool-win-x64-Setup.exe`(または `…-arm64-…`)をダウンロードします。 +2. 実行します。QRcode tool はお使いのユーザーにだけインストールされ(管理者権限は不要)、トレイで起動します。 +3. Ctrl+Alt+Q でスキャンします(他のアプリが使っている場合は *設定 › ショートカット* で変更できます)。デスクトップや画像を右クリックしても同じ機能が使えます(*設定 › 全般 › 右クリックメニュー*)。Windows 11 では **その他のオプションを確認** を開いてください。 + +> **「Windows によって PC が保護されました」と表示されたら?** 初期のリリースはまだコード署名されていないため、SmartScreen が不明な発行元として警告することがあります。**詳細情報 → 実行** をクリックしてください。各リリースで公開している SHA-256 チェックサムでダウンロードを検証できます。[FAQ](../FAQ.md#windows-smartscreen)(英語)も参照してください。 + +**ポータブル版** の `.zip` もあります(インストール不要、自動更新なし)。 + +### macOS 13 以降(Apple シリコンと Intel) + +[最新リリース](https://github.com/naritaroad/qrcode-tool/releases/latest)から `.pkg` をダウンロードします。最初のスキャンのときに、*システム設定 › プライバシーとセキュリティ* で **画面収録**(Web カメラを使う場合は **カメラ** も)を許可してください。リリースはまだ公証を受けていないため、初回はアプリを右クリックして **開く** を選んでください。 + +### Linux + +`.AppImage` をダウンロードし、実行権限を付けて実行します。Wayland では、デスクトップの設定で `qrcode-tool scan-screen` を実行するキーボード ショートカットを追加してください。 + +### ソースからビルド + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Rust 1.85 以降、CMake、C++ コンパイラー(zxing-cpp 用)が必要です。プラットフォームごとの詳細は **[docs/BUILDING.md](../BUILDING.md)**(英語)を参照してください。 + +### コマンド ライン + +```text +qrcode-tool 起動(起動中ならツールバーを表示) +qrcode-tool scan-screen 画面をスキャン +qrcode-tool scan-region 画面を固定して枠で囲む +qrcode-tool scan-camera Web カメラでスキャン +qrcode-tool scan-clipboard クリップボードの画像をスキャン +qrcode-tool scan-file ファイル 画像ファイルを 1 つスキャン +qrcode-tool show-toolbar フローティング ツールバーを表示 +qrcode-tool generate "テキスト" QR コードを作成 +qrcode-tool decode ファイル… [--json] UI なしで画像をデコード +``` + + + +## プロジェクト構成 + +```text +qrcode-tool/ +├─ app/ # デスクトップ アプリ(Slint UI と連携コード) +│ ├─ src/ # トレイ、ショートカット、オーバーレイ、プレビュー、設定、更新… +│ ├─ ui/ # .slint のウィンドウ、ウィジェット、アイコン +│ └─ translations/ # 9 言語の .po ファイル +├─ crates/ +│ ├─ qrtool-core/ # 内容の解析、リンクの安全性、設定、履歴(純粋な Rust) +│ ├─ qrtool-decode/ # zxing-cpp のデコード方法と QR コード生成 +│ ├─ qrtool-capture/ # 複数モニターのスクリーンショット(xcap) +│ ├─ qrtool-camera/ # Web カメラの取り込みとリアルタイム デコード(nokhwa) +│ └─ qrtool-platform/ # OS 連携:開く、自動起動、テーマ、Wi-Fi、IPC、クリップボード、右クリック メニュー +├─ assets/icons/ # アプリとトレイのアイコン +├─ packaging/ # MSIX、Linux のデスクトップ エントリ、macOS バンドル情報 +├─ docs/ # アーキテクチャ、ビルド、FAQ、プライバシー、翻訳 +│ └─ manual/ # ユーザーマニュアル(PDF + Word、10 言語)とビルド スクリプト +└─ .github/workflows/ # CI とリリースの流れ +``` + + + +## 貢献 + +バグ報告、翻訳、コード、アイデアなど、どんな貢献も歓迎します。 + +- まずは **[CONTRIBUTING.md](../../CONTRIBUTING.md)** をお読みください。 +- 翻訳の改善:**[docs/TRANSLATING.md](../TRANSLATING.md)**(現在の翻訳は機械翻訳を見直したものです。ネイティブ スピーカーの協力を大歓迎します)。 +- セキュリティ上の問題を見つけた場合は、公開の issue ではなく **[SECURITY.md](../../SECURITY.md)** の手順に従ってください。 +- 参加するすべての方に **[行動規範](../../CODE_OF_CONDUCT.md)** を守っていただくようお願いしています。 + +QRcode tool が時間の節約に役立ったら、[プロジェクトを支援](https://github.com/sponsors/naritaroad)していただけるとうれしいです。❤️ + +## ライセンス + +次のいずれかのライセンスを選んで利用できます。 + +- Apache License, Version 2.0([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license([LICENSE-MIT](../../LICENSE-MIT)) + +特に明記しない限り、このプロジェクトに取り込むために提出された貢献は、追加の条件なしに上記のデュアル ライセンスで提供されるものとします。 + +サードパーティのコンポーネントとそのライセンスは [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md) に記載しています。UI は [Slint](https://slint.dev) で構築しており、Slint Royalty-free Desktop License に従います。 + +### 関連プロジェクト + +QRcode tool は次のプロジェクトから着想を得ています。コードは一切コピーしていません。デスクトップでの QR スキャンの可能性を示してくれたことに感謝します。 + +- [qrpeek](https://github.com/dzoffice/qrpeek) — 画面上の QR コード認識ツール +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — 画面上の QR コード スキャナー +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — Snipping Tool と ZXing.Net を使ったリーダー +- [NormCap](https://github.com/dynobo/normcap) — OCR を使った画面キャプチャ +- [ShareX](https://github.com/ShareX/ShareX) — QR コード ツールを含む画面キャプチャ スイート +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — 無料のデスクトップ リーダー + +[zxing-cpp](https://github.com/zxing-cpp/zxing-cpp)、[Slint](https://github.com/slint-ui/slint)、[xcap](https://github.com/nashaofu/xcap)、[nokhwa](https://github.com/l1npengtul/nokhwa)、[global-hotkey](https://github.com/tauri-apps/global-hotkey)、[Velopack](https://github.com/velopack/velopack)、[qrcode](https://github.com/kennytm/qrcode-rust) の成果の上に作られています。 + +--- + +QR コードは株式会社デンソーウェーブ(DENSO WAVE INCORPORATED)の登録商標です。QRcode tool は DENSO WAVE、Google、Microsoft とは関係ありません。 diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md new file mode 100644 index 0000000..f1dbad2 --- /dev/null +++ b/docs/i18n/README.ko.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · **한국어** · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +바로 가기 키를 누르면 → 화면의 모든 QR 코드에 레이블이 붙고 → Enter를 누르면 끝. + +웹캠으로도 쓸 수 있습니다. 무료, 오픈 소스, 개인정보 보호. + +📘 **사용 설명서:** [PDF](../manual/QRcode-tool-User-Manual-ko.pdf) · [Word](../manual/QRcode-tool-User-Manual-ko.docx) + +![화면 스캔: 모든 코드에 사이트 이름이 적힌 레이블이 붙음](../assets/screen-scan.png) + +--- + + + +## 기능 + + +| | | +| ------------------------ | ------------------------------------------------------------------------------------------------------------------ | +| ⚡ **간편한 사용** | Ctrl+Alt+Q를 누르거나 트레이 아이콘을 클릭하면 화면이 멈추고, 빠른 스캔 애니메이션이 모든 코드를 자동으로 찾습니다. | +| 🏷️ **링크 레이블** | 코드마다 실제 사이트 이름을 보여 줍니다. Enter로 열고, Tab으로 다음 코드로 가고, C로 복사합니다. | +| ✂️ **영역 선택** | 코드가 아주 작거나 흐리거나 기울어져 있으면 캡처 도구처럼 사각형으로 둘러싸세요. | +| 📷 **웹캠** | 인쇄된 코드나 휴대폰 화면을 카메라에 비추면 결과가 실시간으로 나타납니다. | +| 🛡️ **링크 안전 검사** | 링크를 갑자기 열지 않습니다. 비슷한 글자, 위장된 주소(`bank.com@evil.io`), IP 주소, 암호화되지 않은 `http`, 단축 링크 등을 경고하며 모두 오프라인으로 검사합니다. | +| 📶 **내용 이해** | Wi-Fi(클릭 한 번으로 연결), 연락처(vCard로 저장), 이메일, 전화, 문자, 지도 위치, 2단계 인증 키, 대만 전자 영수증(두 코드를 합침), 텍스트. | +| 🧾 **바코드** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **이미지와 클립보드** | 복사한 스크린샷이나 이미지 파일을 스캔합니다. | +| 🔳 **간단한 QR 생성기** | 링크나 텍스트를 QR 코드로 바꿔 복사하거나 PNG/SVG로 저장합니다. | +| 🧰 **도구 모음과 버블** | 깔끔한 플로팅 도구 모음. 위쪽에 한 줄로, 또는 오른쪽·왼쪽 가장자리에 세로로 둘 수 있고, 버블로 접을 수 있으며, 전체 화면 앱에서는 자동으로 숨겨집니다. | +| 🎨 **네이티브 모양** | Windows 스타일로, 밝은/어두운 모드와 강조색을 따릅니다. | +| 🌍 **10개 언어** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **개인정보 보호** | 모든 것이 사용자의 컴퓨터에서 실행됩니다. 계정, 원격 분석, 온라인 링크 조회가 없습니다. 기록은 기본적으로 꺼져 있습니다. | +| ☁️ **가볍고 빠름** | 네이티브 Rust 코어로 성능은 높이고 메모리 사용은 줄였습니다. | + + + + +## 미리 보기 + + +| | | +| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | +| ![짧은 http 링크는 열기 전에 표시됨](../assets/link-warning.png) 의심스러운 링크는 이유를 보여 주고 기다립니다. | ![연결 단추가 있는 Wi-Fi 코드](../assets/wifi-details.png) Wi-Fi 코드는 클릭 한 번으로 연결되고, 암호는 가려집니다. | +| ![클립보드의 그림 스캔](../assets/image-scan.png) 클립보드나 이미지 파일을 스캔합니다. | ![QR 코드 만들기](../assets/create-qr.png) QR 코드를 만듭니다. | +| ![설정](../assets/settings.png) Windows 11 스타일의 설정. | ![어두운 모드](../assets/link-warning-dark.png) 어두운 모드와 강조색을 따릅니다. | + + + + +## 아키텍처 + +```mermaid +flowchart LR + subgraph 실행 방법 + HK[전역 바로 가기 키] --> D + TR[트레이 아이콘 / 메뉴] --> D + TB[도구 모음 / 버블] --> D + CLI["qrcode-tool scan-screen
(IPC, 예: Wayland)"] --> D + end + D{{디스패처}} --> CAP[모든 모니터 캡처
xcap] + D --> CAM[웹캠
nokhwa] + D --> IMG[이미지 / 클립보드] + CAP --> OV[멈춘 전체 화면 오버레이
모니터마다] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[디코딩
zxing-cpp + 확대 + 타일] --> CLS[내용 분류
URL · Wi-Fi · vCard · 전자 영수증…] + CLS --> SAFE[링크 안전 분석
오프라인] + SAFE --> UI[레이블과 자세한 정보 카드
Slint] + UI -->|Enter / 클릭| ACT[브라우저에서 열기 · Wi-Fi 연결 · 연락처 저장 · 복사] +``` + + + +앱은 Cargo 워크스페이스입니다. 작고 테스트하기 쉬운 라이브러리 위에 얇은 UI 크레이트가 올라가 있습니다. +스레드, 데이터 흐름, 설계 결정은 **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)**(영어)를 참고하세요. + +**기술 세부 사항** + +#### 디코딩 방식 + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp)가 모니터마다 멈춘 스크린샷을 병렬로 읽습니다. +- 작은 화면은 2배로 확대해서 한 번 더 읽고, 큰 화면은 서로 겹치는 900px 타일로도 나누어 읽으므로 4K 모니터의 작은 코드도 찾아냅니다. +- 영역 선택에서는 여백을 더하고 잘라 낸 부분을 2~3배 확대합니다. +- 웹캠은 별도 스레드에서 최신 프레임을 디코딩하며, 코드가 연속된 세 프레임에서 보여야 결과로 인정합니다. + + + +#### DPI와 여러 모니터 + +- 화면을 먼저 캡처하고, 각 오버레이는 그 멈춘 그림을 보여 줍니다. 모든 좌표는 스크린샷 픽셀 그대로 두고 UI 안에서 크기를 조정하므로, DPI가 섞인 환경에서도 변환 오류 없이 작동합니다. + + + +#### 링크 안전 규칙 + +- `http`/`https` 링크만 열 수 있으며, 다른 스킴은 표시만 하고 복사만 할 수 있습니다. +- 셸에는 아무것도 넘기지 않습니다. 링크는 시스템 브라우저 API로 엽니다. +- 경고 항목: 암호화되지 않은 `http`, 사용자 정보 위장(`a.com@b.com`), 국제화 도메인(punycode 표시), 한 레이블 안의 여러 문자 체계, IP 주소, 비정상적인 포트, 단축 링크, 아주 길거나 인코딩이 많은 URL, 깊은 하위 도메인 체인. +- 찾은 코드가 *하나뿐*이고, 경고가 *전혀 없고*, 사이트가 *신뢰 목록*에 있을 때가 아니면 링크를 자동으로 열지 않습니다. +- 단축 링크는 온라인으로 풀지 **않습니다**(그러면 단축 서비스가 무엇을 스캔했는지 알게 됩니다). + + + +#### 플랫폼별 참고 + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ----------------- | --------------------- | ------------------ | ------------------ | --------------------------------------------- | +| 화면 스캔 | ✅ | ✅(화면 기록 권한 필요) | ✅ | ⚠️ portal / 컴포지터를 통해 | +| 전역 바로 가기 키 | ✅ | ✅ | ✅ | ➖ 시스템 설정에서 `qrcode-tool scan-screen` 연결 | +| 전체 화면 앱 사용 중 숨기기 | ✅ | ➖ | ➖ | ➖ | +| 업데이트 | 앱 내(Velopack) | 앱 내 | 앱 내(AppImage) | 앱 내(AppImage) | + + + + +#### 민감한 데이터 + +- 2단계 인증 비밀 값과 Wi-Fi 암호는 기록에 쓰이지 않고 자동으로 복사되지도 않습니다. +- 로그에는 이벤트와 오류만 남으며, 스캔한 내용은 남지 않습니다. + + + +## 설치 + + + +### Windows 10(21H2 이상) / 11 — x64 및 ARM64 + +1. [최신 릴리스](https://github.com/naritaroad/qrcode-tool/releases/latest)에서 `QRcodeTool-win-x64-Setup.exe`(또는 `…-arm64-…`)를 다운로드합니다. +2. 실행합니다. QRcode tool은 현재 사용자에게만 설치되며(관리자 권한 불필요) 트레이에서 시작됩니다. +3. Ctrl+Alt+Q를 눌러 스캔합니다(다른 앱이 이미 쓰고 있으면 *설정 › 바로 가기 키*에서 바꾸세요). 바탕 화면이나 그림을 마우스 오른쪽 단추로 클릭해도 같은 기능을 쓸 수 있습니다(*설정 › 일반 › 오른쪽 클릭 메뉴*). Windows 11에서는 **더 많은 옵션 표시**를 여세요. + +> **“Windows의 PC 보호”가 나타나나요?** 초기 릴리스는 아직 코드 서명이 되어 있지 않아 SmartScreen이 알 수 없는 게시자라고 경고할 수 있습니다. **추가 정보 → 실행**을 클릭하세요. 릴리스마다 공개되는 SHA-256 체크섬으로 다운로드를 검증할 수 있습니다. [FAQ](../FAQ.md#windows-smartscreen)(영어)를 참고하세요. + +**휴대용** `.zip`도 있습니다(설치 프로그램과 자동 업데이트 없음). + +### macOS 13 이상(Apple 실리콘 및 Intel) + +[최신 릴리스](https://github.com/naritaroad/qrcode-tool/releases/latest)에서 `.pkg`를 다운로드합니다. 처음 스캔할 때 *시스템 설정 › 개인정보 보호 및 보안*에서 **화면 기록**(웹캠 스캔에는 **카메라**도)을 허용하세요. 릴리스가 아직 공증되지 않았으므로 처음에는 앱을 마우스 오른쪽 단추로 클릭하고 **열기**를 선택하세요. + +### Linux + +`.AppImage`를 다운로드해 실행 권한을 주고 실행합니다. Wayland에서는 데스크톱 설정에 `qrcode-tool scan-screen`을 실행하는 키보드 바로 가기를 추가하세요. + +### 소스에서 빌드 + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Rust 1.85 이상, CMake, C++ 컴파일러(zxing-cpp용)가 필요합니다. 플랫폼별 자세한 내용은 **[docs/BUILDING.md](../BUILDING.md)**(영어)를 참고하세요. + +### 명령줄 + +```text +qrcode-tool 시작(이미 실행 중이면 도구 모음 표시) +qrcode-tool scan-screen 화면 스캔 +qrcode-tool scan-region 화면을 멈추고 사각형 그리기 +qrcode-tool scan-camera 웹캠으로 스캔 +qrcode-tool scan-clipboard 클립보드의 그림 스캔 +qrcode-tool scan-file 파일 이미지 파일 하나 스캔 +qrcode-tool show-toolbar 플로팅 도구 모음 표시 +qrcode-tool generate "텍스트" QR 코드 만들기 +qrcode-tool decode 파일… [--json] UI 없이 이미지 디코딩 +``` + + + +## 프로젝트 구조 + +```text +qrcode-tool/ +├─ app/ # 데스크톱 앱(Slint UI + 연결 코드) +│ ├─ src/ # 트레이, 바로 가기 키, 오버레이, 미리 보기, 설정, 업데이트… +│ ├─ ui/ # .slint 창, 위젯, 아이콘 +│ └─ translations/ # 9개 언어의 .po 파일 +├─ crates/ +│ ├─ qrtool-core/ # 내용 해석, 링크 안전, 설정, 기록(순수 Rust) +│ ├─ qrtool-decode/ # zxing-cpp 디코딩 방식 + QR 생성 +│ ├─ qrtool-capture/ # 여러 모니터 스크린샷(xcap) +│ ├─ qrtool-camera/ # 웹캠 캡처 + 실시간 디코딩(nokhwa) +│ └─ qrtool-platform/ # OS 통합: 열기, 자동 시작, 테마, Wi-Fi, IPC, 클립보드, 오른쪽 클릭 메뉴 +├─ assets/icons/ # 앱 및 트레이 아이콘 +├─ packaging/ # MSIX, Linux 데스크톱 항목, macOS 번들 정보 +├─ docs/ # 아키텍처, 빌드, FAQ, 개인정보, 번역 +│ └─ manual/ # 사용 설명서(PDF + Word, 10개 언어)와 빌드 스크립트 +└─ .github/workflows/ # CI 및 릴리스 파이프라인 +``` + + + +## 기여하기 + +버그 신고, 번역, 코드, 아이디어 등 모든 기여를 환영합니다. + +- 먼저 [**CONTRIBUTING.md**](../../CONTRIBUTING.md)를 읽어 주세요. +- 번역 개선: **[docs/TRANSLATING.md](../TRANSLATING.md)**(현재 번역은 기계 번역을 검토한 것이며, 원어민의 도움을 크게 환영합니다). +- 보안 문제를 발견했다면 공개 issue 대신 [**SECURITY.md**](../../SECURITY.md)의 절차를 따라 주세요. +- 모든 참여자는 [**행동 강령**](../../CODE_OF_CONDUCT.md)을 지켜야 합니다. + +QRcode tool이 시간을 아껴 주었다면 [프로젝트를 후원](https://github.com/sponsors/naritaroad)해 주세요. ❤️ + +## 라이선스 + +다음 라이선스 중 하나를 선택해 사용할 수 있습니다. + +- Apache License, Version 2.0([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license([LICENSE-MIT](../../LICENSE-MIT)) + +명시적으로 달리 밝히지 않는 한, 이 프로젝트에 포함하도록 제출한 모든 기여는 추가 조건 없이 위의 이중 라이선스로 제공됩니다. + +서드파티 구성 요소와 라이선스는 [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md)에 나와 있습니다. UI는 [Slint](https://slint.dev)로 만들었으며 Slint Royalty-free Desktop License를 따릅니다. + +### 관련 프로젝트 + +QRcode tool은 다음 프로젝트에서 영감을 받았습니다. 코드는 복사하지 않았습니다. 데스크톱 QR 스캔이 어떤 모습일 수 있는지 보여 주어 고맙습니다. + +- [qrpeek](https://github.com/dzoffice/qrpeek) — 화면 QR 코드 인식 도구 +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — 화면 QR 코드 스캐너 +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — 캡처 도구와 ZXing.Net 기반 리더 +- [NormCap](https://github.com/dynobo/normcap) — OCR 기반 화면 캡처 +- [ShareX](https://github.com/ShareX/ShareX) — QR 코드 도구가 포함된 화면 캡처 도구 모음 +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — 무료 데스크톱 리더 + +[zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack), [qrcode](https://github.com/kennytm/qrcode-rust) 위에 만들어졌습니다. + +--- + +QR Code는 DENSO WAVE INCORPORATED의 등록 상표입니다. QRcode tool은 DENSO WAVE, Google, Microsoft와 관련이 없습니다. diff --git a/docs/i18n/README.pt-BR.md b/docs/i18n/README.pt-BR.md new file mode 100644 index 0000000..060732d --- /dev/null +++ b/docs/i18n/README.pt-BR.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · **Português (Brasil)** · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +Pressione um atalho → cada código QR na tela ganha uma etiqueta → pressione Enter. + +Funciona também com a webcam. Gratuito, de código aberto e privado. + +📘 **Manual do usuário:** [PDF](../manual/QRcode-tool-User-Manual-pt-BR.pdf) · [Word](../manual/QRcode-tool-User-Manual-pt-BR.docx) + +![Leitura da tela: cada código ganha uma etiqueta com o nome do site](../assets/screen-scan.png) + +--- + + + +## Recursos + + +| | | +| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ⚡ **Fácil de usar** | Pressione Ctrl+Alt+Q, ou clique no ícone da bandeja, para congelar a tela. Uma varredura rápida encontra todos os códigos automaticamente. | +| 🏷️ **Etiquetas de link** | Cada código mostra o nome real do site. Enter abre, Tab passa para o próximo e C copia. | +| ✂️ **Selecionar uma área** | Quando um código é minúsculo, borrado ou inclinado, arraste um retângulo em volta dele, como na Ferramenta de Captura. | +| 📷 **Webcam** | Mostre à câmera um código impresso ou a tela de um celular; os resultados aparecem ao vivo. | +| 🛡️ **Segurança de links** | Nunca abre um link de surpresa. Avisa sobre letras parecidas, endereços disfarçados (`bank.com@evil.io`), endereços IP, `http` sem criptografia, links encurtados e mais — tudo off-line. | +| 📶 **Entende o conteúdo** | Wi-Fi (conexão com um clique), contatos (salvos como vCard), email, telefone, SMS, locais no mapa, chaves de verificação em duas etapas, notas fiscais eletrônicas de Taiwan (os dois códigos são unidos) e texto. | +| 🧾 **Códigos de barras** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **Imagens e área de transferência** | Escaneie uma captura de tela copiada ou qualquer arquivo de imagem. | +| 🔳 **Gerador de QR simples** | Transforme um link ou texto em código QR; copie ou salve como PNG/SVG. | +| 🧰 **Barra e bolha** | Uma barra flutuante limpa — uma linha no topo ou uma coluna na borda direita ou esquerda — que se recolhe em uma bolha e se esconde sozinha em aplicativos de tela inteira. | +| 🎨 **Visual nativo** | Estilo do Windows; segue o modo claro/escuro e a sua cor de destaque. | +| 🌍 **10 idiomas** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **Privado** | Tudo roda no seu computador. Sem conta, sem telemetria, sem verificação de links on-line. O histórico vem desativado. | +| ☁️ **Leve e rápido** | Um núcleo nativo em Rust, com mais desempenho e menos uso de memória. | + + + + +## Demonstração + + +| | | +| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| ![Um link http curto é sinalizado antes de abrir](../assets/link-warning.png) Links suspeitos mostram o motivo — e esperam por você. | ![Código Wi-Fi com botão de conexão](../assets/wifi-details.png) Códigos Wi-Fi conectam com um clique; a senha fica oculta. | +| ![Escaneando uma imagem da área de transferência](../assets/image-scan.png) Escaneie a área de transferência ou um arquivo de imagem. | ![Criar um código QR](../assets/create-qr.png) Crie um código QR. | +| ![Configurações](../assets/settings.png) Configurações no estilo do Windows 11. | ![Modo escuro](../assets/link-warning-dark.png) Segue o modo escuro e a sua cor de destaque. | + + + + +## Arquitetura + +```mermaid +flowchart LR + subgraph Acionadores + HK[Atalho global] --> D + TR[Ícone / menu da bandeja] --> D + TB[Barra / bolha] --> D + CLI["qrcode-tool scan-screen
(IPC, por ex. Wayland)"] --> D + end + D{{Despachante}} --> CAP[Captura de todos os monitores
xcap] + D --> CAM[Webcam
nokhwa] + D --> IMG[Imagem / área de transferência] + CAP --> OV[Sobreposição congelada em tela inteira
por monitor] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[Decodificação
zxing-cpp + ampliação + blocos] --> CLS[Classificar conteúdo
URL · Wi-Fi · vCard · nota fiscal eletrônica…] + CLS --> SAFE[Análise de segurança do link
off-line] + SAFE --> UI[Etiquetas e cartão de detalhes
Slint] + UI -->|Enter / clique| ACT[Abrir no navegador · Conectar Wi-Fi · Salvar contato · Copiar] +``` + + + +O aplicativo é um workspace do Cargo: um crate de interface fino sobre bibliotecas pequenas e fáceis de testar. +Veja **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)** (em inglês) para threads, fluxo de dados e decisões de design. + +**Detalhes técnicos** + +#### Estratégia de decodificação + +- O [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) lê em paralelo a captura congelada de cada monitor. +- Telas pequenas também são lidas em escala 2×; telas grandes são divididas ainda em blocos sobrepostos de 900 px, então um código pequeno em um monitor 4K continua sendo encontrado. +- A seleção de área adiciona uma margem em branco e amplia o recorte de 2 a 3 vezes. +- A webcam decodifica o quadro mais recente em sua própria thread, e um código precisa aparecer em três quadros seguidos para valer. + + + +#### DPI e vários monitores + +- A tela é capturada primeiro e cada sobreposição mostra essa imagem congelada. Todas as coordenadas ficam em pixels da captura e são escaladas dentro da interface, então configurações com DPI misto funcionam sem erros de conversão. + + + +#### Regras de segurança de links + +- Só links `http`/`https` podem ser abertos; qualquer outro esquema é exibido e só pode ser copiado. +- Nada é passado a um shell. Os links abrem pela API de navegador do sistema. +- Avisos: `http` sem criptografia, disfarce com informações de usuário (`a.com@b.com`), domínios internacionais (mostra o punycode), alfabetos misturados em um mesmo rótulo, endereços IP, portas incomuns, links encurtados, URLs muito longas ou muito codificadas e cadeias profundas de subdomínios. +- Links nunca abrem automaticamente, a não ser que sejam o *único* código encontrado, não tenham *nenhum* aviso e o site esteja na sua *lista de confiáveis*. +- Links encurtados **não** são expandidos on-line (isso diria ao encurtador o que você escaneou). + + + +#### Observações por plataforma + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ------------------------------------ | --------------------- | -------------------------------------- | ----------------- | --------------------------------------------------------------- | +| Leitura da tela | ✅ | ✅ (permissão de Gravação de Tela) | ✅ | ⚠️ via portal / compositor | +| Atalho global | ✅ | ✅ | ✅ | ➖ associe `qrcode-tool scan-screen` nas configurações do sistema | +| Ocultar em apps de tela inteira | ✅ | ➖ | ➖ | ➖ | +| Atualizações | no app (Velopack) | no app | no app (AppImage) | no app (AppImage) | + + + + +#### Dados sensíveis + +- Segredos de verificação em duas etapas e senhas de Wi-Fi nunca são gravados no histórico nem copiados automaticamente. +- Os logs contêm só eventos e erros, nunca conteúdo escaneado. + + + +## Instalação + + + +### Windows 10 (21H2+) / 11 — x64 e ARM64 + +1. Baixe `QRcodeTool-win-x64-Setup.exe` (ou `…-arm64-…`) da [versão mais recente](https://github.com/naritaroad/qrcode-tool/releases/latest). +2. Execute. O QRcode tool é instalado só para o seu usuário (sem direitos de administrador) e inicia na bandeja. +3. Pressione Ctrl+Alt+Q para escanear (altere em *Configurações › Atalhos* se outro aplicativo já usar essa combinação). Clique com o botão direito na área de trabalho ou em uma imagem para usar as mesmas ferramentas (*Configurações › Geral › Menu do botão direito*). No Windows 11, abra **Mostrar mais opções**. + +> **“O Windows protegeu o computador”?** As primeiras versões ainda não têm assinatura de código, então o SmartScreen pode avisar sobre um editor desconhecido. Clique em **Mais informações → Executar assim mesmo**. Você pode conferir o download com as somas SHA-256 publicadas em cada versão. Veja as [perguntas frequentes](../FAQ.md#windows-smartscreen) (em inglês). + +Também há um `.zip` **portátil** (sem instalador e sem atualizações automáticas). + +### macOS 13+ (Apple silicon e Intel) + +Baixe o `.pkg` da [versão mais recente](https://github.com/naritaroad/qrcode-tool/releases/latest). Na primeira leitura, permita **Gravação de Tela** (e **Câmera** para usar a webcam) em *Ajustes do Sistema › Privacidade e Segurança*. As versões ainda não são autenticadas: na primeira vez, clique com o botão direito no app e escolha **Abrir**. + +### Linux + +Baixe o `.AppImage`, torne-o executável e execute. No Wayland, adicione nas configurações da área de trabalho um atalho de teclado que execute `qrcode-tool scan-screen`. + +### Compilar a partir do código-fonte + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Você precisa de Rust 1.85+, CMake e um compilador C++ (para o zxing-cpp). Detalhes de cada plataforma: **[docs/BUILDING.md](../BUILDING.md)** (em inglês). + +### Linha de comando + +```text +qrcode-tool iniciar (ou mostrar a barra se já estiver em execução) +qrcode-tool scan-screen escanear a tela +qrcode-tool scan-region congelar a tela e arrastar um retângulo +qrcode-tool scan-camera escanear com a webcam +qrcode-tool scan-clipboard escanear a imagem da área de transferência +qrcode-tool scan-file ARQUIVO escanear um arquivo de imagem +qrcode-tool show-toolbar mostrar a barra de ferramentas flutuante +qrcode-tool generate "TEXTO" criar um código QR +qrcode-tool decode ARQUIVO… [--json] decodificar imagens sem a interface +``` + + + +## Estrutura do projeto + +```text +qrcode-tool/ +├─ app/ # O aplicativo de desktop (interface Slint + código de ligação) +│ ├─ src/ # bandeja, atalhos, sobreposição, visualização, configurações, atualizador… +│ ├─ ui/ # janelas .slint, widgets, ícones +│ └─ translations/ # arquivos .po de 9 idiomas +├─ crates/ +│ ├─ qrtool-core/ # Análise de conteúdo, segurança de links, configurações, histórico (Rust puro) +│ ├─ qrtool-decode/ # Estratégia de decodificação com zxing-cpp + geração de QR +│ ├─ qrtool-capture/ # Capturas de vários monitores (xcap) +│ ├─ qrtool-camera/ # Captura da webcam + decodificação ao vivo (nokhwa) +│ └─ qrtool-platform/ # Integração com o sistema: abrir, inicialização, tema, Wi-Fi, IPC, área de transferência, menu de contexto +├─ assets/icons/ # Ícones do aplicativo e da bandeja +├─ packaging/ # MSIX, entrada de desktop do Linux, informações do pacote macOS +├─ docs/ # Arquitetura, compilação, perguntas frequentes, privacidade, traduções +│ └─ manual/ # Manual do usuário (PDF + Word, 10 idiomas) e scripts de geração +└─ .github/workflows/ # CI e pipeline de publicação +``` + + + +## Contribuir + +Contribuições são bem-vindas — relatos de bugs, traduções, código e ideias. + +- Leia **[CONTRIBUTING.md](../../CONTRIBUTING.md)** para começar. +- Melhore uma tradução: **[docs/TRANSLATING.md](../TRANSLATING.md)** (as traduções atuais são traduções automáticas revisadas; falantes nativos são muito bem-vindos). +- Encontrou um problema de segurança? Siga o **[SECURITY.md](../../SECURITY.md)** em vez de abrir uma issue pública. +- Todas as pessoas participantes devem seguir o **[Código de Conduta](../../CODE_OF_CONDUCT.md)**. + +Se o QRcode tool economiza seu tempo, você pode [patrocinar o projeto](https://github.com/sponsors/naritaroad). ❤️ + +## Licença + +Licenciado, à sua escolha, sob uma destas licenças: + +- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license ([LICENSE-MIT](../../LICENSE-MIT)) + +Salvo declaração expressa em contrário, qualquer contribuição enviada para inclusão neste projeto terá o licenciamento duplo acima, sem termos ou condições adicionais. + +Os componentes de terceiros e suas licenças estão listados em [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md). A interface é feita com [Slint](https://slint.dev) sob a Slint Royalty-free Desktop License. + +### Projetos relacionados + +O QRcode tool foi inspirado por estes projetos. Nenhum código foi copiado deles; obrigado por mostrarem o que a leitura de QR no desktop pode ser: + +- [qrpeek](https://github.com/dzoffice/qrpeek) — ferramenta de reconhecimento de códigos QR na tela +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — leitor de códigos QR na tela +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — leitor baseado na Ferramenta de Captura e no ZXing.Net +- [NormCap](https://github.com/dynobo/normcap) — captura de tela com OCR +- [ShareX](https://github.com/ShareX/ShareX) — suíte de captura de tela com ferramenta de QR code +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — leitor de desktop gratuito + +Construído sobre [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack) e [qrcode](https://github.com/kennytm/qrcode-rust). + +--- + +QR Code é uma marca registrada da DENSO WAVE INCORPORATED. O QRcode tool não é afiliado à DENSO WAVE, ao Google nem à Microsoft. diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md new file mode 100644 index 0000000..c6df68b --- /dev/null +++ b/docs/i18n/README.ru.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — Scan QR codes on your computer as easily as on your phone.](../assets/banner.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · **Русский** · + +Нажмите сочетание клавиш → каждый QR-код на экране получит метку → нажмите Enter. + +Работает и с веб-камерой. Бесплатно, с открытым исходным кодом и без слежки. + +📘 **Руководство пользователя:** [PDF](../manual/QRcode-tool-User-Manual-ru.pdf) · [Word](../manual/QRcode-tool-User-Manual-ru.docx) + +![Сканирование экрана: каждый код получает метку с именем сайта](../assets/screen-scan.png) + +--- + + + +## Возможности + + +| | | +| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ⚡ **Просто пользоваться** | Нажмите Ctrl+Alt+Q или щёлкните значок в области уведомлений, чтобы заморозить экран. Быстрая анимация сканирования автоматически находит все коды. | +| 🏷️ **Метки ссылок** | На каждом коде показано настоящее имя сайта. Enter открывает, Tab переходит к следующему, C копирует. | +| ✂️ **Выделить область** | Если код крошечный, размытый или наклонённый, обведите его рамкой, как в «Ножницах». | +| 📷 **Веб-камера** | Поднесите к камере напечатанный код или экран телефона — результаты появляются сразу. | +| 🛡️ **Безопасность ссылок** | Никогда не открывает ссылку неожиданно. Предупреждает о похожих буквах, замаскированных адресах (`bank.com@evil.io`), IP-адресах, `http` без шифрования, коротких ссылках и многом другом — всё без подключения к сети. | +| 📶 **Понимает содержимое** | Wi-Fi (подключение одним щелчком), контакты (сохраняются как vCard), почта, телефон, SMS, места на карте, ключи двухэтапной проверки, тайваньские электронные чеки (два кода объединяются) и текст. | +| 🧾 **Штрихкоды** | EAN, UPC, Code 128, Data Matrix, PDF417, Aztec… | +| 🖼️ **Изображения и буфер обмена** | Сканируйте скопированный снимок экрана или любой файл изображения. | +| 🔳 **Простой генератор QR** | Превратите ссылку или текст в QR-код; скопируйте его или сохраните в PNG/SVG. | +| 🧰 **Панель и кнопка** | Аккуратная плавающая панель — строкой вверху или колонкой у правого либо левого края, — которая сворачивается в кнопку и сама прячется при полноэкранных приложениях. | +| 🎨 **Родной вид** | Стиль Windows, следует светлому/тёмному режиму и вашему цвету акцента. | +| 🌍 **10 языков** | English, 繁體中文, 简体中文, Español, Português (Brasil), 日本語, 한국어, Français, Deutsch, Русский. | +| 🔒 **Конфиденциально** | Всё работает на вашем компьютере. Без учётной записи, без телеметрии, без онлайн-проверки ссылок. Журнал по умолчанию выключен. | +| ☁️ **Лёгкий и быстрый** | Нативное ядро на Rust: выше производительность и меньше расход памяти. | + + + + +## Демонстрация + + +| | | +| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| ![Короткая ссылка http помечается перед открытием](../assets/link-warning.png) Подозрительные ссылки объясняют причину — и ждут вас. | ![Код Wi-Fi с кнопкой подключения](../assets/wifi-details.png) Коды Wi-Fi подключаются одним щелчком; пароль остаётся скрытым. | +| ![Сканирование изображения из буфера обмена](../assets/image-scan.png) Сканируйте буфер обмена или файл изображения. | ![Создание QR-кода](../assets/create-qr.png) Создайте QR-код. | +| ![Параметры](../assets/settings.png) Параметры в стиле Windows 11. | ![Тёмный режим](../assets/link-warning-dark.png) Следует тёмному режиму и вашему цвету акцента. | + + + + +## Архитектура + +```mermaid +flowchart LR + subgraph Запуск + HK[Глобальное сочетание клавиш] --> D + TR[Значок / меню в области уведомлений] --> D + TB[Панель / кнопка] --> D + CLI["qrcode-tool scan-screen
(IPC, например Wayland)"] --> D + end + D{{Диспетчер}} --> CAP[Снимок всех мониторов
xcap] + D --> CAM[Веб-камера
nokhwa] + D --> IMG[Изображение / буфер обмена] + CAP --> OV[Замороженный полноэкранный слой
для каждого монитора] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[Декодирование
zxing-cpp + увеличение + плитки] --> CLS[Определение содержимого
URL · Wi-Fi · vCard · электронный чек…] + CLS --> SAFE[Анализ безопасности ссылки
без сети] + SAFE --> UI[Метки и карточка с подробностями
Slint] + UI -->|Enter / щелчок| ACT[Открыть в браузере · Подключить Wi-Fi · Сохранить контакт · Копировать] +``` + + + +Приложение — это рабочая область Cargo: тонкий крейт интерфейса поверх небольших, легко тестируемых библиотек. +О потоках, движении данных и проектных решениях рассказано в **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)** (на английском). + +**Технические подробности** + +#### Стратегия декодирования + +- [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) параллельно считывает замороженный снимок каждого монитора. +- Маленькие экраны дополнительно читаются с увеличением в 2 раза; большие ещё и делятся на перекрывающиеся плитки по 900 px, поэтому даже мелкий код на мониторе 4K находится. +- При выделении области добавляется пустое поле, а фрагмент увеличивается в 2–3 раза. +- Веб-камера декодирует самый свежий кадр в отдельном потоке, и код засчитывается, только если его видно в трёх кадрах подряд. + + + +#### DPI и несколько мониторов + +- Сначала делается снимок экрана, и каждый слой показывает это замороженное изображение. Все координаты остаются в пикселях снимка и масштабируются в интерфейсе, поэтому конфигурации со смешанным DPI работают без ошибок пересчёта. + + + +#### Правила безопасности ссылок + +- Открывать можно только ссылки `http`/`https`; любая другая схема показывается и может быть только скопирована. +- Ничего не передаётся в оболочку. Ссылки открываются через системный API браузера. +- Предупреждения: `http` без шифрования, маскировка с помощью данных пользователя (`a.com@b.com`), международные домены (показывается punycode), смешение алфавитов в одной части имени, IP-адреса, необычные порты, короткие ссылки, очень длинные или сильно закодированные URL, глубокие цепочки поддоменов. +- Ссылки никогда не открываются автоматически, если только это не *единственный* найденный код, у него *нет* предупреждений и сайт есть в вашем *списке надёжных*. +- Короткие ссылки **не** раскрываются через интернет (иначе сервис коротких ссылок узнал бы, что вы отсканировали). + + + +#### Особенности платформ + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ------------------------------------- | --------------------- | ---------------------------------------- | ------------------------ | ---------------------------------------------------------------- | +| Сканирование экрана | ✅ | ✅ (нужно разрешение «Запись экрана») | ✅ | ⚠️ через portal / композитор | +| Глобальное сочетание клавиш | ✅ | ✅ | ✅ | ➖ назначьте `qrcode-tool scan-screen` в настройках системы | +| Скрытие при полноэкранных приложениях | ✅ | ➖ | ➖ | ➖ | +| Обновления | в приложении (Velopack) | в приложении | в приложении (AppImage) | в приложении (AppImage) | + + + + +#### Конфиденциальные данные + +- Секреты двухэтапной проверки и пароли Wi-Fi никогда не записываются в журнал и не копируются автоматически. +- В журналы работы попадают только события и ошибки, никогда — отсканированное содержимое. + + + +## Установка + + + +### Windows 10 (21H2+) / 11 — x64 и ARM64 + +1. Скачайте `QRcodeTool-win-x64-Setup.exe` (или `…-arm64-…`) со страницы [последней версии](https://github.com/naritaroad/qrcode-tool/releases/latest). +2. Запустите его. QRcode tool устанавливается только для вашего пользователя (без прав администратора) и запускается в области уведомлений. +3. Нажмите Ctrl+Alt+Q, чтобы сканировать (если сочетание уже занято другим приложением, измените его в *Параметры › Сочетания клавиш*). Те же функции доступны по щелчку правой кнопкой на рабочем столе или изображении (*Параметры › Общие › Контекстное меню*). В Windows 11 откройте **Показать дополнительные параметры**. + +> **«Система Windows защитила ваш компьютер»?** Первые выпуски пока не подписаны, поэтому SmartScreen может предупредить о неизвестном издателе. Нажмите **Подробнее → Выполнить в любом случае**. Загрузку можно проверить по контрольным суммам SHA-256, которые публикуются с каждым выпуском. См. [FAQ](../FAQ.md#windows-smartscreen) (на английском). + +Есть и **переносная** версия в `.zip` (без установщика и без автоматических обновлений). + +### macOS 13+ (Apple Silicon и Intel) + +Скачайте `.pkg` со страницы [последней версии](https://github.com/naritaroad/qrcode-tool/releases/latest). При первом сканировании разрешите **Запись экрана** (и **Камера** для сканирования веб-камерой) в *Системные настройки › Конфиденциальность и безопасность*. Выпуски пока не заверены Apple — в первый раз щёлкните приложение правой кнопкой мыши и выберите **Открыть**. + +### Linux + +Скачайте `.AppImage`, сделайте его исполняемым и запустите. В Wayland добавьте в настройках рабочего стола сочетание клавиш, которое выполняет `qrcode-tool scan-screen`. + +### Сборка из исходного кода + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +Нужны Rust 1.85+, CMake и компилятор C++ (для zxing-cpp). Подробности для каждой платформы: **[docs/BUILDING.md](../BUILDING.md)** (на английском). + +### Командная строка + +```text +qrcode-tool запустить (или показать панель, если уже запущено) +qrcode-tool scan-screen сканировать экран +qrcode-tool scan-region заморозить экран и обвести рамку +qrcode-tool scan-camera сканировать веб-камерой +qrcode-tool scan-clipboard сканировать изображение из буфера обмена +qrcode-tool scan-file ФАЙЛ сканировать один файл изображения +qrcode-tool show-toolbar показать плавающую панель инструментов +qrcode-tool generate "ТЕКСТ" создать QR-код +qrcode-tool decode ФАЙЛ… [--json] декодировать изображения без интерфейса +``` + + + +## Структура проекта + +```text +qrcode-tool/ +├─ app/ # Настольное приложение (интерфейс Slint + связующий код) +│ ├─ src/ # область уведомлений, сочетания клавиш, слой, просмотр, параметры, обновление… +│ ├─ ui/ # окна .slint, виджеты, значки +│ └─ translations/ # файлы .po для 9 языков +├─ crates/ +│ ├─ qrtool-core/ # Разбор содержимого, безопасность ссылок, параметры, журнал (чистый Rust) +│ ├─ qrtool-decode/ # Стратегия декодирования zxing-cpp + создание QR +│ ├─ qrtool-capture/ # Снимки нескольких мониторов (xcap) +│ ├─ qrtool-camera/ # Захват с веб-камеры + декодирование на лету (nokhwa) +│ └─ qrtool-platform/ # Интеграция с ОС: открытие, автозапуск, тема, Wi-Fi, IPC, буфер обмена, контекстное меню +├─ assets/icons/ # Значки приложения и области уведомлений +├─ packaging/ # MSIX, ярлык рабочего стола Linux, сведения пакета macOS +├─ docs/ # Архитектура, сборка, FAQ, конфиденциальность, переводы +│ └─ manual/ # Руководство пользователя (PDF + Word, 10 языков) и скрипты его сборки +└─ .github/workflows/ # CI и конвейер выпуска +``` + + + +## Участие в проекте + +Мы рады любому вкладу — сообщениям об ошибках, переводам, коду и идеям. + +- Для начала прочитайте **[CONTRIBUTING.md](../../CONTRIBUTING.md)**. +- Улучшить перевод: **[docs/TRANSLATING.md](../TRANSLATING.md)** (текущие переводы — проверенный машинный перевод; помощь носителей языка очень приветствуется). +- Нашли проблему безопасности? Следуйте **[SECURITY.md](../../SECURITY.md)**, а не открывайте публичный issue. +- Все участники должны соблюдать **[Кодекс поведения](../../CODE_OF_CONDUCT.md)**. + +Если QRcode tool экономит вам время, вы можете [поддержать проект](https://github.com/sponsors/naritaroad). ❤️ + +## Лицензия + +Распространяется на ваш выбор по одной из лицензий: + +- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license ([LICENSE-MIT](../../LICENSE-MIT)) + +Если вы явно не укажете иное, любой вклад, который вы отправляете для включения в этот проект, распространяется по указанной двойной лицензии без каких-либо дополнительных условий. + +Сторонние компоненты и их лицензии перечислены в [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md). Интерфейс создан на [Slint](https://slint.dev) по лицензии Slint Royalty-free Desktop License. + +### Похожие проекты + +QRcode tool вдохновлён этими проектами. Код из них не копировался; спасибо им за то, что показали, каким может быть сканирование QR-кодов на компьютере: + +- [qrpeek](https://github.com/dzoffice/qrpeek) — распознавание QR-кодов на экране +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — сканер QR-кодов на экране +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — считыватель на основе «Ножниц» и ZXing.Net +- [NormCap](https://github.com/dynobo/normcap) — захват экрана с OCR +- [ShareX](https://github.com/ShareX/ShareX) — набор для снимков экрана с инструментом для QR-кодов +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — бесплатный настольный считыватель + +Построено на [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp), [Slint](https://github.com/slint-ui/slint), [xcap](https://github.com/nashaofu/xcap), [nokhwa](https://github.com/l1npengtul/nokhwa), [global-hotkey](https://github.com/tauri-apps/global-hotkey), [Velopack](https://github.com/velopack/velopack) и [qrcode](https://github.com/kennytm/qrcode-rust). + +--- + +QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. QRcode tool не связан с DENSO WAVE, Google или Microsoft. diff --git a/docs/i18n/README.zh-CN.md b/docs/i18n/README.zh-CN.md new file mode 100644 index 0000000..193f51a --- /dev/null +++ b/docs/i18n/README.zh-CN.md @@ -0,0 +1,247 @@ +# QRcode tool + +![QRcode tool — 在电脑上扫二维码,像用手机一样简单。](../assets/banner-zh-TW.jpg) + +![CI](https://github.com/naritaroad/qrcode-tool/actions/workflows/ci.yml/badge.svg) +![Release](https://img.shields.io/github/v/release/naritaroad/qrcode-tool?sort=semver&display_name=tag) +![Downloads](https://img.shields.io/github/downloads/naritaroad/qrcode-tool/total) +![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue) +![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey) +![Rust](https://img.shields.io/badge/rust-1.85%2B-orange?logo=rust) +![Made with Slint](https://img.shields.io/badge/UI-Slint-2379F4) +![Languages](https://img.shields.io/badge/languages-10-informational) +![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) + + · [English](../../README.md) · [繁體中文](README.zh-TW.md) · **简体中文** · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · + +按一下快捷键 → 屏幕上的每个二维码都会出现标签 → 按 Enter 打开。 + +也能用摄像头扫描。免费、开源、不收集任何数据。 + +📘 **用户手册:**[PDF](../manual/QRcode-tool-User-Manual-zh-CN.pdf) · [Word](../manual/QRcode-tool-User-Manual-zh-CN.docx) + +![屏幕扫描:每个码上都会出现显示网站名称的标签](../assets/screen-scan.png) + +--- + + + +## 功能特点 + + +| | | +| ------------------- | ----------------------------------------------------------------------------------------------------- | +| ⚡ **简单易用** | 按 Ctrl+Alt+Q 或单击托盘图标即可冻结屏幕,快速扫描动画会自动找出所有码。 | +| 🏷️ **链接标签** | 每个码上都显示真实的网站名称。Enter 打开,Tab 切换到下一个,C 复制。 | +| ✂️ **框选区域** | 码太小、模糊或倾斜时,像截图工具一样拖出一个方框即可。 | +| 📷 **摄像头** | 把印刷的码或手机屏幕对准摄像头,结果实时显示。 | +| 🛡️ **链接安全检查** | 绝不会突然打开链接。会提示形近字母、伪装地址(`bank.com@evil.io`)、IP 地址、未加密的 `http`、短链接等,全部离线完成。 | +| 📶 **理解内容** | Wi-Fi(一键连接)、联系人(保存为 vCard)、电子邮件、电话、短信、地图位置、两步验证密钥、台湾电子发票(左右两个码自动合并)和普通文本。 | +| 🧾 **条形码** | EAN、UPC、Code 128、Data Matrix、PDF417、Aztec… | +| 🖼️ **图片与剪贴板** | 扫描复制的截图或任意图片文件。 | +| 🔳 **简易二维码生成器** | 把链接或文本转换成二维码,可复制或保存为 PNG/SVG。 | +| 🧰 **工具栏与悬浮球** | 简洁的悬浮工具栏,可以横放在屏幕顶部,也可以竖放在屏幕右侧或左侧;能收起为悬浮球,全屏应用运行时自动隐藏。 | +| 🎨 **原生外观** | Windows 风格,跟随浅色/深色模式和系统强调色。 | +| 🌍 **10 种语言** | English、繁體中文、简体中文、Español、Português (Brasil)、日本語、한국어、Français、Deutsch、Русский。 | +| 🔒 **注重隐私** | 一切都在你的电脑上运行。无需账号,没有遥测,不会在线查询链接。扫描历史默认关闭。 | +| ☁️ **轻巧快速** | 原生 Rust 核心,性能更高,内存占用更低。 | + + + + +## 界面展示 + + +| | | +| ------------------------------------------------------------------- | --------------------------------------------------------------------- | +| ![短的 http 链接在打开前会被标记](../assets/link-warning.png) 可疑链接会说明原因,并等你确认。 | ![带连接按钮的 Wi-Fi 码](../assets/wifi-details.png) Wi-Fi 码一键连接,密码默认隐藏。 | +| ![扫描剪贴板中的图片](../assets/image-scan.png) 扫描剪贴板或图片文件。 | ![生成二维码](../assets/create-qr.png) 生成二维码。 | +| ![设置](../assets/settings.png) Windows 11 风格的设置界面。 | ![深色模式](../assets/link-warning-dark.png) 跟随深色模式和系统强调色。 | + + + + +## 架构 + +```mermaid +flowchart LR + subgraph 触发方式 + HK[全局快捷键] --> D + TR[托盘图标 / 菜单] --> D + TB[工具栏 / 悬浮球] --> D + CLI["qrcode-tool scan-screen
(IPC,例如 Wayland)"] --> D + end + D{{分发器}} --> CAP[截取所有显示器
xcap] + D --> CAM[摄像头
nokhwa] + D --> IMG[图片 / 剪贴板] + CAP --> OV[冻结的全屏覆盖层
每台显示器一个] + CAP --> DEC + CAM --> DEC + IMG --> DEC + DEC[解码
zxing-cpp + 放大 + 分块] --> CLS[判断内容类型
URL · Wi-Fi · vCard · 电子发票…] + CLS --> SAFE[链接安全分析
离线] + SAFE --> UI[标签与详细信息卡
Slint] + UI -->|Enter / 单击| ACT[在浏览器中打开 · 连接 Wi-Fi · 保存联系人 · 复制] +``` + + + +本应用是一个 Cargo 工作区:一个精简的 UI crate,建立在几个小而易测试的库之上。 +线程、数据流和设计决策请见 **[docs/ARCHITECTURE.md](../ARCHITECTURE.md)**(英文)。 + +**技术细节** + +#### 解码策略 + +- 用 [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp) 并行读取每台显示器的冻结截图。 +- 小屏幕会再以 2 倍放大读取一次;大屏幕还会切成互相重叠的 900 px 分块,因此 4K 显示器上的小码也能找到。 +- 框选区域会加上留白,并把裁剪部分放大 2–3 倍。 +- 摄像头在独立线程中解码最新一帧,同一个码要在连续 3 帧中都被读到才算数。 + + + +#### DPI 与多显示器 + +- 先截取屏幕,再让每个覆盖层显示这张冻结的画面。所有坐标都以截图像素表示,并在界面中缩放,因此混合 DPI 的环境也不会出现换算错误。 + + + +#### 链接安全规则 + +- 只能打开 `http`/`https` 链接;其他协议只显示,并且只能复制。 +- 不经过 shell,通过系统浏览器 API 打开链接。 +- 警告项目:未加密的 `http`、用户信息伪装(`a.com@b.com`)、国际化域名(显示 punycode)、同一段中混用字母表、IP 地址、不常见的端口、短链接、过长或大量编码的 URL、层级很深的子域名。 +- 只有当链接是*唯一*找到的码、*没有*任何警告、且网站在你的*受信任列表*中时,才会自动打开。 +- 短链接**不会**在线展开(那会让短链接服务知道你扫描了什么)。 + + + +#### 平台说明 + + +| | Windows 10 21H2+ / 11 | macOS 13+ | Linux X11 | Linux Wayland | +| ------------ | --------------------- | ----------- | ----------------- | ----------------------------------------- | +| 屏幕扫描 | ✅ | ✅(需要屏幕录制权限) | ✅ | ⚠️ 通过 portal / 合成器 | +| 全局快捷键 | ✅ | ✅ | ✅ | ➖ 在系统设置中绑定 `qrcode-tool scan-screen` | +| 全屏应用时隐藏 | ✅ | ➖ | ➖ | ➖ | +| 更新 | 应用内(Velopack) | 应用内 | 应用内(AppImage) | 应用内(AppImage) | + + + + +#### 敏感数据 + +- 两步验证密钥和 Wi-Fi 密码永远不会写入历史记录,也不会被自动复制。 +- 日志只记录事件和错误,从不包含扫描内容。 + + + +## 安装 + + + +### Windows 10(21H2 及以上)/ 11 — x64 与 ARM64 + +1. 从[最新版本](https://github.com/naritaroad/qrcode-tool/releases/latest)下载 `QRcodeTool-win-x64-Setup.exe`(ARM 电脑请选 `…-arm64-…`)。 +2. 运行它。QRcode tool 只安装到你的用户账户下(无需管理员权限),并在托盘中启动。 +3. 按 Ctrl+Alt+Q 开始扫描(如果已被其他应用占用,可在“设置 › 快捷键”中修改)。右键单击桌面或图片也能使用同样的功能(“设置 › 常规 › 右键菜单”)。在 Windows 11 上请先选择“显示更多选项”。 + +> **出现“Windows 已保护你的电脑”?** 早期版本尚未进行代码签名,SmartScreen 可能会提示发布者未知。请单击 **更多信息 → 仍要运行**。每个版本都附有 SHA-256 校验和,可用来核对下载的文件。详见 [FAQ](../FAQ.md#windows-smartscreen)(英文)。 + +也提供**便携版** `.zip`(无需安装,不会自动更新)。 + +### macOS 13+(Apple 芯片与 Intel) + +从[最新版本](https://github.com/naritaroad/qrcode-tool/releases/latest)下载 `.pkg`。首次扫描时,请在“系统设置 › 隐私与安全性”中允许**屏幕录制**(使用摄像头扫描时还需允许**相机**)。目前版本尚未公证,第一次请右键单击应用并选择**打开**。 + +### Linux + +下载 `.AppImage`,添加执行权限后运行。在 Wayland 下,请在桌面设置中添加一个运行 `qrcode-tool scan-screen` 的键盘快捷键。 + +### 从源代码构建 + +```bash +git clone https://github.com/naritaroad/qrcode-tool +cd qrcode-tool +cargo run --release +``` + +需要 Rust 1.85+、CMake 和 C++ 编译器(用于 zxing-cpp)。各平台的详细说明见 **[docs/BUILDING.md](../BUILDING.md)**(英文)。 + +### 命令行 + +```text +qrcode-tool 启动(已在运行时显示工具栏) +qrcode-tool scan-screen 扫描屏幕 +qrcode-tool scan-region 冻结屏幕并框选区域 +qrcode-tool scan-camera 用摄像头扫描 +qrcode-tool scan-clipboard 扫描剪贴板中的图片 +qrcode-tool scan-file 文件 扫描一个图片文件 +qrcode-tool show-toolbar 显示悬浮工具栏 +qrcode-tool generate "文本" 生成二维码 +qrcode-tool decode 文件… [--json] 不打开界面直接解码图片 +``` + + + +## 项目结构 + +```text +qrcode-tool/ +├─ app/ # 桌面应用(Slint 界面与胶水代码) +│ ├─ src/ # 托盘、快捷键、覆盖层、预览、设置、更新… +│ ├─ ui/ # .slint 窗口、控件、图标 +│ └─ translations/ # 9 种语言的 .po 翻译文件 +├─ crates/ +│ ├─ qrtool-core/ # 内容解析、链接安全、设置、历史记录(纯 Rust) +│ ├─ qrtool-decode/ # zxing-cpp 解码策略与二维码生成 +│ ├─ qrtool-capture/ # 多显示器截图(xcap) +│ ├─ qrtool-camera/ # 摄像头采集与实时解码(nokhwa) +│ └─ qrtool-platform/ # 系统集成:打开、开机启动、主题、Wi-Fi、IPC、剪贴板、右键菜单 +├─ assets/icons/ # 应用和托盘图标 +├─ packaging/ # MSIX、Linux 桌面项、macOS 包信息 +├─ docs/ # 架构、构建、FAQ、隐私、翻译 +│ └─ manual/ # 用户手册(PDF + Word,10 种语言)及其构建脚本 +└─ .github/workflows/ # CI 与发布流程 +``` + + + +## 参与贡献 + +欢迎提交问题报告、翻译、代码和想法。 + +- 请先阅读 **[CONTRIBUTING.md](../../CONTRIBUTING.md)**。 +- 改进翻译:**[docs/TRANSLATING.md](../TRANSLATING.md)**(目前的译文是经过校对的机器翻译,非常欢迎母语者参与)。 +- 发现安全问题?请按照 **[SECURITY.md](../../SECURITY.md)** 私下报告,不要公开提交 issue。 +- 所有参与者都应遵守 **[行为准则](../../CODE_OF_CONDUCT.md)**。 + +如果 QRcode tool 帮你节省了时间,欢迎[赞助本项目](https://github.com/sponsors/naritaroad)。❤️ + +## 许可证 + +本项目可任选以下一种许可证: + +- Apache License, Version 2.0([LICENSE-APACHE](../../LICENSE-APACHE)) +- MIT license([LICENSE-MIT](../../LICENSE-MIT)) + +除非你另有明确声明,你提交给本项目的任何贡献都将按上述双许可证发布,不附加任何其他条款或条件。 + +第三方组件及其许可证列于 [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md)。用户界面使用 [Slint](https://slint.dev) 构建,采用 Slint Royalty-free Desktop License。 + +### 相关项目 + +QRcode tool 受到以下项目的启发(没有复制它们的代码),感谢它们展示了桌面扫码可以做到什么: + +- [qrpeek](https://github.com/dzoffice/qrpeek) — 屏幕二维码识别工具 +- [ScreenQRScanner](https://github.com/Konyaco/ScreenQRScanner) — 屏幕二维码扫描器 +- [QR-Code-Reader](https://github.com/ottozumkeller/QR-Code-Reader) — 基于截图工具和 ZXing.Net 的读取器 +- [NormCap](https://github.com/dynobo/normcap) — 以 OCR 为核心的屏幕截取工具 +- [ShareX](https://github.com/ShareX/ShareX) — 带二维码工具的屏幕截图套件 +- [CodeTwo QR Code Desktop Reader](https://www.codetwo.com/freeware/qr-code-desktop-reader/) — 免费桌面读取器 + +本项目建立在 [zxing-cpp](https://github.com/zxing-cpp/zxing-cpp)、[Slint](https://github.com/slint-ui/slint)、[xcap](https://github.com/nashaofu/xcap)、[nokhwa](https://github.com/l1npengtul/nokhwa)、[global-hotkey](https://github.com/tauri-apps/global-hotkey)、[Velopack](https://github.com/velopack/velopack) 和 [qrcode](https://github.com/kennytm/qrcode-rust) 之上。 + +--- + +QR Code 是 DENSO WAVE INCORPORATED 的注册商标。QRcode tool 与 DENSO WAVE、Google 和 Microsoft 均无关联。 diff --git a/docs/i18n/README.zh-TW.md b/docs/i18n/README.zh-TW.md index 0375d65..1647cbe 100644 --- a/docs/i18n/README.zh-TW.md +++ b/docs/i18n/README.zh-TW.md @@ -12,7 +12,7 @@ ![Languages](https://img.shields.io/badge/languages-10-informational) ![Privacy](https://img.shields.io/badge/privacy-no%20telemetry-success) - · [English](../../README.md) · **繁體中文** · + · [English](../../README.md) · **繁體中文** · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · 按一個快速鍵 → 螢幕上每個 QR Code 都會出現標籤 → 按 Enter 開啟。 @@ -180,6 +180,7 @@ qrcode-tool/ ├─ assets/icons/ # 應用程式與系統匣圖示 ├─ packaging/ # MSIX、Linux 桌面項目、macOS 套件資訊 ├─ docs/ # 架構、建置、FAQ、隱私、翻譯 +│ └─ manual/ # 使用說明書(PDF 與 Word,10 種語言)及建置腳本 └─ .github/workflows/ # CI 與發佈流程 ``` diff --git a/docs/manual/QRcode-tool-User-Manual-de.docx b/docs/manual/QRcode-tool-User-Manual-de.docx new file mode 100644 index 0000000..b621ffc Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-de.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-de.pdf b/docs/manual/QRcode-tool-User-Manual-de.pdf new file mode 100644 index 0000000..86a8364 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-de.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-en.docx b/docs/manual/QRcode-tool-User-Manual-en.docx index 4678a3f..037a296 100644 Binary files a/docs/manual/QRcode-tool-User-Manual-en.docx and b/docs/manual/QRcode-tool-User-Manual-en.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-en.pdf b/docs/manual/QRcode-tool-User-Manual-en.pdf index 7916f10..d3e2921 100644 Binary files a/docs/manual/QRcode-tool-User-Manual-en.pdf and b/docs/manual/QRcode-tool-User-Manual-en.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-es.docx b/docs/manual/QRcode-tool-User-Manual-es.docx new file mode 100644 index 0000000..dfa5391 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-es.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-es.pdf b/docs/manual/QRcode-tool-User-Manual-es.pdf new file mode 100644 index 0000000..c15d260 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-es.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-fr.docx b/docs/manual/QRcode-tool-User-Manual-fr.docx new file mode 100644 index 0000000..a12c93a Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-fr.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-fr.pdf b/docs/manual/QRcode-tool-User-Manual-fr.pdf new file mode 100644 index 0000000..b653b8c Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-fr.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-ja.docx b/docs/manual/QRcode-tool-User-Manual-ja.docx new file mode 100644 index 0000000..1f227cd Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ja.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-ja.pdf b/docs/manual/QRcode-tool-User-Manual-ja.pdf new file mode 100644 index 0000000..70c4d77 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ja.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-ko.docx b/docs/manual/QRcode-tool-User-Manual-ko.docx new file mode 100644 index 0000000..af2a620 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ko.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-ko.pdf b/docs/manual/QRcode-tool-User-Manual-ko.pdf new file mode 100644 index 0000000..ea7b1da Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ko.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-pt-BR.docx b/docs/manual/QRcode-tool-User-Manual-pt-BR.docx new file mode 100644 index 0000000..2825d7f Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-pt-BR.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-pt-BR.pdf b/docs/manual/QRcode-tool-User-Manual-pt-BR.pdf new file mode 100644 index 0000000..676d641 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-pt-BR.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-ru.docx b/docs/manual/QRcode-tool-User-Manual-ru.docx new file mode 100644 index 0000000..912ca43 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ru.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-ru.pdf b/docs/manual/QRcode-tool-User-Manual-ru.pdf new file mode 100644 index 0000000..23de7e8 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-ru.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-zh-CN.docx b/docs/manual/QRcode-tool-User-Manual-zh-CN.docx new file mode 100644 index 0000000..af02050 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-zh-CN.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-zh-CN.pdf b/docs/manual/QRcode-tool-User-Manual-zh-CN.pdf new file mode 100644 index 0000000..462b659 Binary files /dev/null and b/docs/manual/QRcode-tool-User-Manual-zh-CN.pdf differ diff --git a/docs/manual/QRcode-tool-User-Manual-zh-TW.docx b/docs/manual/QRcode-tool-User-Manual-zh-TW.docx index 172d960..6b30bb1 100644 Binary files a/docs/manual/QRcode-tool-User-Manual-zh-TW.docx and b/docs/manual/QRcode-tool-User-Manual-zh-TW.docx differ diff --git a/docs/manual/QRcode-tool-User-Manual-zh-TW.pdf b/docs/manual/QRcode-tool-User-Manual-zh-TW.pdf index 5164617..c13a926 100644 Binary files a/docs/manual/QRcode-tool-User-Manual-zh-TW.pdf and b/docs/manual/QRcode-tool-User-Manual-zh-TW.pdf differ diff --git a/docs/manual/README.md b/docs/manual/README.md index 81a0bd1..0b6fd00 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -6,8 +6,18 @@ The complete user manual for QRcode tool 1.0, with screenshots of every window i |---|---|---| | English | [QRcode-tool-User-Manual-en.pdf](QRcode-tool-User-Manual-en.pdf) | [QRcode-tool-User-Manual-en.docx](QRcode-tool-User-Manual-en.docx) | | 繁體中文 | [QRcode-tool-User-Manual-zh-TW.pdf](QRcode-tool-User-Manual-zh-TW.pdf) | [QRcode-tool-User-Manual-zh-TW.docx](QRcode-tool-User-Manual-zh-TW.docx) | - -The same files are attached to every [GitHub release](https://github.com/naritaroad/qrcode-tool/releases/latest). +| 简体中文 | [QRcode-tool-User-Manual-zh-CN.pdf](QRcode-tool-User-Manual-zh-CN.pdf) | [QRcode-tool-User-Manual-zh-CN.docx](QRcode-tool-User-Manual-zh-CN.docx) | +| Español | [QRcode-tool-User-Manual-es.pdf](QRcode-tool-User-Manual-es.pdf) | [QRcode-tool-User-Manual-es.docx](QRcode-tool-User-Manual-es.docx) | +| Português (Brasil) | [QRcode-tool-User-Manual-pt-BR.pdf](QRcode-tool-User-Manual-pt-BR.pdf) | [QRcode-tool-User-Manual-pt-BR.docx](QRcode-tool-User-Manual-pt-BR.docx) | +| 日本語 | [QRcode-tool-User-Manual-ja.pdf](QRcode-tool-User-Manual-ja.pdf) | [QRcode-tool-User-Manual-ja.docx](QRcode-tool-User-Manual-ja.docx) | +| 한국어 | [QRcode-tool-User-Manual-ko.pdf](QRcode-tool-User-Manual-ko.pdf) | [QRcode-tool-User-Manual-ko.docx](QRcode-tool-User-Manual-ko.docx) | +| Français | [QRcode-tool-User-Manual-fr.pdf](QRcode-tool-User-Manual-fr.pdf) | [QRcode-tool-User-Manual-fr.docx](QRcode-tool-User-Manual-fr.docx) | +| Deutsch | [QRcode-tool-User-Manual-de.pdf](QRcode-tool-User-Manual-de.pdf) | [QRcode-tool-User-Manual-de.docx](QRcode-tool-User-Manual-de.docx) | +| Русский | [QRcode-tool-User-Manual-ru.pdf](QRcode-tool-User-Manual-ru.pdf) | [QRcode-tool-User-Manual-ru.docx](QRcode-tool-User-Manual-ru.docx) | + +The English and Traditional Chinese files are also attached to every +[GitHub release](https://github.com/naritaroad/qrcode-tool/releases/latest); the other languages +are only here. **Contents:** introduction · installation and first start · scanning the screen · webcam, clipboard, image files, right-click menu and command line · results and detail cards · link safety · @@ -20,8 +30,9 @@ updating and uninstalling · troubleshooting · shortcuts and supported codes. ## Updating the manual -The text lives in [`build/content.en.js`](build/content.en.js) and -[`build/content.zh-TW.js`](build/content.zh-TW.js). The screenshots are not edited by hand: they +The text lives in `build/content..js`, for example [`build/content.en.js`](build/content.en.js), +and the texts of the mock desktop in the screenshots in `build/docscenes/strings..json`. +The screenshots are not edited by hand: they are rendered from the app's real `.slint` files (with the translations from `app/translations`) by the Slint interpreter for Node.js, so they always match the current UI. @@ -38,7 +49,8 @@ through Word, which also fills in the table of contents. Screenshots are kept in `screenshots//` next to this file. The folder is not in git, so a fresh checkout takes them all once; after that only changed windows need retaking: `build.ps1 -Shots toolbar-row,settings-general` (names are listed in `AGENTS.md`), -`-Shots all` for everything, `-SkipShots` to rebuild only the documents. +`-Shots all` for everything, `-SkipShots` to rebuild only the documents, and `-Langs ja,ko` to +build only some languages. | Step | Script | |---|---| diff --git a/docs/manual/build/build-docx.js b/docs/manual/build/build-docx.js index e5314f3..511926f 100644 --- a/docs/manual/build/build-docx.js +++ b/docs/manual/build/build-docx.js @@ -36,7 +36,10 @@ const [lang, outDir] = process.argv.slice(2); const C = require(`./content.${lang}.js`); const FIG = path.join(__dirname, 'figures', lang); const ART = path.join(__dirname, 'art'); -const zh = lang.startsWith('zh'); +// Chinese, Japanese and Korean: East Asian font for the text, Segoe UI for Latin letters. +const cjk = /^(zh|ja|ko)/.test(lang); +// Chinese and Japanese separate numbers from titles with an ideographic space. +const wide = /^(zh|ja)/.test(lang); // The app version, from the workspace manifest. const VERSION = fs.readFileSync(path.join(__dirname, '..', '..', '..', 'Cargo.toml'), 'utf8').match(/^version = "([^"]+)"/m)[1]; @@ -47,9 +50,9 @@ const TEXT = '1B1B1B'; const MUTED = '5B6170'; const RULE = 'D5DAE3'; const TINT = 'EEF2FF'; -const FONT = zh ? { ascii: 'Segoe UI', hAnsi: 'Segoe UI', eastAsia: C.font, cs: 'Segoe UI' } : { ascii: C.font, hAnsi: C.font, eastAsia: C.font, cs: C.font }; -const MONO = { ascii: C.monoFont, hAnsi: C.monoFont, eastAsia: zh ? C.font : C.monoFont, cs: C.monoFont }; -const SEP = zh ? ' ' : ' '; // between number and title +const FONT = cjk ? { ascii: 'Segoe UI', hAnsi: 'Segoe UI', eastAsia: C.font, cs: 'Segoe UI' } : { ascii: C.font, hAnsi: C.font, eastAsia: C.font, cs: C.font }; +const MONO = { ascii: C.monoFont, hAnsi: C.monoFont, eastAsia: cjk ? C.font : C.monoFont, cs: C.monoFont }; +const SEP = wide ? ' ' : ' '; // between number and title const PAGE = { w: 11906, h: 16838 }; // A4 in twips const MARGIN = { top: 1474, bottom: 1361, left: 1304, right: 1304 }; const CONTENT_TW = PAGE.w - MARGIN.left - MARGIN.right; @@ -239,7 +242,7 @@ function body() { new Paragraph({ pageBreakBefore: true, spacing: { before: 0, after: 80 }, - children: [new TextRun({ text: label.toUpperCase(), color: BLUE, bold: true, size: 20, characterSpacing: zh ? 40 : 60 })], + children: [new TextRun({ text: label.toUpperCase(), color: BLUE, bold: true, size: 20, characterSpacing: cjk ? 40 : 60 })], }), ); out.push( @@ -381,7 +384,7 @@ const doc = new Document({ features: { updateFields: true }, styles: { default: { - document: { run: { font: FONT, size: 21, color: TEXT }, paragraph: { spacing: { after: 140, line: zh ? 336 : 312 } } }, + document: { run: { font: FONT, size: 21, color: TEXT }, paragraph: { spacing: { after: 140, line: cjk ? 336 : 312 } } }, heading1: { run: { font: FONT, size: 44, bold: true, color: TEXT }, paragraph: { spacing: { before: 0, after: 360 }, keepNext: true, border: { bottom: { style: BorderStyle.SINGLE, size: 12, color: BLUE, space: 8 } } }, diff --git a/docs/manual/build/build.ps1 b/docs/manual/build/build.ps1 index fc78355..ad685f2 100644 --- a/docs/manual/build/build.ps1 +++ b/docs/manual/build/build.ps1 @@ -1,4 +1,4 @@ -# Rebuilds the user manuals in docs/manual (Word + PDF, English and Traditional Chinese). +# Rebuilds the user manuals in docs/manual (Word + PDF, one per UI language). # # Requirements: Windows, Node.js 20+, Microsoft Word, .NET Framework 4 (csc.exe, part of Windows). # Screenshots are rendered from the app's real .slint files with the Slint interpreter, so no @@ -7,16 +7,18 @@ # # Usage: powershell -ExecutionPolicy Bypass -File docs\manual\build\build.ps1 [options] # (no options) take missing screenshots, rebuild Word + PDF -# -Shots toolbar-row,settings-general also retake these screenshots (both languages) +# -Shots toolbar-row,settings-general also retake these screenshots (every language) # -Shots all retake every screenshot # -SkipShots use the existing screenshots only # -Art redraw the cover and back-cover artwork -param([string[]]$Shots = @(), [switch]$SkipShots, [switch]$Art) +# -Langs ja,ko only these languages (default: all ten) +param([string[]]$Shots = @(), [switch]$SkipShots, [switch]$Art, + [string[]]$Langs = @("en", "zh-TW", "zh-CN", "es", "pt-BR", "ja", "ko", "fr", "de", "ru")) $ErrorActionPreference = "Stop" $here = $PSScriptRoot $repo = (Resolve-Path (Join-Path $here "..\..\..")).Path $manual = (Resolve-Path (Join-Path $here "..")).Path -$langs = @("en", "zh-TW") +$langs = @($Langs | ForEach-Object { $_ -split "," } | Where-Object { $_ }) Push-Location $here try { @@ -42,9 +44,8 @@ try { node figures.js $l; if ($LASTEXITCODE) { throw "figures $l" } node build-docx.js $l $manual; if ($LASTEXITCODE) { throw "docx $l" } } - & powershell -NoProfile -ExecutionPolicy Bypass -File to-pdf.ps1 ` - (Join-Path $manual "QRcode-tool-User-Manual-en.docx") ` - (Join-Path $manual "QRcode-tool-User-Manual-zh-TW.docx") + $docs = @($langs | ForEach-Object { Join-Path $manual "QRcode-tool-User-Manual-$_.docx" }) + & powershell -NoProfile -ExecutionPolicy Bypass -File to-pdf.ps1 @docs if ($LASTEXITCODE) { throw "pdf export" } } finally { Pop-Location diff --git a/docs/manual/build/content.de.js b/docs/manual/build/content.de.js new file mode 100644 index 0000000..063414c --- /dev/null +++ b/docs/manual/build/content.de.js @@ -0,0 +1,733 @@ +// Text des Benutzerhandbuchs von QRcode tool (Deutsch). +// Auszeichnung: **fett**, [[Taste]], `Code`. Abbildungsnamen verweisen auf shots// (siehe figures.js). + +module.exports = { + lang: 'de', + font: 'Segoe UI', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-de', + docTitle: 'QRcode tool Benutzerhandbuch', + cover: { + title: 'QRcode tool', + subtitle: 'Benutzerhandbuch', + tagline: 'QR-Codes am Computer so einfach scannen wie mit dem Smartphone.', + edition: 'Version 1.0.0 | Oktober 2026', + platforms: 'Für Windows 10 (21H2 oder neuer) / Windows 11, macOS 13 oder neuer und Linux', + }, + back: { + heading: 'Scannen. Prüfen. Dann öffnen.', + body: [ + 'QRcode tool ist ein kostenloser Open-Source-Scanner für den Desktop. Er liest QR-Codes und Barcodes vom Bildschirm, von der Webcam, aus der Zwischenablage und aus Bilddateien und prüft jede Webadresse auf gängige Tricks, bevor etwas geöffnet wird.', + 'Alles geschieht auf Ihrem Computer. Das Programm sammelt keine Nutzungsdaten und sendet nie, was Sie scannen, ins Internet.', + ], + links: [ + ['Projektseite', 'https://github.com/naritaroad/qrcode-tool'], + ['Neueste Version', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['Problem melden', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: 'Die Software steht unter der MIT- oder Apache-2.0-Lizenz. Dieses Handbuch darf unter denselben Bedingungen kopiert und bearbeitet werden.', + trademark: 'QR Code ist eine eingetragene Marke der DENSO WAVE INCORPORATED. QRcode tool steht in keiner Verbindung zu DENSO WAVE, Google oder Microsoft.', + }, + labels: { + toc: 'Inhalt', + chapter: (n) => `Kapitel ${n}`, + appendix: (l) => `Anhang ${l}`, + figure: (id) => `Abbildung ${id}`, + tip: 'Tipp', + note: 'Hinweis', + header: 'QRcode tool Benutzerhandbuch', + tocHint: '(Klicken Sie in Word mit der rechten Maustaste auf das Inhaltsverzeichnis und wählen Sie „Felder aktualisieren“, um die Seitenzahlen zu erneuern.)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'QRcode tool im Überblick' }, + { p: 'QRcode tool ist ein kleines Desktop-Programm, das im Infobereich der Taskleiste wartet und QR-Codes und Barcodes vom Bildschirm liest. Wenn Sie die Tastenkombination drücken, wird der Bildschirm kurz eingefroren und jeder Code erhält ein Ergebnisetikett. Es zeigt die Art des Inhalts und bei Links den tatsächlichen Websitenamen. Drücken Sie [[Enter]] oder klicken Sie auf das Etikett, um den Link zu öffnen, sich mit dem WLAN zu verbinden oder den Kontakt zu speichern.' }, + { p: 'Es liest auch Codes, die Sie vor die Webcam halten, Bilder aus der Zwischenablage und Bilddateien, und enthält einen einfachen QR-Code-Generator.' }, + { h2: 'Die wichtigsten Funktionen' }, + { + table: { + cols: [26, 74], + head: ['Funktion', 'Beschreibung'], + rows: [ + ['Ganzen Bildschirm scannen', 'Friert alle Monitore ein, findet jeden Code automatisch und versieht ihn mit einem Etikett. Funktioniert auch bei Videos und Spielen.'], + ['Bereich auswählen', 'Ziehen Sie einen Rahmen um einen einzelnen Code. Für Codes, die zu klein, unscharf oder schräg sind, um automatisch gefunden zu werden.'], + ['Webcam', 'Halten Sie einen gedruckten Code oder einen Smartphone-Bildschirm vor die Kamera; das Ergebnis erscheint, sobald der Code erkannt ist.'], + ['Zwischenablage und Bilddateien', 'Liest einen gerade kopierten Screenshot oder PNG-, JPEG-, BMP-, GIF- und WebP-Dateien.'], + ['Versteht den Inhalt', 'Erkennt Weblinks, WLAN, Kontakte, E-Mail, Telefonnummern, SMS, Kartenpositionen, Schlüssel für die zweistufige Überprüfung, Zahlungsadressen und taiwanische E-Rechnungen und bietet passende Schaltflächen an.'], + ['Sicherheitsprüfung für Links', 'Vor dem Öffnen wird jeder Link auf unverschlüsselte Verbindungen, getarnte Adressen, ähnlich aussehende Buchstaben, IP-Adressen, Kurzlinks und andere gängige Tricks geprüft. Alle Prüfungen laufen offline.'], + ['QR-Codes erstellen', 'Macht aus Text oder einem Link einen QR-Code, den Sie kopieren oder als PNG oder SVG speichern können.'], + ['Schwebende Symbolleiste und Blase', 'Eine Symbolleiste am oberen Bildschirmrand (horizontal) oder am rechten bzw. linken Rand (vertikal), die sich zu einer kleinen runden Blase zusammenklappen lässt.'], + ['Sprachen', 'Englisch, traditionelles Chinesisch, vereinfachtes Chinesisch, Japanisch, Koreanisch, Spanisch, Portugiesisch (Brasilien), Französisch, Deutsch und Russisch.'], + ], + }, + }, + { h2: 'Systemvoraussetzungen' }, + { + table: { + cols: [30, 70], + head: ['Betriebssystem', 'Voraussetzungen und Hinweise'], + rows: [ + ['Windows', 'Windows 10 21H2 oder neuer, Windows 11. x64 und ARM64. Für die Installation sind keine Administratorrechte nötig.'], + ['macOS', 'macOS 13 oder neuer (Apple Silicon und Intel). Für den ersten Scan ist die Berechtigung „Bildschirmaufnahme“ nötig, für das Scannen mit der Webcam die Berechtigung „Kamera“.'], + ['Linux', 'Alle Funktionen unter X11. Unter Wayland starten Sie den Scan über eine Tastenkombination, die Sie in den Desktop-Einstellungen anlegen (siehe Kapitel 4).'], + ['Hardware', 'Jeder übliche Bürocomputer. Eine Webcam ist optional. Im Leerlauf belegt das Programm weniger als etwa 30 MB Arbeitsspeicher.'], + ], + }, + }, + { h2: 'Grundsätze zu Datenschutz und Sicherheit' }, + { + ul: [ + 'Decodierung und Linkprüfung finden auf Ihrem Computer statt. Gescannte Inhalte werden nie hochgeladen, und kein Webdienst wird nach dem Ruf einer Adresse gefragt.', + 'Die einzige Netzwerkverbindung ist die optionale automatische Updateprüfung, die GitHub nur fragt, ob es eine neuere Version gibt.', + 'Der Scanverlauf ist standardmäßig ausgeschaltet. Auch wenn er eingeschaltet ist, werden WLAN-Kennwörter und Schlüssel für die zweistufige Überprüfung nie gespeichert.', + 'Nur `http`- und `https`-Adressen lassen sich öffnen. Andere Linkarten können nur kopiert werden; sie werden nie an das System übergeben.', + 'Ein Link mit Warnung zeigt immer zuerst seine Details und wartet auf Sie.', + ], + }, + { h2: 'Konventionen in diesem Handbuch' }, + { + ul: [ + 'Schaltflächen, Optionen und Fensternamen sind **fett** gesetzt, zum Beispiel **Einstellungen** oder **Ganzen Bildschirm scannen**.', + 'Tasten werden als Tastenkappen dargestellt, zum Beispiel [[Enter]] oder [[Ctrl+Alt+Q]]. [[Ctrl]] entspricht der Taste Strg.', + '**Einstellungen › Allgemein** bedeutet: Öffnen Sie das Fenster **Einstellungen** und wählen Sie links die Seite **Allgemein**.', + 'Die Abbildungen zeigen Windows 11. Unter macOS und Linux funktioniert alles genauso; nur Fensterrahmen und Systemmenüs sehen anders aus.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'Installation und erster Start' }, + { h2: 'Herunterladen und installieren (Windows)' }, + { + ol: [ + 'Öffnen Sie die Release-Seite auf GitHub (https://github.com/naritaroad/qrcode-tool/releases/latest).', + 'Laden Sie für die meisten Computer `QRcodeTool-win-x64-Setup.exe` herunter, für Computer mit ARM-Prozessor `QRcodeTool-win-arm64-Setup.exe`.', + 'Führen Sie die heruntergeladene Datei aus. QRcode tool wird nur für Ihr Benutzerkonto installiert und braucht keine Administratorrechte.', + 'Nach der Installation startet QRcode tool und zeigt den Willkommensbildschirm.', + ], + }, + { tip: 'Wenn Sie nichts installieren möchten, laden Sie die Datei `Portable.zip` herunter, entpacken Sie sie und starten Sie das Programm direkt. Die portable Version kann sich nicht selbst aktualisieren.' }, + { h2: 'Wenn Windows „Der Computer wurde durch Windows geschützt“ anzeigt' }, + { p: 'Die aktuellen Versionen sind noch nicht codesigniert, daher kann Windows SmartScreen vor einem unbekannten Herausgeber warnen. Das ist bei neuen, nicht signierten Programmen üblich.' }, + { + ol: [ + 'Klicken Sie in der Warnung auf **Weitere Informationen**.', + 'Prüfen Sie, dass der App-Name QRcode tool lautet, und klicken Sie auf **Trotzdem ausführen**.', + ], + }, + { p: 'Um sicherzugehen, dass der Download nicht verändert wurde, führen Sie in PowerShell den folgenden Befehl aus und vergleichen das Ergebnis mit der Datei `SHA256SUMS` auf der Release-Seite:' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS und Linux' }, + { p: '**macOS:** Laden Sie die Datei `.pkg` herunter und installieren Sie sie. Die Versionen sind noch nicht von Apple notariell beglaubigt; klicken Sie beim ersten Mal mit der rechten Maustaste auf die App und wählen Sie **Öffnen**. Erlauben Sie QRcode tool beim ersten Scan unter **Systemeinstellungen › Datenschutz & Sicherheit › Bildschirmaufnahme** und, wenn Sie die Webcam nutzen möchten, unter **Kamera**.' }, + { p: '**Linux:** Laden Sie die Datei `.AppImage` herunter, machen Sie sie ausführbar und starten Sie sie. GNOME braucht die Erweiterung „AppIndicator and KStatusNotifierItem Support“, um Symbole im Infobereich anzuzeigen.' }, + { h2: 'Der Willkommensbildschirm' }, + { p: 'Beim ersten Start erscheint der Willkommensbildschirm. Er zeigt die drei häufigsten Arten zu scannen mit ihren Tastenkombinationen und erklärt, dass sich Links nie unerwartet öffnen.' }, + { fig: 'welcome', cap: 'Der Willkommensbildschirm beim ersten Start', width: 11 }, + { + ul: [ + '**Sprache:** folgt standardmäßig dem Betriebssystem. Eine Änderung hier gilt sofort.', + '**Mit dem Computer starten:** standardmäßig eingeschaltet, damit die Tastenkombination immer bereit ist. Sie können es hier oder später unter **Einstellungen › Allgemein** ausschalten.', + '**Jetzt ausprobieren:** schließt den Willkommensbildschirm und scannt einmal den ganzen Bildschirm.', + '**Schließen:** schließt den Willkommensbildschirm und zeigt die schwebende Symbolleiste.', + ], + }, + { p: 'Um den Willkommensbildschirm erneut zu sehen, öffnen Sie **Einstellungen › Allgemein** und klicken auf **Willkommensbildschirm erneut anzeigen**.' }, + { h2: 'Das Symbol im Infobereich' }, + { p: 'QRcode tool hat kein klassisches Hauptfenster. Nach dem Start erscheint sein Symbol im Infobereich am rechten Ende der Taskleiste; von dort erreichen Sie jede Funktion.' }, + { + ul: [ + '**Klick auf das Symbol:** scannt sofort den ganzen Bildschirm.', + '**Rechtsklick:** öffnet das Menü (Abbildung 2-2).', + '**Mauszeiger auf das Symbol:** zeigt die aktuelle Tastenkombination zum Scannen.', + ], + }, + { fig: 'tray-menu', cap: 'Das Menü des Symbols im Infobereich', width: 11 }, + { tip: 'Windows blendet neue Symbole im Infobereich manchmal hinter dem Pfeil „^“ aus. Ziehen Sie das Symbol auf die Taskleiste, damit es immer sichtbar bleibt.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: 'Den Bildschirm scannen' }, + { h2: 'Ganzen Bildschirm scannen' }, + { + ol: [ + 'Sorgen Sie dafür, dass die Webseite, das Dokument, das Video oder das Bild mit dem QR-Code sichtbar ist.', + 'Drücken Sie [[Ctrl+Alt+Q]], klicken Sie auf das Symbol im Infobereich oder klicken Sie in der schwebenden Symbolleiste auf **Ganzen Bildschirm scannen**.', + 'Der Bildschirm friert ein und wird abgedunkelt. Nach einem kurzen Scan-Durchlauf erhält jeder gefundene Code ein Ergebnisetikett.', + 'Drücken Sie [[Enter]], um den ausgewählten Code zu öffnen, oder klicken Sie auf das gewünschte Etikett.', + 'Drücken Sie [[Esc]] oder klicken Sie mit der rechten Maustaste, um den Scanbildschirm zu verlassen.', + ], + }, + { fig: 'scan-screen', cap: 'Ganzen Bildschirm scannen: Jeder Code erhält ein Etikett, der erste ist ausgewählt' }, + { p: 'Die Statusanzeige oben zeigt, wie viele Codes gefunden wurden. Die Farbe der Klammern um jeden Code zeigt das Ergebnis der Prüfungen:' }, + { + table: { + cols: [22, 78], + head: ['Klammerfarbe', 'Bedeutung'], + rows: [ + ['Weiß', 'Nichts Verdächtiges gefunden.'], + ['Akzentfarbe (blau)', 'Der ausgewählte Code. [[Enter]] öffnet ihn.'], + ['Gelb', 'Etwas verdient Aufmerksamkeit, zum Beispiel ein unverschlüsselter http-Link oder ein Kurzlink. Der Grund steht unter dem Etikett.'], + ['Rot', 'Der Link wirkt irreführend, zum Beispiel eine getarnte Adresse oder eine Domäne, die Alphabete mischt.'], + ], + }, + }, + { p: 'Da der Bildschirm eingefroren ist, lassen sich auch Codes in Videos, Präsentationen und Spielen lesen. Bei mehreren Monitoren werden alle gleichzeitig gescannt.' }, + { h2: 'Bereich auswählen' }, + { p: 'Wenn ein Code klein, unscharf oder schräg ist oder wenn viele Codes auf dem Bildschirm sind, ziehen Sie einen Rahmen nur um den gewünschten Code. Der ausgewählte Bereich wird vor dem Lesen vergrößert; bei schwierigen Codes funktioniert das besser als ein Scan des ganzen Bildschirms.' }, + { + ol: [ + 'Drücken Sie [[Ctrl+Alt+A]] oder wählen Sie **Bereich auswählen** im Menü des Infobereichs oder in der schwebenden Symbolleiste.', + 'Der Bildschirm friert ein und der Mauszeiger wird zum Fadenkreuz. Halten Sie die linke Maustaste gedrückt und ziehen Sie einen Rahmen um den Code.', + 'Lassen Sie die Maustaste los. Nur der Inhalt im Rahmen wird gelesen.', + ], + }, + { fig: 'scan-region', cap: 'Bereich auswählen: Beim Ziehen wird die Größe des Rahmens angezeigt' }, + { tip: 'Ziehen Sie den Rahmen etwas größer als den Code; ein freier Rand hilft. Erscheint die Meldung „Kein Code in diesem Bereich“, ziehen Sie einen etwas größeren Rahmen.' }, + { h2: 'Die Symbolleiste auf dem Scanbildschirm' }, + { p: 'Am oberen Rand des Scanbildschirms befindet sich eine Reihe von Schaltflächen. Von links nach rechts: **Ganzen Bildschirm scannen**, **Bereich auswählen**, **Mit Kamera scannen**, **Bild aus Zwischenablage scannen**, **Bild öffnen…**, **QR-Code erstellen…**, **Verlauf**, **Einstellungen** und **Schließen**. Sie können die Methode wechseln, ohne den Scanbildschirm zu verlassen, etwa vom ganzen Bildschirm zu einem ausgewählten Bereich. Zeigen Sie mit der Maus auf eine Schaltfläche, um ihre Beschreibung und Tastenkombination zu sehen.' }, + { h2: 'Tastatur' }, + { p: 'Der Scanbildschirm lässt sich vollständig mit der Tastatur bedienen:' }, + { + table: { + cols: [30, 70], + head: ['Taste', 'Aktion'], + rows: [ + ['[[Enter]]', 'Den ausgewählten Code öffnen.'], + ['[[Tab]], [[→]], [[↓]]', 'Den nächsten Code auswählen.'], + ['[[Shift+Tab]], [[←]], [[↑]]', 'Den vorherigen Code auswählen.'], + ['[[C]]', 'Den ausgewählten Code kopieren.'], + ['[[F]] oder [[F5]]', 'Den ganzen Bildschirm erneut durchsuchen.'], + ['[[Esc]]', 'Abbrechen und den Scanbildschirm verlassen (Rechtsklick geht auch).'], + ], + }, + }, + { h2: 'Wenn kein Code gefunden wird' }, + { + ul: [ + 'Verwenden Sie **Bereich auswählen** und ziehen Sie den Rahmen nur um den Code; er wird vor dem Lesen vergrößert.', + 'Bewegt sich der Code in einem Video schnell, halten Sie das Video zuerst an.', + 'Schieben Sie andere Fenster, den Mauszeiger oder alles andere beiseite, was einen Teil des Codes verdeckt.', + 'Prüfen Sie, ob **Einstellungen › Scannen › Auch Barcodes lesen** eingeschaltet ist, wenn Sie Barcodes und Formate wie Data Matrix lesen möchten.', + 'Ist der Code auf dem Bildschirm sehr klein (weniger als etwa 40 Pixel breit), vergrößern Sie zuerst die Seite oder das Bild.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'Weitere Arten zu scannen' }, + { h2: 'Webcam' }, + { p: 'Verwenden Sie die Webcam für Codes auf Papier, Visitenkarten oder dem Bildschirm eines anderen Smartphones.' }, + { + ol: [ + 'Drücken Sie [[Ctrl+Alt+W]] oder wählen Sie **Mit Kamera scannen**.', + 'Halten Sie den Code in etwa 15 bis 30 cm Abstand vor die Kamera.', + 'Wird ein Code erkannt, erscheinen Klammern um ihn, und sein Ergebnisetikett wird in eine feste Liste unten im Bild eingefügt.', + 'Klicken Sie auf das Etikett oder wählen Sie es mit [[Tab]] aus und drücken Sie [[Enter]].', + ], + }, + { fig: 'camera', cap: 'Mit Kamera scannen: Die Ergebnisse bleiben in einer festen Liste unten', width: 13 }, + { + ul: [ + 'Ein Code muss in mehreren aufeinanderfolgenden Bildern erkannt werden, bevor er in die Liste kommt; das verhindert Fehllesungen.', + 'Verlässt ein Code das Bild, bleibt sein Ergebnis noch eine Weile in der Liste (standardmäßig 8 Sekunden), damit Sie es noch anklicken können. Die Dauer ändern Sie unter **Einstellungen › Kamera**.', + 'Sind mehrere Kameras angeschlossen, wechseln Sie mit der Liste unten im Fenster zwischen ihnen.', + 'Der Schalter **Spiegeln** ändert nur die Darstellung des Bildes; die Erkennung funktioniert in beiden Fällen.', + 'Standardmäßig schließt sich das Kamerafenster, nachdem ein Code geöffnet wurde. Das können Sie unter **Einstellungen › Kamera** ändern.', + ], + }, + { note: 'Startet die Kamera nicht, schließen Sie andere Programme, die sie möglicherweise nutzen (zum Beispiel Videoanrufe), und erlauben Sie QRcode tool in den Datenschutzeinstellungen des Systems den Zugriff auf die Kamera.' }, + { h2: 'Bild aus der Zwischenablage' }, + { + ol: [ + 'Nehmen Sie den Code mit [[Win+Shift+S]] oder einem anderen Screenshot-Werkzeug auf, oder kopieren Sie ein Bild von einer Webseite.', + 'Wählen Sie **Bild aus Zwischenablage scannen**.', + 'Das Bild erscheint in einem Vorschaufenster, und jeder gefundene Code erhält ein Ergebnisetikett.', + ], + }, + { p: 'Befindet sich kein Bild in der Zwischenablage, bittet das Programm Sie, zuerst einen Screenshot oder ein Bild zu kopieren.' }, + { h2: 'Bilddateien' }, + { + ol: [ + 'Wählen Sie **Bild öffnen…**.', + 'Wählen Sie eine PNG-, JPEG-, BMP-, GIF- oder WebP-Datei.', + 'Klicken Sie im Vorschaufenster auf ein Ergebnisetikett. Mit den Schaltflächen unten öffnen Sie ein anderes Bild oder scannen stattdessen die Zwischenablage.', + ], + }, + { fig: 'image-preview', cap: 'Das Vorschaufenster: Die Etiketten liegen auf den Codes im Bild', width: 13 }, + { h2: 'Windows-Kontextmenü' }, + { p: 'Unter Windows kann QRcode tool seine wichtigsten Funktionen zum Kontextmenü (Rechtsklickmenü) des Datei-Explorers hinzufügen: Klicken Sie mit der rechten Maustaste auf den Desktophintergrund, um den Bildschirm zu scannen, oder auf ein Bild, um diese Datei zu scannen – ohne die Symbolleiste zu öffnen oder sich eine Tastenkombination zu merken.' }, + { + figs: [ + ['shell-desktop', 'Rechtsklick auf den Desktophintergrund'], + ['shell-image', 'Rechtsklick auf ein Bild'], + ], + cap: 'Einträge von QRcode tool im Kontextmenü (Windows 11, Weitere Optionen anzeigen)', + }, + { h3: 'Das Kontextmenü ein- oder ausschalten' }, + { p: 'Das Kontextmenü ist standardmäßig **eingeschaltet**: Die Einträge erscheinen, sobald QRcode tool installiert und einmal gestartet wurde. Wenn Sie es früher ausgeschaltet haben, schalten Sie es so wieder ein:' }, + { + ol: [ + 'Öffnen Sie **Einstellungen** über das Menü im Infobereich oder die schwebende Symbolleiste.', + 'Wählen Sie links **Allgemein**.', + 'Schalten Sie **Rechtsklickmenü** ein. Die Änderung gilt sofort; Computer oder Datei-Explorer müssen nicht neu gestartet werden.', + ], + }, + { p: 'Schalten Sie denselben Schalter aus, um die Einträge zu entfernen. Sie werden in Ihren eigenen Benutzereinstellungen gespeichert (im Bereich HKEY_CURRENT_USER der Registrierung); daher sind keine Administratorrechte nötig, und andere Konten auf dem Computer sind nicht betroffen.' }, + { h3: 'Das Menü öffnen' }, + { + ul: [ + '**Windows 11:** Klicken Sie mit der rechten Maustaste und wählen Sie unten **Weitere Optionen anzeigen**; die Einträge von QRcode tool stehen im vollständigen Menü. Um das vollständige Menü direkt zu öffnen, halten Sie beim Rechtsklick [[Shift]] gedrückt oder drücken Sie [[Shift+F10]].', + '**Windows 10:** Die Einträge von QRcode tool erscheinen direkt beim Rechtsklick.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['Menüeintrag', 'Wo', 'Aktion'], + rows: [ + ['QRcode tool Bildschirm scannen', 'Desktophintergrund', 'Scannt den ganzen Bildschirm (wie [[Ctrl+Alt+Q]]).'], + ['QRcode tool Auswahl scannen', 'Desktophintergrund', 'Friert den Bildschirm ein, damit Sie einen Bereich auswählen können (wie [[Ctrl+Alt+A]]).'], + ['QRcode tool Mit Kamera scannen', 'Desktophintergrund', 'Öffnet die Webcam (wie [[Ctrl+Alt+W]]).'], + ['QRcode tool Symbolleiste', 'Desktophintergrund', 'Zeigt die schwebende Symbolleiste.'], + ['QRcode tool Bild öffnen', 'Bilddateien', 'Scannt das Bild im Vorschaufenster. Unterstützt werden PNG, JPEG, BMP, GIF und WebP.'], + ], + }, + }, + { + ul: [ + 'Die vier Desktop-Einträge stehen gesammelt unten im Menü zwischen Trennlinien, mit dem Symbol von QRcode tool.', + '**QRcode tool Bild öffnen** erscheint nur, wenn genau **ein** Bild ausgewählt ist, nicht bei mehreren Dateien gleichzeitig.', + 'Die Einträge verwenden die Sprache von QRcode tool. Nach einer Änderung unter **Einstellungen › Allgemein › Sprache** wird auch das Menü aktualisiert.', + 'Läuft QRcode tool nicht, startet ein Eintrag das Programm und führt die Funktion aus; läuft es bereits, übernimmt das laufende Programm die Anfrage.', + 'Bei der portablen Version zeigen die Einträge auf den aktuellen Speicherort des Programms. Starten Sie das Programm nach dem Verschieben des portablen Ordners einmal, damit die Einträge aktualisiert werden.', + 'Beim Deinstallieren von QRcode tool werden die Einträge entfernt. macOS und Linux haben keine Kontextmenü-Einträge; nutzen Sie dort die Tastenkombinationen oder die Befehlszeile.', + ], + }, + { tip: 'Fehlt QRcode tool im Menü: Prüfen Sie, ob **Einstellungen › Allgemein › Rechtsklickmenü** eingeschaltet ist, wählen Sie unter Windows 11 **Weitere Optionen anzeigen**, und starten Sie QRcode tool einmal, wenn es gerade installiert oder verschoben wurde.' }, + { h2: 'Befehlszeile' }, + { p: 'Jede Scanfunktion lässt sich mit einem Befehl starten. Läuft das Programm bereits, wird der Befehl an das laufende Programm weitergegeben. Das ist besonders unter Linux mit Wayland nützlich: Legen Sie die Befehle in den Tastatureinstellungen des Desktops als eigene Tastenkombinationen an.' }, + { + table: { + cols: [42, 58], + head: ['Befehl', 'Aktion'], + rows: [ + ['`qrcode-tool`', 'Startet das Programm oder zeigt die schwebende Symbolleiste, wenn es bereits läuft.'], + ['`qrcode-tool scan-screen`', 'Scannt den ganzen Bildschirm.'], + ['`qrcode-tool scan-region`', 'Friert den Bildschirm ein und wählt einen Bereich aus.'], + ['`qrcode-tool scan-camera`', 'Scannt mit der Webcam.'], + ['`qrcode-tool scan-clipboard`', 'Scannt das Bild in der Zwischenablage.'], + ['`qrcode-tool scan-file DATEI`', 'Scannt eine Bilddatei im Vorschaufenster.'], + ['`qrcode-tool toolbar`', 'Blendet die schwebende Symbolleiste ein oder aus.'], + ['`qrcode-tool bubble`', 'Blendet die schwebende Blase ein oder aus.'], + ['`qrcode-tool generate "TEXT"`', 'Öffnet den QR-Code-Generator mit dem eingetragenen Text.'], + ['`qrcode-tool settings`', 'Öffnet die Einstellungen.'], + ['`qrcode-tool decode DATEI… [--json]`', 'Gibt die Codes in Bilddateien im Terminal aus, ohne die Oberfläche zu starten.'], + ['`qrcode-tool quit`', 'Beendet das laufende Programm.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: 'Ergebnisse und Details' }, + { h2: 'Ergebnisetiketten' }, + { p: 'Jeder gefundene Code erhält ein dunkles Ergebnisetikett. Von links nach rechts zeigt es:' }, + { + ul: [ + '**Symbol:** die Art des Inhalts, zum Beispiel ein Globus für einen Link, Funkwellen für WLAN oder eine Person für einen Kontakt. Links mit Warnung zeigen stattdessen ein Warn- oder Gefahrensymbol.', + '**Haupttext:** bei Links der tatsächliche Websitename statt der vollständigen Adresse, bei WLAN der Netzwerkname, bei Kontakten der Name.', + '**Zweite Zeile:** die Art des Inhalts oder der Hauptgrund einer Warnung.', + '**Schaltfläche ›:** öffnet immer die Detailkarte, egal welcher Inhalt.', + ], + }, + { h2: 'Was Enter oder ein Klick bewirken' }, + { + table: { + cols: [36, 64], + head: ['Inhalt', 'Aktion'], + rows: [ + ['Link ohne Warnungen', 'Wird im Standardbrowser geöffnet.'], + ['Link mit Warnung', 'Zeigt zuerst die Detailkarte; der Link wird erst nach Ihrer Bestätigung geöffnet.'], + ['Alles andere', 'Zeigt die Detailkarte, auf der Sie wählen, was geschehen soll.'], + ], + }, + }, + { h2: 'Die Detailkarte' }, + { p: 'Die Detailkarte listet jedes Feld des Codes auf und bietet passende Schaltflächen an. Die Kopierschaltfläche neben einem Feld kopiert nur dieses Feld. Sensible Felder wie Kennwörter werden als „••••“ verborgen; die Schloss-Schaltfläche zeigt sie kurz an. Klicken Sie außerhalb der Karte oder auf **Schließen**, um zu den Ergebnissen zurückzukehren.' }, + { fig: 'detail-wifi', cap: 'Detailkarte eines WLAN-Codes: „Verbinden“ tritt dem Netzwerk bei', width: 12 }, + { h2: 'Schaltflächen je nach Inhalt' }, + { + table: { + cols: [30, 70], + head: ['Art', 'Schaltflächen'], + rows: [ + ['Link', '**Öffnen**, **Kopieren**. Links ohne Warnungen zu Websites, denen Sie noch nicht vertrauen, bieten außerdem **Diese Website immer zulassen**.'], + ['WLAN-Netzwerk', '**Verbinden** (das System legt das Netzwerkprofil an), **Kennwort kopieren**.'], + ['Kontakt (vCard, MeCard)', '**Kontakt speichern** (speichert eine .vcf-Datei, die Sie ins Adressbuch importieren können), **Kopieren**.'], + ['E-Mail', '**E-Mail schreiben** (öffnet Ihr Standard-Mailprogramm), **Kopieren**.'], + ['Telefonnummer', '**Anrufen** (an die Anruf-App des Systems übergeben), **Kopieren**.'], + ['SMS', '**Nachricht senden**, **Kopieren**.'], + ['Standort', '**Karte öffnen**, **Kopieren**.'], + ['Schlüssel für zweistufige Überprüfung', 'Nur Dienstname und Konto werden angezeigt; **Kopieren** ist verfügbar. Das Geheimnis selbst wird nie angezeigt oder gespeichert.'], + ['Zahlungsadresse', '**Kopieren**. Prüfen Sie eine Zahlungsadresse immer doppelt, bevor Sie Geld senden.'], + ['E-Rechnung', '**Rechnungsnummer kopieren**, **Kopieren**.'], + ['Blockierter Link', 'Links außer `http` und `https` (zum Beispiel `file:` oder `javascript:`) können nur kopiert, nie geöffnet werden.'], + ['Text und Barcodes', '**Kopieren**. Bei Barcodes wird zusätzlich das Format angezeigt, zum Beispiel EAN-13.'], + ], + }, + }, + { h2: 'Taiwanische E-Rechnungen' }, + { p: 'Eine taiwanische E-Rechnung trägt zwei QR-Codes nebeneinander. Der linke Code enthält Rechnungsnummer, Datum, Beträge und einen Teil der Positionen, der rechte die übrigen Positionen. Findet **Ganzen Bildschirm scannen** oder **Bild öffnen…** beide Codes, werden sie zu einer Rechnung zusammengeführt, und die Detailkarte zeigt Rechnungsnummer, Datum, Zufallscode, Gesamtbetrag, Steuer, die Kennungen von Verkäufer und Käufer sowie alle Positionen. Wird nur der linke Code gefunden, erinnert die Karte Sie daran, auch den rechten zu scannen.' }, + { h2: 'Sensible Daten' }, + { p: 'Schlüssel für die zweistufige Überprüfung und WLAN-Kennwörter sind sensibel. Auch wenn der Verlauf oder **Ergebnis automatisch kopieren** eingeschaltet ist, werden sie nie in den Verlauf geschrieben, nie automatisch kopiert und nie in die Protokolldateien des Programms geschrieben.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'Sicherheit von Links' }, + { p: 'Schädliche QR-Codes führen oft zu gefälschten Websites. QRcode tool untersucht jede Webadresse auf Ihrem Computer, bevor das Ergebnis angezeigt wird, und markiert Auffälligkeiten direkt auf dem Ergebnisetikett und der Detailkarte. Nichts wird online nachgeschlagen, und keine Adresse wird an einen Dienst gesendet.' }, + { h2: 'Vor dem Öffnen den Websitenamen prüfen' }, + { p: 'Das Ergebnisetikett zeigt den tatsächlichen Websitenamen aus der Adresse. Prüfen Sie vor dem Öffnen eines Links, ob es die erwartete Website ist. Links mit Warnung zeigen zuerst ihre Detailkarte mit einem farbigen Hinweis oben, der erklärt, worauf Sie achten sollten.' }, + { fig: 'detail-warning', cap: 'Ein Link mit Warnungen: Ein unverschlüsselter Kurzlink nennt die Gründe und wartet', width: 12 }, + { h2: 'Warnstufen' }, + { + table: { + cols: [18, 82], + head: ['Stufe', 'Was das Programm tut'], + rows: [ + ['Info', 'Zum Beispiel eine sehr lange Adresse. Wird nur auf der Detailkarte genannt; [[Enter]] öffnet den Link direkt.'], + ['Warnung', 'Gelbe Klammern und gelbes Symbol. [[Enter]] oder ein Klick zeigt zuerst die Detailkarte; dann klicken Sie auf **Öffnen**.'], + ['Gefahr', 'Rote Klammern und rotes Symbol. **Öffnen** ist nicht mehr die Standardschaltfläche, und nach dem Klick müssen Sie mit **Trotzdem öffnen** bestätigen.'], + ], + }, + }, + { h2: 'Was geprüft wird' }, + { + table: { + cols: [30, 12, 58], + head: ['Angezeigte Meldung', 'Stufe', 'Erklärung und Rat'], + rows: [ + ['Nicht verschlüsselt (http)', 'Warnung', 'Die Verbindung ist nicht verschlüsselt; Daten können unterwegs gelesen oder verändert werden. Geben Sie auf solchen Seiten keine Kennwörter oder Zahlungsdaten ein.'], + ['Getarnte Adresse', 'Gefahr', 'Ein vertrauenswürdig wirkender Name steht vor einem „@“, der Link führt aber tatsächlich zur Website dahinter, zum Beispiel `https://bank.example.com@login-check.example.net/`.'], + ['Internationaler Domänenname', 'Warnung', 'Die Domäne enthält nicht-lateinische Buchstaben. Die Karte zeigt zusätzlich die tatsächliche codierte Adresse (beginnt mit `xn--`), damit Sie sie prüfen können.'], + ['Ähnlich aussehende Buchstaben', 'Gefahr', 'Ein Teil der Domäne mischt Alphabete, zum Beispiel ein kyrillisches „а“ anstelle eines lateinischen „a“. Ein häufiger Trick gefälschter Websites.'], + ['Reine IP-Adresse', 'Warnung', 'Die Adresse verwendet Zahlen statt eines Websitenamens, was gewöhnliche Websites selten tun.'], + ['Ungewöhnlicher Port', 'Warnung', 'Die Adresse gibt eine nicht standardmäßige Portnummer an.'], + ['Kurzlink', 'Warnung', 'Dienste wie bit.ly verbergen das tatsächliche Ziel. Der Link wird nicht online aufgelöst, weil der Dienst sonst erfahren würde, was Sie gescannt haben. Öffnen Sie Kurzlinks nur aus vertrauenswürdigen Quellen.'], + ['Sehr lange Adresse', 'Info', 'Sehr lange Adressen können den tatsächlichen Websitenamen aus dem Blickfeld schieben.'], + ['Viele codierte Zeichen', 'Info', 'Viele „%“-Escapes können verwendet werden, um den Inhalt einer Adresse zu verschleiern.'], + ['Viele Subdomänen', 'Info', 'Zum Beispiel `login.bank.example.com.secure-check.example.net`, das auf den ersten Blick wie die Website einer Bank aussehen kann.'], + ], + }, + }, + { h2: 'Irreführende Links' }, + { p: 'Bei Links der Stufe **Gefahr** sagt die Detailkarte in Rot, dass der Link irreführend wirkt, und nennt die Gründe. Verlassen Sie sich auf den tatsächlichen Websitenamen auf der Karte, nicht auf den Text, der neben dem Code gedruckt ist.' }, + { fig: 'detail-danger', cap: 'Eine getarnte Adresse: Sie sieht nach einer Bank aus, führt aber zu login-check.example.net', width: 12 }, + { p: 'Wenn Sie sicher sind, dass Sie fortfahren möchten, klicken Sie auf **Öffnen**. Die Karte fragt noch einmal nach; erst **Trotzdem öffnen** öffnet die Seite wirklich.' }, + { h2: 'Vertrauenswürdige Websites und automatisches Öffnen' }, + { p: 'Websites, die Sie oft nutzen, etwa die Domäne Ihrer Schule oder Firma, können Sie zu den vertrauenswürdigen Websites hinzufügen. Ein Link öffnet sich dann direkt nach dem Scan, ohne auf [[Enter]] zu warten, wenn alles Folgende zutrifft:' }, + { + ul: [ + 'Es wurde nur ein Code gefunden.', + 'Der Link hat keine Warnungen.', + 'Die Website (oder eine ihrer Subdomänen) steht auf der Vertrauensliste.', + '**Einstellungen › Scannen › Vertrauenswürdige Websites ohne Nachfrage öffnen** ist eingeschaltet (Standard).', + ], + }, + { p: 'Fügen Sie eine Website mit **Diese Website immer zulassen** auf der Detailkarte eines Links ohne Warnungen hinzu, oder geben Sie die Domäne unter **Einstellungen › Scannen** ein.' }, + { fig: 'detail-link', cap: 'Ein Link ohne Warnungen: Öffnen oder die Website zur Vertrauensliste hinzufügen', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'Schwebende Symbolleiste und Blase' }, + { p: 'Die schwebende Symbolleiste bleibt über anderen Fenstern, sodass jede Funktion nur einen Klick entfernt ist. In gescannten Screenshots erscheint sie nie. Blenden Sie sie mit **Schwebende Symbolleiste** im Menü des Infobereichs, mit [[Ctrl+Alt+E]] oder mit dem Befehl `qrcode-tool toolbar` ein oder aus.' }, + { h2: 'Schaltflächen der Symbolleiste' }, + { fig: 'toolbar-row', cap: 'Horizontale Symbolleiste: Zeigen Sie auf eine Schaltfläche, um darunter Name und Tastenkombination zu sehen', width: 11 }, + { + table: { + cols: [34, 66], + head: ['Schaltfläche', 'Aktion'], + rows: [ + ['(gepunkteter Griff am Anfang)', 'Gedrückt halten und ziehen, um die Symbolleiste zu verschieben.'], + ['Ganzen Bildschirm scannen', 'Wie [[Ctrl+Alt+Q]].'], + ['Bereich auswählen', 'Wie [[Ctrl+Alt+A]].'], + ['Mit Kamera scannen', 'Wie [[Ctrl+Alt+W]]. Ausgegraut, wenn keine Kamera gefunden wird.'], + ['Bild aus Zwischenablage scannen', 'Liest das Bild in der Zwischenablage.'], + ['Bild öffnen…', 'Eine Bilddatei auswählen und scannen.'], + ['QR-Code erstellen…', 'Öffnet den QR-Code-Generator.'], + ['Verlauf', 'Öffnet **Einstellungen › Datenschutz & Verlauf**.'], + ['Einstellungen', 'Öffnet die Einstellungen.'], + ['Benutzerhandbuch (Schaltfläche „?“)', 'Öffnet das PDF-Benutzerhandbuch auf GitHub in einem neuen Browser-Tab, in der Sprache der Oberfläche.'], + ['Zu Blase minimieren', 'Blendet die Symbolleiste aus und zeigt stattdessen die kleine runde Blase.'], + ['Symbolleiste schließen', 'Blendet die Symbolleiste aus (die Blase erscheint nicht). Das Programm läuft im Infobereich weiter.'], + ], + }, + }, + { h2: 'Vertikale Symbolleiste (rechts oder links)' }, + { p: 'Neben der standardmäßigen horizontalen Anordnung oben am Bildschirm kann die Symbolleiste auch eine senkrechte Spalte am rechten oder linken Bildschirmrand sein. Die Spalte braucht weniger Breite, passt gut zu breiten Bildschirmen und lässt den oberen Teil von Webseiten frei.' }, + { + figs: [ + ['toolbar-right', 'Vertikal, rechts (Standardposition der vertikalen Anordnung)'], + ['toolbar-left', 'Vertikal, links'], + ], + cap: 'Vertikale Symbolleiste: Name und Tastenkombination der Schaltfläche unter dem Mauszeiger erscheinen unter den Schaltflächen', + }, + { p: 'So ändern Sie die Anordnung:' }, + { + ol: [ + 'Öffnen Sie **Einstellungen** und wählen Sie **Allgemein**.', + 'Suchen Sie im Abschnitt **Schwebende Symbolleiste und Blase** die Option **Anordnung der Symbolleiste**.', + 'Wählen Sie **Horizontal, oben**, **Vertikal, rechts** oder **Vertikal, links**.', + ], + }, + { p: 'Die Änderung gilt sofort. Die Symbolleiste springt an die Standardposition der neuen Anordnung: horizontal oben in der Mitte, vertikal in der Mitte des gewählten Rands. Danach können Sie sie beliebig verschieben.' }, + { h2: 'Die Symbolleiste verschieben' }, + { p: 'Halten Sie den gepunkteten Griff an einem Ende der Symbolleiste gedrückt und ziehen Sie. Das Programm merkt sich die letzte Position und zeigt die Symbolleiste beim nächsten Mal dort an. Liegt diese Position auf keinem Monitor mehr, etwa nach dem Abziehen eines externen Bildschirms, kehrt die Symbolleiste an ihren Standardplatz zurück.' }, + { h2: 'Die schwebende Blase' }, + { p: 'Die schwebende Blase ist die zusammengeklappte Symbolleiste. Sie belegt nur einen kleinen Kreis und erscheint standardmäßig am rechten Bildschirmrand.' }, + { fig: 'bubble', cap: 'Die schwebende Blase', width: 8 }, + { + table: { + cols: [30, 70], + head: ['Aktion', 'Ergebnis'], + rows: [ + ['Klicken', 'Klappt zur vollständigen schwebenden Symbolleiste auf.'], + ['Etwa eine halbe Sekunde halten', 'Scannt den ganzen Bildschirm.'], + ['Rechtsklick', 'Öffnet ein Menü: **Ganzen Bildschirm scannen**, **Bereich auswählen**, **Mit Kamera scannen**, **Bild aus Zwischenablage scannen**, **Symbolleiste anzeigen**, **Blase ausblenden**.'], + ['Ziehen', 'Verschiebt die Blase.'], + ], + }, + }, + { p: 'Damit die Blase bei jedem Programmstart erscheint, schalten Sie **Einstellungen › Allgemein › Blase beim Start der App anzeigen** ein. Symbolleiste und Blase werden nie gleichzeitig angezeigt.' }, + { h2: 'Bei Vollbild-Apps ausblenden' }, + { p: 'Unter Windows verschwinden Symbolleiste und Blase, während Sie ein Video im Vollbild ansehen, eine Präsentation halten oder spielen, und kehren zurück, wenn Sie den Vollbildmodus verlassen. Sie können das unter **Einstellungen › Allgemein › Bei Vollbild-Apps ausblenden** ausschalten.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'QR-Codes erstellen' }, + { p: 'Der QR-Code-Generator macht aus einem Link oder einem Text einen QR-Code, den Sie mit dem Smartphone scannen oder in Dokumente und Präsentationen einfügen können.' }, + { + ol: [ + 'Wählen Sie **QR-Code erstellen…** im Menü des Infobereichs, in der schwebenden Symbolleiste oder auf dem Scanbildschirm.', + 'Geben Sie den Inhalt unter **Text oder Link** ein oder fügen Sie ihn ein. Der QR-Code erscheint sofort rechts.', + 'Wählen Sie bei Bedarf eine Stufe der **Fehlerkorrektur**.', + 'Klicken Sie auf **Bild kopieren**, um den Code in die Zwischenablage zu kopieren, oder auf **Als PNG speichern…** bzw. **Als SVG speichern…**, um ihn als Datei zu speichern.', + ], + }, + { fig: 'generator', cap: 'Der QR-Code-Generator', width: 13 }, + { h2: 'Fehlerkorrektur' }, + { p: 'Eine höhere Stufe sorgt dafür, dass der Code auch dann lesbar bleibt, wenn ein Teil beschädigt oder von einem Logo verdeckt ist; der Code wird dafür dichter und größer.' }, + { + table: { + cols: [36, 64], + head: ['Stufe', 'Wann verwenden'], + rows: [ + ['Niedrig – kleinster Code', 'Viel Inhalt, der nur auf dem Bildschirm angezeigt wird.'], + ['Mittel – empfohlen', 'Der Standard für den allgemeinen Gebrauch.'], + ['Quartil', 'Codes, die auf Gegenstände gedruckt werden, die verkratzen können.'], + ['Hoch – übersteht Schäden oder ein Logo', 'Wenn ein Logo in die Mitte des Codes kommt oder maximale Robustheit nötig ist.'], + ], + }, + }, + { note: 'Ein QR-Code fasst nur eine begrenzte Menge an Inhalt. Erscheint „Zu viel Text für einen QR-Code“, kürzen Sie den Inhalt oder wählen Sie eine niedrigere Fehlerkorrektur.' }, + { p: '**PNG** eignet sich für Dokumente und Folien; **SVG** ist ein Vektorformat, das auch groß gedruckt scharf bleibt. Mit [[Esc]] schließen Sie den Generator.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: 'Einstellungen' }, + { p: 'Wählen Sie **Einstellungen** im Menü des Infobereichs, in der schwebenden Symbolleiste oder auf dem Scanbildschirm. Jede Änderung wird sofort gespeichert und angewendet; eine OK-Schaltfläche gibt es nicht.' }, + { h2: 'Allgemein' }, + { fig: 'settings-general', cap: 'Einstellungen › Allgemein', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Einstellung', 'Beschreibung'], + rows: [ + ['Sprache', 'Sprache von Menüs und Meldungen. Folgt standardmäßig dem Betriebssystem.'], + ['Design', '**Systemeinstellung verwenden**, **Hell** oder **Dunkel**. Die Akzentfarbe des Systems wird automatisch übernommen.'], + ['Mit dem Computer starten', 'Startet bei der Anmeldung unauffällig im Hintergrund, damit die Tastenkombination immer funktioniert.'], + ['Rechtsklickmenü', '(Nur Windows) Fügt Einträge von QRcode tool zu den Kontextmenüs des Desktops und von Bilddateien hinzu. Standardmäßig eingeschaltet; siehe „Windows-Kontextmenü“ in Kapitel 4.'], + ['Anordnung der Symbolleiste', '**Horizontal, oben**, **Vertikal, rechts** oder **Vertikal, links**. Siehe Kapitel 7.'], + ['Blase beim Start der App anzeigen', 'Zeigt die schwebende Blase beim Start.'], + ['Bei Vollbild-Apps ausblenden', '(Nur Windows) Blendet Symbolleiste und Blase bei Vollbild-Videos, Präsentationen und Spielen aus.'], + ['Automatisch nach Updates suchen', 'Fragt GitHub einmal am Tag, ob es eine neue Version gibt. Ohne Ihre Zustimmung wird nichts installiert.'], + ['Willkommensbildschirm erneut anzeigen', 'Öffnet den Willkommensbildschirm des ersten Starts.'], + ], + }, + }, + { h2: 'Scannen' }, + { fig: 'settings-scanning', cap: 'Einstellungen › Scannen', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Einstellung', 'Beschreibung'], + rows: [ + ['Ergebnis automatisch kopieren', 'Wird genau ein Code gefunden, kommt sein Inhalt in die Zwischenablage. Sensible Inhalte werden nie kopiert. Standardmäßig ausgeschaltet.'], + ['Ton abspielen, wenn ein Code gefunden wird', 'Spielt einen kurzen Ton ab. Standardmäßig ausgeschaltet.'], + ['Auch Barcodes lesen', 'Liest zusätzlich zu QR-Codes EAN, UPC, Code 128, Data Matrix, PDF417, Aztec und mehr. Standardmäßig eingeschaltet.'], + ['Vertrauenswürdige Websites ohne Nachfrage öffnen', 'Öffnet Links zu vertrauenswürdigen Websites automatisch unter den in Kapitel 6 genannten Bedingungen.'], + ['Vertrauenswürdige Websites', 'Geben Sie eine Domäne ein (zum Beispiel example.com) und klicken Sie auf **Hinzufügen**. Subdomänen gelten ebenfalls als vertrauenswürdig. Das Papierkorbsymbol entfernt einen Eintrag.'], + ], + }, + }, + { h2: 'Kamera' }, + { fig: 'settings-camera', cap: 'Einstellungen › Kamera', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Einstellung', 'Beschreibung'], + rows: [ + ['Kamera', 'Die zu verwendende Webcam.'], + ['Bild spiegeln', 'Zeigt die Kamera wie einen Spiegel. Die Erkennung funktioniert in beiden Fällen.'], + ['Ergebnisse anzeigen (Sekunden)', 'Wie lange (0 bis 60 Sekunden) ein Ergebnis in der Liste bleibt, nachdem sein Code das Bild verlassen hat. Bei 0 werden nur gerade sichtbare Codes aufgeführt.'], + ['Kamera schließen, nachdem ein Code geöffnet wurde', 'Schließt das Kamerafenster, sobald ein Code geöffnet oder verwendet wurde.'], + ], + }, + }, + { h2: 'Tastenkombinationen' }, + { fig: 'settings-shortcuts', cap: 'Einstellungen › Tastenkombinationen', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['Aktion', 'Standard', 'Beschreibung'], + rows: [ + ['Ganzen Bildschirm scannen', '[[Ctrl+Alt+Q]]', 'Friert alle Monitore ein und scannt sie.'], + ['Bereich auswählen', '[[Ctrl+Alt+A]]', 'Friert den Bildschirm ein, damit Sie einen Rahmen ziehen können.'], + ['Mit Kamera scannen', '[[Ctrl+Alt+W]]', 'Öffnet das Webcam-Fenster.'], + ['Symbolleiste ein-/ausblenden', '[[Ctrl+Alt+E]]', 'Schaltet die schwebende Symbolleiste um.'], + ], + }, + }, + { p: 'So ändern Sie eine Tastenkombination:' }, + { + ol: [ + 'Klicken Sie auf die Tastenkombination, die Sie ändern möchten. Die Schaltfläche zeigt **Tasten drücken… (Esc zum Abbrechen)**.', + 'Drücken Sie die neue Tastenkombination. Sie muss mindestens eine der Tasten [[Ctrl]], [[Alt]], [[Shift]] oder [[Win]] enthalten (auf dem Mac [[Cmd]]).', + 'Die neue Tastenkombination gilt sofort.', + ], + }, + { p: 'Verwendet eine andere App die Kombination bereits, steht in der Zeile „Wird bereits von einer anderen App verwendet – wählen Sie eine andere.“ Wählen Sie dann eine andere Kombination. **Standard wiederherstellen** stellt alle Standard-Tastenkombinationen wieder her. Der Abschnitt **Beim Scannen** unten listet die Tasten des Scanbildschirms auf, dieselben wie in Kapitel 3.' }, + { h2: 'Datenschutz & Verlauf' }, + { fig: 'settings-privacy', cap: 'Einstellungen › Datenschutz & Verlauf (mit eingeschaltetem Verlauf)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Einstellung', 'Beschreibung'], + rows: [ + ['Scanverlauf speichern', 'Wird nur auf diesem Computer gespeichert. WLAN-Kennwörter und Schlüssel für die zweistufige Überprüfung werden nie gespeichert. Standardmäßig ausgeschaltet.'], + ['Anzahl gespeicherter Einträge', '5 bis 500 Einträge. Die ältesten werden zuerst entfernt.'], + ['Letzte Scans', 'Neueste zuerst. Links ohne Warnungen lassen sich mit **Öffnen** erneut öffnen; jeder Eintrag lässt sich mit **Kopieren** kopieren.'], + ['Verlauf löschen', 'Löscht den gesamten Verlauf.'], + ], + }, + }, + { h2: 'Info' }, + { fig: 'settings-about', cap: 'Einstellungen › Info', width: 14 }, + { + ul: [ + 'Zeigt die aktuelle Version. **Nach Updates suchen** prüft sofort.', + 'Links zum Quellcode, zu Problemmeldungen, zur Datenschutzerklärung und zu den Open-Source-Lizenzen.', + '**Einstellungsordner öffnen** und **Protokollordner öffnen** öffnen diese Ordner direkt, etwa um Ihre Einstellungen zu sichern oder Protokolldateien an eine Problemmeldung anzuhängen.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: 'Aktualisieren und deinstallieren' }, + { h2: 'Nach Updates suchen und installieren' }, + { p: 'Mit dem Installationsprogramm installierte Kopien können sich selbst aktualisieren. Ist **Automatisch nach Updates suchen** eingeschaltet, fragt das Programm einmal am Tag bei GitHub nach. Sie können auch jederzeit im Menü des Infobereichs oder unter **Einstellungen › Info** auf **Nach Updates suchen** klicken.' }, + { fig: 'message-update', cap: 'Die Meldung, wenn eine neue Version verfügbar ist', width: 10 }, + { + ol: [ + 'Wenn die Meldung **Update verfügbar** erscheint, klicken Sie auf **Jetzt aktualisieren**.', + 'Die neue Version wird im Hintergrund heruntergeladen, und das Programm startet danach neu.', + 'Klicken Sie auf **Später**, wenn Sie jetzt nicht aktualisieren möchten.', + ], + }, + { p: 'Updates werden erst installiert, nachdem Sie auf **Jetzt aktualisieren** geklickt haben; das Programm installiert nie etwas von sich aus.' }, + { h2: 'Portable Version' }, + { p: 'Die portable Version (`Portable.zip`) aktualisiert sich nicht selbst; die Updatesuche meldet „Updates sind nicht verfügbar“. Laden Sie die neue Version von der GitHub-Release-Seite herunter und ersetzen Sie die alten Dateien. Ihre Einstellungen bleiben erhalten.' }, + { h2: 'Deinstallieren' }, + { + ol: [ + 'Öffnen Sie in Windows **Einstellungen › Apps › Installierte Apps**.', + 'Suchen Sie QRcode tool, klicken Sie auf **…** und wählen Sie **Deinstallieren**.', + 'Der Autostart-Eintrag und die Kontextmenü-Einträge werden ebenfalls entfernt.', + ], + }, + { p: 'Um auch Einstellungen und Verlauf zu entfernen, öffnen Sie vor dem Deinstallieren unter **Einstellungen › Info** den Einstellungsordner und den Protokollordner und löschen Sie sie.' }, + { h2: 'Wo Einstellungen und Protokolle gespeichert sind' }, + { + table: { + cols: [18, 82], + head: ['System', 'Speicherort'], + rows: [ + ['Windows', 'Einstellungen: `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\nVerlauf und Protokolle: `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', 'Einstellungen: `~/.config/qrcode-tool`\nVerlauf und Protokolle: `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: 'Die Einstellungsdatei `settings.toml` ist reiner Text. Kopieren Sie sie, um Ihre Einstellungen auf einen anderen Computer zu übertragen.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'Fehlerbehebung' }, + { + qa: [ + ['Beim Drücken der Tastenkombination passiert nichts.', 'Eine andere App verwendet sie vielleicht schon. Öffnen Sie **Einstellungen › Tastenkombinationen**; steht in der Zeile „Wird bereits von einer anderen App verwendet“, wählen Sie eine andere Kombination. Manche Spiele und Remotedesktop-Programme fangen alle Tasten ab, solange sie im Vordergrund sind.'], + ['Der Scan findet keinen Code.', 'Verwenden Sie **Bereich auswählen** und ziehen Sie den Rahmen nur um den Code, oder vergrößern Sie zuerst die Seite oder das Bild. Siehe „Wenn kein Code gefunden wird“ in Kapitel 3.'], + ['Warum hat sich der Link nicht sofort geöffnet?', 'Ein Link mit Warnung zeigt immer zuerst seine Details, damit Sie die tatsächliche Website prüfen können. Automatisch öffnen sich nur Links zu vertrauenswürdigen Websites ohne jede Warnung, und das nur, wenn sie der einzige gefundene Code sind.'], + ['Es erscheint „Kurzlink – das tatsächliche Ziel ist verborgen“.', 'Kurzlink-Dienste verbergen das tatsächliche Ziel. Das Programm schlägt es nicht online nach, weil das verraten würde, was Sie gescannt haben. Öffnen Sie Kurzlinks nur aus vertrauenswürdigen Quellen.'], + ['Wo ist das Hauptfenster?', 'Es gibt absichtlich keines. Verwenden Sie das Symbol im Infobereich, die Tastenkombination, die schwebende Symbolleiste oder die schwebende Blase.'], + ['QRcode tool fehlt im Kontextmenü.', 'Prüfen Sie, ob **Einstellungen › Allgemein › Rechtsklickmenü** eingeschaltet ist. Unter Windows 11 stehen die Einträge unter **Weitere Optionen anzeigen** (oder halten Sie beim Rechtsklick [[Shift]] gedrückt). **QRcode tool Bild öffnen** erscheint nur, wenn ein Bild ausgewählt ist. Wenn Sie QRcode tool gerade installiert oder die portable Version verschoben haben, starten Sie es einmal.'], + ['Die Symbolleiste ist verschwunden.', 'Drücken Sie [[Ctrl+Alt+E]] oder setzen Sie im Menü des Infobereichs das Häkchen bei **Schwebende Symbolleiste**. Ist **Bei Vollbild-Apps ausblenden** eingeschaltet, bleibt die Symbolleiste verborgen, solange ein Vollbildprogramm im Vordergrund ist.'], + ['Die Kamera startet nicht.', 'Schließen Sie andere Programme, die die Kamera nutzen, und prüfen Sie, ob die Datenschutzeinstellungen des Systems QRcode tool den Kamerazugriff erlauben. Bei mehreren Kameras wählen Sie unter **Einstellungen › Kamera** die richtige aus.'], + ['Das WLAN verbindet sich nicht automatisch.', 'Manche Netzwerke (zum Beispiel mit Unternehmensanmeldung) kann das Programm nicht einrichten. Klicken Sie auf der Detailkarte auf **Kennwort kopieren** und verbinden Sie sich über das WLAN-Menü des Systems.'], + ['Mein Virenschutz warnt.', 'Neue, nicht signierte Programme, die Tastenkombinationen registrieren, den Bildschirm lesen und mit dem Computer starten, werden von verhaltensbasierter Erkennung manchmal markiert. QRcode tool nutzt Standard-Systemschnittstellen, und sein Quellcode ist öffentlich. Melden Sie den Fehlalarm bitte Ihrem Virenschutz-Anbieter oder eröffnen Sie ein Issue auf GitHub.'], + ['Unter macOS ist der Screenshot schwarz.', 'Erlauben Sie QRcode tool unter **Systemeinstellungen › Datenschutz & Sicherheit › Bildschirmaufnahme** und starten Sie das Programm neu. macOS kann nach Systemupdates erneut fragen.'], + ['Unter Linux mit Wayland bewirkt die Tastenkombination nichts.', 'Wayland erlaubt Programmen nicht, globale Tastenkombinationen zu registrieren. Legen Sie in den Tastatureinstellungen des Desktops eine eigene Tastenkombination an, die `qrcode-tool scan-screen` oder einen anderen Befehl ausführt.'], + ['Wie öffne ich dieses Handbuch wieder?', 'Klicken Sie in der schwebenden Symbolleiste auf die Schaltfläche **?** (**Benutzerhandbuch**); die PDF-Ausgabe auf GitHub öffnet sich in einem neuen Browser-Tab. Die Word- und PDF-Dateien liegen außerdem im Ordner `docs/manual` des GitHub-Repositorys.'], + ['Wie melde ich ein Problem?', 'Klicken Sie unter **Einstellungen › Info** auf **Problem melden oder Idee vorschlagen** und beschreiben Sie Ihr System, die Schritte und die angezeigten Meldungen. Sie können Dateien aus dem Protokollordner anhängen; Protokolle enthalten nur Ereignisse und Fehler, nie gescannte Inhalte.'], + ], + }, + + // ───────────────────────── Anhänge ───────────────────────── + { h1: 'Tastenkombinationen auf einen Blick', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['Wo', 'Taste', 'Aktion'], + rows: [ + ['Überall', '[[Ctrl+Alt+Q]]', 'Ganzen Bildschirm scannen'], + ['Überall', '[[Ctrl+Alt+A]]', 'Bereich auswählen'], + ['Überall', '[[Ctrl+Alt+W]]', 'Mit Kamera scannen'], + ['Überall', '[[Ctrl+Alt+E]]', 'Schwebende Symbolleiste ein-/ausblenden'], + ['Scanbildschirm, Vorschau', '[[Enter]]', 'Ausgewählten Code öffnen'], + ['Scanbildschirm, Vorschau', '[[Tab]] / [[Shift+Tab]]', 'Nächsten / vorherigen Code auswählen'], + ['Scanbildschirm, Vorschau', '[[C]]', 'Ausgewählten Code kopieren'], + ['Scanbildschirm', '[[F]] oder [[F5]]', 'Ganzen Bildschirm erneut durchsuchen'], + ['Scanbildschirm, Vorschau, Generator', '[[Esc]]', 'Schließen'], + ], + }, + }, + { p: 'Die globalen Tastenkombinationen lassen sich unter **Einstellungen › Tastenkombinationen** ändern. Die Tabelle zeigt die Standardwerte.' }, + { h1: 'Unterstützte Codes', appendix: true }, + { + table: { + cols: [30, 70], + head: ['Gruppe', 'Formate'], + rows: [ + ['Immer gelesen', 'QR Code, Micro QR Code, rMQR Code'], + ['Mit „Auch Barcodes lesen“', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec und mehr'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['Erkannter Inhalt', 'Beispiel'], + rows: [ + ['Weblink', '`https://example.com/`'], + ['WLAN', '`WIFI:T:WPA;S:Netzwerk;P:Kennwort;;`'], + ['Kontakt', 'vCard (`BEGIN:VCARD`), MeCard (`MECARD:`)'], + ['E-Mail', '`mailto:`, `MATMSG:`'], + ['Telefon und SMS', '`tel:`, `sms:`, `SMSTO:`'], + ['Standort', '`geo:25.0330,121.5654`'], + ['Schlüssel für zweistufige Überprüfung', '`otpauth://`'], + ['Zahlungsadresse', '`bitcoin:`, `ethereum:` und andere'], + ['Taiwanische E-Rechnung', 'Die beiden QR-Codes auf der Rechnung'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.en.js b/docs/manual/build/content.en.js index b2b6695..62917ec 100644 --- a/docs/manual/build/content.en.js +++ b/docs/manual/build/content.en.js @@ -450,7 +450,7 @@ module.exports = { ['Create QR code…', 'Opens the QR code generator.'], ['History', 'Opens **Settings › Privacy & history**.'], ['Settings', 'Opens Settings.'], - ['User manual (“?” button)', 'Opens the PDF user manual on GitHub in a new browser tab: the Traditional Chinese edition when the UI is in Chinese, the English edition otherwise.'], + ['User manual (“?” button)', 'Opens the PDF user manual on GitHub in a new browser tab, in the language of the user interface.'], ['Collapse to bubble', 'Hides the toolbar and shows the small round bubble instead.'], ['Close toolbar', 'Hides the toolbar (the bubble does not appear). The program keeps running in the tray.'], ], diff --git a/docs/manual/build/content.es.js b/docs/manual/build/content.es.js new file mode 100644 index 0000000..741fd25 --- /dev/null +++ b/docs/manual/build/content.es.js @@ -0,0 +1,733 @@ +// Texto del manual de usuario de QRcode tool (español). +// Marcas: **negrita**, [[Tecla]], `código`. Los nombres de figura remiten a shots// (ver figures.js). + +module.exports = { + lang: 'es', + font: 'Segoe UI', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-es', + docTitle: 'Manual de usuario de QRcode tool', + cover: { + title: 'QRcode tool', + subtitle: 'Manual de usuario', + tagline: 'Escanea códigos QR en tu computadora tan fácilmente como con el teléfono.', + edition: 'Versión 1.0.0 | octubre de 2026', + platforms: 'Para Windows 10 (21H2 o posterior) / Windows 11, macOS 13 o posterior y Linux', + }, + back: { + heading: 'Escanea. Comprueba. Después abre.', + body: [ + 'QRcode tool es un escáner de escritorio gratuito y de código abierto. Lee códigos QR y códigos de barras de la pantalla, la cámara web, el portapapeles y los archivos de imagen, y revisa cada dirección web en busca de trucos habituales antes de abrir nada.', + 'Todo ocurre en tu computadora. El programa no recopila datos de uso y nunca envía a internet lo que escaneas.', + ], + links: [ + ['Página del proyecto', 'https://github.com/naritaroad/qrcode-tool'], + ['Última versión', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['Informar de un problema', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: 'El software se publica bajo la licencia MIT o Apache-2.0. Este manual puede copiarse y adaptarse en las mismas condiciones.', + trademark: 'QR Code es una marca registrada de DENSO WAVE INCORPORATED. QRcode tool no está afiliado a DENSO WAVE, Google ni Microsoft.', + }, + labels: { + toc: 'Contenido', + chapter: (n) => `Capítulo ${n}`, + appendix: (l) => `Apéndice ${l}`, + figure: (id) => `Figura ${id}`, + tip: 'Consejo', + note: 'Nota', + header: 'Manual de usuario de QRcode tool', + tocHint: '(En Word, haz clic derecho en la tabla de contenido y elige Actualizar campos para refrescar los números de página).', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'Presentación de QRcode tool' }, + { p: 'QRcode tool es un pequeño programa de escritorio que espera en la bandeja del sistema y lee códigos QR y códigos de barras de la pantalla. Al pulsar su método abreviado, la pantalla se congela un momento y cada código recibe una etiqueta de resultado que muestra qué tipo de contenido tiene y, en el caso de los enlaces, el nombre real del sitio. Pulsa [[Enter]] o haz clic en la etiqueta para abrir el enlace, conectarte a la red Wi-Fi o guardar el contacto.' }, + { p: 'También lee códigos que muestras a la cámara web, imágenes del portapapeles y archivos de imagen, e incluye un sencillo generador de códigos QR.' }, + { h2: 'Funciones principales' }, + { + table: { + cols: [26, 74], + head: ['Función', 'Descripción'], + rows: [ + ['Escanear toda la pantalla', 'Congela todos los monitores, encuentra cada código automáticamente y lo etiqueta. También funciona con videos y juegos.'], + ['Seleccionar área', 'Arrastra un recuadro alrededor de un solo código. Úsalo con códigos demasiado pequeños, borrosos o inclinados para encontrarlos automáticamente.'], + ['Cámara web', 'Acerca a la cámara un código impreso o la pantalla de un teléfono; el resultado aparece en cuanto se reconoce el código.'], + ['Portapapeles y archivos de imagen', 'Lee una captura de pantalla que acabas de copiar o archivos PNG, JPEG, BMP, GIF y WebP.'], + ['Entiende el contenido', 'Reconoce enlaces web, Wi-Fi, contactos, correo electrónico, números de teléfono, mensajes de texto, ubicaciones, claves de verificación en dos pasos, direcciones de pago y facturas electrónicas de Taiwán, y ofrece los botones correspondientes.'], + ['Comprobaciones de seguridad', 'Antes de abrir un enlace se comprueba si usa una conexión sin cifrar, una dirección disfrazada, letras parecidas, una dirección IP, un enlace acortado u otros trucos habituales. Todo se comprueba sin conexión.'], + ['Crear códigos QR', 'Convierte un texto o un enlace en un código QR que puedes copiar o guardar como PNG o SVG.'], + ['Barra de herramientas y burbuja flotantes', 'Una barra que se coloca en la parte superior de la pantalla (horizontal) o en el borde derecho o izquierdo (vertical), y que se contrae en una pequeña burbuja redonda.'], + ['Idiomas', 'Inglés, chino tradicional, chino simplificado, japonés, coreano, español, portugués (Brasil), francés, alemán y ruso.'], + ], + }, + }, + { h2: 'Requisitos del sistema' }, + { + table: { + cols: [30, 70], + head: ['Sistema operativo', 'Requisitos y notas'], + rows: [ + ['Windows', 'Windows 10 21H2 o posterior, Windows 11. x64 y ARM64. No se necesitan permisos de administrador para instalarlo.'], + ['macOS', 'macOS 13 o posterior (Apple silicon e Intel). El primer escaneo requiere el permiso de Grabación de pantalla, y el escaneo con la cámara web, el permiso de Cámara.'], + ['Linux', 'Todas las funciones en X11. En Wayland, el escaneo se inicia con un atajo de teclado que configuras en los ajustes del escritorio (ver el capítulo 4).'], + ['Hardware', 'Cualquier computadora de oficina normal. La cámara web es opcional. En reposo, el programa usa menos de unos 30 MB de memoria.'], + ], + }, + }, + { h2: 'Principios de privacidad y seguridad' }, + { + ul: [ + 'La decodificación y la comprobación de enlaces se hacen en tu computadora. El contenido escaneado nunca se sube y no se consulta a ningún servicio web la reputación de una dirección.', + 'La única conexión de red es la búsqueda automática de actualizaciones, que es opcional y solo pregunta a GitHub si existe una versión más nueva.', + 'El historial de escaneos está desactivado de forma predeterminada. Aunque lo actives, las contraseñas Wi-Fi y las claves de verificación en dos pasos nunca se guardan.', + 'Solo se pueden abrir direcciones `http` y `https`. Los demás tipos de enlace solo se pueden copiar; nunca se pasan al sistema.', + 'Un enlace con advertencia siempre muestra primero sus detalles y te espera.', + ], + }, + { h2: 'Convenciones de este manual' }, + { + ul: [ + 'Los botones, opciones y nombres de ventana aparecen en **negrita**, por ejemplo **Configuración** o **Escanear toda la pantalla**.', + 'Las teclas se muestran como teclas, por ejemplo [[Enter]] o [[Ctrl+Alt+Q]].', + '**Configuración › General** significa: abre la ventana **Configuración** y elige la página **General** a la izquierda.', + 'Las imágenes muestran Windows 11. macOS y Linux funcionan igual; solo cambia el aspecto de los marcos de ventana y los menús del sistema.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'Instalación y primer inicio' }, + { h2: 'Descargar e instalar (Windows)' }, + { + ol: [ + 'Abre la página de versiones en GitHub (https://github.com/naritaroad/qrcode-tool/releases/latest).', + 'Descarga `QRcodeTool-win-x64-Setup.exe` para la mayoría de las computadoras, o `QRcodeTool-win-arm64-Setup.exe` para equipos con procesador ARM.', + 'Ejecuta el archivo descargado. QRcode tool se instala solo para tu cuenta de usuario y no necesita permisos de administrador.', + 'Al terminar la instalación, QRcode tool se inicia y muestra la pantalla de bienvenida.', + ], + }, + { tip: 'Si prefieres no instalar nada, descarga el archivo `Portable.zip`, descomprímelo y ejecuta el programa directamente. La versión portátil no se puede actualizar sola.' }, + { h2: 'Si Windows muestra “Windows protegió su PC”' }, + { p: 'Las versiones actuales aún no tienen firma de código, por lo que Windows SmartScreen puede advertir de un editor desconocido. Es habitual en programas nuevos sin firmar.' }, + { + ol: [ + 'En la advertencia, haz clic en **Más información**.', + 'Comprueba que el nombre de la aplicación es QRcode tool y haz clic en **Ejecutar de todas formas**.', + ], + }, + { p: 'Para asegurarte de que la descarga no se ha modificado, ejecuta el siguiente comando en PowerShell y compara el resultado con el archivo `SHA256SUMS` de la página de la versión:' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS y Linux' }, + { p: '**macOS:** descarga e instala el archivo `.pkg`. Las versiones aún no están notarizadas por Apple, así que la primera vez haz clic derecho en la aplicación y elige **Abrir**. En el primer escaneo, permite QRcode tool en **Ajustes del Sistema › Privacidad y seguridad › Grabación de pantalla**, y en **Cámara** si quieres usar la cámara web.' }, + { p: '**Linux:** descarga el archivo `.AppImage`, hazlo ejecutable y ejecútalo. GNOME necesita la extensión “AppIndicator and KStatusNotifierItem Support” para mostrar iconos en la bandeja.' }, + { h2: 'La pantalla de bienvenida' }, + { p: 'La pantalla de bienvenida aparece en el primer inicio. Muestra las tres formas de escaneo más habituales, con sus métodos abreviados, y explica que los enlaces nunca se abren por sorpresa.' }, + { fig: 'welcome', cap: 'La pantalla de bienvenida en el primer inicio', width: 11 }, + { + ul: [ + '**Idioma:** sigue al sistema operativo de forma predeterminada. Un cambio aquí se aplica de inmediato.', + '**Iniciar con el equipo:** activado de forma predeterminada para que el método abreviado esté siempre listo. Puedes desactivarlo aquí o más tarde en **Configuración › General**.', + '**Pruébalo ahora:** cierra la pantalla de bienvenida y escanea toda la pantalla una vez.', + '**Cerrar:** cierra la pantalla de bienvenida y muestra la barra de herramientas flotante.', + ], + }, + { p: 'Para volver a ver la pantalla de bienvenida, abre **Configuración › General** y haz clic en **Volver a mostrar la pantalla de bienvenida**.' }, + { h2: 'El icono de la bandeja' }, + { p: 'QRcode tool no tiene una ventana principal tradicional. Después de iniciarse, su icono aparece en la bandeja del sistema, en el extremo derecho de la barra de tareas, y desde ahí se llega a todas las funciones.' }, + { + ul: [ + '**Clic en el icono:** escanea toda la pantalla al instante.', + '**Clic derecho:** abre el menú (figura 2-2).', + '**Pasar el puntero sobre el icono:** muestra el método abreviado de escaneo actual.', + ], + }, + { fig: 'tray-menu', cap: 'El menú del icono de la bandeja', width: 11 }, + { tip: 'Windows puede ocultar los iconos nuevos de la bandeja detrás de la flecha “^”. Arrastra el icono a la barra de tareas para que quede siempre visible.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: 'Escanear la pantalla' }, + { h2: 'Escanear toda la pantalla' }, + { + ol: [ + 'Asegúrate de que la página web, el documento, el video o la imagen con el código QR esté visible.', + 'Pulsa [[Ctrl+Alt+Q]], haz clic en el icono de la bandeja o haz clic en **Escanear toda la pantalla** en la barra flotante.', + 'La pantalla se congela y se oscurece. Tras un breve barrido, cada código encontrado recibe una etiqueta de resultado.', + 'Pulsa [[Enter]] para abrir el código seleccionado o haz clic en la etiqueta que quieras.', + 'Pulsa [[Esc]] o haz clic derecho para salir de la pantalla de escaneo.', + ], + }, + { fig: 'scan-screen', cap: 'Escanear toda la pantalla: cada código recibe una etiqueta; el primero queda seleccionado' }, + { p: 'El indicador de estado de la parte superior muestra cuántos códigos se encontraron. El color de los corchetes que rodean cada código indica el resultado de las comprobaciones:' }, + { + table: { + cols: [22, 78], + head: ['Color de los corchetes', 'Significado'], + rows: [ + ['Blanco', 'No se encontró nada sospechoso.'], + ['Color de énfasis (azul)', 'El código seleccionado. [[Enter]] lo abre.'], + ['Amarillo', 'Hay algo que merece atención, por ejemplo un enlace http sin cifrar o un enlace acortado. El motivo aparece bajo la etiqueta.'], + ['Rojo', 'El enlace parece engañoso, por ejemplo una dirección disfrazada o un dominio que mezcla alfabetos.'], + ], + }, + }, + { p: 'Como la pantalla está congelada, también se pueden leer códigos de videos, presentaciones y juegos. Con varios monitores, se escanean todos a la vez.' }, + { h2: 'Seleccionar un área' }, + { p: 'Cuando un código es pequeño, borroso o está inclinado, o cuando hay muchos códigos en la pantalla, dibuja un recuadro solo alrededor del que necesitas. El área seleccionada se amplía antes de leerla, lo que funciona mejor que escanear toda la pantalla con códigos difíciles.' }, + { + ol: [ + 'Pulsa [[Ctrl+Alt+A]] o elige **Seleccionar área** en el menú de la bandeja o en la barra flotante.', + 'La pantalla se congela y el puntero se convierte en una cruz. Mantén pulsado el botón izquierdo del mouse y arrastra un recuadro alrededor del código.', + 'Suelta el botón. Solo se lee el contenido del recuadro.', + ], + }, + { fig: 'scan-region', cap: 'Seleccionar área: mientras arrastras se muestra el tamaño del recuadro' }, + { tip: 'Haz el recuadro un poco más grande que el código; un margen vacío alrededor ayuda. Si aparece el mensaje “No hay ningún código en esa área”, dibuja un recuadro algo mayor.' }, + { h2: 'La barra de la pantalla de escaneo' }, + { p: 'La pantalla de escaneo tiene una fila de botones en la parte superior. De izquierda a derecha: **Escanear toda la pantalla**, **Seleccionar área**, **Escanear con la cámara**, **Escanear imagen del portapapeles**, **Abrir imagen…**, **Crear código QR…**, **Historial**, **Configuración** y **Cerrar**. Puedes cambiar de método sin salir de la pantalla de escaneo, por ejemplo de toda la pantalla a un área seleccionada. Pasa el puntero sobre un botón para ver su descripción y su método abreviado.' }, + { h2: 'Teclado' }, + { p: 'La pantalla de escaneo se puede usar por completo con el teclado:' }, + { + table: { + cols: [30, 70], + head: ['Tecla', 'Acción'], + rows: [ + ['[[Enter]]', 'Abrir el código seleccionado.'], + ['[[Tab]], [[→]], [[↓]]', 'Seleccionar el código siguiente.'], + ['[[Shift+Tab]], [[←]], [[↑]]', 'Seleccionar el código anterior.'], + ['[[C]]', 'Copiar el código seleccionado.'], + ['[[F]] o [[F5]]', 'Volver a buscar en toda la pantalla.'], + ['[[Esc]]', 'Cancelar y salir de la pantalla de escaneo (el clic derecho también funciona).'], + ], + }, + }, + { h2: 'Si no se encuentra ningún código' }, + { + ul: [ + 'Usa **Seleccionar área** y dibuja un recuadro solo alrededor del código; se amplía antes de leerlo.', + 'Si el código se mueve rápido en un video, pausa primero el video.', + 'Aparta otras ventanas, el puntero del mouse o cualquier cosa que tape parte del código.', + 'Comprueba que **Configuración › Escaneo › Leer también códigos de barras** esté activado si quieres leer códigos de barras y formatos como Data Matrix.', + 'Si el código es muy pequeño en la pantalla (menos de unos 40 píxeles de ancho), amplía primero la página o la imagen.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'Otras formas de escanear' }, + { h2: 'Cámara web' }, + { p: 'Usa la cámara web para códigos en papel, tarjetas de visita o la pantalla de otro teléfono.' }, + { + ol: [ + 'Pulsa [[Ctrl+Alt+W]] o elige **Escanear con la cámara**.', + 'Acerca el código a la cámara, a unos 15–30 cm de distancia.', + 'Cuando se reconoce un código, aparecen corchetes a su alrededor y su etiqueta de resultado se coloca en una lista fija en la parte inferior de la imagen.', + 'Haz clic en la etiqueta, o selecciónala con [[Tab]] y pulsa [[Enter]].', + ], + }, + { fig: 'camera', cap: 'Escanear con la cámara: los resultados permanecen en una lista fija en la parte inferior', width: 13 }, + { + ul: [ + 'Un código debe verse en varios fotogramas seguidos antes de aparecer en la lista, lo que evita lecturas erróneas.', + 'Cuando un código sale de la imagen, su resultado sigue en la lista un tiempo (8 segundos de forma predeterminada) para que aún puedas hacer clic. Cambia el tiempo en **Configuración › Cámara**.', + 'Si hay más de una cámara conectada, cambia entre ellas con la lista de la parte inferior de la ventana.', + 'El interruptor **Espejo** solo cambia cómo se muestra la imagen; el reconocimiento funciona igual.', + 'De forma predeterminada, la ventana de la cámara se cierra después de abrir un código. Puedes cambiarlo en **Configuración › Cámara**.', + ], + }, + { note: 'Si la cámara no se inicia, cierra otros programas que puedan estar usándola (por ejemplo, videollamadas) y permite que QRcode tool use la cámara en la configuración de privacidad del sistema.' }, + { h2: 'Imagen del portapapeles' }, + { + ol: [ + 'Haz una captura de pantalla del código con [[Win+Shift+S]] u otra herramienta de captura, o copia una imagen de una página web.', + 'Elige **Escanear imagen del portapapeles**.', + 'La imagen se muestra en una ventana de vista previa y cada código encontrado recibe una etiqueta de resultado.', + ], + }, + { p: 'Si no hay ninguna imagen en el portapapeles, el programa te pide que copies primero una captura o una imagen.' }, + { h2: 'Archivos de imagen' }, + { + ol: [ + 'Elige **Abrir imagen…**.', + 'Selecciona un archivo PNG, JPEG, BMP, GIF o WebP.', + 'Haz clic en una etiqueta de resultado en la ventana de vista previa. Los botones de la parte inferior abren otra imagen o escanean el portapapeles.', + ], + }, + { fig: 'image-preview', cap: 'La ventana de vista previa: las etiquetas se colocan sobre los códigos de la imagen', width: 13 }, + { h2: 'Menú contextual de Windows' }, + { p: 'En Windows, QRcode tool puede añadir sus funciones principales al menú contextual (clic derecho) del Explorador de archivos: haz clic derecho en el fondo del escritorio para escanear la pantalla, o en una imagen para escanear ese archivo, sin abrir la barra ni recordar un método abreviado.' }, + { + figs: [ + ['shell-desktop', 'Clic derecho en el fondo del escritorio'], + ['shell-image', 'Clic derecho en una imagen'], + ], + cap: 'Entradas de QRcode tool en el menú contextual (Windows 11, Mostrar más opciones)', + }, + { h3: 'Activar o desactivar el menú contextual' }, + { p: 'El menú contextual está **activado** de forma predeterminada: las entradas aparecen en cuanto QRcode tool se ha instalado e iniciado una vez. Si lo desactivaste antes, vuelve a activarlo así:' }, + { + ol: [ + 'Abre **Configuración** desde el menú de la bandeja o la barra flotante.', + 'Elige **General** a la izquierda.', + 'Activa **Menú del clic derecho**. El cambio se aplica de inmediato; no hace falta reiniciar la computadora ni el Explorador de archivos.', + ], + }, + { p: 'Desactiva el mismo interruptor para quitar las entradas. Se guardan en tu propia configuración de usuario (la parte HKEY_CURRENT_USER del registro), así que no se necesitan permisos de administrador y no afectan a otras cuentas de la computadora.' }, + { h3: 'Abrir el menú' }, + { + ul: [ + '**Windows 11:** haz clic derecho y elige **Mostrar más opciones** al final; las entradas de QRcode tool están en el menú completo. Para abrir el menú completo directamente, mantén pulsada [[Shift]] al hacer clic derecho o pulsa [[Shift+F10]].', + '**Windows 10:** las entradas de QRcode tool aparecen en cuanto haces clic derecho.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['Entrada del menú', 'Dónde', 'Acción'], + rows: [ + ['QRcode tool Escanear pantalla', 'Fondo del escritorio', 'Escanea toda la pantalla (como [[Ctrl+Alt+Q]]).'], + ['QRcode tool Escanear selección', 'Fondo del escritorio', 'Congela la pantalla para que selecciones un área (como [[Ctrl+Alt+A]]).'], + ['QRcode tool Escanear con la cámara', 'Fondo del escritorio', 'Abre la cámara web (como [[Ctrl+Alt+W]]).'], + ['QRcode tool Barra de herramientas', 'Fondo del escritorio', 'Muestra la barra de herramientas flotante.'], + ['QRcode tool Abrir imagen', 'Archivos de imagen', 'Escanea la imagen en la ventana de vista previa. Se admiten PNG, JPEG, BMP, GIF y WebP.'], + ], + }, + }, + { + ul: [ + 'Las cuatro entradas del escritorio están agrupadas al final del menú entre separadores, con el icono de QRcode tool.', + '**QRcode tool Abrir imagen** solo aparece cuando hay exactamente **una** imagen seleccionada, no con varios archivos a la vez.', + 'Las entradas usan el idioma de QRcode tool. Al cambiar **Configuración › General › Idioma**, el menú también se actualiza.', + 'Si QRcode tool no se está ejecutando, al elegir una entrada se inicia y realiza la función; si ya se está ejecutando, el programa abierto atiende la petición.', + 'Con la versión portátil, las entradas apuntan a la ubicación actual del programa. Si mueves la carpeta portátil, inicia el programa una vez para que se actualicen.', + 'Al desinstalar QRcode tool se quitan las entradas. macOS y Linux no tienen entradas en el menú contextual; usa los métodos abreviados o la línea de comandos.', + ], + }, + { tip: 'Si QRcode tool no aparece en el menú: comprueba que **Configuración › General › Menú del clic derecho** esté activado, elige **Mostrar más opciones** en Windows 11 e inicia QRcode tool una vez si acabas de instalarlo o moverlo.' }, + { h2: 'Línea de comandos' }, + { p: 'Todas las funciones de escaneo se pueden iniciar con un comando. Si el programa ya se está ejecutando, el comando se le pasa a él. Esto es especialmente útil en Linux con Wayland: asigna los comandos a atajos personalizados en la configuración de teclado del escritorio.' }, + { + table: { + cols: [42, 58], + head: ['Comando', 'Acción'], + rows: [ + ['`qrcode-tool`', 'Inicia el programa o, si ya se está ejecutando, muestra la barra flotante.'], + ['`qrcode-tool scan-screen`', 'Escanea toda la pantalla.'], + ['`qrcode-tool scan-region`', 'Congela la pantalla y selecciona un área.'], + ['`qrcode-tool scan-camera`', 'Escanea con la cámara web.'], + ['`qrcode-tool scan-clipboard`', 'Escanea la imagen del portapapeles.'], + ['`qrcode-tool scan-file ARCHIVO`', 'Escanea un archivo de imagen en la ventana de vista previa.'], + ['`qrcode-tool toolbar`', 'Muestra u oculta la barra de herramientas flotante.'], + ['`qrcode-tool bubble`', 'Muestra u oculta la burbuja flotante.'], + ['`qrcode-tool generate "TEXTO"`', 'Abre el generador de códigos QR con el texto ya escrito.'], + ['`qrcode-tool settings`', 'Abre la configuración.'], + ['`qrcode-tool decode ARCHIVO… [--json]`', 'Muestra en la terminal los códigos de los archivos de imagen sin abrir la interfaz.'], + ['`qrcode-tool quit`', 'Cierra el programa en ejecución.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: 'Resultados y detalles' }, + { h2: 'Etiquetas de resultado' }, + { p: 'Cada código encontrado recibe una etiqueta de resultado oscura. De izquierda a derecha muestra:' }, + { + ul: [ + '**Icono:** el tipo de contenido, por ejemplo un globo para un enlace, ondas para el Wi-Fi o una persona para un contacto. Los enlaces con advertencia muestran en su lugar un símbolo de advertencia o de peligro.', + '**Texto principal:** para los enlaces, el nombre real del sitio en lugar de la dirección completa; para el Wi-Fi, el nombre de la red; para los contactos, el nombre.', + '**Segunda línea:** el tipo de contenido o el motivo principal de una advertencia.', + '**Botón ›:** siempre abre la tarjeta de detalles, sea cual sea el contenido.', + ], + }, + { h2: 'Qué hace Enter o un clic' }, + { + table: { + cols: [36, 64], + head: ['Contenido', 'Acción'], + rows: [ + ['Enlace sin advertencias', 'Se abre en el navegador predeterminado.'], + ['Enlace con advertencia', 'Primero se muestra la tarjeta de detalles; el enlace solo se abre cuando lo confirmas.'], + ['Todo lo demás', 'Se muestra la tarjeta de detalles, donde eliges qué hacer.'], + ], + }, + }, + { h2: 'La tarjeta de detalles' }, + { p: 'La tarjeta de detalles enumera todos los campos del código y ofrece botones adecuados al contenido. El botón de copiar junto a un campo copia solo ese campo. Los campos sensibles, como las contraseñas, se ocultan como “••••”; el botón del candado los muestra un momento. Haz clic fuera de la tarjeta o en **Cerrar** para volver a los resultados.' }, + { fig: 'detail-wifi', cap: 'Tarjeta de detalles de un código Wi-Fi: Conectar se une a la red', width: 12 }, + { h2: 'Botones según el tipo de contenido' }, + { + table: { + cols: [30, 70], + head: ['Tipo', 'Botones'], + rows: [ + ['Enlace', '**Abrir**, **Copiar**. Los enlaces sin advertencias a sitios en los que aún no confías también ofrecen **Permitir siempre este sitio**.'], + ['Red Wi-Fi', '**Conectar** (el sistema crea el perfil de red), **Copiar contraseña**.'], + ['Contacto (vCard, MeCard)', '**Guardar contacto** (guarda un archivo .vcf que puedes importar a tu libreta de direcciones), **Copiar**.'], + ['Correo electrónico', '**Escribir correo** (abre tu programa de correo predeterminado), **Copiar**.'], + ['Número de teléfono', '**Llamar** (se pasa a la aplicación de llamadas del sistema), **Copiar**.'], + ['Mensaje de texto', '**Enviar mensaje**, **Copiar**.'], + ['Ubicación', '**Abrir mapa**, **Copiar**.'], + ['Clave de verificación en dos pasos', 'Solo se muestran el nombre del servicio y la cuenta; está disponible **Copiar**. El secreto nunca se muestra ni se guarda.'], + ['Dirección de pago', '**Copiar**. Comprueba siempre una dirección de pago antes de enviar dinero.'], + ['Factura electrónica', '**Copiar número de factura**, **Copiar**.'], + ['Enlace bloqueado', 'Los enlaces que no son `http` ni `https` (por ejemplo `file:` o `javascript:`) solo se pueden copiar, nunca abrir.'], + ['Texto y códigos de barras', '**Copiar**. En los códigos de barras también se muestra el formato, por ejemplo EAN-13.'], + ], + }, + }, + { h2: 'Facturas electrónicas de Taiwán' }, + { p: 'Una factura electrónica de Taiwán tiene dos códigos QR uno al lado del otro. El código izquierdo contiene el número de factura, la fecha, los importes y algunos artículos; el derecho contiene el resto de los artículos. Cuando **Escanear toda la pantalla** o **Abrir imagen…** encuentra los dos códigos, se combinan en una sola factura y la tarjeta de detalles muestra el número de factura, la fecha, el código aleatorio, el total, el impuesto, los identificadores del vendedor y del comprador y todos los artículos. Si solo se encuentra el código izquierdo, la tarjeta te recuerda que escanees también el derecho.' }, + { h2: 'Datos sensibles' }, + { p: 'Las claves de verificación en dos pasos y las contraseñas Wi-Fi son sensibles. Aunque estén activados el historial o **Copiar el resultado automáticamente**, nunca se escriben en el historial, nunca se copian automáticamente y nunca se escriben en los archivos de registro del programa.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'Seguridad de los enlaces' }, + { p: 'Los códigos QR maliciosos suelen llevar a sitios web falsos. QRcode tool analiza cada dirección web en tu computadora antes de mostrar el resultado y marca lo que encuentra directamente en la etiqueta y en la tarjeta de detalles. No se consulta nada en línea ni se envía ninguna dirección a ningún servicio.' }, + { h2: 'Comprueba el nombre del sitio antes de abrir' }, + { p: 'La etiqueta de resultado muestra el nombre real del sitio que contiene la dirección. Antes de abrir cualquier enlace, asegúrate de que es el sitio que esperas. Los enlaces con advertencia muestran primero su tarjeta de detalles, con un aviso de color en la parte superior que explica a qué prestar atención.' }, + { fig: 'detail-warning', cap: 'Un enlace con advertencias: un enlace acortado sin cifrar muestra los motivos y te espera', width: 12 }, + { h2: 'Niveles de advertencia' }, + { + table: { + cols: [18, 82], + head: ['Nivel', 'Qué hace el programa'], + rows: [ + ['Información', 'Por ejemplo, una dirección muy larga. Solo se indica en la tarjeta de detalles; [[Enter]] abre el enlace directamente.'], + ['Advertencia', 'Corchetes e icono amarillos. [[Enter]] o un clic muestran primero la tarjeta de detalles; después haces clic en **Abrir**.'], + ['Peligro', 'Corchetes e icono rojos. **Abrir** deja de ser el botón predeterminado y, tras pulsarlo, debes confirmar con **Abrir de todos modos**.'], + ], + }, + }, + { h2: 'Qué se comprueba' }, + { + table: { + cols: [30, 12, 58], + head: ['Mensaje mostrado', 'Nivel', 'Explicación y consejo'], + rows: [ + ['Sin cifrar (http)', 'Advertencia', 'La conexión no está cifrada, así que los datos pueden leerse o modificarse por el camino. No escribas contraseñas ni datos de pago en esas páginas.'], + ['Dirección disfrazada', 'Peligro', 'Se coloca un nombre de aspecto fiable antes de una “@”, pero el enlace lleva en realidad al sitio que va después, por ejemplo `https://bank.example.com@login-check.example.net/`.'], + ['Nombre de dominio internacional', 'Advertencia', 'El dominio contiene letras no latinas. La tarjeta también muestra la dirección codificada real (empieza por `xn--`) para que puedas comprobarla.'], + ['Letras parecidas', 'Peligro', 'Una parte del dominio mezcla alfabetos, por ejemplo una “а” cirílica en lugar de una “a” latina. Es un truco habitual de los sitios falsos.'], + ['Dirección IP', 'Advertencia', 'La dirección usa números en lugar de un nombre de sitio, algo poco habitual en sitios web normales.'], + ['Puerto inusual', 'Advertencia', 'La dirección indica un número de puerto no estándar.'], + ['Enlace acortado', 'Advertencia', 'Servicios como bit.ly ocultan el destino real. El enlace no se expande en línea, porque eso le diría al servicio qué escaneaste. Abre enlaces acortados solo de fuentes de confianza.'], + ['Dirección muy larga', 'Información', 'Las direcciones muy largas pueden dejar fuera de la vista el nombre real del sitio.'], + ['Muchos caracteres codificados', 'Información', 'Muchas secuencias “%” pueden servir para ocultar lo que contiene una dirección.'], + ['Muchos subdominios', 'Información', 'Por ejemplo `login.bank.example.com.secure-check.example.net`, que a primera vista puede parecer el sitio de un banco.'], + ], + }, + }, + { h2: 'Enlaces engañosos' }, + { p: 'En los enlaces calificados como **Peligro**, la tarjeta de detalles indica en rojo que el enlace parece engañoso y enumera los motivos. Fíate del nombre real del sitio que muestra la tarjeta, no del texto impreso junto al código.' }, + { fig: 'detail-danger', cap: 'Una dirección disfrazada: parece un banco, pero lleva a login-check.example.net', width: 12 }, + { p: 'Si estás seguro de que quieres continuar, haz clic en **Abrir**. La tarjeta pregunta una vez más; solo **Abrir de todos modos** abre realmente la página.' }, + { h2: 'Sitios de confianza y apertura automática' }, + { p: 'Puedes añadir a los sitios de confianza los que usas a menudo, como el dominio de tu escuela o tu empresa. Entonces un enlace se abre justo después del escaneo, sin esperar a [[Enter]], cuando se cumple todo esto:' }, + { + ul: [ + 'Solo se encontró un código.', + 'El enlace no tiene advertencias.', + 'El sitio (o uno de sus subdominios) está en la lista de confianza.', + '**Configuración › Escaneo › Abrir sitios de confianza sin preguntar** está activado (opción predeterminada).', + ], + }, + { p: 'Añade un sitio con **Permitir siempre este sitio** en la tarjeta de detalles de un enlace sin advertencias, o escribe el dominio en **Configuración › Escaneo**.' }, + { fig: 'detail-link', cap: 'Un enlace sin advertencias: ábrelo o añade el sitio a la lista de confianza', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'Barra de herramientas y burbuja flotantes' }, + { p: 'La barra de herramientas flotante se mantiene sobre las demás ventanas para que cada función esté a un clic. Nunca aparece en las capturas que se escanean. Muéstrala u ocúltala con **Barra de herramientas flotante** en el menú de la bandeja, el método abreviado [[Ctrl+Alt+E]] o el comando `qrcode-tool toolbar`.' }, + { h2: 'Botones de la barra' }, + { fig: 'toolbar-row', cap: 'Barra horizontal: pasa el puntero sobre un botón para ver debajo su nombre y su método abreviado', width: 11 }, + { + table: { + cols: [34, 66], + head: ['Botón', 'Acción'], + rows: [ + ['(asa punteada del principio)', 'Mantén pulsado y arrastra para mover la barra.'], + ['Escanear toda la pantalla', 'Igual que [[Ctrl+Alt+Q]].'], + ['Seleccionar área', 'Igual que [[Ctrl+Alt+A]].'], + ['Escanear con la cámara', 'Igual que [[Ctrl+Alt+W]]. Aparece atenuado cuando no se encuentra ninguna cámara.'], + ['Escanear imagen del portapapeles', 'Lee la imagen del portapapeles.'], + ['Abrir imagen…', 'Elige un archivo de imagen y escanéalo.'], + ['Crear código QR…', 'Abre el generador de códigos QR.'], + ['Historial', 'Abre **Configuración › Privacidad e historial**.'], + ['Configuración', 'Abre la configuración.'], + ['Manual de usuario (botón “?”)', 'Abre el manual de usuario en PDF de GitHub en una pestaña nueva del navegador, en el idioma de la interfaz.'], + ['Contraer en burbuja', 'Oculta la barra y muestra en su lugar la pequeña burbuja redonda.'], + ['Cerrar barra de herramientas', 'Oculta la barra (la burbuja no aparece). El programa sigue ejecutándose en la bandeja.'], + ], + }, + }, + { h2: 'Barra vertical (derecha o izquierda)' }, + { p: 'Además de la disposición horizontal predeterminada en la parte superior de la pantalla, la barra puede ser una columna vertical en el borde derecho o izquierdo. La columna ocupa menos ancho, lo que conviene en pantallas anchas y deja libre la parte superior de las páginas web.' }, + { + figs: [ + ['toolbar-right', 'Vertical, a la derecha (posición vertical predeterminada)'], + ['toolbar-left', 'Vertical, a la izquierda'], + ], + cap: 'Barra vertical: el nombre y el método abreviado del botón señalado aparecen bajo los botones', + }, + { p: 'Para cambiar la disposición:' }, + { + ol: [ + 'Abre **Configuración** y elige **General**.', + 'En la sección **Barra de herramientas y burbuja flotantes**, busca **Disposición de la barra**.', + 'Elige **Horizontal, arriba**, **Vertical, a la derecha** o **Vertical, a la izquierda**.', + ], + }, + { p: 'El cambio se aplica de inmediato. La barra se mueve a la posición predeterminada de la nueva disposición: centrada arriba en la horizontal y centrada verticalmente en el borde elegido en la vertical. Después puedes arrastrarla a cualquier lugar.' }, + { h2: 'Mover la barra' }, + { p: 'Mantén pulsada el asa punteada de un extremo de la barra y arrástrala. El programa recuerda la última posición y la vuelve a mostrar ahí. Si esa posición ya no está en ningún monitor, por ejemplo tras desconectar una pantalla externa, la barra vuelve a su lugar predeterminado.' }, + { h2: 'La burbuja flotante' }, + { p: 'La burbuja flotante es la barra contraída. Solo ocupa un pequeño círculo y aparece de forma predeterminada en el borde derecho de la pantalla.' }, + { fig: 'bubble', cap: 'La burbuja flotante', width: 8 }, + { + table: { + cols: [30, 70], + head: ['Acción', 'Resultado'], + rows: [ + ['Clic', 'Se expande en la barra de herramientas flotante completa.'], + ['Mantener pulsado medio segundo', 'Escanea toda la pantalla.'], + ['Clic derecho', 'Abre un menú: **Escanear toda la pantalla**, **Seleccionar área**, **Escanear con la cámara**, **Escanear imagen del portapapeles**, **Mostrar barra de herramientas**, **Ocultar burbuja**.'], + ['Arrastrar', 'Mueve la burbuja.'], + ], + }, + }, + { p: 'Para mostrar la burbuja cada vez que se inicia el programa, activa **Configuración › General › Mostrar la burbuja al iniciar la aplicación**. La barra y la burbuja nunca se muestran a la vez.' }, + { h2: 'Ocultar con aplicaciones en pantalla completa' }, + { p: 'En Windows, la barra y la burbuja se ocultan mientras ves un video a pantalla completa, das una presentación o juegas, y vuelven al salir de la pantalla completa. Desactívalo en **Configuración › General › Ocultar con aplicaciones en pantalla completa**.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'Crear códigos QR' }, + { p: 'El generador de códigos QR convierte un enlace o un texto en un código QR que puedes escanear con un teléfono o colocar en documentos y presentaciones.' }, + { + ol: [ + 'Elige **Crear código QR…** en el menú de la bandeja, la barra flotante o la pantalla de escaneo.', + 'Escribe o pega el contenido en **Texto o enlace**. El código QR aparece a la derecha al instante.', + 'Si hace falta, elige un nivel de **Corrección de errores**.', + 'Haz clic en **Copiar imagen** para copiar el código al portapapeles, o en **Guardar PNG…** o **Guardar SVG…** para guardarlo como archivo.', + ], + }, + { fig: 'generator', cap: 'El generador de códigos QR', width: 13 }, + { h2: 'Corrección de errores' }, + { p: 'Un nivel más alto permite leer el código aunque una parte esté dañada o tapada por un logotipo, pero hace el código más denso y más grande.' }, + { + table: { + cols: [36, 64], + head: ['Nivel', 'Cuándo usarlo'], + rows: [ + ['Baja — código más pequeño', 'Mucho contenido que solo se mostrará en pantalla.'], + ['Media — recomendada', 'La opción predeterminada para uso general.'], + ['Cuartil', 'Códigos impresos en objetos que pueden rayarse.'], + ['Alta — resiste daños o un logotipo', 'Cuando se colocará un logotipo en el centro del código o se necesita la máxima robustez.'], + ], + }, + }, + { note: 'Un código QR solo puede contener una cantidad limitada de contenido. Si aparece “Hay demasiado texto para un código QR”, acorta el contenido o elige un nivel de corrección de errores más bajo.' }, + { p: '**PNG** es práctico para documentos y diapositivas; **SVG** es un formato vectorial que se mantiene nítido al imprimirlo en grande. Pulsa [[Esc]] para cerrar el generador.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: 'Configuración' }, + { p: 'Elige **Configuración** en el menú de la bandeja, la barra flotante o la pantalla de escaneo. Cada cambio se guarda y se aplica de inmediato; no hay botón Aceptar.' }, + { h2: 'General' }, + { fig: 'settings-general', cap: 'Configuración › General', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Opción', 'Descripción'], + rows: [ + ['Idioma', 'Idioma de los menús y mensajes. Sigue al sistema operativo de forma predeterminada.'], + ['Tema', '**Usar la configuración del sistema**, **Claro** u **Oscuro**. El color de énfasis del sistema se aplica automáticamente.'], + ['Iniciar con el equipo', 'Se inicia discretamente en segundo plano al iniciar sesión, para que el método abreviado funcione siempre.'], + ['Menú del clic derecho', '(Solo Windows) Añade entradas de QRcode tool a los menús contextuales del escritorio y de los archivos de imagen. Activado de forma predeterminada; ver “Menú contextual de Windows” en el capítulo 4.'], + ['Disposición de la barra', '**Horizontal, arriba**, **Vertical, a la derecha** o **Vertical, a la izquierda**. Ver el capítulo 7.'], + ['Mostrar la burbuja al iniciar la aplicación', 'Muestra la burbuja flotante al iniciar.'], + ['Ocultar con aplicaciones en pantalla completa', '(Solo Windows) Oculta la barra y la burbuja durante videos, presentaciones y juegos a pantalla completa.'], + ['Buscar actualizaciones automáticamente', 'Pregunta a GitHub una vez al día si hay una versión nueva. No se instala nada sin preguntarte.'], + ['Volver a mostrar la pantalla de bienvenida', 'Abre la pantalla de bienvenida del primer inicio.'], + ], + }, + }, + { h2: 'Escaneo' }, + { fig: 'settings-scanning', cap: 'Configuración › Escaneo', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Opción', 'Descripción'], + rows: [ + ['Copiar el resultado automáticamente', 'Cuando se encuentra exactamente un código, su contenido se copia al portapapeles. El contenido sensible nunca se copia. Desactivado de forma predeterminada.'], + ['Reproducir un sonido al encontrar un código', 'Reproduce un sonido breve. Desactivado de forma predeterminada.'], + ['Leer también códigos de barras', 'Además de los códigos QR, lee EAN, UPC, Code 128, Data Matrix, PDF417, Aztec y más. Activado de forma predeterminada.'], + ['Abrir sitios de confianza sin preguntar', 'Abre automáticamente los enlaces a sitios de confianza en las condiciones indicadas en el capítulo 6.'], + ['Sitios de confianza', 'Escribe un dominio (por ejemplo example.com) y haz clic en **Agregar**. También se confía en sus subdominios. El icono de la papelera quita una entrada.'], + ], + }, + }, + { h2: 'Cámara' }, + { fig: 'settings-camera', cap: 'Configuración › Cámara', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Opción', 'Descripción'], + rows: [ + ['Cámara', 'La cámara web que se usará.'], + ['Reflejar la imagen', 'Muestra la cámara como un espejo. El reconocimiento funciona igual.'], + ['Mantener resultados en pantalla (segundos)', 'Cuánto tiempo (de 0 a 60 segundos) sigue en la lista un resultado después de que el código salga de la imagen. Con 0 solo se listan los códigos visibles.'], + ['Cerrar la cámara después de abrir un código', 'Cierra la ventana de la cámara cuando se ha abierto o usado un código.'], + ], + }, + }, + { h2: 'Métodos abreviados' }, + { fig: 'settings-shortcuts', cap: 'Configuración › Métodos abreviados', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['Acción', 'Predeterminado', 'Descripción'], + rows: [ + ['Escanear toda la pantalla', '[[Ctrl+Alt+Q]]', 'Congela y escanea todos los monitores.'], + ['Seleccionar área', '[[Ctrl+Alt+A]]', 'Congela la pantalla para que arrastres un recuadro.'], + ['Escanear con la cámara', '[[Ctrl+Alt+W]]', 'Abre la ventana de la cámara web.'], + ['Mostrar u ocultar la barra de herramientas', '[[Ctrl+Alt+E]]', 'Muestra u oculta la barra flotante.'], + ], + }, + }, + { p: 'Para cambiar un método abreviado:' }, + { + ol: [ + 'Haz clic en el método abreviado que quieres cambiar. El botón muestra **Presiona teclas… (Esc para cancelar)**.', + 'Pulsa la nueva combinación de teclas. Debe incluir al menos una de [[Ctrl]], [[Alt]], [[Shift]] o [[Win]] (en Mac, [[Cmd]]).', + 'El nuevo método abreviado se aplica de inmediato.', + ], + }, + { p: 'Si otra aplicación ya usa la combinación, la fila indica “Ya lo usa otra aplicación: elige otro.”. Elige otra combinación. **Restaurar valores predeterminados** recupera todos los métodos abreviados predeterminados. La sección **Durante el escaneo** de la parte inferior enumera las teclas de la pantalla de escaneo, las mismas del capítulo 3.' }, + { h2: 'Privacidad e historial' }, + { fig: 'settings-privacy', cap: 'Configuración › Privacidad e historial (con el historial activado)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Opción', 'Descripción'], + rows: [ + ['Guardar un historial de escaneos', 'Se guarda solo en esta computadora. Las contraseñas Wi-Fi y las claves de verificación en dos pasos nunca se guardan. Desactivado de forma predeterminada.'], + ['Número de entradas que se conservan', 'De 5 a 500 entradas. Las más antiguas se eliminan primero.'], + ['Escaneos recientes', 'Los más nuevos primero. Los enlaces sin advertencias pueden volver a abrirse con **Abrir**; cualquier entrada se puede copiar con **Copiar**.'], + ['Borrar historial', 'Elimina todo el historial.'], + ], + }, + }, + { h2: 'Acerca de' }, + { fig: 'settings-about', cap: 'Configuración › Acerca de', width: 14 }, + { + ul: [ + 'Muestra la versión actual. **Buscar actualizaciones** comprueba en ese momento.', + 'Enlaces al código fuente, a los informes de problemas, a la declaración de privacidad y a las licencias de código abierto.', + '**Abrir la carpeta de configuración** y **Abrir la carpeta de registros** abren esas carpetas directamente, para hacer una copia de seguridad de la configuración o adjuntar archivos de registro a un informe de problema.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: 'Actualizar y desinstalar' }, + { h2: 'Buscar e instalar actualizaciones' }, + { p: 'Las copias instaladas con el programa de instalación pueden actualizarse solas. Con **Buscar actualizaciones automáticamente** activado, el programa pregunta a GitHub una vez al día. También puedes hacer clic en **Buscar actualizaciones** en el menú de la bandeja o en **Configuración › Acerca de** cuando quieras.' }, + { fig: 'message-update', cap: 'El mensaje que aparece cuando hay una versión nueva', width: 10 }, + { + ol: [ + 'Cuando aparezca el mensaje **Actualización disponible**, haz clic en **Actualizar ahora**.', + 'La nueva versión se descarga en segundo plano y el programa se reinicia al terminar.', + 'Haz clic en **Más tarde** si no quieres actualizar ahora.', + ], + }, + { p: 'Las actualizaciones solo se instalan después de hacer clic en **Actualizar ahora**; el programa nunca instala nada por su cuenta.' }, + { h2: 'Versión portátil' }, + { p: 'La versión portátil (`Portable.zip`) no se actualiza sola; al buscar actualizaciones se muestra “Las actualizaciones no están disponibles”. Descarga la nueva versión desde la página de versiones de GitHub y reemplaza los archivos antiguos. Tu configuración se conserva.' }, + { h2: 'Desinstalar' }, + { + ol: [ + 'Abre **Configuración › Aplicaciones › Aplicaciones instaladas** de Windows.', + 'Busca QRcode tool, haz clic en **…** y elige **Desinstalar**.', + 'También se quitan la entrada de inicio y las entradas del menú contextual.', + ], + }, + { p: 'Para quitar también tu configuración y tu historial, abre la carpeta de configuración y la de registros desde **Configuración › Acerca de** antes de desinstalar, y elimínalas.' }, + { h2: 'Dónde se guardan la configuración y los registros' }, + { + table: { + cols: [18, 82], + head: ['Sistema', 'Ubicación'], + rows: [ + ['Windows', 'Configuración: `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\nHistorial y registros: `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', 'Configuración: `~/.config/qrcode-tool`\nHistorial y registros: `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: 'El archivo de configuración `settings.toml` es texto sin formato. Cópialo para llevar tu configuración a otra computadora.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'Solución de problemas' }, + { + qa: [ + ['No pasa nada al pulsar el método abreviado.', 'Puede que otra aplicación ya lo use. Abre **Configuración › Métodos abreviados**; si la fila indica “Ya lo usa otra aplicación”, elige otra combinación. Algunos juegos y programas de escritorio remoto capturan todas las teclas mientras están en primer plano.'], + ['El escaneo no encuentra ningún código.', 'Usa **Seleccionar área** y dibuja un recuadro solo alrededor del código, o amplía primero la página o la imagen. Ver “Si no se encuentra ningún código” en el capítulo 3.'], + ['¿Por qué no se abrió el enlace al momento?', 'Un enlace con advertencia siempre muestra primero sus detalles para que compruebes el sitio real. Solo se abren automáticamente los enlaces a sitios de confianza sin ninguna advertencia, y solo cuando son el único código encontrado.'], + ['Dice “Enlace acortado: el destino real está oculto”.', 'Los servicios de enlaces acortados ocultan el destino real. El programa no lo consulta en línea, porque eso revelaría lo que escaneaste. Abre enlaces acortados solo de fuentes de confianza.'], + ['¿Dónde está la ventana principal?', 'No hay ninguna, a propósito. Usa el icono de la bandeja, el método abreviado, la barra de herramientas flotante o la burbuja flotante.'], + ['QRcode tool no aparece en el menú contextual.', 'Comprueba que **Configuración › General › Menú del clic derecho** esté activado. En Windows 11 las entradas están en **Mostrar más opciones** (o mantén pulsada [[Shift]] al hacer clic derecho). **QRcode tool Abrir imagen** solo aparece cuando hay una imagen seleccionada. Si acabas de instalar QRcode tool o moviste la versión portátil, inícialo una vez.'], + ['La barra de herramientas ha desaparecido.', 'Pulsa [[Ctrl+Alt+E]] o marca **Barra de herramientas flotante** en el menú de la bandeja. Con **Ocultar con aplicaciones en pantalla completa** activado, la barra se oculta mientras hay un programa a pantalla completa en primer plano.'], + ['La cámara no se inicia.', 'Cierra otros programas que usen la cámara y comprueba que la configuración de privacidad del sistema permita a QRcode tool usarla. Si tienes varias cámaras, elige la correcta en **Configuración › Cámara**.'], + ['El Wi-Fi no se conecta automáticamente.', 'Algunas redes (por ejemplo, con autenticación empresarial) no pueden configurarse desde el programa. Haz clic en **Copiar contraseña** en la tarjeta de detalles y conéctate desde el menú Wi-Fi del sistema.'], + ['Mi antivirus muestra una advertencia.', 'Los programas nuevos sin firmar que registran métodos abreviados, leen la pantalla y se inician con el equipo a veces se marcan por detección de comportamiento. QRcode tool usa interfaces estándar del sistema y su código fuente es público. Informa del falso positivo a tu proveedor de antivirus o abre una incidencia en GitHub.'], + ['En macOS la captura sale negra.', 'Permite QRcode tool en **Ajustes del Sistema › Privacidad y seguridad › Grabación de pantalla** y reinicia el programa. macOS puede volver a preguntar después de una actualización del sistema.'], + ['En Linux con Wayland el método abreviado no hace nada.', 'Wayland no permite que los programas registren métodos abreviados globales. Añade un atajo personalizado en la configuración de teclado del escritorio que ejecute `qrcode-tool scan-screen` u otro comando.'], + ['¿Cómo vuelvo a abrir este manual?', 'Haz clic en el botón **?** (**Manual de usuario**) de la barra flotante; la edición PDF de GitHub se abre en una pestaña nueva del navegador. Los archivos Word y PDF también están en la carpeta `docs/manual` del repositorio de GitHub.'], + ['¿Cómo informo de un problema?', 'Haz clic en **Informar de un problema o sugerir una idea** en **Configuración › Acerca de** y describe tu sistema, los pasos y los mensajes que viste. Puedes adjuntar archivos de la carpeta de registros; los registros solo contienen eventos y errores, nunca contenido escaneado.'], + ], + }, + + // ───────────────────────── Apéndices ───────────────────────── + { h1: 'Métodos abreviados y teclas de un vistazo', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['Dónde', 'Tecla', 'Acción'], + rows: [ + ['En cualquier lugar', '[[Ctrl+Alt+Q]]', 'Escanear toda la pantalla'], + ['En cualquier lugar', '[[Ctrl+Alt+A]]', 'Seleccionar área'], + ['En cualquier lugar', '[[Ctrl+Alt+W]]', 'Escanear con la cámara'], + ['En cualquier lugar', '[[Ctrl+Alt+E]]', 'Mostrar u ocultar la barra flotante'], + ['Pantalla de escaneo, vista previa', '[[Enter]]', 'Abrir el código seleccionado'], + ['Pantalla de escaneo, vista previa', '[[Tab]] / [[Shift+Tab]]', 'Seleccionar el código siguiente / anterior'], + ['Pantalla de escaneo, vista previa', '[[C]]', 'Copiar el código seleccionado'], + ['Pantalla de escaneo', '[[F]] o [[F5]]', 'Volver a buscar en toda la pantalla'], + ['Pantalla de escaneo, vista previa, generador', '[[Esc]]', 'Cerrar'], + ], + }, + }, + { p: 'Los métodos abreviados globales se pueden cambiar en **Configuración › Métodos abreviados**. La tabla muestra los valores predeterminados.' }, + { h1: 'Códigos compatibles', appendix: true }, + { + table: { + cols: [30, 70], + head: ['Grupo', 'Formatos'], + rows: [ + ['Siempre se leen', 'QR Code, Micro QR Code, rMQR Code'], + ['Con “Leer también códigos de barras”', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec y más'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['Contenido reconocido', 'Ejemplo'], + rows: [ + ['Enlace web', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:red;P:contraseña;;`'], + ['Contacto', 'vCard (`BEGIN:VCARD`), MeCard (`MECARD:`)'], + ['Correo electrónico', '`mailto:`, `MATMSG:`'], + ['Teléfono y mensaje de texto', '`tel:`, `sms:`, `SMSTO:`'], + ['Ubicación', '`geo:25.0330,121.5654`'], + ['Clave de verificación en dos pasos', '`otpauth://`'], + ['Dirección de pago', '`bitcoin:`, `ethereum:` y otras'], + ['Factura electrónica de Taiwán', 'Los dos códigos QR de la factura'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.fr.js b/docs/manual/build/content.fr.js new file mode 100644 index 0000000..03fa6e9 --- /dev/null +++ b/docs/manual/build/content.fr.js @@ -0,0 +1,733 @@ +// Texte du manuel d’utilisation de QRcode tool (français). +// Balises : **gras**, [[Touche]], `code`. Les noms de figure renvoient à shots// (voir figures.js). + +module.exports = { + lang: 'fr', + font: 'Segoe UI', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-fr', + docTitle: 'Manuel d’utilisation de QRcode tool', + cover: { + title: 'QRcode tool', + subtitle: 'Manuel d’utilisation', + tagline: 'Scannez les codes QR sur votre ordinateur aussi facilement qu’avec votre téléphone.', + edition: 'Version 1.0.0 | octobre 2026', + platforms: 'Pour Windows 10 (21H2 ou version ultérieure) / Windows 11, macOS 13 ou version ultérieure et Linux', + }, + back: { + heading: 'Scanner. Vérifier. Puis ouvrir.', + body: [ + 'QRcode tool est un scanner de bureau gratuit et open source. Il lit les codes QR et les codes-barres de l’écran, de la webcam, du Presse-papiers et des fichiers image, et vérifie chaque adresse web à la recherche des pièges courants avant d’ouvrir quoi que ce soit.', + 'Tout se passe sur votre ordinateur. Le programme ne collecte aucune donnée d’utilisation et n’envoie jamais sur internet ce que vous scannez.', + ], + links: [ + ['Page du projet', 'https://github.com/naritaroad/qrcode-tool'], + ['Dernière version', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['Signaler un problème', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: 'Le logiciel est publié sous licence MIT ou Apache-2.0. Ce manuel peut être copié et adapté dans les mêmes conditions.', + trademark: 'QR Code est une marque déposée de DENSO WAVE INCORPORATED. QRcode tool n’est affilié ni à DENSO WAVE, ni à Google, ni à Microsoft.', + }, + labels: { + toc: 'Sommaire', + chapter: (n) => `Chapitre ${n}`, + appendix: (l) => `Annexe ${l}`, + figure: (id) => `Figure ${id}`, + tip: 'Astuce', + note: 'Remarque', + header: 'Manuel d’utilisation de QRcode tool', + tocHint: '(Dans Word, faites un clic droit sur la table des matières et choisissez Mettre à jour les champs pour actualiser les numéros de page.)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'Présentation de QRcode tool' }, + { p: 'QRcode tool est un petit programme de bureau qui attend dans la zone de notification et lit les codes QR et les codes-barres affichés à l’écran. Lorsque vous appuyez sur son raccourci, l’écran se fige un instant et chaque code reçoit une étiquette de résultat qui indique le type de contenu et, pour les liens, le vrai nom du site. Appuyez sur [[Entrée]] ou cliquez sur l’étiquette pour ouvrir le lien, rejoindre le réseau Wi-Fi ou enregistrer le contact.' }, + { p: 'Il lit aussi les codes présentés à la webcam, les images du Presse-papiers et les fichiers image, et comprend un générateur de codes QR simple.' }, + { h2: 'Fonctions principales' }, + { + table: { + cols: [26, 74], + head: ['Fonction', 'Description'], + rows: [ + ['Scanner tout l’écran', 'Fige tous les écrans, trouve automatiquement chaque code et lui attribue une étiquette. Fonctionne aussi avec les vidéos et les jeux.'], + ['Sélectionner une zone', 'Tracez un cadre autour d’un seul code. Utile pour les codes trop petits, flous ou inclinés pour être trouvés automatiquement.'], + ['Webcam', 'Présentez un code imprimé ou l’écran d’un téléphone à la caméra ; le résultat s’affiche dès que le code est reconnu.'], + ['Presse-papiers et fichiers image', 'Lit une capture d’écran que vous venez de copier, ou des fichiers PNG, JPEG, BMP, GIF et WebP.'], + ['Comprend le contenu', 'Reconnaît les liens web, le Wi-Fi, les contacts, les e-mails, les numéros de téléphone, les SMS, les positions géographiques, les clés de vérification en deux étapes, les adresses de paiement et les factures électroniques de Taïwan, et propose les boutons adaptés.'], + ['Contrôles de sécurité des liens', 'Avant l’ouverture d’un lien, le programme recherche les connexions non chiffrées, les adresses déguisées, les lettres similaires, les adresses IP, les liens raccourcis et d’autres pièges courants. Tous les contrôles se font hors ligne.'], + ['Créer des codes QR', 'Transforme un texte ou un lien en code QR que vous pouvez copier ou enregistrer en PNG ou SVG.'], + ['Barre d’outils et bulle flottantes', 'Une barre placée en haut de l’écran (horizontale) ou sur le bord droit ou gauche (verticale), qui peut se réduire en une petite bulle ronde.'], + ['Langues', 'Anglais, chinois traditionnel, chinois simplifié, japonais, coréen, espagnol, portugais (Brésil), français, allemand et russe.'], + ], + }, + }, + { h2: 'Configuration requise' }, + { + table: { + cols: [30, 70], + head: ['Système d’exploitation', 'Exigences et remarques'], + rows: [ + ['Windows', 'Windows 10 21H2 ou version ultérieure, Windows 11. x64 et ARM64. L’installation ne demande pas de droits d’administrateur.'], + ['macOS', 'macOS 13 ou version ultérieure (Apple silicon et Intel). Le premier scan nécessite l’autorisation Enregistrement de l’écran, le scan par webcam l’autorisation Caméra.'], + ['Linux', 'Toutes les fonctions sous X11. Sous Wayland, le scan se lance avec un raccourci clavier que vous définissez dans les réglages du bureau (voir le chapitre 4).'], + ['Matériel', 'N’importe quel ordinateur de bureau ordinaire. La webcam est facultative. Au repos, le programme utilise moins d’environ 30 Mo de mémoire.'], + ], + }, + }, + { h2: 'Principes de confidentialité et de sécurité' }, + { + ul: [ + 'Le décodage et la vérification des liens se font sur votre ordinateur. Le contenu scanné n’est jamais envoyé, et aucun service web n’est interrogé sur la réputation d’une adresse.', + 'La seule connexion réseau est la recherche automatique de mises à jour, facultative, qui demande seulement à GitHub si une version plus récente existe.', + 'L’historique des scans est désactivé par défaut. Même activé, il ne conserve jamais les mots de passe Wi-Fi ni les clés de vérification en deux étapes.', + 'Seules les adresses `http` et `https` peuvent être ouvertes. Les autres types de liens peuvent seulement être copiés ; ils ne sont jamais transmis au système.', + 'Un lien qui présente un avertissement affiche toujours ses détails d’abord et attend votre décision.', + ], + }, + { h2: 'Conventions de ce manuel' }, + { + ul: [ + 'Les boutons, options et noms de fenêtres sont en **gras**, par exemple **Paramètres** ou **Scanner tout l’écran**.', + 'Les touches sont représentées comme des touches, par exemple [[Entrée]] ou [[Ctrl+Alt+Q]].', + '**Paramètres › Général** signifie : ouvrez la fenêtre **Paramètres** et choisissez la page **Général** à gauche.', + 'Les images montrent Windows 11. macOS et Linux fonctionnent de la même façon ; seuls les cadres des fenêtres et les menus du système changent d’aspect.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'Installation et premier démarrage' }, + { h2: 'Télécharger et installer (Windows)' }, + { + ol: [ + 'Ouvrez la page des versions sur GitHub (https://github.com/naritaroad/qrcode-tool/releases/latest).', + 'Téléchargez `QRcodeTool-win-x64-Setup.exe` pour la plupart des ordinateurs, ou `QRcodeTool-win-arm64-Setup.exe` pour les ordinateurs équipés d’un processeur ARM.', + 'Lancez le fichier téléchargé. QRcode tool s’installe uniquement pour votre compte utilisateur et ne demande pas de droits d’administrateur.', + 'À la fin de l’installation, QRcode tool démarre et affiche l’écran d’accueil.', + ], + }, + { tip: 'Si vous préférez ne rien installer, téléchargez le fichier `Portable.zip`, décompressez-le et lancez le programme directement. La version portable ne peut pas se mettre à jour seule.' }, + { h2: 'Si Windows affiche « Windows a protégé votre ordinateur »' }, + { p: 'Les versions actuelles ne sont pas encore signées numériquement ; Windows SmartScreen peut donc signaler un éditeur inconnu. C’est courant pour les nouveaux programmes non signés.' }, + { + ol: [ + 'Dans l’avertissement, cliquez sur **Informations complémentaires**.', + 'Vérifiez que le nom de l’application est QRcode tool, puis cliquez sur **Exécuter quand même**.', + ], + }, + { p: 'Pour vérifier que le téléchargement n’a pas été modifié, exécutez la commande suivante dans PowerShell et comparez le résultat avec le fichier `SHA256SUMS` de la page de la version :' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS et Linux' }, + { p: '**macOS :** téléchargez et installez le fichier `.pkg`. Les versions ne sont pas encore notariées par Apple : la première fois, faites un clic droit sur l’app et choisissez **Ouvrir**. Au premier scan, autorisez QRcode tool dans **Réglages Système › Confidentialité et sécurité › Enregistrement de l’écran**, ainsi que dans **Caméra** si vous voulez utiliser la webcam.' }, + { p: '**Linux :** téléchargez le fichier `.AppImage`, rendez-le exécutable et lancez-le. GNOME a besoin de l’extension « AppIndicator and KStatusNotifierItem Support » pour afficher les icônes de notification.' }, + { h2: 'L’écran d’accueil' }, + { p: 'L’écran d’accueil s’affiche au premier démarrage. Il présente les trois façons de scanner les plus courantes, avec leurs raccourcis, et explique que les liens ne s’ouvrent jamais par surprise.' }, + { fig: 'welcome', cap: 'L’écran d’accueil au premier démarrage', width: 11 }, + { + ul: [ + '**Langue :** suit le système d’exploitation par défaut. Un changement ici s’applique immédiatement.', + '**Démarrer avec l’ordinateur :** activé par défaut pour que le raccourci soit toujours prêt. Vous pouvez le désactiver ici ou plus tard dans **Paramètres › Général**.', + '**Essayer maintenant :** ferme l’écran d’accueil et scanne une fois tout l’écran.', + '**Fermer :** ferme l’écran d’accueil et affiche la barre d’outils flottante.', + ], + }, + { p: 'Pour revoir l’écran d’accueil, ouvrez **Paramètres › Général** et cliquez sur **Afficher à nouveau l’écran d’accueil**.' }, + { h2: 'L’icône de notification' }, + { p: 'QRcode tool n’a pas de fenêtre principale traditionnelle. Une fois démarré, son icône apparaît dans la zone de notification, à l’extrémité droite de la barre des tâches, et toutes les fonctions sont accessibles à partir de là.' }, + { + ul: [ + '**Clic sur l’icône :** scanne tout l’écran immédiatement.', + '**Clic droit :** ouvre le menu (figure 2-2).', + '**Survol de l’icône :** affiche le raccourci de scan actuel.', + ], + }, + { fig: 'tray-menu', cap: 'Le menu de l’icône de notification', width: 11 }, + { tip: 'Windows peut masquer les nouvelles icônes derrière la flèche « ^ ». Faites glisser l’icône sur la barre des tâches pour qu’elle reste visible.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: 'Scanner l’écran' }, + { h2: 'Scanner tout l’écran' }, + { + ol: [ + 'Vérifiez que la page web, le document, la vidéo ou l’image contenant le code QR est visible.', + 'Appuyez sur [[Ctrl+Alt+Q]], cliquez sur l’icône de notification ou cliquez sur **Scanner tout l’écran** dans la barre flottante.', + 'L’écran se fige et s’assombrit. Après un bref balayage, chaque code trouvé reçoit une étiquette de résultat.', + 'Appuyez sur [[Entrée]] pour ouvrir le code sélectionné, ou cliquez sur l’étiquette voulue.', + 'Appuyez sur [[Échap]] ou faites un clic droit pour quitter l’écran de scan.', + ], + }, + { fig: 'scan-screen', cap: 'Scanner tout l’écran : chaque code reçoit une étiquette ; le premier est sélectionné' }, + { p: 'L’indicateur d’état en haut montre combien de codes ont été trouvés. La couleur des crochets autour de chaque code indique le résultat des contrôles :' }, + { + table: { + cols: [22, 78], + head: ['Couleur des crochets', 'Signification'], + rows: [ + ['Blanc', 'Rien de suspect n’a été trouvé.'], + ['Couleur d’accentuation (bleu)', 'Le code sélectionné. [[Entrée]] l’ouvre.'], + ['Jaune', 'Un point mérite votre attention, par exemple un lien http non chiffré ou un lien raccourci. La raison s’affiche sous l’étiquette.'], + ['Rouge', 'Le lien semble trompeur, par exemple une adresse déguisée ou un domaine qui mélange plusieurs alphabets.'], + ], + }, + }, + { p: 'Comme l’écran est figé, les codes des vidéos, des présentations et des jeux peuvent aussi être lus. Avec plusieurs écrans, tous sont scannés en même temps.' }, + { h2: 'Sélectionner une zone' }, + { p: 'Lorsqu’un code est petit, flou ou incliné, ou lorsqu’il y a beaucoup de codes à l’écran, tracez un cadre autour du seul code qui vous intéresse. La zone sélectionnée est agrandie avant d’être lue, ce qui donne de meilleurs résultats qu’un scan de tout l’écran pour les codes difficiles.' }, + { + ol: [ + 'Appuyez sur [[Ctrl+Alt+A]], ou choisissez **Sélectionner une zone** dans le menu de notification ou dans la barre flottante.', + 'L’écran se fige et le pointeur devient une croix. Maintenez le bouton gauche de la souris enfoncé et tracez un cadre autour du code.', + 'Relâchez le bouton. Seul le contenu du cadre est lu.', + ], + }, + { fig: 'scan-region', cap: 'Sélectionner une zone : la taille du cadre s’affiche pendant le tracé' }, + { tip: 'Faites un cadre un peu plus grand que le code ; une marge vide autour aide la lecture. Si le message « Aucun code dans cette zone » apparaît, tracez un cadre légèrement plus grand.' }, + { h2: 'La barre de l’écran de scan' }, + { p: 'L’écran de scan comporte une rangée de boutons en haut. De gauche à droite : **Scanner tout l’écran**, **Sélectionner une zone**, **Scanner avec la caméra**, **Scanner l’image du Presse-papiers**, **Ouvrir une image…**, **Créer un code QR…**, **Historique**, **Paramètres** et **Fermer**. Vous pouvez changer de méthode sans quitter l’écran de scan, par exemple passer de tout l’écran à une zone sélectionnée. Survolez un bouton pour voir sa description et son raccourci.' }, + { h2: 'Clavier' }, + { p: 'L’écran de scan s’utilise entièrement au clavier :' }, + { + table: { + cols: [30, 70], + head: ['Touche', 'Action'], + rows: [ + ['[[Entrée]]', 'Ouvrir le code sélectionné.'], + ['[[Tab]], [[→]], [[↓]]', 'Sélectionner le code suivant.'], + ['[[Maj+Tab]], [[←]], [[↑]]', 'Sélectionner le code précédent.'], + ['[[C]]', 'Copier le code sélectionné.'], + ['[[F]] ou [[F5]]', 'Relancer la recherche sur tout l’écran.'], + ['[[Échap]]', 'Annuler et quitter l’écran de scan (le clic droit fonctionne aussi).'], + ], + }, + }, + { h2: 'Si aucun code n’est trouvé' }, + { + ul: [ + 'Utilisez **Sélectionner une zone** et tracez un cadre autour du code seulement ; il est agrandi avant d’être lu.', + 'Si le code bouge vite dans une vidéo, mettez d’abord la vidéo en pause.', + 'Écartez les autres fenêtres, le pointeur de la souris ou tout ce qui cache une partie du code.', + 'Vérifiez que **Paramètres › Scan › Lire aussi les codes-barres** est activé si vous voulez lire des codes-barres et des formats comme Data Matrix.', + 'Si le code est très petit à l’écran (moins d’environ 40 pixels de large), agrandissez d’abord la page ou l’image.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'Autres façons de scanner' }, + { h2: 'Webcam' }, + { p: 'Utilisez la webcam pour les codes sur papier, sur une carte de visite ou sur l’écran d’un autre téléphone.' }, + { + ol: [ + 'Appuyez sur [[Ctrl+Alt+W]], ou choisissez **Scanner avec la caméra**.', + 'Présentez le code à la caméra à une distance d’environ 15 à 30 cm.', + 'Lorsqu’un code est reconnu, des crochets apparaissent autour de lui et son étiquette de résultat se place dans une liste fixe en bas de l’image.', + 'Cliquez sur l’étiquette, ou sélectionnez-la avec [[Tab]] et appuyez sur [[Entrée]].', + ], + }, + { fig: 'camera', cap: 'Scanner avec la caméra : les résultats restent dans une liste fixe en bas', width: 13 }, + { + ul: [ + 'Un code doit être vu sur plusieurs images d’affilée avant d’apparaître dans la liste, ce qui évite les erreurs de lecture.', + 'Quand un code quitte l’image, son résultat reste dans la liste un moment (8 secondes par défaut) pour que vous puissiez encore cliquer dessus. Modifiez cette durée dans **Paramètres › Caméra**.', + 'Si plusieurs caméras sont branchées, passez de l’une à l’autre avec la liste en bas de la fenêtre.', + 'L’interrupteur **Miroir** change seulement l’affichage de l’image ; la reconnaissance fonctionne dans les deux cas.', + 'Par défaut, la fenêtre de la caméra se ferme après l’ouverture d’un code. Vous pouvez changer ce comportement dans **Paramètres › Caméra**.', + ], + }, + { note: 'Si la caméra ne démarre pas, fermez les autres programmes qui l’utilisent peut-être (appels vidéo, par exemple) et autorisez QRcode tool à utiliser la caméra dans les paramètres de confidentialité du système.' }, + { h2: 'Image du Presse-papiers' }, + { + ol: [ + 'Faites une capture du code avec [[Win+Maj+S]] ou un autre outil de capture, ou copiez une image depuis une page web.', + 'Choisissez **Scanner l’image du Presse-papiers**.', + 'L’image s’affiche dans une fenêtre d’aperçu, et chaque code trouvé reçoit une étiquette de résultat.', + ], + }, + { p: 'S’il n’y a pas d’image dans le Presse-papiers, le programme vous invite à copier d’abord une capture d’écran ou une image.' }, + { h2: 'Fichiers image' }, + { + ol: [ + 'Choisissez **Ouvrir une image…**.', + 'Sélectionnez un fichier PNG, JPEG, BMP, GIF ou WebP.', + 'Cliquez sur une étiquette de résultat dans la fenêtre d’aperçu. Les boutons du bas ouvrent une autre image ou scannent plutôt le Presse-papiers.', + ], + }, + { fig: 'image-preview', cap: 'La fenêtre d’aperçu : les étiquettes sont placées sur les codes de l’image', width: 13 }, + { h2: 'Menu contextuel de Windows' }, + { p: 'Sous Windows, QRcode tool peut ajouter ses fonctions principales au menu contextuel (clic droit) de l’Explorateur de fichiers : faites un clic droit sur le fond du Bureau pour scanner l’écran, ou sur une image pour scanner ce fichier, sans ouvrir la barre ni retenir de raccourci.' }, + { + figs: [ + ['shell-desktop', 'Clic droit sur le fond du Bureau'], + ['shell-image', 'Clic droit sur une image'], + ], + cap: 'Entrées de QRcode tool dans le menu contextuel (Windows 11, Afficher d’autres options)', + }, + { h3: 'Activer ou désactiver le menu contextuel' }, + { p: 'Le menu contextuel est **activé** par défaut : les entrées apparaissent dès que QRcode tool a été installé et lancé une fois. Si vous l’avez désactivé, réactivez-le ainsi :' }, + { + ol: [ + 'Ouvrez **Paramètres** depuis le menu de notification ou la barre flottante.', + 'Choisissez **Général** à gauche.', + 'Activez **Menu contextuel**. Le changement s’applique immédiatement ; inutile de redémarrer l’ordinateur ou l’Explorateur de fichiers.', + ], + }, + { p: 'Désactivez le même interrupteur pour retirer les entrées. Elles sont enregistrées dans vos propres paramètres utilisateur (la partie HKEY_CURRENT_USER du Registre) : aucun droit d’administrateur n’est nécessaire et les autres comptes de l’ordinateur ne sont pas concernés.' }, + { h3: 'Ouvrir le menu' }, + { + ul: [ + '**Windows 11 :** faites un clic droit, puis choisissez **Afficher d’autres options** en bas ; les entrées de QRcode tool se trouvent dans le menu complet. Pour ouvrir directement le menu complet, maintenez [[Maj]] enfoncée pendant le clic droit, ou appuyez sur [[Maj+F10]].', + '**Windows 10 :** les entrées de QRcode tool apparaissent dès le clic droit.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['Entrée du menu', 'Où', 'Action'], + rows: [ + ['QRcode tool Analyser l’écran', 'Fond du Bureau', 'Scanne tout l’écran (comme [[Ctrl+Alt+Q]]).'], + ['QRcode tool Analyser une zone', 'Fond du Bureau', 'Fige l’écran pour que vous sélectionniez une zone (comme [[Ctrl+Alt+A]]).'], + ['QRcode tool Analyser avec la caméra', 'Fond du Bureau', 'Ouvre la webcam (comme [[Ctrl+Alt+W]]).'], + ['QRcode tool Barre d’outils', 'Fond du Bureau', 'Affiche la barre d’outils flottante.'], + ['QRcode tool Ouvrir l’image', 'Fichiers image', 'Scanne l’image dans la fenêtre d’aperçu. PNG, JPEG, BMP, GIF et WebP sont pris en charge.'], + ], + }, + }, + { + ul: [ + 'Les quatre entrées du Bureau sont regroupées en bas du menu entre deux séparateurs, avec l’icône de QRcode tool.', + '**QRcode tool Ouvrir l’image** n’apparaît que lorsqu’**une seule** image est sélectionnée, pas pour plusieurs fichiers à la fois.', + 'Les entrées utilisent la langue de QRcode tool. Après une modification de **Paramètres › Général › Langue**, le menu est mis à jour aussi.', + 'Si QRcode tool n’est pas en cours d’exécution, choisir une entrée le lance et exécute la fonction ; s’il est déjà lancé, c’est le programme ouvert qui traite la demande.', + 'Avec la version portable, les entrées pointent vers l’emplacement actuel du programme. Après avoir déplacé le dossier portable, lancez le programme une fois pour mettre les entrées à jour.', + 'La désinstallation de QRcode tool supprime les entrées. macOS et Linux n’ont pas d’entrées de menu contextuel ; utilisez les raccourcis ou la ligne de commande.', + ], + }, + { tip: 'Si QRcode tool n’apparaît pas dans le menu : vérifiez que **Paramètres › Général › Menu contextuel** est activé, choisissez **Afficher d’autres options** sous Windows 11, et lancez QRcode tool une fois s’il vient d’être installé ou déplacé.' }, + { h2: 'Ligne de commande' }, + { p: 'Chaque fonction de scan peut être lancée par une commande. Si le programme tourne déjà, la commande lui est transmise. C’est particulièrement utile sous Linux avec Wayland : associez les commandes à des raccourcis personnalisés dans les réglages clavier du bureau.' }, + { + table: { + cols: [42, 58], + head: ['Commande', 'Action'], + rows: [ + ['`qrcode-tool`', 'Lance le programme, ou affiche la barre flottante s’il tourne déjà.'], + ['`qrcode-tool scan-screen`', 'Scanne tout l’écran.'], + ['`qrcode-tool scan-region`', 'Fige l’écran et sélectionne une zone.'], + ['`qrcode-tool scan-camera`', 'Scanne avec la webcam.'], + ['`qrcode-tool scan-clipboard`', 'Scanne l’image du Presse-papiers.'], + ['`qrcode-tool scan-file FICHIER`', 'Scanne un fichier image dans la fenêtre d’aperçu.'], + ['`qrcode-tool toolbar`', 'Affiche ou masque la barre d’outils flottante.'], + ['`qrcode-tool bubble`', 'Affiche ou masque la bulle flottante.'], + ['`qrcode-tool generate "TEXTE"`', 'Ouvre le générateur de codes QR avec le texte déjà saisi.'], + ['`qrcode-tool settings`', 'Ouvre les paramètres.'], + ['`qrcode-tool decode FICHIER… [--json]`', 'Affiche dans le terminal les codes des fichiers image sans lancer l’interface.'], + ['`qrcode-tool quit`', 'Quitte le programme en cours d’exécution.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: 'Résultats et détails' }, + { h2: 'Étiquettes de résultat' }, + { p: 'Chaque code trouvé reçoit une étiquette de résultat sombre. De gauche à droite, elle affiche :' }, + { + ul: [ + '**Icône :** le type de contenu, par exemple un globe pour un lien, des ondes pour le Wi-Fi ou une silhouette pour un contact. Les liens avec avertissement affichent à la place un symbole d’avertissement ou de danger.', + '**Texte principal :** pour un lien, le vrai nom du site plutôt que l’adresse complète ; pour le Wi-Fi, le nom du réseau ; pour un contact, le nom.', + '**Deuxième ligne :** le type de contenu, ou la raison principale d’un avertissement.', + '**Bouton › :** ouvre toujours la fiche de détails, quel que soit le contenu.', + ], + }, + { h2: 'Ce que font Entrée et le clic' }, + { + table: { + cols: [36, 64], + head: ['Contenu', 'Action'], + rows: [ + ['Lien sans avertissement', 'S’ouvre dans votre navigateur par défaut.'], + ['Lien avec avertissement', 'Affiche d’abord la fiche de détails ; le lien ne s’ouvre qu’après votre confirmation.'], + ['Tout le reste', 'Affiche la fiche de détails, où vous choisissez quoi faire.'], + ], + }, + }, + { h2: 'La fiche de détails' }, + { p: 'La fiche de détails liste chaque champ du code et propose des boutons adaptés au contenu. Le bouton Copier à côté d’un champ copie seulement ce champ. Les champs sensibles, comme les mots de passe, sont masqués par « •••• » ; le bouton cadenas les affiche un instant. Cliquez en dehors de la fiche ou sur **Fermer** pour revenir aux résultats.' }, + { fig: 'detail-wifi', cap: 'Fiche de détails d’un code Wi-Fi : « Se connecter » rejoint le réseau', width: 12 }, + { h2: 'Boutons selon le type de contenu' }, + { + table: { + cols: [30, 70], + head: ['Type', 'Boutons'], + rows: [ + ['Lien', '**Ouvrir**, **Copier**. Les liens sans avertissement vers des sites pas encore approuvés proposent aussi **Toujours autoriser ce site**.'], + ['Réseau Wi-Fi', '**Se connecter** (le système crée le profil réseau), **Copier le mot de passe**.'], + ['Contact (vCard, MeCard)', '**Enregistrer le contact** (enregistre un fichier .vcf à importer dans votre carnet d’adresses), **Copier**.'], + ['E-mail', '**Écrire un e-mail** (ouvre votre messagerie par défaut), **Copier**.'], + ['Numéro de téléphone', '**Appeler** (transmis à l’application d’appel du système), **Copier**.'], + ['SMS', '**Envoyer un message**, **Copier**.'], + ['Position', '**Ouvrir la carte**, **Copier**.'], + ['Clé de vérification en deux étapes', 'Seuls le nom du service et le compte sont affichés ; **Copier** est disponible. Le secret lui-même n’est jamais affiché ni enregistré.'], + ['Adresse de paiement', '**Copier**. Vérifiez toujours une adresse de paiement avant d’envoyer de l’argent.'], + ['Facture électronique', '**Copier le numéro de facture**, **Copier**.'], + ['Lien bloqué', 'Les liens autres que `http` et `https` (par exemple `file:` ou `javascript:`) peuvent seulement être copiés, jamais ouverts.'], + ['Texte et codes-barres', '**Copier**. Pour les codes-barres, le format (par exemple EAN-13) est aussi indiqué.'], + ], + }, + }, + { h2: 'Factures électroniques de Taïwan' }, + { p: 'Une facture électronique de Taïwan comporte deux codes QR côte à côte. Le code de gauche contient le numéro de facture, la date, les montants et une partie des articles ; celui de droite contient les articles restants. Lorsque **Scanner tout l’écran** ou **Ouvrir une image…** trouve les deux codes, ils sont fusionnés en une seule facture, et la fiche de détails liste le numéro de facture, la date, le code aléatoire, le total, la taxe, les identifiants du vendeur et de l’acheteur et tous les articles. Si seul le code de gauche est trouvé, la fiche vous rappelle de scanner aussi celui de droite.' }, + { h2: 'Données sensibles' }, + { p: 'Les clés de vérification en deux étapes et les mots de passe Wi-Fi sont des données sensibles. Même si l’historique ou **Copier le résultat automatiquement** est activé, ils ne sont jamais écrits dans l’historique, jamais copiés automatiquement et jamais inscrits dans les fichiers journaux du programme.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'Sécurité des liens' }, + { p: 'Les codes QR malveillants mènent souvent à de faux sites web. QRcode tool analyse chaque adresse web sur votre ordinateur avant d’afficher le résultat, et signale ce qu’il trouve directement sur l’étiquette et sur la fiche de détails. Rien n’est vérifié en ligne et aucune adresse n’est envoyée à un service.' }, + { h2: 'Vérifiez le nom du site avant d’ouvrir' }, + { p: 'L’étiquette de résultat affiche le vrai nom du site contenu dans l’adresse. Avant d’ouvrir un lien, assurez-vous qu’il s’agit bien du site attendu. Les liens avec avertissement affichent d’abord leur fiche de détails, avec en haut un bandeau coloré qui explique à quoi faire attention.' }, + { fig: 'detail-warning', cap: 'Un lien avec avertissements : un lien raccourci non chiffré affiche les raisons et attend', width: 12 }, + { h2: 'Niveaux d’avertissement' }, + { + table: { + cols: [18, 82], + head: ['Niveau', 'Ce que fait le programme'], + rows: [ + ['Info', 'Par exemple une adresse très longue. Signalé seulement sur la fiche de détails ; [[Entrée]] ouvre le lien directement.'], + ['Avertissement', 'Crochets et icône jaunes. [[Entrée]] ou un clic affiche d’abord la fiche de détails ; vous cliquez ensuite sur **Ouvrir**.'], + ['Danger', 'Crochets et icône rouges. **Ouvrir** n’est plus le bouton par défaut et, après avoir cliqué dessus, vous devez confirmer avec **Ouvrir quand même**.'], + ], + }, + }, + { h2: 'Ce qui est vérifié' }, + { + table: { + cols: [30, 12, 58], + head: ['Message affiché', 'Niveau', 'Explication et conseil'], + rows: [ + ['Non chiffré (http)', 'Avertissement', 'La connexion n’est pas chiffrée : les données peuvent être lues ou modifiées en chemin. Ne saisissez ni mot de passe ni données de paiement sur ces pages.'], + ['Adresse déguisée', 'Danger', 'Un nom de confiance est placé avant un « @ », mais le lien mène en réalité au site qui suit, par exemple `https://bank.example.com@login-check.example.net/`.'], + ['Nom de domaine international', 'Avertissement', 'Le domaine contient des lettres non latines. La fiche affiche aussi l’adresse encodée réelle (commençant par `xn--`) pour que vous puissiez la vérifier.'], + ['Lettres similaires', 'Danger', 'Une partie du domaine mélange plusieurs alphabets, par exemple un « а » cyrillique à la place d’un « a » latin. C’est une ruse courante des faux sites.'], + ['Adresse IP brute', 'Avertissement', 'L’adresse utilise des chiffres au lieu d’un nom de site, ce que les sites ordinaires font rarement.'], + ['Port inhabituel', 'Avertissement', 'L’adresse indique un numéro de port non standard.'], + ['Lien raccourci', 'Avertissement', 'Des services comme bit.ly masquent la vraie destination. Le lien n’est pas déplié en ligne, car cela révélerait au service ce que vous avez scanné. N’ouvrez les liens raccourcis que s’ils viennent de sources fiables.'], + ['Adresse très longue', 'Info', 'Une adresse très longue peut repousser le vrai nom du site hors de vue.'], + ['Nombreux caractères encodés', 'Info', 'De nombreuses séquences « % » peuvent servir à cacher le contenu d’une adresse.'], + ['Nombreux sous-domaines', 'Info', 'Par exemple `login.bank.example.com.secure-check.example.net`, qui ressemble au premier coup d’œil au site d’une banque.'], + ], + }, + }, + { h2: 'Liens trompeurs' }, + { p: 'Pour les liens classés **Danger**, la fiche de détails indique en rouge que le lien semble trompeur et en liste les raisons. Fiez-vous au vrai nom du site affiché sur la fiche, pas au texte imprimé à côté du code.' }, + { fig: 'detail-danger', cap: 'Une adresse déguisée : elle ressemble à une banque mais mène à login-check.example.net', width: 12 }, + { p: 'Si vous êtes sûr de vouloir continuer, cliquez sur **Ouvrir**. La fiche demande une nouvelle fois ; seul **Ouvrir quand même** ouvre réellement la page.' }, + { h2: 'Sites de confiance et ouverture automatique' }, + { p: 'Vous pouvez ajouter aux sites de confiance ceux que vous utilisez souvent, comme le domaine de votre école ou de votre entreprise. Un lien s’ouvre alors juste après le scan, sans attendre [[Entrée]], lorsque toutes ces conditions sont réunies :' }, + { + ul: [ + 'Un seul code a été trouvé.', + 'Le lien ne présente aucun avertissement.', + 'Le site (ou l’un de ses sous-domaines) figure dans la liste de confiance.', + '**Paramètres › Scan › Ouvrir les sites de confiance sans demander** est activé (valeur par défaut).', + ], + }, + { p: 'Ajoutez un site avec **Toujours autoriser ce site** sur la fiche de détails d’un lien sans avertissement, ou saisissez le domaine dans **Paramètres › Scan**.' }, + { fig: 'detail-link', cap: 'Un lien sans avertissement : ouvrez-le ou ajoutez le site à la liste de confiance', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'Barre d’outils et bulle flottantes' }, + { p: 'La barre d’outils flottante reste au-dessus des autres fenêtres pour que chaque fonction soit à un clic. Elle n’apparaît jamais dans les captures scannées. Affichez-la ou masquez-la avec **Barre d’outils flottante** dans le menu de notification, le raccourci [[Ctrl+Alt+E]] ou la commande `qrcode-tool toolbar`.' }, + { h2: 'Boutons de la barre' }, + { fig: 'toolbar-row', cap: 'Barre horizontale : survolez un bouton pour voir son nom et son raccourci en dessous', width: 11 }, + { + table: { + cols: [34, 66], + head: ['Bouton', 'Action'], + rows: [ + ['(poignée pointillée au début)', 'Maintenez et faites glisser pour déplacer la barre.'], + ['Scanner tout l’écran', 'Comme [[Ctrl+Alt+Q]].'], + ['Sélectionner une zone', 'Comme [[Ctrl+Alt+A]].'], + ['Scanner avec la caméra', 'Comme [[Ctrl+Alt+W]]. Grisé si aucune caméra n’est trouvée.'], + ['Scanner l’image du Presse-papiers', 'Lit l’image du Presse-papiers.'], + ['Ouvrir une image…', 'Choisissez un fichier image et scannez-le.'], + ['Créer un code QR…', 'Ouvre le générateur de codes QR.'], + ['Historique', 'Ouvre **Paramètres › Confidentialité et historique**.'], + ['Paramètres', 'Ouvre les paramètres.'], + ['Manuel d’utilisation (bouton « ? »)', 'Ouvre le manuel d’utilisation PDF sur GitHub dans un nouvel onglet du navigateur, dans la langue de l’interface.'], + ['Réduire en bulle', 'Masque la barre et affiche à la place la petite bulle ronde.'], + ['Fermer la barre d’outils', 'Masque la barre (la bulle n’apparaît pas). Le programme continue de tourner dans la zone de notification.'], + ], + }, + }, + { h2: 'Barre verticale (droite ou gauche)' }, + { p: 'En plus de la disposition horizontale par défaut en haut de l’écran, la barre peut former une colonne verticale sur le bord droit ou gauche. La colonne prend moins de largeur, ce qui convient aux écrans larges et laisse libre le haut des pages web.' }, + { + figs: [ + ['toolbar-right', 'Verticale, à droite (position verticale par défaut)'], + ['toolbar-left', 'Verticale, à gauche'], + ], + cap: 'Barre verticale : le nom et le raccourci du bouton survolé s’affichent sous les boutons', + }, + { p: 'Pour changer de disposition :' }, + { + ol: [ + 'Ouvrez **Paramètres** et choisissez **Général**.', + 'Dans la section **Barre d’outils et bulle flottantes**, repérez **Disposition de la barre**.', + 'Choisissez **Horizontale, en haut**, **Verticale, à droite** ou **Verticale, à gauche**.', + ], + }, + { p: 'Le changement s’applique immédiatement. La barre se place à l’emplacement par défaut de la nouvelle disposition : centrée en haut pour l’horizontale, centrée verticalement sur le bord choisi pour la verticale. Vous pouvez ensuite la faire glisser où vous voulez.' }, + { h2: 'Déplacer la barre' }, + { p: 'Maintenez la poignée pointillée à une extrémité de la barre et faites-la glisser. Le programme mémorise la dernière position et y réaffiche la barre la fois suivante. Si cette position n’est plus sur aucun écran, par exemple après avoir débranché un écran externe, la barre revient à son emplacement par défaut.' }, + { h2: 'La bulle flottante' }, + { p: 'La bulle flottante est la barre réduite. Elle n’occupe qu’un petit cercle et s’affiche par défaut sur le bord droit de l’écran.' }, + { fig: 'bubble', cap: 'La bulle flottante', width: 8 }, + { + table: { + cols: [30, 70], + head: ['Action', 'Résultat'], + rows: [ + ['Clic', 'Déplie la barre d’outils flottante complète.'], + ['Maintien d’environ une demi-seconde', 'Scanne tout l’écran.'], + ['Clic droit', 'Ouvre un menu : **Scanner tout l’écran**, **Sélectionner une zone**, **Scanner avec la caméra**, **Scanner l’image du Presse-papiers**, **Afficher la barre d’outils**, **Masquer la bulle**.'], + ['Glisser', 'Déplace la bulle.'], + ], + }, + }, + { p: 'Pour afficher la bulle à chaque démarrage du programme, activez **Paramètres › Général › Afficher la bulle au démarrage de l’application**. La barre et la bulle ne s’affichent jamais en même temps.' }, + { h2: 'Masquer pendant les applications en plein écran' }, + { p: 'Sous Windows, la barre et la bulle se masquent pendant que vous regardez une vidéo en plein écran, faites une présentation ou jouez, et reviennent quand vous quittez le plein écran. Désactivez ce comportement dans **Paramètres › Général › Masquer pendant les applications en plein écran**.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'Créer des codes QR' }, + { p: 'Le générateur de codes QR transforme un lien ou un texte en code QR que vous pouvez scanner avec un téléphone ou insérer dans des documents et des présentations.' }, + { + ol: [ + 'Choisissez **Créer un code QR…** dans le menu de notification, la barre flottante ou l’écran de scan.', + 'Saisissez ou collez le contenu dans **Texte ou lien**. Le code QR apparaît aussitôt à droite.', + 'Choisissez si besoin un niveau de **Correction d’erreurs**.', + 'Cliquez sur **Copier l’image** pour copier le code dans le Presse-papiers, ou sur **Enregistrer en PNG…** ou **Enregistrer en SVG…** pour l’enregistrer dans un fichier.', + ], + }, + { fig: 'generator', cap: 'Le générateur de codes QR', width: 13 }, + { h2: 'Correction d’erreurs' }, + { p: 'Un niveau plus élevé permet de lire le code même s’il est en partie abîmé ou masqué par un logo, mais le rend plus dense et plus grand.' }, + { + table: { + cols: [36, 64], + head: ['Niveau', 'Quand l’utiliser'], + rows: [ + ['Faible — code le plus petit', 'Beaucoup de contenu qui ne sera affiché qu’à l’écran.'], + ['Moyenne — recommandée', 'La valeur par défaut pour un usage général.'], + ['Quartile', 'Codes imprimés sur des objets susceptibles d’être rayés.'], + ['Élevée — résiste aux dégâts ou à un logo', 'Quand un logo sera placé au centre du code, ou quand une robustesse maximale est nécessaire.'], + ], + }, + }, + { note: 'Un code QR ne peut contenir qu’une quantité limitée de contenu. Si « Trop de texte pour un seul code QR » s’affiche, raccourcissez le contenu ou choisissez un niveau de correction plus faible.' }, + { p: '**PNG** est pratique pour les documents et les diapositives ; **SVG** est un format vectoriel qui reste net même imprimé en grand. Appuyez sur [[Échap]] pour fermer le générateur.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: 'Paramètres' }, + { p: 'Choisissez **Paramètres** dans le menu de notification, la barre flottante ou l’écran de scan. Chaque modification est enregistrée et appliquée immédiatement ; il n’y a pas de bouton OK.' }, + { h2: 'Général' }, + { fig: 'settings-general', cap: 'Paramètres › Général', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Paramètre', 'Description'], + rows: [ + ['Langue', 'Langue des menus et des messages. Suit le système d’exploitation par défaut.'], + ['Thème', '**Utiliser le paramètre système**, **Clair** ou **Sombre**. La couleur d’accentuation du système est appliquée automatiquement.'], + ['Démarrer avec l’ordinateur', 'Démarre discrètement en arrière-plan à l’ouverture de session, pour que le raccourci fonctionne toujours.'], + ['Menu contextuel', '(Windows uniquement) Ajoute des entrées QRcode tool aux menus contextuels du Bureau et des fichiers image. Activé par défaut ; voir « Menu contextuel de Windows » au chapitre 4.'], + ['Disposition de la barre', '**Horizontale, en haut**, **Verticale, à droite** ou **Verticale, à gauche**. Voir le chapitre 7.'], + ['Afficher la bulle au démarrage de l’application', 'Affiche la bulle flottante au démarrage.'], + ['Masquer pendant les applications en plein écran', '(Windows uniquement) Masque la barre et la bulle pendant les vidéos, présentations et jeux en plein écran.'], + ['Rechercher automatiquement les mises à jour', 'Demande à GitHub une fois par jour si une nouvelle version existe. Rien n’est installé sans votre accord.'], + ['Afficher à nouveau l’écran d’accueil', 'Ouvre l’écran d’accueil du premier démarrage.'], + ], + }, + }, + { h2: 'Scan' }, + { fig: 'settings-scanning', cap: 'Paramètres › Scan', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Paramètre', 'Description'], + rows: [ + ['Copier le résultat automatiquement', 'Quand un seul code est trouvé, son contenu est placé dans le Presse-papiers. Le contenu sensible n’est jamais copié. Désactivé par défaut.'], + ['Émettre un son lorsqu’un code est trouvé', 'Émet un son bref. Désactivé par défaut.'], + ['Lire aussi les codes-barres', 'Lit EAN, UPC, Code 128, Data Matrix, PDF417, Aztec et d’autres formats en plus des codes QR. Activé par défaut.'], + ['Ouvrir les sites de confiance sans demander', 'Ouvre automatiquement les liens vers les sites de confiance dans les conditions décrites au chapitre 6.'], + ['Sites de confiance', 'Saisissez un domaine (par exemple example.com) et cliquez sur **Ajouter**. Ses sous-domaines sont aussi approuvés. L’icône de corbeille supprime une entrée.'], + ], + }, + }, + { h2: 'Caméra' }, + { fig: 'settings-camera', cap: 'Paramètres › Caméra', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Paramètre', 'Description'], + rows: [ + ['Caméra', 'La webcam à utiliser.'], + ['Afficher l’image en miroir', 'Affiche la caméra comme un miroir. La reconnaissance fonctionne dans les deux cas.'], + ['Garder les résultats à l’écran (secondes)', 'Durée (0 à 60 secondes) pendant laquelle un résultat reste dans la liste après la sortie du code de l’image. Avec 0, seuls les codes visibles sont listés.'], + ['Fermer la caméra après l’ouverture d’un code', 'Ferme la fenêtre de la caméra dès qu’un code a été ouvert ou utilisé.'], + ], + }, + }, + { h2: 'Raccourcis' }, + { fig: 'settings-shortcuts', cap: 'Paramètres › Raccourcis', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['Action', 'Par défaut', 'Description'], + rows: [ + ['Scanner tout l’écran', '[[Ctrl+Alt+Q]]', 'Fige et scanne tous les écrans.'], + ['Sélectionner une zone', '[[Ctrl+Alt+A]]', 'Fige l’écran pour que vous traciez un cadre.'], + ['Scanner avec la caméra', '[[Ctrl+Alt+W]]', 'Ouvre la fenêtre de la webcam.'], + ['Afficher ou masquer la barre d’outils', '[[Ctrl+Alt+E]]', 'Affiche ou masque la barre flottante.'], + ], + }, + }, + { p: 'Pour modifier un raccourci :' }, + { + ol: [ + 'Cliquez sur le raccourci à modifier. Le bouton affiche **Appuyez sur des touches… (Échap pour annuler)**.', + 'Appuyez sur la nouvelle combinaison de touches. Elle doit comporter au moins l’une des touches [[Ctrl]], [[Alt]], [[Maj]] ou [[Win]] (sur Mac, [[Cmd]]).', + 'Le nouveau raccourci s’applique immédiatement.', + ], + }, + { p: 'Si une autre application utilise déjà la combinaison, la ligne indique « Déjà utilisé par une autre application — choisissez-en un autre. » Choisissez une autre combinaison. **Rétablir les valeurs par défaut** restaure tous les raccourcis d’origine. La section **Pendant le scan**, en bas, liste les touches de l’écran de scan, les mêmes qu’au chapitre 3.' }, + { h2: 'Confidentialité et historique' }, + { fig: 'settings-privacy', cap: 'Paramètres › Confidentialité et historique (historique activé)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Paramètre', 'Description'], + rows: [ + ['Conserver un historique des scans', 'Enregistré uniquement sur cet ordinateur. Les mots de passe Wi-Fi et les clés de vérification en deux étapes ne sont jamais enregistrés. Désactivé par défaut.'], + ['Nombre d’entrées à conserver', 'De 5 à 500 entrées. Les plus anciennes sont supprimées en premier.'], + ['Scans récents', 'Les plus récents en premier. Les liens sans avertissement peuvent être rouverts avec **Ouvrir** ; chaque entrée peut être copiée avec **Copier**.'], + ['Effacer l’historique', 'Supprime tout l’historique.'], + ], + }, + }, + { h2: 'À propos' }, + { fig: 'settings-about', cap: 'Paramètres › À propos', width: 14 }, + { + ul: [ + 'Affiche la version actuelle. **Rechercher des mises à jour** vérifie tout de suite.', + 'Liens vers le code source, le signalement de problèmes, la déclaration de confidentialité et les licences open source.', + '**Ouvrir le dossier des paramètres** et **Ouvrir le dossier des journaux** ouvrent directement ces dossiers, pour sauvegarder vos paramètres ou joindre des journaux à un signalement.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: 'Mise à jour et désinstallation' }, + { h2: 'Rechercher et installer les mises à jour' }, + { p: 'Les copies installées avec le programme d’installation peuvent se mettre à jour elles-mêmes. Avec **Rechercher automatiquement les mises à jour** activé, le programme interroge GitHub une fois par jour. Vous pouvez aussi cliquer à tout moment sur **Rechercher des mises à jour** dans le menu de notification ou dans **Paramètres › À propos**.' }, + { fig: 'message-update', cap: 'Le message affiché quand une nouvelle version est disponible', width: 10 }, + { + ol: [ + 'Quand le message **Mise à jour disponible** apparaît, cliquez sur **Mettre à jour**.', + 'La nouvelle version est téléchargée en arrière-plan, puis le programme redémarre.', + 'Cliquez sur **Plus tard** si vous ne voulez pas mettre à jour maintenant.', + ], + }, + { p: 'Les mises à jour ne sont installées qu’après un clic sur **Mettre à jour** ; le programme n’installe jamais rien de lui-même.' }, + { h2: 'Version portable' }, + { p: 'La version portable (`Portable.zip`) ne se met pas à jour seule ; la recherche de mises à jour affiche « Les mises à jour ne sont pas disponibles ». Téléchargez la nouvelle version sur la page des versions GitHub et remplacez les anciens fichiers. Vos paramètres sont conservés.' }, + { h2: 'Désinstaller' }, + { + ol: [ + 'Ouvrez **Paramètres › Applications › Applications installées** dans Windows.', + 'Repérez QRcode tool, cliquez sur **…** et choisissez **Désinstaller**.', + 'L’entrée de démarrage et les entrées du menu contextuel sont également supprimées.', + ], + }, + { p: 'Pour supprimer aussi vos paramètres et votre historique, ouvrez le dossier des paramètres et celui des journaux depuis **Paramètres › À propos** avant la désinstallation, puis supprimez-les.' }, + { h2: 'Emplacement des paramètres et des journaux' }, + { + table: { + cols: [18, 82], + head: ['Système', 'Emplacement'], + rows: [ + ['Windows', 'Paramètres : `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\nHistorique et journaux : `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', 'Paramètres : `~/.config/qrcode-tool`\nHistorique et journaux : `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: 'Le fichier de paramètres `settings.toml` est en texte brut. Copiez-le pour transférer vos paramètres sur un autre ordinateur.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'Dépannage' }, + { + qa: [ + ['Rien ne se passe quand j’appuie sur le raccourci.', 'Une autre application l’utilise peut-être déjà. Ouvrez **Paramètres › Raccourcis** ; si la ligne indique « Déjà utilisé par une autre application », choisissez une autre combinaison. Certains jeux et logiciels de bureau à distance capturent toutes les touches lorsqu’ils sont au premier plan.'], + ['Le scan ne trouve aucun code.', 'Utilisez **Sélectionner une zone** et tracez un cadre autour du code seulement, ou agrandissez d’abord la page ou l’image. Voir « Si aucun code n’est trouvé » au chapitre 3.'], + ['Pourquoi le lien ne s’est-il pas ouvert tout de suite ?', 'Un lien avec avertissement affiche toujours ses détails d’abord pour que vous vérifiiez le vrai site. Seuls les liens vers des sites de confiance sans aucun avertissement s’ouvrent automatiquement, et seulement s’ils sont le seul code trouvé.'], + ['Il est écrit « Lien raccourci — la vraie destination est masquée ».', 'Les services de liens raccourcis masquent la vraie destination. Le programme ne la recherche pas en ligne, car cela révélerait ce que vous avez scanné. N’ouvrez les liens raccourcis que s’ils viennent de sources fiables.'], + ['Où est la fenêtre principale ?', 'Il n’y en a pas, c’est voulu. Utilisez l’icône de notification, le raccourci, la barre d’outils flottante ou la bulle flottante.'], + ['QRcode tool n’apparaît pas dans le menu contextuel.', 'Vérifiez que **Paramètres › Général › Menu contextuel** est activé. Sous Windows 11, les entrées se trouvent sous **Afficher d’autres options** (ou maintenez [[Maj]] pendant le clic droit). **QRcode tool Ouvrir l’image** n’apparaît que si une seule image est sélectionnée. Si vous venez d’installer QRcode tool ou de déplacer la version portable, lancez-le une fois.'], + ['La barre d’outils a disparu.', 'Appuyez sur [[Ctrl+Alt+E]] ou cochez **Barre d’outils flottante** dans le menu de notification. Avec **Masquer pendant les applications en plein écran** activé, la barre est masquée tant qu’un programme en plein écran est au premier plan.'], + ['La caméra ne démarre pas.', 'Fermez les autres programmes qui utilisent la caméra et vérifiez que les paramètres de confidentialité du système autorisent QRcode tool à l’utiliser. Avec plusieurs caméras, choisissez la bonne dans **Paramètres › Caméra**.'], + ['Le Wi-Fi ne se connecte pas automatiquement.', 'Certains réseaux (avec authentification d’entreprise, par exemple) ne peuvent pas être configurés par le programme. Cliquez sur **Copier le mot de passe** dans la fiche de détails et connectez-vous depuis le menu Wi-Fi du système.'], + ['Mon antivirus affiche un avertissement.', 'Les nouveaux programmes non signés qui enregistrent des raccourcis, lisent l’écran et démarrent avec l’ordinateur sont parfois signalés par la détection comportementale. QRcode tool utilise des interfaces système standard et son code source est public. Signalez le faux positif à l’éditeur de votre antivirus, ou ouvrez une issue sur GitHub.'], + ['Sous macOS, la capture est noire.', 'Autorisez QRcode tool dans **Réglages Système › Confidentialité et sécurité › Enregistrement de l’écran** et redémarrez le programme. macOS peut redemander l’autorisation après une mise à jour du système.'], + ['Sous Linux avec Wayland, le raccourci ne fait rien.', 'Wayland n’autorise pas les programmes à enregistrer des raccourcis globaux. Ajoutez dans les réglages clavier du bureau un raccourci personnalisé qui exécute `qrcode-tool scan-screen` ou une autre commande.'], + ['Comment rouvrir ce manuel ?', 'Cliquez sur le bouton **?** (**Manuel d’utilisation**) de la barre flottante ; l’édition PDF sur GitHub s’ouvre dans un nouvel onglet du navigateur. Les fichiers Word et PDF se trouvent aussi dans le dossier `docs/manual` du dépôt GitHub.'], + ['Comment signaler un problème ?', 'Cliquez sur **Signaler un problème ou proposer une idée** dans **Paramètres › À propos** et décrivez votre système, les étapes et les messages affichés. Vous pouvez joindre des fichiers du dossier des journaux ; les journaux ne contiennent que des événements et des erreurs, jamais de contenu scanné.'], + ], + }, + + // ───────────────────────── Annexes ───────────────────────── + { h1: 'Raccourcis et touches en un coup d’œil', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['Où', 'Touche', 'Action'], + rows: [ + ['Partout', '[[Ctrl+Alt+Q]]', 'Scanner tout l’écran'], + ['Partout', '[[Ctrl+Alt+A]]', 'Sélectionner une zone'], + ['Partout', '[[Ctrl+Alt+W]]', 'Scanner avec la caméra'], + ['Partout', '[[Ctrl+Alt+E]]', 'Afficher ou masquer la barre flottante'], + ['Écran de scan, aperçu', '[[Entrée]]', 'Ouvrir le code sélectionné'], + ['Écran de scan, aperçu', '[[Tab]] / [[Maj+Tab]]', 'Sélectionner le code suivant / précédent'], + ['Écran de scan, aperçu', '[[C]]', 'Copier le code sélectionné'], + ['Écran de scan', '[[F]] ou [[F5]]', 'Relancer la recherche sur tout l’écran'], + ['Écran de scan, aperçu, générateur', '[[Échap]]', 'Fermer'], + ], + }, + }, + { p: 'Les raccourcis globaux se modifient dans **Paramètres › Raccourcis**. Le tableau indique les valeurs par défaut.' }, + { h1: 'Codes pris en charge', appendix: true }, + { + table: { + cols: [30, 70], + head: ['Groupe', 'Formats'], + rows: [ + ['Toujours lus', 'QR Code, Micro QR Code, rMQR Code'], + ['Avec « Lire aussi les codes-barres »', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec et d’autres'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['Contenu reconnu', 'Exemple'], + rows: [ + ['Lien web', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:réseau;P:motdepasse;;`'], + ['Contact', 'vCard (`BEGIN:VCARD`), MeCard (`MECARD:`)'], + ['E-mail', '`mailto:`, `MATMSG:`'], + ['Téléphone et SMS', '`tel:`, `sms:`, `SMSTO:`'], + ['Position', '`geo:25.0330,121.5654`'], + ['Clé de vérification en deux étapes', '`otpauth://`'], + ['Adresse de paiement', '`bitcoin:`, `ethereum:` et d’autres'], + ['Facture électronique de Taïwan', 'Les deux codes QR de la facture'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.ja.js b/docs/manual/build/content.ja.js new file mode 100644 index 0000000..7729ad2 --- /dev/null +++ b/docs/manual/build/content.ja.js @@ -0,0 +1,733 @@ +// QRcode tool ユーザーマニュアル(日本語)の本文。 +// 記法:**太字**、[[キー]]、`コード`。図の名前は shots/<言語>/ のスクリーンショットに対応します(figures.js を参照)。 + +module.exports = { + lang: 'ja', + font: 'Yu Gothic', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-ja', + docTitle: 'QRcode tool ユーザーマニュアル', + cover: { + title: 'QRcode tool', + subtitle: 'ユーザーマニュアル', + tagline: 'スマートフォンと同じくらい手軽に、パソコンで QR コードを読み取れます。', + edition: 'バージョン 1.0.0 | 2026 年 10 月', + platforms: '対応 OS:Windows 10(21H2 以降)/ Windows 11、macOS 13 以降、Linux', + }, + back: { + heading: '読み取って、確かめて、それから開く。', + body: [ + 'QRcode tool は無料のオープンソース デスクトップ スキャナーです。画面、Web カメラ、クリップボード、画像ファイルから QR コードやバーコードを読み取り、リンクを開く前に、よくある手口が使われていないかを Web アドレスごとに確認します。', + 'すべての処理はお使いのパソコンの中で行われます。利用状況のデータは収集せず、読み取った内容をインターネットに送ることもありません。', + ], + links: [ + ['プロジェクトのページ', 'https://github.com/naritaroad/qrcode-tool'], + ['最新リリース', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['問題の報告', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: '本ソフトウェアは MIT または Apache-2.0 ライセンスで公開されています。本マニュアルも同じ条件で複製・改変できます。', + trademark: 'QR コードは株式会社デンソーウェーブ(DENSO WAVE INCORPORATED)の登録商標です。QRcode tool は DENSO WAVE、Google、Microsoft とは関係ありません。', + }, + labels: { + toc: '目次', + chapter: (n) => `第 ${n} 章`, + appendix: (l) => `付録 ${l}`, + figure: (id) => `図 ${id}`, + tip: 'ヒント', + note: '注意', + header: 'QRcode tool ユーザーマニュアル', + tocHint: '(Word では、目次を右クリックして[フィールド更新]を選ぶとページ番号が更新されます。)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'QRcode tool について' }, + { p: 'QRcode tool は、システム トレイに常駐して画面上の QR コードやバーコードを読み取る小さなデスクトップ アプリです。ショートカット キーを押すと画面が一瞬固定され、画面上のすべてのコードに結果ラベルが付きます。ラベルには内容の種類と、リンクの場合は実際のサイト名が表示されます。[[Enter]] を押すかラベルをクリックすると、リンクを開いたり、Wi-Fi に接続したり、連絡先を保存したりできます。' }, + { p: 'Web カメラに向けたコード、クリップボードの画像、画像ファイルも読み取れます。簡単な QR コード作成機能も備えています。' }, + { h2: '主な機能' }, + { + table: { + cols: [26, 74], + head: ['機能', '説明'], + rows: [ + ['画面全体をスキャン', 'すべてのモニターの画面を固定し、すべてのコードを自動で見つけてラベルを付けます。動画やゲームの画面にも使えます。'], + ['範囲を選択', '1 つのコードをドラッグで囲みます。小さすぎる、ぼやけている、傾いているなどの理由で自動では見つからないコードに使います。'], + ['Web カメラ', '印刷されたコードやスマートフォンの画面をカメラに向けると、認識された時点で結果が表示されます。'], + ['クリップボードと画像ファイル', 'コピーしたばかりのスクリーンショットや、PNG、JPEG、BMP、GIF、WebP ファイルを読み取ります。'], + ['内容を理解', 'Web リンク、Wi-Fi、連絡先、メール、電話番号、SMS、地図上の位置、2 段階認証のキー、支払い先アドレス、台湾の電子インボイスを認識し、それぞれに合ったボタンを表示します。'], + ['リンクの安全チェック', 'リンクを開く前に、暗号化されていない接続、偽装されたアドレス、よく似た文字、IP アドレス、短縮リンクなどのよくある手口を確認します。チェックはすべてオフラインで行います。'], + ['QR コードの作成', 'テキストやリンクから QR コードを作り、コピーしたり PNG / SVG で保存したりできます。'], + ['フローティング ツールバーとバブル', '画面の上部(横向き)または左右の端(縦向き)に置けるツールバーです。小さな丸いバブルに折りたたむこともできます。'], + ['対応言語', '英語、繁体字中国語、簡体字中国語、日本語、韓国語、スペイン語、ポルトガル語(ブラジル)、フランス語、ドイツ語、ロシア語。'], + ], + }, + }, + { h2: 'システム要件' }, + { + table: { + cols: [30, 70], + head: ['OS', '要件と注意事項'], + rows: [ + ['Windows', 'Windows 10 21H2 以降、Windows 11。x64 と ARM64。インストールに管理者権限は不要です。'], + ['macOS', 'macOS 13 以降(Apple シリコンと Intel)。最初のスキャンには「画面収録」の許可が、Web カメラでのスキャンには「カメラ」の許可が必要です。'], + ['Linux', 'X11 ではすべての機能が使えます。Wayland では、デスクトップの設定で登録したキーボード ショートカットからスキャンを開始します(第 4 章を参照)。'], + ['ハードウェア', '一般的な事務用パソコンで動作します。Web カメラは任意です。待機中のメモリ使用量は約 30 MB 未満です。'], + ], + }, + }, + { h2: 'プライバシーと安全の原則' }, + { + ul: [ + 'デコードとリンクのチェックはお使いのパソコンの中で行います。読み取った内容をアップロードすることはなく、アドレスの評判を Web サービスに問い合わせることもありません。', + 'ネットワーク接続は、任意の自動更新確認だけです。新しいバージョンがあるかどうかを GitHub に問い合わせます。', + 'スキャン履歴は既定でオフです。オンにしても、Wi-Fi のパスワードと 2 段階認証のキーは保存されません。', + '開けるのは `http` と `https` のアドレスだけです。それ以外のリンクはコピーのみ可能で、システムに渡されることはありません。', + '警告のあるリンクは、必ず先に詳細を表示し、あなたの操作を待ちます。', + ], + }, + { h2: 'このマニュアルの表記' }, + { + ul: [ + 'ボタン、オプション、ウィンドウ名は**太字**で示します。例:**設定**、**画面全体をスキャン**。', + 'キーはキーの形で示します。例:[[Enter]]、[[Ctrl+Alt+Q]]。', + '**設定 › 全般**は、**設定**ウィンドウを開き、左側で**全般**ページを選ぶことを表します。', + '画面写真は Windows 11 のものです。macOS と Linux でも操作は同じで、ウィンドウの枠やシステム メニューの見た目だけが異なります。', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'インストールと初回起動' }, + { h2: 'ダウンロードとインストール(Windows)' }, + { + ol: [ + 'GitHub のリリース ページ(https://github.com/naritaroad/qrcode-tool/releases/latest)を開きます。', + 'ほとんどのパソコンでは `QRcodeTool-win-x64-Setup.exe` を、ARM プロセッサのパソコンでは `QRcodeTool-win-arm64-Setup.exe` をダウンロードします。', + 'ダウンロードしたファイルを実行します。QRcode tool はお使いのユーザー アカウントにだけインストールされ、管理者権限は必要ありません。', + 'セットアップが終わると QRcode tool が起動し、ようこそ画面が表示されます。', + ], + }, + { tip: 'インストールしたくない場合は、`Portable.zip` をダウンロードして展開し、プログラムを直接実行してください。ポータブル版は自動更新できません。' }, + { h2: '「Windows によって PC が保護されました」と表示された場合' }, + { p: '現在のリリースはまだコード署名されていないため、Windows SmartScreen が「不明な発行元」と警告することがあります。署名のない新しいプログラムではよくあることです。' }, + { + ol: [ + '警告の中の**詳細情報**をクリックします。', + 'アプリ名が QRcode tool であることを確認し、**実行**をクリックします。', + ], + }, + { p: 'ダウンロードしたファイルが改ざんされていないことを確かめるには、PowerShell で次のコマンドを実行し、結果をリリース ページの `SHA256SUMS` ファイルと比べてください。' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS と Linux' }, + { p: '**macOS:**`.pkg` ファイルをダウンロードしてインストールします。リリースはまだ Apple の公証を受けていないため、初回はアプリを右クリックして**開く**を選んでください。最初のスキャンのときに、**システム設定 › プライバシーとセキュリティ › 画面収録**で QRcode tool を許可します。Web カメラを使う場合は**カメラ**でも許可します。' }, + { p: '**Linux:**`.AppImage` ファイルをダウンロードし、実行権限を付けて実行します。GNOME でトレイ アイコンを表示するには「AppIndicator and KStatusNotifierItem Support」拡張機能が必要です。' }, + { h2: 'ようこそ画面' }, + { p: '初回起動時にはようこそ画面が表示されます。よく使う 3 つのスキャン方法とそのショートカット キーを示し、リンクが勝手に開くことはないと説明します。' }, + { fig: 'welcome', cap: '初回起動時のようこそ画面', width: 11 }, + { + ul: [ + '**言語:**既定では OS の設定に従います。ここで変更するとすぐに反映されます。', + '**スタートアップ時に起動:**ショートカット キーをいつでも使えるよう、既定でオンです。ここで、または後で**設定 › 全般**でオフにできます。', + '**今すぐ試す:**ようこそ画面を閉じ、画面全体を 1 回スキャンします。', + '**閉じる:**ようこそ画面を閉じ、フローティング ツールバーを表示します。', + ], + }, + { p: 'ようこそ画面をもう一度見るには、**設定 › 全般**を開き、**ようこそ画面をもう一度表示**をクリックします。' }, + { h2: 'トレイ アイコン' }, + { p: 'QRcode tool には従来のようなメイン ウィンドウがありません。起動するとタスク バー右端のシステム トレイにアイコンが表示され、すべての機能はここから使えます。' }, + { + ul: [ + '**アイコンをクリック:**すぐに画面全体をスキャンします。', + '**右クリック:**メニューを開きます(図 2-2)。', + '**アイコンにポインターを置く:**現在のスキャン用ショートカット キーを表示します。', + ], + }, + { fig: 'tray-menu', cap: 'トレイ アイコンのメニュー', width: 11 }, + { tip: 'Windows は新しいトレイ アイコンを「^」の矢印の中に隠すことがあります。アイコンをタスク バーにドラッグすると、常に表示されるようになります。' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: '画面のスキャン' }, + { h2: '画面全体をスキャン' }, + { + ol: [ + 'QR コードを含む Web ページ、文書、動画、画像が画面に表示されていることを確認します。', + '[[Ctrl+Alt+Q]] を押すか、トレイ アイコンをクリックするか、フローティング ツールバーの**画面全体をスキャン**をクリックします。', + '画面が固定されて暗くなります。短いスキャン アニメーションの後、見つかったコードにそれぞれ結果ラベルが付きます。', + '[[Enter]] を押して選択中のコードを開くか、目的のラベルをクリックします。', + '[[Esc]] を押すか右クリックすると、スキャン画面を終了します。', + ], + }, + { fig: 'scan-screen', cap: '画面全体をスキャン:すべてのコードにラベルが付き、最初のコードが選択されている' }, + { p: '上部の状態表示に、見つかったコードの数が表示されます。各コードを囲む括弧の色はチェックの結果を表します。' }, + { + table: { + cols: [22, 78], + head: ['括弧の色', '意味'], + rows: [ + ['白', '不審な点は見つかりませんでした。'], + ['アクセント カラー(青)', '選択中のコードです。[[Enter]] で開きます。'], + ['黄', '注意が必要な点があります。たとえば暗号化されていない http リンクや短縮リンクです。理由はラベルの下に表示されます。'], + ['赤', 'リンクに欺く意図がありそうです。たとえば偽装されたアドレスや、複数の文字体系を混ぜたドメインです。'], + ], + }, + }, + { p: '画面が固定されるので、動画、プレゼンテーション、ゲームの中のコードも読み取れます。モニターが複数ある場合は、すべて同時にスキャンします。' }, + { h2: '範囲を選択' }, + { p: 'コードが小さい、ぼやけている、傾いている場合や、画面にコードがたくさんある場合は、必要なコードだけを枠で囲みます。選択した範囲は拡大してから読み取るため、読み取りにくいコードでは画面全体のスキャンよりうまくいきます。' }, + { + ol: [ + '[[Ctrl+Alt+A]] を押すか、トレイ メニューまたはフローティング ツールバーで**範囲を選択**を選びます。', + '画面が固定され、ポインターが十字になります。マウスの左ボタンを押したまま、コードを囲むようにドラッグします。', + 'マウス ボタンを離します。枠の中だけが読み取られます。', + ], + }, + { fig: 'scan-region', cap: '範囲を選択:ドラッグ中は枠のサイズが表示される' }, + { tip: '枠はコードより少し大きめにしてください。周囲に余白があると読み取りやすくなります。「その範囲にコードがありません」と表示されたら、少し大きめに囲み直してください。' }, + { h2: 'スキャン画面のツールバー' }, + { p: 'スキャン画面の上部にはボタンが並んでいます。左から順に、**画面全体をスキャン**、**範囲を選択**、**カメラでスキャン**、**クリップボードの画像をスキャン**、**画像を開く…**、**QR コードを作成…**、**履歴**、**設定**、**閉じる**です。スキャン画面を閉じずに、たとえば画面全体から範囲選択へ方法を切り替えられます。ボタンにポインターを置くと、説明とショートカット キーが表示されます。' }, + { h2: 'キーボード操作' }, + { p: 'スキャン画面はキーボードだけで操作できます。' }, + { + table: { + cols: [30, 70], + head: ['キー', '操作'], + rows: [ + ['[[Enter]]', '選択中のコードを開く。'], + ['[[Tab]]、[[→]]、[[↓]]', '次のコードを選択する。'], + ['[[Shift+Tab]]、[[←]]、[[↑]]', '前のコードを選択する。'], + ['[[C]]', '選択中のコードをコピーする。'], + ['[[F]] または [[F5]]', '画面全体をもう一度検索する。'], + ['[[Esc]]', 'キャンセルしてスキャン画面を終了する(右クリックでも可)。'], + ], + }, + }, + { h2: 'コードが見つからないとき' }, + { + ul: [ + '**範囲を選択**を使い、コードだけを枠で囲みます。囲んだ範囲は拡大してから読み取られます。', + '動画の中でコードが速く動いている場合は、先に動画を一時停止します。', + 'コードの一部を隠している他のウィンドウやマウス ポインターなどをどかします。', + 'バーコードや Data Matrix などの形式を読み取る場合は、**設定 › スキャン › バーコードも読み取る**がオンになっていることを確認します。', + 'コードが画面上でとても小さい(幅が約 40 ピクセル未満)場合は、先にページや画像を拡大します。', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'そのほかのスキャン方法' }, + { h2: 'Web カメラ' }, + { p: '紙や名刺、ほかのスマートフォンの画面に表示されたコードは Web カメラで読み取れます。' }, + { + ol: [ + '[[Ctrl+Alt+W]] を押すか、**カメラでスキャン**を選びます。', + 'コードをカメラから 15~30 cm ほど離してかざします。', + 'コードが認識されると周りに括弧が表示され、結果ラベルが画像の下部にある固定のリストに並びます。', + 'ラベルをクリックするか、[[Tab]] で選んで [[Enter]] を押します。', + ], + }, + { fig: 'camera', cap: 'カメラでスキャン:結果は下部の固定リストに残る', width: 13 }, + { + ul: [ + '誤読を防ぐため、コードが連続する複数のフレームで認識されてからリストに表示されます。', + 'コードが画面から外れても、結果はしばらく(既定では 8 秒)リストに残るので、まだクリックできます。時間は**設定 › カメラ**で変更できます。', + 'カメラが複数接続されている場合は、ウィンドウ下部のリストで切り替えます。', + '**左右反転**スイッチは表示の仕方を変えるだけで、どちらでも認識できます。', + '既定では、コードを開いた後にカメラ ウィンドウが閉じます。**設定 › カメラ**で変更できます。', + ], + }, + { note: 'カメラが起動しない場合は、カメラを使っている可能性のある他のプログラム(ビデオ通話など)を終了し、システムのプライバシー設定で QRcode tool にカメラの使用を許可してください。' }, + { h2: 'クリップボードの画像' }, + { + ol: [ + '[[Win+Shift+S]] などのスクリーンショット ツールでコードを撮るか、Web ページの画像をコピーします。', + '**クリップボードの画像をスキャン**を選びます。', + '画像がプレビュー ウィンドウに表示され、見つかったコードそれぞれに結果ラベルが付きます。', + ], + }, + { p: 'クリップボードに画像がない場合は、先にスクリーンショットや画像をコピーするよう案内が表示されます。' }, + { h2: '画像ファイル' }, + { + ol: [ + '**画像を開く…**を選びます。', + 'PNG、JPEG、BMP、GIF、WebP のいずれかのファイルを選びます。', + 'プレビュー ウィンドウで結果ラベルをクリックします。下部のボタンで別の画像を開いたり、代わりにクリップボードをスキャンしたりできます。', + ], + }, + { fig: 'image-preview', cap: 'プレビュー ウィンドウ:画像の中のコードにラベルが付く', width: 13 }, + { h2: 'Windows の右クリック メニュー' }, + { p: 'Windows では、QRcode tool の主な機能をエクスプローラーの右クリック メニュー(コンテキスト メニュー)に追加できます。デスクトップの何もないところを右クリックすれば画面をスキャンでき、画像を右クリックすればそのファイルをスキャンできます。ツールバーを開いたり、ショートカット キーを覚えたりする必要はありません。' }, + { + figs: [ + ['shell-desktop', 'デスクトップの背景を右クリック'], + ['shell-image', '画像を 1 つ右クリック'], + ], + cap: '右クリック メニューの QRcode tool の項目(Windows 11、その他のオプションを確認)', + }, + { h3: '右クリック メニューのオン/オフ' }, + { p: '右クリック メニューは既定で**オン**です。QRcode tool をインストールして一度起動すると、項目が表示されます。以前にオフにした場合は、次の手順でオンに戻します。' }, + { + ol: [ + 'トレイ メニューまたはフローティング ツールバーから**設定**を開きます。', + '左側で**全般**を選びます。', + '**右クリックメニュー**をオンにします。変更はすぐに反映され、パソコンやエクスプローラーを再起動する必要はありません。', + ], + }, + { p: '同じスイッチをオフにすると項目が削除されます。項目はあなた自身のユーザー設定(レジストリの HKEY_CURRENT_USER)に保存されるため、管理者権限は不要で、このパソコンの他のアカウントにも影響しません。' }, + { h3: 'メニューの開き方' }, + { + ul: [ + '**Windows 11:**右クリックしてから、一番下の**その他のオプションを確認**を選びます。QRcode tool の項目は完全なメニューの中にあります。完全なメニューを直接開くには、[[Shift]] を押しながら右クリックするか、[[Shift+F10]] を押します。', + '**Windows 10:**右クリックするとすぐに QRcode tool の項目が表示されます。', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['メニュー項目', '場所', '操作'], + rows: [ + ['QRcode tool 画面をスキャン', 'デスクトップの背景', '画面全体をスキャンします([[Ctrl+Alt+Q]] と同じ)。'], + ['QRcode tool 範囲をスキャン', 'デスクトップの背景', '画面を固定して範囲を選択できるようにします([[Ctrl+Alt+A]] と同じ)。'], + ['QRcode tool カメラでスキャン', 'デスクトップの背景', 'Web カメラを開きます([[Ctrl+Alt+W]] と同じ)。'], + ['QRcode tool ツールバー', 'デスクトップの背景', 'フローティング ツールバーを表示します。'], + ['QRcode tool 画像を開く', '画像ファイル', 'プレビュー ウィンドウで画像をスキャンします。PNG、JPEG、BMP、GIF、WebP に対応しています。'], + ], + }, + }, + { + ul: [ + 'デスクトップ用の 4 つの項目は、メニューの下部に区切り線で囲まれてまとまり、QRcode tool のアイコンが付いています。', + '**QRcode tool 画像を開く**は、画像がちょうど**1 つ**選択されているときにだけ表示され、複数のファイルを選んだときには表示されません。', + '項目は QRcode tool の表示言語で表示されます。**設定 › 全般 › 言語**を変更すると、メニューも更新されます。', + 'QRcode tool が起動していない場合は、項目を選ぶとプログラムが起動してその機能を実行します。起動中の場合は、動いているプログラムが処理します。', + 'ポータブル版では、項目はプログラムの現在の場所を指します。ポータブル版のフォルダーを移動した後は、一度プログラムを起動して項目を更新してください。', + 'QRcode tool をアンインストールすると項目も削除されます。macOS と Linux には右クリック メニューの項目がないので、ショートカット キーかコマンド ラインを使ってください。', + ], + }, + { tip: 'メニューに QRcode tool が見当たらない場合:**設定 › 全般 › 右クリックメニュー**がオンになっていることを確認し、Windows 11 では**その他のオプションを確認**を選び、インストールや移動をした直後なら一度 QRcode tool を起動してください。' }, + { h2: 'コマンド ライン' }, + { p: 'すべてのスキャン機能はコマンドでも開始できます。プログラムがすでに起動している場合は、コマンドがそのプログラムに渡されます。Wayland を使う Linux では特に便利で、デスクトップのキーボード設定でこれらのコマンドをカスタム ショートカットに割り当てられます。' }, + { + table: { + cols: [42, 58], + head: ['コマンド', '操作'], + rows: [ + ['`qrcode-tool`', 'プログラムを起動します。すでに起動している場合はフローティング ツールバーを表示します。'], + ['`qrcode-tool scan-screen`', '画面全体をスキャンします。'], + ['`qrcode-tool scan-region`', '画面を固定して範囲を選択します。'], + ['`qrcode-tool scan-camera`', 'Web カメラでスキャンします。'], + ['`qrcode-tool scan-clipboard`', 'クリップボードの画像をスキャンします。'], + ['`qrcode-tool scan-file ファイル`', 'プレビュー ウィンドウで画像ファイルを 1 つスキャンします。'], + ['`qrcode-tool toolbar`', 'フローティング ツールバーの表示/非表示を切り替えます。'], + ['`qrcode-tool bubble`', 'フローティング バブルの表示/非表示を切り替えます。'], + ['`qrcode-tool generate "テキスト"`', 'テキストを入力した状態で QR コード作成画面を開きます。'], + ['`qrcode-tool settings`', '設定を開きます。'], + ['`qrcode-tool decode ファイル… [--json]`', 'UI を起動せずに、画像ファイル内のコードをターミナルに出力します。'], + ['`qrcode-tool quit`', '起動中のプログラムを終了します。'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: '結果と詳細' }, + { h2: '結果ラベル' }, + { p: '見つかったコードにはそれぞれ暗い色の結果ラベルが付きます。左から順に次の内容が表示されます。' }, + { + ul: [ + '**アイコン:**内容の種類です。たとえばリンクは地球儀、Wi-Fi は電波、連絡先は人の形です。警告のあるリンクでは、代わりに警告や危険の記号が表示されます。', + '**メインのテキスト:**リンクの場合は完全なアドレスではなく実際のサイト名、Wi-Fi の場合はネットワーク名、連絡先の場合は名前です。', + '**2 行目:**内容の種類、または警告の主な理由です。', + '**› ボタン:**内容にかかわらず、常に詳細カードを開きます。', + ], + }, + { h2: 'Enter やクリックで起こること' }, + { + table: { + cols: [36, 64], + head: ['内容', '操作'], + rows: [ + ['警告のないリンク', '既定のブラウザーで開きます。'], + ['警告のあるリンク', '先に詳細カードを表示し、あなたが確認してからリンクを開きます。'], + ['それ以外のすべて', '詳細カードを表示し、そこで何をするかを選びます。'], + ], + }, + }, + { h2: '詳細カード' }, + { p: '詳細カードにはコードのすべての項目が並び、内容に合ったボタンが表示されます。項目の横のコピー ボタンは、その項目だけをコピーします。パスワードなどの機密情報は「••••」で隠され、鍵のボタンで一時的に表示できます。カードの外側をクリックするか**閉じる**をクリックすると、結果に戻ります。' }, + { fig: 'detail-wifi', cap: 'Wi-Fi コードの詳細カード:「接続」でネットワークに参加する', width: 12 }, + { h2: '内容の種類ごとのボタン' }, + { + table: { + cols: [30, 70], + head: ['種類', 'ボタン'], + rows: [ + ['リンク', '**開く**、**コピー**。まだ信頼していないサイトへの警告のないリンクには、**このサイトを常に許可**も表示されます。'], + ['Wi-Fi ネットワーク', '**接続**(システムがネットワーク プロファイルを作成)、**パスワードをコピー**。'], + ['連絡先(vCard、MeCard)', '**連絡先を保存**(アドレス帳に取り込める .vcf ファイルを保存)、**コピー**。'], + ['メール', '**メールを作成**(既定のメール アプリを開く)、**コピー**。'], + ['電話番号', '**電話をかける**(システムの通話アプリに渡す)、**コピー**。'], + ['SMS メッセージ', '**メッセージを送信**、**コピー**。'], + ['位置情報', '**地図を開く**、**コピー**。'], + ['2 段階認証のキー', 'サービス名とアカウントだけが表示され、**コピー**できます。秘密の値そのものは表示も保存もされません。'], + ['支払い先アドレス', '**コピー**。送金する前に、必ず支払い先アドレスを再確認してください。'], + ['電子インボイス(台湾)', '**インボイス番号をコピー**、**コピー**。'], + ['ブロックされたリンク', '`http` と `https` 以外のリンク(`file:` や `javascript:` など)はコピーのみ可能で、開くことはできません。'], + ['テキストとバーコード', '**コピー**。バーコードの場合は EAN-13 などの形式も表示されます。'], + ], + }, + }, + { h2: '台湾の電子インボイス' }, + { p: '台湾の電子インボイス(電子發票)には、2 つの QR コードが左右に並んでいます。左のコードにはインボイス番号、日付、金額、一部の品目が、右のコードには残りの品目が入っています。**画面全体をスキャン**や**画像を開く…**で両方のコードが見つかると、1 枚のインボイスにまとめられ、詳細カードにインボイス番号、日付、ランダム コード、合計、税額、販売者と購入者の統一番号、すべての品目が表示されます。左のコードだけが見つかった場合は、右のコードもスキャンするよう表示されます。' }, + { h2: '機密データ' }, + { p: '2 段階認証のキーと Wi-Fi のパスワードは機密データです。スキャン履歴や**結果を自動的にコピーする**をオンにしていても、履歴に書き込まれることも、自動でコピーされることも、プログラムのログ ファイルに書き込まれることもありません。' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'リンクの安全' }, + { p: '悪意のある QR コードは、偽のサイトへ誘導することがよくあります。QRcode tool は結果を表示する前に、すべての Web アドレスをお使いのパソコンの中で分析し、見つかった問題を結果ラベルと詳細カードに直接表示します。オンラインで調べることはなく、どのアドレスもどのサービスにも送りません。' }, + { h2: '開く前にサイト名を確認' }, + { p: '結果ラベルには、アドレスに含まれる実際のサイト名が表示されます。リンクを開く前に、それが目的のサイトであることを確認してください。警告のあるリンクは先に詳細カードを表示し、上部の色付きの注意書きで何に気をつけるべきかを説明します。' }, + { fig: 'detail-warning', cap: '警告のあるリンク:暗号化されていない短縮リンクは理由を表示して操作を待つ', width: 12 }, + { h2: '警告のレベル' }, + { + table: { + cols: [18, 82], + head: ['レベル', 'プログラムの動作'], + rows: [ + ['情報', 'たとえば非常に長いアドレスです。詳細カードに表示されるだけで、[[Enter]] でそのままリンクを開きます。'], + ['警告', '黄色の括弧とアイコン。[[Enter]] やクリックで先に詳細カードを表示し、その後あなたが**開く**をクリックします。'], + ['危険', '赤い括弧とアイコン。**開く**は既定のボタンではなくなり、クリックした後に**このまま開く**でもう一度確認する必要があります。'], + ], + }, + }, + { h2: 'チェックの内容' }, + { + table: { + cols: [30, 12, 58], + head: ['表示されるメッセージ', 'レベル', '説明とアドバイス'], + rows: [ + ['暗号化されていません (http)', '警告', '接続が暗号化されていないため、途中でデータを読まれたり書き換えられたりするおそれがあります。このようなページでパスワードや支払い情報を入力しないでください。'], + ['偽装されたアドレス', '危険', '信頼できそうな名前が「@」の前に置かれていますが、実際には後ろのサイトに移動します。例:`https://bank.example.com@login-check.example.net/`。'], + ['国際化ドメイン名', '警告', 'ドメインにラテン文字以外が含まれています。確認できるよう、エンコードされた実際のアドレス(`xn--` で始まる)もカードに表示されます。'], + ['よく似た文字', '危険', 'ドメインの一部で文字体系が混ざっています。たとえばラテン文字の「a」の代わりにキリル文字の「а」が使われています。偽サイトによくある手口です。'], + ['IP アドレス', '警告', 'サイト名の代わりに数字が使われています。一般的な Web サイトではあまり見られません。'], + ['通常とは異なるポート', '警告', 'アドレスに標準以外のポート番号が指定されています。'], + ['短縮リンク', '警告', 'bit.ly などのサービスは実際のリンク先を隠します。オンラインで展開するとサービスに何をスキャンしたかが伝わってしまうため、展開は行いません。短縮リンクは信頼できる提供元のものだけを開いてください。'], + ['非常に長いアドレス', '情報', '非常に長いアドレスは、実際のサイト名を見えない位置に押し出すことがあります。'], + ['エンコードされた文字が多い', '情報', '多数の「%」エスケープは、アドレスの中身を隠すために使われることがあります。'], + ['サブドメインが多い', '情報', 'たとえば `login.bank.example.com.secure-check.example.net` は、ぱっと見では銀行のサイトのように見えることがあります。'], + ], + }, + }, + { h2: '欺くリンク' }, + { p: '**危険**と判定されたリンクでは、詳細カードに赤字で「欺くリンクの可能性がある」と表示され、その理由が並びます。コードの横に印刷された文字ではなく、カードに表示される実際のサイト名を信頼してください。' }, + { fig: 'detail-danger', cap: '偽装されたアドレス:銀行に見えるが、実際は login-check.example.net に移動する', width: 12 }, + { p: 'それでも続ける場合は**開く**をクリックします。カードがもう一度確認し、**このまま開く**を選んだときだけページが開きます。' }, + { h2: '信頼済みサイトと自動で開く機能' }, + { p: '学校や会社のドメインなど、よく使うサイトを信頼済みサイトに追加できます。次の条件をすべて満たすと、[[Enter]] を待たずにスキャン直後にリンクが開きます。' }, + { + ul: [ + '見つかったコードが 1 つだけである。', + 'リンクに警告がない。', + 'サイト(またはそのサブドメイン)が信頼済みリストにある。', + '**設定 › スキャン › 信頼済みサイトを確認なしで開く**がオンになっている(既定)。', + ], + }, + { p: '警告のないリンクの詳細カードで**このサイトを常に許可**をクリックするか、**設定 › スキャン**でドメインを入力してサイトを追加します。' }, + { fig: 'detail-link', cap: '警告のないリンク:そのまま開くか、サイトを信頼済みリストに追加する', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'フローティング ツールバーとバブル' }, + { p: 'フローティング ツールバーは他のウィンドウより手前に表示され、すべての機能にワン クリックでアクセスできます。スキャン用のスクリーンショットに写り込むことはありません。トレイ メニューの**フローティング ツールバー**、ショートカット キー [[Ctrl+Alt+E]]、またはコマンド `qrcode-tool toolbar` で表示/非表示を切り替えます。' }, + { h2: 'ツールバーのボタン' }, + { fig: 'toolbar-row', cap: '横向きのツールバー:ボタンにポインターを置くと、下に名前とショートカット キーが表示される', width: 11 }, + { + table: { + cols: [34, 66], + head: ['ボタン', '操作'], + rows: [ + ['(先頭の点線のつまみ)', '押したままドラッグするとツールバーを移動できます。'], + ['画面全体をスキャン', '[[Ctrl+Alt+Q]] と同じです。'], + ['範囲を選択', '[[Ctrl+Alt+A]] と同じです。'], + ['カメラでスキャン', '[[Ctrl+Alt+W]] と同じです。カメラが見つからないときは灰色になります。'], + ['クリップボードの画像をスキャン', 'クリップボードの画像を読み取ります。'], + ['画像を開く…', '画像ファイルを選んでスキャンします。'], + ['QR コードを作成…', 'QR コード作成画面を開きます。'], + ['履歴', '**設定 › プライバシーと履歴**を開きます。'], + ['設定', '設定を開きます。'], + ['ユーザーマニュアル(「?」ボタン)', 'GitHub 上の PDF 版ユーザーマニュアルを、表示言語と同じ言語でブラウザーの新しいタブに開きます。'], + ['バブルに折りたたむ', 'ツールバーを隠し、代わりに小さな丸いバブルを表示します。'], + ['ツールバーを閉じる', 'ツールバーを隠します(バブルは表示されません)。プログラムはトレイで動き続けます。'], + ], + }, + }, + { h2: '縦向きのツールバー(右側または左側)' }, + { p: '画面上部の横向きの配置(既定)のほか、画面の右端または左端に縦一列で置くこともできます。縦向きは幅を取らないため、横長の画面に向いており、Web ページの上部も隠れません。' }, + { + figs: [ + ['toolbar-right', '縦向き(右側):縦向きの既定の位置'], + ['toolbar-left', '縦向き(左側)'], + ], + cap: '縦向きのツールバー:ポインターを置いたボタンの名前とショートカット キーがボタンの下に表示される', + }, + { p: '配置を変更するには:' }, + { + ol: [ + '**設定**を開き、**全般**を選びます。', + '**フローティング ツールバーとバブル**のセクションで**ツールバーの配置**を探します。', + '**横向き(上部)**、**縦向き(右側)**、**縦向き(左側)**のいずれかを選びます。', + ], + }, + { p: '変更はすぐに反映されます。ツールバーは新しい配置の既定の位置に移動します。横向きなら上部中央、縦向きなら選んだ端の上下中央です。その後も好きな位置にドラッグできます。' }, + { h2: 'ツールバーの移動' }, + { p: 'ツールバーの端にある点線のつまみを押したままドラッグします。最後の位置が記憶され、次回もそこに表示されます。外部ディスプレイを外した後など、その位置がどのモニターにも含まれなくなった場合は、既定の位置に戻ります。' }, + { h2: 'フローティング バブル' }, + { p: 'フローティング バブルは、ツールバーを折りたたんだものです。小さな円だけを占め、既定では画面の右端に表示されます。' }, + { fig: 'bubble', cap: 'フローティング バブル', width: 8 }, + { + table: { + cols: [30, 70], + head: ['操作', '結果'], + rows: [ + ['クリック', 'フローティング ツールバー全体に展開します。'], + ['約 0.5 秒押し続ける', '画面全体をスキャンします。'], + ['右クリック', 'メニューを開きます:**画面全体をスキャン**、**範囲を選択**、**カメラでスキャン**、**クリップボードの画像をスキャン**、**ツールバーを表示**、**バブルを非表示**。'], + ['ドラッグ', 'バブルを移動します。'], + ], + }, + }, + { p: 'プログラムを起動するたびにバブルを表示するには、**設定 › 全般 › アプリの起動時にバブルを表示する**をオンにします。ツールバーとバブルが同時に表示されることはありません。' }, + { h2: '全画面アプリの使用中は非表示' }, + { p: 'Windows では、全画面で動画を見たり、プレゼンテーションをしたり、ゲームをしたりしている間はツールバーとバブルが隠れ、全画面を終えると戻ってきます。この動作は**設定 › 全般 › 全画面アプリの使用中は非表示にする**でオフにできます。' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'QR コードの作成' }, + { p: 'QR コード作成機能は、リンクやテキストを QR コードに変換します。スマートフォンで読み取ったり、文書やプレゼンテーションに貼り付けたりできます。' }, + { + ol: [ + 'トレイ メニュー、フローティング ツールバー、またはスキャン画面で**QR コードを作成…**を選びます。', + '**テキストまたはリンク**に内容を入力するか貼り付けます。右側にすぐ QR コードが表示されます。', + '必要に応じて**誤り訂正**のレベルを選びます。', + '**画像をコピー**でクリップボードにコピーするか、**PNG を保存…**または**SVG を保存…**でファイルに保存します。', + ], + }, + { fig: 'generator', cap: 'QR コード作成画面', width: 13 }, + { h2: '誤り訂正' }, + { p: 'レベルが高いほど、コードの一部が汚れたりロゴで隠れたりしても読み取れますが、コードは細かく大きくなります。' }, + { + table: { + cols: [36, 64], + head: ['レベル', '使いどころ'], + rows: [ + ['低 — 最も小さいコード', '内容が多く、画面に表示するだけの場合。'], + ['中 — 推奨', '一般的な用途の既定値。'], + ['やや高', 'こすれる可能性のある物に印刷するコード。'], + ['高 — 汚れやロゴがあっても読み取り可能', 'コードの中央にロゴを置く場合や、最大限の読み取りやすさが必要な場合。'], + ], + }, + }, + { note: '1 つの QR コードに入れられる量には限りがあります。「1 つの QR コードに入りきらない長さです」と表示された場合は、内容を短くするか、誤り訂正レベルを下げてください。' }, + { p: '**PNG** は文書やスライドに便利です。**SVG** はベクター形式なので、大きく印刷してもくっきりしています。[[Esc]] で作成画面を閉じます。' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: '設定' }, + { p: 'トレイ メニュー、フローティング ツールバー、またはスキャン画面で**設定**を選びます。変更はすべてすぐに保存・反映され、OK ボタンはありません。' }, + { h2: '全般' }, + { fig: 'settings-general', cap: '設定 › 全般', width: 14 }, + { + table: { + cols: [34, 66], + head: ['設定項目', '説明'], + rows: [ + ['言語', 'メニューとメッセージの言語です。既定では OS に従います。'], + ['テーマ', '**システム設定を使用**、**ライト**、**ダーク**。システムのアクセント カラーは自動で適用されます。'], + ['スタートアップ時に起動', 'サインイン時にバックグラウンドで静かに起動し、ショートカット キーをいつでも使えるようにします。'], + ['右クリックメニュー', '(Windows のみ)デスクトップと画像ファイルの右クリック メニューに QRcode tool の項目を追加します。既定でオンです。第 4 章「Windows の右クリック メニュー」を参照してください。'], + ['ツールバーの配置', '**横向き(上部)**、**縦向き(右側)**、**縦向き(左側)**。第 7 章を参照してください。'], + ['アプリの起動時にバブルを表示する', '起動時にフローティング バブルを表示します。'], + ['全画面アプリの使用中は非表示にする', '(Windows のみ)全画面の動画、プレゼンテーション、ゲームの間、ツールバーとバブルを隠します。'], + ['更新プログラムを自動的に確認する', '1 日に 1 回、新しいバージョンがあるかを GitHub に問い合わせます。確認なしに何かをインストールすることはありません。'], + ['ようこそ画面をもう一度表示', '初回起動時のようこそ画面を開きます。'], + ], + }, + }, + { h2: 'スキャン' }, + { fig: 'settings-scanning', cap: '設定 › スキャン', width: 14 }, + { + table: { + cols: [34, 66], + head: ['設定項目', '説明'], + rows: [ + ['結果を自動的にコピーする', 'コードがちょうど 1 つ見つかったとき、その内容をクリップボードに入れます。機密情報はコピーされません。既定でオフです。'], + ['コードが見つかったときに音を鳴らす', '短い音を鳴らします。既定でオフです。'], + ['バーコードも読み取る', 'QR コードに加えて、EAN、UPC、Code 128、Data Matrix、PDF417、Aztec などを読み取ります。既定でオンです。'], + ['信頼済みサイトを確認なしで開く', '第 6 章に挙げた条件のもとで、信頼済みサイトへのリンクを自動で開きます。'], + ['信頼済みサイト', 'ドメイン(例:example.com)を入力して**追加**をクリックします。サブドメインも信頼されます。ごみ箱アイコンで項目を削除します。'], + ], + }, + }, + { h2: 'カメラ' }, + { fig: 'settings-camera', cap: '設定 › カメラ', width: 14 }, + { + table: { + cols: [34, 66], + head: ['設定項目', '説明'], + rows: [ + ['カメラ', '使用する Web カメラです。'], + ['映像を左右反転する', 'カメラの映像を鏡のように表示します。どちらでも認識できます。'], + ['結果を表示し続ける秒数', 'コードが画面から外れた後、結果をリストに残す時間(0~60 秒)です。0 にすると、現在映っているコードだけが表示されます。'], + ['コードを開いた後にカメラを閉じる', 'コードを開いたり使ったりした後、カメラ ウィンドウを閉じます。'], + ], + }, + }, + { h2: 'ショートカット' }, + { fig: 'settings-shortcuts', cap: '設定 › ショートカット', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['操作', '既定値', '説明'], + rows: [ + ['画面全体をスキャン', '[[Ctrl+Alt+Q]]', 'すべてのモニターを固定してスキャンします。'], + ['範囲を選択', '[[Ctrl+Alt+A]]', '画面を固定し、枠をドラッグできるようにします。'], + ['カメラでスキャン', '[[Ctrl+Alt+W]]', 'Web カメラのウィンドウを開きます。'], + ['ツールバーの表示/非表示', '[[Ctrl+Alt+E]]', 'フローティング ツールバーを切り替えます。'], + ], + }, + }, + { p: 'ショートカット キーを変更するには:' }, + { + ol: [ + '変更したいショートカット キーをクリックします。ボタンに**キーを押してください… (Esc でキャンセル)**と表示されます。', + '新しいキーの組み合わせを押します。[[Ctrl]]、[[Alt]]、[[Shift]]、[[Win]](Mac では [[Cmd]])のいずれか 1 つ以上を含める必要があります。', + '新しいショートカット キーはすぐに有効になります。', + ], + }, + { p: 'その組み合わせを他のアプリがすでに使っている場合は、行に「別のアプリで使用されています — 別のものを選んでください。」と表示されます。別の組み合わせを選んでください。**既定値に戻す**ですべてのショートカット キーを既定に戻せます。下部の**スキャン中**のセクションには、第 3 章と同じスキャン画面のキーが一覧表示されます。' }, + { h2: 'プライバシーと履歴' }, + { fig: 'settings-privacy', cap: '設定 › プライバシーと履歴(履歴をオンにした状態)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['設定項目', '説明'], + rows: [ + ['スキャン履歴を保存する', 'このパソコンにだけ保存されます。Wi-Fi のパスワードと 2 段階認証のキーは保存されません。既定でオフです。'], + ['保存する件数', '5~500 件。古いものから削除されます。'], + ['最近のスキャン', '新しい順に並びます。警告のないリンクは**開く**でもう一度開けます。どの項目も**コピー**でコピーできます。'], + ['履歴を消去', '履歴をすべて削除します。'], + ], + }, + }, + { h2: 'バージョン情報' }, + { fig: 'settings-about', cap: '設定 › バージョン情報', width: 14 }, + { + ul: [ + '現在のバージョンを表示します。**更新プログラムの確認**ですぐに確認します。', + 'ソース コード、問題の報告、プライバシーに関する声明、オープンソース ライセンスへのリンクがあります。', + '**設定フォルダーを開く**と**ログ フォルダーを開く**は、それぞれのフォルダーを直接開きます。設定のバックアップや、問題の報告にログ ファイルを添付するときに使います。', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: '更新とアンインストール' }, + { h2: '更新の確認とインストール' }, + { p: 'インストーラーでインストールしたものは自動で更新できます。**更新プログラムを自動的に確認する**がオンなら、1 日に 1 回 GitHub に問い合わせます。トレイ メニューや**設定 › バージョン情報**の**更新プログラムの確認**で、いつでも確認することもできます。' }, + { fig: 'message-update', cap: '新しいバージョンがあるときのメッセージ', width: 10 }, + { + ol: [ + '**更新プログラムがあります**というメッセージが表示されたら、**今すぐ更新**をクリックします。', + '新しいバージョンがバックグラウンドでダウンロードされ、完了するとプログラムが再起動します。', + '今は更新しない場合は**後で**をクリックします。', + ], + }, + { p: '更新がインストールされるのは**今すぐ更新**をクリックした後だけです。プログラムが勝手に何かをインストールすることはありません。' }, + { h2: 'ポータブル版' }, + { p: 'ポータブル版(`Portable.zip`)は自動更新されません。更新を確認すると「更新は利用できません」と表示されます。GitHub のリリース ページから新しいバージョンをダウンロードし、古いファイルを置き換えてください。設定はそのまま残ります。' }, + { h2: 'アンインストール' }, + { + ol: [ + 'Windows の**設定 › アプリ › インストールされているアプリ**を開きます。', + 'QRcode tool を探し、**…**をクリックして**アンインストール**を選びます。', + 'スタートアップの登録と右クリック メニューの項目も削除されます。', + ], + }, + { p: '設定と履歴も削除したい場合は、アンインストールの前に**設定 › バージョン情報**から設定フォルダーとログ フォルダーを開き、それらを削除してください。' }, + { h2: '設定とログの保存場所' }, + { + table: { + cols: [18, 82], + head: ['システム', '場所'], + rows: [ + ['Windows', '設定:`%APPDATA%\\Lrniey666\\qrcode-tool\\config`\n履歴とログ:`%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', '設定:`~/.config/qrcode-tool`\n履歴とログ:`~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: '設定ファイル `settings.toml` はプレーン テキストです。これをコピーすれば、設定を別のパソコンに移せます。' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'トラブルシューティング' }, + { + qa: [ + ['ショートカット キーを押しても何も起きない。', '他のアプリがすでに使っている可能性があります。**設定 › ショートカット**を開き、行に「別のアプリで使用されています」と表示されていたら、別の組み合わせを選んでください。ゲームやリモート デスクトップのプログラムの中には、前面にある間すべてのキーを取り込むものがあります。'], + ['スキャンしてもコードが見つからない。', '**範囲を選択**でコードだけを囲むか、先にページや画像を拡大してください。第 3 章「コードが見つからないとき」も参照してください。'], + ['リンクがすぐに開かなかったのはなぜ?', '警告のあるリンクは、実際のサイトを確認できるよう必ず先に詳細を表示します。自動で開くのは、警告のない信頼済みサイトへのリンクで、しかも見つかったコードがそれ 1 つだけの場合に限られます。'], + ['「短縮リンク — 実際のリンク先は隠されています」と表示される。', '短縮リンクのサービスは実際のリンク先を隠します。オンラインで調べると何をスキャンしたかが知られてしまうため、プログラムは調べません。短縮リンクは信頼できる提供元のものだけを開いてください。'], + ['メイン ウィンドウはどこ?', '意図的にありません。トレイ アイコン、ショートカット キー、フローティング ツールバー、フローティング バブルを使ってください。'], + ['右クリック メニューに QRcode tool がない。', '**設定 › 全般 › 右クリックメニュー**がオンか確認してください。Windows 11 では項目は**その他のオプションを確認**の中にあります([[Shift]] を押しながら右クリックしても開けます)。**QRcode tool 画像を開く**は画像を 1 つ選択したときだけ表示されます。QRcode tool をインストールした直後やポータブル版を移動した後は、一度起動してください。'], + ['ツールバーが消えた。', '[[Ctrl+Alt+E]] を押すか、トレイ メニューで**フローティング ツールバー**にチェックを入れてください。**全画面アプリの使用中は非表示にする**がオンだと、全画面のプログラムが前面にある間はツールバーが隠れます。'], + ['カメラが起動しない。', 'カメラを使っている他のプログラムを終了し、システムのプライバシー設定で QRcode tool にカメラの使用が許可されているか確認してください。カメラが複数ある場合は、**設定 › カメラ**で正しいものを選んでください。'], + ['Wi-Fi に自動で接続されない。', '企業向け認証などのネットワークは、プログラムからは設定できません。詳細カードで**パスワードをコピー**をクリックし、システムの Wi-Fi メニューから接続してください。'], + ['ウイルス対策ソフトが警告する。', 'ショートカット キーを登録し、画面を読み取り、スタートアップ時に起動する署名のない新しいプログラムは、振る舞い検知で検出されることがあります。QRcode tool は標準的なシステムのインターフェイスを使っており、ソース コードも公開されています。誤検知としてウイルス対策ソフトのベンダーに報告するか、GitHub で issue を作成してください。'], + ['macOS でスクリーンショットが真っ黒になる。', '**システム設定 › プライバシーとセキュリティ › 画面収録**で QRcode tool を許可し、プログラムを再起動してください。システムのアップデート後に再び確認されることがあります。'], + ['Wayland の Linux でショートカット キーが効かない。', 'Wayland ではプログラムがグローバル ショートカットを登録できません。デスクトップのキーボード設定で、`qrcode-tool scan-screen` などのコマンドを実行するカスタム ショートカットを追加してください。'], + ['このマニュアルをもう一度開くには?', 'フローティング ツールバーの **?** ボタン(**ユーザーマニュアル**)をクリックすると、GitHub 上の PDF 版がブラウザーの新しいタブで開きます。Word 版と PDF 版のファイルは GitHub リポジトリの `docs/manual` フォルダーにもあります。'], + ['問題を報告するには?', '**設定 › バージョン情報**で**問題の報告やアイデアの提案**をクリックし、お使いのシステム、操作の手順、表示されたメッセージを書いてください。ログ フォルダーのファイルを添付できます。ログにはイベントとエラーだけが記録され、読み取った内容は含まれません。'], + ], + }, + + // ───────────────────────── 付録 ───────────────────────── + { h1: 'ショートカット キーとキー操作の一覧', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['場面', 'キー', '操作'], + rows: [ + ['どこでも', '[[Ctrl+Alt+Q]]', '画面全体をスキャン'], + ['どこでも', '[[Ctrl+Alt+A]]', '範囲を選択'], + ['どこでも', '[[Ctrl+Alt+W]]', 'カメラでスキャン'], + ['どこでも', '[[Ctrl+Alt+E]]', 'フローティング ツールバーの表示/非表示'], + ['スキャン画面、プレビュー', '[[Enter]]', '選択中のコードを開く'], + ['スキャン画面、プレビュー', '[[Tab]] / [[Shift+Tab]]', '次 / 前のコードを選択'], + ['スキャン画面、プレビュー', '[[C]]', '選択中のコードをコピー'], + ['スキャン画面', '[[F]] または [[F5]]', '画面全体をもう一度検索'], + ['スキャン画面、プレビュー、作成画面', '[[Esc]]', '閉じる'], + ], + }, + }, + { p: 'グローバル ショートカット キーは**設定 › ショートカット**で変更できます。表は既定値です。' }, + { h1: '対応するコード', appendix: true }, + { + table: { + cols: [30, 70], + head: ['グループ', '形式'], + rows: [ + ['常に読み取る', 'QR Code、Micro QR Code、rMQR Code'], + ['「バーコードも読み取る」がオンのとき', 'EAN-13、EAN-8、UPC-A、UPC-E、Code 128、Code 39、Code 93、Codabar、ITF、DataBar、Data Matrix、PDF417、Aztec など'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['認識する内容', '例'], + rows: [ + ['Web リンク', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:ネットワーク名;P:パスワード;;`'], + ['連絡先', 'vCard(`BEGIN:VCARD`)、MeCard(`MECARD:`)'], + ['メール', '`mailto:`、`MATMSG:`'], + ['電話と SMS', '`tel:`、`sms:`、`SMSTO:`'], + ['位置情報', '`geo:25.0330,121.5654`'], + ['2 段階認証のキー', '`otpauth://`'], + ['支払い先アドレス', '`bitcoin:`、`ethereum:` など'], + ['台湾の電子インボイス', 'インボイスに印刷された 2 つの QR コード'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.ko.js b/docs/manual/build/content.ko.js new file mode 100644 index 0000000..a1500fa --- /dev/null +++ b/docs/manual/build/content.ko.js @@ -0,0 +1,733 @@ +// QRcode tool 사용 설명서(한국어) 본문. +// 표기: **굵게**, [[키]], `코드`. 그림 이름은 shots/<언어>/ 의 스크린샷을 가리킵니다(figures.js 참고). + +module.exports = { + lang: 'ko', + font: 'Malgun Gothic', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-ko', + docTitle: 'QRcode tool 사용 설명서', + cover: { + title: 'QRcode tool', + subtitle: '사용 설명서', + tagline: '휴대폰처럼 간편하게, 컴퓨터에서 QR 코드를 스캔하세요.', + edition: '버전 1.0.0 | 2026년 10월', + platforms: 'Windows 10(21H2 이상) / Windows 11, macOS 13 이상, Linux 지원', + }, + back: { + heading: '스캔하고, 확인하고, 그다음에 엽니다.', + body: [ + 'QRcode tool은 무료 오픈 소스 데스크톱 스캐너입니다. 화면, 웹캠, 클립보드, 이미지 파일에서 QR 코드와 바코드를 읽고, 링크를 열기 전에 모든 웹 주소에 흔한 속임수가 있는지 확인합니다.', + '모든 처리는 사용자의 컴퓨터에서 이루어집니다. 프로그램은 사용 데이터를 수집하지 않으며, 스캔한 내용을 인터넷으로 보내지 않습니다.', + ], + links: [ + ['프로젝트 페이지', 'https://github.com/naritaroad/qrcode-tool'], + ['최신 릴리스', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['문제 신고', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: '이 소프트웨어는 MIT 또는 Apache-2.0 라이선스로 배포됩니다. 이 설명서도 같은 조건으로 복사하고 수정할 수 있습니다.', + trademark: 'QR Code는 DENSO WAVE INCORPORATED의 등록 상표입니다. QRcode tool은 DENSO WAVE, Google, Microsoft와 관련이 없습니다.', + }, + labels: { + toc: '목차', + chapter: (n) => `제${n}장`, + appendix: (l) => `부록 ${l}`, + figure: (id) => `그림 ${id}`, + tip: '팁', + note: '참고', + header: 'QRcode tool 사용 설명서', + tocHint: '(Word에서 목차를 마우스 오른쪽 단추로 클릭하고 [필드 업데이트]를 선택하면 페이지 번호가 새로 고쳐집니다.)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'QRcode tool 소개' }, + { p: 'QRcode tool은 시스템 트레이에서 대기하며 화면의 QR 코드와 바코드를 읽는 작은 데스크톱 프로그램입니다. 바로 가기 키를 누르면 화면이 잠시 멈추고, 화면의 모든 코드에 결과 레이블이 붙습니다. 레이블에는 내용의 종류와, 링크라면 실제 사이트 이름이 표시됩니다. [[Enter]]를 누르거나 레이블을 클릭하면 링크를 열거나 Wi-Fi에 연결하거나 연락처를 저장할 수 있습니다.' }, + { p: '웹캠에 비춘 코드, 클립보드의 이미지, 이미지 파일도 읽을 수 있으며, 간단한 QR 코드 생성기도 들어 있습니다.' }, + { h2: '주요 기능' }, + { + table: { + cols: [26, 74], + head: ['기능', '설명'], + rows: [ + ['전체 화면 스캔', '모든 모니터의 화면을 멈추고, 모든 코드를 자동으로 찾아 레이블을 붙입니다. 동영상과 게임 화면에서도 작동합니다.'], + ['영역 선택', '코드 하나를 드래그해서 사각형으로 둘러쌉니다. 너무 작거나 흐리거나 기울어져서 자동으로 찾지 못하는 코드에 사용합니다.'], + ['웹캠', '인쇄된 코드나 휴대폰 화면을 카메라에 비추면, 코드를 인식하는 즉시 결과가 나타납니다.'], + ['클립보드와 이미지 파일', '방금 복사한 스크린샷이나 PNG, JPEG, BMP, GIF, WebP 파일을 읽습니다.'], + ['내용 이해', '웹 링크, Wi-Fi, 연락처, 이메일, 전화번호, 문자 메시지, 지도 위치, 2단계 인증 키, 결제 주소, 대만 전자 영수증을 인식하고, 알맞은 단추를 보여 줍니다.'], + ['링크 안전 검사', '링크를 열기 전에 암호화되지 않은 연결, 위장된 주소, 비슷한 글자, IP 주소, 단축 링크 등 흔한 속임수가 있는지 검사합니다. 모든 검사는 오프라인으로 이루어집니다.'], + ['QR 코드 만들기', '텍스트나 링크를 QR 코드로 바꿔 복사하거나 PNG, SVG로 저장할 수 있습니다.'], + ['플로팅 도구 모음과 버블', '화면 위쪽(가로) 또는 오른쪽·왼쪽 가장자리(세로)에 놓을 수 있는 도구 모음으로, 작은 둥근 버블로 접을 수도 있습니다.'], + ['언어', '영어, 중국어(번체), 중국어(간체), 일본어, 한국어, 스페인어, 포르투갈어(브라질), 프랑스어, 독일어, 러시아어.'], + ], + }, + }, + { h2: '시스템 요구 사항' }, + { + table: { + cols: [30, 70], + head: ['운영 체제', '요구 사항 및 참고'], + rows: [ + ['Windows', 'Windows 10 21H2 이상, Windows 11. x64 및 ARM64. 설치할 때 관리자 권한이 필요하지 않습니다.'], + ['macOS', 'macOS 13 이상(Apple 실리콘 및 Intel). 처음 스캔할 때 화면 기록 권한이, 웹캠으로 스캔할 때 카메라 권한이 필요합니다.'], + ['Linux', 'X11에서는 모든 기능을 사용할 수 있습니다. Wayland에서는 데스크톱 설정에 직접 등록한 키보드 바로 가기로 스캔을 시작합니다(제4장 참고).'], + ['하드웨어', '일반 사무용 컴퓨터면 충분합니다. 웹캠은 선택 사항입니다. 대기 중 메모리 사용량은 약 30MB 미만입니다.'], + ], + }, + }, + { h2: '개인정보 보호와 안전 원칙' }, + { + ul: [ + '디코딩과 링크 검사는 사용자의 컴퓨터에서 이루어집니다. 스캔한 내용은 절대 업로드되지 않으며, 어떤 웹 서비스에도 주소의 평판을 묻지 않습니다.', + '네트워크 연결은 선택 사항인 자동 업데이트 확인뿐이며, 새 버전이 있는지 GitHub에 묻기만 합니다.', + '스캔 기록은 기본적으로 꺼져 있습니다. 켜더라도 Wi-Fi 암호와 2단계 인증 키는 절대 저장되지 않습니다.', + '`http`와 `https` 주소만 열 수 있습니다. 다른 종류의 링크는 복사만 할 수 있으며, 시스템에 넘겨지지 않습니다.', + '경고가 있는 링크는 항상 자세한 내용을 먼저 보여 주고 사용자의 결정을 기다립니다.', + ], + }, + { h2: '이 설명서의 표기법' }, + { + ul: [ + '단추, 옵션, 창 이름은 **굵게** 표시합니다. 예: **설정**, **전체 화면 스캔**.', + '키는 키 모양으로 표시합니다. 예: [[Enter]], [[Ctrl+Alt+Q]].', + '**설정 › 일반**은 **설정** 창을 열고 왼쪽에서 **일반** 페이지를 선택한다는 뜻입니다.', + '그림은 Windows 11 화면입니다. macOS와 Linux에서도 사용 방법은 같으며, 창 테두리와 시스템 메뉴의 모양만 다릅니다.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: '설치와 처음 시작' }, + { h2: '다운로드 및 설치(Windows)' }, + { + ol: [ + 'GitHub의 릴리스 페이지(https://github.com/naritaroad/qrcode-tool/releases/latest)를 엽니다.', + '대부분의 컴퓨터에서는 `QRcodeTool-win-x64-Setup.exe`를, ARM 프로세서 컴퓨터에서는 `QRcodeTool-win-arm64-Setup.exe`를 다운로드합니다.', + '다운로드한 파일을 실행합니다. QRcode tool은 현재 사용자 계정에만 설치되며 관리자 권한이 필요하지 않습니다.', + '설치가 끝나면 QRcode tool이 시작되고 시작 화면이 나타납니다.', + ], + }, + { tip: '설치하고 싶지 않다면 `Portable.zip` 파일을 다운로드해 압축을 풀고 프로그램을 바로 실행하세요. 휴대용 버전은 스스로 업데이트할 수 없습니다.' }, + { h2: '“Windows의 PC 보호”가 표시될 때' }, + { p: '현재 릴리스는 아직 코드 서명이 되어 있지 않아 Windows SmartScreen이 알 수 없는 게시자라고 경고할 수 있습니다. 서명되지 않은 새 프로그램에서는 흔한 일입니다.' }, + { + ol: [ + '경고에서 **추가 정보**를 클릭합니다.', + '앱 이름이 QRcode tool인지 확인한 다음 **실행**을 클릭합니다.', + ], + }, + { p: '다운로드한 파일이 변조되지 않았는지 확인하려면 PowerShell에서 다음 명령을 실행하고, 결과를 릴리스 페이지의 `SHA256SUMS` 파일과 비교하세요.' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS와 Linux' }, + { p: '**macOS:** `.pkg` 파일을 다운로드해 설치합니다. 릴리스가 아직 Apple의 공증을 받지 않았으므로, 처음에는 앱을 마우스 오른쪽 단추로 클릭하고 **열기**를 선택하세요. 처음 스캔할 때 **시스템 설정 › 개인정보 보호 및 보안 › 화면 기록**에서 QRcode tool을 허용하고, 웹캠을 사용하려면 **카메라**에서도 허용합니다.' }, + { p: '**Linux:** `.AppImage` 파일을 다운로드해 실행 권한을 주고 실행합니다. GNOME에서 트레이 아이콘을 표시하려면 “AppIndicator and KStatusNotifierItem Support” 확장 기능이 필요합니다.' }, + { h2: '시작 화면' }, + { p: '처음 시작할 때 시작 화면이 나타납니다. 가장 많이 쓰는 세 가지 스캔 방법과 바로 가기 키를 보여 주고, 링크가 갑자기 열리지 않는다는 점을 설명합니다.' }, + { fig: 'welcome', cap: '처음 시작할 때의 시작 화면', width: 11 }, + { + ul: [ + '**언어:** 기본적으로 운영 체제를 따릅니다. 여기서 바꾸면 바로 적용됩니다.', + '**시작 시 실행:** 바로 가기 키를 언제든 쓸 수 있도록 기본적으로 켜져 있습니다. 여기서 끄거나 나중에 **설정 › 일반**에서 끌 수 있습니다.', + '**지금 사용해 보기:** 시작 화면을 닫고 전체 화면을 한 번 스캔합니다.', + '**닫기:** 시작 화면을 닫고 플로팅 도구 모음을 표시합니다.', + ], + }, + { p: '시작 화면을 다시 보려면 **설정 › 일반**을 열고 **시작 화면 다시 보기**를 클릭하세요.' }, + { h2: '트레이 아이콘' }, + { p: 'QRcode tool에는 일반적인 기본 창이 없습니다. 시작하면 작업 표시줄 오른쪽 끝의 시스템 트레이에 아이콘이 나타나고, 모든 기능을 여기서 사용할 수 있습니다.' }, + { + ul: [ + '**아이콘 클릭:** 바로 전체 화면을 스캔합니다.', + '**마우스 오른쪽 단추 클릭:** 메뉴를 엽니다(그림 2-2).', + '**아이콘에 마우스 올리기:** 현재 스캔 바로 가기 키를 보여 줍니다.', + ], + }, + { fig: 'tray-menu', cap: '트레이 아이콘 메뉴', width: 11 }, + { tip: 'Windows는 새 트레이 아이콘을 “^” 화살표 안에 숨길 수 있습니다. 아이콘을 작업 표시줄로 끌어다 놓으면 항상 보입니다.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: '화면 스캔' }, + { h2: '전체 화면 스캔' }, + { + ol: [ + 'QR 코드가 있는 웹 페이지, 문서, 동영상 또는 그림이 화면에 보이는지 확인합니다.', + '[[Ctrl+Alt+Q]]를 누르거나, 트레이 아이콘을 클릭하거나, 플로팅 도구 모음에서 **전체 화면 스캔**을 클릭합니다.', + '화면이 멈추고 어두워집니다. 짧은 스캔 애니메이션이 지나면 찾은 코드마다 결과 레이블이 붙습니다.', + '[[Enter]]를 눌러 선택된 코드를 열거나, 원하는 레이블을 클릭합니다.', + '[[Esc]]를 누르거나 마우스 오른쪽 단추를 클릭하면 스캔 화면을 닫습니다.', + ], + }, + { fig: 'scan-screen', cap: '전체 화면 스캔: 모든 코드에 레이블이 붙고 첫 번째 코드가 선택됨' }, + { p: '위쪽의 상태 표시에 찾은 코드 수가 나옵니다. 각 코드를 둘러싼 괄호의 색은 검사 결과를 나타냅니다.' }, + { + table: { + cols: [22, 78], + head: ['괄호 색', '의미'], + rows: [ + ['흰색', '의심스러운 점이 없습니다.'], + ['강조색(파란색)', '선택된 코드입니다. [[Enter]]로 엽니다.'], + ['노란색', '주의할 점이 있습니다. 예를 들어 암호화되지 않은 http 링크나 단축 링크입니다. 이유는 레이블 아래에 표시됩니다.'], + ['빨간색', '링크가 속임수처럼 보입니다. 예를 들어 위장된 주소나 여러 문자 체계를 섞은 도메인입니다.'], + ], + }, + }, + { p: '화면이 멈춰 있으므로 동영상, 프레젠테이션, 게임 속 코드도 읽을 수 있습니다. 모니터가 여러 대이면 모두 동시에 스캔합니다.' }, + { h2: '영역 선택' }, + { p: '코드가 작거나 흐리거나 기울어져 있을 때, 또는 화면에 코드가 많을 때는 필요한 코드만 사각형으로 둘러싸세요. 선택한 영역은 확대한 뒤에 읽기 때문에, 읽기 어려운 코드는 전체 화면 스캔보다 잘 인식됩니다.' }, + { + ol: [ + '[[Ctrl+Alt+A]]를 누르거나, 트레이 메뉴나 플로팅 도구 모음에서 **영역 선택**을 선택합니다.', + '화면이 멈추고 포인터가 십자 모양으로 바뀝니다. 마우스 왼쪽 단추를 누른 채 코드 주위로 사각형을 드래그합니다.', + '마우스 단추를 놓습니다. 사각형 안의 내용만 읽습니다.', + ], + }, + { fig: 'scan-region', cap: '영역 선택: 드래그하는 동안 사각형의 크기가 표시됨' }, + { tip: '사각형을 코드보다 조금 크게 그리세요. 주위에 여백이 있으면 더 잘 읽힙니다. “해당 영역에 코드가 없습니다”라는 메시지가 나오면 조금 더 크게 그려 보세요.' }, + { h2: '스캔 화면의 도구 모음' }, + { p: '스캔 화면 위쪽에는 단추가 한 줄로 있습니다. 왼쪽부터 **전체 화면 스캔**, **영역 선택**, **카메라로 스캔**, **클립보드 이미지 스캔**, **이미지 열기…**, **QR 코드 만들기…**, **기록**, **설정**, **닫기**입니다. 스캔 화면을 벗어나지 않고도 전체 화면에서 영역 선택으로 바꾸는 식으로 방법을 전환할 수 있습니다. 단추에 마우스를 올리면 설명과 바로 가기 키가 나타납니다.' }, + { h2: '키보드' }, + { p: '스캔 화면은 키보드만으로도 사용할 수 있습니다.' }, + { + table: { + cols: [30, 70], + head: ['키', '동작'], + rows: [ + ['[[Enter]]', '선택된 코드를 엽니다.'], + ['[[Tab]], [[→]], [[↓]]', '다음 코드를 선택합니다.'], + ['[[Shift+Tab]], [[←]], [[↑]]', '이전 코드를 선택합니다.'], + ['[[C]]', '선택된 코드를 복사합니다.'], + ['[[F]] 또는 [[F5]]', '전체 화면을 다시 검색합니다.'], + ['[[Esc]]', '취소하고 스캔 화면을 닫습니다(마우스 오른쪽 단추 클릭도 가능).'], + ], + }, + }, + { h2: '코드를 찾지 못할 때' }, + { + ul: [ + '**영역 선택**으로 코드만 둘러싸세요. 선택한 영역은 확대한 뒤 읽습니다.', + '동영상 속 코드가 빠르게 움직인다면 먼저 동영상을 일시 정지하세요.', + '코드의 일부를 가리는 다른 창이나 마우스 포인터 등을 치우세요.', + '바코드나 Data Matrix 같은 형식을 읽으려면 **설정 › 스캔 › 바코드도 읽기**가 켜져 있는지 확인하세요.', + '화면에서 코드가 아주 작다면(너비 약 40픽셀 미만) 먼저 페이지나 그림을 확대하세요.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: '다른 스캔 방법' }, + { h2: '웹캠' }, + { p: '종이, 명함, 다른 휴대폰 화면에 있는 코드는 웹캠으로 스캔하세요.' }, + { + ol: [ + '[[Ctrl+Alt+W]]를 누르거나 **카메라로 스캔**을 선택합니다.', + '코드를 카메라에서 15~30cm 정도 떨어진 곳에 비춥니다.', + '코드가 인식되면 주위에 괄호가 나타나고, 결과 레이블이 화면 아래쪽의 고정된 목록에 표시됩니다.', + '레이블을 클릭하거나, [[Tab]]으로 선택한 뒤 [[Enter]]를 누릅니다.', + ], + }, + { fig: 'camera', cap: '카메라로 스캔: 결과가 아래쪽의 고정된 목록에 남음', width: 13 }, + { + ul: [ + '잘못 읽는 것을 막기 위해, 코드가 연속된 여러 프레임에서 보여야 목록에 나타납니다.', + '코드가 화면에서 벗어나도 결과는 한동안(기본 8초) 목록에 남아 있어 계속 클릭할 수 있습니다. 시간은 **설정 › 카메라**에서 바꿉니다.', + '카메라가 여러 대 연결되어 있으면 창 아래쪽의 목록에서 전환합니다.', + '**좌우 반전** 스위치는 화면 표시 방식만 바꾸며, 인식은 어느 쪽이든 됩니다.', + '기본적으로 코드를 열면 카메라 창이 닫힙니다. **설정 › 카메라**에서 바꿀 수 있습니다.', + ], + }, + { note: '카메라가 시작되지 않으면 카메라를 사용 중일 수 있는 다른 프로그램(화상 통화 등)을 닫고, 시스템의 개인정보 설정에서 QRcode tool이 카메라를 사용하도록 허용하세요.' }, + { h2: '클립보드의 이미지' }, + { + ol: [ + '[[Win+Shift+S]]나 다른 캡처 도구로 코드를 캡처하거나, 웹 페이지에서 그림을 복사합니다.', + '**클립보드 이미지 스캔**을 선택합니다.', + '그림이 미리 보기 창에 표시되고, 찾은 코드마다 결과 레이블이 붙습니다.', + ], + }, + { p: '클립보드에 그림이 없으면 먼저 스크린샷이나 그림을 복사하라는 안내가 나옵니다.' }, + { h2: '이미지 파일' }, + { + ol: [ + '**이미지 열기…**를 선택합니다.', + 'PNG, JPEG, BMP, GIF 또는 WebP 파일을 선택합니다.', + '미리 보기 창에서 결과 레이블을 클릭합니다. 아래쪽 단추로 다른 그림을 열거나 클립보드를 대신 스캔할 수 있습니다.', + ], + }, + { fig: 'image-preview', cap: '미리 보기 창: 그림 속 코드 위에 레이블이 붙음', width: 13 }, + { h2: 'Windows 오른쪽 클릭 메뉴' }, + { p: 'Windows에서는 QRcode tool의 주요 기능을 파일 탐색기의 오른쪽 클릭 메뉴(바로 가기 메뉴)에 추가할 수 있습니다. 바탕 화면의 빈 곳을 마우스 오른쪽 단추로 클릭해 화면을 스캔하거나, 그림을 마우스 오른쪽 단추로 클릭해 그 파일을 스캔할 수 있으며, 도구 모음을 열거나 바로 가기 키를 기억할 필요가 없습니다.' }, + { + figs: [ + ['shell-desktop', '바탕 화면 빈 곳을 마우스 오른쪽 단추로 클릭'], + ['shell-image', '그림 하나를 마우스 오른쪽 단추로 클릭'], + ], + cap: '오른쪽 클릭 메뉴의 QRcode tool 항목(Windows 11, 더 많은 옵션 표시)', + }, + { h3: '오른쪽 클릭 메뉴 켜기·끄기' }, + { p: '오른쪽 클릭 메뉴는 기본적으로 **켜져** 있습니다. QRcode tool을 설치하고 한 번 시작하면 항목이 나타납니다. 이전에 껐다면 다음과 같이 다시 켭니다.' }, + { + ol: [ + '트레이 메뉴나 플로팅 도구 모음에서 **설정**을 엽니다.', + '왼쪽에서 **일반**을 선택합니다.', + '**오른쪽 클릭 메뉴**를 켭니다. 변경 사항은 바로 적용되며, 컴퓨터나 파일 탐색기를 다시 시작할 필요가 없습니다.', + ], + }, + { p: '같은 스위치를 끄면 항목이 제거됩니다. 항목은 사용자 본인의 설정(레지스트리의 HKEY_CURRENT_USER)에 저장되므로 관리자 권한이 필요 없고, 이 컴퓨터의 다른 계정에는 영향을 주지 않습니다.' }, + { h3: '메뉴 열기' }, + { + ul: [ + '**Windows 11:** 마우스 오른쪽 단추로 클릭한 뒤 맨 아래의 **더 많은 옵션 표시**를 선택하면, 전체 메뉴에 QRcode tool 항목이 있습니다. 전체 메뉴를 바로 열려면 [[Shift]]를 누른 채 마우스 오른쪽 단추로 클릭하거나 [[Shift+F10]]을 누르세요.', + '**Windows 10:** 마우스 오른쪽 단추로 클릭하면 바로 QRcode tool 항목이 나타납니다.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['메뉴 항목', '위치', '동작'], + rows: [ + ['QRcode tool 화면 스캔', '바탕 화면 빈 곳', '전체 화면을 스캔합니다([[Ctrl+Alt+Q]]와 같음).'], + ['QRcode tool 영역 스캔', '바탕 화면 빈 곳', '화면을 멈춰 영역을 선택할 수 있게 합니다([[Ctrl+Alt+A]]와 같음).'], + ['QRcode tool 카메라 스캔', '바탕 화면 빈 곳', '웹캠을 엽니다([[Ctrl+Alt+W]]와 같음).'], + ['QRcode tool 도구 모음', '바탕 화면 빈 곳', '플로팅 도구 모음을 표시합니다.'], + ['QRcode tool 이미지 열기', '그림 파일', '미리 보기 창에서 그림을 스캔합니다. PNG, JPEG, BMP, GIF, WebP를 지원합니다.'], + ], + }, + }, + { + ul: [ + '바탕 화면용 항목 네 개는 메뉴 아래쪽에 구분선 사이로 모여 있으며, QRcode tool 아이콘이 붙어 있습니다.', + '**QRcode tool 이미지 열기**는 그림이 정확히 **하나** 선택되었을 때만 나타나며, 여러 파일을 한꺼번에 선택하면 나타나지 않습니다.', + '항목은 QRcode tool의 표시 언어를 따릅니다. **설정 › 일반 › 언어**를 바꾸면 메뉴도 함께 바뀝니다.', + 'QRcode tool이 실행 중이 아니면 항목을 선택할 때 프로그램이 시작되어 기능을 실행하고, 이미 실행 중이면 실행 중인 프로그램이 요청을 처리합니다.', + '휴대용 버전에서는 항목이 프로그램의 현재 위치를 가리킵니다. 휴대용 폴더를 옮긴 뒤에는 프로그램을 한 번 시작해서 항목을 업데이트하세요.', + 'QRcode tool을 제거하면 항목도 제거됩니다. macOS와 Linux에는 오른쪽 클릭 메뉴 항목이 없으니 바로 가기 키나 명령줄을 사용하세요.', + ], + }, + { tip: '메뉴에 QRcode tool이 없다면 **설정 › 일반 › 오른쪽 클릭 메뉴**가 켜져 있는지 확인하고, Windows 11에서는 **더 많은 옵션 표시**를 선택하세요. 방금 설치했거나 옮겼다면 QRcode tool을 한 번 시작하세요.' }, + { h2: '명령줄' }, + { p: '모든 스캔 기능은 명령으로도 시작할 수 있습니다. 프로그램이 이미 실행 중이면 명령이 그 프로그램에 전달됩니다. Wayland를 쓰는 Linux에서 특히 유용합니다. 데스크톱의 키보드 설정에서 이 명령들을 사용자 지정 바로 가기에 연결하세요.' }, + { + table: { + cols: [42, 58], + head: ['명령', '동작'], + rows: [ + ['`qrcode-tool`', '프로그램을 시작합니다. 이미 실행 중이면 플로팅 도구 모음을 표시합니다.'], + ['`qrcode-tool scan-screen`', '전체 화면을 스캔합니다.'], + ['`qrcode-tool scan-region`', '화면을 멈추고 영역을 선택합니다.'], + ['`qrcode-tool scan-camera`', '웹캠으로 스캔합니다.'], + ['`qrcode-tool scan-clipboard`', '클립보드의 그림을 스캔합니다.'], + ['`qrcode-tool scan-file 파일`', '미리 보기 창에서 이미지 파일 하나를 스캔합니다.'], + ['`qrcode-tool toolbar`', '플로팅 도구 모음을 표시하거나 숨깁니다.'], + ['`qrcode-tool bubble`', '플로팅 버블을 표시하거나 숨깁니다.'], + ['`qrcode-tool generate "텍스트"`', '텍스트가 채워진 상태로 QR 코드 생성기를 엽니다.'], + ['`qrcode-tool settings`', '설정을 엽니다.'], + ['`qrcode-tool decode 파일… [--json]`', 'UI를 시작하지 않고 이미지 파일 속 코드를 터미널에 출력합니다.'], + ['`qrcode-tool quit`', '실행 중인 프로그램을 끝냅니다.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: '결과와 자세한 정보' }, + { h2: '결과 레이블' }, + { p: '찾은 코드마다 어두운 색의 결과 레이블이 붙습니다. 왼쪽부터 다음 내용을 보여 줍니다.' }, + { + ul: [ + '**아이콘:** 내용의 종류입니다. 예를 들어 링크는 지구본, Wi-Fi는 신호 모양, 연락처는 사람 모양입니다. 경고가 있는 링크는 대신 경고나 위험 기호를 보여 줍니다.', + '**기본 텍스트:** 링크는 전체 주소 대신 실제 사이트 이름, Wi-Fi는 네트워크 이름, 연락처는 이름입니다.', + '**두 번째 줄:** 내용의 종류 또는 경고의 주된 이유입니다.', + '**› 단추:** 내용과 관계없이 항상 자세한 정보 카드를 엽니다.', + ], + }, + { h2: 'Enter나 클릭을 하면' }, + { + table: { + cols: [36, 64], + head: ['내용', '동작'], + rows: [ + ['경고가 없는 링크', '기본 브라우저에서 엽니다.'], + ['경고가 있는 링크', '자세한 정보 카드를 먼저 보여 주고, 확인한 뒤에야 링크를 엽니다.'], + ['그 밖의 모든 내용', '자세한 정보 카드를 보여 주며, 여기서 할 일을 고릅니다.'], + ], + }, + }, + { h2: '자세한 정보 카드' }, + { p: '자세한 정보 카드에는 코드의 모든 항목이 나열되고, 내용에 맞는 단추가 나타납니다. 항목 옆의 복사 단추는 그 항목만 복사합니다. 암호 같은 민감한 항목은 “••••”로 가려지며, 자물쇠 단추를 누르면 잠시 보입니다. 카드 바깥을 클릭하거나 **닫기**를 클릭하면 결과로 돌아갑니다.' }, + { fig: 'detail-wifi', cap: 'Wi-Fi 코드의 자세한 정보 카드: “연결”로 네트워크에 연결', width: 12 }, + { h2: '내용 종류별 단추' }, + { + table: { + cols: [30, 70], + head: ['종류', '단추'], + rows: [ + ['링크', '**열기**, **복사**. 아직 신뢰하지 않은 사이트로 가는 경고 없는 링크에는 **이 사이트 항상 허용**도 나타납니다.'], + ['Wi-Fi 네트워크', '**연결**(시스템이 네트워크 프로필을 만듦), **암호 복사**.'], + ['연락처(vCard, MeCard)', '**연락처 저장**(주소록으로 가져올 수 있는 .vcf 파일을 저장), **복사**.'], + ['이메일', '**이메일 쓰기**(기본 메일 프로그램을 엶), **복사**.'], + ['전화번호', '**전화 걸기**(시스템의 통화 앱으로 넘김), **복사**.'], + ['문자 메시지', '**메시지 보내기**, **복사**.'], + ['위치', '**지도 열기**, **복사**.'], + ['2단계 인증 키', '서비스 이름과 계정만 표시되며 **복사**할 수 있습니다. 비밀 값 자체는 표시하거나 저장하지 않습니다.'], + ['결제 주소', '**복사**. 돈을 보내기 전에 결제 주소를 반드시 다시 확인하세요.'], + ['전자 영수증(대만)', '**영수증 번호 복사**, **복사**.'], + ['차단된 링크', '`http`와 `https`가 아닌 링크(예: `file:`, `javascript:`)는 복사만 할 수 있고 열 수 없습니다.'], + ['텍스트와 바코드', '**복사**. 바코드는 EAN-13 같은 형식도 함께 표시됩니다.'], + ], + }, + }, + { h2: '대만 전자 영수증' }, + { p: '대만 전자 영수증(전자발표)에는 QR 코드 두 개가 나란히 있습니다. 왼쪽 코드에는 영수증 번호, 날짜, 금액, 일부 품목이, 오른쪽 코드에는 나머지 품목이 들어 있습니다. **전체 화면 스캔**이나 **이미지 열기…**에서 두 코드를 모두 찾으면 하나의 영수증으로 합쳐지고, 자세한 정보 카드에 영수증 번호, 날짜, 임의 코드, 합계, 세액, 판매자와 구매자의 사업자 번호, 모든 품목이 나열됩니다. 왼쪽 코드만 찾았다면 오른쪽 코드도 스캔하라고 알려 줍니다.' }, + { h2: '민감한 데이터' }, + { p: '2단계 인증 키와 Wi-Fi 암호는 민감한 데이터입니다. 스캔 기록이나 **자동으로 결과 복사**를 켜 두어도 기록에 쓰이지 않고, 자동으로 복사되지 않으며, 프로그램의 로그 파일에도 기록되지 않습니다.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: '링크 안전' }, + { p: '악성 QR 코드는 가짜 웹사이트로 이끄는 경우가 많습니다. QRcode tool은 결과를 보여 주기 전에 모든 웹 주소를 사용자의 컴퓨터에서 분석하고, 발견한 내용을 결과 레이블과 자세한 정보 카드에 바로 표시합니다. 온라인으로 조회하지 않으며, 어떤 주소도 어떤 서비스로 보내지 않습니다.' }, + { h2: '열기 전에 사이트 이름 확인' }, + { p: '결과 레이블에는 주소에 담긴 실제 사이트 이름이 표시됩니다. 링크를 열기 전에 원하는 사이트가 맞는지 확인하세요. 경고가 있는 링크는 자세한 정보 카드를 먼저 보여 주며, 위쪽의 색 있는 안내문이 무엇을 조심해야 하는지 설명합니다.' }, + { fig: 'detail-warning', cap: '경고가 있는 링크: 암호화되지 않은 단축 링크는 이유를 보여 주고 기다림', width: 12 }, + { h2: '경고 수준' }, + { + table: { + cols: [18, 82], + head: ['수준', '프로그램의 동작'], + rows: [ + ['정보', '예를 들어 아주 긴 주소입니다. 자세한 정보 카드에만 표시되며, [[Enter]]를 누르면 링크가 바로 열립니다.'], + ['경고', '노란색 괄호와 아이콘. [[Enter]]나 클릭을 하면 자세한 정보 카드가 먼저 나타나고, 그다음 **열기**를 클릭합니다.'], + ['위험', '빨간색 괄호와 아이콘. **열기**가 더 이상 기본 단추가 아니며, 클릭한 뒤 **그래도 열기**로 한 번 더 확인해야 합니다.'], + ], + }, + }, + { h2: '검사 항목' }, + { + table: { + cols: [30, 12, 58], + head: ['표시되는 메시지', '수준', '설명과 조언'], + rows: [ + ['암호화되지 않음(http)', '경고', '연결이 암호화되지 않아 전송 중에 데이터를 읽거나 바꿀 수 있습니다. 이런 페이지에는 암호나 결제 정보를 입력하지 마세요.'], + ['위장된 주소', '위험', '믿을 만해 보이는 이름이 “@” 앞에 있지만, 실제로는 그 뒤의 사이트로 이동합니다. 예: `https://bank.example.com@login-check.example.net/`.'], + ['국제화 도메인 이름', '경고', '도메인에 라틴 문자가 아닌 글자가 들어 있습니다. 확인할 수 있도록 실제로 인코딩된 주소(`xn--`로 시작)도 카드에 표시됩니다.'], + ['비슷한 글자', '위험', '도메인의 한 부분에 여러 문자 체계가 섞여 있습니다. 예를 들어 라틴 문자 “a” 대신 키릴 문자 “а”를 쓴 경우입니다. 가짜 웹사이트가 흔히 쓰는 수법입니다.'], + ['IP 주소', '경고', '주소가 사이트 이름 대신 숫자를 씁니다. 일반 웹사이트에서는 드문 일입니다.'], + ['비정상적인 포트', '경고', '주소에 표준이 아닌 포트 번호가 지정되어 있습니다.'], + ['단축 링크', '경고', 'bit.ly 같은 서비스는 실제 목적지를 숨깁니다. 온라인으로 풀어 보면 무엇을 스캔했는지 그 서비스에 알려지므로 링크를 풀지 않습니다. 단축 링크는 믿을 수 있는 출처의 것만 여세요.'], + ['매우 긴 주소', '정보', '아주 긴 주소는 실제 사이트 이름을 눈에 띄지 않는 곳으로 밀어낼 수 있습니다.'], + ['인코딩된 문자가 많음', '정보', '“%” 이스케이프가 많으면 주소의 실제 내용을 숨기는 데 쓰일 수 있습니다.'], + ['하위 도메인이 많음', '정보', '예를 들어 `login.bank.example.com.secure-check.example.net`은 언뜻 보면 은행 사이트처럼 보일 수 있습니다.'], + ], + }, + }, + { h2: '속이는 링크' }, + { p: '**위험**으로 평가된 링크는 자세한 정보 카드에 빨간 글씨로 속이는 링크로 보인다고 알리고 이유를 나열합니다. 코드 옆에 인쇄된 글이 아니라 카드에 표시된 실제 사이트 이름을 믿으세요.' }, + { fig: 'detail-danger', cap: '위장된 주소: 은행처럼 보이지만 실제로는 login-check.example.net으로 이동', width: 12 }, + { p: '그래도 계속하려면 **열기**를 클릭하세요. 카드가 한 번 더 묻고, **그래도 열기**를 눌러야 페이지가 실제로 열립니다.' }, + { h2: '신뢰할 수 있는 사이트와 자동 열기' }, + { p: '학교나 회사 도메인처럼 자주 쓰는 사이트를 신뢰할 수 있는 사이트에 추가할 수 있습니다. 다음 조건을 모두 만족하면 [[Enter]]를 기다리지 않고 스캔 직후 링크가 열립니다.' }, + { + ul: [ + '찾은 코드가 하나뿐입니다.', + '링크에 경고가 없습니다.', + '사이트(또는 그 하위 도메인)가 신뢰 목록에 있습니다.', + '**설정 › 스캔 › 신뢰할 수 있는 사이트는 묻지 않고 열기**가 켜져 있습니다(기본값).', + ], + }, + { p: '경고 없는 링크의 자세한 정보 카드에서 **이 사이트 항상 허용**을 누르거나, **설정 › 스캔**에서 도메인을 입력해 사이트를 추가합니다.' }, + { fig: 'detail-link', cap: '경고가 없는 링크: 바로 열거나 사이트를 신뢰 목록에 추가', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: '플로팅 도구 모음과 버블' }, + { p: '플로팅 도구 모음은 다른 창 위에 머물러 있어 모든 기능을 한 번의 클릭으로 쓸 수 있습니다. 스캔용 스크린샷에는 절대 나타나지 않습니다. 트레이 메뉴의 **플로팅 도구 모음**, 바로 가기 키 [[Ctrl+Alt+E]], 또는 `qrcode-tool toolbar` 명령으로 표시하거나 숨깁니다.' }, + { h2: '도구 모음 단추' }, + { fig: 'toolbar-row', cap: '가로 도구 모음: 단추에 마우스를 올리면 아래에 이름과 바로 가기 키가 표시됨', width: 11 }, + { + table: { + cols: [34, 66], + head: ['단추', '동작'], + rows: [ + ['(맨 앞의 점선 손잡이)', '누른 채 드래그하면 도구 모음을 옮깁니다.'], + ['전체 화면 스캔', '[[Ctrl+Alt+Q]]와 같습니다.'], + ['영역 선택', '[[Ctrl+Alt+A]]와 같습니다.'], + ['카메라로 스캔', '[[Ctrl+Alt+W]]와 같습니다. 카메라가 없으면 회색으로 표시됩니다.'], + ['클립보드 이미지 스캔', '클립보드의 그림을 읽습니다.'], + ['이미지 열기…', '이미지 파일을 골라 스캔합니다.'], + ['QR 코드 만들기…', 'QR 코드 생성기를 엽니다.'], + ['기록', '**설정 › 개인정보 및 기록**을 엽니다.'], + ['설정', '설정을 엽니다.'], + ['사용 설명서(“?” 단추)', 'GitHub의 PDF 사용 설명서를 표시 언어와 같은 언어로 브라우저의 새 탭에서 엽니다.'], + ['버블로 접기', '도구 모음을 숨기고 대신 작은 둥근 버블을 보여 줍니다.'], + ['도구 모음 닫기', '도구 모음을 숨깁니다(버블은 나타나지 않음). 프로그램은 트레이에서 계속 실행됩니다.'], + ], + }, + }, + { h2: '세로 도구 모음(오른쪽 또는 왼쪽)' }, + { p: '기본값인 화면 위쪽의 가로 배치 외에, 화면 오른쪽이나 왼쪽 가장자리에 세로 한 줄로 둘 수도 있습니다. 세로 배치는 너비를 덜 차지해 와이드 화면에 잘 맞고, 웹 페이지 위쪽을 가리지 않습니다.' }, + { + figs: [ + ['toolbar-right', '세로, 오른쪽(세로 배치의 기본 위치)'], + ['toolbar-left', '세로, 왼쪽'], + ], + cap: '세로 도구 모음: 마우스를 올린 단추의 이름과 바로 가기 키가 단추 아래에 표시됨', + }, + { p: '배치를 바꾸려면:' }, + { + ol: [ + '**설정**을 열고 **일반**을 선택합니다.', + '**플로팅 도구 모음과 버블** 섹션에서 **도구 모음 배치**를 찾습니다.', + '**가로, 위쪽**, **세로, 오른쪽**, **세로, 왼쪽** 중 하나를 선택합니다.', + ], + }, + { p: '변경 사항은 바로 적용됩니다. 도구 모음은 새 배치의 기본 위치로 옮겨집니다. 가로 배치는 위쪽 가운데, 세로 배치는 선택한 가장자리의 세로 가운데입니다. 그 뒤에도 원하는 곳으로 끌어다 놓을 수 있습니다.' }, + { h2: '도구 모음 옮기기' }, + { p: '도구 모음 한쪽 끝의 점선 손잡이를 누른 채 드래그합니다. 마지막 위치가 기억되어 다음에도 그곳에 표시됩니다. 외부 모니터를 분리한 경우처럼 그 위치가 더 이상 어떤 모니터에도 없으면 기본 위치로 돌아갑니다.' }, + { h2: '플로팅 버블' }, + { p: '플로팅 버블은 접힌 도구 모음입니다. 작은 원 하나만 차지하며, 기본적으로 화면 오른쪽 가장자리에 나타납니다.' }, + { fig: 'bubble', cap: '플로팅 버블', width: 8 }, + { + table: { + cols: [30, 70], + head: ['동작', '결과'], + rows: [ + ['클릭', '플로팅 도구 모음 전체로 펼칩니다.'], + ['약 0.5초 동안 누르기', '전체 화면을 스캔합니다.'], + ['마우스 오른쪽 단추 클릭', '메뉴를 엽니다: **전체 화면 스캔**, **영역 선택**, **카메라로 스캔**, **클립보드 이미지 스캔**, **도구 모음 표시**, **버블 숨기기**.'], + ['드래그', '버블을 옮깁니다.'], + ], + }, + }, + { p: '프로그램을 시작할 때마다 버블을 표시하려면 **설정 › 일반 › 앱 시작 시 버블 표시**를 켜세요. 도구 모음과 버블은 동시에 표시되지 않습니다.' }, + { h2: '전체 화면 앱 사용 중 숨기기' }, + { p: 'Windows에서는 전체 화면으로 동영상을 보거나, 프레젠테이션을 하거나, 게임을 하는 동안 도구 모음과 버블이 숨겨지고, 전체 화면을 벗어나면 다시 나타납니다. **설정 › 일반 › 전체 화면 앱 사용 중 숨기기**에서 끌 수 있습니다.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'QR 코드 만들기' }, + { p: 'QR 코드 생성기는 링크나 텍스트를 QR 코드로 바꿔 줍니다. 휴대폰으로 스캔하거나 문서와 프레젠테이션에 넣을 수 있습니다.' }, + { + ol: [ + '트레이 메뉴, 플로팅 도구 모음 또는 스캔 화면에서 **QR 코드 만들기…**를 선택합니다.', + '**텍스트 또는 링크**에 내용을 입력하거나 붙여 넣습니다. QR 코드가 오른쪽에 바로 나타납니다.', + '필요하면 **오류 정정** 수준을 고릅니다.', + '**이미지 복사**를 눌러 클립보드에 복사하거나, **PNG 저장…** 또는 **SVG 저장…**을 눌러 파일로 저장합니다.', + ], + }, + { fig: 'generator', cap: 'QR 코드 생성기', width: 13 }, + { h2: '오류 정정' }, + { p: '수준이 높을수록 코드 일부가 손상되거나 로고에 가려져도 읽을 수 있지만, 코드가 더 촘촘하고 커집니다.' }, + { + table: { + cols: [36, 64], + head: ['수준', '사용할 때'], + rows: [ + ['낮음 — 가장 작은 코드', '내용이 많고 화면에만 표시할 때.'], + ['중간 — 권장', '일반적인 용도의 기본값.'], + ['높음(25%)', '긁힐 수 있는 물건에 인쇄하는 코드.'], + ['매우 높음 — 손상이나 로고에도 인식', '코드 가운데에 로고를 넣거나, 최대한 튼튼해야 할 때.'], + ], + }, + }, + { note: 'QR 코드 하나에 담을 수 있는 내용에는 한계가 있습니다. “QR 코드 하나에 담기에는 텍스트가 너무 깁니다”라는 메시지가 나오면 내용을 줄이거나 더 낮은 오류 정정 수준을 고르세요.' }, + { p: '**PNG**는 문서와 슬라이드에 편리하고, **SVG**는 벡터 형식이라 크게 인쇄해도 선명합니다. [[Esc]]를 누르면 생성기가 닫힙니다.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: '설정' }, + { p: '트레이 메뉴, 플로팅 도구 모음 또는 스캔 화면에서 **설정**을 선택합니다. 모든 변경 사항은 바로 저장·적용되며, 확인 단추는 없습니다.' }, + { h2: '일반' }, + { fig: 'settings-general', cap: '설정 › 일반', width: 14 }, + { + table: { + cols: [34, 66], + head: ['설정', '설명'], + rows: [ + ['언어', '메뉴와 메시지의 언어입니다. 기본적으로 운영 체제를 따릅니다.'], + ['테마', '**시스템 설정 사용**, **밝게**, **어둡게**. 시스템 강조색은 자동으로 적용됩니다.'], + ['시작 시 실행', '로그인할 때 백그라운드에서 조용히 시작해 바로 가기 키가 항상 작동하게 합니다.'], + ['오른쪽 클릭 메뉴', '(Windows만) 바탕 화면과 그림 파일의 오른쪽 클릭 메뉴에 QRcode tool 항목을 추가합니다. 기본적으로 켜져 있습니다. 제4장 “Windows 오른쪽 클릭 메뉴”를 참고하세요.'], + ['도구 모음 배치', '**가로, 위쪽**, **세로, 오른쪽**, **세로, 왼쪽**. 제7장을 참고하세요.'], + ['앱 시작 시 버블 표시', '시작할 때 플로팅 버블을 표시합니다.'], + ['전체 화면 앱 사용 중 숨기기', '(Windows만) 전체 화면 동영상, 프레젠테이션, 게임 중에는 도구 모음과 버블을 숨깁니다.'], + ['자동으로 업데이트 확인', '하루에 한 번 GitHub에 새 버전이 있는지 묻습니다. 묻지 않고 무언가를 설치하지 않습니다.'], + ['시작 화면 다시 보기', '처음 실행할 때의 시작 화면을 엽니다.'], + ], + }, + }, + { h2: '스캔' }, + { fig: 'settings-scanning', cap: '설정 › 스캔', width: 14 }, + { + table: { + cols: [34, 66], + head: ['설정', '설명'], + rows: [ + ['자동으로 결과 복사', '코드를 정확히 하나 찾으면 그 내용을 클립보드에 넣습니다. 민감한 내용은 복사하지 않습니다. 기본적으로 꺼져 있습니다.'], + ['코드를 찾으면 소리 재생', '짧은 소리를 냅니다. 기본적으로 꺼져 있습니다.'], + ['바코드도 읽기', 'QR 코드 외에 EAN, UPC, Code 128, Data Matrix, PDF417, Aztec 등도 읽습니다. 기본적으로 켜져 있습니다.'], + ['신뢰할 수 있는 사이트는 묻지 않고 열기', '제6장에 적힌 조건에서 신뢰할 수 있는 사이트의 링크를 자동으로 엽니다.'], + ['신뢰할 수 있는 사이트', '도메인(예: example.com)을 입력하고 **추가**를 클릭합니다. 하위 도메인도 신뢰됩니다. 휴지통 아이콘으로 항목을 지웁니다.'], + ], + }, + }, + { h2: '카메라' }, + { fig: 'settings-camera', cap: '설정 › 카메라', width: 14 }, + { + table: { + cols: [34, 66], + head: ['설정', '설명'], + rows: [ + ['카메라', '사용할 웹캠입니다.'], + ['화면 좌우 반전', '카메라 화면을 거울처럼 보여 줍니다. 인식은 어느 쪽이든 됩니다.'], + ['결과 유지 시간(초)', '코드가 화면을 벗어난 뒤에도 결과를 목록에 남겨 두는 시간(0~60초)입니다. 0이면 지금 보이는 코드만 나열합니다.'], + ['코드를 연 후 카메라 닫기', '코드를 열거나 사용하면 카메라 창을 닫습니다.'], + ], + }, + }, + { h2: '바로 가기 키' }, + { fig: 'settings-shortcuts', cap: '설정 › 바로 가기 키', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['동작', '기본값', '설명'], + rows: [ + ['전체 화면 스캔', '[[Ctrl+Alt+Q]]', '모든 모니터를 멈추고 스캔합니다.'], + ['영역 선택', '[[Ctrl+Alt+A]]', '화면을 멈춰 사각형을 드래그할 수 있게 합니다.'], + ['카메라로 스캔', '[[Ctrl+Alt+W]]', '웹캠 창을 엽니다.'], + ['도구 모음 표시/숨기기', '[[Ctrl+Alt+E]]', '플로팅 도구 모음을 켜고 끕니다.'], + ], + }, + }, + { p: '바로 가기 키를 바꾸려면:' }, + { + ol: [ + '바꿀 바로 가기 키를 클릭합니다. 단추에 **키를 누르세요… (취소하려면 Esc)**가 표시됩니다.', + '새 키 조합을 누릅니다. [[Ctrl]], [[Alt]], [[Shift]], [[Win]](Mac에서는 [[Cmd]]) 중 하나 이상이 들어가야 합니다.', + '새 바로 가기 키가 바로 적용됩니다.', + ], + }, + { p: '다른 앱이 이미 그 조합을 쓰고 있으면 해당 줄에 “다른 앱에서 이미 사용 중입니다. 다른 키를 선택하세요.”가 표시됩니다. 다른 조합을 고르세요. **기본값 복원**은 모든 기본 바로 가기 키를 되돌립니다. 아래쪽의 **스캔 중** 섹션에는 제3장과 같은 스캔 화면의 키가 나열됩니다.' }, + { h2: '개인정보 및 기록' }, + { fig: 'settings-privacy', cap: '설정 › 개인정보 및 기록(기록을 켠 상태)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['설정', '설명'], + rows: [ + ['스캔 기록 보관', '이 컴퓨터에만 저장됩니다. Wi-Fi 암호와 2단계 인증 키는 절대 저장되지 않습니다. 기본적으로 꺼져 있습니다.'], + ['보관할 항목 수', '5~500개. 가장 오래된 항목부터 지워집니다.'], + ['최근 스캔', '최신 항목이 맨 위에 옵니다. 경고 없는 링크는 **열기**로 다시 열 수 있고, 모든 항목은 **복사**로 복사할 수 있습니다.'], + ['기록 지우기', '기록 전체를 삭제합니다.'], + ], + }, + }, + { h2: '정보' }, + { fig: 'settings-about', cap: '설정 › 정보', width: 14 }, + { + ul: [ + '현재 버전을 보여 줍니다. **업데이트 확인**은 바로 확인합니다.', + '소스 코드, 문제 신고, 개인정보 처리방침, 오픈 소스 라이선스로 가는 링크가 있습니다.', + '**설정 폴더 열기**와 **로그 폴더 열기**는 해당 폴더를 바로 엽니다. 설정을 백업하거나 문제를 신고할 때 로그 파일을 첨부할 때 씁니다.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: '업데이트와 제거' }, + { h2: '업데이트 확인 및 설치' }, + { p: '설치 프로그램으로 설치한 경우 스스로 업데이트할 수 있습니다. **자동으로 업데이트 확인**이 켜져 있으면 하루에 한 번 GitHub에 묻습니다. 언제든 트레이 메뉴나 **설정 › 정보**에서 **업데이트 확인**을 클릭할 수도 있습니다.' }, + { fig: 'message-update', cap: '새 버전이 있을 때 나타나는 메시지', width: 10 }, + { + ol: [ + '**업데이트 사용 가능** 메시지가 나타나면 **지금 업데이트**를 클릭합니다.', + '새 버전이 백그라운드에서 다운로드되고, 끝나면 프로그램이 다시 시작됩니다.', + '지금 업데이트하지 않으려면 **나중에**를 클릭합니다.', + ], + }, + { p: '업데이트는 **지금 업데이트**를 클릭한 뒤에만 설치됩니다. 프로그램이 스스로 무언가를 설치하는 일은 없습니다.' }, + { h2: '휴대용 버전' }, + { p: '휴대용 버전(`Portable.zip`)은 스스로 업데이트하지 않습니다. 업데이트를 확인하면 “업데이트를 사용할 수 없음”이 표시됩니다. GitHub 릴리스 페이지에서 새 버전을 다운로드해 이전 파일을 바꾸세요. 설정은 그대로 유지됩니다.' }, + { h2: '제거' }, + { + ol: [ + 'Windows의 **설정 › 앱 › 설치된 앱**을 엽니다.', + 'QRcode tool을 찾아 **…**를 클릭하고 **제거**를 선택합니다.', + '시작 프로그램 항목과 오른쪽 클릭 메뉴 항목도 함께 제거됩니다.', + ], + }, + { p: '설정과 기록도 지우려면 제거하기 전에 **설정 › 정보**에서 설정 폴더와 로그 폴더를 열어 삭제하세요.' }, + { h2: '설정과 로그가 저장되는 곳' }, + { + table: { + cols: [18, 82], + head: ['시스템', '위치'], + rows: [ + ['Windows', '설정: `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\n기록과 로그: `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', '설정: `~/.config/qrcode-tool`\n기록과 로그: `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: '설정 파일 `settings.toml`은 일반 텍스트입니다. 이 파일을 복사하면 설정을 다른 컴퓨터로 옮길 수 있습니다.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: '문제 해결' }, + { + qa: [ + ['바로 가기 키를 눌러도 아무 일도 일어나지 않습니다.', '다른 앱이 이미 그 키를 쓰고 있을 수 있습니다. **설정 › 바로 가기 키**를 열고, 해당 줄에 “다른 앱에서 이미 사용 중입니다”가 보이면 다른 조합을 고르세요. 일부 게임과 원격 데스크톱 프로그램은 앞에 있는 동안 모든 키를 가로챕니다.'], + ['스캔해도 코드를 찾지 못합니다.', '**영역 선택**으로 코드만 둘러싸거나, 먼저 페이지나 그림을 확대하세요. 제3장 “코드를 찾지 못할 때”를 참고하세요.'], + ['링크가 왜 바로 열리지 않았나요?', '경고가 있는 링크는 실제 사이트를 확인할 수 있도록 항상 자세한 내용을 먼저 보여 줍니다. 경고가 전혀 없는 신뢰할 수 있는 사이트의 링크만, 그것도 찾은 코드가 하나뿐일 때만 자동으로 열립니다.'], + ['“단축 링크 — 실제 목적지가 숨겨져 있습니다”라고 나옵니다.', '단축 링크 서비스는 실제 목적지를 숨깁니다. 온라인으로 조회하면 무엇을 스캔했는지 드러나므로 프로그램은 조회하지 않습니다. 단축 링크는 믿을 수 있는 출처의 것만 여세요.'], + ['기본 창은 어디에 있나요?', '일부러 두지 않았습니다. 트레이 아이콘, 바로 가기 키, 플로팅 도구 모음, 플로팅 버블을 사용하세요.'], + ['오른쪽 클릭 메뉴에 QRcode tool이 없습니다.', '**설정 › 일반 › 오른쪽 클릭 메뉴**가 켜져 있는지 확인하세요. Windows 11에서는 항목이 **더 많은 옵션 표시** 안에 있습니다([[Shift]]를 누른 채 마우스 오른쪽 단추로 클릭해도 됩니다). **QRcode tool 이미지 열기**는 그림 하나를 선택했을 때만 나타납니다. QRcode tool을 방금 설치했거나 휴대용 버전을 옮겼다면 한 번 시작하세요.'], + ['도구 모음이 사라졌습니다.', '[[Ctrl+Alt+E]]를 누르거나 트레이 메뉴에서 **플로팅 도구 모음**을 선택하세요. **전체 화면 앱 사용 중 숨기기**가 켜져 있으면 전체 화면 프로그램이 앞에 있는 동안 도구 모음이 숨겨집니다.'], + ['카메라가 시작되지 않습니다.', '카메라를 쓰는 다른 프로그램을 닫고, 시스템의 개인정보 설정에서 QRcode tool이 카메라를 쓸 수 있는지 확인하세요. 카메라가 여러 대라면 **설정 › 카메라**에서 올바른 카메라를 고르세요.'], + ['Wi-Fi가 자동으로 연결되지 않습니다.', '일부 네트워크(예: 기업용 인증)는 프로그램이 설정할 수 없습니다. 자세한 정보 카드에서 **암호 복사**를 누르고 시스템의 Wi-Fi 메뉴에서 연결하세요.'], + ['백신 프로그램이 경고합니다.', '바로 가기 키를 등록하고, 화면을 읽고, 컴퓨터와 함께 시작하는 서명되지 않은 새 프로그램은 동작 기반 탐지에 걸리기도 합니다. QRcode tool은 표준 시스템 인터페이스를 쓰며 소스 코드가 공개되어 있습니다. 백신 업체에 오탐으로 신고하거나 GitHub에 issue를 올려 주세요.'], + ['macOS에서 스크린샷이 검게 나옵니다.', '**시스템 설정 › 개인정보 보호 및 보안 › 화면 기록**에서 QRcode tool을 허용하고 프로그램을 다시 시작하세요. 시스템 업데이트 후 macOS가 다시 물어볼 수 있습니다.'], + ['Wayland를 쓰는 Linux에서 바로 가기 키가 작동하지 않습니다.', 'Wayland에서는 프로그램이 전역 바로 가기 키를 등록할 수 없습니다. 데스크톱의 키보드 설정에서 `qrcode-tool scan-screen` 등의 명령을 실행하는 사용자 지정 바로 가기를 추가하세요.'], + ['이 설명서를 다시 열려면 어떻게 하나요?', '플로팅 도구 모음의 **?** 단추(**사용 설명서**)를 클릭하면 GitHub의 PDF 판이 브라우저의 새 탭에서 열립니다. Word와 PDF 파일은 GitHub 저장소의 `docs/manual` 폴더에도 있습니다.'], + ['문제는 어떻게 신고하나요?', '**설정 › 정보**에서 **문제 신고 또는 아이디어 제안**을 클릭하고, 시스템, 단계, 표시된 메시지를 적어 주세요. 로그 폴더의 파일을 첨부할 수 있습니다. 로그에는 이벤트와 오류만 기록되며 스캔한 내용은 들어 있지 않습니다.'], + ], + }, + + // ───────────────────────── 부록 ───────────────────────── + { h1: '바로 가기 키와 키 한눈에 보기', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['위치', '키', '동작'], + rows: [ + ['어디서나', '[[Ctrl+Alt+Q]]', '전체 화면 스캔'], + ['어디서나', '[[Ctrl+Alt+A]]', '영역 선택'], + ['어디서나', '[[Ctrl+Alt+W]]', '카메라로 스캔'], + ['어디서나', '[[Ctrl+Alt+E]]', '플로팅 도구 모음 표시/숨기기'], + ['스캔 화면, 미리 보기', '[[Enter]]', '선택된 코드 열기'], + ['스캔 화면, 미리 보기', '[[Tab]] / [[Shift+Tab]]', '다음 / 이전 코드 선택'], + ['스캔 화면, 미리 보기', '[[C]]', '선택된 코드 복사'], + ['스캔 화면', '[[F]] 또는 [[F5]]', '전체 화면 다시 검색'], + ['스캔 화면, 미리 보기, 생성기', '[[Esc]]', '닫기'], + ], + }, + }, + { p: '전역 바로 가기 키는 **설정 › 바로 가기 키**에서 바꿀 수 있습니다. 표는 기본값입니다.' }, + { h1: '지원하는 코드', appendix: true }, + { + table: { + cols: [30, 70], + head: ['분류', '형식'], + rows: [ + ['항상 읽음', 'QR Code, Micro QR Code, rMQR Code'], + ['“바코드도 읽기”를 켰을 때', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec 등'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['인식하는 내용', '예'], + rows: [ + ['웹 링크', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:네트워크;P:암호;;`'], + ['연락처', 'vCard(`BEGIN:VCARD`), MeCard(`MECARD:`)'], + ['이메일', '`mailto:`, `MATMSG:`'], + ['전화와 문자 메시지', '`tel:`, `sms:`, `SMSTO:`'], + ['위치', '`geo:25.0330,121.5654`'], + ['2단계 인증 키', '`otpauth://`'], + ['결제 주소', '`bitcoin:`, `ethereum:` 등'], + ['대만 전자 영수증', '영수증에 인쇄된 두 개의 QR 코드'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.pt-BR.js b/docs/manual/build/content.pt-BR.js new file mode 100644 index 0000000..c6e79b8 --- /dev/null +++ b/docs/manual/build/content.pt-BR.js @@ -0,0 +1,733 @@ +// Texto do manual do usuário do QRcode tool (português do Brasil). +// Marcações: **negrito**, [[Tecla]], `código`. Os nomes de figura se referem a shots// (veja figures.js). + +module.exports = { + lang: 'pt-BR', + font: 'Segoe UI', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-pt-BR', + docTitle: 'Manual do usuário do QRcode tool', + cover: { + title: 'QRcode tool', + subtitle: 'Manual do usuário', + tagline: 'Escaneie códigos QR no computador com a mesma facilidade do celular.', + edition: 'Versão 1.0.0 | outubro de 2026', + platforms: 'Para Windows 10 (21H2 ou posterior) / Windows 11, macOS 13 ou posterior e Linux', + }, + back: { + heading: 'Escaneie. Confira. Depois abra.', + body: [ + 'O QRcode tool é um leitor de desktop gratuito e de código aberto. Ele lê códigos QR e códigos de barras da tela, da webcam, da área de transferência e de arquivos de imagem, e verifica cada endereço da web em busca de truques comuns antes de abrir qualquer coisa.', + 'Tudo acontece no seu computador. O programa não coleta dados de uso e nunca envia para a internet o que você escaneia.', + ], + links: [ + ['Página do projeto', 'https://github.com/naritaroad/qrcode-tool'], + ['Versão mais recente', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['Relatar um problema', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: 'O software é distribuído sob a licença MIT ou Apache-2.0. Este manual pode ser copiado e adaptado nas mesmas condições.', + trademark: 'QR Code é uma marca registrada da DENSO WAVE INCORPORATED. O QRcode tool não é afiliado à DENSO WAVE, ao Google nem à Microsoft.', + }, + labels: { + toc: 'Sumário', + chapter: (n) => `Capítulo ${n}`, + appendix: (l) => `Apêndice ${l}`, + figure: (id) => `Figura ${id}`, + tip: 'Dica', + note: 'Observação', + header: 'Manual do usuário do QRcode tool', + tocHint: '(No Word, clique com o botão direito no sumário e escolha Atualizar campo para atualizar os números de página.)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'Conheça o QRcode tool' }, + { p: 'O QRcode tool é um pequeno programa de desktop que fica na bandeja do sistema e lê códigos QR e códigos de barras da tela. Quando você pressiona o atalho, a tela congela por um instante e cada código recebe uma etiqueta de resultado que mostra o tipo de conteúdo e, no caso de links, o nome real do site. Pressione [[Enter]] ou clique na etiqueta para abrir o link, entrar na rede Wi-Fi ou salvar o contato.' }, + { p: 'Ele também lê códigos mostrados à webcam, imagens da área de transferência e arquivos de imagem, e inclui um gerador simples de códigos QR.' }, + { h2: 'Principais recursos' }, + { + table: { + cols: [26, 74], + head: ['Recurso', 'Descrição'], + rows: [ + ['Escanear a tela inteira', 'Congela todos os monitores, encontra cada código automaticamente e coloca uma etiqueta nele. Funciona também com vídeos e jogos.'], + ['Selecionar área', 'Arraste um retângulo em volta de um único código. Use para códigos pequenos, borrados ou inclinados demais para serem encontrados automaticamente.'], + ['Webcam', 'Mostre à câmera um código impresso ou a tela de um celular; o resultado aparece assim que o código é reconhecido.'], + ['Área de transferência e arquivos de imagem', 'Lê uma captura de tela que você acabou de copiar ou arquivos PNG, JPEG, BMP, GIF e WebP.'], + ['Entende o conteúdo', 'Reconhece links, Wi-Fi, contatos, email, números de telefone, mensagens de texto, locais no mapa, chaves de verificação em duas etapas, endereços de pagamento e notas fiscais eletrônicas de Taiwan, e oferece os botões correspondentes.'], + ['Verificações de segurança', 'Antes de abrir um link, verifica se ele usa conexão sem criptografia, endereço disfarçado, letras parecidas, endereço IP, link encurtado ou outros truques comuns. Tudo é verificado off-line.'], + ['Criar códigos QR', 'Transforma um texto ou link em um código QR que você pode copiar ou salvar como PNG ou SVG.'], + ['Barra de ferramentas e bolha flutuantes', 'Uma barra que fica no topo da tela (horizontal) ou na borda direita ou esquerda (vertical), e que pode ser recolhida em uma pequena bolha redonda.'], + ['Idiomas', 'Inglês, chinês tradicional, chinês simplificado, japonês, coreano, espanhol, português (Brasil), francês, alemão e russo.'], + ], + }, + }, + { h2: 'Requisitos do sistema' }, + { + table: { + cols: [30, 70], + head: ['Sistema operacional', 'Requisitos e observações'], + rows: [ + ['Windows', 'Windows 10 21H2 ou posterior, Windows 11. x64 e ARM64. A instalação não exige direitos de administrador.'], + ['macOS', 'macOS 13 ou posterior (Apple silicon e Intel). A primeira leitura exige a permissão de Gravação de Tela; a leitura pela webcam exige a permissão de Câmera.'], + ['Linux', 'Todos os recursos no X11. No Wayland, a leitura é iniciada por um atalho de teclado configurado nas configurações da área de trabalho (veja o capítulo 4).'], + ['Hardware', 'Qualquer computador de escritório comum. A webcam é opcional. Ocioso, o programa usa menos de cerca de 30 MB de memória.'], + ], + }, + }, + { h2: 'Princípios de privacidade e segurança' }, + { + ul: [ + 'A decodificação e a verificação de links são feitas no seu computador. O conteúdo escaneado nunca é enviado, e nenhum serviço da web é consultado sobre a reputação de um endereço.', + 'A única conexão de rede é a verificação automática de atualizações, que é opcional e só pergunta ao GitHub se existe uma versão mais nova.', + 'O histórico de leituras vem desativado. Mesmo ativado, senhas de Wi-Fi e chaves de verificação em duas etapas nunca são armazenadas.', + 'Só endereços `http` e `https` podem ser abertos. Outros tipos de link só podem ser copiados; nunca são entregues ao sistema.', + 'Um link com aviso sempre mostra os detalhes primeiro e espera por você.', + ], + }, + { h2: 'Convenções deste manual' }, + { + ul: [ + 'Botões, opções e nomes de janela aparecem em **negrito**, por exemplo **Configurações** ou **Escanear a tela inteira**.', + 'As teclas aparecem como teclas, por exemplo [[Enter]] ou [[Ctrl+Alt+Q]].', + '**Configurações › Geral** significa: abra a janela **Configurações** e escolha a página **Geral** à esquerda.', + 'As imagens mostram o Windows 11. O macOS e o Linux funcionam da mesma forma; só mudam a aparência das molduras das janelas e dos menus do sistema.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'Instalação e primeira execução' }, + { h2: 'Baixar e instalar (Windows)' }, + { + ol: [ + 'Abra a página de versões no GitHub (https://github.com/naritaroad/qrcode-tool/releases/latest).', + 'Baixe `QRcodeTool-win-x64-Setup.exe` para a maioria dos computadores, ou `QRcodeTool-win-arm64-Setup.exe` para computadores com processador ARM.', + 'Execute o arquivo baixado. O QRcode tool é instalado só para a sua conta de usuário e não precisa de direitos de administrador.', + 'Ao final da instalação, o QRcode tool é iniciado e mostra a tela de boas-vindas.', + ], + }, + { tip: 'Se preferir não instalar nada, baixe o arquivo `Portable.zip`, extraia e execute o programa diretamente. A versão portátil não se atualiza sozinha.' }, + { h2: 'Se o Windows mostrar “O Windows protegeu o computador”' }, + { p: 'As versões atuais ainda não têm assinatura de código, então o Windows SmartScreen pode avisar sobre um editor desconhecido. Isso é comum em programas novos sem assinatura.' }, + { + ol: [ + 'No aviso, clique em **Mais informações**.', + 'Confira se o nome do aplicativo é QRcode tool e clique em **Executar assim mesmo**.', + ], + }, + { p: 'Para ter certeza de que o download não foi alterado, execute o comando a seguir no PowerShell e compare o resultado com o arquivo `SHA256SUMS` da página da versão:' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS e Linux' }, + { p: '**macOS:** baixe e instale o arquivo `.pkg`. As versões ainda não são autenticadas pela Apple; por isso, na primeira vez, clique com o botão direito no app e escolha **Abrir**. Na primeira leitura, permita o QRcode tool em **Ajustes do Sistema › Privacidade e Segurança › Gravação de Tela**, e em **Câmera** se quiser usar a webcam.' }, + { p: '**Linux:** baixe o arquivo `.AppImage`, torne-o executável e execute-o. O GNOME precisa da extensão “AppIndicator and KStatusNotifierItem Support” para mostrar ícones na bandeja.' }, + { h2: 'A tela de boas-vindas' }, + { p: 'A tela de boas-vindas aparece na primeira execução. Ela mostra as três formas mais comuns de escanear, com seus atalhos, e explica que os links nunca abrem de surpresa.' }, + { fig: 'welcome', cap: 'A tela de boas-vindas na primeira execução', width: 11 }, + { + ul: [ + '**Idioma:** segue o sistema operacional por padrão. A mudança vale na hora.', + '**Iniciar com o computador:** ativado por padrão, para que o atalho esteja sempre pronto. Você pode desativar aqui ou depois em **Configurações › Geral**.', + '**Experimente agora:** fecha a tela de boas-vindas e escaneia a tela inteira uma vez.', + '**Fechar:** fecha a tela de boas-vindas e mostra a barra de ferramentas flutuante.', + ], + }, + { p: 'Para ver a tela de boas-vindas de novo, abra **Configurações › Geral** e clique em **Mostrar a tela de boas-vindas novamente**.' }, + { h2: 'O ícone da bandeja' }, + { p: 'O QRcode tool não tem uma janela principal tradicional. Depois de iniciado, o ícone dele aparece na bandeja do sistema, no canto direito da barra de tarefas, e todos os recursos podem ser acessados por ali.' }, + { + ul: [ + '**Clicar no ícone:** escaneia a tela inteira na hora.', + '**Clicar com o botão direito:** abre o menu (figura 2-2).', + '**Passar o mouse sobre o ícone:** mostra o atalho de leitura atual.', + ], + }, + { fig: 'tray-menu', cap: 'O menu do ícone da bandeja', width: 11 }, + { tip: 'O Windows pode esconder ícones novos da bandeja atrás da seta “^”. Arraste o ícone para a barra de tarefas para mantê-lo visível.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: 'Escanear a tela' }, + { h2: 'Escanear a tela inteira' }, + { + ol: [ + 'Verifique se a página, o documento, o vídeo ou a imagem com o código QR está visível.', + 'Pressione [[Ctrl+Alt+Q]], clique no ícone da bandeja ou clique em **Escanear a tela inteira** na barra flutuante.', + 'A tela congela e escurece. Depois de uma rápida varredura, cada código encontrado recebe uma etiqueta de resultado.', + 'Pressione [[Enter]] para abrir o código selecionado ou clique na etiqueta desejada.', + 'Pressione [[Esc]] ou clique com o botão direito para sair da tela de leitura.', + ], + }, + { fig: 'scan-screen', cap: 'Escanear a tela inteira: cada código recebe uma etiqueta; o primeiro fica selecionado' }, + { p: 'O indicador de status no topo mostra quantos códigos foram encontrados. A cor dos colchetes em volta de cada código indica o resultado das verificações:' }, + { + table: { + cols: [22, 78], + head: ['Cor dos colchetes', 'Significado'], + rows: [ + ['Branco', 'Nada suspeito foi encontrado.'], + ['Cor de destaque (azul)', 'O código selecionado. [[Enter]] abre esse código.'], + ['Amarelo', 'Algo merece atenção, por exemplo um link http sem criptografia ou um link encurtado. O motivo aparece abaixo da etiqueta.'], + ['Vermelho', 'O link parece enganoso, por exemplo um endereço disfarçado ou um domínio que mistura alfabetos.'], + ], + }, + }, + { p: 'Como a tela fica congelada, também é possível ler códigos em vídeos, apresentações e jogos. Com vários monitores, todos são escaneados ao mesmo tempo.' }, + { h2: 'Selecionar uma área' }, + { p: 'Quando um código é pequeno, borrado ou inclinado, ou quando há muitos códigos na tela, desenhe um retângulo só em volta do que você precisa. A área selecionada é ampliada antes da leitura, o que funciona melhor que a tela inteira para códigos difíceis.' }, + { + ol: [ + 'Pressione [[Ctrl+Alt+A]] ou escolha **Selecionar área** no menu da bandeja ou na barra flutuante.', + 'A tela congela e o ponteiro vira uma cruz. Mantenha o botão esquerdo do mouse pressionado e arraste um retângulo em volta do código.', + 'Solte o botão. Só o conteúdo dentro do retângulo é lido.', + ], + }, + { fig: 'scan-region', cap: 'Selecionar área: o tamanho do retângulo aparece enquanto você arrasta' }, + { tip: 'Faça o retângulo um pouco maior que o código; uma margem vazia em volta ajuda. Se aparecer a mensagem “Nenhum código nessa área”, desenhe um retângulo um pouco maior.' }, + { h2: 'A barra da tela de leitura' }, + { p: 'A tela de leitura tem uma fileira de botões no topo. Da esquerda para a direita: **Escanear a tela inteira**, **Selecionar área**, **Escanear com a câmera**, **Escanear imagem da área de transferência**, **Abrir imagem…**, **Criar código QR…**, **Histórico**, **Configurações** e **Fechar**. Dá para trocar de método sem sair da tela de leitura, por exemplo da tela inteira para uma área selecionada. Passe o mouse sobre um botão para ver a descrição e o atalho.' }, + { h2: 'Teclado' }, + { p: 'A tela de leitura pode ser usada inteiramente pelo teclado:' }, + { + table: { + cols: [30, 70], + head: ['Tecla', 'Ação'], + rows: [ + ['[[Enter]]', 'Abrir o código selecionado.'], + ['[[Tab]], [[→]], [[↓]]', 'Selecionar o próximo código.'], + ['[[Shift+Tab]], [[←]], [[↑]]', 'Selecionar o código anterior.'], + ['[[C]]', 'Copiar o código selecionado.'], + ['[[F]] ou [[F5]]', 'Procurar novamente na tela inteira.'], + ['[[Esc]]', 'Cancelar e sair da tela de leitura (clicar com o botão direito também funciona).'], + ], + }, + }, + { h2: 'Quando nenhum código é encontrado' }, + { + ul: [ + 'Use **Selecionar área** e desenhe um retângulo só em volta do código; ele é ampliado antes da leitura.', + 'Se o código se move rápido em um vídeo, pause o vídeo primeiro.', + 'Afaste outras janelas, o ponteiro do mouse ou qualquer coisa que cubra parte do código.', + 'Verifique se **Configurações › Escaneamento › Também ler códigos de barras** está ativado se quiser ler códigos de barras e formatos como Data Matrix.', + 'Se o código estiver muito pequeno na tela (menos de cerca de 40 pixels de largura), amplie a página ou a imagem primeiro.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'Outras formas de escanear' }, + { h2: 'Webcam' }, + { p: 'Use a webcam para códigos em papel, cartões de visita ou na tela de outro celular.' }, + { + ol: [ + 'Pressione [[Ctrl+Alt+W]] ou escolha **Escanear com a câmera**.', + 'Mostre o código à câmera a uma distância de cerca de 15 a 30 cm.', + 'Quando um código é reconhecido, aparecem colchetes em volta dele e a etiqueta de resultado entra em uma lista fixa na parte de baixo da imagem.', + 'Clique na etiqueta, ou selecione-a com [[Tab]] e pressione [[Enter]].', + ], + }, + { fig: 'camera', cap: 'Escanear com a câmera: os resultados ficam em uma lista fixa na parte de baixo', width: 13 }, + { + ul: [ + 'Um código precisa aparecer em vários quadros seguidos antes de entrar na lista, o que evita leituras erradas.', + 'Depois que um código sai da imagem, o resultado continua na lista por um tempo (8 segundos por padrão), para você ainda poder clicar. Altere o tempo em **Configurações › Câmera**.', + 'Se houver mais de uma câmera conectada, alterne entre elas pela lista na parte de baixo da janela.', + 'A chave **Espelhar** só muda a forma como a imagem é exibida; o reconhecimento funciona do mesmo jeito.', + 'Por padrão, a janela da câmera fecha depois que um código é aberto. Você pode mudar isso em **Configurações › Câmera**.', + ], + }, + { note: 'Se a câmera não iniciar, feche outros programas que possam estar usando a câmera (chamadas de vídeo, por exemplo) e permita que o QRcode tool use a câmera nas configurações de privacidade do sistema.' }, + { h2: 'Imagem na área de transferência' }, + { + ol: [ + 'Faça uma captura do código com [[Win+Shift+S]] ou outra ferramenta de captura, ou copie uma imagem de uma página da web.', + 'Escolha **Escanear imagem da área de transferência**.', + 'A imagem aparece em uma janela de visualização, e cada código encontrado recebe uma etiqueta de resultado.', + ], + }, + { p: 'Se não houver imagem na área de transferência, o programa pede que você copie uma captura de tela ou imagem primeiro.' }, + { h2: 'Arquivos de imagem' }, + { + ol: [ + 'Escolha **Abrir imagem…**.', + 'Selecione um arquivo PNG, JPEG, BMP, GIF ou WebP.', + 'Clique em uma etiqueta de resultado na janela de visualização. Os botões na parte de baixo abrem outra imagem ou escaneiam a área de transferência.', + ], + }, + { fig: 'image-preview', cap: 'A janela de visualização: as etiquetas ficam sobre os códigos da imagem', width: 13 }, + { h2: 'Menu do botão direito do Windows' }, + { p: 'No Windows, o QRcode tool pode adicionar as funções principais ao menu do botão direito (menu de contexto) do Explorador de Arquivos: clique com o botão direito no fundo da área de trabalho para escanear a tela, ou em uma imagem para escanear esse arquivo, sem abrir a barra nem lembrar de atalhos.' }, + { + figs: [ + ['shell-desktop', 'Botão direito no fundo da área de trabalho'], + ['shell-image', 'Botão direito em uma imagem'], + ], + cap: 'Itens do QRcode tool no menu do botão direito (Windows 11, Mostrar mais opções)', + }, + { h3: 'Ativar ou desativar o menu do botão direito' }, + { p: 'O menu do botão direito vem **ativado**: os itens aparecem assim que o QRcode tool é instalado e iniciado uma vez. Se você o desativou antes, reative assim:' }, + { + ol: [ + 'Abra **Configurações** pelo menu da bandeja ou pela barra flutuante.', + 'Escolha **Geral** à esquerda.', + 'Ative **Menu do botão direito**. A mudança vale na hora; não é preciso reiniciar o computador nem o Explorador de Arquivos.', + ], + }, + { p: 'Desative a mesma chave para remover os itens. Eles ficam nas configurações do seu próprio usuário (a parte HKEY_CURRENT_USER do registro), então não são necessários direitos de administrador e as outras contas do computador não são afetadas.' }, + { h3: 'Abrir o menu' }, + { + ul: [ + '**Windows 11:** clique com o botão direito e escolha **Mostrar mais opções** no final; os itens do QRcode tool estão no menu completo. Para abrir o menu completo direto, segure [[Shift]] ao clicar com o botão direito ou pressione [[Shift+F10]].', + '**Windows 10:** os itens do QRcode tool aparecem assim que você clica com o botão direito.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['Item do menu', 'Onde', 'Ação'], + rows: [ + ['QRcode tool Digitalizar a tela', 'Fundo da área de trabalho', 'Escaneia a tela inteira (como [[Ctrl+Alt+Q]]).'], + ['QRcode tool Digitalizar seleção', 'Fundo da área de trabalho', 'Congela a tela para você selecionar uma área (como [[Ctrl+Alt+A]]).'], + ['QRcode tool Digitalizar com a câmera', 'Fundo da área de trabalho', 'Abre a webcam (como [[Ctrl+Alt+W]]).'], + ['QRcode tool Barra de ferramentas', 'Fundo da área de trabalho', 'Mostra a barra de ferramentas flutuante.'], + ['QRcode tool Abrir imagem', 'Arquivos de imagem', 'Escaneia a imagem na janela de visualização. São aceitos PNG, JPEG, BMP, GIF e WebP.'], + ], + }, + }, + { + ul: [ + 'Os quatro itens da área de trabalho ficam agrupados no fim do menu, entre separadores, com o ícone do QRcode tool.', + '**QRcode tool Abrir imagem** só aparece quando exatamente **uma** imagem está selecionada, não para vários arquivos de uma vez.', + 'Os itens usam o idioma do QRcode tool. Depois que você muda **Configurações › Geral › Idioma**, o menu também é atualizado.', + 'Se o QRcode tool não estiver em execução, escolher um item inicia o programa e executa a função; se já estiver em execução, o programa aberto atende o pedido.', + 'Na versão portátil, os itens apontam para o local atual do programa. Depois de mover a pasta portátil, inicie o programa uma vez para que os itens sejam atualizados.', + 'Desinstalar o QRcode tool remove os itens. O macOS e o Linux não têm itens no menu do botão direito; use os atalhos ou a linha de comando.', + ], + }, + { tip: 'Se o QRcode tool não aparecer no menu: verifique se **Configurações › Geral › Menu do botão direito** está ativado, escolha **Mostrar mais opções** no Windows 11 e inicie o QRcode tool uma vez se ele acabou de ser instalado ou movido.' }, + { h2: 'Linha de comando' }, + { p: 'Todas as funções de leitura podem ser iniciadas por um comando. Se o programa já estiver em execução, o comando é repassado a ele. Isso é especialmente útil no Linux com Wayland: associe os comandos a atalhos personalizados nas configurações de teclado da área de trabalho.' }, + { + table: { + cols: [42, 58], + head: ['Comando', 'Ação'], + rows: [ + ['`qrcode-tool`', 'Inicia o programa ou, se já estiver em execução, mostra a barra flutuante.'], + ['`qrcode-tool scan-screen`', 'Escaneia a tela inteira.'], + ['`qrcode-tool scan-region`', 'Congela a tela e seleciona uma área.'], + ['`qrcode-tool scan-camera`', 'Escaneia com a webcam.'], + ['`qrcode-tool scan-clipboard`', 'Escaneia a imagem da área de transferência.'], + ['`qrcode-tool scan-file ARQUIVO`', 'Escaneia um arquivo de imagem na janela de visualização.'], + ['`qrcode-tool toolbar`', 'Mostra ou oculta a barra de ferramentas flutuante.'], + ['`qrcode-tool bubble`', 'Mostra ou oculta a bolha flutuante.'], + ['`qrcode-tool generate "TEXTO"`', 'Abre o gerador de códigos QR com o texto preenchido.'], + ['`qrcode-tool settings`', 'Abre as configurações.'], + ['`qrcode-tool decode ARQUIVO… [--json]`', 'Mostra no terminal os códigos dos arquivos de imagem sem abrir a interface.'], + ['`qrcode-tool quit`', 'Encerra o programa em execução.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: 'Resultados e detalhes' }, + { h2: 'Etiquetas de resultado' }, + { p: 'Cada código encontrado recebe uma etiqueta de resultado escura. Da esquerda para a direita, ela mostra:' }, + { + ul: [ + '**Ícone:** o tipo de conteúdo, por exemplo um globo para link, ondas para Wi-Fi ou uma pessoa para contato. Links com aviso mostram um símbolo de aviso ou de perigo no lugar.', + '**Texto principal:** para links, o nome real do site em vez do endereço completo; para Wi-Fi, o nome da rede; para contatos, o nome.', + '**Segunda linha:** o tipo de conteúdo ou o principal motivo de um aviso.', + '**Botão ›:** sempre abre o cartão de detalhes, seja qual for o conteúdo.', + ], + }, + { h2: 'O que Enter ou um clique fazem' }, + { + table: { + cols: [36, 64], + head: ['Conteúdo', 'Ação'], + rows: [ + ['Link sem avisos', 'Abre no navegador padrão.'], + ['Link com aviso', 'Mostra primeiro o cartão de detalhes; o link só abre depois que você confirma.'], + ['Todo o resto', 'Mostra o cartão de detalhes, onde você escolhe o que fazer.'], + ], + }, + }, + { h2: 'O cartão de detalhes' }, + { p: 'O cartão de detalhes lista todos os campos do código e oferece botões adequados ao conteúdo. O botão de copiar ao lado de um campo copia só aquele campo. Campos sensíveis, como senhas, aparecem como “••••”; o botão de cadeado mostra o conteúdo por um instante. Clique fora do cartão ou em **Fechar** para voltar aos resultados.' }, + { fig: 'detail-wifi', cap: 'Cartão de detalhes de um código Wi-Fi: Conectar entra na rede', width: 12 }, + { h2: 'Botões para cada tipo de conteúdo' }, + { + table: { + cols: [30, 70], + head: ['Tipo', 'Botões'], + rows: [ + ['Link', '**Abrir**, **Copiar**. Links sem avisos para sites que você ainda não marcou como confiáveis também oferecem **Sempre permitir este site**.'], + ['Rede Wi-Fi', '**Conectar** (o sistema cria o perfil de rede), **Copiar senha**.'], + ['Contato (vCard, MeCard)', '**Salvar contato** (salva um arquivo .vcf que você pode importar nos contatos), **Copiar**.'], + ['Email', '**Escrever email** (abre o programa de email padrão), **Copiar**.'], + ['Número de telefone', '**Ligar** (repassado ao app de chamadas do sistema), **Copiar**.'], + ['Mensagem de texto', '**Enviar mensagem**, **Copiar**.'], + ['Local', '**Abrir mapa**, **Copiar**.'], + ['Chave de verificação em duas etapas', 'Só o nome do serviço e a conta são exibidos; **Copiar** está disponível. O segredo em si nunca é exibido nem armazenado.'], + ['Endereço de pagamento', '**Copiar**. Sempre confira um endereço de pagamento antes de enviar dinheiro.'], + ['Nota fiscal eletrônica', '**Copiar número da nota**, **Copiar**.'], + ['Link bloqueado', 'Links que não sejam `http` nem `https` (por exemplo `file:` ou `javascript:`) só podem ser copiados, nunca abertos.'], + ['Texto e códigos de barras', '**Copiar**. Nos códigos de barras, o formato (por exemplo EAN-13) também é exibido.'], + ], + }, + }, + { h2: 'Notas fiscais eletrônicas de Taiwan' }, + { p: 'Uma nota fiscal eletrônica de Taiwan tem dois códigos QR lado a lado. O código da esquerda contém o número da nota, a data, os valores e alguns itens; o da direita contém os itens restantes. Quando **Escanear a tela inteira** ou **Abrir imagem…** encontra os dois códigos, eles são unidos em uma única nota, e o cartão de detalhes lista o número da nota, a data, o código aleatório, o total, o imposto, as identificações do vendedor e do comprador e todos os itens. Se só o código da esquerda for encontrado, o cartão lembra você de escanear também o da direita.' }, + { h2: 'Dados sensíveis' }, + { p: 'Chaves de verificação em duas etapas e senhas de Wi-Fi são dados sensíveis. Mesmo com o histórico ou **Copiar o resultado automaticamente** ativados, elas nunca são gravadas no histórico, nunca são copiadas automaticamente e nunca são gravadas nos arquivos de log do programa.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'Segurança dos links' }, + { p: 'Códigos QR maliciosos costumam levar a sites falsos. O QRcode tool analisa cada endereço da web no seu computador antes de mostrar o resultado e marca o que encontra direto na etiqueta e no cartão de detalhes. Nada é consultado on-line e nenhum endereço é enviado a qualquer serviço.' }, + { h2: 'Confira o nome do site antes de abrir' }, + { p: 'A etiqueta de resultado mostra o nome real do site contido no endereço. Antes de abrir qualquer link, confirme que é o site esperado. Links com aviso mostram primeiro o cartão de detalhes, com um aviso colorido no topo explicando o que observar.' }, + { fig: 'detail-warning', cap: 'Um link com avisos: um link encurtado sem criptografia mostra os motivos e espera por você', width: 12 }, + { h2: 'Níveis de aviso' }, + { + table: { + cols: [18, 82], + head: ['Nível', 'O que o programa faz'], + rows: [ + ['Informação', 'Por exemplo, um endereço muito longo. Aparece só no cartão de detalhes; [[Enter]] abre o link diretamente.'], + ['Aviso', 'Colchetes e ícone amarelos. [[Enter]] ou um clique mostram primeiro o cartão de detalhes; depois você clica em **Abrir**.'], + ['Perigo', 'Colchetes e ícone vermelhos. **Abrir** deixa de ser o botão padrão e, depois de clicar nele, é preciso confirmar com **Abrir mesmo assim**.'], + ], + }, + }, + { h2: 'O que é verificado' }, + { + table: { + cols: [30, 12, 58], + head: ['Mensagem exibida', 'Nível', 'Explicação e conselho'], + rows: [ + ['Não criptografado (http)', 'Aviso', 'A conexão não é criptografada, então os dados podem ser lidos ou alterados no caminho. Não digite senhas nem dados de pagamento nessas páginas.'], + ['Endereço disfarçado', 'Perigo', 'Um nome que parece confiável é colocado antes de um “@”, mas o link na verdade leva ao site depois dele, por exemplo `https://bank.example.com@login-check.example.net/`.'], + ['Nome de domínio internacional', 'Aviso', 'O domínio contém letras não latinas. O cartão também mostra o endereço codificado real (começando com `xn--`) para você conferir.'], + ['Letras parecidas', 'Perigo', 'Uma parte do domínio mistura alfabetos, por exemplo um “а” cirílico no lugar de um “a” latino. É um truque comum de sites falsos.'], + ['Endereço IP', 'Aviso', 'O endereço usa números em vez do nome de um site, algo raro em sites comuns.'], + ['Porta incomum', 'Aviso', 'O endereço especifica um número de porta fora do padrão.'], + ['Link encurtado', 'Aviso', 'Serviços como bit.ly escondem o destino real. O link não é expandido on-line, porque isso diria ao serviço o que você escaneou. Abra links encurtados só de fontes confiáveis.'], + ['Endereço muito longo', 'Informação', 'Endereços muito longos podem empurrar o nome real do site para fora da vista.'], + ['Muitos caracteres codificados', 'Informação', 'Muitas sequências “%” podem ser usadas para esconder o que um endereço contém.'], + ['Muitos subdomínios', 'Informação', 'Por exemplo `login.bank.example.com.secure-check.example.net`, que à primeira vista pode parecer o site de um banco.'], + ], + }, + }, + { h2: 'Links enganosos' }, + { p: 'Para links classificados como **Perigo**, o cartão de detalhes diz em vermelho que o link parece enganoso e lista os motivos. Confie no nome real do site mostrado no cartão, não no texto impresso ao lado do código.' }, + { fig: 'detail-danger', cap: 'Um endereço disfarçado: parece um banco, mas leva a login-check.example.net', width: 12 }, + { p: 'Se tiver certeza de que quer continuar, clique em **Abrir**. O cartão pergunta mais uma vez; só **Abrir mesmo assim** abre de fato a página.' }, + { h2: 'Sites confiáveis e abertura automática' }, + { p: 'Você pode adicionar aos sites confiáveis os que usa com frequência, como o domínio da sua escola ou empresa. Assim, um link abre logo depois da leitura, sem esperar pelo [[Enter]], quando tudo isto for verdade:' }, + { + ul: [ + 'Só um código foi encontrado.', + 'O link não tem avisos.', + 'O site (ou um de seus subdomínios) está na lista de confiáveis.', + '**Configurações › Escaneamento › Abrir sites confiáveis sem perguntar** está ativado (o padrão).', + ], + }, + { p: 'Adicione um site com **Sempre permitir este site** no cartão de detalhes de um link sem avisos, ou digite o domínio em **Configurações › Escaneamento**.' }, + { fig: 'detail-link', cap: 'Um link sem avisos: abra-o ou adicione o site à lista de confiáveis', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'Barra de ferramentas e bolha flutuantes' }, + { p: 'A barra de ferramentas flutuante fica acima das outras janelas, para que cada função esteja a um clique. Ela nunca aparece nas capturas escaneadas. Mostre ou oculte a barra com **Barra de ferramentas flutuante** no menu da bandeja, com o atalho [[Ctrl+Alt+E]] ou com o comando `qrcode-tool toolbar`.' }, + { h2: 'Botões da barra' }, + { fig: 'toolbar-row', cap: 'Barra horizontal: passe o mouse sobre um botão para ver o nome e o atalho embaixo', width: 11 }, + { + table: { + cols: [34, 66], + head: ['Botão', 'Ação'], + rows: [ + ['(alça pontilhada no início)', 'Segure e arraste para mover a barra.'], + ['Escanear a tela inteira', 'O mesmo que [[Ctrl+Alt+Q]].'], + ['Selecionar área', 'O mesmo que [[Ctrl+Alt+A]].'], + ['Escanear com a câmera', 'O mesmo que [[Ctrl+Alt+W]]. Fica acinzentado quando nenhuma câmera é encontrada.'], + ['Escanear imagem da área de transferência', 'Lê a imagem da área de transferência.'], + ['Abrir imagem…', 'Escolha um arquivo de imagem e escaneie.'], + ['Criar código QR…', 'Abre o gerador de códigos QR.'], + ['Histórico', 'Abre **Configurações › Privacidade e histórico**.'], + ['Configurações', 'Abre as configurações.'], + ['Manual do usuário (botão “?”)', 'Abre o manual do usuário em PDF no GitHub em uma nova guia do navegador, no idioma da interface.'], + ['Recolher para bolha', 'Oculta a barra e mostra a pequena bolha redonda no lugar.'], + ['Fechar barra de ferramentas', 'Oculta a barra (a bolha não aparece). O programa continua em execução na bandeja.'], + ], + }, + }, + { h2: 'Barra vertical (direita ou esquerda)' }, + { p: 'Além do layout horizontal padrão no topo da tela, a barra pode ser uma coluna vertical na borda direita ou esquerda. A coluna ocupa menos largura, o que combina com telas largas e deixa o topo das páginas livre.' }, + { + figs: [ + ['toolbar-right', 'Vertical, à direita (posição vertical padrão)'], + ['toolbar-left', 'Vertical, à esquerda'], + ], + cap: 'Barra vertical: o nome e o atalho do botão apontado aparecem abaixo dos botões', + }, + { p: 'Para mudar o layout:' }, + { + ol: [ + 'Abra **Configurações** e escolha **Geral**.', + 'Na seção **Barra de ferramentas e bolha flutuantes**, encontre **Layout da barra de ferramentas**.', + 'Escolha **Horizontal, no topo**, **Vertical, à direita** ou **Vertical, à esquerda**.', + ], + }, + { p: 'A mudança vale na hora. A barra vai para a posição padrão do novo layout: centralizada no topo no layout horizontal, centralizada verticalmente na borda escolhida no vertical. Depois você ainda pode arrastá-la para qualquer lugar.' }, + { h2: 'Mover a barra' }, + { p: 'Segure a alça pontilhada em uma das pontas da barra e arraste. O programa lembra a última posição e mostra a barra ali da próxima vez. Se essa posição não estiver mais em nenhum monitor, por exemplo depois de desconectar uma tela externa, a barra volta à posição padrão.' }, + { h2: 'A bolha flutuante' }, + { p: 'A bolha flutuante é a barra recolhida. Ela ocupa só um pequeno círculo e aparece por padrão na borda direita da tela.' }, + { fig: 'bubble', cap: 'A bolha flutuante', width: 8 }, + { + table: { + cols: [30, 70], + head: ['Ação', 'Resultado'], + rows: [ + ['Clicar', 'Expande para a barra de ferramentas flutuante completa.'], + ['Segurar por cerca de meio segundo', 'Escaneia a tela inteira.'], + ['Clicar com o botão direito', 'Abre um menu: **Escanear a tela inteira**, **Selecionar área**, **Escanear com a câmera**, **Escanear imagem da área de transferência**, **Mostrar barra de ferramentas**, **Ocultar bolha**.'], + ['Arrastar', 'Move a bolha.'], + ], + }, + }, + { p: 'Para mostrar a bolha sempre que o programa iniciar, ative **Configurações › Geral › Mostrar a bolha quando o aplicativo iniciar**. A barra e a bolha nunca aparecem juntas.' }, + { h2: 'Ocultar durante aplicativos em tela inteira' }, + { p: 'No Windows, a barra e a bolha se escondem enquanto você assiste a um vídeo em tela inteira, faz uma apresentação ou joga, e voltam quando você sai da tela inteira. Desative isso em **Configurações › Geral › Ocultar durante aplicativos em tela inteira**.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'Criar códigos QR' }, + { p: 'O gerador de códigos QR transforma um link ou um texto em um código QR que você pode escanear com o celular ou colocar em documentos e apresentações.' }, + { + ol: [ + 'Escolha **Criar código QR…** no menu da bandeja, na barra flutuante ou na tela de leitura.', + 'Digite ou cole o conteúdo em **Texto ou link**. O código QR aparece na hora, à direita.', + 'Se necessário, escolha um nível de **Correção de erros**.', + 'Clique em **Copiar imagem** para copiar o código para a área de transferência, ou em **Salvar PNG…** ou **Salvar SVG…** para salvar como arquivo.', + ], + }, + { fig: 'generator', cap: 'O gerador de códigos QR', width: 13 }, + { h2: 'Correção de erros' }, + { p: 'Um nível mais alto permite ler o código mesmo com parte dele danificada ou coberta por um logotipo, mas deixa o código mais denso e maior.' }, + { + table: { + cols: [36, 64], + head: ['Nível', 'Quando usar'], + rows: [ + ['Baixa — código menor', 'Muito conteúdo que só será exibido na tela.'], + ['Média — recomendada', 'O padrão para uso geral.'], + ['Quartil', 'Códigos impressos em objetos que podem ser riscados.'], + ['Alta — resiste a danos ou a um logotipo', 'Quando um logotipo vai ficar no meio do código, ou quando é preciso o máximo de robustez.'], + ], + }, + }, + { note: 'Um código QR comporta uma quantidade limitada de conteúdo. Se aparecer “Texto demais para um código QR”, encurte o conteúdo ou escolha uma correção de erros menor.' }, + { p: '**PNG** é prático para documentos e slides; **SVG** é um formato vetorial que continua nítido quando impresso em tamanho grande. Pressione [[Esc]] para fechar o gerador.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: 'Configurações' }, + { p: 'Escolha **Configurações** no menu da bandeja, na barra flutuante ou na tela de leitura. Cada mudança é salva e aplicada na hora; não há botão OK.' }, + { h2: 'Geral' }, + { fig: 'settings-general', cap: 'Configurações › Geral', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Configuração', 'Descrição'], + rows: [ + ['Idioma', 'Idioma dos menus e mensagens. Segue o sistema operacional por padrão.'], + ['Tema', '**Usar configuração do sistema**, **Claro** ou **Escuro**. A cor de destaque do sistema é aplicada automaticamente.'], + ['Iniciar com o computador', 'Inicia discretamente em segundo plano quando você entra no sistema, para que o atalho sempre funcione.'], + ['Menu do botão direito', '(Só no Windows) Adiciona itens do QRcode tool aos menus do botão direito da área de trabalho e dos arquivos de imagem. Ativado por padrão; veja “Menu do botão direito do Windows” no capítulo 4.'], + ['Layout da barra de ferramentas', '**Horizontal, no topo**, **Vertical, à direita** ou **Vertical, à esquerda**. Veja o capítulo 7.'], + ['Mostrar a bolha quando o aplicativo iniciar', 'Mostra a bolha flutuante na inicialização.'], + ['Ocultar durante aplicativos em tela inteira', '(Só no Windows) Oculta a barra e a bolha durante vídeos, apresentações e jogos em tela inteira.'], + ['Verificar atualizações automaticamente', 'Pergunta ao GitHub uma vez por dia se existe uma versão nova. Nada é instalado sem perguntar a você.'], + ['Mostrar a tela de boas-vindas novamente', 'Abre a tela de boas-vindas da primeira execução.'], + ], + }, + }, + { h2: 'Escaneamento' }, + { fig: 'settings-scanning', cap: 'Configurações › Escaneamento', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Configuração', 'Descrição'], + rows: [ + ['Copiar o resultado automaticamente', 'Quando exatamente um código é encontrado, o conteúdo vai para a área de transferência. Conteúdo sensível nunca é copiado. Desativado por padrão.'], + ['Tocar um som quando um código for encontrado', 'Toca um som curto. Desativado por padrão.'], + ['Também ler códigos de barras', 'Além de códigos QR, lê EAN, UPC, Code 128, Data Matrix, PDF417, Aztec e outros. Ativado por padrão.'], + ['Abrir sites confiáveis sem perguntar', 'Abre automaticamente links para sites confiáveis nas condições descritas no capítulo 6.'], + ['Sites confiáveis', 'Digite um domínio (por exemplo example.com) e clique em **Adicionar**. Os subdomínios também passam a ser confiáveis. O ícone de lixeira remove um item.'], + ], + }, + }, + { h2: 'Câmera' }, + { fig: 'settings-camera', cap: 'Configurações › Câmera', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Configuração', 'Descrição'], + rows: [ + ['Câmera', 'A webcam que será usada.'], + ['Espelhar a imagem', 'Mostra a câmera como um espelho. O reconhecimento funciona do mesmo jeito.'], + ['Manter resultados na tela (segundos)', 'Por quanto tempo (de 0 a 60 segundos) um resultado continua na lista depois que o código sai da imagem. Com 0, só os códigos visíveis no momento são listados.'], + ['Fechar a câmera depois que um código for aberto', 'Fecha a janela da câmera assim que um código é aberto ou usado.'], + ], + }, + }, + { h2: 'Atalhos' }, + { fig: 'settings-shortcuts', cap: 'Configurações › Atalhos', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['Ação', 'Padrão', 'Descrição'], + rows: [ + ['Escanear a tela inteira', '[[Ctrl+Alt+Q]]', 'Congela e escaneia todos os monitores.'], + ['Selecionar área', '[[Ctrl+Alt+A]]', 'Congela a tela para você arrastar um retângulo.'], + ['Escanear com a câmera', '[[Ctrl+Alt+W]]', 'Abre a janela da webcam.'], + ['Mostrar ou ocultar a barra de ferramentas', '[[Ctrl+Alt+E]]', 'Alterna a barra de ferramentas flutuante.'], + ], + }, + }, + { p: 'Para mudar um atalho:' }, + { + ol: [ + 'Clique no atalho que deseja mudar. O botão mostra **Pressione as teclas… (Esc para cancelar)**.', + 'Pressione a nova combinação de teclas. Ela precisa incluir pelo menos uma destas: [[Ctrl]], [[Alt]], [[Shift]] ou [[Win]] (no Mac, [[Cmd]]).', + 'O novo atalho vale na hora.', + ], + }, + { p: 'Se outro aplicativo já usa a combinação, a linha mostra “Já usado por outro aplicativo — escolha outro.”. Escolha outra combinação. **Restaurar padrões** traz de volta todos os atalhos padrão. A seção **Durante o escaneamento**, embaixo, lista as teclas da tela de leitura, as mesmas do capítulo 3.' }, + { h2: 'Privacidade e histórico' }, + { fig: 'settings-privacy', cap: 'Configurações › Privacidade e histórico (com o histórico ativado)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Configuração', 'Descrição'], + rows: [ + ['Manter um histórico de escaneamentos', 'Fica só neste computador. Senhas de Wi-Fi e chaves de verificação em duas etapas nunca são salvas. Desativado por padrão.'], + ['Número de itens a manter', 'De 5 a 500 itens. Os mais antigos são removidos primeiro.'], + ['Escaneamentos recentes', 'Os mais novos primeiro. Links sem avisos podem ser abertos de novo com **Abrir**; qualquer item pode ser copiado com **Copiar**.'], + ['Limpar histórico', 'Apaga todo o histórico.'], + ], + }, + }, + { h2: 'Sobre' }, + { fig: 'settings-about', cap: 'Configurações › Sobre', width: 14 }, + { + ul: [ + 'Mostra a versão atual. **Verificar atualizações** verifica na hora.', + 'Links para o código-fonte, para relatar problemas, para a política de privacidade e para as licenças de código aberto.', + '**Abrir a pasta de configurações** e **Abrir a pasta de logs** abrem essas pastas diretamente, para fazer backup das configurações ou anexar arquivos de log a um relato de problema.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: 'Atualizar e desinstalar' }, + { h2: 'Verificar e instalar atualizações' }, + { p: 'Cópias instaladas pelo instalador podem se atualizar sozinhas. Com **Verificar atualizações automaticamente** ativado, o programa pergunta ao GitHub uma vez por dia. Você também pode clicar em **Verificar atualizações** no menu da bandeja ou em **Configurações › Sobre** a qualquer momento.' }, + { fig: 'message-update', cap: 'A mensagem mostrada quando há uma versão nova', width: 10 }, + { + ol: [ + 'Quando aparecer a mensagem **Atualização disponível**, clique em **Atualizar agora**.', + 'A nova versão é baixada em segundo plano, e o programa reinicia quando termina.', + 'Clique em **Mais tarde** se não quiser atualizar agora.', + ], + }, + { p: 'As atualizações só são instaladas depois que você clica em **Atualizar agora**; o programa nunca instala nada por conta própria.' }, + { h2: 'Versão portátil' }, + { p: 'A versão portátil (`Portable.zip`) não se atualiza sozinha; ao verificar atualizações, aparece “Atualizações não disponíveis”. Baixe a nova versão na página de versões do GitHub e substitua os arquivos antigos. Suas configurações são mantidas.' }, + { h2: 'Desinstalar' }, + { + ol: [ + 'Abra **Configurações › Aplicativos › Aplicativos instalados** do Windows.', + 'Encontre o QRcode tool, clique em **…** e escolha **Desinstalar**.', + 'O item de inicialização e os itens do menu do botão direito também são removidos.', + ], + }, + { p: 'Para remover também as configurações e o histórico, abra a pasta de configurações e a pasta de logs em **Configurações › Sobre** antes de desinstalar e apague-as.' }, + { h2: 'Onde ficam as configurações e os logs' }, + { + table: { + cols: [18, 82], + head: ['Sistema', 'Local'], + rows: [ + ['Windows', 'Configurações: `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\nHistórico e logs: `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', 'Configurações: `~/.config/qrcode-tool`\nHistórico e logs: `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: 'O arquivo de configurações `settings.toml` é texto simples. Copie-o para levar suas configurações para outro computador.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'Solução de problemas' }, + { + qa: [ + ['Nada acontece quando pressiono o atalho.', 'Outro aplicativo pode já estar usando esse atalho. Abra **Configurações › Atalhos**; se a linha mostrar “Já usado por outro aplicativo”, escolha outra combinação. Alguns jogos e programas de área de trabalho remota capturam todas as teclas enquanto estão em primeiro plano.'], + ['A leitura não encontra nenhum código.', 'Use **Selecionar área** e desenhe um retângulo só em volta do código, ou amplie primeiro a página ou a imagem. Veja “Quando nenhum código é encontrado” no capítulo 3.'], + ['Por que o link não abriu na hora?', 'Um link com aviso sempre mostra os detalhes primeiro, para você conferir o site real. Só links para sites confiáveis sem nenhum aviso abrem automaticamente, e só quando são o único código encontrado.'], + ['Aparece “Link encurtado — o destino real está oculto”.', 'Serviços de links encurtados escondem o destino real. O programa não consulta isso on-line, porque revelaria o que você escaneou. Abra links encurtados só de fontes confiáveis.'], + ['Onde está a janela principal?', 'Não existe, de propósito. Use o ícone da bandeja, o atalho, a barra de ferramentas flutuante ou a bolha flutuante.'], + ['O QRcode tool não aparece no menu do botão direito.', 'Verifique se **Configurações › Geral › Menu do botão direito** está ativado. No Windows 11, os itens ficam em **Mostrar mais opções** (ou segure [[Shift]] ao clicar com o botão direito). **QRcode tool Abrir imagem** só aparece quando uma imagem está selecionada. Se você acabou de instalar o QRcode tool ou moveu a versão portátil, inicie-o uma vez.'], + ['A barra de ferramentas sumiu.', 'Pressione [[Ctrl+Alt+E]] ou marque **Barra de ferramentas flutuante** no menu da bandeja. Com **Ocultar durante aplicativos em tela inteira** ativado, a barra fica oculta enquanto um programa em tela inteira está em primeiro plano.'], + ['A câmera não inicia.', 'Feche outros programas que usam a câmera e verifique se as configurações de privacidade do sistema permitem que o QRcode tool a use. Com várias câmeras, escolha a certa em **Configurações › Câmera**.'], + ['O Wi-Fi não conecta automaticamente.', 'Algumas redes (por exemplo, com autenticação corporativa) não podem ser configuradas pelo programa. Clique em **Copiar senha** no cartão de detalhes e conecte pelo menu de Wi-Fi do sistema.'], + ['Meu antivírus mostra um aviso.', 'Programas novos sem assinatura que registram atalhos, leem a tela e iniciam com o computador às vezes são sinalizados pela detecção baseada em comportamento. O QRcode tool usa interfaces padrão do sistema e o código-fonte é público. Relate o falso positivo ao fornecedor do antivírus ou abra uma issue no GitHub.'], + ['No macOS a captura fica preta.', 'Permita o QRcode tool em **Ajustes do Sistema › Privacidade e Segurança › Gravação de Tela** e reinicie o programa. O macOS pode perguntar de novo depois de atualizações do sistema.'], + ['No Linux com Wayland o atalho não faz nada.', 'O Wayland não permite que programas registrem atalhos globais. Adicione um atalho personalizado nas configurações de teclado da área de trabalho que execute `qrcode-tool scan-screen` ou outro comando.'], + ['Como abro este manual de novo?', 'Clique no botão **?** (**Manual do usuário**) na barra flutuante; a edição em PDF no GitHub abre em uma nova guia do navegador. Os arquivos Word e PDF também estão na pasta `docs/manual` do repositório no GitHub.'], + ['Como relato um problema?', 'Clique em **Relatar um problema ou sugerir uma ideia** em **Configurações › Sobre** e descreva seu sistema, os passos e as mensagens que você viu. Você pode anexar arquivos da pasta de logs; os logs contêm só eventos e erros, nunca conteúdo escaneado.'], + ], + }, + + // ───────────────────────── Apêndices ───────────────────────── + { h1: 'Atalhos e teclas em resumo', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['Onde', 'Tecla', 'Ação'], + rows: [ + ['Em qualquer lugar', '[[Ctrl+Alt+Q]]', 'Escanear a tela inteira'], + ['Em qualquer lugar', '[[Ctrl+Alt+A]]', 'Selecionar área'], + ['Em qualquer lugar', '[[Ctrl+Alt+W]]', 'Escanear com a câmera'], + ['Em qualquer lugar', '[[Ctrl+Alt+E]]', 'Mostrar ou ocultar a barra flutuante'], + ['Tela de leitura, visualização', '[[Enter]]', 'Abrir o código selecionado'], + ['Tela de leitura, visualização', '[[Tab]] / [[Shift+Tab]]', 'Selecionar o próximo / anterior código'], + ['Tela de leitura, visualização', '[[C]]', 'Copiar o código selecionado'], + ['Tela de leitura', '[[F]] ou [[F5]]', 'Procurar novamente na tela inteira'], + ['Tela de leitura, visualização, gerador', '[[Esc]]', 'Fechar'], + ], + }, + }, + { p: 'Os atalhos globais podem ser alterados em **Configurações › Atalhos**. A tabela mostra os padrões.' }, + { h1: 'Códigos compatíveis', appendix: true }, + { + table: { + cols: [30, 70], + head: ['Grupo', 'Formatos'], + rows: [ + ['Sempre lidos', 'QR Code, Micro QR Code, rMQR Code'], + ['Com “Também ler códigos de barras”', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec e outros'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['Conteúdo reconhecido', 'Exemplo'], + rows: [ + ['Link da web', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:rede;P:senha;;`'], + ['Contato', 'vCard (`BEGIN:VCARD`), MeCard (`MECARD:`)'], + ['Email', '`mailto:`, `MATMSG:`'], + ['Telefone e mensagem de texto', '`tel:`, `sms:`, `SMSTO:`'], + ['Local', '`geo:25.0330,121.5654`'], + ['Chave de verificação em duas etapas', '`otpauth://`'], + ['Endereço de pagamento', '`bitcoin:`, `ethereum:` e outros'], + ['Nota fiscal eletrônica de Taiwan', 'Os dois códigos QR da nota'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.ru.js b/docs/manual/build/content.ru.js new file mode 100644 index 0000000..55674de --- /dev/null +++ b/docs/manual/build/content.ru.js @@ -0,0 +1,733 @@ +// Текст руководства пользователя QRcode tool (русский язык). +// Разметка: **жирный**, [[Клавиша]], `код`. Имена рисунков соответствуют shots/<язык>/ (см. figures.js). + +module.exports = { + lang: 'ru', + font: 'Segoe UI', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-ru', + docTitle: 'Руководство пользователя QRcode tool', + cover: { + title: 'QRcode tool', + subtitle: 'Руководство пользователя', + tagline: 'Сканируйте QR-коды на компьютере так же легко, как на телефоне.', + edition: 'Версия 1.0.0 | октябрь 2026 г.', + platforms: 'Для Windows 10 (21H2 и новее) / Windows 11, macOS 13 и новее и Linux', + }, + back: { + heading: 'Сканируйте. Проверяйте. Затем открывайте.', + body: [ + 'QRcode tool — бесплатный сканер с открытым исходным кодом для настольных компьютеров. Он считывает QR-коды и штрихкоды с экрана, веб-камеры, из буфера обмена и файлов изображений и перед открытием проверяет каждый веб-адрес на распространённые уловки.', + 'Всё происходит на вашем компьютере. Программа не собирает данные об использовании и никогда не отправляет в интернет то, что вы сканируете.', + ], + links: [ + ['Страница проекта', 'https://github.com/naritaroad/qrcode-tool'], + ['Последняя версия', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['Сообщить о проблеме', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: 'Программа распространяется по лицензии MIT или Apache-2.0. Это руководство можно копировать и изменять на тех же условиях.', + trademark: 'QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. QRcode tool не связан с DENSO WAVE, Google или Microsoft.', + }, + labels: { + toc: 'Содержание', + chapter: (n) => `Глава ${n}`, + appendix: (l) => `Приложение ${l}`, + figure: (id) => `Рисунок ${id}`, + tip: 'Совет', + note: 'Примечание', + header: 'Руководство пользователя QRcode tool', + tocHint: '(В Word щёлкните оглавление правой кнопкой мыши и выберите «Обновить поле», чтобы обновить номера страниц.)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: 'Знакомство с QRcode tool' }, + { p: 'QRcode tool — небольшая программа, которая ждёт в области уведомлений и считывает QR-коды и штрихкоды с экрана. Когда вы нажимаете сочетание клавиш, экран на мгновение замирает, и каждый код получает метку с результатом: тип содержимого, а для ссылок — настоящее имя сайта. Нажмите [[Enter]] или щёлкните метку, чтобы открыть ссылку, подключиться к сети Wi-Fi или сохранить контакт.' }, + { p: 'Программа также считывает коды, поднесённые к веб-камере, изображения из буфера обмена и файлы изображений, а ещё в ней есть простой генератор QR-кодов.' }, + { h2: 'Основные возможности' }, + { + table: { + cols: [26, 74], + head: ['Возможность', 'Описание'], + rows: [ + ['Сканировать весь экран', 'Замораживает все мониторы, автоматически находит каждый код и подписывает его. Работает и с видео, и с играми.'], + ['Выделить область', 'Обведите рамкой один код. Подходит для кодов, которые слишком малы, размыты или наклонены, чтобы найтись автоматически.'], + ['Веб-камера', 'Поднесите к камере напечатанный код или экран телефона — результат появится, как только код будет распознан.'], + ['Буфер обмена и файлы изображений', 'Считывает только что скопированный снимок экрана или файлы PNG, JPEG, BMP, GIF и WebP.'], + ['Понимает содержимое', 'Распознаёт веб-ссылки, Wi-Fi, контакты, электронную почту, номера телефонов, SMS, места на карте, ключи двухэтапной проверки, платёжные адреса и тайваньские электронные чеки и предлагает подходящие кнопки.'], + ['Проверка ссылок', 'Перед открытием ссылка проверяется на соединение без шифрования, замаскированный адрес, похожие буквы, IP-адрес, короткую ссылку и другие распространённые уловки. Все проверки выполняются без подключения к сети.'], + ['Создание QR-кодов', 'Превращает текст или ссылку в QR-код, который можно скопировать или сохранить в PNG или SVG.'], + ['Плавающая панель и кнопка', 'Панель инструментов вверху экрана (горизонтально) или у правого либо левого края (вертикально), которую можно свернуть в маленькую круглую кнопку.'], + ['Языки', 'Английский, китайский (традиционный), китайский (упрощённый), японский, корейский, испанский, португальский (Бразилия), французский, немецкий и русский.'], + ], + }, + }, + { h2: 'Системные требования' }, + { + table: { + cols: [30, 70], + head: ['Операционная система', 'Требования и примечания'], + rows: [ + ['Windows', 'Windows 10 21H2 и новее, Windows 11. x64 и ARM64. Для установки права администратора не нужны.'], + ['macOS', 'macOS 13 и новее (Apple Silicon и Intel). Для первого сканирования нужно разрешение «Запись экрана», для сканирования веб-камерой — разрешение «Камера».'], + ['Linux', 'Все функции в X11. В Wayland сканирование запускается сочетанием клавиш, которое вы задаёте в настройках рабочего стола (см. главу 4).'], + ['Оборудование', 'Подойдёт любой обычный офисный компьютер. Веб-камера не обязательна. В режиме ожидания программа занимает менее 30 МБ памяти.'], + ], + }, + }, + { h2: 'Принципы конфиденциальности и безопасности' }, + { + ul: [ + 'Декодирование и проверка ссылок выполняются на вашем компьютере. Отсканированное содержимое никуда не загружается, а репутация адресов ни у каких веб-служб не запрашивается.', + 'Единственное сетевое подключение — необязательная автоматическая проверка обновлений, которая лишь спрашивает у GitHub, есть ли новая версия.', + 'Журнал сканирования по умолчанию выключен. Даже если его включить, пароли Wi-Fi и ключи двухэтапной проверки в нём никогда не сохраняются.', + 'Открывать можно только адреса `http` и `https`. Остальные ссылки можно лишь скопировать; системе они никогда не передаются.', + 'Ссылка с предупреждением всегда сначала показывает подробности и ждёт вашего решения.', + ], + }, + { h2: 'Обозначения в руководстве' }, + { + ul: [ + 'Кнопки, параметры и названия окон выделены **жирным**, например **Параметры** или **Сканировать весь экран**.', + 'Клавиши показаны как клавиши, например [[Enter]] или [[Ctrl+Alt+Q]].', + '**Параметры › Общие** означает: откройте окно **Параметры** и выберите слева страницу **Общие**.', + 'На рисунках показана Windows 11. В macOS и Linux всё работает так же, отличаются только рамки окон и системные меню.', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: 'Установка и первый запуск' }, + { h2: 'Загрузка и установка (Windows)' }, + { + ol: [ + 'Откройте страницу выпусков на GitHub (https://github.com/naritaroad/qrcode-tool/releases/latest).', + 'Для большинства компьютеров скачайте `QRcodeTool-win-x64-Setup.exe`, для компьютеров с процессором ARM — `QRcodeTool-win-arm64-Setup.exe`.', + 'Запустите скачанный файл. QRcode tool устанавливается только для вашей учётной записи и не требует прав администратора.', + 'По окончании установки QRcode tool запускается и показывает экран приветствия.', + ], + }, + { tip: 'Если не хотите ничего устанавливать, скачайте файл `Portable.zip`, распакуйте его и запустите программу напрямую. Переносная версия не умеет обновляться сама.' }, + { h2: 'Если Windows показывает «Система Windows защитила ваш компьютер»' }, + { p: 'Текущие выпуски пока не подписаны цифровой подписью, поэтому Windows SmartScreen может предупредить о неизвестном издателе. Для новых неподписанных программ это обычное дело.' }, + { + ol: [ + 'В предупреждении нажмите **Подробнее**.', + 'Убедитесь, что имя приложения — QRcode tool, и нажмите **Выполнить в любом случае**.', + ], + }, + { p: 'Чтобы убедиться, что загруженный файл не изменён, выполните в PowerShell следующую команду и сравните результат с файлом `SHA256SUMS` на странице выпуска:' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS и Linux' }, + { p: '**macOS:** скачайте и установите файл `.pkg`. Выпуски пока не заверены Apple, поэтому в первый раз щёлкните приложение правой кнопкой мыши и выберите **Открыть**. При первом сканировании разрешите QRcode tool в разделе **Системные настройки › Конфиденциальность и безопасность › Запись экрана**, а если хотите пользоваться веб-камерой — ещё и в разделе **Камера**.' }, + { p: '**Linux:** скачайте файл `.AppImage`, сделайте его исполняемым и запустите. Чтобы в GNOME отображались значки в области уведомлений, нужно расширение «AppIndicator and KStatusNotifierItem Support».' }, + { h2: 'Экран приветствия' }, + { p: 'Экран приветствия появляется при первом запуске. Он показывает три самых частых способа сканирования с их сочетаниями клавиш и объясняет, что ссылки никогда не открываются неожиданно.' }, + { fig: 'welcome', cap: 'Экран приветствия при первом запуске', width: 11 }, + { + ul: [ + '**Язык:** по умолчанию совпадает с языком системы. Изменение вступает в силу сразу.', + '**Запускать вместе с компьютером:** по умолчанию включено, чтобы сочетание клавиш всегда работало. Отключить можно здесь или позже в разделе **Параметры › Общие**.', + '**Попробовать:** закрывает экран приветствия и один раз сканирует весь экран.', + '**Закрыть:** закрывает экран приветствия и показывает плавающую панель инструментов.', + ], + }, + { p: 'Чтобы снова увидеть экран приветствия, откройте **Параметры › Общие** и нажмите **Снова показать экран приветствия**.' }, + { h2: 'Значок в области уведомлений' }, + { p: 'У QRcode tool нет привычного главного окна. После запуска его значок появляется в области уведомлений у правого края панели задач, и отсюда доступны все функции.' }, + { + ul: [ + '**Щелчок по значку:** сразу сканирует весь экран.', + '**Щелчок правой кнопкой:** открывает меню (рисунок 2-2).', + '**Наведение указателя на значок:** показывает текущее сочетание клавиш для сканирования.', + ], + }, + { fig: 'tray-menu', cap: 'Меню значка в области уведомлений', width: 11 }, + { tip: 'Windows может прятать новые значки за стрелкой «^». Перетащите значок на панель задач, чтобы он всегда был виден.' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: 'Сканирование экрана' }, + { h2: 'Сканировать весь экран' }, + { + ol: [ + 'Убедитесь, что веб-страница, документ, видео или изображение с QR-кодом видны на экране.', + 'Нажмите [[Ctrl+Alt+Q]], щёлкните значок в области уведомлений или нажмите **Сканировать весь экран** на плавающей панели.', + 'Экран замирает и затемняется. После короткой анимации сканирования каждый найденный код получает метку с результатом.', + 'Нажмите [[Enter]], чтобы открыть выбранный код, или щёлкните нужную метку.', + 'Нажмите [[Esc]] или щёлкните правой кнопкой мыши, чтобы выйти из режима сканирования.', + ], + }, + { fig: 'scan-screen', cap: 'Сканировать весь экран: у каждого кода есть метка, первый код выбран' }, + { p: 'Индикатор состояния вверху показывает, сколько кодов найдено. Цвет скобок вокруг каждого кода показывает результат проверок:' }, + { + table: { + cols: [22, 78], + head: ['Цвет скобок', 'Значение'], + rows: [ + ['Белый', 'Ничего подозрительного не найдено.'], + ['Цвет акцента (синий)', 'Выбранный код. [[Enter]] открывает его.'], + ['Жёлтый', 'Есть на что обратить внимание, например ссылка http без шифрования или короткая ссылка. Причина указана под меткой.'], + ['Красный', 'Ссылка выглядит обманной, например замаскированный адрес или домен, в котором смешаны алфавиты.'], + ], + }, + }, + { p: 'Поскольку экран заморожен, можно считывать коды из видео, презентаций и игр. Если мониторов несколько, сканируются все одновременно.' }, + { h2: 'Выделить область' }, + { p: 'Если код маленький, размытый или наклонённый либо на экране много кодов, обведите рамкой только нужный. Выделенная область перед считыванием увеличивается, поэтому с трудными кодами это работает лучше, чем сканирование всего экрана.' }, + { + ol: [ + 'Нажмите [[Ctrl+Alt+A]] или выберите **Выделить область** в меню значка или на плавающей панели.', + 'Экран замирает, указатель превращается в перекрестие. Удерживая левую кнопку мыши, обведите код рамкой.', + 'Отпустите кнопку мыши. Считывается только то, что внутри рамки.', + ], + }, + { fig: 'scan-region', cap: 'Выделить область: во время перетаскивания показывается размер рамки' }, + { tip: 'Сделайте рамку чуть больше кода — пустое поле вокруг помогает. Если появилось сообщение «В этой области нет кода», нарисуйте рамку немного побольше.' }, + { h2: 'Панель режима сканирования' }, + { p: 'Вверху экрана сканирования находится ряд кнопок. Слева направо: **Сканировать весь экран**, **Выделить область**, **Сканировать камерой**, **Сканировать изображение из буфера обмена**, **Открыть изображение…**, **Создать QR-код…**, **Журнал**, **Параметры** и **Закрыть**. Способ можно сменить, не выходя из режима сканирования, например перейти от всего экрана к выделенной области. Наведите указатель на кнопку, чтобы увидеть её описание и сочетание клавиш.' }, + { h2: 'Клавиатура' }, + { p: 'Режимом сканирования можно полностью управлять с клавиатуры:' }, + { + table: { + cols: [30, 70], + head: ['Клавиша', 'Действие'], + rows: [ + ['[[Enter]]', 'Открыть выбранный код.'], + ['[[Tab]], [[→]], [[↓]]', 'Выбрать следующий код.'], + ['[[Shift+Tab]], [[←]], [[↑]]', 'Выбрать предыдущий код.'], + ['[[C]]', 'Скопировать выбранный код.'], + ['[[F]] или [[F5]]', 'Заново выполнить поиск по всему экрану.'], + ['[[Esc]]', 'Отменить и выйти из режима сканирования (щелчок правой кнопкой тоже работает).'], + ], + }, + }, + { h2: 'Если код не найден' }, + { + ul: [ + 'Воспользуйтесь функцией **Выделить область** и обведите рамкой только код — перед считыванием он будет увеличен.', + 'Если код в видео быстро движется, сначала поставьте видео на паузу.', + 'Уберите другие окна, указатель мыши и всё, что закрывает часть кода.', + 'Если нужно считывать штрихкоды и форматы вроде Data Matrix, проверьте, что включён параметр **Параметры › Сканирование › Также считывать штрихкоды**.', + 'Если код на экране очень мелкий (меньше примерно 40 пикселей в ширину), сначала увеличьте страницу или изображение.', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: 'Другие способы сканирования' }, + { h2: 'Веб-камера' }, + { p: 'Коды на бумаге, визитках или на экране другого телефона удобно сканировать веб-камерой.' }, + { + ol: [ + 'Нажмите [[Ctrl+Alt+W]] или выберите **Сканировать камерой**.', + 'Поднесите код к камере на расстояние примерно 15–30 см.', + 'Когда код распознан, вокруг него появляются скобки, а метка с результатом попадает в постоянный список внизу изображения.', + 'Щёлкните метку или выберите её клавишей [[Tab]] и нажмите [[Enter]].', + ], + }, + { fig: 'camera', cap: 'Сканировать камерой: результаты остаются в постоянном списке внизу', width: 13 }, + { + ul: [ + 'Код попадает в список, только если его видно в нескольких кадрах подряд, — это защищает от ошибочного считывания.', + 'Когда код уходит из кадра, результат ещё какое-то время (по умолчанию 8 секунд) остаётся в списке, и по нему можно щёлкнуть. Время меняется в разделе **Параметры › Камера**.', + 'Если подключено несколько камер, переключайтесь между ними с помощью списка внизу окна.', + 'Переключатель **Зеркально** меняет только отображение картинки; распознавание работает в любом случае.', + 'По умолчанию окно камеры закрывается после открытия кода. Это можно изменить в разделе **Параметры › Камера**.', + ], + }, + { note: 'Если камера не запускается, закройте другие программы, которые могут её использовать (например, видеозвонки), и разрешите QRcode tool доступ к камере в настройках конфиденциальности системы.' }, + { h2: 'Изображение из буфера обмена' }, + { + ol: [ + 'Сделайте снимок кода клавишами [[Win+Shift+S]] или другим инструментом либо скопируйте изображение с веб-страницы.', + 'Выберите **Сканировать изображение из буфера обмена**.', + 'Изображение откроется в окне предварительного просмотра, и каждый найденный код получит метку с результатом.', + ], + }, + { p: 'Если в буфере обмена нет изображения, программа попросит сначала скопировать снимок экрана или картинку.' }, + { h2: 'Файлы изображений' }, + { + ol: [ + 'Выберите **Открыть изображение…**.', + 'Выберите файл PNG, JPEG, BMP, GIF или WebP.', + 'Щёлкните метку с результатом в окне предварительного просмотра. Кнопки внизу открывают другое изображение или вместо этого сканируют буфер обмена.', + ], + }, + { fig: 'image-preview', cap: 'Окно предварительного просмотра: метки размещаются на кодах в изображении', width: 13 }, + { h2: 'Контекстное меню Windows' }, + { p: 'В Windows QRcode tool может добавить свои основные функции в контекстное меню проводника: щёлкните правой кнопкой фон рабочего стола, чтобы отсканировать экран, или изображение, чтобы отсканировать этот файл, — без открытия панели и без запоминания сочетаний клавиш.' }, + { + figs: [ + ['shell-desktop', 'Щелчок правой кнопкой по фону рабочего стола'], + ['shell-image', 'Щелчок правой кнопкой по изображению'], + ], + cap: 'Пункты QRcode tool в контекстном меню (Windows 11, «Показать дополнительные параметры»)', + }, + { h3: 'Включение и отключение контекстного меню' }, + { p: 'Контекстное меню по умолчанию **включено**: пункты появляются, как только QRcode tool установлен и один раз запущен. Если вы раньше его отключили, включите снова так:' }, + { + ol: [ + 'Откройте **Параметры** из меню значка или с плавающей панели.', + 'Слева выберите **Общие**.', + 'Включите **Контекстное меню**. Изменение вступает в силу сразу; перезапускать компьютер или проводник не нужно.', + ], + }, + { p: 'Чтобы убрать пункты, выключите тот же переключатель. Они хранятся в ваших собственных параметрах пользователя (раздел HKEY_CURRENT_USER реестра), поэтому права администратора не нужны, а другие учётные записи на компьютере не затрагиваются.' }, + { h3: 'Как открыть меню' }, + { + ul: [ + '**Windows 11:** щёлкните правой кнопкой и выберите внизу **Показать дополнительные параметры** — пункты QRcode tool находятся в полном меню. Чтобы сразу открыть полное меню, удерживайте [[Shift]] при щелчке правой кнопкой или нажмите [[Shift+F10]].', + '**Windows 10:** пункты QRcode tool появляются сразу при щелчке правой кнопкой.', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['Пункт меню', 'Где', 'Действие'], + rows: [ + ['QRcode tool Сканировать экран', 'Фон рабочего стола', 'Сканирует весь экран (как [[Ctrl+Alt+Q]]).'], + ['QRcode tool Сканировать область', 'Фон рабочего стола', 'Замораживает экран, чтобы вы выделили область (как [[Ctrl+Alt+A]]).'], + ['QRcode tool Сканировать камерой', 'Фон рабочего стола', 'Открывает веб-камеру (как [[Ctrl+Alt+W]]).'], + ['QRcode tool Панель инструментов', 'Фон рабочего стола', 'Показывает плавающую панель инструментов.'], + ['QRcode tool Открыть изображение', 'Файлы изображений', 'Сканирует изображение в окне предварительного просмотра. Поддерживаются PNG, JPEG, BMP, GIF и WebP.'], + ], + }, + }, + { + ul: [ + 'Четыре пункта для рабочего стола собраны внизу меню между разделителями и отмечены значком QRcode tool.', + 'Пункт **QRcode tool Открыть изображение** появляется, только когда выбрано ровно **одно** изображение, а не несколько файлов сразу.', + 'Пункты отображаются на языке QRcode tool. После изменения параметра **Параметры › Общие › Язык** меню тоже обновляется.', + 'Если QRcode tool не запущен, выбор пункта запускает программу и выполняет функцию; если запущен — запрос обрабатывает уже работающая программа.', + 'В переносной версии пункты указывают на текущее расположение программы. После перемещения папки один раз запустите программу, чтобы пункты обновились.', + 'При удалении QRcode tool пункты удаляются. В macOS и Linux пунктов контекстного меню нет — пользуйтесь сочетаниями клавиш или командной строкой.', + ], + }, + { tip: 'Если QRcode tool нет в меню: проверьте, что параметр **Параметры › Общие › Контекстное меню** включён, в Windows 11 выберите **Показать дополнительные параметры**, а если программа только что установлена или перемещена, один раз запустите QRcode tool.' }, + { h2: 'Командная строка' }, + { p: 'Любую функцию сканирования можно запустить командой. Если программа уже работает, команда передаётся ей. Это особенно удобно в Linux с Wayland: назначьте команды собственным сочетаниям клавиш в настройках клавиатуры рабочего стола.' }, + { + table: { + cols: [42, 58], + head: ['Команда', 'Действие'], + rows: [ + ['`qrcode-tool`', 'Запускает программу или, если она уже работает, показывает плавающую панель.'], + ['`qrcode-tool scan-screen`', 'Сканирует весь экран.'], + ['`qrcode-tool scan-region`', 'Замораживает экран для выделения области.'], + ['`qrcode-tool scan-camera`', 'Сканирует веб-камерой.'], + ['`qrcode-tool scan-clipboard`', 'Сканирует изображение из буфера обмена.'], + ['`qrcode-tool scan-file ФАЙЛ`', 'Сканирует один файл изображения в окне предварительного просмотра.'], + ['`qrcode-tool toolbar`', 'Показывает или скрывает плавающую панель инструментов.'], + ['`qrcode-tool bubble`', 'Показывает или скрывает плавающую кнопку.'], + ['`qrcode-tool generate "ТЕКСТ"`', 'Открывает генератор QR-кодов с уже введённым текстом.'], + ['`qrcode-tool settings`', 'Открывает параметры.'], + ['`qrcode-tool decode ФАЙЛ… [--json]`', 'Выводит коды из файлов изображений в терминал без запуска интерфейса.'], + ['`qrcode-tool quit`', 'Завершает работающую программу.'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: 'Результаты и подробности' }, + { h2: 'Метки с результатами' }, + { p: 'Каждый найденный код получает тёмную метку с результатом. Слева направо на ней показаны:' }, + { + ul: [ + '**Значок:** тип содержимого, например глобус для ссылки, волны для Wi-Fi или человечек для контакта. У ссылок с предупреждением вместо этого показан знак предупреждения или опасности.', + '**Основной текст:** для ссылок — настоящее имя сайта, а не полный адрес; для Wi-Fi — имя сети; для контактов — имя.', + '**Вторая строка:** тип содержимого или главная причина предупреждения.', + '**Кнопка ›:** всегда открывает карточку с подробностями, каким бы ни было содержимое.', + ], + }, + { h2: 'Что делают Enter и щелчок' }, + { + table: { + cols: [36, 64], + head: ['Содержимое', 'Действие'], + rows: [ + ['Ссылка без предупреждений', 'Открывается в браузере по умолчанию.'], + ['Ссылка с предупреждением', 'Сначала показывается карточка с подробностями; ссылка открывается только после вашего подтверждения.'], + ['Всё остальное', 'Показывается карточка с подробностями, где вы выбираете действие.'], + ], + }, + }, + { h2: 'Карточка с подробностями' }, + { p: 'В карточке перечислены все поля кода и есть кнопки, подходящие к содержимому. Кнопка копирования рядом с полем копирует только это поле. Конфиденциальные поля, например пароли, скрыты как «••••»; кнопка с замком ненадолго их показывает. Щёлкните за пределами карточки или нажмите **Закрыть**, чтобы вернуться к результатам.' }, + { fig: 'detail-wifi', cap: 'Карточка кода Wi-Fi: «Подключиться» подключает к сети', width: 12 }, + { h2: 'Кнопки для разных типов содержимого' }, + { + table: { + cols: [30, 70], + head: ['Тип', 'Кнопки'], + rows: [ + ['Ссылка', '**Открыть**, **Копировать**. Для ссылок без предупреждений на сайты, которым вы ещё не доверяете, есть также **Всегда разрешать этот сайт**.'], + ['Сеть Wi-Fi', '**Подключиться** (система создаёт профиль сети), **Копировать пароль**.'], + ['Контакт (vCard, MeCard)', '**Сохранить контакт** (сохраняет файл .vcf, который можно импортировать в адресную книгу), **Копировать**.'], + ['Электронная почта', '**Написать письмо** (открывает почтовую программу по умолчанию), **Копировать**.'], + ['Номер телефона', '**Позвонить** (передаётся системному приложению для звонков), **Копировать**.'], + ['SMS-сообщение', '**Отправить сообщение**, **Копировать**.'], + ['Местоположение', '**Открыть карту**, **Копировать**.'], + ['Ключ двухэтапной проверки', 'Показываются только название службы и учётная запись; доступна кнопка **Копировать**. Сам секрет никогда не показывается и не сохраняется.'], + ['Платёжный адрес', '**Копировать**. Всегда перепроверяйте платёжный адрес перед отправкой денег.'], + ['Электронный чек (Тайвань)', '**Копировать номер чека**, **Копировать**.'], + ['Заблокированная ссылка', 'Ссылки, отличные от `http` и `https` (например `file:` или `javascript:`), можно только скопировать, но не открыть.'], + ['Текст и штрихкоды', '**Копировать**. Для штрихкодов также указан формат, например EAN-13.'], + ], + }, + }, + { h2: 'Тайваньские электронные чеки' }, + { p: 'На тайваньском электронном чеке два QR-кода расположены рядом. Левый код содержит номер чека, дату, суммы и часть позиций, правый — остальные позиции. Когда **Сканировать весь экран** или **Открыть изображение…** находит оба кода, они объединяются в один чек, и в карточке показываются номер чека, дата, случайный код, итог, налог, идентификаторы продавца и покупателя и все позиции. Если найден только левый код, карточка напомнит отсканировать и правый.' }, + { h2: 'Конфиденциальные данные' }, + { p: 'Ключи двухэтапной проверки и пароли Wi-Fi — конфиденциальные данные. Даже при включённом журнале или параметре **Автоматически копировать результат** они никогда не записываются в журнал, не копируются автоматически и не попадают в файлы журналов работы программы.' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: 'Безопасность ссылок' }, + { p: 'Вредоносные QR-коды часто ведут на поддельные сайты. QRcode tool анализирует каждый веб-адрес на вашем компьютере ещё до показа результата и отмечает найденное прямо на метке и в карточке. Ничего не проверяется в интернете, и ни один адрес никуда не отправляется.' }, + { h2: 'Перед открытием проверьте имя сайта' }, + { p: 'На метке показано настоящее имя сайта из адреса. Прежде чем открыть ссылку, убедитесь, что это именно тот сайт, который вы ожидаете. Ссылки с предупреждением сначала показывают карточку, а вверху цветная плашка объясняет, на что обратить внимание.' }, + { fig: 'detail-warning', cap: 'Ссылка с предупреждениями: короткая ссылка без шифрования показывает причины и ждёт', width: 12 }, + { h2: 'Уровни предупреждений' }, + { + table: { + cols: [18, 82], + head: ['Уровень', 'Что делает программа'], + rows: [ + ['Сведения', 'Например, очень длинный адрес. Указывается только в карточке; [[Enter]] сразу открывает ссылку.'], + ['Предупреждение', 'Жёлтые скобки и значок. [[Enter]] или щелчок сначала показывает карточку, затем вы нажимаете **Открыть**.'], + ['Опасность', 'Красные скобки и значок. **Открыть** больше не кнопка по умолчанию, а после нажатия нужно ещё подтвердить кнопкой **Всё равно открыть**.'], + ], + }, + }, + { h2: 'Что проверяется' }, + { + table: { + cols: [30, 12, 58], + head: ['Сообщение', 'Уровень', 'Пояснение и совет'], + rows: [ + ['Без шифрования (http)', 'Предупреждение', 'Соединение не зашифровано, поэтому данные по пути можно прочитать или изменить. Не вводите на таких страницах пароли и платёжные данные.'], + ['Замаскированный адрес', 'Опасность', 'Перед символом «@» стоит имя, внушающее доверие, но на самом деле ссылка ведёт на сайт после него, например `https://bank.example.com@login-check.example.net/`.'], + ['Международное доменное имя', 'Предупреждение', 'В домене есть нелатинские буквы. В карточке также показан настоящий закодированный адрес (начинается с `xn--`), чтобы вы могли его проверить.'], + ['Похожие буквы', 'Опасность', 'В части домена смешаны алфавиты, например кириллическая «а» вместо латинской «a». Это частая уловка поддельных сайтов.'], + ['IP-адрес', 'Предупреждение', 'Вместо имени сайта в адресе используются цифры, что для обычных сайтов редкость.'], + ['Необычный порт', 'Предупреждение', 'В адресе указан нестандартный номер порта.'], + ['Короткая ссылка', 'Предупреждение', 'Сервисы вроде bit.ly скрывают настоящий адрес. Ссылка не раскрывается через интернет, потому что тогда сервис узнал бы, что вы отсканировали. Открывайте короткие ссылки только из надёжных источников.'], + ['Очень длинный адрес', 'Сведения', 'Очень длинный адрес может вытеснить настоящее имя сайта из поля зрения.'], + ['Много закодированных символов', 'Сведения', 'Множество последовательностей «%» может скрывать, что на самом деле содержит адрес.'], + ['Много поддоменов', 'Сведения', 'Например, `login.bank.example.com.secure-check.example.net` на первый взгляд похож на сайт банка.'], + ], + }, + }, + { h2: 'Обманные ссылки' }, + { p: 'Для ссылок с уровнем **Опасность** карточка красным сообщает, что ссылка выглядит обманной, и перечисляет причины. Доверяйте настоящему имени сайта в карточке, а не тексту, напечатанному рядом с кодом.' }, + { fig: 'detail-danger', cap: 'Замаскированный адрес: похож на банк, но ведёт на login-check.example.net', width: 12 }, + { p: 'Если вы уверены, что хотите продолжить, нажмите **Открыть**. Карточка спросит ещё раз; страницу откроет только кнопка **Всё равно открыть**.' }, + { h2: 'Надёжные сайты и автоматическое открытие' }, + { p: 'Сайты, которыми вы часто пользуетесь, например домен вашего учебного заведения или компании, можно добавить в надёжные. Тогда ссылка открывается сразу после сканирования, без нажатия [[Enter]], если выполнены все условия:' }, + { + ul: [ + 'Найден только один код.', + 'У ссылки нет предупреждений.', + 'Сайт (или его поддомен) есть в списке надёжных.', + 'Включён параметр **Параметры › Сканирование › Открывать надёжные сайты без подтверждения** (по умолчанию включён).', + ], + }, + { p: 'Добавить сайт можно кнопкой **Всегда разрешать этот сайт** в карточке ссылки без предупреждений или вручную в разделе **Параметры › Сканирование**.' }, + { fig: 'detail-link', cap: 'Ссылка без предупреждений: откройте её или добавьте сайт в список надёжных', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: 'Плавающая панель инструментов и кнопка' }, + { p: 'Плавающая панель инструментов находится поверх других окон, так что любая функция доступна в один щелчок. На сканируемых снимках экрана она никогда не появляется. Показать или скрыть её можно пунктом **Плавающая панель инструментов** в меню значка, сочетанием [[Ctrl+Alt+E]] или командой `qrcode-tool toolbar`.' }, + { h2: 'Кнопки панели' }, + { fig: 'toolbar-row', cap: 'Горизонтальная панель: наведите указатель на кнопку, чтобы увидеть под ней название и сочетание клавиш', width: 11 }, + { + table: { + cols: [34, 66], + head: ['Кнопка', 'Действие'], + rows: [ + ['(точечный маркер в начале)', 'Зажмите и перетащите, чтобы переместить панель.'], + ['Сканировать весь экран', 'То же, что [[Ctrl+Alt+Q]].'], + ['Выделить область', 'То же, что [[Ctrl+Alt+A]].'], + ['Сканировать камерой', 'То же, что [[Ctrl+Alt+W]]. Недоступна, если камера не найдена.'], + ['Сканировать изображение из буфера обмена', 'Считывает изображение из буфера обмена.'], + ['Открыть изображение…', 'Выбрать файл изображения и отсканировать его.'], + ['Создать QR-код…', 'Открывает генератор QR-кодов.'], + ['Журнал', 'Открывает **Параметры › Конфиденциальность и журнал**.'], + ['Параметры', 'Открывает параметры.'], + ['Руководство пользователя (кнопка «?»)', 'Открывает PDF-руководство на GitHub в новой вкладке браузера на языке интерфейса.'], + ['Свернуть в плавающую кнопку', 'Скрывает панель и показывает вместо неё маленькую круглую кнопку.'], + ['Закрыть панель инструментов', 'Скрывает панель (кнопка не появляется). Программа продолжает работать в области уведомлений.'], + ], + }, + }, + { h2: 'Вертикальная панель (справа или слева)' }, + { p: 'Кроме горизонтального расположения вверху экрана (по умолчанию), панель может быть вертикальной колонкой у правого или левого края. Колонка занимает меньше места по ширине, что удобно на широких экранах, и не закрывает верх веб-страниц.' }, + { + figs: [ + ['toolbar-right', 'Вертикально, справа (вертикальное положение по умолчанию)'], + ['toolbar-left', 'Вертикально, слева'], + ], + cap: 'Вертикальная панель: название и сочетание клавиш кнопки под указателем показываются под кнопками', + }, + { p: 'Чтобы изменить расположение:' }, + { + ol: [ + 'Откройте **Параметры** и выберите **Общие**.', + 'В разделе **Плавающая панель и кнопка** найдите **Расположение панели**.', + 'Выберите **Горизонтально, сверху**, **Вертикально, справа** или **Вертикально, слева**.', + ], + }, + { p: 'Изменение вступает в силу сразу. Панель перемещается в положение по умолчанию для нового расположения: по центру вверху для горизонтального, по центру выбранного края для вертикального. После этого её можно перетащить куда угодно.' }, + { h2: 'Перемещение панели' }, + { p: 'Зажмите точечный маркер на одном из концов панели и перетащите. Программа запоминает последнее положение и в следующий раз показывает панель там же. Если это положение больше не попадает ни на один монитор, например после отключения внешнего дисплея, панель возвращается на место по умолчанию.' }, + { h2: 'Плавающая кнопка' }, + { p: 'Плавающая кнопка — это свёрнутая панель. Она занимает лишь маленький круг и по умолчанию появляется у правого края экрана.' }, + { fig: 'bubble', cap: 'Плавающая кнопка', width: 8 }, + { + table: { + cols: [30, 70], + head: ['Действие', 'Результат'], + rows: [ + ['Щелчок', 'Разворачивает полную плавающую панель инструментов.'], + ['Удержание около полсекунды', 'Сканирует весь экран.'], + ['Щелчок правой кнопкой', 'Открывает меню: **Сканировать весь экран**, **Выделить область**, **Сканировать камерой**, **Сканировать изображение из буфера обмена**, **Показать панель инструментов**, **Скрыть плавающую кнопку**.'], + ['Перетаскивание', 'Перемещает кнопку.'], + ], + }, + }, + { p: 'Чтобы кнопка появлялась при каждом запуске программы, включите **Параметры › Общие › Показывать плавающую кнопку при запуске приложения**. Панель и кнопка никогда не показываются одновременно.' }, + { h2: 'Скрытие при полноэкранных приложениях' }, + { p: 'В Windows панель и кнопка скрываются, пока вы смотрите видео во весь экран, показываете презентацию или играете, и возвращаются после выхода из полноэкранного режима. Отключить это можно параметром **Параметры › Общие › Скрывать при полноэкранных приложениях**.' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: 'Создание QR-кодов' }, + { p: 'Генератор QR-кодов превращает ссылку или текст в QR-код, который можно отсканировать телефоном или вставить в документы и презентации.' }, + { + ol: [ + 'Выберите **Создать QR-код…** в меню значка, на плавающей панели или в режиме сканирования.', + 'Введите или вставьте содержимое в поле **Текст или ссылка**. QR-код сразу появится справа.', + 'При необходимости выберите уровень **Коррекция ошибок**.', + 'Нажмите **Копировать изображение**, чтобы скопировать код в буфер обмена, или **Сохранить PNG…** либо **Сохранить SVG…**, чтобы сохранить его в файл.', + ], + }, + { fig: 'generator', cap: 'Генератор QR-кодов', width: 13 }, + { h2: 'Коррекция ошибок' }, + { p: 'Чем выше уровень, тем лучше код читается, даже если часть его повреждена или закрыта логотипом, но тем он плотнее и крупнее.' }, + { + table: { + cols: [36, 64], + head: ['Уровень', 'Когда использовать'], + rows: [ + ['Низкая — самый маленький код', 'Много содержимого, которое будет показываться только на экране.'], + ['Средняя — рекомендуется', 'Значение по умолчанию для обычных задач.'], + ['Повышенная', 'Коды, напечатанные на вещах, которые могут потереться.'], + ['Высокая — выдерживает повреждения или логотип', 'Если в центр кода будет помещён логотип или нужна максимальная надёжность.'], + ], + }, + }, + { note: 'QR-код вмещает ограниченный объём данных. Если появилось сообщение «Слишком много текста для одного QR-кода», сократите содержимое или выберите более низкий уровень коррекции ошибок.' }, + { p: '**PNG** удобен для документов и слайдов; **SVG** — векторный формат, который остаётся чётким даже при печати крупным планом. Нажмите [[Esc]], чтобы закрыть генератор.' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: 'Параметры' }, + { p: 'Выберите **Параметры** в меню значка, на плавающей панели или в режиме сканирования. Каждое изменение сразу сохраняется и применяется; кнопки «ОК» нет.' }, + { h2: 'Общие' }, + { fig: 'settings-general', cap: 'Параметры › Общие', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Параметр', 'Описание'], + rows: [ + ['Язык', 'Язык меню и сообщений. По умолчанию совпадает с языком системы.'], + ['Тема', '**Как в системе**, **Светлая** или **Тёмная**. Цвет акцента системы применяется автоматически.'], + ['Запускать вместе с компьютером', 'Незаметно запускается в фоне при входе в систему, чтобы сочетание клавиш всегда работало.'], + ['Контекстное меню', '(Только Windows) Добавляет пункты QRcode tool в контекстные меню рабочего стола и файлов изображений. По умолчанию включено; см. «Контекстное меню Windows» в главе 4.'], + ['Расположение панели', '**Горизонтально, сверху**, **Вертикально, справа** или **Вертикально, слева**. См. главу 7.'], + ['Показывать плавающую кнопку при запуске приложения', 'Показывает плавающую кнопку при запуске.'], + ['Скрывать при полноэкранных приложениях', '(Только Windows) Скрывает панель и кнопку во время полноэкранных видео, презентаций и игр.'], + ['Автоматически проверять наличие обновлений', 'Раз в день спрашивает GitHub, есть ли новая версия. Без вашего согласия ничего не устанавливается.'], + ['Снова показать экран приветствия', 'Открывает экран приветствия первого запуска.'], + ], + }, + }, + { h2: 'Сканирование' }, + { fig: 'settings-scanning', cap: 'Параметры › Сканирование', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Параметр', 'Описание'], + rows: [ + ['Автоматически копировать результат', 'Если найден ровно один код, его содержимое помещается в буфер обмена. Конфиденциальное содержимое никогда не копируется. По умолчанию выключено.'], + ['Воспроизводить звук при обнаружении кода', 'Воспроизводит короткий звук. По умолчанию выключено.'], + ['Также считывать штрихкоды', 'Помимо QR-кодов считывает EAN, UPC, Code 128, Data Matrix, PDF417, Aztec и другие форматы. По умолчанию включено.'], + ['Открывать надёжные сайты без подтверждения', 'Автоматически открывает ссылки на надёжные сайты при условиях из главы 6.'], + ['Надёжные сайты', 'Введите домен (например, example.com) и нажмите **Добавить**. Его поддомены тоже считаются надёжными. Значок корзины удаляет запись.'], + ], + }, + }, + { h2: 'Камера' }, + { fig: 'settings-camera', cap: 'Параметры › Камера', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Параметр', 'Описание'], + rows: [ + ['Камера', 'Используемая веб-камера.'], + ['Зеркально отражать изображение', 'Показывает изображение камеры как в зеркале. Распознавание работает в любом случае.'], + ['Хранить результаты на экране (секунды)', 'Сколько времени (от 0 до 60 секунд) результат остаётся в списке после того, как код ушёл из кадра. При 0 в списке только коды, видимые сейчас.'], + ['Закрывать камеру после открытия кода', 'Закрывает окно камеры, как только код открыт или использован.'], + ], + }, + }, + { h2: 'Сочетания клавиш' }, + { fig: 'settings-shortcuts', cap: 'Параметры › Сочетания клавиш', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['Действие', 'По умолчанию', 'Описание'], + rows: [ + ['Сканировать весь экран', '[[Ctrl+Alt+Q]]', 'Замораживает и сканирует все мониторы.'], + ['Выделить область', '[[Ctrl+Alt+A]]', 'Замораживает экран, чтобы вы обвели рамку.'], + ['Сканировать камерой', '[[Ctrl+Alt+W]]', 'Открывает окно веб-камеры.'], + ['Показать или скрыть панель инструментов', '[[Ctrl+Alt+E]]', 'Переключает плавающую панель.'], + ], + }, + }, + { p: 'Чтобы изменить сочетание клавиш:' }, + { + ol: [ + 'Щёлкните сочетание, которое хотите изменить. На кнопке появится **Нажмите клавиши… (Esc — отмена)**.', + 'Нажмите новое сочетание. Оно должно включать хотя бы одну из клавиш [[Ctrl]], [[Alt]], [[Shift]] или [[Win]] (на Mac — [[Cmd]]).', + 'Новое сочетание начинает работать сразу.', + ], + }, + { p: 'Если это сочетание уже занято другим приложением, в строке появится «Уже используется другим приложением — выберите другое.» Выберите другое сочетание. **Восстановить значения по умолчанию** возвращает все стандартные сочетания. Раздел **Во время сканирования** внизу перечисляет клавиши режима сканирования — те же, что в главе 3.' }, + { h2: 'Конфиденциальность и журнал' }, + { fig: 'settings-privacy', cap: 'Параметры › Конфиденциальность и журнал (журнал включён)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['Параметр', 'Описание'], + rows: [ + ['Вести журнал сканирования', 'Хранится только на этом компьютере. Пароли Wi-Fi и ключи двухэтапной проверки никогда не сохраняются. По умолчанию выключено.'], + ['Количество хранимых записей', 'От 5 до 500 записей. Самые старые удаляются первыми.'], + ['Последние сканирования', 'Сначала самые новые. Ссылки без предупреждений можно снова открыть кнопкой **Открыть**; любую запись можно скопировать кнопкой **Копировать**.'], + ['Очистить журнал', 'Удаляет весь журнал.'], + ], + }, + }, + { h2: 'О программе' }, + { fig: 'settings-about', cap: 'Параметры › О программе', width: 14 }, + { + ul: [ + 'Показывает текущую версию. **Проверить наличие обновлений** выполняет проверку сразу.', + 'Ссылки на исходный код, сообщения о проблемах, заявление о конфиденциальности и лицензии открытого ПО.', + '**Открыть папку параметров** и **Открыть папку журналов работы** сразу открывают эти папки — чтобы сделать резервную копию параметров или приложить журналы к сообщению о проблеме.', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: 'Обновление и удаление' }, + { h2: 'Проверка и установка обновлений' }, + { p: 'Копии, установленные установщиком, умеют обновляться сами. Если включён параметр **Автоматически проверять наличие обновлений**, программа раз в день обращается к GitHub. Кроме того, в любой момент можно нажать **Проверить наличие обновлений** в меню значка или в разделе **Параметры › О программе**.' }, + { fig: 'message-update', cap: 'Сообщение о доступной новой версии', width: 10 }, + { + ol: [ + 'Когда появится сообщение **Доступно обновление**, нажмите **Обновить сейчас**.', + 'Новая версия загрузится в фоне, а затем программа перезапустится.', + 'Нажмите **Позже**, если не хотите обновляться сейчас.', + ], + }, + { p: 'Обновления устанавливаются только после нажатия **Обновить сейчас**; сама программа ничего не устанавливает.' }, + { h2: 'Переносная версия' }, + { p: 'Переносная версия (`Portable.zip`) сама не обновляется; при проверке обновлений показывается «Обновления недоступны». Скачайте новую версию со страницы выпусков GitHub и замените старые файлы. Ваши параметры сохранятся.' }, + { h2: 'Удаление' }, + { + ol: [ + 'Откройте в Windows **Параметры › Приложения › Установленные приложения**.', + 'Найдите QRcode tool, нажмите **…** и выберите **Удалить**.', + 'Запись автозапуска и пункты контекстного меню тоже удаляются.', + ], + }, + { p: 'Чтобы удалить и параметры с журналом, перед удалением откройте папку параметров и папку журналов работы из раздела **Параметры › О программе** и удалите их.' }, + { h2: 'Где хранятся параметры и журналы' }, + { + table: { + cols: [18, 82], + head: ['Система', 'Расположение'], + rows: [ + ['Windows', 'Параметры: `%APPDATA%\\Lrniey666\\qrcode-tool\\config`\nЖурнал сканирования и журналы работы: `%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', 'Параметры: `~/.config/qrcode-tool`\nЖурнал сканирования и журналы работы: `~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: 'Файл параметров `settings.toml` — обычный текст. Скопируйте его, чтобы перенести параметры на другой компьютер.' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: 'Устранение неполадок' }, + { + qa: [ + ['При нажатии сочетания клавиш ничего не происходит.', 'Возможно, его уже использует другое приложение. Откройте **Параметры › Сочетания клавиш**; если в строке написано «Уже используется другим приложением», выберите другое сочетание. Некоторые игры и программы удалённого рабочего стола перехватывают все клавиши, пока находятся на переднем плане.'], + ['Сканирование не находит код.', 'Воспользуйтесь функцией **Выделить область** и обведите рамкой только код или сначала увеличьте страницу или изображение. См. «Если код не найден» в главе 3.'], + ['Почему ссылка не открылась сразу?', 'Ссылка с предупреждением всегда сначала показывает подробности, чтобы вы проверили настоящий сайт. Автоматически открываются только ссылки на надёжные сайты без единого предупреждения и только если это единственный найденный код.'], + ['Написано «Короткая ссылка — настоящий адрес скрыт».', 'Сервисы коротких ссылок скрывают настоящий адрес. Программа не выясняет его через интернет, потому что это выдало бы, что вы отсканировали. Открывайте короткие ссылки только из надёжных источников.'], + ['Где главное окно?', 'Его нет, и это сделано намеренно. Пользуйтесь значком в области уведомлений, сочетанием клавиш, плавающей панелью или плавающей кнопкой.'], + ['QRcode tool нет в контекстном меню.', 'Проверьте, что параметр **Параметры › Общие › Контекстное меню** включён. В Windows 11 пункты находятся в разделе **Показать дополнительные параметры** (или удерживайте [[Shift]] при щелчке правой кнопкой). Пункт **QRcode tool Открыть изображение** появляется, только когда выбрано одно изображение. Если вы только что установили QRcode tool или переместили переносную версию, один раз запустите программу.'], + ['Панель инструментов пропала.', 'Нажмите [[Ctrl+Alt+E]] или отметьте **Плавающая панель инструментов** в меню значка. Если включён параметр **Скрывать при полноэкранных приложениях**, панель скрыта, пока на переднем плане полноэкранная программа.'], + ['Камера не запускается.', 'Закройте другие программы, использующие камеру, и проверьте, разрешён ли QRcode tool доступ к камере в настройках конфиденциальности системы. Если камер несколько, выберите нужную в разделе **Параметры › Камера**.'], + ['Wi-Fi не подключается автоматически.', 'Некоторые сети (например, с корпоративной аутентификацией) программа настроить не может. Нажмите **Копировать пароль** в карточке и подключитесь через меню Wi-Fi системы.'], + ['Антивирус выдаёт предупреждение.', 'Новые неподписанные программы, которые регистрируют сочетания клавиш, считывают экран и запускаются вместе с компьютером, иногда помечаются поведенческим анализом. QRcode tool использует стандартные системные интерфейсы, а его исходный код открыт. Сообщите о ложном срабатывании производителю антивируса или создайте issue на GitHub.'], + ['В macOS снимок экрана чёрный.', 'Разрешите QRcode tool в разделе **Системные настройки › Конфиденциальность и безопасность › Запись экрана** и перезапустите программу. После обновления системы macOS может спросить снова.'], + ['В Linux с Wayland сочетание клавиш не работает.', 'Wayland не позволяет программам регистрировать глобальные сочетания клавиш. Добавьте в настройках клавиатуры рабочего стола собственное сочетание, которое выполняет `qrcode-tool scan-screen` или другую команду.'], + ['Как снова открыть это руководство?', 'Нажмите кнопку **?** (**Руководство пользователя**) на плавающей панели — PDF-версия на GitHub откроется в новой вкладке браузера. Файлы Word и PDF также лежат в папке `docs/manual` репозитория на GitHub.'], + ['Как сообщить о проблеме?', 'Нажмите **Сообщить о проблеме или предложить идею** в разделе **Параметры › О программе** и опишите систему, свои действия и увиденные сообщения. Можно приложить файлы из папки журналов работы: в них только события и ошибки, никакого отсканированного содержимого.'], + ], + }, + + // ───────────────────────── Приложения ───────────────────────── + { h1: 'Сочетания и клавиши кратко', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['Где', 'Клавиша', 'Действие'], + rows: [ + ['Везде', '[[Ctrl+Alt+Q]]', 'Сканировать весь экран'], + ['Везде', '[[Ctrl+Alt+A]]', 'Выделить область'], + ['Везде', '[[Ctrl+Alt+W]]', 'Сканировать камерой'], + ['Везде', '[[Ctrl+Alt+E]]', 'Показать или скрыть плавающую панель'], + ['Режим сканирования, просмотр', '[[Enter]]', 'Открыть выбранный код'], + ['Режим сканирования, просмотр', '[[Tab]] / [[Shift+Tab]]', 'Выбрать следующий / предыдущий код'], + ['Режим сканирования, просмотр', '[[C]]', 'Скопировать выбранный код'], + ['Режим сканирования', '[[F]] или [[F5]]', 'Заново выполнить поиск по всему экрану'], + ['Режим сканирования, просмотр, генератор', '[[Esc]]', 'Закрыть'], + ], + }, + }, + { p: 'Глобальные сочетания клавиш меняются в разделе **Параметры › Сочетания клавиш**. В таблице указаны значения по умолчанию.' }, + { h1: 'Поддерживаемые коды', appendix: true }, + { + table: { + cols: [30, 70], + head: ['Группа', 'Форматы'], + rows: [ + ['Считываются всегда', 'QR Code, Micro QR Code, rMQR Code'], + ['С параметром «Также считывать штрихкоды»', 'EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, DataBar, Data Matrix, PDF417, Aztec и другие'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['Распознаваемое содержимое', 'Пример'], + rows: [ + ['Веб-ссылка', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:сеть;P:пароль;;`'], + ['Контакт', 'vCard (`BEGIN:VCARD`), MeCard (`MECARD:`)'], + ['Электронная почта', '`mailto:`, `MATMSG:`'], + ['Телефон и SMS', '`tel:`, `sms:`, `SMSTO:`'], + ['Местоположение', '`geo:25.0330,121.5654`'], + ['Ключ двухэтапной проверки', '`otpauth://`'], + ['Платёжный адрес', '`bitcoin:`, `ethereum:` и другие'], + ['Тайваньский электронный чек', 'Два QR-кода на чеке'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.zh-CN.js b/docs/manual/build/content.zh-CN.js new file mode 100644 index 0000000..3d2722a --- /dev/null +++ b/docs/manual/build/content.zh-CN.js @@ -0,0 +1,733 @@ +// QRcode tool 用户手册(简体中文)的正文。 +// 标记:**粗体**、[[按键]]、`代码`。图片名称对应 shots/<语言>/ 下的截图(见 figures.js)。 + +module.exports = { + lang: 'zh-CN', + font: 'Microsoft YaHei', + monoFont: 'Consolas', + file: 'QRcode-tool-User-Manual-zh-CN', + docTitle: 'QRcode tool 用户手册', + cover: { + title: 'QRcode tool', + subtitle: '用户手册', + tagline: '在电脑上扫二维码,像用手机一样简单。', + edition: '版本 1.0.0 | 2026 年 10 月', + platforms: '适用于 Windows 10(21H2 及以上)/ Windows 11、macOS 13 及以上、Linux', + }, + back: { + heading: '先扫描,再确认,然后打开。', + body: [ + 'QRcode tool 是一款免费、开源的桌面扫码工具。它可以读取屏幕、摄像头、剪贴板和图片文件中的二维码与条形码,并在打开任何链接之前检查网址中常见的欺骗手法。', + '所有处理都在你的电脑上完成。程序不收集使用数据,也不会把你扫描的内容发送到网络。', + ], + links: [ + ['项目主页', 'https://github.com/naritaroad/qrcode-tool'], + ['下载最新版本', 'https://github.com/naritaroad/qrcode-tool/releases/latest'], + ['反馈问题', 'https://github.com/naritaroad/qrcode-tool/issues'], + ], + license: '本软件以 MIT 或 Apache-2.0 许可证发布。本手册可按相同条款自由转载和修改。', + trademark: 'QR Code 是 DENSO WAVE INCORPORATED 的注册商标。QRcode tool 与 DENSO WAVE、Google 和 Microsoft 均无关联。', + }, + labels: { + toc: '目录', + chapter: (n) => `第 ${n} 章`, + appendix: (l) => `附录 ${l}`, + figure: (id) => `图 ${id}`, + tip: '提示', + note: '注意', + header: 'QRcode tool 用户手册', + tocHint: '(在 Word 中右键单击目录并选择“更新域”即可刷新页码。)', + }, + blocks: [ + // ───────────────────────── 1 ───────────────────────── + { h1: '认识 QRcode tool' }, + { p: 'QRcode tool 是一款常驻系统托盘的桌面小工具,用来读取屏幕上的二维码和条形码。按下快捷键后,屏幕会暂时冻结,屏幕上的每个码都会加上一个结果标签,显示其内容类型;如果是链接,还会显示真实的网站名称。按 [[Enter]] 或单击标签,即可打开链接、连接 Wi-Fi 或保存联系人。' }, + { p: '它还能读取对着摄像头的码、剪贴板中的图片和图片文件,并内置一个简单的二维码生成器。' }, + { h2: '主要功能' }, + { + table: { + cols: [26, 74], + head: ['功能', '说明'], + rows: [ + ['扫描整个屏幕', '冻结所有显示器的画面,自动找出每个码并加上标签。视频和游戏画面中的码也能读取。'], + ['选择区域', '拖动鼠标框选单个码。适用于太小、模糊或倾斜而无法自动识别的码。'], + ['摄像头', '把印刷的码或手机屏幕对准摄像头,识别后立即显示结果。'], + ['剪贴板与图片文件', '读取刚复制的截图,或 PNG、JPEG、BMP、GIF、WebP 图片文件。'], + ['理解内容', '识别网页链接、Wi-Fi、联系人、电子邮件、电话号码、短信、地图位置、两步验证密钥、付款地址和台湾电子发票,并提供对应的按钮。'], + ['链接安全检查', '打开链接前,检查是否为未加密连接、伪装地址、形近字母、IP 地址、短链接等常见手法。所有检查都离线完成。'], + ['生成二维码', '把文本或链接转换成二维码,可复制或保存为 PNG、SVG。'], + ['悬浮工具栏与悬浮球', '可停靠在屏幕顶部(横向)或左右边缘(纵向)的工具栏,还可以收起为一个小圆形悬浮球。'], + ['多种语言', '英文、繁体中文、简体中文、日文、韩文、西班牙文、葡萄牙文(巴西)、法文、德文和俄文。'], + ], + }, + }, + { h2: '系统要求' }, + { + table: { + cols: [30, 70], + head: ['操作系统', '要求与说明'], + rows: [ + ['Windows', 'Windows 10 21H2 及以上、Windows 11。支持 x64 和 ARM64。安装无需管理员权限。'], + ['macOS', 'macOS 13 及以上(Apple 芯片和 Intel)。首次扫描需要“屏幕录制”权限,使用摄像头扫描需要“相机”权限。'], + ['Linux', 'X11 下可使用全部功能。在 Wayland 下,需要在桌面设置中自行添加快捷键来启动扫描(见第 4 章)。'], + ['硬件', '普通办公电脑即可。摄像头为可选。程序空闲时内存占用约 30 MB 以内。'], + ], + }, + }, + { h2: '隐私与安全原则' }, + { + ul: [ + '解码和链接检查都在你的电脑上进行。扫描内容从不上传,也不会向任何网络服务查询地址的信誉。', + '唯一的网络连接是可选的自动检查更新,它只会询问 GitHub 是否有新版本。', + '扫描历史记录默认关闭。即使开启,Wi-Fi 密码和两步验证密钥也永远不会被保存。', + '只能打开 `http` 和 `https` 地址。其他类型的链接只能复制,绝不会交给系统处理。', + '带有警告的链接总是先显示详细信息,等待你确认。', + ], + }, + { h2: '本手册的约定' }, + { + ul: [ + '按钮、选项和窗口名称以**粗体**表示,例如**设置**或**扫描整个屏幕**。', + '按键以键帽表示,例如 [[Enter]] 或 [[Ctrl+Alt+Q]]。', + '**设置 › 常规**表示:打开**设置**窗口,在左侧选择**常规**页面。', + '本手册的截图以 Windows 11 为例。macOS 和 Linux 的操作方式相同,只是窗口边框和系统菜单的外观不同。', + ], + }, + + // ───────────────────────── 2 ───────────────────────── + { h1: '安装与首次启动' }, + { h2: '下载并安装(Windows)' }, + { + ol: [ + '打开 GitHub 上的发布页面(https://github.com/naritaroad/qrcode-tool/releases/latest)。', + '大多数电脑请下载 `QRcodeTool-win-x64-Setup.exe`;ARM 处理器的电脑请下载 `QRcodeTool-win-arm64-Setup.exe`。', + '运行下载的文件。QRcode tool 只安装到你的用户账户下,不需要管理员权限。', + '安装完成后,QRcode tool 会自动启动并显示欢迎界面。', + ], + }, + { tip: '如果不想安装,可以下载 `Portable.zip`,解压后直接运行程序。便携版无法自动更新。' }, + { h2: '如果 Windows 显示“Windows 已保护你的电脑”' }, + { p: '当前版本尚未进行代码签名,因此 Windows SmartScreen 可能会提示发布者未知。新发布、未签名的程序通常都会出现这种提示。' }, + { + ol: [ + '在提示中单击**更多信息**。', + '确认应用名称为 QRcode tool,然后单击**仍要运行**。', + ], + }, + { p: '要确认下载的文件未被篡改,可在 PowerShell 中运行以下命令,并将结果与发布页面上的 `SHA256SUMS` 文件进行比对:' }, + { code: 'Get-FileHash .\\QRcodeTool-win-x64-Setup.exe -Algorithm SHA256' }, + { h2: 'macOS 和 Linux' }, + { p: '**macOS:**下载并安装 `.pkg` 文件。目前版本尚未经过 Apple 公证,因此第一次请右键单击应用并选择**打开**。首次扫描时,请在**系统设置 › 隐私与安全性 › 屏幕录制**中允许 QRcode tool;如需使用摄像头,还要在**相机**中允许。' }, + { p: '**Linux:**下载 `.AppImage` 文件,添加执行权限后运行。GNOME 需要安装“AppIndicator and KStatusNotifierItem Support”扩展才能显示托盘图标。' }, + { h2: '欢迎界面' }, + { p: '首次启动时会显示欢迎界面。它列出三种最常用的扫描方式及其快捷键,并说明链接绝不会意外打开。' }, + { fig: 'welcome', cap: '首次启动时的欢迎界面', width: 11 }, + { + ul: [ + '**语言:**默认跟随操作系统。在这里更改后立即生效。', + '**开机自启动:**默认开启,让快捷键随时可用。可以在这里关闭,也可以稍后在**设置 › 常规**中关闭。', + '**立即试用:**关闭欢迎界面并扫描一次整个屏幕。', + '**关闭:**关闭欢迎界面并显示悬浮工具栏。', + ], + }, + { p: '要再次查看欢迎界面,请打开**设置 › 常规**并单击**再次显示欢迎界面**。' }, + { h2: '托盘图标' }, + { p: 'QRcode tool 没有传统意义上的主窗口。启动后,它的图标会出现在任务栏右端的系统托盘中,所有功能都可以从这里使用。' }, + { + ul: [ + '**单击图标:**立即扫描整个屏幕。', + '**右键单击:**打开菜单(图 2-2)。', + '**鼠标悬停在图标上:**显示当前的扫描快捷键。', + ], + }, + { fig: 'tray-menu', cap: '托盘图标菜单', width: 11 }, + { tip: 'Windows 可能会把新的托盘图标隐藏在“^”箭头后面。把图标拖到任务栏上即可让它一直显示。' }, + + // ───────────────────────── 3 ───────────────────────── + { h1: '扫描屏幕' }, + { h2: '扫描整个屏幕' }, + { + ol: [ + '确保含有二维码的网页、文档、视频或图片显示在屏幕上。', + '按 [[Ctrl+Alt+Q]]、单击托盘图标,或在悬浮工具栏上单击**扫描整个屏幕**。', + '屏幕冻结并变暗。经过短暂的扫描动画后,找到的每个码都会加上结果标签。', + '按 [[Enter]] 打开选中的码,或单击你想要的标签。', + '按 [[Esc]] 或右键单击即可退出扫描界面。', + ], + }, + { fig: 'scan-screen', cap: '扫描整个屏幕:每个码都有标签,第一个处于选中状态' }, + { p: '顶部的状态提示显示找到了多少个码。每个码周围括号的颜色表示检查结果:' }, + { + table: { + cols: [22, 78], + head: ['括号颜色', '含义'], + rows: [ + ['白色', '没有发现可疑之处。'], + ['强调色(蓝色)', '当前选中的码。按 [[Enter]] 即可打开。'], + ['黄色', '有需要注意的地方,例如未加密的 http 链接或短链接。原因显示在标签下方。'], + ['红色', '链接看起来具有欺骗性,例如伪装地址或混用多种字母的域名。'], + ], + }, + }, + { p: '由于屏幕是冻结的,视频、演示文稿和游戏中的码也能读取。连接多台显示器时,会同时扫描所有显示器。' }, + { h2: '选择区域' }, + { p: '当码很小、模糊或倾斜,或者屏幕上有很多码时,只框选你需要的那一个即可。选中的区域会先放大再读取,对于难以识别的码,效果比扫描整个屏幕更好。' }, + { + ol: [ + '按 [[Ctrl+Alt+A]],或在托盘菜单、悬浮工具栏中选择**选择区域**。', + '屏幕冻结,鼠标指针变为十字形。按住鼠标左键,拖出一个框住码的方框。', + '松开鼠标按钮。程序只读取方框内的内容。', + ], + }, + { fig: 'scan-region', cap: '选择区域:拖动时会显示方框的尺寸' }, + { tip: '方框可以比码稍大一些,四周留出空白更容易识别。如果出现“该区域没有码”,请把方框画大一点。' }, + { h2: '扫描界面上的工具栏' }, + { p: '扫描界面顶部有一排按钮,从左到右依次是:**扫描整个屏幕**、**选择区域**、**用摄像头扫描**、**扫描剪贴板中的图片**、**打开图片…**、**生成二维码…**、**历史记录**、**设置**和**关闭**。无需退出扫描界面即可切换扫描方式,例如从整个屏幕切换到选择区域。把鼠标悬停在按钮上可以查看说明和快捷键。' }, + { h2: '键盘操作' }, + { p: '扫描界面可以完全用键盘操作:' }, + { + table: { + cols: [30, 70], + head: ['按键', '操作'], + rows: [ + ['[[Enter]]', '打开选中的码。'], + ['[[Tab]]、[[→]]、[[↓]]', '选择下一个码。'], + ['[[Shift+Tab]]、[[←]]、[[↑]]', '选择上一个码。'], + ['[[C]]', '复制选中的码。'], + ['[[F]] 或 [[F5]]', '重新搜索整个屏幕。'], + ['[[Esc]]', '取消并退出扫描界面(也可以右键单击)。'], + ], + }, + }, + { h2: '找不到码时' }, + { + ul: [ + '使用**选择区域**,只框住码本身;框选的区域会先放大再读取。', + '如果码在视频中快速移动,请先暂停视频。', + '移开遮挡码的其他窗口、鼠标指针或其他物体。', + '如果要读取条形码或 Data Matrix 等格式,请确认**设置 › 扫描 › 同时识别条形码**已开启。', + '如果码在屏幕上非常小(宽度不足约 40 像素),请先放大网页或图片。', + ], + }, + + // ───────────────────────── 4 ───────────────────────── + { h1: '其他扫描方式' }, + { h2: '摄像头' }, + { p: '纸张、名片或另一部手机屏幕上的码,可以用摄像头扫描。' }, + { + ol: [ + '按 [[Ctrl+Alt+W]],或选择**用摄像头扫描**。', + '将码对准摄像头,距离约 15 至 30 厘米。', + '识别到码后,码的周围会出现括号,结果标签会显示在画面底部一个固定的列表中。', + '单击标签,或用 [[Tab]] 选中后按 [[Enter]]。', + ], + }, + { fig: 'camera', cap: '用摄像头扫描:结果固定显示在底部的列表中', width: 13 }, + { + ul: [ + '码需要在连续几帧画面中都被识别到才会列出,以避免误读。', + '码离开画面后,结果还会保留一段时间(默认 8 秒),方便你单击。可以在**设置 › 摄像头**中修改时长。', + '如果连接了多个摄像头,可以用窗口底部的列表切换。', + '**镜像**开关只改变画面的显示方式,不影响识别。', + '默认情况下,打开一个码后摄像头窗口会自动关闭。可以在**设置 › 摄像头**中更改。', + ], + }, + { note: '如果摄像头无法启动,请关闭可能正在使用摄像头的其他程序(例如视频通话),并在系统的隐私设置中允许 QRcode tool 使用摄像头。' }, + { h2: '剪贴板中的图片' }, + { + ol: [ + '用 [[Win+Shift+S]] 或其他截图工具截取码的画面,或从网页复制一张图片。', + '选择**扫描剪贴板中的图片**。', + '图片会显示在预览窗口中,找到的每个码都会加上结果标签。', + ], + }, + { p: '如果剪贴板中没有图片,程序会提示你先复制截图或图片。' }, + { h2: '图片文件' }, + { + ol: [ + '选择**打开图片…**。', + '选择一个 PNG、JPEG、BMP、GIF 或 WebP 文件。', + '在预览窗口中单击结果标签。底部的按钮可以打开另一张图片,或改为扫描剪贴板。', + ], + }, + { fig: 'image-preview', cap: '预览窗口:标签显示在图片中的码上', width: 13 }, + { h2: 'Windows 右键菜单' }, + { p: '在 Windows 上,QRcode tool 可以把主要功能添加到文件资源管理器的右键菜单(上下文菜单)中:右键单击桌面空白处即可扫描屏幕,右键单击图片即可扫描该文件,无需打开工具栏,也不必记住快捷键。' }, + { + figs: [ + ['shell-desktop', '右键单击桌面空白处'], + ['shell-image', '右键单击一张图片'], + ], + cap: '右键菜单中的 QRcode tool 项目(Windows 11,显示更多选项)', + }, + { h3: '开启或关闭右键菜单' }, + { p: '右键菜单默认**开启**:安装 QRcode tool 并启动一次后,菜单项就会出现。如果之前关闭了,可以这样重新开启:' }, + { + ol: [ + '从托盘菜单或悬浮工具栏打开**设置**。', + '在左侧选择**常规**。', + '开启**右键菜单**。更改立即生效,无需重启电脑或文件资源管理器。', + ], + }, + { p: '关闭同一个开关即可移除这些菜单项。它们保存在你自己的用户设置中(注册表的 HKEY_CURRENT_USER 部分),因此不需要管理员权限,也不会影响这台电脑上的其他账户。' }, + { h3: '打开菜单' }, + { + ul: [ + '**Windows 11:**右键单击后,选择底部的**显示更多选项**,QRcode tool 的菜单项在完整菜单中。要直接打开完整菜单,可以按住 [[Shift]] 再右键单击,或按 [[Shift+F10]]。', + '**Windows 10:**右键单击后即可看到 QRcode tool 的菜单项。', + ], + }, + { + table: { + cols: [36, 22, 42], + head: ['菜单项', '位置', '操作'], + rows: [ + ['QRcode tool 扫描屏幕', '桌面空白处', '扫描整个屏幕(同 [[Ctrl+Alt+Q]])。'], + ['QRcode tool 框选扫描', '桌面空白处', '冻结屏幕,以便选择区域(同 [[Ctrl+Alt+A]])。'], + ['QRcode tool 摄像头扫描', '桌面空白处', '打开摄像头(同 [[Ctrl+Alt+W]])。'], + ['QRcode tool 工具栏', '桌面空白处', '显示悬浮工具栏。'], + ['QRcode tool 打开图片', '图片文件', '在预览窗口中扫描该图片。支持 PNG、JPEG、BMP、GIF 和 WebP。'], + ], + }, + }, + { + ul: [ + '桌面上的四个菜单项集中在菜单底部,前后有分隔线,并带有 QRcode tool 图标。', + '只有选中**一张**图片时才会出现**QRcode tool 打开图片**,同时选中多个文件时不会出现。', + '菜单项使用 QRcode tool 的界面语言。更改**设置 › 常规 › 语言**后,菜单也会随之更新。', + '如果 QRcode tool 没有运行,选择菜单项会启动程序并执行该功能;如果已经在运行,则由正在运行的程序处理。', + '使用便携版时,菜单项指向程序当前所在的位置。移动便携版文件夹后,请启动一次程序以更新菜单项。', + '卸载 QRcode tool 会移除这些菜单项。macOS 和 Linux 没有右键菜单项,请改用快捷键或命令行。', + ], + }, + { tip: '如果菜单中没有 QRcode tool:请确认**设置 › 常规 › 右键菜单**已开启;在 Windows 11 上选择**显示更多选项**;如果刚安装或移动过程序,请先启动一次 QRcode tool。' }, + { h2: '命令行' }, + { p: '每个扫描功能都可以用命令启动。如果程序已经在运行,命令会交给正在运行的程序处理。这在使用 Wayland 的 Linux 上特别有用:在桌面的键盘设置中把这些命令绑定到自定义快捷键即可。' }, + { + table: { + cols: [42, 58], + head: ['命令', '操作'], + rows: [ + ['`qrcode-tool`', '启动程序;如果已在运行,则显示悬浮工具栏。'], + ['`qrcode-tool scan-screen`', '扫描整个屏幕。'], + ['`qrcode-tool scan-region`', '冻结屏幕并选择区域。'], + ['`qrcode-tool scan-camera`', '用摄像头扫描。'], + ['`qrcode-tool scan-clipboard`', '扫描剪贴板中的图片。'], + ['`qrcode-tool scan-file 文件`', '在预览窗口中扫描一个图片文件。'], + ['`qrcode-tool toolbar`', '显示或隐藏悬浮工具栏。'], + ['`qrcode-tool bubble`', '显示或隐藏悬浮球。'], + ['`qrcode-tool generate "文本"`', '打开二维码生成器并填入文本。'], + ['`qrcode-tool settings`', '打开设置。'], + ['`qrcode-tool decode 文件… [--json]`', '不启动界面,直接在终端输出图片文件中的码。'], + ['`qrcode-tool quit`', '退出正在运行的程序。'], + ], + }, + }, + + // ───────────────────────── 5 ───────────────────────── + { h1: '扫描结果与详细信息' }, + { h2: '结果标签' }, + { p: '找到的每个码都会有一个深色的结果标签,从左到右依次显示:' }, + { + ul: [ + '**图标:**内容类型,例如链接显示地球,Wi-Fi 显示信号图标,联系人显示人像。带有警告的链接会改为显示警告或危险标志。', + '**主文本:**链接显示真实的网站名称而不是完整地址;Wi-Fi 显示网络名称;联系人显示姓名。', + '**第二行:**内容类型,或警告的主要原因。', + '**› 按钮:**无论什么内容,都会打开详细信息卡。', + ], + }, + { h2: '按 Enter 或单击后会发生什么' }, + { + table: { + cols: [36, 64], + head: ['内容', '操作'], + rows: [ + ['没有警告的链接', '用默认浏览器打开。'], + ['带有警告的链接', '先显示详细信息卡,你确认后才会打开链接。'], + ['其他所有内容', '显示详细信息卡,由你选择要执行的操作。'], + ], + }, + }, + { h2: '详细信息卡' }, + { p: '详细信息卡列出码中的每个字段,并提供与内容相应的按钮。字段旁边的复制按钮只复制该字段。密码等敏感字段显示为“••••”,单击锁形按钮可暂时显示。单击卡片外部或单击**关闭**即可返回扫描结果。' }, + { fig: 'detail-wifi', cap: 'Wi-Fi 码的详细信息卡:单击“连接”即可加入网络', width: 12 }, + { h2: '各类内容的按钮' }, + { + table: { + cols: [30, 70], + head: ['类型', '按钮'], + rows: [ + ['链接', '**打开**、**复制**。对于没有警告且尚未信任的网站,还会提供**始终允许此网站**。'], + ['Wi-Fi 网络', '**连接**(由系统创建网络配置文件)、**复制密码**。'], + ['联系人(vCard、MeCard)', '**保存联系人**(保存为 .vcf 文件,可导入通讯录)、**复制**。'], + ['电子邮件', '**写邮件**(打开默认邮件程序)、**复制**。'], + ['电话号码', '**拨打**(交给系统的通话应用)、**复制**。'], + ['短信', '**发送短信**、**复制**。'], + ['位置', '**打开地图**、**复制**。'], + ['两步验证密钥', '只显示服务名称和账户,可以**复制**。密钥本身永远不会显示或保存。'], + ['付款地址', '**复制**。转账前务必再次核对付款地址。'], + ['电子发票', '**复制发票号码**、**复制**。'], + ['已拦截的链接', '`http` 和 `https` 以外的链接(例如 `file:` 或 `javascript:`)只能复制,永远不会打开。'], + ['文本和条形码', '**复制**。条形码还会显示格式,例如 EAN-13。'], + ], + }, + }, + { h2: '台湾电子发票' }, + { p: '台湾电子发票上有左右并排的两个二维码。左边的码包含发票号码、日期、金额和部分品项;右边的码包含其余品项。当**扫描整个屏幕**或**打开图片…**同时找到两个码时,它们会被合并为一张发票,详细信息卡会列出发票号码、日期、随机码、总计、税额、卖方和买方统一编号以及所有品项。如果只找到左边的码,卡片会提醒你同时扫描右边的码。' }, + { h2: '敏感数据' }, + { p: '两步验证密钥和 Wi-Fi 密码属于敏感数据。即使开启了扫描历史记录或**自动复制结果**,它们也永远不会写入历史记录、不会被自动复制,也不会写入程序的日志文件。' }, + + // ───────────────────────── 6 ───────────────────────── + { h1: '链接安全' }, + { p: '恶意二维码常常会把人引向虚假网站。QRcode tool 在显示结果之前,会在你的电脑上分析每个网址,并把发现的问题直接标注在结果标签和详细信息卡上。不会在线查询任何内容,也不会把任何地址发送给任何服务。' }, + { h2: '打开前先核对网站名称' }, + { p: '结果标签显示地址中真实的网站名称。打开任何链接之前,请确认这就是你要访问的网站。带有警告的链接会先显示详细信息卡,顶部有彩色提示,说明需要注意什么。' }, + { fig: 'detail-warning', cap: '带有警告的链接:未加密的短链接会显示原因并等待你确认', width: 12 }, + { h2: '警告级别' }, + { + table: { + cols: [18, 82], + head: ['级别', '程序的处理方式'], + rows: [ + ['信息', '例如地址很长。只在详细信息卡中列出;按 [[Enter]] 会直接打开链接。'], + ['警告', '黄色括号和图标。按 [[Enter]] 或单击会先显示详细信息卡,然后由你单击**打开**。'], + ['危险', '红色括号和图标。**打开**不再是默认按钮,单击后还必须用**仍然打开**再确认一次。'], + ], + }, + }, + { h2: '检查项目' }, + { + table: { + cols: [30, 12, 58], + head: ['显示的信息', '级别', '说明与建议'], + rows: [ + ['未加密 (http)', '警告', '连接未加密,数据在传输途中可能被读取或篡改。不要在这类网页上输入密码或付款信息。'], + ['伪装的地址', '危险', '一个看似可信的名称放在“@”之前,但链接实际指向“@”后面的网站,例如 `https://bank.example.com@login-check.example.net/`。'], + ['国际化域名', '警告', '域名中包含非拉丁字母。卡片还会显示编码后的真实地址(以 `xn--` 开头),方便你核对。'], + ['形近字母', '危险', '域名的某一部分混用了不同字母表,例如用西里尔字母“а”代替拉丁字母“a”。这是虚假网站的常用手法。'], + ['使用 IP 地址', '警告', '地址用数字代替网站名称,一般网站很少这样做。'], + ['不常见的端口', '警告', '地址指定了非标准的端口号。'], + ['短链接', '警告', 'bit.ly 等服务会隐藏真实目标。程序不会在线展开短链接,因为那样会让该服务知道你扫描了什么。只打开来源可信的短链接。'], + ['地址过长', '信息', '很长的地址可能会把真实的网站名称挤出视野。'], + ['包含大量编码字符', '信息', '大量“%”转义字符可能被用来隐藏地址的真实内容。'], + ['子域名异常多', '信息', '例如 `login.bank.example.com.secure-check.example.net`,乍一看像银行的网站。'], + ], + }, + }, + { h2: '具有欺骗性的链接' }, + { p: '对于评为**危险**的链接,详细信息卡会用红字说明该链接看起来具有欺骗性,并列出原因。请以卡片上显示的真实网站名称为准,而不是码旁边印刷的文字。' }, + { fig: 'detail-danger', cap: '伪装的地址:看起来像银行,实际指向 login-check.example.net', width: 12 }, + { p: '如果确定要继续,请单击**打开**。卡片会再询问一次,只有单击**仍然打开**才会真正打开网页。' }, + { h2: '受信任的网站与自动打开' }, + { p: '你可以把常用的网站(例如学校或公司的域名)加入受信任的网站。满足以下所有条件时,链接会在扫描后直接打开,无需等待你按 [[Enter]]:' }, + { + ul: [ + '只找到一个码。', + '链接没有任何警告。', + '该网站(或其子域名)在受信任列表中。', + '**设置 › 扫描 › 直接打开受信任的网站**已开启(默认开启)。', + ], + }, + { p: '可以在没有警告的链接的详细信息卡上单击**始终允许此网站**来添加网站,也可以在**设置 › 扫描**中输入域名。' }, + { fig: 'detail-link', cap: '没有警告的链接:可以直接打开,或把网站加入受信任列表', width: 12 }, + + // ───────────────────────── 7 ───────────────────────── + { h1: '悬浮工具栏与悬浮球' }, + { p: '悬浮工具栏始终显示在其他窗口上方,所有功能一键可达。它永远不会出现在扫描用的截图中。可以用托盘菜单中的**悬浮工具栏**、快捷键 [[Ctrl+Alt+E]] 或命令 `qrcode-tool toolbar` 来显示或隐藏它。' }, + { h2: '工具栏按钮' }, + { fig: 'toolbar-row', cap: '横向工具栏:鼠标悬停在按钮上时,下方会显示其名称和快捷键', width: 11 }, + { + table: { + cols: [34, 66], + head: ['按钮', '操作'], + rows: [ + ['(开头的点状拖动柄)', '按住并拖动即可移动工具栏。'], + ['扫描整个屏幕', '同 [[Ctrl+Alt+Q]]。'], + ['选择区域', '同 [[Ctrl+Alt+A]]。'], + ['用摄像头扫描', '同 [[Ctrl+Alt+W]]。找不到摄像头时显示为灰色。'], + ['扫描剪贴板中的图片', '读取剪贴板中的图片。'], + ['打开图片…', '选择一个图片文件并扫描。'], + ['生成二维码…', '打开二维码生成器。'], + ['历史记录', '打开**设置 › 隐私与历史记录**。'], + ['设置', '打开设置。'], + ['用户手册(“?”按钮)', '在浏览器的新标签页中打开 GitHub 上的 PDF 用户手册,语言与界面一致。'], + ['收起为悬浮球', '隐藏工具栏,改为显示小圆形悬浮球。'], + ['关闭工具栏', '隐藏工具栏(不显示悬浮球)。程序仍在托盘中运行。'], + ], + }, + }, + { h2: '纵向工具栏(右侧或左侧)' }, + { p: '除了默认位于屏幕顶部的横向布局外,工具栏也可以是位于屏幕右侧或左侧边缘的纵向一列。纵向布局占用的宽度更小,适合宽屏,也不会遮挡网页顶部。' }, + { + figs: [ + ['toolbar-right', '纵向,位于右侧(纵向的默认位置)'], + ['toolbar-left', '纵向,位于左侧'], + ], + cap: '纵向工具栏:鼠标悬停的按钮名称和快捷键显示在按钮下方', + }, + { p: '更改布局的方法:' }, + { + ol: [ + '打开**设置**并选择**常规**。', + '在**悬浮工具栏和悬浮球**部分找到**工具栏布局**。', + '选择**横向,位于顶部**、**纵向,位于右侧**或**纵向,位于左侧**。', + ], + }, + { p: '更改立即生效。工具栏会移到新布局的默认位置:横向布局位于顶部居中,纵向布局位于所选边缘的垂直居中处。之后仍然可以把它拖到任意位置。' }, + { h2: '移动工具栏' }, + { p: '按住工具栏一端的点状拖动柄并拖动即可。程序会记住最后的位置,下次在同一位置显示。如果该位置已不在任何显示器上(例如拔掉了外接显示器),工具栏会回到默认位置。' }, + { h2: '悬浮球' }, + { p: '悬浮球是收起后的工具栏,只占一个小圆形,默认显示在屏幕右侧边缘。' }, + { fig: 'bubble', cap: '悬浮球', width: 8 }, + { + table: { + cols: [30, 70], + head: ['操作', '结果'], + rows: [ + ['单击', '展开为完整的悬浮工具栏。'], + ['按住约半秒', '扫描整个屏幕。'], + ['右键单击', '打开菜单:**扫描整个屏幕**、**选择区域**、**用摄像头扫描**、**扫描剪贴板中的图片**、**显示工具栏**、**隐藏悬浮球**。'], + ['拖动', '移动悬浮球。'], + ], + }, + }, + { p: '如果希望每次启动程序时都显示悬浮球,请开启**设置 › 常规 › 启动应用时显示悬浮球**。工具栏和悬浮球不会同时显示。' }, + { h2: '全屏应用时隐藏' }, + { p: '在 Windows 上,观看全屏视频、放映演示文稿或玩游戏时,工具栏和悬浮球会自动隐藏,退出全屏后再重新出现。可以在**设置 › 常规 › 全屏应用时隐藏**中关闭此功能。' }, + + // ───────────────────────── 8 ───────────────────────── + { h1: '生成二维码' }, + { p: '二维码生成器可以把链接或一段文本转换成二维码,用手机扫描,或放进文档和演示文稿中。' }, + { + ol: [ + '从托盘菜单、悬浮工具栏或扫描界面选择**生成二维码…**。', + '在**文本或链接**中输入或粘贴内容。二维码会立即显示在右侧。', + '如有需要,选择**容错级别**。', + '单击**复制图片**把二维码复制到剪贴板,或单击**保存 PNG…**、**保存 SVG…**保存为文件。', + ], + }, + { fig: 'generator', cap: '二维码生成器', width: 13 }, + { h2: '容错级别' }, + { p: '级别越高,即使码的一部分损坏或被 Logo 遮住也能读取,但码会更密集、更大。' }, + { + table: { + cols: [36, 64], + head: ['级别', '适用场合'], + rows: [ + ['低 — 二维码最小', '内容很多,且只在屏幕上显示。'], + ['中 — 推荐', '一般用途的默认值。'], + ['较高', '印在容易磨损的物品上的码。'], + ['高 — 可承受污损或加 Logo', '要在码的中间放 Logo,或需要最高的可靠性。'], + ], + }, + }, + { note: '一个二维码能容纳的内容有限。如果出现“内容太多,一个二维码放不下”,请缩短内容或选择较低的容错级别。' }, + { p: '**PNG** 适合放进文档和幻灯片;**SVG** 是矢量格式,放大印刷也很清晰。按 [[Esc]] 即可关闭生成器。' }, + + // ───────────────────────── 9 ───────────────────────── + { h1: '设置' }, + { p: '从托盘菜单、悬浮工具栏或扫描界面选择**设置**。所有更改都会立即保存并生效,没有“确定”按钮。' }, + { h2: '常规' }, + { fig: 'settings-general', cap: '设置 › 常规', width: 14 }, + { + table: { + cols: [34, 66], + head: ['设置项', '说明'], + rows: [ + ['语言', '菜单和消息的语言。默认跟随操作系统。'], + ['主题', '**跟随系统设置**、**浅色**或**深色**。系统强调色会自动套用。'], + ['开机自启动', '登录时在后台静默启动,让快捷键随时可用。'], + ['右键菜单', '(仅 Windows)在桌面和图片文件的右键菜单中添加 QRcode tool 项目。默认开启;见第 4 章“Windows 右键菜单”。'], + ['工具栏布局', '**横向,位于顶部**、**纵向,位于右侧**或**纵向,位于左侧**。见第 7 章。'], + ['启动应用时显示悬浮球', '启动时显示悬浮球。'], + ['全屏应用时隐藏', '(仅 Windows)在全屏视频、演示文稿和游戏期间隐藏工具栏和悬浮球。'], + ['自动检查更新', '每天询问一次 GitHub 是否有新版本。未经你同意不会安装任何内容。'], + ['再次显示欢迎界面', '打开首次运行时的欢迎界面。'], + ], + }, + }, + { h2: '扫描' }, + { fig: 'settings-scanning', cap: '设置 › 扫描', width: 14 }, + { + table: { + cols: [34, 66], + head: ['设置项', '说明'], + rows: [ + ['自动复制结果', '只找到一个码时,把其内容放到剪贴板。敏感内容永远不会被复制。默认关闭。'], + ['找到码时播放提示音', '播放一个简短的提示音。默认关闭。'], + ['同时识别条形码', '除二维码外,还读取 EAN、UPC、Code 128、Data Matrix、PDF417、Aztec 等格式。默认开启。'], + ['直接打开受信任的网站', '在第 6 章列出的条件下自动打开受信任网站的链接。'], + ['受信任的网站', '输入域名(例如 example.com)并单击**添加**。其子域名也会被信任。单击垃圾桶图标可删除条目。'], + ], + }, + }, + { h2: '摄像头' }, + { fig: 'settings-camera', cap: '设置 › 摄像头', width: 14 }, + { + table: { + cols: [34, 66], + head: ['设置项', '说明'], + rows: [ + ['摄像头', '要使用的摄像头。'], + ['镜像画面', '像照镜子一样显示摄像头画面。不影响识别。'], + ['结果保留秒数', '码离开画面后结果继续保留的时间(0 到 60 秒)。设为 0 时,只列出当前画面中的码。'], + ['打开码后关闭摄像头', '打开或使用一个码后关闭摄像头窗口。'], + ], + }, + }, + { h2: '快捷键' }, + { fig: 'settings-shortcuts', cap: '设置 › 快捷键', width: 14 }, + { + table: { + cols: [34, 22, 44], + head: ['操作', '默认', '说明'], + rows: [ + ['扫描整个屏幕', '[[Ctrl+Alt+Q]]', '冻结并扫描所有显示器。'], + ['选择区域', '[[Ctrl+Alt+A]]', '冻结屏幕,以便拖出方框。'], + ['用摄像头扫描', '[[Ctrl+Alt+W]]', '打开摄像头窗口。'], + ['显示或隐藏工具栏', '[[Ctrl+Alt+E]]', '切换悬浮工具栏。'], + ], + }, + }, + { p: '更改快捷键的方法:' }, + { + ol: [ + '单击要更改的快捷键。按钮会显示**请按键…(Esc 取消)**。', + '按下新的组合键。其中至少要包含 [[Ctrl]]、[[Alt]]、[[Shift]] 或 [[Win]](Mac 上为 [[Cmd]])之一。', + '新的快捷键立即生效。', + ], + }, + { p: '如果该组合键已被其他应用使用,该行会显示“已被其他应用占用 — 请换一个。”,请改用其他组合键。**恢复默认**会恢复所有默认快捷键。底部的**扫描时**部分列出扫描界面的按键,与第 3 章相同。' }, + { h2: '隐私与历史记录' }, + { fig: 'settings-privacy', cap: '设置 › 隐私与历史记录(已开启历史记录)', width: 14 }, + { + table: { + cols: [34, 66], + head: ['设置项', '说明'], + rows: [ + ['保留扫描历史记录', '只保存在这台电脑上。Wi-Fi 密码和两步验证密钥永远不会被保存。默认关闭。'], + ['保留条数', '5 到 500 条。最旧的条目会最先被删除。'], + ['最近扫描', '最新的排在最前。没有警告的链接可以用**打开**再次打开;每个条目都可以用**复制**复制。'], + ['清除历史记录', '删除全部历史记录。'], + ], + }, + }, + { h2: '关于' }, + { fig: 'settings-about', cap: '设置 › 关于', width: 14 }, + { + ul: [ + '显示当前版本。**检查更新**会立即检查。', + '提供源代码、问题反馈、隐私声明和开源许可证的链接。', + '**打开设置文件夹**和**打开日志文件夹**会直接打开相应文件夹,方便备份设置或在反馈问题时附上日志文件。', + ], + }, + + // ───────────────────────── 10 ───────────────────────── + { h1: '更新与卸载' }, + { h2: '检查并安装更新' }, + { p: '通过安装程序安装的版本可以自动更新。开启**自动检查更新**后,程序每天询问一次 GitHub。你也可以随时在托盘菜单或**设置 › 关于**中单击**检查更新**。' }, + { fig: 'message-update', cap: '有新版本时显示的提示', width: 10 }, + { + ol: [ + '出现**有可用更新**提示时,单击**立即更新**。', + '新版本会在后台下载,完成后程序自动重启。', + '如果暂时不想更新,请单击**稍后**。', + ], + }, + { p: '只有在你单击**立即更新**之后才会安装更新;程序绝不会自行安装任何内容。' }, + { h2: '便携版' }, + { p: '便携版(`Portable.zip`)不会自动更新;检查更新时会显示“无法使用更新”。请从 GitHub 发布页面下载新版本并替换旧文件,你的设置会保留。' }, + { h2: '卸载' }, + { + ol: [ + '打开 Windows 的**设置 › 应用 › 安装的应用**。', + '找到 QRcode tool,单击**…**并选择**卸载**。', + '开机启动项和右键菜单项也会一并移除。', + ], + }, + { p: '如果还想删除设置和历史记录,请在卸载前从**设置 › 关于**打开设置文件夹和日志文件夹,并将其删除。' }, + { h2: '设置和日志的存储位置' }, + { + table: { + cols: [18, 82], + head: ['系统', '位置'], + rows: [ + ['Windows', '设置:`%APPDATA%\\Lrniey666\\qrcode-tool\\config`\n历史记录和日志:`%LOCALAPPDATA%\\Lrniey666\\qrcode-tool\\data`'], + ['macOS', '`~/Library/Application Support/io.github.Lrniey666.qrcode-tool`'], + ['Linux', '设置:`~/.config/qrcode-tool`\n历史记录和日志:`~/.local/share/qrcode-tool`'], + ], + }, + }, + { p: '设置文件 `settings.toml` 是纯文本文件。把它复制到另一台电脑即可迁移设置。' }, + + // ───────────────────────── 11 ───────────────────────── + { h1: '故障排除' }, + { + qa: [ + ['按快捷键没有反应。', '可能有其他应用已经占用了该快捷键。打开**设置 › 快捷键**,如果该行显示“已被其他应用占用”,请换一个组合键。某些游戏和远程桌面程序在前台运行时会截获所有按键。'], + ['扫描找不到码。', '使用**选择区域**只框住码本身,或先放大网页或图片。参见第 3 章“找不到码时”。'], + ['为什么链接没有立即打开?', '带有警告的链接总是先显示详细信息,让你核对真实的网站。只有没有任何警告的受信任网站链接才会自动打开,而且只在它是唯一找到的码时。'], + ['显示“短链接 — 真实目标被隐藏”。', '短链接服务会隐藏真实目标。程序不会在线查询,因为那样会泄露你扫描的内容。只打开来源可信的短链接。'], + ['主窗口在哪里?', '程序特意没有主窗口。请使用托盘图标、快捷键、悬浮工具栏或悬浮球。'], + ['右键菜单中没有 QRcode tool。', '请确认**设置 › 常规 › 右键菜单**已开启。在 Windows 11 上,菜单项位于**显示更多选项**中(也可以按住 [[Shift]] 再右键单击)。**QRcode tool 打开图片**只在选中一张图片时出现。如果刚安装 QRcode tool 或移动过便携版,请先启动一次。'], + ['工具栏不见了。', '按 [[Ctrl+Alt+E]],或在托盘菜单中勾选**悬浮工具栏**。开启**全屏应用时隐藏**后,全屏程序在前台时工具栏会被隐藏。'], + ['摄像头无法启动。', '关闭正在使用摄像头的其他程序,并检查系统的隐私设置是否允许 QRcode tool 使用摄像头。如果有多个摄像头,请在**设置 › 摄像头**中选择正确的一个。'], + ['Wi-Fi 没有自动连接。', '某些网络(例如企业认证网络)无法由程序配置。请在详细信息卡上单击**复制密码**,然后从系统的 Wi-Fi 菜单连接。'], + ['杀毒软件发出警告。', '注册快捷键、读取屏幕并开机自启动的新的未签名程序,有时会被基于行为的检测标记。QRcode tool 使用标准的系统接口,源代码完全公开。请向杀毒软件厂商报告误报,或在 GitHub 上提交 issue。'], + ['在 macOS 上截图是黑色的。', '请在**系统设置 › 隐私与安全性 › 屏幕录制**中允许 QRcode tool,然后重新启动程序。系统更新后 macOS 可能会再次询问。'], + ['在使用 Wayland 的 Linux 上快捷键没有反应。', 'Wayland 不允许程序注册全局快捷键。请在桌面的键盘设置中添加一个自定义快捷键,运行 `qrcode-tool scan-screen` 或其他命令。'], + ['如何再次打开本手册?', '单击悬浮工具栏上的 **?** 按钮(**用户手册**),浏览器会在新标签页中打开 GitHub 上的 PDF 版本。Word 和 PDF 文件也都在 GitHub 仓库的 `docs/manual` 文件夹中。'], + ['如何反馈问题?', '在**设置 › 关于**中单击**报告问题或提出建议**,描述你的系统、操作步骤和看到的提示信息。可以附上日志文件夹中的文件;日志只记录事件和错误,绝不包含扫描内容。'], + ], + }, + + // ───────────────────────── 附录 ───────────────────────── + { h1: '快捷键与按键一览', appendix: true }, + { + table: { + cols: [30, 26, 44], + head: ['使用场合', '按键', '操作'], + rows: [ + ['任何地方', '[[Ctrl+Alt+Q]]', '扫描整个屏幕'], + ['任何地方', '[[Ctrl+Alt+A]]', '选择区域'], + ['任何地方', '[[Ctrl+Alt+W]]', '用摄像头扫描'], + ['任何地方', '[[Ctrl+Alt+E]]', '显示或隐藏悬浮工具栏'], + ['扫描界面、预览', '[[Enter]]', '打开选中的码'], + ['扫描界面、预览', '[[Tab]] / [[Shift+Tab]]', '选择下一个 / 上一个码'], + ['扫描界面、预览', '[[C]]', '复制选中的码'], + ['扫描界面', '[[F]] 或 [[F5]]', '重新搜索整个屏幕'], + ['扫描界面、预览、生成器', '[[Esc]]', '关闭'], + ], + }, + }, + { p: '全局快捷键可以在**设置 › 快捷键**中更改。上表列出的是默认值。' }, + { h1: '支持的码', appendix: true }, + { + table: { + cols: [30, 70], + head: ['类别', '格式'], + rows: [ + ['始终读取', 'QR Code、Micro QR Code、rMQR Code'], + ['开启“同时识别条形码”时', 'EAN-13、EAN-8、UPC-A、UPC-E、Code 128、Code 39、Code 93、Codabar、ITF、DataBar、Data Matrix、PDF417、Aztec 等'], + ], + }, + }, + { + table: { + cols: [30, 70], + head: ['可识别的内容', '示例'], + rows: [ + ['网页链接', '`https://example.com/`'], + ['Wi-Fi', '`WIFI:T:WPA;S:网络名称;P:密码;;`'], + ['联系人', 'vCard(`BEGIN:VCARD`)、MeCard(`MECARD:`)'], + ['电子邮件', '`mailto:`、`MATMSG:`'], + ['电话和短信', '`tel:`、`sms:`、`SMSTO:`'], + ['位置', '`geo:25.0330,121.5654`'], + ['两步验证密钥', '`otpauth://`'], + ['付款地址', '`bitcoin:`、`ethereum:` 等'], + ['台湾电子发票', '发票上的两个二维码'], + ], + }, + }, + ], +}; diff --git a/docs/manual/build/content.zh-TW.js b/docs/manual/build/content.zh-TW.js index 9e92be6..9fb32cd 100644 --- a/docs/manual/build/content.zh-TW.js +++ b/docs/manual/build/content.zh-TW.js @@ -450,7 +450,7 @@ module.exports = { ['建立 QR Code…', '開啟 QR Code 產生器。'], ['掃描記錄', '開啟「設定 › 隱私權與記錄」頁面。'], ['設定', '開啟設定視窗。'], - ['使用說明書(「?」按鈕)', '在瀏覽器的新分頁中開啟 GitHub 上的 PDF 使用說明書。介面為中文時開啟繁體中文版,其他語言開啟英文版。'], + ['使用說明書(「?」按鈕)', '在瀏覽器的新分頁中開啟 GitHub 上的 PDF 使用說明書,語言與介面相同。'], ['收合成泡泡', '隱藏工具列,改為顯示小圓形泡泡。'], ['關閉工具列', '隱藏工具列(不會改為顯示泡泡)。程式仍在系統匣中執行。'], ], diff --git a/docs/manual/build/docscenes/scenes.slint b/docs/manual/build/docscenes/scenes.slint index 15f6cbc..bc802c4 100644 --- a/docs/manual/build/docscenes/scenes.slint +++ b/docs/manual/build/docscenes/scenes.slint @@ -565,7 +565,8 @@ component ShellSep inherits Rectangle { } component ShellMenu inherits Rectangle { - width: 300px; + // Wide enough for the longest Explorer entries (Russian, Portuguese). + width: 360px; height: list.preferred-height; background: #f9f9f9; border-radius: 8px; diff --git a/docs/manual/build/docscenes/strings.de.json b/docs/manual/build/docscenes/strings.de.json new file mode 100644 index 0000000..45bf258 --- /dev/null +++ b/docs/manual/build/docscenes/strings.de.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "Herbstseminar Informationstechnik 2026", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "Samstag, 14. November · Großer Saal, 3. Stock · Eintritt frei", + "Register online": "Online anmelden", + "Scan to fill in the sign-up form.": "Scannen und das Anmeldeformular ausfüllen.", + "Venue Wi-Fi": "WLAN im Saal", + "Join the guest network in the hall.": "Mit dem Gästenetz im Saal verbinden.", + "Contact the organizer": "Kontakt zum Veranstalter", + "Save the organizer's details to your contacts.": "Die Daten des Veranstalters in den Kontakten speichern.", + "Sponsor offer": "Angebot eines Sponsors", + "A coupon link from an outside advertiser.": "Ein Gutschein-Link eines externen Werbepartners.", + "Recycle Bin": "Papierkorb", + "Documents": "Dokumente", + "View": "Ansicht", + "Sort by": "Sortieren nach", + "Refresh": "Aktualisieren", + "New": "Neu", + "Display settings": "Anzeigeeinstellungen", + "Personalize": "Anpassen", + "Open": "Öffnen", + "Edit": "Bearbeiten", + "Print": "Drucken", + "Set as desktop background": "Als Desktophintergrund festlegen", + "Open with": "Öffnen mit", + "Copy as path": "Als Pfad kopieren", + "Cut": "Ausschneiden", + "Copy": "Kopieren", + "Delete": "Löschen", + "Rename": "Umbenennen", + "Properties": "Eigenschaften" +} diff --git a/docs/manual/build/docscenes/strings.es.json b/docs/manual/build/docscenes/strings.es.json new file mode 100644 index 0000000..ce8991d --- /dev/null +++ b/docs/manual/build/docscenes/strings.es.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "Seminario de Tecnología de Otoño 2026", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "Sábado 14 de noviembre · Salón principal, 3.ª planta · Entrada gratuita", + "Register online": "Inscríbete en línea", + "Scan to fill in the sign-up form.": "Escanea el código para rellenar el formulario.", + "Venue Wi-Fi": "Wi-Fi del recinto", + "Join the guest network in the hall.": "Conéctate a la red de invitados del salón.", + "Contact the organizer": "Contacta con la organización", + "Save the organizer's details to your contacts.": "Guarda los datos de la organización en tus contactos.", + "Sponsor offer": "Oferta del patrocinador", + "A coupon link from an outside advertiser.": "Un enlace a un cupón de un anunciante externo.", + "Recycle Bin": "Papelera de reciclaje", + "Documents": "Documentos", + "View": "Ver", + "Sort by": "Ordenar por", + "Refresh": "Actualizar", + "New": "Nuevo", + "Display settings": "Configuración de pantalla", + "Personalize": "Personalizar", + "Open": "Abrir", + "Edit": "Editar", + "Print": "Imprimir", + "Set as desktop background": "Establecer como fondo de escritorio", + "Open with": "Abrir con", + "Copy as path": "Copiar como ruta de acceso", + "Cut": "Cortar", + "Copy": "Copiar", + "Delete": "Eliminar", + "Rename": "Cambiar nombre", + "Properties": "Propiedades" +} diff --git a/docs/manual/build/docscenes/strings.fr.json b/docs/manual/build/docscenes/strings.fr.json new file mode 100644 index 0000000..1c559a8 --- /dev/null +++ b/docs/manual/build/docscenes/strings.fr.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "Séminaire d’automne sur les technologies 2026", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "Samedi 14 novembre · Grande salle, 3ᵉ étage · Entrée libre", + "Register online": "Inscription en ligne", + "Scan to fill in the sign-up form.": "Scannez pour remplir le formulaire d’inscription.", + "Venue Wi-Fi": "Wi-Fi de la salle", + "Join the guest network in the hall.": "Rejoignez le réseau invités de la salle.", + "Contact the organizer": "Contacter l’organisateur", + "Save the organizer's details to your contacts.": "Enregistrez les coordonnées de l’organisateur dans vos contacts.", + "Sponsor offer": "Offre du sponsor", + "A coupon link from an outside advertiser.": "Un lien vers un bon de réduction d’un annonceur externe.", + "Recycle Bin": "Corbeille", + "Documents": "Documents", + "View": "Affichage", + "Sort by": "Trier par", + "Refresh": "Actualiser", + "New": "Nouveau", + "Display settings": "Paramètres d’affichage", + "Personalize": "Personnaliser", + "Open": "Ouvrir", + "Edit": "Modifier", + "Print": "Imprimer", + "Set as desktop background": "Choisir comme arrière-plan du Bureau", + "Open with": "Ouvrir avec", + "Copy as path": "Copier en tant que chemin d’accès", + "Cut": "Couper", + "Copy": "Copier", + "Delete": "Supprimer", + "Rename": "Renommer", + "Properties": "Propriétés" +} diff --git a/docs/manual/build/docscenes/strings.ja.json b/docs/manual/build/docscenes/strings.ja.json new file mode 100644 index 0000000..2ca8adb --- /dev/null +++ b/docs/manual/build/docscenes/strings.ja.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "2026 秋の情報技術セミナー", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "11 月 14 日(土)· 3 階 大講堂 · 入場無料", + "Register online": "オンライン申し込み", + "Scan to fill in the sign-up form.": "スキャンして申込フォームに記入してください。", + "Venue Wi-Fi": "会場の Wi-Fi", + "Join the guest network in the hall.": "会場のゲスト用ネットワークに接続できます。", + "Contact the organizer": "主催者への連絡", + "Save the organizer's details to your contacts.": "主催者の連絡先をアドレス帳に保存できます。", + "Sponsor offer": "スポンサー特典", + "A coupon link from an outside advertiser.": "外部の広告主によるクーポンのリンクです。", + "Recycle Bin": "ごみ箱", + "Documents": "ドキュメント", + "View": "表示", + "Sort by": "並べ替え", + "Refresh": "最新の情報に更新", + "New": "新規作成", + "Display settings": "ディスプレイ設定", + "Personalize": "個人用設定", + "Open": "開く", + "Edit": "編集", + "Print": "印刷", + "Set as desktop background": "デスクトップの背景として設定", + "Open with": "プログラムから開く", + "Copy as path": "パスのコピー", + "Cut": "切り取り", + "Copy": "コピー", + "Delete": "削除", + "Rename": "名前の変更", + "Properties": "プロパティ" +} diff --git a/docs/manual/build/docscenes/strings.ko.json b/docs/manual/build/docscenes/strings.ko.json new file mode 100644 index 0000000..face1ca --- /dev/null +++ b/docs/manual/build/docscenes/strings.ko.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "2026 가을 정보기술 세미나", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "11월 14일(토) · 3층 대강당 · 무료 입장", + "Register online": "온라인 신청", + "Scan to fill in the sign-up form.": "스캔해서 신청서를 작성하세요.", + "Venue Wi-Fi": "행사장 Wi-Fi", + "Join the guest network in the hall.": "행사장의 게스트 네트워크에 연결하세요.", + "Contact the organizer": "주최 측 연락처", + "Save the organizer's details to your contacts.": "주최 측 연락처를 주소록에 저장하세요.", + "Sponsor offer": "후원사 혜택", + "A coupon link from an outside advertiser.": "외부 광고주가 제공하는 쿠폰 링크입니다.", + "Recycle Bin": "휴지통", + "Documents": "문서", + "View": "보기", + "Sort by": "정렬 기준", + "Refresh": "새로 고침", + "New": "새로 만들기", + "Display settings": "디스플레이 설정", + "Personalize": "개인 설정", + "Open": "열기", + "Edit": "편집", + "Print": "인쇄", + "Set as desktop background": "바탕 화면 배경으로 설정", + "Open with": "연결 프로그램", + "Copy as path": "경로로 복사", + "Cut": "잘라내기", + "Copy": "복사", + "Delete": "삭제", + "Rename": "이름 바꾸기", + "Properties": "속성" +} diff --git a/docs/manual/build/docscenes/strings.pt-BR.json b/docs/manual/build/docscenes/strings.pt-BR.json new file mode 100644 index 0000000..ad35620 --- /dev/null +++ b/docs/manual/build/docscenes/strings.pt-BR.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "Seminário de Tecnologia de Outono 2026", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "Sábado, 14 de novembro · Auditório principal, 3º andar · Entrada gratuita", + "Register online": "Inscreva-se on-line", + "Scan to fill in the sign-up form.": "Escaneie para preencher a ficha de inscrição.", + "Venue Wi-Fi": "Wi-Fi do evento", + "Join the guest network in the hall.": "Conecte-se à rede de visitantes do auditório.", + "Contact the organizer": "Fale com a organização", + "Save the organizer's details to your contacts.": "Salve os dados da organização nos seus contatos.", + "Sponsor offer": "Oferta do patrocinador", + "A coupon link from an outside advertiser.": "Um link de cupom de um anunciante externo.", + "Recycle Bin": "Lixeira", + "Documents": "Documentos", + "View": "Exibir", + "Sort by": "Classificar por", + "Refresh": "Atualizar", + "New": "Novo", + "Display settings": "Configurações de exibição", + "Personalize": "Personalizar", + "Open": "Abrir", + "Edit": "Editar", + "Print": "Imprimir", + "Set as desktop background": "Definir como tela de fundo da área de trabalho", + "Open with": "Abrir com", + "Copy as path": "Copiar como caminho", + "Cut": "Recortar", + "Copy": "Copiar", + "Delete": "Excluir", + "Rename": "Renomear", + "Properties": "Propriedades" +} diff --git a/docs/manual/build/docscenes/strings.ru.json b/docs/manual/build/docscenes/strings.ru.json new file mode 100644 index 0000000..c440134 --- /dev/null +++ b/docs/manual/build/docscenes/strings.ru.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "Осенний семинар по информационным технологиям 2026", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "Суббота, 14 ноября · Большой зал, 3-й этаж · Вход свободный", + "Register online": "Регистрация онлайн", + "Scan to fill in the sign-up form.": "Отсканируйте, чтобы заполнить анкету.", + "Venue Wi-Fi": "Wi-Fi в зале", + "Join the guest network in the hall.": "Подключитесь к гостевой сети зала.", + "Contact the organizer": "Контакты организатора", + "Save the organizer's details to your contacts.": "Сохраните данные организатора в контактах.", + "Sponsor offer": "Предложение спонсора", + "A coupon link from an outside advertiser.": "Ссылка на купон от стороннего рекламодателя.", + "Recycle Bin": "Корзина", + "Documents": "Документы", + "View": "Вид", + "Sort by": "Сортировка", + "Refresh": "Обновить", + "New": "Создать", + "Display settings": "Параметры экрана", + "Personalize": "Персонализация", + "Open": "Открыть", + "Edit": "Изменить", + "Print": "Печать", + "Set as desktop background": "Сделать фоновым изображением рабочего стола", + "Open with": "Открыть с помощью", + "Copy as path": "Копировать как путь", + "Cut": "Вырезать", + "Copy": "Копировать", + "Delete": "Удалить", + "Rename": "Переименовать", + "Properties": "Свойства" +} diff --git a/docs/manual/build/docscenes/strings.zh-CN.json b/docs/manual/build/docscenes/strings.zh-CN.json new file mode 100644 index 0000000..5c47aae --- /dev/null +++ b/docs/manual/build/docscenes/strings.zh-CN.json @@ -0,0 +1,31 @@ +{ + "Autumn Technology Seminar 2026": "2026 秋季信息技术讲座", + "Saturday 14 November · Main Hall, 3rd floor · Free admission": "11 月 14 日(周六)· 三楼大讲堂 · 免费入场", + "Register online": "在线报名", + "Scan to fill in the sign-up form.": "扫码填写报名表。", + "Venue Wi-Fi": "会场 Wi-Fi", + "Join the guest network in the hall.": "连接会场的访客网络。", + "Contact the organizer": "联系主办方", + "Save the organizer's details to your contacts.": "把主办方的联系方式存入通讯录。", + "Sponsor offer": "赞助商优惠", + "A coupon link from an outside advertiser.": "外部广告商提供的优惠券链接。", + "Recycle Bin": "回收站", + "Documents": "文档", + "View": "查看", + "Sort by": "排序方式", + "Refresh": "刷新", + "New": "新建", + "Display settings": "显示设置", + "Personalize": "个性化", + "Open": "打开", + "Edit": "编辑", + "Print": "打印", + "Set as desktop background": "设置为桌面背景", + "Open with": "打开方式", + "Copy as path": "复制文件地址", + "Cut": "剪切", + "Copy": "复制", + "Delete": "删除", + "Rename": "重命名", + "Properties": "属性" +} diff --git a/docs/manual/build/figures.js b/docs/manual/build/figures.js index e03bbfd..4139e0c 100644 --- a/docs/manual/build/figures.js +++ b/docs/manual/build/figures.js @@ -17,7 +17,7 @@ fs.mkdirSync(dst, { recursive: true }); const FIGURES = { welcome: {}, 'tray-menu': { crop: [1050, 300, 870, 780] }, - // menus: desktop at logical (560, 150), image at (120, 250); 300 wide + // menus: desktop at logical (560, 150), image at (120, 250); 360 wide 'shell-desktop': { crop: [690, 180, 780, 700] }, 'shell-image': { crop: [0, 300, 780, 760] }, 'scan-screen': { crop: [0, 0, 1920, 1080] }, diff --git a/docs/manual/build/shoot.js b/docs/manual/build/shoot.js index a9eb106..43cf04d 100644 --- a/docs/manual/build/shoot.js +++ b/docs/manual/build/shoot.js @@ -65,7 +65,8 @@ const T = (id, ...args) => { for (const a of args) s = s.replace('{}', a); return s; }; -const L = (en, zh) => (lang === 'zh-TW' ? zh : en); +// Demo data in the language of the manual: { en: …, 'zh-TW': …, … }, English when missing. +const L = (texts) => texts[lang] ?? texts.en; // ── images ── function qrImage(text, px = 6, margin = 4) { @@ -152,13 +153,36 @@ const model = (arr) => new slint.ArrayModel(arr); const px = (v) => Math.round(v * SCALE); // Demo codes on the mock event page. +const ORGANIZER = L({ en: 'Mei-Ling Chen', 'zh-TW': '陳美玲', 'zh-CN': '陈美玲' }); +const OFFICE = L({ + en: 'Seminar Office', + 'zh-TW': '講座籌備處', + 'zh-CN': '讲座筹备处', + es: 'Oficina del seminario', + 'pt-BR': 'Secretaria do seminário', + ja: 'セミナー事務局', + ko: '세미나 사무국', + fr: 'Bureau du séminaire', + de: 'Seminarbüro', + ru: 'Оргкомитет семинара', +}); +// A plain-text entry in the scan history. +const ROOM_NOTE = L({ + en: 'Room 302 — bring your student ID', + 'zh-TW': '302 教室,請攜帶學生證', + 'zh-CN': '302 教室,请携带学生证', + es: 'Aula 302: trae tu carné de estudiante', + 'pt-BR': 'Sala 302 — traga sua carteirinha de estudante', + ja: '302 教室・学生証を持参してください', + ko: '302호 강의실 — 학생증을 지참하세요', + fr: 'Salle 302 — apportez votre carte d’étudiant', + de: 'Raum 302 – bitte Studierendenausweis mitbringen', + ru: 'Аудитория 302 — возьмите студенческий билет', +}); const CODES = { link: 'https://events.example.org/register', wifi: 'WIFI:T:WPA;S:Seminar-Guest;P:autumn-2026;;', - contact: L( - 'BEGIN:VCARD\nVERSION:3.0\nFN:Mei-Ling Chen\nORG:Seminar Office\nTEL:+886-2-2345-6789\nEMAIL:office@example.org\nEND:VCARD', - 'BEGIN:VCARD\nVERSION:3.0\nFN:陳美玲\nORG:講座籌備處\nTEL:+886-2-2345-6789\nEMAIL:office@example.org\nEND:VCARD', - ), + contact: `BEGIN:VCARD\nVERSION:3.0\nFN:${ORGANIZER}\nORG:${OFFICE}\nTEL:+886-2-2345-6789\nEMAIL:office@example.org\nEND:VCARD`, short: 'http://bit.ly/4kQ2xZp', }; const qrs = { @@ -167,7 +191,6 @@ const qrs = { qr2: qrImage(CODES.contact), qr3: qrImage(CODES.short), }; -const ORGANIZER = L('Mei-Ling Chen', '陳美玲'); // QR positions on the mock desktop, logical pixels (see scenes.slint). const qrBox = (i) => ({ x: 165 + 260 * i, y: 284, w: 170, h: 170 }); const pill = (i, kind, label, sublabel, level, selected = false, live = true) => { @@ -421,7 +444,7 @@ async function main() { { time: '2026-11-14 10:28', kind: 'url', text: CODES.link, openable: true }, { time: '2026-11-14 10:27', kind: 'contact', text: ORGANIZER, openable: false }, { time: '2026-11-13 16:05', kind: 'einvoice', text: 'AB-12345678', openable: false }, - { time: '2026-11-12 09:41', kind: 'text', text: L('Room 302 — bring your student ID', '302 教室,請攜帶學生證'), openable: false }, + { time: '2026-11-12 09:41', kind: 'text', text: ROOM_NOTE, openable: false }, ]), version: '1.0.0', update_status: T('QRcode tool {} is the latest version.', '1.0.0'),