j1-template 2023.9.0 → 2023.9.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (55) hide show
  1. checksums.yaml +4 -4
  2. data/_includes/themes/j1/layouts/content_generator_post.html +19 -49
  3. data/_includes/themes/j1/procedures/posts/collate_timeline.proc +185 -192
  4. data/_includes/themes/j1/procedures/posts/create_series_header.proc +1 -14
  5. data/_includes/themes/j1/procedures/posts/pager.proc +39 -46
  6. data/assets/data/speak2me.html +9 -7
  7. data/assets/themes/j1/adapter/js/navigator.js +5 -2
  8. data/assets/themes/j1/adapter/js/speak2me.js +181 -46
  9. data/assets/themes/j1/core/css/themes/unolight/bootstrap.css +3 -0
  10. data/assets/themes/j1/core/css/themes/unolight/bootstrap.min.css +1 -1
  11. data/assets/themes/j1/core/js/template.js +165 -133
  12. data/assets/themes/j1/core/js/template.min.js +7 -7
  13. data/assets/themes/j1/core/js/template.min.js.map +1 -1
  14. data/lib/j1/version.rb +1 -1
  15. data/lib/starter_web/README.md +5 -5
  16. data/lib/starter_web/_config.yml +1 -1
  17. data/lib/starter_web/_data/blocks/footer.yml +6 -4
  18. data/lib/starter_web/_data/modules/defaults/blog_navigator.yml +89 -135
  19. data/lib/starter_web/_data/modules/defaults/speak2me.yml +8 -4
  20. data/lib/starter_web/_data/modules/navigator_menu.yml +14 -7
  21. data/lib/starter_web/_data/templates/feed.xml +1 -1
  22. data/lib/starter_web/_plugins/asciidoctor/carousel-block.rb +1 -1
  23. data/lib/starter_web/_plugins/asciidoctor/gallery-block.rb +1 -1
  24. data/lib/starter_web/_plugins/asciidoctor/lightbox-block.rb +1 -1
  25. data/lib/starter_web/_plugins/asciidoctor/masonry-block.rb +1 -1
  26. data/lib/starter_web/_plugins/asciidoctor/masterslider-block.rb +1 -1
  27. data/lib/starter_web/_plugins/asciidoctor/slick-block.rb +1 -1
  28. data/lib/starter_web/_plugins/index/lunr.rb +1 -1
  29. data/lib/starter_web/collections/posts/public/featured/_posts/0000-00-00-welcome-to-j1.adoc.erb +75 -71
  30. data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.adoc +110 -84
  31. data/lib/starter_web/collections/posts/public/featured/_posts/2021-02-01-static-site-generators.adoc +49 -33
  32. data/lib/starter_web/collections/posts/public/featured/_posts/2022-02-01-about-j1.adoc +47 -26
  33. data/lib/starter_web/package.json +1 -1
  34. data/lib/starter_web/pages/public/blog/navigator/archive/allview.html +66 -63
  35. data/lib/starter_web/pages/public/blog/navigator/archive/categoryview.html +76 -77
  36. data/lib/starter_web/pages/public/blog/navigator/archive/dateview.html +63 -64
  37. data/lib/starter_web/pages/public/blog/navigator/archive/tagview.html +79 -64
  38. data/lib/starter_web/pages/public/blog/navigator/index.html +55 -99
  39. data/lib/starter_web/pages/public/learn/roundtrip/_includes/documents/themes_bootstrap.asciidoc +2 -1
  40. data/lib/starter_web/pages/public/learn/roundtrip/asciidoc_extensions.adoc +39 -29
  41. data/lib/starter_web/pages/public/learn/roundtrip/bootstrap_themes.adoc +0 -3
  42. data/lib/starter_web/pages/public/learn/roundtrip/highlghter_rouge.adoc +1 -1
  43. data/lib/starter_web/pages/public/learn/roundtrip/icon_fonts.adoc +1 -0
  44. data/lib/starter_web/pages/public/learn/roundtrip/modal_extentions.adoc +1 -0
  45. data/lib/starter_web/pages/public/learn/roundtrip/present_images.adoc +44 -62
  46. data/lib/starter_web/pages/public/learn/roundtrip/responsive_tables.adoc +1 -0
  47. data/lib/starter_web/pages/public/learn/where_to_go.adoc +24 -13
  48. data/lib/starter_web/pages/public/legal/en/100_copyright.adoc +4 -1
  49. data/lib/starter_web/pages/public/legal/en/200_impress.adoc +4 -1
  50. data/lib/starter_web/pages/public/legal/en/300_privacy.adoc +632 -595
  51. data/lib/starter_web/pages/public/legal/en/400_comment_policy.adoc +12 -3
  52. data/lib/starter_web/pages/public/tools/previewer/preview_bootstrap_theme.adoc +3093 -3104
  53. data/lib/starter_web/utilsrv/_defaults/package.json +1 -1
  54. data/lib/starter_web/utilsrv/package.json +1 -1
  55. metadata +2 -2
