Skip to content

Latest commit

 

History

History
93 lines (59 loc) · 2.94 KB

readme.md

File metadata and controls

93 lines (59 loc) · 2.94 KB

About

Tristano is a generic, ready-to-extend, responsive Django + Angular site based on:

  • Twitter Bootstrap (CSS grid and UI widgets)
  • AngularJS
  • Django REST Framework (API generation)
  • Django-AllAuth (for social network logins)
  • Django Extensions
  • Editable public profiles (via Markdown)
  • Asset pipeline (compression and minification) via django-compressor
  • Samples of list and detail views via both Django CBVs and Angular
  • Sample API representations

Tristano is not intended to be installed as a reusable Django app. Instead, start a new project with it, rename, remove the git history, add it to a new repo, and start tweaking.

postgres and a clean virtualenv are assumed, but season to taste.

Installing

[create blank database `tristano` or other]
pip install -r requirements.txt
pip install psycopg2
cd requirements
bower install
mv local_settings.sample.py local_settings.py and tweak as needed
./manage.py migrate

Because apps are kept in the apps directory rather than in the project root, you'll need to add its path to your virtualenv:

cd apps
pwd [copy path to clipboard]
add2virtualenv [paste]

Rename the project directory to match the name of your current project and fix references to it in settings.

Via /admin, add a Site record for localhost.

Add at least one social network via Social Apps.

Static File Management

bower install installs apps to static/bower_components, including bootstrap and angular

Our own scss and js lives in static

In static/styles/sass/app.scss we import selective bower-installed bootstrap components, then override with our own styles and settings, which live in the same dir.

Compass compiles our custom scss from static/styles/sass to static/styles/css

Thus, generated styles/css/app.css includes all of bootstrap plus our overrides.

To compile, use: cd tristano; compass compile

Compass will use the input and output settings listed in config.rb.

Or, take advantage of the included config.rb by opening a 2nd terminal and running (from the main directory): compass watch

In dev mode, we serve directly out of static.

In production, collectstatic copies all of this plus media included with installed apps over to static_apps, which is where everything gets served from.

Test django-compressor's minification by setting

COMPRESS_ENABLED = True

in local_settings.py and then viewing source.

API

A simple books API (meant to be changed to whatever app/model you're building) is demonstrated via django-rest-framework with the sampledata app. Enter a few books, then access /api/books for the demo. Append ?format=json to any REST URL for raw data.

Testing

Basic unit tests are included for bundled sample apps. Since these live in the apps directory, you'll need to specify that dir in the test runner:

./manage.py test -v2 project/apps

Versions

v1.1: Demonstrates list and detail views both via CBV (Django) and Angular

v1.0: Initial release