Switch branches/tags
x-tern-base v1.0 pre-dmr deploy-2018-02-06 deploy-2018-01-31 deploy-2018-01-24 deploy-2018-01-23 deploy-2018-01-18 deploy-2018-01-10 deploy-2018-01-03 deploy-2017-12-07 deploy-2017-11-22 deploy-2017-11-13 deploy-2017-11-13-2 deploy-2017-11-01 deploy-2017-10-17 deploy-2017-10-17-try2 deploy-2017-10-10 deploy-2017-09-27 deploy-2017-09-22 deploy-2017-09-22-2 deploy-2017-09-21 deploy-2017-09-21-2 deploy-2017-09-19 deploy-2017-09-18 deploy-2017-09-05 deploy-2017-09-01 deploy-2017-09-01-2 deploy-2017-08-10 deploy-2017-07-27 deploy-2017-07-16 deploy-2017-06-22 deploy-2017-06-22-2 deploy-2017-06-17 deploy-2017-06-16 deploy-2017-05-17 deploy-2017-05-03 deploy-2017-04-27 deploy-2017-04-17 deploy-2017-04-10 deploy-2017-04-03 deploy-2017-04-03-2 deploy-2017-03-30 deploy-2017-03-28 deploy-2017-03-22 deploy-2017-03-15 deploy-2017-03-09 deploy-2017-03-06 deploy-2017-03-03 deploy-2017-03-01 deploy-2017-02-22 deploy-2017-02-14 deploy-2017-01-31 deploy-2017-01-25 deploy-2017-01-13 deploy-2016-12-21 deploy-2016-11-29 deploy-2016-11-16 deploy-2016-11-16-2 deploy-2016-11-01 deploy-2016-10-27 deploy-2016-10-24 deploy-2016-10-21 deploy-2016-10-21-5 deploy-2016-10-21-2 deploy-2016-10-19 deploy-2016-10-14 deploy-2016-10-12 deploy-2016-10-11 deploy-2016-09-29 deploy-2016-09-28 deploy-2016-08-04 deploy-2016-08-03 deploy-2016-08-03-try2 deploy-2016-07-20 deploy-2016-07-06 deploy-2016-06-15 deploy-2016-06-07 deploy-2016-05-25 deploy-2016-05-24 deploy-2016-05-20 deploy-2016-05-19 deploy-2016-05-19-2 deploy-2016-05-12 deploy-2016-04-26 deploy-2016-04-20 deploy-2016-04-18 deploy-2016-04-15 deploy-2016-04-14 deploy-2016-04-13.2 deploy-2016-04-13 deploy-2016-04-07 deploy-2016-04-01 deploy-2016-03-30 1.1.9 1.1.7 1.1.6 1.0.1 0.9.12 0.9.11
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.docker Updating S3EnabledImageField to use django-storages Sep 18, 2018
.tx Re-implemented syncing translations Apr 18, 2016
amara-assets @ e5efdc4 Merge branch 'staging' into dev Sep 20, 2018
amara-enterprise @ 7c963f0 Updating submodules Sep 20, 2018
apps Another fix for search terms Sep 25, 2018
babelsubs @ f3cc473 Removing a few unneeded dev reqirements (#3322) Aug 27, 2018
bin Removing last bits of old boto code Sep 18, 2018
closure Remove unused compilation scripts. Jul 27, 2012
codeship Trying to fix commit.py Oct 18, 2017
css-compression Improved sphinx doc, moved deployment guide and running unisubs to th… Jul 30, 2011
deploy Removing last bits of old boto code Sep 18, 2018
docker-dev/mysql/conf.d Fix for searching against short words / stop words Dec 28, 2015
docs Removing last bits of old boto code Sep 18, 2018
guitests Removing last bits of celery code Aug 10, 2018
libs Started to separate dev/production requirements Aug 6, 2018
locale Updating translations May 24, 2018
media Fixed for button sizing on the embedder Sep 24, 2018
pykss @ f393d7b Updating submodules Nov 20, 2017
static try 137 Nov 29, 2012
templates Fixed typo in the comments template Sep 25, 2018
tests Fix for bracket chars in search terms (#3426) Sep 24, 2018
unilangs @ 5756f13 Updating submodules Sep 7, 2018
utils Fix for bracket chars in search terms (#3426) Sep 24, 2018
.ctags Add a .ctags file. Jan 18, 2012
.dockerignore Include settings_extra from amara-assets in the docker image Jun 14, 2018
.ffignore Ignore more files. Apr 9, 2013
.gitignore Added new image upload to the styleguide (#3334) Aug 15, 2018
.gitmodules Marking pages supporting work Nov 3, 2017
.ignore Renamed .agignore Dec 8, 2016
.jshintrc Add jshintrc Jan 1, 2013
.kick Working on new editor HTML and CSS. Dec 27, 2012
COPYING Added license file Mar 27, 2010
Dockerfile Prep work to upgrade django Sep 6, 2018
README.markdown Updating readme file Jan 18, 2018
README.transifex Changed all mirosubs references to unisubs. This also entails: Aug 23, 2011
__init__.py Changing our copyright year to 2013. Jan 3, 2013
checkout-submodules Use amara-assets for our static files Nov 6, 2017
codeship-services.yml Started to separate dev/production requirements Aug 6, 2018
codeship-steps.yml Started to separate dev/production requirements Aug 6, 2018
creds.encrypted Updating codeship steps Nov 10, 2017
crossdomain_views.py Added crossdomain views file for last commit. Apr 18, 2011
dev_settings.py Upgrading to django 1.8 Sep 6, 2018
dev_settings_test.py Removing last bits of celery code Aug 10, 2018
docker-compose.yml Upgrading to django-1.11 Sep 7, 2018
manage.py Prep work to upgrade django Sep 6, 2018
middleware.py Removed all debug_toolbar references Feb 13, 2018
optionalapps.py Upgrading to Django 1.9 Sep 6, 2018
schema.xml added fig local dev environment Jul 13, 2014
settings.py Updating S3EnabledImageField to use django-storages Sep 18, 2018
startup.py Removing last bits of celery code Aug 10, 2018
task_settings.py Upgrading to django 1.8 Sep 6, 2018
testacular.conf.js 2101: Use text() to replace a node's contents when we're exporting th… Feb 28, 2013
unisubs_settings.py Removing last bits of old boto code Sep 18, 2018
urls.py Upgrading to django-1.11 Sep 7, 2018
views.py Update mimetype attribute name Apr 3, 2018

README.markdown

This repository is the code for the Amara project.

The full documentation can be found at http://amara.readthedocs.org/en/latest/index.html

Quick Start

Amara uses Docker. For ease of development, we use the docker-compose tool to have a full, production like, local dev environment.

  1. Git clone the repository:

     git clone git://github.com/pculture/unisubs.git unisubs
    

    Now the entire project will be in the unisubs directory.

  2. Get submodules. There are two cases here:

    • For non-pcf employees, use the ./checkout-submodules public
    • For PCF employees and others with access to our private repositories, use the ./checkout-submodules all

Note: for either case, make sure that you have SSH access setup for github. (https://help.github.com/articles/connecting-to-github-with-ssh/)

  1. Install docker-compose (http://docs.docker.com/compose/install/)

  2. Build the Amara docker image:

     bin/dev build
    
  3. Configure Database:

     bin/dev dbreset
    
  4. Start Amara Containers:

     bin/dev up
    
  5. Add unisubs.example.com to your hosts file, pointing at 127.0.0.1. This is necessary for Twitter and Facebook oauth to work correctly.

    You can access the site at http://unisubs.example.com:8000.

To see services logs, run docker-compose logs <service> i.e. docker-compose logs worker

Testing

To run the test suite:

    bin/dev test

Dev Notes

To run a single manage.py command:

    bin/dev manage <command>

To see running services:

    docker-compose ps

To stop and remove all containers:

    docker-compose kill ; docker-compose rm

To view logs from a service:

    docker-compose logs <service>

To create an admin user:

    bin/dev manage createsuperuser