Skip to content

[QA] common-issues symlink example #872

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jnweiger wants to merge 3 commits into
base: main
Choose a base branch
from
Open

[QA] common-issues symlink example #872

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6a9834c
common-issues symlink example
jnweiger May 21, 2026
19b5361
Same example in German translation.
jnweiger May 21, 2026
bf8c03b
.
jnweiger May 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion docs/user/common-issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,19 @@ If you want to synchronize a folder that is located outside your sync root, you

You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.

1. Move the folder into your sync root:
1. Move the folder into (a sub-folder of) your sync root:

```bash
mkdir -p /home/bar/OpenCloud/Personal/foo/
mv /foo/A /home/bar/OpenCloud/Personal/foo/A
```

2. Create a symlink in the original place:

```bash
ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
```

## Files with "~$" in the name will not be synchronized

The OpenCloud Desktop Client does not synchronize files starting with `~$`, such as `~$document.docx`.
Expand Down
17 changes: 12 additions & 5 deletions i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,21 +28,28 @@ Symlinks werden aus mehreren wichtigen Gründen bewusst von der Synchronisation

#### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden

Wenn Sie einen Ordner außerhalb Ihres Synchronisationsverzeichnisses synchronisieren möchten, können Sie diesen verschieben und am ursprünglichen Ort durch einen Symlink ersetzen.
Wenn Sie einen Ordner außerhalb Ihres Synchronisationsverzeichnisses (Sync-Root) synchronisieren möchten, können Sie diesen in die Sync-Root verschieben und am ursprünglichen Ort durch einen Symlink ersetzen.

##### Beispiel

Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihr Sync-Root ist `/home/bar/OpenCloud/Personal`.
Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihre Sync-Root ist `/home/bar/OpenCloud/Personal`.

1. Verschieben Sie den Ordner in das Synchronisationsverzeichnis:
1. Verschieben Sie den Ordner in die Sync-Root (in ein geeignetes Unterverzeichnis):

```bash
mkdir -p /home/bar/OpenCloud/Personal/foo/
mv /foo/A /home/bar/OpenCloud/Personal/foo/A
```

2. Erstellen Sie einen Symlink:

```bash
mv /foo/A /home/bar/OpenCloud/Personal/foo/A
ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
```

## Dateien mit "~$" im Namen werden nicht synchronisiert

Der OpenCloud Desktop Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.
Der OpenCloud Desktop Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.
Dabei handelt es sich um temporäre Sperrdateien, die von Microsoft Office-Anwendungen (Word, Excel, PowerPoint) erstellt werden, solange ein Dokument geöffnet ist.

<img src={require("./img/common-issues/desktop-excluded.png").default} alt="Anzeige, dass ~$ Dateien von der Synchronisierung ausgeschlossen sind" width="500"/>
Expand Down