X-Git-Url: https://git.cweiske.de/grauphel.git/blobdiff_plain/fe95ae00a244b1ebae6bc88958065b5355c7c8c8..0cff53bab0eaf5152e91bebd5070d817d301f0e7:/README.rst diff --git a/README.rst b/README.rst index ab81ce4..b8c3f2b 100644 --- a/README.rst +++ b/README.rst @@ -1,11 +1,11 @@ ***************************** grauphel - tomboy REST server ***************************** -ownCloud__ application implementing the `Tomboy`__ `REST API`__ for syncing notes. +nextCloud__ application implementing the `Tomboy`__ `REST API`__ for syncing notes. Pretty stable. -__ http://owncloud.org/ +__ https://nextcloud.com/ __ https://wiki.gnome.org/Apps/Tomboy __ https://wiki.gnome.org/Apps/Tomboy/Synchronization/REST/1.0 @@ -40,12 +40,12 @@ Supported clients __ http://conboy.garage.maemo.org/ __ https://wiki.gnome.org/Apps/Tomboy -__ https://launchpad.net/tomdroid +__ https://github.com/tomboy-notes/tomdroid Known working versions ====================== -grauphel 0.2.1 is known to work with: +grauphel 0.7.3 is known to work with: * Tomboy 1.15.2, Linux * Tomboy 1.15.1, Windows @@ -62,7 +62,7 @@ Functionality Search ====== -You can use ownCloud's global search on the top right. +You can use nextCloud's global search on the top right. During search, the note's titles, tags and content are searched. @@ -91,9 +91,13 @@ __ http://pecl.php.net/package/oauth Installation ============ +.. note:: + grauphel needs to be activated for all users. + It will not work with the "enable only for specific groups" setting. + App store installation ====================== -#. Log into owncloud as administrator +#. Log into nextcloud as administrator #. Goto "Apps" #. Enable experimental apps in the settings #. Click "Productivity" @@ -105,17 +109,17 @@ Manual installation =================== #. SSH onto your web server -#. Navigate to the owncloud ``apps`` directory, often in ``/var/www/owncloud/apps`` +#. Navigate to the nextcloud ``apps`` directory, often in ``/var/www/nextcloud/apps`` #. Download the latest release from http://cweiske.de/grauphel.htm#download and extract it. For example:: - $ wget http://cweiske.de/download/grauphel/grauphel-0.6.2.tar.bz2 - $ tar xjvf grauphel-0.6.2.tar.bz2 - $ rm grauphel-0.6.2.tar.bz2 + $ wget http://cweiske.de/download/grauphel/grauphel-0.7.3.tar.gz + $ tar xjvf grauphel-0.7.3.tar.gz + $ rm grauphel-0.7.3.tar.gz - You do have a directory ``/var/www/owncloud/apps/grauphel`` now. -#. Using your browser, login as administrator into ownCloud and click + You do have a directory ``/var/www/nextcloud/apps/grauphel`` now. +#. Using your browser, login as administrator into nextCloud and click the "Apps" icon in the main menu ("+" icon). #. Click on "Grauphel: Tomboy note server" and then on the "Enable" button. #. In the main menu, click the "Tomboy notes" icon. @@ -125,14 +129,13 @@ It may be that grauphel now shows you an error message:: PHP extension "oauth" is required You have to install the PHP PECL oauth extension now. -On Debian 7, do the following:: +On Debian 9 or higher, do the following:: - $ apt-get install libpcre3-dev php-pear php5-dev - $ pecl install oauth-1.2.3 - $ echo 'extension=oauth.so' > /etc/php5/conf.d/oauth.ini + $ apt install php-oauth + $ phpenmod oauth $ /etc/init.d/apache2 restart -Reload the ownCloud page in your browser now. +Reload the nextCloud page in your browser now. .. note:: ``oauth-1.2.3`` is only needed on PHP 5.x @@ -142,36 +145,10 @@ Reload the ownCloud page in your browser now. ======== Download ======== +.. LATESTRELEASE -* `grauphel-0.6.1.tar.gz `__, - 35 kiB, 2015-09-22, - SHA256: ``f86cf7b47be857d8a87d413b6315c336e83e9c4beba2cb6ed0eaea8d2b3ea1c3`` - - * `grauphel-0.6.1.tar.bz2 `__, - 31 kiB, 2015-09-21, - SHA256: ``b755b32a453617536eb202cd9d29129df1b04311b633d971108c310a4b9b2e4b`` -* `grauphel-0.6.0.tar.bz2 `__, - 31 kiB, 2015-09-18, - SHA256: ``42e66ed4db1f0c24ca25e46ac4be6e523352f431daaefb22140a2a2e621049b8`` -* `grauphel-0.5.1.tar.bz2 `__, - 29 kiB, 2015-06-04, - SHA256: ``fdb6232fa0d09a72e8355e5e4610403717ffe5c7f7193af2b36d991f1eb76127`` -* `grauphel-0.5.0.tar.bz2 `__, - 29 kiB, 2015-03-17, - SHA256: ``9bbd5426cd7cd36f603c49b0635f24cb9507cf857480edc1f72df0ea0107f7de`` -* `grauphel-0.4.0.tar.bz2 `__, - 24 kiB, 2014-10-29, - SHA256: ``a625ed127af04af4c0a658fcac8156557ef8098eaeddb72281842ad0c0c00b71`` -* `grauphel-0.3.0.tar.bz2 `__, - 17 kiB, 2014-10-14, - SHA256: ``c59ac4cab6d747a4fe89ebd59c92e7ec80f9e2fb3b1edf8904357bc161897ae8`` -* `grauphel-0.2.1.tar.bz2 `__, - 13 kiB, 2014-10-03, - SHA256: ``b66db077fc3e117b2e143b5b177c1d9a8a86c43029936ea65300a4d822e9fdda`` -* `grauphel-0.2.0.tar.bz2 `__, - 13 kiB, 2014-09-27, - SHA256: ``abb1372e8b8525237bea1b686aa6ee2d390974f84bf2206d3aacc2c191978162`` - +See `grauphel downloads page `_ +for all released versions. ====== Author @@ -183,12 +160,12 @@ Christian Weiske, cweiske@cweiske.de, http://cweiske.de/ Links ===== - `Homepage`__ -- `grauphel on apps.owncloud.com`__ +- `grauphel on apps.nextcloud.com`__ - `Source code repository`__ - `Github source code mirror`__ __ http://cweiske.de/grauphel.htm -__ http://apps.owncloud.com/content/show.php?action=content&content=166654 +__ http://apps.nextcloud.com/apps/grauphel __ http://git.cweiske.de/grauphel.git/ __ https://github.com/cweiske/grauphel @@ -221,6 +198,14 @@ Releasing grauphel To release a new version, do the following: #. Increase version number in ``appinfo/version`` and ``appinfo/info.xml``. +#. Validate ``appinfo/info.xml``:: + + $ xmllint --noout --schema tools/info.xsd appinfo/info.xml + +#. Validate ``appinfo/database.xml``:: + + $ xmllint --noout --schema tools/database.xsd appinfo/database.xml + #. Fill the ``ChangeLog`` file with the changes since the last release, mention the new version number. #. Update ``README.rst`` and increase the version number @@ -233,6 +218,12 @@ To release a new version, do the following: #. Tag the release in git #. Upload the release to http://cweiske.de/grauphel.htm with:: - $ phing update-website + $ cd ~/Dev/html/cweiske.de + $ ./scripts/update-grauphel.sh + +#. Upload the new release on + https://apps.nextcloud.com/developer/apps/releases/new + + Signature:: -#. Link the new release on https://apps.owncloud.com/content/show.php?content=166654 + $ openssl dgst -sha512 -sign ~/.nextcloud/certificates/grauphel.key dist/grauphel-0.7.3.tar.gz | openssl base64