2.6 KiB

Исходник Постоянная ссылка Ответственный История

documents

Documents app for Nextcloud

A Nextcloud app to work with office documents alone and/or collaboratively. It can open ODF documents and supports the basic features around text markup and inserting images. Tables can be displayed and edited but not created. Most other features are not supported. As the Documents app does not import documents to an internal representation and export them upon saving, editing will rarely damage documents, even if it can't display or handle elements.

Deprectated 💀

Sadly, WebODF is no longer developed and the company behind it has closed up. We might continue to try to keep Documents compatible with Nextcloud releases. But, as browsers change and office document formats evolve, the WebODF engine itself is expected to start exhibiting more and more issues over time and it will cease to function at some point. Unless a significant time effort can be invested in WebODF, there is not much that can be done about this.

We suggest to migrate to Collabora Online.

Known issues

Problem: Editor doesn't open. Spinner spins for ages.
Solution: Try to disable gzip for Documents app by adding the following line to your .htaccess:
SetEnvIf Request_URI .*/apps/documents/ajax/.* no-gzip dont-vary

Problem: Doc(x) support doesn't work
Solution: Install at least libreoffice-common and libreoffice-writer packages for your distro.
If you don't want to mess around with dependencies, you need simply install unoconv package. It will do the trick for you.

How to add more fonts

Upload font files to documents/css/fonts directory
Edit documents/css/fonts.css adding @font-face rule for each uploaded file

WebODF upgrade

Build WebODF:
```
 ./src/updateWebODF.sh prepare
```

    git clone https://github.com/kogmbh/WebODF.git webodf
    mkdir build
    cd build
    cmake ../webodf
    make all webodf-debug.js-target build-wodocollabtexteditor

Refresh code and create a new branch:

 cd /path/to/documents
 git checkout master
 git pull --rebase
 git checkout -b new-branch

Run upgrade script:

 ./src/updateWebODF.sh copy
 ./src/updateWebODF.sh patch

Resolve confilcts in patches (if any). Commit changes.
Update patches in /path/to/documents/src/patches according to conflicts. Commit changes.
Test UI. Fix glitches by updating CSS. Commit changes.
Run locale extraction script:
```
 ./src/updateWebODF.sh
```
Commit changes
Push the branch for testing
You are done.