Source

eagcms / docs / tutorial.rst

Tutorial

Intro

EAG cms is as simple as possible CMS for Google App Engine (GAE) and Django

EAG cms yra sukurtas naudojantis Google App Engine (GAE) ir Django bibliotekomis. Taigi, aš primigtinai rekomenduočiau pirma susipažinti su pastarųjų dokumentacija (Žinoma, jeigu dar nesate susipažinęs):

Google App Engine Docs

Django Docs

Getting started

EAG cms yra visiškai priklausomas nuo GAE. Taigi, vienintelis būdas jį publikuoti yra publikuoti kaip GAE aplikaciją.

Bet mums nereikia nieko publikuoti - dabar mes tiesiog norime pasileisti pačią aplikaciją ir testuoti ją namuose - localhost'e. Bent jau aš darau tokią prielaidą, kad jūs to norite...

Prepare dev enviroment

Visos žemiau pateiktos komandos testuotos tik linux OS. Tuo tarpu Windows ir/ar Mac OS savininkų teks atsiprašyti - aš neturi priėjimo prie pastarųjų OS. Bet jums yra pasiekiamas GAE SDK GUI. Peržvelgę linux komandas ir pridėję sveiką nuovoką, manau, turėtumėte išsisukti.

Parsisiųskite GAE SDK. Išarchyvuokite jį į pasirinktą katalogą. Užeikite į direktoriją.:

wget http://googleappengine.googlecode.com/files/google_appengine_<last-version>.zip
unzip google_appengine_<last-version>.zip
cd google_appengine/

Django siuntimą galite praleisti, jeigu jį jau esate instaliavę ir jis yra pasiekiamas PYTHON_PATH kintamajame. SVARBU: jums reikalinga django 1.1.* versija!

Parsisiųskite Django 1.1. Išarchyvuokite jį į tą patį katalogą ir padarykite taip, kad anas būtų pasiekiamas iš GAE SDK.:

wget http://media.djangoproject.com/releases/1.1.1/Django-1.1.1.tar.gz
tar zxf Django-1.1.1.tar.gz
mv Django-1.1.1/django/ ./
rm -r Django-1.1.1

Parsisiųskite EAG cms versiją. Išskleiskite ją į katalogą projects/eagcms.:

mkdir -p projects
wget TODO
tar zxf TODO projects/eagcms

Pervadinkite main.py.sample į main.py Pervadinkite eagproject/settings.py.sample į eagproject/settings.py:

mv projects/eagcms/main.py.sample projects/eagcms/main.py
mv projects/eagcms/eagproject/settings.py.sample projects/eagcms/eagproject/settings.py.sample

Paleiskite testinę aplinką:

./dev_appserver.py projects/eagcms

Pagal nutylėjimą administratoriaus pultas bus pasiekiamas adresu http://localhost:8080/admin, o frontend'as http://localhost:8080/site.

Rekomenduoju pasiskaityti Čia.

Admin Interface

TODO

Django setting.py variables

EAG cms needs you to define some options in standard Django's settings module.

ADMINS

Actually it is Django's standard settings' variable, but in EAG cms it is used to define additional users that are allowed to edit content.

All users that are assigned as Yours app's administrators in appspots are allowed to edit content anyway - so You do not need to add them to ADMINS settings' var:

ADMINS = (
    ('Default', 'test@example.com'),
)

EAGCMS_TYPES

modules list where EAG page types are defined.:

EAGCMS_TYPES = (
    'eagtypes',
)

See see :ref:`tut-eagtypes-concept` to find out more about page types.

EAGCMS_PICASA_USER

Optional. Picasa Web user's name which public galleries are used to retrieve images for EAG cms wysiwyg and image widget (:ref:`PicasaWidget <class-picasa-widget>`):

EAGCMS_PICASA_USER = 'some-user-name'

EAG Types concept

TODO

Customizing look and feel

TODO

Fictional Django app integration (Advanced topic)

TODO

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.