feat: add VitePress docs site, music file picker modal, Dockerfile optimization, i18n keys for 14 locales

- Add docs/ with VitePress site (19 pages): guide, config, architecture, FAQ - Add GitHub Actions workflow for auto-deploy to GitHub Pages - Replace music 'Add Tracks' upload picker with in-app audio file browser modal - Add music picker CSS styles with dark theme support - Add missing i18n keys (search_audio, no_audio_files, etc.) to all 14 locales - Optimize Dockerfile: shared base stage, COPY --chmod, consolidated RUN, HEALTHCHECK - Improve README: docs links, updated stats (222+ tests, 14 languages), feature status
2026-04-11 20:58:34 +02:00
parent 1bb65e6448
commit f08cffc0e8
42 changed files with 4313 additions and 95 deletions
@@ -0,0 +1,78 @@
+# WOPI (Office Document Editing)
+
+OxiCloud integrates with **Collabora Online** and **OnlyOffice** via the WOPI protocol, letting users edit documents, spreadsheets, and presentations directly in the browser.
+
+## How It Works
+
+1. User opens a document (`.docx`, `.xlsx`, `.pptx`, `.odt`, etc.)
+2. OxiCloud generates a WOPI access token and redirects to the editor
+3. The editor fetches the file from OxiCloud via WOPI endpoints
+4. Edits are saved back via `PutFile`
+
+## Configuration
+
+```bash
+OXICLOUD_WOPI_ENABLED=true
+OXICLOUD_WOPI_DISCOVERY_URL="http://collabora:9980/hosting/discovery"
+```
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_WOPI_ENABLED` | `false` | Enable WOPI integration |
+| `OXICLOUD_WOPI_DISCOVERY_URL` | — | Editor's WOPI discovery URL |
+| `OXICLOUD_WOPI_SECRET` | (JWT secret) | Token signing key |
+| `OXICLOUD_WOPI_TOKEN_TTL_SECS` | `86400` | Access token lifetime |
+| `OXICLOUD_WOPI_LOCK_TTL_SECS` | `1800` | Lock expiration |
+
+## Docker Compose with Collabora
+
+```yaml
+services:
+  collabora:
+    image: collabora/code:latest
+    environment:
+      - domain=oxicloud\\.example\\.com
+      - extra_params=--o:ssl.enable=false
+    ports:
+      - "9980:9980"
+    cap_add:
+      - MKNOD
+
+  oxicloud:
+    environment:
+      OXICLOUD_WOPI_ENABLED: "true"
+      OXICLOUD_WOPI_DISCOVERY_URL: "http://collabora:9980/hosting/discovery"
+```
+
+## Docker Compose with OnlyOffice
+
+```yaml
+services:
+  onlyoffice:
+    image: onlyoffice/documentserver:latest
+    environment:
+      - JWT_ENABLED=false
+    ports:
+      - "8443:443"
+
+  oxicloud:
+    environment:
+      OXICLOUD_WOPI_ENABLED: "true"
+      OXICLOUD_WOPI_DISCOVERY_URL: "http://onlyoffice/hosting/discovery"
+```
+
+## WOPI Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/wopi/files/{id}` | CheckFileInfo — file metadata |
+| GET | `/wopi/files/{id}/contents` | GetFile — download file content |
+| POST | `/wopi/files/{id}/contents` | PutFile — save edited content |
+| POST | `/wopi/files/{id}` | Lock / Unlock / RefreshLock |
+
+## Supported Formats
+
+Any format supported by your Collabora or OnlyOffice installation, typically:
+- Documents: `.docx`, `.odt`, `.doc`, `.rtf`
+- Spreadsheets: `.xlsx`, `.ods`, `.xls`, `.csv`
+- Presentations: `.pptx`, `.odp`, `.ppt`