opt.: new website #1138
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,6 +4,7 @@ import starlight from '@astrojs/starlight'; | |
|
|
||
| // https://astro.build/config | ||
| export default defineConfig({ | ||
| base: '/docs', | ||
| integrations: [ | ||
| starlight({ | ||
| title: 'Server Box', | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -10,7 +10,7 @@ Import multiple server configurations at once using a JSON file. | |
| :::danger[Security Warning] | ||
| **Never store plaintext passwords in files!** This JSON example shows a password field for demonstration only, but you should: | ||
|
|
||
| - **Prefer SSH keys** (`pubKeyId`) instead of `pwd` - they're more secure | ||
| - **Use secret managers** or environment variables if you must use passwords | ||
| - **Delete the file immediately** after import - don't leave credentials lying around | ||
| - **Add to .gitignore** - never commit credential files to version control | ||
|
|
@@ -24,7 +24,7 @@ Import multiple server configurations at once using a JSON file. | |
| "port": 22, | ||
| "user": "root", | ||
| "pwd": "password", | ||
| "pubKeyId": "", | ||
| "tags": ["production"], | ||
| "autoConnect": false | ||
| } | ||
|
|
@@ -40,9 +40,10 @@ Import multiple server configurations at once using a JSON file. | |
| | `port` | Yes | SSH port (usually 22) | | ||
| | `user` | Yes | SSH username | | ||
| | `pwd` | No | Password (avoid - use SSH keys instead) | | ||
| | `pubKeyId` | No | Private key id (from Private Keys - recommended) | | ||
| | `tags` | No | Organization tags | | ||
| | `autoConnect` | No | Auto-connect on startup | | ||
| | `id` | No | Stable server id; omitted or empty values are generated on import | | ||
|
|
||
| ## Import Steps | ||
|
|
||
|
|
@@ -60,15 +61,15 @@ Import multiple server configurations at once using a JSON file. | |
| "ip": "prod.example.com", | ||
| "port": 22, | ||
| "user": "admin", | ||
| "pubKeyId": "my-key", | ||
| "tags": ["production", "web"] | ||
| }, | ||
| { | ||
| "name": "Development", | ||
| "ip": "dev.example.com", | ||
| "port": 2222, | ||
| "user": "dev", | ||
| "pubKeyId": "dev-key", | ||
| "tags": ["development"] | ||
| } | ||
| ] | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -10,7 +10,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D | |
| :::danger[Sicherheitswarnung] | ||
| **Speichern Sie niemals Klartext-Passwörter in Dateien!** Dieses JSON-Beispiel zeigt ein Passwort-Feld nur zur Demonstration, aber Sie sollten: | ||
|
|
||
| - **SSH-Schlüssel bevorzugen** (`pubKeyId`) anstelle von `pwd` - diese sind sicherer | ||
| - **Passwort-Manager** oder Umgebungsvariablen verwenden, wenn Sie Passwörter verwenden müssen | ||
| - **Löschen Sie die Datei sofort** nach dem Import - lassen Sie keine Anmeldedaten herumliegen | ||
| - **Fügen Sie sie zur .gitignore hinzu** - checken Sie niemals Anmeldedatendateien in die Versionsverwaltung ein | ||
|
|
@@ -24,7 +24,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D | |
| "port": 22, | ||
| "user": "root", | ||
| "pwd": "password", | ||
| "pubKeyId": "", | ||
| "tags": ["production"], | ||
| "autoConnect": false | ||
| } | ||
|
|
@@ -40,7 +40,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D | |
| | `port` | Ja | SSH-Port (normalerweise 22) | | ||
| | `user` | Ja | SSH-Benutzername | | ||
| | `pwd` | Nein | Passwort (vermeiden - stattdessen SSH-Schlüssel verwenden) | | ||
| | `pubKeyId` | Nein | Private-Key-ID (aus Private Keys - empfohlen) | | ||
| | `tags` | Nein | Organisations-Tags | | ||
| | `autoConnect` | Nein | Automatische Verbindung beim Start | | ||
|
|
||
|
|
@@ -60,15 +60,15 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D | |
| "ip": "prod.example.com", | ||
| "port": 22, | ||
| "user": "admin", | ||
| "pubKeyId": "my-key", | ||
| "tags": ["production", "web"] | ||
| }, | ||
| { | ||
| "name": "Entwicklung", | ||
| "ip": "dev.example.com", | ||
| "port": 2222, | ||
| "user": "dev", | ||
| "pubKeyId": "dev-key", | ||
| "tags": ["development"] | ||
| } | ||
| ] | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -47,7 +47,7 @@ Server Box folgt den Prinzipien der Clean Architecture mit einer klaren Trennung | |
| ### Lokale Speicherung: Hive | ||
|
|
||
| - **hive_ce**: Community-Edition von Hive | ||
| - Folgen Sie dem bestehenden Modellmuster: Die meisten Stores verwenden `hive_ce`, einige verfolgte Modelle deklarieren weiterhin explizit `@HiveType` und `@HiveField` | ||
| - Typ-Adapter werden automatisch generiert | ||
| - Persistenter Key-Value-Speicher | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -21,8 +21,11 @@ Führen Sie sie aus nach der Änderung von: | |
| # Gesamten Code generieren | ||
| dart run build_runner build --delete-conflicting-outputs | ||
|
|
||
| # Generierten Build-Cache bereinigen | ||
| dart run build_runner clean | ||
|
|
||
| # Dann neu generieren | ||
| dart run build_runner build --delete-conflicting-outputs | ||
| ``` | ||
|
|
||
| ## Generierte Dateien | ||
|
|
@@ -94,5 +97,5 @@ Generiert `lib/generated/l10n/` aus `lib/l10n/*.arb` Dateien. | |
| ## Tipps | ||
|
|
||
| - Verwenden Sie `--delete-conflicting-outputs`, um Konflikte zu vermeiden. | ||
| - Behalten Sie generierte Dateien in der Versionsverwaltung, wenn dieses Repository sie bereits verfolgt. | ||
| - Bearbeiten Sie generierte Dateien niemals manuell. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -18,17 +18,7 @@ flutter test --coverage | |
|
|
||
| ## Teststruktur | ||
|
|
||
| Tests befinden sich im Verzeichnis `test/`. Die aktuelle Suite ist überwiegend flach und nach Parser-, Modell- und Utility-Verhalten gruppiert, zum Beispiel `cpu_test.dart`, `container_test.dart` und `ssh_config_test.dart`. | ||
|
|
||
| ## Unit-Tests | ||
|
|
||
|
|
@@ -71,26 +61,13 @@ test('serverStatusProvider gibt Status zurück', () async { | |
| }); | ||
| ``` | ||
|
|
||
| ## Externe Abhängigkeiten | ||
|
|
||
| Vermeiden Sie Tests, die von echten SSH-Servern abhängen. Parser-, Modell- und Command-Builder-Tests sollten deterministisch bleiben; fügen Sie gezielte Fakes oder Fixtures hinzu, wenn eine Funktion eine Service-Grenze einführt. | ||
|
|
||
| ## Integrationstests | ||
|
|
||
| Im aktuellen Repository gibt es keine `integration_test/`-Suite. Fügen Sie Integrationstests nur hinzu, wenn eine Funktion End-to-End-Geräte- oder App-Flow-Abdeckung benötigt.dart | ||
|
There was a problem hiding this comment. 🟡 Missing code fence opener in localized testing docs renders Dart code as plain paragraph text In the German (and identically in es, fr, ja, zh) testing docs, the Same bug in other locale files
The English version ( Prompt for agents
Was this helpful? React with 👍 or 👎 to provide feedback. |
||
| testWidgets('Server hinzufügen Ablauf', (tester) async { | ||
| await tester.pumpWidget(MyApp()); | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -5,7 +5,7 @@ hero: | |
| tagline: Verwalten Sie Ihre Linux-Server von überall aus | ||
| actions: | ||
| - text: Loslegen | ||
| link: /docs/de/introduction/ | ||
| icon: right-arrow | ||
| variant: primary | ||
| - text: Auf GitHub ansehen | ||
|
|
@@ -41,6 +41,6 @@ import { Card, CardGrid } from '@astrojs/starlight/components'; | |
|
|
||
| ## Quick-Links | ||
|
|
||
| - **Download**: Verfügbar im [App Store](https://apps.apple.com/app/id1586449703), auf [GitHub](https://github.com/lollipopkit/flutter_server_box/releases), bei [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox), im [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) und bei [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/) | ||
| - **Dokumentation**: Entdecken Sie die Anleitungen für den Einstieg in die Server Box | ||
| - **Support**: Treten Sie unserer Community auf GitHub für Diskussionen und Probleme bei | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -15,36 +15,44 @@ Laden Sie es aus dem **[App Store](https://apps.apple.com/app/id1586449703)** he | |
|
|
||
| Wählen Sie Ihre bevorzugte Quelle: | ||
|
|
||
| - **[GitHub Releases](https://github.com/lollipopkit/flutter_server_box/releases)** – Für die neueste Version direkt von der Quelle | ||
| - **[CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid)** – Spiegel für Release-Pakete | ||
| - **[F-Droid](https://f-droid.org/packages/tech.lolli.toolbox)** – Für Benutzer, die reine FOSS-Quellen bevorzugen | ||
| - **[OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/)** – Drittanbieter-Android-App-Store | ||
|
|
||
| ## Desktop Apps | ||
|
|
||
| ### macOS | ||
|
|
||
| Aus dem **[App Store](https://apps.apple.com/app/id1586449703)** herunterladen oder mit Homebrew Cask installieren: | ||
|
|
||
| ```sh | ||
| brew install --cask server-box | ||
| ``` | ||
|
|
||
| Funktionen: | ||
| - Native Menüleisten-Integration | ||
| - Unterstützung für sowohl Intel als auch Apple Silicon | ||
|
|
||
| ### Linux | ||
|
|
||
| Herunterladen von den **[GitHub Releases](https://github.com/lollipopkit/flutter_server_box/releases)** oder dem **[CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid)**. | ||
|
|
||
| GitHub Releases und CDN stellen Linux-AppImage-Pakete bereit. | ||
|
|
||
| ### Windows | ||
|
|
||
| Herunterladen von den **[GitHub Releases](https://github.com/lollipopkit/flutter_server_box/releases)** oder dem **[CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid)**. | ||
|
|
||
| GitHub Releases und CDN stellen Windows-zip-Pakete bereit. | ||
|
|
||
| ## watchOS | ||
|
|
||
| Verfügbar im **[App Store](https://apps.apple.com/app/id1586449703)** als Teil der iOS-App. | ||
|
|
||
| ## Aus dem Quellcode bauen | ||
|
|
||
| Um Server Box aus dem Quellcode zu bauen, lesen Sie den Abschnitt [Bauen](/docs/de/development/building/) in der Entwicklungsdokumentation. | ||
|
|
||
| ## Versionsinformationen | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -85,7 +85,7 @@ void main() { | |
| - Keine Abhängigkeiten von nativem Code | ||
| - Schneller Key-Value-Speicher | ||
| - Typsicher durch Codegenerierung | ||
| - Folgen Sie dem bestehenden Modellmuster; einige verfolgte Modelle verwenden weiterhin explizite Feld-Annotationen | ||
|
|
||
| **Stores:** | ||
| - `SettingStore`: App-Einstellungen | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -47,7 +47,7 @@ Server Box follows clean architecture principles with clear separation between d | |
| ### Local Storage: Hive | ||
|
|
||
| - **hive_ce**: Community edition of Hive | ||
| - Follow the existing model pattern: most stores use `hive_ce`, while some tracked models still declare `@HiveType` and `@HiveField` explicitly | ||
| - Type adapters auto-generated | ||
| - Persistent key-value storage | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -21,8 +21,11 @@ Run after modifying: | |
| # Generate all code | ||
| dart run build_runner build --delete-conflicting-outputs | ||
|
|
||
| # Clean generated build cache | ||
| dart run build_runner clean | ||
|
|
||
| # Then regenerate | ||
| dart run build_runner build --delete-conflicting-outputs | ||
| ``` | ||
|
|
||
| ## Generated Files | ||
|
|
@@ -94,5 +97,5 @@ Generates `lib/generated/l10n/` from `lib/l10n/*.arb` files. | |
| ## Tips | ||
|
|
||
| - Use `--delete-conflicting-outputs` to avoid conflicts | ||
| - Keep generated files in version control when they are already tracked by this repository | ||
| - Never manually edit generated files | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🚩 Makefile gen-build-clean target still uses invalid --clean flag despite docs update
The PR updates documentation in multiple languages (e.g.,
docs/src/content/docs/development/codegen.md:24-28) to recommenddart run build_runner cleanfollowed bydart run build_runner build --delete-conflicting-outputsas two separate commands. However, the Makefilegen-build-cleantarget atMakefile:94-95still uses the old single-command formdart run build_runner build --delete-conflicting-outputs --clean. The--cleanflag is not a valid option forbuild_runner build; the correct approach isbuild_runner cleanas a separate subcommand. This is a pre-existing issue, but the PR's doc changes explicitly corrected the guidance without updating the Makefile target to match.(Refers to lines 94-95)
Was this helpful? React with 👍 or 👎 to provide feedback.