Merge pull request #614 from DhruvamSharma/master

Removed errors from README.md
This commit is contained in:
Shawn K 2018-10-05 00:59:57 -05:00 committed by GitHub
commit de9c84c346
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -3,16 +3,16 @@ Spee.ch is a web app that reads and publishes images and videos to and from the
You can create your own custom version of spee.ch by installing this code base and then creating your own custom components and styles to override the defaults. (More details / guide on how to do that coming soon.) You can create your own custom version of spee.ch by installing this code base and then creating your own custom components and styles to override the defaults. (More details / guide on how to do that coming soon.)
## Quick start ## Quickstart
_note: this is the quickstart guide, for an in-depth step-by-step overview visit the [fullstart guide](https://github.com/lbryio/spee.ch/blob/readme-update/fullstart.md)._ _note: this is the quickstart guide, for an in-depth step-by-step overview visit the [fullstart guide](https://github.com/lbryio/spee.ch/blob/readme-update/fullstart.md)._
#### Install System Dependencies: #### Install System Dependencies:
* [node](https://nodejs.org) * [node](https://nodejs.org)
* [mysql](https://dev.mysql.com/doc/refman/8.0/en/installing.html) * [MySQL](https://dev.mysql.com/doc/refman/8.0/en/installing.html)
* [`lbry`](https://github.com/lbryio/lbry) daemon * [`lbry`](https://github.com/lbryio/lbry) daemon
* note: retrieve an address from the daemon and send your wallet a couple credits (or join us in the [#speech discord channel](https://discord.gg/YjYbwhS) and we will send you a few) * note: retrieve an address from the daemon and send your wallet a couple credits (or join us in the [#speech discord channel](https://discord.gg/YjYbwhS) and we will send you a few)
* [ffmpeg](https://www.ffmpeg.org/download.html) * [FFmpeg](https://www.ffmpeg.org/download.html)
#### Clone this repo #### Clone this repo
``` ```
@ -29,7 +29,7 @@ $ cd spee.ch
$ npm install $ npm install
``` ```
#### Create the config files using the built in CLI #### Create the config files using the built-in CLI
``` ```
$ npm run configure $ npm run configure
``` ```
@ -51,7 +51,7 @@ check out the [customization guide](https://github.com/lbryio/spee.ch/blob/readm
#### (optional) add custom components and update the styles #### (optional) add custom components and update the styles
* create custom components by creating React components in `src/views/` (further instructions coming soon) * create custom components by creating React components in `src/views/` (further instructions coming soon)
* update the css by changing the files in `public/assets/css/` (further instructions and refactor coming soon) * update the CSS by changing the files in `public/assets/css/` (further instructions and refactor coming soon)
#### (optional) Syncing the full blockchain #### (optional) Syncing the full blockchain
* Start the `spee.ch-sync` tool available at [billbitt/spee.ch-sync](https://github.com/billbitt/spee.ch-sync) * Start the `spee.ch-sync` tool available at [billbitt/spee.ch-sync](https://github.com/billbitt/spee.ch-sync)
@ -120,16 +120,16 @@ response:
## Contribute ## Contribute
### Stack ### Stack
The spee.ch stack is MySQL, Express.js, Node.js, and React.js. Spee.ch also runs `lbrynet` on its server, and it uses the `lbrynet` api to make requests -- such as `publish`, `create_channel`, and `get` -- on the `LBRY` network. The spee.ch stack is MySQL, Express.js, Node.js, and React.js. Spee.ch also runs `lbrynet` on its server, and it uses the `lbrynet` API to make requests -- such as `publish`, `create_channel`, and `get` -- on the `LBRY` network.
Spee.ch also runs a sync tool, which decodes blocks from the `LBRY` blockchain as they are mined, and stores the information in mysql. It stores all claims in the `Claims` table, and all channel claims in the `Certificates` table. Spee.ch also runs a sync tool, which decodes blocks from the `LBRY` blockchain as they are mined, and stores the information in MySQL. It stores all claims in the `Claims` table, and all channel claims in the `Certificates` table.
* server * server
* [mysql](https://www.mysql.com/) * [MySQL](https://www.mysql.com/)
* [express](https://www.npmjs.com/package/express) * [express](https://www.npmjs.com/package/express)
* [node](https://nodejs.org/) * [node](https://nodejs.org/)
* [lbry](https://github.com/lbryio/lbry) * [lbry](https://github.com/lbryio/lbry)
* [ffmpeg](https://www.ffmpeg.org/) * [FFmpeg](https://www.ffmpeg.org/)
* client * client
* [react](https://reactjs.org/) * [react](https://reactjs.org/)
* redux * redux
@ -139,10 +139,10 @@ Spee.ch also runs a sync tool, which decodes blocks from the `LBRY` blockchain a
### Architecture ### Architecture
* `cli/` contains the code for the cli tool. Running the tool will create `.json` config files and place them in the `config/` folder * `cli/` contains the code for the CLI tool. Running the tool will create `.json` config files and place them in the `config/` folder
* `configure.js` is the entry point for the cli tool * `configure.js` is the entry point for the CLI tool
* `cli/defaults/` holds default config files * `cli/defaults/` holds default config files
* `cli/questions/` holds the questions that the cli tool asks to build the config files * `cli/questions/` holds the questions that the CLI tool asks to build the config files
* `client/` contains all of the client code * `client/` contains all of the client code
* The client side of spee.ch uses `React` and `Redux` * The client side of spee.ch uses `React` and `Redux`
@ -152,12 +152,12 @@ Spee.ch also runs a sync tool, which decodes blocks from the `LBRY` blockchain a
* The Redux code is broken up into `actions/` `reducers/` and `selectors/` * The Redux code is broken up into `actions/` `reducers/` and `selectors/`
* The React components are broken up into `containers/` (components that pull props directly from the Redux store), `components/` ('dumb' components), and `pages/` * The React components are broken up into `containers/` (components that pull props directly from the Redux store), `components/` ('dumb' components), and `pages/`
* spee.ch also uses sagas which are in the `sagas/` folders and `channels/` * spee.ch also uses sagas which are in the `sagas/` folders and `channels/`
* `client/scss/` contains the css for the project * `client/scss/` contains the CSS for the project
* *
* `client_custom` is a folder which can be used to override the default components in `client/` * `client_custom` is a folder which can be used to override the default components in `client/`
* The folder structure mimics that of the `client/` folder * The folder structure mimics that of the `client/` folder
* to customize spee.ch, place your own components ans scss in the `client_custom/src/` and `client_custom/scss` folders. * to customize spee.ch, place your own components and scss in the `client_custom/src/` and `client_custom/scss` folders.
* `server/` contains all of the server code * `server/` contains all of the server code
* `index.js` is the entry point for the server. It creates the [express app](https://expressjs.com/), requires the routes, syncs the database, and starts the server listening on the `PORT` designated in the config files. * `index.js` is the entry point for the server. It creates the [express app](https://expressjs.com/), requires the routes, syncs the database, and starts the server listening on the `PORT` designated in the config files.
@ -178,7 +178,7 @@ Spee.ch also runs a sync tool, which decodes blocks from the `LBRY` blockchain a
* To run only tests that do not require LBC, run `npm run test:no-lbc` * To run only tests that do not require LBC, run `npm run test:no-lbc`
### URL formats ### URL formats
Spee.ch has a few types of url formats that return different assets from the LBRY network. Below is a list of all possible urls for the content on spee.ch Spee.ch has a few types of URL formats that return different assets from the LBRY network. Below is a list of all possible URLs for the content on spee.ch
* retrieve the controlling `LBRY` claim: * retrieve the controlling `LBRY` claim:
* https://spee.ch/`claim` * https://spee.ch/`claim`
* https://spee.ch/`claim`.`ext` (serve) * https://spee.ch/`claim`.`ext` (serve)
@ -197,7 +197,7 @@ Spee.ch has a few types of url formats that return different assets from the LBR
* https://spee.ch/`@channel`:`channel_id`/`claim`.`ext` (serve) * https://spee.ch/`@channel`:`channel_id`/`claim`.`ext` (serve)
### Bugs ### Bugs
If you find a bug or experience a problem, please report your issue here on github and find us in the lbry discord! If you find a bug or experience a problem, please report your issue here on GitHub and find us in the lbry discord!
### Issue tags in this repo ### Issue tags in this repo
#### level 1 #### level 1
@ -210,4 +210,4 @@ Familiarity with web apps is required, but little-to-no familiarity with the lbr
Familiarity with the spee.ch code base and how the lbry daemon functions is required Familiarity with the spee.ch code base and how the lbry daemon functions is required
#### level 4 #### level 4
Issues with lbry (e.g. the spee.ch wallet, lbrynet configuration, etc.) that require strong familiarity with the lbry daemon and/or network to fix. Generally these issues are best suited for the `lbry` `protocol team` but are reported in this repo because of they are part of the spee.ch implementation Issues with lbry (e.g. the spee.ch wallet, lbrynet configuration, etc.) that require strong familiarity with the lbry daemon and/or network to fix. Generally these issues are best suited for the `lbry` `protocol team` but are reported in this repo because they are part of the spee.ch implementation