@@ -79,11 +79,11 @@ resource_options:
79
79
  // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
80
80
  [role="dropcap"]
81
81
  Welcome to the preview page focussing on image modules. This page shows
82
- all the valuable features of the J1 Template to manage your image-based
82
+ all of the powerful features of the J1 Template to manage your image-based
83
83
  content using lightboxes, carousels, sliders, grids, and galleries.
84
84
 
85
85
  The image-related modules of the J1 Template offer a wide range of complex
86
- functionality based on powerful Open Source libraries like Lightbox V2,
86
+ functionality based on powerful Open Source libraries like Lightbox Version 2,
87
87
  Slick Slider, Master Slider, or Masonry Grid and JustifiedGallery to create
88
88
  masonry-styled preview maps.
89
89
 
@@ -98,14 +98,14 @@ mdi:clock-time-five-outline[24px, md-gray mt-4 mr-2]
98
98
 
99
99
  A Lightbox is a helper which displays enlarged, almost screen-filling versions
100
100
  of images while dimming the remainder of the page. The technique, introduced
101
- by Lightbox V2, gained widespread popularity thanks to its simple style. The
102
- term *Lightbox* has been employed since then for Javascript libraries to
101
+ by Lightbox Version 2, gained widespread popularity thanks to its simple style.
102
+ The term *Lightbox* has been employed since then for Javascript libraries to
103
103
  support such functionality.
104
104
 
105
105
  For J1 Template, different lightbox modules are available:
106
106
 
107
- * Lightbox V2 (default)
108
- * LightGallery Lightbox (optional)
107
+ * Lightbox Version 2 (default)
108
+ * Lightbox LightGallery (optional)
109
109
  * Slick Lightbox (for Slick Carousels only)
110
110
 
111
111
  The *default* tool employed by J1 Template is Lightbox V2, a Javascript
