Skip to content
Snippets Groups Projects
Commit 365338ca authored by Yannis Barlas's avatar Yannis Barlas
Browse files

Merge branch 'delete-env-files' into 'staging'

Delete env files

See merge request !82
parents b1e0ae56 9220e4c7
No related branches found
Tags 1.0.0
No related merge requests found
## Make sure you connect to a valid ink instance to get word to html conversions
# INK_ENDPOINT='http://ink-api.coko.foundation'
# INK_USERNAME='email@provider.com'
# INK_PASSWORD='password'
File moved
......@@ -2,13 +2,11 @@
Editoria is a book production platform, built with [Pubsweet](https://gitlab.coko.foundation/pubsweet/) and [Substance](http://substance.io/).
This application is being developed by the [Coko Foundation](https://coko.foundation/), for the [University of California Press](http://www.ucpress.edu/).
<br>
## Requirements
Node >= 7.6
npm >= 3
<br>
## Installation
......@@ -16,46 +14,41 @@ First you need to clone this repository on your machine.
```git clone git@gitlab.coko.foundation:editoria/editoria.git```
or the ```https``` equivalent:
```git clone https://gitlab.coko.foundation/editoria/editoria.git```
<br>
Once you have, navigate to the project's root directory.
```cd editoria```
<br>
This application requires node 7.6 or greater.
If you use nvm for managing different node versions, the project includes an ```.nvmrc``` file that you can take advantage of.
The application has been tested with node 7.9 .
<br>
Install the project's dependencies.
```npm install```
<br>
Create a database.
```npm run setupdb```
Follow the instructions, create the administrator user and name your first book.
<br>
Editoria uses [INK](https://gitlab.coko.foundation/INK/ink-api) in order to convert word files into our custom variant of HTML, [Editoria Typescript](https://gitlab.coko.foundation/XSweet/editoria_typescript).
For this to work, you need a valid username and password for a running INK instance on a server.
To use these credentials in Editoria, you need to pass the `INK_USERNAME` and `INK_PASSWORD` environment variables in the `.env.production` file in the project's root directory, as well as the `INK_ENDPOINT` environment variable that will point to the running INK instance.
To use these credentials in Editoria, you need to pass the app three enviroment variables, namely `INK_ENDPOINT`, `INK_USERNAME` and `INK_PASSWORD`.
You can pass those in the `.env.production` or `.env.dev` files that you'll find in the project's root directory.
Please note that these files will be generated automatically the first time you run the `setupdb` command for a production or development database respectively.
You'll find a sample configuration in the [.env.sample]() file in the root directory.
<!--- We provide default valid credentials already for demo purposes on our own INK instance. --->
<!--- If you simply want to try this out, you can uncomment the `INK_USERNAME`, `INK_PASSWORD` and `INK_ENDPOINT` environment variables in the `.env.production` file. --->
<br>
Once that is done, you can run the app like so:
```npm start```
<br>
## Set up
Log in as an administrator, and click on the "Teams" link in the navigation bar.
<br>
You can now assign different users to different roles.
If a user is a production editor, the user can then also edit user roles for all other users.
<br>
You're good to go!
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment