picasso 0.0.2 → 0.0.3

Sign up to get free protection for your applications and to get access to all the features.
data/docs/bubbles.html CHANGED
@@ -1,10 +1,13 @@
1
- <!doctype html>
2
- <html>
1
+ <!DOCTYPE html>
2
+ <!--[if IE 7]> <html class="ie7"> <![endif]-->
3
+ <!--[if IE 8]> <html class="ie8"> <![endif]-->
4
+ <!--[if IE 9]> <html class="ie9"> <![endif]-->
5
+ <!--[if gt IE 9]><!--> <html> <!--<![endif]-->
3
6
 
4
7
  <head>
5
8
  <meta charset="utf-8">
6
9
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
7
- <title>Picasso Docs</title>
10
+ <title>Picasso. Framework CSS/Sass.</title>
8
11
 
9
12
  <link type="text/css" rel="stylesheet" href="./css/markdown.css">
10
13
  <link type="text/css" rel="stylesheet" href="./css/github.css">
@@ -14,67 +17,123 @@
14
17
  <body>
15
18
 
16
19
 
20
+ <header>
21
+ <h1>Picasso. Framework CSS/Sass.</h1>
22
+ </header>
23
+
24
+
25
+
26
+
27
+ <hr>
28
+
29
+ <h2>Contenidos</h2>
30
+
31
+ <aside>
32
+ <nav>
33
+ <ol>
34
+
35
+ <li>
36
+ <a href="./intro.html#introduccioacuten">Introducci&amp;oacute;n</a>
37
+
38
+ <ol>
39
+
40
+ <li><a href="./intro.html#repositorio">Repositorio</a></li>
41
+
42
+ <li><a href="./intro.html#instalacioacuten">Instalaci&amp;oacute;n</a></li>
43
+
44
+ <li><a href="./intro.html#actualizacioacuten">Actualizaci&amp;oacute;n</a></li>
45
+
46
+ </ol>
47
+
48
+ </li>
49
+
50
+ <li>
51
+ <a href="./changelog.html#changelog">Changelog</a>
52
+
53
+ <ol>
54
+
55
+ <li><a href="./changelog.html#003">0.0.3</a></li>
56
+
57
+ <li><a href="./changelog.html#002">0.0.2</a></li>
58
+
59
+ <li><a href="./changelog.html#001">0.0.1</a></li>
60
+
61
+ </ol>
62
+
63
+ </li>
64
+
65
+ <li>
66
+ <a href="./todo.html#todo">Todo</a>
67
+
68
+ <ol>
69
+
70
+ </ol>
71
+
72
+ </li>
73
+
74
+ <li>
75
+ <a href="./docs.html#generar-la-documentacioacuten">Generar la documentaci&amp;oacute;n</a>
76
+
77
+ <ol>
78
+
79
+ </ol>
80
+
81
+ </li>
82
+
83
+ <li>
84
+ <a href="./components.html#components">Components</a>
85
+
86
+ <ol>
87
+
88
+ <li><a href="./buttons.html#buttons">Buttons</a></li>
89
+
90
+ <li><a href="./buttons.html#mini-buttons">Mini-Buttons</a></li>
91
+
92
+ <li><a href="./arrows.html#arrows">Arrows</a></li>
93
+
94
+ <li><a href="./bubbles.html#bubbles">Bubbles</a></li>
95
+
96
+ <li><a href="./ie.html#internet-explorer">Internet Explorer</a></li>
97
+
98
+ </ol>
99
+
100
+ </li>
101
+
102
+ <li>
103
+ <a href="./utils.html#utils">Utils</a>
104
+
105
+ <ol>
106
+
107
+ <li><a href="./utils.html#clearfix">Clearfix</a></li>
108
+
109
+ </ol>
110
+
111
+ </li>
112
+
113
+ <li>
114
+ <a href="./despegar.html#despegar">Despegar</a>
115
+
116
+ <ol>
117
+
118
+ <li><a href="./despegar.html#variables">Variables</a></li>
119
+
120
+ </ol>
121
+
122
+ </li>
123
+
124
+ </ol>
125
+ </nav>
126
+ </aside>
17
127
 
18
128
 
