Added a README
This commit is contained in:
parent
2242ce2878
commit
6399ac1432
56
README.md
Normal file
56
README.md
Normal file
@ -0,0 +1,56 @@
|
||||
# Episodes.Community
|
||||
## Overview
|
||||
Episodes.Community is an in-development website for the discussion and viewing of any and every television show. An index of episodes is maintained for each show. Users are able to submit a link to a streaming location for an episode. This link is then voted on by other users, with the resulting score determining that link's priority.
|
||||
|
||||
## Planned Features
|
||||
* Each show given a subdomain that can be used as an alternative to the url
|
||||
* Tags can be set by users on link submissions, and links can be filtered by tag
|
||||
* A system by which content can be flagged by users for admin/moderators to check
|
||||
* User moderators for shows
|
||||
* An api for automation of link submission
|
||||
|
||||
See a detailed draft [here](https://docs.google.com/document/d/1VI-wDvCF-3qvyC7tVX0HwruII93UDUJvFjTIfrH4fZI/edit?usp=sharing)
|
||||
|
||||
## Installation
|
||||
0. Install prerequisites
|
||||
* [python3](https://www.python.org/)
|
||||
* [pip](https://pip.pypa.io/en/stable/installing/) (or manually install all python deps in the [requirements][requirements.txt] file)
|
||||
* Some kind of database server. Any kind [supported by Django](https://docs.djangoproject.com/en/1.11/ref/databases/) will work. You can use a third-party database as well, but you are responsible for [configuring Django](https://docs.djangoproject.com/en/1.11/ref/databases/#using-a-3rd-party-database-backend), and should not expect help from the community.
|
||||
* [gunicorn](http://gunicorn.org/) (for production)
|
||||
1. Clone the repository
|
||||
```
|
||||
$ git clone https://github.com/IcyNet/IcyNet.eu.git
|
||||
$ cd IcyNet.eu
|
||||
```
|
||||
2. Install requirements. If you're using pip (recomended), use
|
||||
```
|
||||
$ sudo pip install -r requirements.txt
|
||||
```
|
||||
if installing as root, or
|
||||
```
|
||||
$ pip install -r requirements.txt --user
|
||||
```
|
||||
if installing for your user only.
|
||||
3. If you're not using a full release, you'll need to generate the migration instructions. If you are using a full release, you can skip this step.
|
||||
```
|
||||
$ python3 manage.py makemigrations
|
||||
```
|
||||
4. Copy the config file, and make any needed changes
|
||||
```
|
||||
$ cp options_example.ini options.ini
|
||||
$ $EDITOR options.ini
|
||||
```
|
||||
5. Setup the database
|
||||
```
|
||||
$ python3 manage.py migrate
|
||||
```
|
||||
6. Run the server. For development purposes, you can use
|
||||
```
|
||||
$ python3 manage.py runserver
|
||||
```
|
||||
For production, run
|
||||
```
|
||||
$ gunicorn EpisodesCommunity.wsgi
|
||||
```
|
||||
## Contributing
|
||||
If you want to contribute, we'd love your help. You can get in contact with @LunaSquee or @Tsa6, or just start in on anything on the [issues list](https://github.com/IcyNet/Episodes.Community/issues) that hasn't already been assigned. We do ask that you follow the [GitHub Workflow](https://guides.github.com/introduction/flow/)
|
Reference in New Issue
Block a user