j1-template 2020.0.25 → 2021.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (99) hide show
  1. checksums.yaml +4 -4
  2. data/_includes/themes/j1/modules/attics/generator.html +1 -1
  3. data/assets/data/carousel.json +7 -15
  4. data/assets/themes/j1/adapter/js/carousel.js +395 -32
  5. data/assets/themes/j1/adapter/js/rtable.js +3 -1
  6. data/assets/themes/j1/adapter/js/toccer.js +1 -1
  7. data/assets/themes/j1/core/css/themes/uno-light/bootstrap.css +23 -3
  8. data/assets/themes/j1/core/css/themes/uno-light/bootstrap.min.css +1 -1
  9. data/assets/themes/j1/core/js/template.js +1 -1
  10. data/assets/themes/j1/core/js/template.js.map +1 -1
  11. data/assets/themes/j1/core/js/template.min.js +1 -1
  12. data/assets/themes/j1/modules/carousel/css/theme/uno.css +89 -36
  13. data/assets/themes/j1/modules/carousel/css/theme/uno.min.css +1 -1
  14. data/assets/themes/j1/modules/jquery/css/jqueryUI/theme.css +443 -0
  15. data/assets/themes/j1/modules/jquery/css/jqueryUI/theme.min.css +5 -0
  16. data/assets/themes/j1/modules/jquery/js/jqueryUI.js +18701 -0
  17. data/assets/themes/j1/modules/jquery/js/jqueryUI.min.js +13 -0
  18. data/assets/themes/j1/modules/kofax.7z +0 -0
  19. data/lib/j1/version.rb +1 -1
  20. data/lib/starter_web/Gemfile +1 -1
  21. data/lib/starter_web/_config.yml +21 -90
  22. data/lib/starter_web/_data/apps/carousel.yml +157 -336
  23. data/lib/starter_web/_data/apps/defaults/carousel.yml +87 -86
  24. data/lib/starter_web/_data/layouts/collection.yml +6 -6
  25. data/lib/starter_web/_data/layouts/home.yml +0 -1
  26. data/lib/starter_web/_data/layouts/page.yml +1 -2
  27. data/lib/starter_web/_data/layouts/post.yml +1 -2
  28. data/lib/starter_web/_data/modules/fam.yml +45 -11
  29. data/lib/starter_web/_data/resources.yml +3 -2
  30. data/lib/starter_web/_includes/attributes.asciidoc +1 -1
  31. data/lib/starter_web/assets/images/modules/icons/d1/d1-256x256.png +0 -0
  32. data/lib/starter_web/assets/images/modules/icons/d1/d1-32x32.ico +0 -0
  33. data/lib/starter_web/assets/images/modules/icons/d1/d1-512x512.png +0 -0
  34. data/lib/starter_web/assets/images/modules/icons/d1/d1-64x64.png +0 -0
  35. data/lib/starter_web/assets/images/modules/icons/d1/d1.ico +0 -0
  36. data/lib/starter_web/assets/images/modules/icons/d1/favicon.ico +0 -0
  37. data/lib/starter_web/assets/images/modules/icons/d1/scalable/d1.svg +48 -43
  38. data/lib/starter_web/assets/images/quotes/colored-1.jpg +0 -0
  39. data/lib/starter_web/assets/images/quotes/colored-2.jpg +0 -0
  40. data/lib/starter_web/assets/images/quotes/default.jpg +0 -0
  41. data/lib/starter_web/assets/images/quotes/light-blue.jpg +0 -0
  42. data/lib/starter_web/assets/images/quotes/people.jpg +0 -0
  43. data/lib/starter_web/package.json +4 -3
  44. data/lib/starter_web/pages/public/learn/roundtrip/100_present_images.adoc +6 -23
  45. data/lib/starter_web/pages/public/previewer/rouge.adoc +238 -4
  46. data/lib/starter_web/utilsrv/_defaults/package.json +1 -1
  47. data/lib/starter_web/utilsrv/package.json +1 -1
  48. metadata +12 -53
  49. data/assets/themes/j1/core/css/bootstrap.css +0 -7154
  50. data/assets/themes/j1/core/css/bootstrap.min.css +0 -6
  51. data/assets/themes/j1/core/css/custom.scss +0 -28
  52. data/assets/themes/j1/core/css/globals.css +0 -14523
  53. data/assets/themes/j1/core/css/globals.min.css +0 -1
  54. data/assets/themes/j1/core/css/globals.scss +0 -28
  55. data/assets/themes/j1/core/css/theme_extensions.css +0 -11558
  56. data/assets/themes/j1/core/css/theme_extensions.min.css +0 -1
  57. data/assets/themes/j1/core/css/uno.css +0 -11823
  58. data/assets/themes/j1/core/css/uno.min.css +0 -1
  59. data/assets/themes/j1/core/css/uno.scss +0 -28
  60. data/assets/themes/j1/core/css/vendor.scss +0 -28
  61. data/lib/starter_web/assets/images/quotes/default.png +0 -0
  62. data/lib/starter_web/assets/images/quotes/people.png +0 -0
  63. data/lib/starter_web/collections/posts/public/series/_posts/2018-11-01-docker-using-shared-folders.adoc +0 -494
  64. data/lib/starter_web/collections/posts/public/test_posts/_posts/2020-09-11-test_post.adoc +0 -218
  65. data/lib/starter_web/collections/posts/public/test_posts/_posts/_includes/attributes.asciidoc +0 -34
  66. data/lib/starter_web/collections/posts/public/test_posts/_posts/_includes/documents/readme +0 -0
  67. data/lib/starter_web/collections/posts/public/test_posts/_posts/_includes/tables/debug_variables.asciidoc +0 -48
  68. data/lib/starter_web/collections/posts/public/test_posts/_posts/_includes/tables/readme +0 -0
  69. data/lib/starter_web/pages/public/test_pages/_includes/attributes.asciidoc +0 -49
  70. data/lib/starter_web/pages/public/test_pages/_includes/documents/100_gistblock.asciidoc +0 -27
  71. data/lib/starter_web/pages/public/test_pages/_includes/tables/000_bem_specifiers.asciidoc +0 -22
  72. data/lib/starter_web/pages/public/test_pages/_includes/tables/000_specifier_examples.asciidoc +0 -56
  73. data/lib/starter_web/pages/public/test_pages/breadcrumbs_tester.adoc +0 -62
  74. data/lib/starter_web/pages/public/test_pages/carousel_captions.adoc +0 -1045
  75. data/lib/starter_web/pages/public/test_pages/deck_of_posts.adoc +0 -165
  76. data/lib/starter_web/pages/public/test_pages/floating_actions_button.adoc +0 -523
  77. data/lib/starter_web/pages/public/test_pages/floating_ad.adoc +0 -208
  78. data/lib/starter_web/pages/public/test_pages/floating_div.adoc +0 -196
  79. data/lib/starter_web/pages/public/test_pages/lunr_tester.adoc +0 -89
  80. data/lib/starter_web/pages/public/test_pages/nav_pagination_tester.adoc +0 -284
  81. data/lib/starter_web/pages/public/test_pages/page_attribute_tester.adoc +0 -196
  82. data/lib/starter_web/pages/public/test_pages/responsive_images.adoc +0 -213
  83. data/lib/starter_web/pages/public/test_pages/responsive_tables.adoc +0 -210
  84. data/lib/starter_web/pages/public/test_pages/toccer_tester.adoc +0 -2245
  85. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/attributes.asciidoc +0 -117
  86. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/100_gistblock.asciidoc +0 -27
  87. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_bottom_info.asciidoc +0 -11
  88. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_bottom_left_warning.asciidoc +0 -11
  89. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_bottom_right_danger.asciidoc +0 -11
  90. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_central_success.asciidoc +0 -11
  91. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_full_height_left_info.asciidoc +0 -11
  92. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_full_height_right_success.asciidoc +0 -11
  93. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_table_3_column.asciidoc +0 -47
  94. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_top_info.asciidoc +0 -11
  95. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_top_left_info.asciidoc +0 -11
  96. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/410_top_right_success.asciidoc +0 -11
  97. data/lib/starter_web/pages/public/test_pages/vtutorials/000_includes/documents/419_advanced_modals_html.asciidoc +0 -928
  98. data/lib/starter_web/pages/public/test_pages/vtutorials/000_test_youtube_video.adoc +0 -141
  99. data/lib/starter_web/pages/public/test_pages/vtutorials/100_basic_video.adoc +0 -109
