Commits

Dmitri Lebedev committed fa0976d

updated wiki for coffeescript

Comments (0)

Files changed (2)

 
 == Установка ==
 
-Склонируйте проект:
+Склонируйте проект и удалите связь с репозиторием fastdev:
 
 {{{
 #!bash
     hg clone https://hg.bitbucket.org/siberiano/fastdev-django
-}}}    
-Если проект будет жить самостоятельно, удалите связь с репозиторием fastdev:
-{{{
-#!bash
     rm yourproject/.hg/hgrc
 }}}
-Если вы хотите участовать в проекте fastdjango, не делайте этого.
+
+Чтобы использовать CoffeeScript, выполните инструкции из [[#CoffeeScript|этого
+раздела]].
 
 == Использование ==
 {{{
 теги {{{script}}} в странице, открыть файлы скриптов, уплотнить их и сжать в один
 файл.
 
+=== CoffeeScript ===
+
+Если вы хотите использовать CoffeeScript, сделайте следующее:
+
+* откройте Makefile и раскомментируйте строку {{{run: bin/coffee}}}
+* установите {{{USE_COFFEE_SCRIPT = True}}} в файле settings.py
+* если у вас ОС Ubuntu, проверьте, что установлена программа curl (по
+ умолчанию её нет):
+
+{{{
+#!bash
+    sudo apt-get install curl
+}}}
+
+Вам **НЕ НУЖНЫ** ни [[http://nodejs.org/|Node.js]], ни [[http://npmjs.org/|npm]],
+чтобы проект запустил CoffeeScript. Программа Buildout установит их
+автоматически. Это удобно, когда нужно развернуть проект на хостинге.
+
 === Webfaction ===
 
 Чтобы запустить ваш проект на хостинге Webfaction, нужно сделать специальный
 
 == Installation ==
 
-Clone the project:
+Clone the project and disconnect from this repo:
 
 {{{
 #!bash
     hg clone https://hg.bitbucket.org/siberiano/fastdev-django yourproject
-}}}
-
-If you want to develop your own project, disconnect it from my repo:
-
-{{{
-#!bash
     rm yourproject/.hg/hgrc
 }}}
 
-If you want to contribute to fastdev, then don't.
+See also instructions for [[#CoffeeScript|CoffeeScript]].
 
 == Usage ==
 
 
 * Python 2.5+
 * Ruby 1.8+ (for Sass)
-* SQLite 3 or any database of choice
+* A database of choice
 
 All the other packages are bundled in the buildout script.
 
 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 ===
+
+If you want to use CoffeeScript, do the following:
+
+* edit Makefile and uncomment the line {{{run: bin/coffee}}}
+* set {{{USE_COFFEE_SCRIPT = True}}} in settings.py
+* if you use Ubuntu, make sure curl is installed (by default it is not):
+
+{{{
+#!bash
+    sudo apt-get install curl
+
+You **DON'T NEED** [[http://nodejs.org/|Node.js]], nor [[http://npmjs.org/|npm]]
+ for this project to run CoffeeScript. Buildout will install them
+ automatically. This makes it easier to deploy in web hosting.
+
 === Webfaction ===
 
 To make a WSGI script for Webfaction hosting, run