##// END OF EJS Templates
docs: adding grunt info
lisaq -
r304:85646c29 default
parent child
Show More
@@ -12,19 +12,21 Templates
12 =========
12 =========
13
13
14 - Indent with 4 spaces in general.
14 - Indent with 4 spaces in general.
15
16 - Embedded Python code follows the same conventions as in the backend.
15 - Embedded Python code follows the same conventions as in the backend.
17
16
18 A common problem are missed spaces around operators.
17 A common problem is missed spaces around operators.
19
18
20
19
21
20
22
21
23 Grunt AND npm2nix
22 Grunt
24 =================
23 =====
25
24
26
25 We use Grunt to compile our JavaScript and LESS files. This is done automatically
27 ---something goes here ---
26 when you start an instance. If you are changing these files, however, it is
27 recommended to amend `--reload` to the `runserver` command, or use `grunt watch`
28 - the Gruntfile is located in the base directory. For more info on Grunt, see
29 http://gruntjs.com/
28
30
29
31
30
32
@@ -37,8 +39,7 Style
37 -----
39 -----
38
40
39 - Use 4 spaces instead of tabs.
41 - Use 4 spaces instead of tabs.
40
42 - Avoid ``!important``; it is very often an indicator for a problem.
41 - Avoid ``!important``, it is very often an indicator for a problem.
42
43
43
44
44
45
@@ -47,7 +48,7 Structure
47 ---------
48 ---------
48
49
49 It is important that we maintain consistency in the LESS files so that things
50 It is important that we maintain consistency in the LESS files so that things
50 scale properly. CSS is organized using LESS and then compiled into a css file
51 scale properly. CSS is organized using LESS and then compiled into a CSS file
51 to be used in production. Find the class you need to change and change it
52 to be used in production. Find the class you need to change and change it
52 there. Do not add overriding styles at the end of the file. The LESS file will
53 there. Do not add overriding styles at the end of the file. The LESS file will
53 be minified; use plenty of spacing and comments for readability.
54 be minified; use plenty of spacing and comments for readability.
General Comments 0
You need to be logged in to leave comments. Login now