@@ -127,8 +127,8 @@ under the link:{url-j1-docs--lightbox-module}[Lightbox module, {browser-window--
127
127
  === Default Lightbox
128
128
 
129
129
  [role="mb-4"]
130
- Find below an example of using the rhe default lightbox used for standalone
131
- images. See how single (individual) images are linked.
130
+ Find below an example of using the the default lightbox used for standalone
131
+ images. See how individual images are linked.
132
132
 
133
133
  .Lightbox for standalone images
134
134
  lightbox::example-standalone[ 800, {data-images-standalone}, role="mb-4" ]
@@ -164,8 +164,8 @@ gallery::jg_old_times[]
164
164
  == J1 Carousel
165
165
 
166
166
  J1 Carousel is based on OWL Carousel V1 in the latest version. OWL Carousel
167
- is a clean and neat _jQuery_ slider plugin for creating fully responsive and
168
- touch-enabled carousel sliders.
167
+ is a powerful jQuery plugin for creating fully responsive and touch-enabled
168
+ carousel sliders.
169
169
 
170
170
  [role="mt-4"]
171
171
  === Simple Text Carousel
@@ -178,20 +178,19 @@ displayed as a slide show: simple text, for example.
178
178
  .Text Carousel
179
179
  carousel::demo_text_carousel[role="mb-4"]
180
180
 
181
- Important statements or topics can be placed, e.g., on top of an article or
182
- a paragraph, to give them better visibility. In one line, you can present
181
+ Important statements or topics can be placed on top of an article or
182
+ a paragraph to give them better visibility. In one line, you can present
183
183
  many facts to know animated for the reader's attention within a single
184
- line. No much space is needed!
184
+ line.
185
185
 
186
186
  [role="mt-4"]
187
187
  === Parallax Text Carousel
188
188
 
189
189
  [role="mb-4"]
190
- A more eye-minded type of text-based slide show is a parallax text slider. If
191
- you want to emphasize your statements focussing the meaning, this kind of a
192
- slide show may be interesting. Image-based slide shows may draw off the
193
- reader's attention from the text, therefore a pure text-based presentation
194
- maybe the better choice.
190
+ A more emphasized type of text-based carousel is a parallax text slider. If
191
+ you want to focus the meaning, this kind of a slide show may be interesting.
192
+ Image-based slide shows may draw off the reader's attention from the text,
193
+ therefore a pure text-based presentation maybe the better choice.
195
194
 
196
195
  .Parallax Text
197
196
  carousel::demo_text_carousel_parallax[role="mb-4"]
@@ -228,16 +227,15 @@ carousel::demo_simple[role="mb-4"]
228
227
 
229
228
  Carousels are used for an exceptionally compact form of image galleries.
230
229
  This example shows some pictures having individual caption text and supports
231
- a lightbox to enlarge images full size. For the example below, an almost simple
232
- lightbox is used: Lightbox2; or short: lightbox.
230
+ a lightbox to enlarge images full size.
233
231
 
234
232
  .Image Carousel + Lightbox
235
233
  carousel::demo_cats[role="mb-3"]
236
234
 
237
235
  The J1 module lightbox is a simple Lightbox but offers a bunch of impressive
238
236
  features for displaying images. For example, the lightbox can display all
239
- images (of a carousel) as a group. If one picture is opened in the lightbox,
240
- others are browsed by easy-to-use control buttons.
237
+ images as a group. If one picture is opened in the lightbox, others are
238
+ browsed by easy-to-use control buttons.
241
239
 
242
240
  [role="mt-4"]
243
241
  === One Slide Carousel + Lightbox
@@ -254,7 +252,7 @@ carousel::demo_oneslide[role="mb-4"]
254
252
  == J1 Slick Carousel
255
253
 
256
254
  [role="mb-4"]
257
- _Slick_ is a popular jQuery plugin for creating responsive and fully
255
+ Slick is a popular jQuery plugin for creating responsive and fully
258
256
  customizable carousels. It allows developers to easily create beautiful
259
257
  and dynamic carousels that can display images, videos, or any other type
260
258
  of content in a visually appealing way.
@@ -329,11 +327,11 @@ link:{url-j1-slick-previewer}[Slick Previewer, {browser-window--new}],
329
327
  [[masterSlider]]
330
328
  == J1 Master Slider
331
329
 
332
- The Javascript library _Master Slider_ is a 3rd party plugin fully integrated
333
- into the J1 Template by the module `masterslider`. J1 Template uses the *free*
334
- version *MS Lite*. The free version of Master Slider does *not* support
335
- all features: the functionality of *filters*, *layouts* are limited and no
336
- *overlay* techniques are supported by MS Lite.
330
+ Masterslider is a jQuery plugin fully integrated into the J1 Template.
331
+ Jekyll One uses the *free* version of Masterslider well-known as MS Lite.
332
+ The lite version does *not* support all features of the full product.
333
+ The functionality of filters and layouts are limited and no overlay
334
+ techniques are supported by the MS Lite version.
337
335
 
338
336
  [role="mt-4"]
339
337
  [[carousel_versus_slider]]
@@ -398,26 +396,19 @@ masterslider::ms_00003[]
398
396
 
399
397
  [role="mt-4"]
400
398
  [[thumb_images]]
401
- === MS Slider using ThumbImages
399
+ === [role="mt-4"] Slider using Thumb Elements
402
400
 
403
401
  To give the users better control over a slideshow, sliders provide complex UI
404
- elements like *thumbs* placed side-by-side (left|right), at the top, or at
405
- the bottom of a slideshow. Find two examples to control a slideshow by
406
- *thumb images*.
402
+ elements to place dor example mini-images or short text elements side-by-side
403
+ left or right, or at the bottom of a slideshow. Find two examples below how
404
+ to control such a carousel element.
407
405
 
408
- .Slider using ThumbImages
409
- masterslider::ms_00004[]
406
+ .Image controls
407
+ masterslider::ms_00004[role="mb-5"]
410
408
 
411
- [role="mt-4"]
412
- [[thumb_info]]
413
- === MS Slider using ThumbInfo
414
-
415
- To give the users better control over a slideshow, MS Slider provides
416
- complex UI elements like thumbs placed side-by-side (left|right), at the
417
- top, or at the bottom of a slideshow.
409
+ .Text controls
410
+ masterslider::ms_00007[role="mt-4 mb-5"]
418
411
 
419
- .Slider using ThumbInfo
420
- masterslider::ms_00007[]
421
412
 
422
413
  [role="mt-4"]
423
414
  [[partialview]]
@@ -445,32 +436,22 @@ documents:
445
436
  [role="mt-5"]
446
437
  == J1 Masonry
447
438
 
448
- J1 Masonry is based on the popular JavaScript library _Masonry_, enabling
449
- the creation of responsive, dynamic grid layouts of *groups* of content
450
- elements. It uses a unique algorithm to arrange elements vertically, then
451
- horizontally in a responsive grid.
439
+ J1 Masonry is a great tool to create dynamic image galleries. Image galleries
440
+ are popular on many websites, and masonry can be a useful tool for creating
441
+ dynamic and visually appealing galleries.
452
442
 
453
- The module provides a flexible configuration to enabling developers to
454
- customize the layout, adjust the column width, gutter size, and add
455
- animations.
456
-
457
- [role="mt-4"]
458
- === Grid of Images
443
+ [role="mb-4"]
444
+ By using masonry, you can create a gallery that displays images of different
445
+ sizes in an aesthetically pleasing and functional way.
459
446
 
460
- Bootstrap cards are a popular component of the Bootstrap front-end framework
461
- that provides a flexible and customizable way to display content on a website.
462
- Find an example below of how Bootstrap cards can be combined with the Masonry
463
- module for a fully responsive image grid.
447
+ .Image Cards
448
+ masonry::card_example[role="mb-5"]
464
449
 
465
450
  [TIP]
466
451
  ====
467
- Resize your browser window for the width to see the J1 Masonry module
468
- in action.
452
+ Change the size of your current browser width to see what will happen!
469
453
  ====
470
454
 
471
- .Grid of Images
472
- masonry::card_example[]
473
-
474
455
 
475
456
  [role="mt-5"]
476
457
  == JustifiedGallery
@@ -494,6 +475,7 @@ You'll have seen it in use all over the Internet!
494
475
  .Masonry Grid Gallery
495
476
  gallery::jg_customizer[]
496
477
 
478
+
497
479
  [role="mt-5"]
498
480
  == What next
499
481
 
@@ -23,6 +23,7 @@ image:
23
23
  width: 1920
24
24
  height: 1280
25
25
 
26
+ tts: false
26
27
  regenerate: false
27
28
  permalink: /pages/public/learn/roundtrip/responsive_tables/
28
29
 
@@ -73,13 +73,17 @@ mdi:clock-time-five-outline[24px, md-gray mr-2]
73
73
 
74
74
  // Include sub-documents (if any)
75
75
  // -----------------------------------------------------------------------------
76
- The crucial first step in finding your way to Jekyll is done. Congratulations.
77
- The *Learn* section contains all you need to expirience what Jekyll and J1
76
+ [role="mt-5"]
77
+ == Important Sections
78
+
79
+ The crucial first step in finding your way to Jekyll is done: congratulations.
80
+ The section *Learn* contains all you need to expirience what Jekyll and J1
78
81
  can do for your new website, for your new static web. You are welcome to spend
79
82
  some time diving into the techniques of creating modern static webs.
80
83
 
81
- [role="mt-5"]
82
- Roundtrip::
84
+ [role="mt-4"]
85
+ === Roundtrip
86
+
83
87
  In this section, you’ll find a tour to show some of the main features of
84
88
  the J1 Template. This trip covers how image data can be managed using
85
89
  J1, some background of the Theme's typography, discuss extensions, and
@@ -91,15 +95,20 @@ If you're interested what J1 Template can do, continue by walking through the
91
95
  roundtrip examples by starting an inspiring tour
92
96
  link:{url-j1-roundtrip--present-images}[from here].
93
97
 
94
- Cheatsheet::
95
- Cheat sheets are concise reference guides or summaries that provide quick
96
- and handy information about a topic or subject. They help you to remember
97
- key concepts, formulas, commands, or other essential details without
98
- consulting extensive documentation or resources. Find convenient quick
99
- references for _YAML_, _Git_ and more. For example, go for the cheatsheet
100
- link:{url-j1--cheatsheet-yaml}[YAML, {browser-window--new}].
98
+ [role="mt-4"]
99
+ === Cheatsheets
100
+
101
+ A cheatsheet is a helper text concise as a reference or summary to provide
102
+ quick and handy information about a topic or subject. They will help you to
103
+ remember key concepts, formulas, commands, or other essential details without
104
+ consulting extensive documentation or resources.
105
+
106
+ Find convenient quick references for _YAML_, _Git_ and more. For example,
107
+ go for the cheatsheet link:{url-j1--cheatsheet-yaml}[YAML, {browser-window--new}].
108
+
109
+ [role="mt-4"]
110
+ === Collections
101
111
 
102
- Collections::
103
112
  Collections are Jekyll’s most powerful and simultaneously least understood
104
113
  feature of the generator. Collections add another possibility, or use-case,
105
114
  outside of Jekyll’s post- and page-publishing functionality. Learn more
@@ -107,7 +116,9 @@ about collections for more powerful static websites. To learn more what
107
116
  collections are, check
108
117
  link:{url-j1--jekyll-collections}[Jekyll Collections, {browser-window--new}].
109
118
 
110
- Tutorials::
119
+ [role="mt-4"]
120
+ === Tutorials
121
+
111
122
  To become more familiar with using J1, go to the tutorial section. Have
112
123
  fun experiencing what Jekyll and J1 can do. A good starting point for using
113
124
  J1 Template is
@@ -57,8 +57,11 @@ resource_options:
57
57
  {% include {{load_attributes}} scope="global" %}
58
58
 
59
59
  ifeval::[{legal-warning} == true]
60
- WARNING: This document *does not* constitute any *legal advice*. It is
60
+ [WARNING]
61
+ ====
62
+ This document *does not* constitute any *legal advice*. It is
61
63
  highly recommended to verify legal aspects and implications.
64
+ ====
62
65
  endif::[]
63
66
 
64
67
 
@@ -60,8 +60,11 @@ resource_options:
60
60
  {% include {{load_attributes}} scope="none" %}
61
61
 
62
62
  ifeval::[{legal-warning} == true]
63
- WARNING: This document *does not* constitute any *legal advice*. It is
63
+ [WARNING]
64
+ ====
65
+ This document *does not* constitute any *legal advice*. It is
64
66
  highly recommended to verify legal aspects and implications.
67
+ ====
65
68
  endif::[]
66
69
 
67
70
  // NOTE