Skip to content

Commit 3055895

Browse files
committed
create german file naming rules and remove draft:true
1 parent 3029477 commit 3055895

2 files changed

Lines changed: 68 additions & 1 deletion

File tree

docs/user/desktop-client/file-names.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ sidebar_position: 11
33
id: file-names
44
title: File Naming Rules
55
description: File Naming Rules for OpenCloud Desktop
6-
draft: true
6+
draft: false
77
---
88

99
# Filename restrictions on OpenCloud Desktop
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
sidebar_position: 11
3+
id: file-names
4+
title: Dateinamensbeschränkungen im OpenCloud Desktop-Client
5+
description: Dateinamensbeschränkungen im OpenCloud Desktop-Client
6+
draft: false
7+
---
8+
9+
# Dateinamensbeschränkungen im OpenCloud Desktop-Client
10+
11+
Bei der Verwendung des OpenCloud Desktop-Clients müssen Datei- und Ordnernamen bestimmte Anforderungen des Betriebssystems (OS) erfüllen, um eine reibungslose Synchronisierung zwischen verschiedenen Plattformen zu gewährleisten.
12+
Diese Einschränkungen werden nicht von OpenCloud erzwungen, sondern stammen aus systembedingten Beschränkungen.
13+
14+
## Wichtige Richtlinien
15+
16+
- Verwenden Sie keine verbotenen Zeichen oder reservierten Namen in Dateinamen – unabhängig vom Betriebssystem.
17+
- Wenn Sie von Linux/macOS zu einer Windows-basierten Freigabe synchronisieren, stellen Sie sicher, dass die Dateinamen mit den Windows-Benennungsregeln kompatibel sind.
18+
- Um unter Linux/macOS beim Synchronisieren mit Windows nur die Groß-/Kleinschreibung zu ändern (z. B. `File.txt``file.txt`), benennen Sie die Datei zunächst in einen komplett neuen Namen um, lassen Sie sie synchronisieren und benennen Sie sie danach in den gewünschten Namen um.
19+
20+
## Häufige Einschränkungen
21+
22+
### a. Maximale Pfadlänge
23+
24+
Windows begrenzt Dateipfade standardmäßig auf 260 Zeichen.
25+
Wenn Ihr Synchronisierungs-Stammverzeichnis diesen Wert überschreitet, zeigt der Desktop-Client folgende Warnung an:
26+
„The path 'YOUR.LONG.PATH' is too long. Please enable long paths in the Windows settings or choose a different folder.“
27+
28+
Unter Windows 10 und neuer kann diese Beschränkung aufgehoben werden, indem "Long Paths" aktiviert werden. Siehe [Microsoft-Dokumentation](https://learn.microsoft.com/de-de/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#enable-long-paths-in-windows-10-version-1607-and-later).
29+
30+
### b. Verbotene Zeichen
31+
32+
| Betriebssystem | Verbotene Zeichen |
33+
| -------------- | ------------------------------- | ------------ |
34+
| Windows | `<`, `>`, `:`, `"`, `/`, `\`, ` | `, `?`, `\*` |
35+
36+
### c. Nicht druckbare ASCII-Zeichen
37+
38+
- Linux/macOS: NUL (Zeichencode 0)
39+
- Windows: ASCII 0 – 31
40+
41+
Auch wenn diese Zeichen auf manchen Systemen gültig sind, führen sie häufig zu Problemen bei der Synchronisierung.
42+
43+
### d. Reservierte Dateinamen (Windows)
44+
45+
Vermeiden Sie die Verwendung folgender Dateinamen:
46+
`CON`, `PRN`, `AUX`, `NUL`, `COM1``COM9`, `LPT1``LPT9`
47+
48+
### e. Besondere Regeln
49+
50+
- Unter Linux/macOS beim Synchronisieren zu SMB können Dateinamen, die sich nur in der Groß-/Kleinschreibung unterscheiden, zu Konflikten führen – benennen Sie Dateien eindeutig, um Fehler zu vermeiden.
51+
- Unter Windows dürfen Dateinamen nicht mit einem Leerzeichen oder Punkt (`.`) enden.
52+
53+
## Beispiel
54+
55+
Das Erstellen einer Datei mit dem Namen `example.` oder `example.LPT1` unter macOS kann zwar erfolgreich mit OpenCloud synchronisiert werden.
56+
Beim Zugriff über einen Windows-Client werden diese Dateien jedoch möglicherweise abgelehnt, da sie gegen reservierte Namens- oder Formatregeln verstoßen, was zu inkonsistentem Synchronisierungsverhalten zwischen Geräten führt.
57+
58+
## Zusammenfassung
59+
60+
| Einschränkungstyp | Maßnahme |
61+
| ------------------------- | ------------------------------------------------------ |
62+
| Pfadlänge | Pfade unter ~260 Zeichen halten (außer bei Long Paths) |
63+
| Verbotene Zeichen | Nicht erlaubte Zeichen aus Namen entfernen |
64+
| Steuerzeichen | Nicht druckbare ASCII-Zeichen vermeiden |
65+
| Reservierte Dateinamen | Keine Windows-reservierten Namen verwenden |
66+
| Nur Groß-/Kleinschreibung | Vorher temporär umbenennen, dann synchronisieren |
67+
| Endzeichen | Keine Dateinamen mit Leerzeichen oder Punkt beenden |

0 commit comments

Comments
 (0)