forked from mateuszkocz/3l
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
93 lines (55 loc) · 4.47 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
3L was made for YOU to help you create awesome websites
and fill the Internet with excessive amount of Love! ♥
Keep up your good work!
Yours faithfully,
Mateusz ★ Kocz -> http://radiatingstar.com
3L: -> http://mateuszkocz.github.com/3l
Watch 3L on Github: -> https://github.com/mateuszkocz/3l
Submit a bug issue: -> https://github.com/mateuszkocz/3l/issues?state=open
Download .zip: -> https://github.com/downloads/mateuszkocz/3l/3l-v1.3.3.zip
Licensed under the Apache License v2.0
http://www.apache.org/licenses/LICENSE-2.0
Version: 1.3.3 (2012.09.09)
LESS version: 1.3.0 (included in 3l's .zip)
Get your own LESS.js: -> http://lesscss.org/
==========================================
HOW TO USE
Inside the .zip file you have:
my-style.less – here you'll be writing you code,
3L-mini.less – the basic file with mixins,
3L-maxi.less – mixins with documentation and examples,
less.js – the newest, compatible with 3L version of LESS.js,
animations.less – mixins required for declaring @keyframes,
bootstrap – files to be replaced in Bootstrap's less directory in order to use 3L together with Bootstrap.
Copy my-style.less, 3L-mini.less and less.js into the folder with your project. Place the code below in the <head> section of your .html file.
<link rel="stylesheet/less" type="text/css" href="my-style.less" />
<script src="less.js" type="text/javascript"></script>
You can now start writing your own style in my-style.less. Check out the documentation for class names available to use and make your code awesome!
==========================================
ANIMATIONS
Using animations with 3L is pretty easy. Copy the animations less files (animationX.less) to the folder where you have your style sheet. In your code just type @import "animation1" (or any other number), create a class .animation1 (or any other) and declare your animation. 3L will make @keyframes for you. Now just use this animation in any element you want with .animation() class.
@import "animation1";
.animation1 () {
/* your @keyframes rules */
}
.someClassName {
.animation(.animation1 1s);
}
==========================================
How to make 3L compatible with Bootstrap?
It's easy! First you need to download pre-compiled Bootstrap (tested on v.2.0.2) with LESS files. Get it here -> https://github.com/twitter/bootstrap/ and unzip it. Then, in your downloaded 3L folder, you have a bootstrap folder with 2 files: bootstrap.less and mixins.less. Replace Bootstrap's original files in less folder with those two. After that just copy and paste 3l-mini.less (and all animations if you wish to use them) to the Bootstrap's less folder and create some awesome website!
**********
Where are my grids?
3L doesn't have a grid system implemented. It is not meant to have any style included. Of course grids are cool so create yours with Gridpak —> http://gridpak.com/ . Gridpak gives you a responsive grid in LESS file so you can use it together with 3L.
**********
Compiler I use fail to compile 3L!
Unfortunately not all compilers can deal with some of the 3L classes. The hardest to compile are opacity in percentages (it uses a small piece of JavaSript), keyframes and guarded mixins. I strongly encourage you to use WinLess (also the online version) as it works very well with all 3L classes.
If you're on a Mac and compiler you use was able to deal with all the issues stated above, please, let me know (mateusz@radiatingstar.com)!
Other solution would be to delete the option to declare opacity in percentages (it's the biggest class in opacity block in 3L.less file and uses JavaScript). If it still doesn't help, you seriously need to consider getting a better compiler compatible with all LESS functionality!
**********
I've found a bug (in your English)
That's great! Please, submit an issue via GitHub, so I'll get it fixed ASAP. -> https://github.com/mateuszkocz/3l/issues?state=open
If you find an error in language — be it on this website or in 3L's documentation — do not hesitate to also point that out! 3L is learning English very hard!
**********
After compilation I have many comments in my style sheet
The reason is that you're using 3L-maxi.less that has documentation included. Your compiler leaves the comments intact. Solution is pretty easy — use either 3L-mini.less (if you use my-style.less 3L-mini is the default) or minify your CSS. Actually you should always minify CSS files so even if you were using 3L-maxi.less, those comments will be deleted eventually.