19
- <aside>
20
- <nav>
21
- <ol>
22
-
23
- <li>
24
- <a href="./intro.html#picasso-framework-css-sass">Picasso. Framework CSS/Sass.</a>
25
-
26
- <ol>
27
-
28
- </ol>
29
-
30
- </li>
31
-
32
- <li>
33
- <a href="./components.html#components">Components</a>
34
-
35
- <ol>
36
-
37
- <li><a href="./buttons.html#buttons">Buttons</a></li>
38
-
39
- <li><a href="./buttons.html#mini-buttons">Mini-Buttons</a></li>
40
-
41
- <li><a href="./arrows.html#arrows">Arrows</a></li>
42
-
43
- <li><a href="./bubbles.html#bubbles">Bubbles</a></li>
44
-
45
- </ol>
46
-
47
- </li>
48
-
49
- <li>
50
- <a href="./utils.html#utils">Utils</a>
51
-
52
- <ol>
53
-
54
- <li><a href="./utils.html#clearfix">Clearfix</a></li>
55
-
56
- </ol>
57
-
58
- </li>
59
-
60
- <li>
61
- <a href="./despegar.html#despegar">Despegar</a>
62
-
63
- <ol>
64
-
65
- <li><a href="./despegar.html#variables">Variables</a></li>
66
-
67
- </ol>
68
-
69
- </li>
70
-
71
- </ol>
72
- </nav>
73
- </aside>
74
-
75
-
76
- <article>
129
+
130
+ <hr>
131
+
132
+ <article>
77
133
  <a name="bubbles"></a><h2>Bubbles</h2>
134
+ <p>Ideales para mostrar comentarios de clientes.
135
+
136
+ </p>
78
137
  <a name="ejemplos"></a><h3>Ejemplos</h3>
79
138
  <div class="bubble-demo-1">
80
139
  <blockquote>
@@ -113,11 +172,9 @@
113
172
 
114
173
 
115
174
  <footer>
116
- <a href="./all.html">Everything on a single page</a>
117
-
118
175
  </footer>
119
176
 
120
- <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
177
+ <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
121
178
  <script src="./js/docs.js"></script>
122
179
  <script src="./js/rainbow-custom.min.js"></script>
123
180
 
@@ -1,4 +1,4 @@
1
1
  {
2
- "title": "Picasso Docs",
3
- "files": ["md/intro.md", "md/components.md", "md/buttons.md", "md/arrows.md", "md/bubbles.md", "md/utils.md", "md/despegar.md"]
2
+ "title": "Picasso. Framework CSS/Sass.",
3
+ "files": ["md/intro.md", "md/changelog.md", "md/todo.md", "md/docs.md","md/components.md", "md/buttons.md", "md/arrows.md", "md/bubbles.md", "md/ie.md" ,"md/utils.md", "md/despegar.md"]
4
4
  }
@@ -1,9 +1,11 @@
1
1
  ## Arrows
2
2
 
3
+ Excelentes para avisos importantes.
4
+
3
5
  ### Ejemplos
4
6
 
5
7
  <em class="arrow-demo-1">
6
- Información
8
+ Informaci&oacute;n
7
9
  </em>
8
10
 
9
11
  <em class="arrow-demo-2">
@@ -1,5 +1,7 @@
1
1
  ## Bubbles
2
2
 
3
+ Ideales para mostrar comentarios de clientes.
4
+
3
5
  ### Ejemplos
4
6
 
5
7
  <div class="bubble-demo-1">
@@ -1,5 +1,7 @@
1
1
  ## Buttons
2
2
 
3
+ Ideales para situaciones en que se necesita un call-to-action.
4
+
3
5
  ### Ejemplos
4
6
 
5
7
  <a class="button-demo-1" href="#">
@@ -15,7 +17,7 @@
15
17
  </a>
16
18
 
17
19
  <a class="button-demo-4" href="#">
18
- <span>Un texto demasiado largo para este botón</span>
20
+ <span>Un texto demasiado largo para este bot&oacute;n</span>
19
21
  </a>
20
22
 
21
23
  ### HTML
@@ -44,6 +46,8 @@
44
46
 
45
47
  ## Mini-Buttons
46
48
 
49
+ Perfectos para acciones simples que influyen en la interfaz.
50
+
47
51
  ### Ejemplos
