-
Notifications
You must be signed in to change notification settings - Fork 11
/
README
116 lines (89 loc) · 3.57 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
This is the code for CHIRP's internal web applications. The apps run
on Google App Engine, under the 'chirpradio' project. The source code is
hosted on Google Code, also under the 'chirpradio' project.
This code is covered by the Apache License, version 2.0 and is
copyrighted by the Chicago Indepedent Radio Project. For the details of
the Apache License, see:
http://www.apache.org/licenses/LICENSE-2.0.html
For the chirpradio developer dashboard, go to:
http://appengine.google.com/dashboard?&app_id=chirpradio
For the end-user landing page, go to:
http://chirpradio.appspot.com/
For the Google Code project:
http://code.google.com/p/chirpradio
Helpful external documentation:
* App Engine Python API
http://code.google.com/appengine/docs/python/
* Django 1.0:
http://www.djangobook.com/en/2.0/
Be sure you are looking at the right version of the book! We are using
version 1.0 of Django, which is covered by (confusing enough) version 2.0
of the Django book.
* Mercurial
http://hgbook.red-bean.com/
OVERVIEW OF THE TREE
====================
There are part of the common infrastructure.
docs/
Documentation.
djzango.zip
Django 1.0.2-final, zipped up. We never want to change this.
appengine_django/
From google-app-engine-django, AppEngine helper & glue code.
common/
Code & data shared by all apps.
django-extras/
A tree that is merged into the django namespace. We put our own
glue code here. This should be kept small and simple.
__init__.py
main.py
manage.py
Launchers for Django.
settings.py
Global configuration for Django.
urls.py
Main URL file.
auth/
Our own custom authentication & account management system.
media/common/css/
Stylesheets common to multiple apps.
media/common/img/
Images common to multiple apps.
media/common/js/
JavaScripts common to multiple apps, organized by sub directory.
media/common/js/chirp/
CHIRP-related JavaScripts that are common to multiple applications.
media/common/js/[package_name]
Common external JavaScript packages (like JQuery) would go here.
Note that since jQuery plugins are generally external to jQuery itself
they should live in their own subdirectory.
These are places where all applications store data.
media/[application name]/{js, css, img}/
templates/[application name]/
These are applications that are running in production.
(None so far)
These are applications that are under development.
landing_page/
Where you end up when you go to "/". Currently a test page.
THIRD-PARTY CODE
================
* google-app-engine-django
Some of the files in this directory and all of files under the
appengine_django/ subdirectory are based on rev 81 of the
google-app-engine-django Subversion repository.
* Django
All files in django.zip are taken from Django 1.0.2-final. It was
constructed by running the following commands:
zip -r django.zip django/__init__.py django/bin django/core \
django/db django/dispatch django/forms \
django/http django/middleware django/shortcuts \
django/template django/templatetags \
django/test django/utils django/views
zip -r django.zip django/conf -x 'django/conf/locale/*'
These commands were taken from
http://code.google.com/appengine/articles/django10_zipimport.html
Some of the CSS files media/common/css are based on files that
were copied from django/contrib/admin/media/css.
* jQuery
The code under media/ext_js/jquery-* is part of the jQuery library
(http://www.jquery.com) and is covered by the MIT license.