From 5a6d19ba47757de4c42999a4947526ad31f423e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6=20=28skjnldsv=29?= Date: Mon, 9 Sep 2019 10:06:56 +0200 Subject: [PATCH] Update readme MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: John Molakvoæ (skjnldsv) --- README.md | 79 ++++++++++++++++++++++--------------------------------- 1 file changed, 32 insertions(+), 47 deletions(-) diff --git a/README.md b/README.md index 8ac69c3..e560353 100644 --- a/README.md +++ b/README.md @@ -6,59 +6,44 @@ Forms allows the creation of shareable forms, with multiple question types and p **Note**: This app is tested with Apache2 webserver, MySQL database, and apt-get package manager. To use alternatives, replace the relevant commands with those of your technology. This document assumes that a working NextCloud development environment has been installed. See https://docs.nextcloud.com/server/stable/developer_manual/general/devenv.html for help with this. -## Installation -### Download the Forms Codebase +## Build the app -```sh -$ cd /var/www/html/nextcloud/apps -$ git clone https://github.com/nextcloud/forms.git +``` bash +# set up and build for production +make + +# install dependencies +make dev-setup + +# build for dev and watch changes +make watch-js + +# build for dev +make build-js + +# build for production with minification +make build-js-production + +``` +## Running tests +You can use the provided Makefile to run all tests by using: + +_ps: only works if you're using php locally and have forms installed info your apps default folder_ + +``` +make test ``` -### Install Prerequisites and Dependencies -#### Install NPM -```sh -$ apt-get npm -``` +## :v: Code of conduct -#### Install Yarn -```sh -$ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - -$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list -$ apt update -$ apt install yarn -``` -#### Update NodeJS -```sh -$ npm install -g n -$ n stable -``` -### Build the App -```sh -$ cd /var/www/html/nextcloud/apps/forms -$ make all -``` +The Nextcloud community has core values that are shared between all members during conferences, +hackweeks and on all interactions in online platforms including [Github](https://github.com/nextcloud) and [Forums](https://help.nextcloud.com). +If you contribute, participate or interact with this community, please respect [our shared values](https://nextcloud.com/code-of-conduct/). :relieved: -### Start Webserver / Database -```sh -$ service apache2 start -$ service mysql start -``` +## :heart: How to create a pull request -### Enable the App -- Open NextCloud in your browser of choice -- Click on the user icon in the top right of the screen, and select Apps from the drop down menu -- Find the Forms app in the list and click enable -- The app will now be fully functional! The forms icon will appear on the top toolbar of NextCloud after it has been enabled - - -### To Rebuild -``` -$ cd /var/www/html/nextcloud/apps/forms -$ npm run build -$ service Apache2 restart -$ service mysql restart -``` -Refresh the page in your browser to reflect the changes. +This guide will help you get started: +- :dancer: :smile: [Opening a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) ## Code Overview The following are the most important code files for development of the Forms App.