Some markdown fixes

pull/200/head
Chocobozzz 2018-01-12 18:55:45 +01:00
parent 63bfad7ec9
commit afe8176799
No known key found for this signature in database
GPG Key ID: 583A612D890159BE
6 changed files with 34 additions and 36 deletions

View File

@ -35,7 +35,7 @@ to install the dependencies.
Then clone the sources and install node modules: Then clone the sources and install node modules:
```bash ```
$ git clone -b master https://github.com/Chocobozzz/PeerTube $ git clone -b master https://github.com/Chocobozzz/PeerTube
$ cd PeerTube $ cd PeerTube
$ yarn install --pure-lockfile $ yarn install --pure-lockfile
@ -46,7 +46,7 @@ Then, create a postgres database and user with the values set in the
there, the following commands would create a new database called `peertube_dev` there, the following commands would create a new database called `peertube_dev`
and a postgres user called `peertube` with password `peertube`: and a postgres user called `peertube` with password `peertube`:
```bash ```
# sudo -u postgres createuser -P peertube # sudo -u postgres createuser -P peertube
Enter password for new role: peertube Enter password for new role: peertube
# sudo -u postgres createdb -O peertube peertube_dev # sudo -u postgres createdb -O peertube peertube_dev
@ -60,7 +60,7 @@ You can find a documentation of the server code/architecture [here](/support/doc
To develop on the server-side: To develop on the server-side:
```bash ```
$ npm run dev:server $ npm run dev:server
``` ```
@ -76,7 +76,7 @@ You can find a documentation of the server code/architecture
To develop on the client side: To develop on the client side:
```bash ```
$ npm run dev:client $ npm run dev:client
``` ```
@ -88,7 +88,7 @@ reload them automatically thanks to hot module replacement.
This will run 3 nodes: This will run 3 nodes:
```bash ```
$ npm run clean:server:test $ npm run clean:server:test
$ npm run play $ npm run play
``` ```

View File

@ -143,13 +143,13 @@ See the [production guide](support/doc/production.md).
## Contributing ## Contributing
See the [contributing See the [contributing
guide](https://github.com/Chocobozzz/PeerTube/blob/master/.github/CONTRIBUTING.md) guide](/.github/CONTRIBUTING.md)
to see how to contribute to PeerTube. Spoiler alert: you don't need to be a to see how to contribute to PeerTube. Spoiler alert: you don't need to be a
coder to help! coder to help!
## Architecture ## Architecture
See [ARCHITECTURE.md](https://github.com/Chocobozzz/PeerTube/blob/master/ARCHITECTURE.md) for a more detailed explanation. See [ARCHITECTURE.md](/ARCHITECTURE.md) for a more detailed explanation.
### Backend ### Backend

View File

@ -1,8 +1,6 @@
# Installation # Dependencies
## Dependencies ## Debian / Ubuntu
### Debian / Ubuntu
1. Install NodeJS 8.x (current LTS): 1. Install NodeJS 8.x (current LTS):
[https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions) [https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions)
@ -10,20 +8,20 @@
[https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install) [https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install)
4. Run: 4. Run:
```bash ```
$ apt-get update $ apt-get update
$ apt-get install nginx ffmpeg postgresql openssl g++ make $ apt-get install nginx ffmpeg postgresql openssl g++ make
``` ```
### Arch Linux ## Arch Linux
1. Run: 1. Run:
```bash ```
$ pacman -S nodejs yarn ffmpeg postgresql openssl $ pacman -S nodejs yarn ffmpeg postgresql openssl
``` ```
### Other distributions ## Other distributions
Feel free to update this file in a pull request! Feel free to update this file in a pull request!

View File

@ -17,7 +17,7 @@ The client is a HTML/CSS/JavaScript web application (single page application ->
## Files ## Files
The client files are in the `client` directory. The Webpack 2 configurations files are in `client/config` and the source files in `client/src`. The client files are in the `client` directory. The Webpack 2 configurations files are in `client/config` and the source files in `client/src`.
The client modules description are in the [client/package.json](https://github.com/Chocobozzz/PeerTube/blob/master/client/package.json). There are many modules that are used to compile the web application in development or production mode. The client modules description are in the [client/package.json](/client/package.json). There are many modules that are used to compile the web application in development or production mode.
Here is the description of the useful `client` files directory: Here is the description of the useful `client` files directory:
tslint.json -> TypeScript linter rules tslint.json -> TypeScript linter rules
@ -60,7 +60,7 @@ If you are not familiar with Angular I recommend you to read the [quickstart gui
## Components tree ## Components tree
![Components tree](https://github.com/Chocobozzz/PeerTube/blob/master/support/doc/client/components-tree.png) ![Components tree](/support/doc/client/development/components-tree.png)
## Newcomers ## Newcomers

View File

@ -15,9 +15,9 @@ The server is a web server developed with [TypeScript](https://www.typescriptlan
## Files ## Files
The server main file is [server.ts](https://github.com/Chocobozzz/PeerTube/blob/master/server.ts). The server main file is [server.ts](/server.ts).
The server modules description are in the [package.json](https://github.com/Chocobozzz/PeerTube/blob/master/package.json) at the project root. The server modules description are in the [package.json](/package.json) at the project root.
All other server files are in the [server](https://github.com/Chocobozzz/PeerTube/tree/master/server) directory: All other server files are in the [server](/server) directory:
server.ts -> app initilization, main routes configuration (static routes...) server.ts -> app initilization, main routes configuration (static routes...)
config -> server YAML configurations (for tests, production...) config -> server YAML configurations (for tests, production...)
@ -45,7 +45,7 @@ The server is composed by:
A video is seeded by the server with the [WebSeed](http://www.bittorrent.org/beps/bep_0019.html) protocol (HTTP). A video is seeded by the server with the [WebSeed](http://www.bittorrent.org/beps/bep_0019.html) protocol (HTTP).
![Architecture scheme](https://github.com/Chocobozzz/PeerTube/blob/master/support/doc/server/upload-video.png) ![Architecture scheme](/support/doc/development/server/upload-video.png)
When a user uploads a video, the rest API create the torrent file and then adds it to its database. When a user uploads a video, the rest API create the torrent file and then adds it to its database.
@ -53,5 +53,5 @@ If a user wants to watch the video, the tracker will indicate all other users th
## Newcomers ## Newcomers
The server entrypoint is [server.ts](https://github.com/Chocobozzz/PeerTube/blob/master/server.ts). You can begin to look at this file. The server entrypoint is [server.ts](/server.ts). You can begin to look at this file.
Then you can try to understand the [controllers](https://github.com/Chocobozzz/PeerTube/tree/master/server/controllers): they are the entrypoint of each API request. Then you can try to understand the [controllers](/server/controllers): they are the entrypoint of each API request.

View File

@ -10,7 +10,7 @@ Follow the steps of the [dependencies guide](dependencies.md).
Create a `peertube` user with `/home/peertube` home: Create a `peertube` user with `/home/peertube` home:
```bash ```
sudo useradd -m -d /home/peertube -s /bin/bash -p peertube peertube sudo useradd -m -d /home/peertube -s /bin/bash -p peertube peertube
sudo passwd peertube sudo passwd peertube
``` ```
@ -19,7 +19,7 @@ sudo passwd peertube
Create production database and peertube user: Create production database and peertube user:
```bash ```
sudo -u postgres createuser -P peertube sudo -u postgres createuser -P peertube
sudo -u postgres createdb -O peertube peertube_prod sudo -u postgres createdb -O peertube peertube_prod
``` ```
@ -28,7 +28,7 @@ sudo -u postgres createdb -O peertube peertube_prod
Clone, install node dependencies and build application: Clone, install node dependencies and build application:
```bash ```
$ cd /home/peertube $ cd /home/peertube
$ sudo -u peertube git clone -b master https://github.com/Chocobozzz/PeerTube $ sudo -u peertube git clone -b master https://github.com/Chocobozzz/PeerTube
$ cd PeerTube $ cd PeerTube
@ -40,7 +40,7 @@ $ sudo -u peertube npm run build
Copy example configuration: Copy example configuration:
```bash ```
$ sudo -u peertube cp config/production.yaml.example config/production.yaml $ sudo -u peertube cp config/production.yaml.example config/production.yaml
``` ```
@ -52,14 +52,14 @@ configuration. Keys set in this file will override those of
Copy the nginx configuration template: Copy the nginx configuration template:
```bash ```
$ sudo cp /home/peertube/PeerTube/support/nginx/peertube-https /etc/nginx/sites-available/peertube $ sudo cp /home/peertube/PeerTube/support/nginx/peertube-https /etc/nginx/sites-available/peertube
``` ```
Then modify the webserver configuration file. Please pay attention to the `alias` key of `/static/webseed` location. Then modify the webserver configuration file. Please pay attention to the `alias` key of `/static/webseed` location.
It should correspond to the path of your videos directory (set in the configuration file as `storage->videos` key). It should correspond to the path of your videos directory (set in the configuration file as `storage->videos` key).
```bash ```
$ sudo vim /etc/nginx/sites-available/peertube $ sudo vim /etc/nginx/sites-available/peertube
``` ```
@ -150,7 +150,7 @@ server {
Activate the configuration file: Activate the configuration file:
```bash ```
$ sudo ln -s /etc/nginx/sites-available/peertube /etc/nginx/sites-enabled/peertube $ sudo ln -s /etc/nginx/sites-available/peertube /etc/nginx/sites-enabled/peertube
$ sudo systemctl reload nginx $ sudo systemctl reload nginx
``` ```
@ -159,13 +159,13 @@ $ sudo systemctl reload nginx
Copy the nginx configuration template: Copy the nginx configuration template:
```bash ```
sudo cp /home/peertube/PeerTube/support/systemd/peertube.service /etc/systemd/system/ sudo cp /home/peertube/PeerTube/support/systemd/peertube.service /etc/systemd/system/
``` ```
Update the service file: Update the service file:
```bash ```
sudo vim /etc/systemd/system/peertube.service sudo vim /etc/systemd/system/peertube.service
``` ```
@ -195,13 +195,13 @@ WantedBy=multi-user.target
Tell systemd to reload its config: Tell systemd to reload its config:
```bash ```
sudo systemctl daemon-reload sudo systemctl daemon-reload
``` ```
### Run ### Run
```bash ```
sudo systemctl start peertube sudo systemctl start peertube
sudo journalctl -feu peertube sudo journalctl -feu peertube
``` ```
@ -211,7 +211,7 @@ sudo journalctl -feu peertube
The administrator password is automatically generated and can be found in the The administrator password is automatically generated and can be found in the
logs. You can set another password with: logs. You can set another password with:
```bash ```
$ NODE_ENV=production npm run reset-password -- -u root $ NODE_ENV=production npm run reset-password -- -u root
``` ```
@ -220,7 +220,7 @@ $ NODE_ENV=production npm run reset-password -- -u root
The following commands will upgrade the source (according to your current The following commands will upgrade the source (according to your current
branch), upgrade node modules and rebuild client application: branch), upgrade node modules and rebuild client application:
```bash ```
# systemctl stop peertube # systemctl stop peertube
$ npm run upgrade-peertube $ npm run upgrade-peertube
# systemctl start peertube # systemctl start peertube