Skip to content

Commit bff9f00

Browse files
committed
update docs
1 parent c9838fc commit bff9f00

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

docs/source/install.rst

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -121,16 +121,9 @@ Whichever database type you chose, now it's time to run migrations::
121121

122122
$ ./manage.py migrate
123123

124-
To compile and compress static media, you will need *compass* and
125-
*yui-compressor*::
124+
To compile SCSS, you will need *sass-dart*::
126125

127-
$ gem install bundler
128-
$ bundle install
129-
130-
.. note::
131-
132-
To install *yui-compressor*, use your OS's package manager or download it
133-
directly then add the executable to your ``PATH``.
126+
$ npm install
134127

135128
To create initial data for the most used applications, run::
136129

@@ -156,15 +149,24 @@ settings in ``pydotorg/settings/local.py`` to your local ElasticSearch server.
156149
.. _Elasticsearch: https://www.elastic.co/downloads/elasticsearch
157150

158151

152+
Compiling SCSS files to CSS
153+
---------------------------
154+
155+
For frontend work, SCSS files should be compiled to CSS before committing.
156+
157+
After installing *sass-dart* via NPM::
158+
159+
$ PATH=$(npm bin):$PATH sass -I static/vendor/compass -I static/vendor/susy static/sass
160+
161+
159162
Generating CSS files automatically
160163
----------------------------------
161164

162165
Due to performance issues of django-pipeline_, we are using a dummy compiler
163166
``pydotorg.compilers.DummySASSCompiler`` in development mode. To generate CSS
164167
files, use ``sass`` itself in a separate terminal window::
165168

166-
$ cd static
167-
$ sass --compass --scss -I $(dirname $(dirname $(gem which susy))) --trace --watch sass/style.scss:sass/style.css
169+
$ PATH=$(npm bin):$PATH sass -w -I static/vendor/compass -I static/vendor/susy static/sass
168170

169171
.. _django-pipeline: https://github.com/cyberdelia/django-pipeline/issues/313
170172

0 commit comments

Comments
 (0)