@@ -1,284 +0,0 @@
1
- ---
2
- title: Navigation Tester
3
- tagline: paginator
4
- description: J1 Template Roundtrip - Present image based data
5
-
6
- tags: [ Page, Roundtrip ]
7
- index: [ Template, Roundtrip, Images ]
8
- categories: [ pages ]
9
-
10
- toc: true
11
- scrollbar: false
12
-
13
- permalink: /pages/public/tester/paginator/
14
- regenerate: false
15
- date: 2020-11-08 12:00:00
16
-
17
- resources: []
18
- resource_options:
19
- - attic:
20
- padding_top: 400
21
- padding_bottom: 50
22
- opacity: 0.5
23
- # slides:
24
- # - url: /assets/images/pages/roundtrip/images-1920x1280-bw.jpg
25
- # alt: Photo by Ricardo Gomez Angel on Unsplash
26
- # badge:
27
- # type: unsplash
28
- # author: Ricardo Gomez Angel
29
- # href: https://unsplash.com/@ripato/portfolio
30
- ---
31
-
32
- // Page Initializer
33
- // =============================================================================
34
- // Enable the Liquid Preprocessor
35
- :page-liquid:
36
-
37
- // Set page (local) attributes here
38
- // -----------------------------------------------------------------------------
39
- // :page--attr: <attr-value>
40
-
41
- // Load Liquid procedures
42
- // -----------------------------------------------------------------------------
43
- {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
44
-
45
- // Load page attributes
46
- // -----------------------------------------------------------------------------
47
- {% include {{load_attributes}} scope="none" %}
48
-
49
-
50
- // Page content
51
- // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52
- == Paginator
53
-
54
- lorem:sentences[3]
55
-
56
- ++++
57
- <div class="mb-5">
58
- <!-- Pagination #15 -->
59
- <nav class="text-left" aria-label="Page Navigation">
60
- <ul class="list-inline">
61
- <li class="list-inline-item">
62
- <a class="u-pagination-v1__item g-brd-around g-brd-2 g-brd-gray-dark-v2 g-color-gray-dark-v2 g-bg-gray-dark-v2--hover g-color-white--hover g-brd-gray-dark-v2--hover g-rounded-3 g-pa-4-13" href="#" aria-label="Previous">
63
- <span aria-hidden="true">
64
- <i class="fa fa-angle-left g-mr-5"></i>
65
- Previous
66
- </span>
67
- <span class="sr-only">Previous</span>
68
- </a>
69
- </li>
70
- <li class="list-inline-item">
71
- <a class="u-pagination-v1__item g-brd-around g-brd-2 g-brd-gray-dark-v2 g-color-gray-dark-v2 g-bg-gray-dark-v2--hover g-color-white--hover g-brd-gray-dark-v2--hover g-rounded-3 g-pa-4-13" href="#" aria-label="Next">
72
- <span aria-hidden="true">
73
- Next
74
- <i class="fa fa-angle-right g-ml-5"></i>
75
- </span>
76
- <span class="sr-only">Next</span>
77
- </a>
78
- </li>
79
- </ul>
80
- </nav>
81
- <!-- End Pagination #15 -->
82
- </div>
83
- ++++
84
-
85
- ++++
86
- <div class="mb-5">
87
- <!-- Pagination #08 -->
88
- <nav class="text-left" aria-label="Page Navigation">
89
- <ul class="list-inline">
90
- <li class="list-inline-item">
91
- <a class="u-pagination-v1__item u-pagination-v1-2 g-pa-7-16" href="#" aria-label="Previous">
92
- <span aria-hidden="true">
93
- <i class="fa fa-angle-left g-mr-5"></i>
94
- Previous
95
- </span>
96
- <span class="sr-only">Previous</span>
97
- </a>
98
- </li>
99
- <li class="list-inline-item g-hidden-sm-down">
100
- <a class="u-pagination-v1__item u-pagination-v1-2 g-pa-7-14" href="#">1</a>
101
- </li>
102
- <li class="list-inline-item g-hidden-sm-down">
103
- <a class="u-pagination-v1__item u-pagination-v1-2 u-pagination-v1-2--active g-pa-7-14" href="#">2</a>
104
- </li>
105
- <li class="list-inline-item g-hidden-sm-down">
106
- <a class="u-pagination-v1__item u-pagination-v1-2 g-pa-7-14" href="#">3</a>
107
- </li>
108
- <li class="list-inline-item g-hidden-sm-down">
109
- <a class="g-pa-7-14">...</a>
110
- </li>
111
- <li class="list-inline-item g-hidden-sm-down">
112
- <a class="u-pagination-v1__item u-pagination-v1-2 g-pa-7-14" href="#">80</a>
113
- </li>
114
- <li class="list-inline-item">
115
- <a class="u-pagination-v1__item u-pagination-v1-2 g-pa-7-16" href="#" aria-label="Next">
116
- <span aria-hidden="true">
117
- Next
118
- <i class="fa fa-angle-right g-ml-5"></i>
119
- </span>
120
- <span class="sr-only">Next</span>
121
- </a>
122
- </li>
123
- </ul>
124
- </nav>
125
- <!-- End Pagination #08 -->
126
- </div>
127
- ++++
128
-
129
- ++++
130
- <nav class="text-left mb-5" aria-label="Page Navigation">
131
- <ul class="list-inline">
132
- <li class="list-inline-item">
133
- <a class="u-pagination-v1__item u-pagination-v1-1 u-pagination-v1__item--disabled g-pa-12-21" href="#" aria-label="Previous">
134
- <span aria-hidden="true">
135
- <i class="fa fa-angle-left g-mr-5"></i>
136
- Previous
137
- </span>
138
- <span class="sr-only">Previous</span>
139
- </a>
140
- </li>
141
- <li class="list-inline-item g-hidden-sm-down">
142
- <a class="u-pagination-v1__item u-pagination-v1-1 u-pagination-v1-1--active g-pa-12-19" href="#">1</a>
143
- </li>
144
- <li class="list-inline-item g-hidden-sm-down">
145
- <a class="u-pagination-v1__item u-pagination-v1-1 g-pa-12-19" href="#">2</a>
146
- </li>
147
- <li class="list-inline-item g-hidden-sm-down">
148
- <a class="u-pagination-v1__item u-pagination-v1-1 g-pa-12-19" href="#">3</a>
149
- </li>
150
- <li class="list-inline-item g-hidden-sm-down">
151
- <span class="g-pa-12-19">...</span>
152
- </li>
153
- <li class="list-inline-item g-hidden-sm-down">
154
- <a class="u-pagination-v1__item u-pagination-v1-1 g-pa-12-19" href="#">15</a>
155
- </li>
156
- <li class="list-inline-item">
157
- <a class="u-pagination-v1__item u-pagination-v1-1 g-pa-12-21" href="#" aria-label="Next">
158
- <span aria-hidden="true">
159
- Next
160
- <i class="fa fa-angle-right g-ml-5"></i>
161
- </span>
162
- <span class="sr-only">Next</span>
163
- </a>
164
- </li>
165
- </ul>
166
- </nav>
167
- ++++
168
-
169
- == Bootstrap Paginations
170
-
171
- Pagination links indicate a series of related content exists across
172
- multiple pages. Typically these are used where a multi-page approach
173
- to long lists of content improves general performance, such as in
174
- search results or inboxes.
175
-
176
- ++++
177
- <div class="shortcode-html">
178
- <!-- Pagination Default -->
179
- <nav aria-label="Page navigation">
180
- <ul class="pagination">
181
- <li class="page-item">
182
- <a class="page-link" href="#" aria-label="Previous">
183
- <span aria-hidden="true">«</span>
184
- <span class="sr-only">Previous</span>
185
- </a>
186
- </li>
187
- <li class="page-item">
188
- <a class="page-link" href="#">1</a>
189
- </li>
190
- <li class="page-item">
191
- <a class="page-link" href="#">2</a>
192
- </li>
193
- <li class="page-item">
194
- <a class="page-link" href="#">3</a>
195
- </li>
196
- <li class="page-item">
197
- <a class="page-link" href="#">4</a>
198
- </li>
199
- <li class="page-item">
200
- <a class="page-link" href="#">5</a>
201
- </li>
202
- <li class="page-item">
203
- <a class="page-link" href="#" aria-label="Next">
204
- <span aria-hidden="true">»</span>
205
- <span class="sr-only">Next</span>
206
- </a>
207
- </li>
208
- </ul>
209
- </nav>
210
- <!-- End Pagination Default -->
211
- </div>
212
- ++++
213
-
214
- ++++
215
- <div class="shortcode-html">
216
- <!-- Pagination States -->
217
- <nav aria-label="...">
218
- <ul class="pagination">
219
- <li class="page-item disabled">
220
- <a class="page-link" href="#" tabindex="-1" aria-label="Previous">
221
- <span aria-hidden="true">«</span>
222
- <span class="sr-only">Previous</span>
223
- </a>
224
- </li>
225
- <li class="page-item active">
226
- <a class="page-link" href="#">1
227
- <span class="sr-only">(current)</span>
228
- </a>
229
- </li>
230
- <li class="page-item">
231
- <a class="page-link" href="#">2</a>
232
- </li>
233
- <li class="page-item">
234
- <a class="page-link" href="#">3</a>
235
- </li>
236
- <li class="page-item">
237
- <a class="page-link" href="#">4</a>
238
- </li>
239
- <li class="page-item">
240
- <a class="page-link" href="#">5</a>
241
- </li>
242
- <li class="page-item">
243
- <a class="page-link" href="#" aria-label="Next">
244
- <span aria-hidden="true">»</span>
245
- <span class="sr-only">Next</span>
246
- </a>
247
- </li>
248
- </ul>
249
- </nav>
250
- <!-- End Pagination States -->
251
- </div>
252
- ++++
253
-
254
- ++++
255
- <div class="shortcode-html">
256
- <!-- Pagination Large -->
257
- <nav aria-label="...">
258
- <ul class="pagination pagination-lg">
259
- <li class="page-item">
260
- <a class="page-link" href="#" aria-label="Previous">
261
- <span aria-hidden="true">«</span>
262
- <span class="sr-only">Previous</span>
263
- </a>
264
- </li>
265
- <li class="page-item">
266
- <a class="page-link" href="#">1</a>
267
- </li>
268
- <li class="page-item">
269
- <a class="page-link" href="#">2</a>
270
- </li>
271
- <li class="page-item">
272
- <a class="page-link" href="#">3</a>
273
- </li>
274
- <li class="page-item">
275
- <a class="page-link" href="#" aria-label="Next">
276
- <span aria-hidden="true">»</span>
277
- <span class="sr-only">Next</span>
278
- </a>
279
- </li>
280
- </ul>
281
- </nav>
282
- <!-- End Pagination Large -->
283
- </div>
284
- ++++
@@ -1,196 +0,0 @@
1
- ---
2
- title: Attribute Tester
3
- tagline: global attributes for pages
4
- description:
5
-
6
- tags: [ Page, Tester ]
7
- index: [ Template, Tester, Attribute ]
8
- categories: [ pages ]
9
-
10
- permalink: /pages/public/test_pages/page_attribute_tester/
11
- regenerate: false
12
- date: 2020-11-08 12:00:00
13
-
14
- toc: true
15
- advertising: false
16
-
17
- resources: [ rouge ]
18
- resource_options:
19
- # - ssm:
20
- # mode: menu
21
- - attic:
22
- padding_top: 400
23
- padding_bottom: 50
24
- opacity: 0.3
25
- slides:
26
- - url: /assets/images/pages/roundtrip/typography-1920x1280-bw.jpg
27
- alt: Photo by Alice Donovan Rousel on Unsplash
28
- preload: 0
29
- transitionDuration: fast
30
- resolutionRefreshRate: 500
31
- badge:
32
- type: unsplash
33
- author: Alice Donovan Rousel
34
- href: https://unsplash.com/@alicekat/portfolio
35
- ---
36
-
37
- // Page Initializer
38
- // =============================================================================
39
- // Enable the Liquid Preprocessor
40
- :page-liquid:
41
-
42
- // Set page (local) attributes here
43
- // -----------------------------------------------------------------------------
44
- :debug: true
45
- :content: false
46
-
47
- // Load Liquid procedures
48
- // -----------------------------------------------------------------------------
49
- {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
50
-
51
- // Load page attributes
52
- // -----------------------------------------------------------------------------
53
- {% include {{load_attributes}} scope="global" %}
54
-
55
-
56
- // Page content
57
- // =============================================================================
58
- ifeval::[{debug} == true]
59
- == Notes
60
-
61
- The Liquid preprocessor not applied to included AsciiDoc files by the
62
- *jekyll-asciidoc* plugin.
63
-
64
- See::
65
- * link:{url-asciidoctor-plugin--issue_166}[Plugin {char-middot} jekyll-asciidoc {char-middot} issue #166, {browser-window--new}] +
66
- * link:{url__asciidoctor-plugin--issue_166}[Plugin {char-middot} jekyll-asciidoc {char-middot} issue #166, {browser-window--new}]
67
-
68
- Comments::
69
- *mojavelinux* commented on 3 Oct 2017
70
-
71
- [source, text, role="mb-5"]
72
- ----
73
- The problem is that the liquid filter is applied to the raw source, before
74
- the AsciiDoc plugin gets involved. That step doesn't know anything about
75
- AsciiDoc includes, so it only looks at the flat source. Then Asciidoctor
76
- comes in and converts the content. Only then is the include file folded in,
77
- but Asciidoctor doesn't know anything about liquid. That's why the liquid
78
- tags are not processed in the include file.
79
-
80
- There was never a test for this scenario, which is why it got overlooked.
81
-
82
- In order to solve this, we'd need to introduce a custom IncludeProcessor
83
- that applies the liquid filter on the included content. At the moment,
84
- that has side effects, so it needs to be handled carefully.
85
- ----
86
-
87
- == Variables
88
-
89
- // Include table|s (global source)
90
- // -----------------------------------------------------------------------------
91
- include::{table-template--variables}[]
92
-
93
- .Jekyll variables (Liquid)
94
- [cols="3,3a,6a, options="header", width="100%", role="rtable mt-3"]
95
- |===============================================================================
96
- |Name |Value |Description
97
-
98
- |`page.path`
99
- |{{ page.path }}
100
- |The path to the raw post or page. Example usage: Linking back to the page
101
- or post's source on GitHub. This can be overridden in the `YAML Front Matter`.
102
-
103
- |`site.collections_dir`
104
- |{{ site.collections_dir }}
105
- |lorem:sentences[1]
106
-
107
- |`page.images.dir`
108
- |{{ page.images.dir }}
109
- |Image path set pagewise. See FRONTMATTER defaults in `_config.yml` for the
110
- images path specified by: `images.dir` for specific page *type*. See the
111
- example below for a page of type *pages*.
112
- [source, yaml]
113
- ----
114
- defaults:
115
- - scope:
116
- path: pages
117
- type: pages
118
-
119
- values:
120
- images:
121
- dir: /assets/images/pages
122
- ----
123
-
124
- |`page-imagesdir`
125
- |{{ page-imagesdir }}
126
- | Images path set in the page by `:page-imagesdir:`.
127
-
128
- |`template`
129
- |{{ site.template.name }}
130
- |Name of the template used for rendering a page. Settings are taken from
131
- sitewide configuration defined by `_config.yml`.
132
-
133
- |`includedir`
134
- |{{ includedir }}
135
- |lorem:sentences[1]
136
-
137
- |===============================================================================
138
-
139
- == MIT license
140
-
141
- include::{docs-licenses--mit}[]
142
-
143
- endif::[]
144
-
145
- ifeval::[{content} == true]
146
- == BEM Notation
147
-
148
- J1 Template is using the **B**lock, **E**lement, **M**odifier methodology
149
- (commonly referred to as *BEM*) to construct resource names like
150
-
151
- * Template variables (e.g. from Liquid)
152
- * Asciidoc attributes
153
-
154
- BEM is a popular naming convention for classes in *HTML* and *CSS*.
155
- It's developed by the team at
156
- link:{url-wikipedia_de--yandex}[Yandex (Wikipedia), {browser-window--new}].
157
- It's goal is to help developers to better understand the relationship between
158
- the HTML and CSS in a given project intuitively without reading any documention.
159
-
160
- NOTE: For J1 Template components, classes for *HTML* and *CSS* code, the
161
- *standard* BEM notation of `block__element\--modifier` (double underscores
162
- and hyphens) is used. As __Bootstrap__ does *NOT* use BEM, all Bootstrap code
163
- remains unchanged for *HTML* and *CSS*.
164
-
165
- For J1 Template, this idea of writing resource names enables authors to get
166
- quickly an idea what type a resource is addressed (the block), and which
167
- element depends on a block. Modifiers finally adresses a specific resource
168
- out of the hierarchy given by the `block-element\--modifier` notation.
169
-
170
- NOTE: To not conflict with naming conventions for Asciidoc or Liquid,
171
- the BEM notation for variables and attributes is using only *hyphens*.
172
- An element is prepended by a single hyphen (`-`), modifiers by double
173
- ones (`--`).
174
-
175
- // Include table|s (local source)
176
- // -----------------------------------------------------------------------------
177
- include::{tabledir}/000_bem_specifiers.asciidoc[]
178
-
179
- NOTE: For more complex resources, modifiers can make use of *underscores*
180
- to express a hierarchy on a source if appreciated.
181
-
182
- J1 Template and Jekyll gives creators of Webs the freedom to use simple
183
- text editors to construct Web sites and write content. Because of the missing
184
- database, no GUI support is given. To write *and* read code fluently, a
185
- notation scheme can help a lot. All developers can consistently name
186
- components for easier communication between team members. In other words,
187
- BEM gives everyone on a project a declarative syntax that they can share
188
- so that they’re on the same page even not witten by their selves.
189
-
190
- == Examples
191
-
192
- // Include table|s (local source)
193
- // -----------------------------------------------------------------------------
194
- include::{tabledir}/000_specifier_examples.asciidoc[]
195
-
196
- endif::[]