48
52
 
49
53
  <a class="mini-button-demo-1" href="#">
@@ -0,0 +1,18 @@
1
+ # Changelog
2
+
3
+ ## 0.0.3
4
+
5
+ * Agregados estilos de fallback para Internet Explorer.
6
+ * Soporte para CSS3 Pie (de manera predeterminado apagado).
7
+ * Agregada la documentaci&oacute;n sobre la generaci&oacute;n de docs.
8
+
9
+ ## 0.0.2
10
+
11
+ * Modularizaci&oacute;n del componente.
12
+ * Agregados: buttons, mini-buttons, bubbles y arrows.
13
+ * Creaci&oacute;n de la documentaci&oacute;n.
14
+
15
+ ## 0.0.1
16
+
17
+ * Versi&oacute;n inicial.
18
+ * Agregadas las variables de la marca Despegar y clearfix.
@@ -1 +1,3 @@
1
+ ----------------
2
+
1
3
  # Components
@@ -1,3 +1,5 @@
1
+ ----------------
2
+
1
3
  # Despegar
2
4
 
3
5
  ## Variables
@@ -0,0 +1,21 @@
1
+ # Generar la documentaci&oacute;n
2
+
3
+ * Para generar una nueva versi&oacute;n de la documentaci&oacute;n es necesario tener instalado node.js: http://nodejs.org/#download
4
+
5
+ * Abrir una terminal e instalar [Beautiful docs](http://beautifuldocs.com/):
6
+
7
+ ```bash
8
+ $ npm install beautiful-docs -g
9
+ ```
10
+
11
+ * Crear (o actualizar) los archivos `.md` (`docs/build/md`) con la documentaci&oacute;n pertinente. En caso de agregar un nuevo archivo `.md`, actualizar el `manifest.json`.
12
+
13
+ Nota: Cada `.md` es un archivo de texto plano escrito con la sintaxis [markdown](http://daringfireball.net/projects/markdown/basics).
14
+
15
+ * Pararse sobre la carpeta raiz del proyecto y ejecutar:
16
+
17
+ ```bash
18
+ bfdocs --base-url='.' --templates-dir='docs/build/templates/' docs/build/manifest.json docs
19
+ ```
20
+
21
+ * Revisar que la documentaci&oacute;n se haya generado correctamente abriendo el archivo `.html` pertinente.
@@ -0,0 +1,32 @@
1
+ ## Internet Explorer
2
+
3
+ La gran mayor&iacute;a de los componentes hacen uso intensivo de estilos CSS3 no soportados por versiones de Internet Explorer iguales o menores a 9. De manera predeterminada los componentes tienen estilos de fallback para tener compatibilidad con dicho navegador, el &uacute;nico requisito es que la p&aacute;gina que carga los estilos generados por Picasso posean la [t&eacute;cnica de clases condicionales en la etiqueta html](http://paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/):
4
+
5
+ ```html
6
+ <!DOCTYPE html>
7
+ <!--[if IE 7]> <html class="ie7"> <![endif]-->
8
+ <!--[if IE 8]> <html class="ie8"> <![endif]-->
9
+ <!--[if IE 9]> <html class="ie9"> <![endif]-->
10
+ <!--[if gt IE 9]><!--> <html> <!--<![endif]-->
11
+ ```
12
+
13
+ ### CSS3 Pie
14
+
15
+ Picasso adem&aacute;s ofrece soporte para [CSS3 Pie](http://css3pie.com/). Su soporte esta apagado de forma predeterminada. Para habilitarlo, en el archivo Sass que hace uso de los mixins, agregar la siguiente variable:
16
+
17
+ ```css
18
+ $experimental-support-for-pie: true;
19
+ ```
20
+
21
+ Notas:
22
+ - Tambi&eacute;n es requisito que la p&aacute;gina posea la t&eacute;cnica de clases condicionales en la etiqueta html.
23
+ - Cuando el soporte de CSS3 Pie esta activado, los estilos de fallback no son cargados.
24
+
25
+ Un punto importante a tener en cuenta es la definici&oacute; de la variable `$pie-behavior` con la ruta del archivo `.htc`:
26
+
27
+ ```css
28
+ $pie-behavior stylesheet-url("PIE.htc")
29
+ ```
30
+
31
+ Para otras opciones relacionadas, consultar la documentaci&oacute;n pertinente de Compass: http://compass-style.org/reference/compass/css3/pie/
32
+
@@ -1 +1,42 @@
1
- # Picasso. Framework CSS/Sass.
1
+ # Introducci&oacute;n
2
+
3
+ ## Repositorio
4
+
5
+ http://gitorious.despegar.it/picasso/picasso
6
+
7
+ ## Instalaci&oacute;n
8
+
9
+ Ejecutar:
10
+
11
+ ```bash
12
+ $ (sudo) gem install picasso
13
+ ```
14
+
15
+ En el config.rb agregar:
16
+
17
+ ```bash
18
+ require 'picasso'
19
+ gem 'picasso', '~> 0.0.3'
20
+ ```
21
+
22
+ Modificar el n&uacute;mero de versi&oacute;n a medida que se quiere usar nuevas versiones del framework.
23
+
24
+ Finalmente, en el archivo Sass importar el framework completo:
25
+
26
+ ```bash
27
+ @import "picasso";
28
+ ```
29
+
30
+ o s&oacute;lo lo necesario:
31
+
32
+ ```bash
33
+ @import "picasso/components/buttons";
34
+ @import "picasso/despegar/variables";
35
+ ```
36
+
37
+ ## Actualizaci&oacute;n
38
+
39
+ ```bash
40
+ $ (sudo) gem update picasso
41
+ ```
42
+
@@ -0,0 +1,3 @@
1
+ # Todo
2
+
3
+ ...
@@ -1,3 +1,5 @@
1
+ -------------------
2
+
1
3
  # Utils
2
4
 
3
5
  ## Clearfix
@@ -1,5 +1,8 @@
1
- <!doctype html>
2
- <html>
1
+ <!DOCTYPE html>
2
+ <!--[if IE 7]> <html class="ie7"> <![endif]-->
3
+ <!--[if IE 8]> <html class="ie8"> <![endif]-->
4
+ <!--[if IE 9]> <html class="ie9"> <![endif]-->
5
+ <!--[if gt IE 9]><!--> <html> <!--<![endif]-->
3
6
 
4
7
  <head>
5
8
  <meta charset="utf-8">
@@ -17,20 +20,45 @@
17
20
 
18
21
  <% if not @noHeader: %>
19
22
  <header>
20
- <h1><a href="<%= @baseUrl %>"><%= @manifest.title %></a></h1>
23
+ <h1><%= @manifest.title %></h1>
21
24
  </header>
22
25
  <% end %>
23
26
 
27
+ <% if not @noToc: %>
28
+
29
+ <hr>
30
+
31
+ <h2>Contenidos</h2>
32
+
33
+ <aside>
34
+ <nav>
35
+ <ol>
36
+ <% for entry in @manifest.tableOfContent: %>
37
+ <li>
38
+ <a href="<%= @baseUrl %><%- entry.slug %>.html#<%= entry.anchor %>"><%= entry.title %></a>
39
+ <% if entry.childs: %>
40
+ <ol>
41
+ <% for child in entry.childs: %>
42
+ <li><a href="<%= @baseUrl %><%- child.slug %>.html#<%= child.anchor %>"><%= child.title %></a></li>
43
+ <% end %>
44
+ </ol>
45
+ <% end %>
46
+ </li>
47
+ <% end %>
48
+ </ol>
49
+ </nav>
50
+ </aside>
51
+
52
+ <% end %>
53
+
54
+ <hr>
55
+
24
56
  <%- @content %>
25
57
 
26
58
  <footer>
27
- <a href="<%= @baseUrl %>all.html">Everything on a single page</a>
28
- <% if @manifest.options.github: %>
29
- - <a href="https://github.com/<%= @manifest.options.github %>" id="fork-me-on-github">Fork me on Github</a>
30
- <% end %>
31
59
  </footer>
32
60
 
33
- <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
61
+ <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
34
62
  <script src="<%= @baseUrl %>js/docs.js"></script>
35
63
  <script src="<%= @baseUrl %>js/rainbow-custom.min.js"></script>
36
64