X-Git-Url: https://git.cweiske.de/grauphel.git/blobdiff_plain/89a7da2db6368707c1247b25b7605a4cb1db83d0..74c2b5177be213dc8f450b48d31855cc67ac1e0e:/README.rst diff --git a/README.rst b/README.rst index 22aa44a..96968df 100644 --- a/README.rst +++ b/README.rst @@ -91,17 +91,32 @@ __ 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 +#. Goto "Apps" +#. Enable experimental apps in the settings +#. Click "Productivity" +#. Look for "grauphel - Tomboy sync server" +#. Click "Activate" + + Manual installation =================== #. SSH onto your web server #. Navigate to the owncloud ``apps`` directory, often in ``/var/www/owncloud/apps`` -#. Download the latest release from http://cweiske.de/grauphel.htm and extract it. +#. Download the latest release from http://cweiske.de/grauphel.htm#download + and extract it. For example:: - $ wget http://cweiske.de/download/grauphel/grauphel-0.5.1.tar.bz2 - $ tar xjvf grauphel-0.5.1.tar.bz2 - $ rm grauphel-0.5.1.tar.bz2 + $ wget http://cweiske.de/download/grauphel/grauphel-0.6.4.tar.gz + $ tar xjvf grauphel-0.6.4.tar.gz + $ rm grauphel-0.6.4.tar.gz You do have a directory ``/var/www/owncloud/apps/grauphel`` now. #. Using your browser, login as administrator into ownCloud and click @@ -117,12 +132,24 @@ You have to install the PHP PECL oauth extension now. On Debian 7, do the following:: $ apt-get install libpcre3-dev php-pear php5-dev - $ pecl install oauth + $ pecl install oauth-1.2.3 $ echo 'extension=oauth.so' > /etc/php5/conf.d/oauth.ini $ /etc/init.d/apache2 restart Reload the ownCloud page in your browser now. +.. note:: + ``oauth-1.2.3`` is only needed on PHP 5.x + For PHP 7 simply use ``pecl install oauth``. + + +======== +Download +======== +.. LATESTRELEASE + +See `grauphel downloads page `_ +for all released versions. ====== Author @@ -155,11 +182,31 @@ Development hints incremented by 1. +Unit testing +============ +- `ownCloud unit testing documentation`__ +- `grauphel on Travis CI`__ + + .. image:: https://travis-ci.org/cweiske/grauphel.svg + :target: https://travis-ci.org/cweiske/grauphel + +__ https://doc.owncloud.org/server/8.0/developer_manual/core/unit-testing.html +__ https://travis-ci.org/cweiske/grauphel + + 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 @@ -170,5 +217,9 @@ To release a new version, do the following: The file will be in ``dist/`` #. Test the release on a server #. Tag the release in git -#. Upload the release to http://cweiske.de/grauphel.htm +#. Upload the release to http://cweiske.de/grauphel.htm with:: + + $ cd ~/Dev/html/cweiske.de + $ ./scripts/update-grauphel.sh + #. Link the new release on https://apps.owncloud.com/content/show.php?content=166654