X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=.github%2FCONTRIBUTING.md;h=75557865e6fce920b3aac049e7af3abaa2acabb4;hb=647c2b7d0448e68d8c8ade52d9568e9b33f8638d;hp=74d20aa78759f10392de414033d2b8c593efcad5;hpb=9883e60f307c8161ef694b8fc209b857b196add0;p=github%2FChocobozzz%2FPeerTube.git diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 74d20aa78..75557865e 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -7,7 +7,6 @@ Interested in contributing? Awesome! - - [Translate](#translate) - [Give your feedback](#give-your-feedback) - [Write documentation](#write-documentation) @@ -20,7 +19,7 @@ Interested in contributing? Awesome! - [Client and server side](#client-and-server-side) - [RTL layout](#rtl-layout) - [Testing](#testing) - - [Unit tests](#unit-tests) + - [Unit/integration tests](#unitintegration-tests) - [Testing the federation of PeerTube servers](#testing-the-federation-of-peertube-servers) - [Emails](#emails) - [Plugins & Themes](#plugins--themes) @@ -117,6 +116,9 @@ $ sudo -u postgres psql -c "CREATE EXTENSION pg_trgm;" peertube_dev $ sudo -u postgres psql -c "CREATE EXTENSION unaccent;" peertube_dev ``` +Peertube also requires a running redis server, no special setup is needed for +this. + In dev mode, administrator username is **root** and password is **test**. ### Online development @@ -127,7 +129,7 @@ You can get a complete PeerTube development setup with Gitpod, a free one-click ### Server side -You can find a documentation of the server code/architecture [here](https://docs.joinpeertube.org/#/contribute-architecture?id=server-code). +You can find a documentation of the server code/architecture [here](https://docs.joinpeertube.org/contribute-architecture?id=server-code). To develop on the server-side: @@ -142,7 +144,7 @@ restart. ### Client side You can find a documentation of the client code/architecture -[here](https://docs.joinpeertube.org/#/contribute-architecture?id=client-code). +[here](https://docs.joinpeertube.org/contribute-architecture?id=client-code). To develop on the client side: @@ -217,8 +219,20 @@ Instance configurations are in `config/test-{1,2,3}.yaml`. To test emails with PeerTube: * Run [mailslurper](http://mailslurper.com/) - * Run PeerTube using mailslurper SMTP port: `NODE_CONFIG='{ "smtp": { "hostname": "localhost", "port": 2500, "tls": false } }' NODE_ENV=test npm start` + * Run PeerTube using mailslurper SMTP port: `NODE_CONFIG='{ "smtp": { "hostname": "localhost", "port": 2500, "tls": false } }' NODE_ENV=dev node dist/server` + +### Environment variables + +PeerTube can be configured using environment variables. +See the list on https://docs.joinpeertube.org/maintain-configuration?id=environment-variables + +Additionally to these ones, we provide some environment for dev/test purpose: + + * `PRODUCTION_CONSTANTS=true`: in `NODE_ENV=dev` or `NODE_ENV=test` PeerTube customizes some constants. To prevent this behaviour, you can set `PRODUCTION_CONSTANTS` env to + `true` + * `PEERTUBE_LOCAL_CONFIG`: directory to find the local configuration file (used by web admin) + * `NODE_DB_LOG=false`: disable SQL request logging ## Plugins & Themes -See the dedicated documentation: https://docs.joinpeertube.org/#/contribute-plugins +See the dedicated documentation: https://docs.joinpeertube.org/contribute-plugins