Skip to content
Python JavaScript HTML CSS
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.docker Use exec in our docker entrypoint
.tx fixed transifex config
apps Merge pull request #2460 from pculture/infrastructure
bin Fixed the dev bash command
closure Remove unused compilation scripts.
css-compression Improved sphinx doc, moved deployment guide and running unisubs to th…
deploy Pinning selenium version.
docker-dev/mysql/conf.d Fix for searching against short words / stop words
docs Removed raven
libs Removed blip.tv video type
locale Updated transifex translations -- through update_translations.sh
media yet some additional improvements in account confirmation page
optional Bumping version
static try 137
templates fixed typo in template
user-data Use a temp dir for MEDIA_ROOT during the tests.
utils Log users in request data
.agignore gitignore cleanup
.ctags Add a .ctags file.
.dockerignore Docker build update
.ffignore Ignore more files.
.gitignore gitignore cleanup
.jshintrc Add jshintrc
.kick Working on new editor HTML and CSS.
COPYING Added license file
Dockerfile Docker container fixes
README.markdown Updated docker-compose commands
README.transifex Changed all mirosubs references to unisubs. This also entails:
__init__.py Changing our copyright year to 2013.
crossdomain_views.py Added crossdomain views file for last commit.
dev_settings.py Added JSON logging output
dev_settings_test.py Updated test signals a bit
docker-compose.yml Simpler way to switch on JSON logging
initial_data.yaml there were two entries for site 15 so the wrong base url was returned…
manage.py Move startup code to 1 place (#1605)
middleware.py Updated error message in our logs
optionalapps.py Docker container fixes
schema.xml added fig local dev environment
sentry.dev.conf.py Upgrade sentry.
settings.py Merge pull request #2460 from pculture/infrastructure
sitemaps.py Fixed generating counts for the video sitemap
startup.py Docker container fixes
task_settings.py Changed way we keep the new video index updated
test_settings.py Removed haystack/solr code
testacular.conf.js 2101: Use text() to replace a node's contents when we're exporting th…
unisubs_settings.py Removed haystack/solr code
urls.py Merge pull request #2460 from pculture/infrastructure
views.py Log errors to elasticsearch

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. Install docker-compose (http://docs.docker.com/compose/install/)

  3. Build the Amara docker image:

    bin/dev build
    
  4. Start Amara Containers:

    bin/dev up
    
  5. Configure Database:

    bin/dev dbreset
    
  6. 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/test.sh

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:

    docker-compose run --rm app python manage.py createsuperuser --settings=dev_settings
Something went wrong with that request. Please try again.