Skip to content

allotropia/nextcloud_files_libreoffice_edit

Repository files navigation

Nextcloud Files - Edit with LibreOffice

Nextcloud App to edit files directly in LibreOffice (via WebDav).

Requires at least:

  • LibreOffice 5.3 (on Windows)
  • LibreOffice 7.2 (on Linux)

Doesn't seem to work on macOS currently (See issue #6)

Automatic install

Install from the Nextcloud app store.

Manual install

Place this app in nextcloud/apps/

Translations

Help translate this app at Nextcloud Transifex.

Local development

For developing, build the app (with automatic rebuilding when changes are done) using:

npm run watch

For local testing, use the following command:

docker run --rm -p 8080:80 -v ~/path/to/fileslibreofficeedit:/var/www/html/apps-extra/fileslibreofficeedit ghcr.io/juliushaertl/nextcloud-dev-php81:latest

Then open Nextcloud in your browser: http://localhost:8080

Go to http://localhost:8080/index.php/settings/apps/installed and enable the fileslibreofficeedit app.

Now you can work on the code. Any changes will be visible in your local Nextcloud after reload (maybe need to clear cache).

Building a release

To build a release, use make && make appstore.

The following things to be present:

  • make
  • which
  • tar: for building the archive
  • curl: used if phpunit and composer are not installed to fetch them from the web
  • npm: for building and testing everything JS, only required if a package.json is placed inside the js/ folder

The make command will install or update Composer dependencies and also npm run build.

Release procedure

  • IMPORTANT: Make sure that this directory is named fileslibreofficeedit and not nextcloud_files_libreoffice_edit or other names, otherwise the build scripts will produce unusable artifacts.
  • Update CHANGELOG.md
  • Update version number in appinfo/info.xml
  • Verify that the build succeeds without errors: make && make appstore
  • Commit changes & create a tag
    • git tag -a v1.0.3
  • git push && git push --tags
  • Build the appstore package: make && make appstore
  • The archive is located in build/artifacts/appstore
  • Create a new github release and upload the release artifact there
  • Create a new extension release in Nextcloud store
  • Done!