Commits

Dmitri Lebedev committed 4b8e4fe

updated readmes

Comments (0)

Files changed (2)

  - rubygems (for Sass)
  - libxml-dev, libxslt-dev
  - Database of your choice
+ - Java Runtime (without JDK/GUI)
 
-How to install these libraries in Ubuntu:
+Install these libraries in Ubuntu with this command:
 
-    sudo apt-get install libxslt-dev python-dev rubygems
+    sudo apt-get install libxslt-dev python-dev libpq-dev rubygems make openjdk-6-jre-headless --no-install-recommends
 
 All the other packages are bundled in the buildout script.
 
     rm yourproject/.hg/hgrc
 
 If you want to use **CoffeeScript**, read section "CoffeeScript" below.
-    
+
 
 Usage
 =====
 It's a script, assembled by buildout, that connects the project environment
 packages.
 
+Database
+--------
 
+While developing, you may need to quickly recreate the database from scratch and
+reload fixtures. Fastdev-django has a command for this:
 
+    make rebuilddb
+
+It will drop the db and run syncdb again.
 
 
 Packages
 ========
 
- - **bootstrap.py**
+bootstrap.py
+------------
 
 Installs zc.buildout script.
 
 
- - **IPython and django-extensions**
+IPython and django-extensions
+-----------------------------
 
 A better Python shell with code completion and scripting. The extensions package
 adds `shell_plus` command that runs IPython. There's a shortcut for it:
     make shell_plus
 
 
- - **PuDB**
+PuDB
+----
 
 A debugging environment for Python, which looks like the good old QBasic or
 Borland IDEs from the '80-s.
     import pudb; pudb.set_trace()
 
 
- - **django-debug-toolbar**
+Debug Toolbar
+-------------
 
 A toolbar that is embed into pages that shows you the list of rendered templates
 and their contexts. Enable its middleware and see a clickable label on the right
 in pages.
 
 
- - **HamlPy**
+Haml
+----
 
 An elegant markup language that transforms into HTML. HamlPy implements HAML and
 a similar notation for Django template language:
         .footer
             - trans 'See you'
 
- - **Django Compressor and Sass**
+Django Compressor and Sass
+--------------------------
 
 Compressor can be used to transform and compress CSS and JS on the fly. Here it
 is used to convert SASS stylesheets in valid CSS. Usage (Haml notation):
 A **not included** feature: it can parse `script` tags in the page, open the JS
 files, minify them and pack into one single file.
 
- - **CoffeeScript**
+CoffeeScript
+------------
 
 If you want to use CoffeeScript, do the following:
 
 CoffeeScript. Buildout will install them automatically. This makes it easier
 to deploy in web hosting.
 
- - **Webfaction**
+WSGI
+----
 
-To make a WSGI script for Webfaction hosting, run
+In the `bin` folder, `<settings name>.wsgi` script will be created. (django and
+prod, as in buildout.cfg.) Connect your Apache or Nginx to this wsgi file.
 
-    make webfaction
-
-In the project root the `<project name>.wsgi` script will be created. (Project
-name is set in buildout.cfg.)
-
-Updated packages in buildout.cfg? Just do `make webfaction` again. Make will see
-that Django has to be re-installed with Buildout.
-
+To update WSGI script (after adding packages to buildout.cfg), just run
+`make bin/django`.
 
   [1]: http://obnob.com/
   [2]: http://aatiis.me/
 
 Как установить Ruby и другие библиотеки в Ubuntu:
 
-    sudo apt-get install libxslt-dev python-dev rubygems
+    sudo apt-get install libxslt-dev python-dev libpq-dev rubygems make openjdk-6-jre-headless --no-install-recommends
 
 Установка
-============
+=========
 
 Склонируйте проект:
 
 Если вам нужен **CoffeeScript**, прочтите параграф "CoffeeScript" ниже.
 
 Использование
-=====
+=============
 
     make run
 
 окружения проекта.
 
 Пакеты
-========
+======
 
- - **bootstrap.py**
+bootstrap.py
+------------
 
 Устанавливает скрипт zc.buildout.
 
 
- - **IPython и django-extensions**
+IPython и django-extensions
+---------------------------
 
 Улучшенная консоль Питона с автозавершением кода и макросами. Пакет extensions
 добавляет в Джанго команду `shell_plus`, которая автоматически загружает модели
     $ make shell_plus
 
 
- - **PuDB**
+PuDB
+----
 
 Среда отладки Питона, выглядящая как старые добрые QBasic или программы
 Борланда 80-х годов.
     import pudb; pudb.set_trace()
 
 
- - **django-debug-toolbar**
+Панель отладки
+--------------
 
 Панель отладки, которая вствляется прямо в страницу. Справа вверху в странице
 появится кнопка, открывающая панель. В панели вы увидите статистику генерации
 страницы, список использованных шаблонов и их контексты.
 
 
- - **HamlPy**
+Haml
+----
 
 Лаконичная разметка, которая превращается в HTML. С файлами HAML намного проще
 работать и программисту, и верстальщику. HamlPy — это реализация HAML на Питоне,
         .footer
             - trans 'Пока'
 
- - **Django Compressor и Sass**
+Django Compressor и Sass
+------------------------
 
 Compressor — модуль для сжатия на лету CSS и ЯваСкрипта из страниц. Здесь он
 пока используется только для преобразования таблиц на языке SASS в корректную
 теги `script` в странице, открыть файлы скриптов, уплотнить их и сжать в один
 файл.
 
- - **CoffeeScript**
+CoffeeScript
+------------
 
 Если вы хотите использовать CoffeeScript, сделайте следующее:
 
 CoffeeScript. Программа Buildout установит их автоматически. Это удобно,
 когда нужно развернуть проект на хостинге.
 
- - **Webfaction**
+WSGI
+----
 
-Чтобы запустить ваш проект на хостинге Webfaction, нужно сделать специальный
-скрипт WSGI. Запустите команду
+В папке `bin` автоматически создаются скрипты WSGI для настроек разработки и
+рабочих: `bin/django.wsgi` и `bin/prod.wsgi` соответственно. Подключите ваш
+сервер Apache или Nginx к ним.
 
-    make webfaction
-
-в корне проекта появится файл `<имя проекта>.wsgi` (имя проекта задаётся в
-buildout.cfg). Изменили пакеты в buildout.cfg? Просто запустите снова
-`make webfaction`.
+Если вы изменили пакеты в buildout.cfg, и нужно подключить их к скрипту, просто
+запустите снова `make bin/django`.
 
   [1]: http://obnob.com/
   [2]: http://aatiis.me/