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.
- checksums.yaml +4 -4
- data/_includes/themes/j1/layouts/content_generator_post.html +19 -49
- data/_includes/themes/j1/procedures/posts/collate_timeline.proc +185 -192
- data/_includes/themes/j1/procedures/posts/create_series_header.proc +1 -14
- data/_includes/themes/j1/procedures/posts/pager.proc +39 -46
- data/assets/data/speak2me.html +9 -7
- data/assets/themes/j1/adapter/js/navigator.js +5 -2
- data/assets/themes/j1/adapter/js/speak2me.js +181 -46
- data/assets/themes/j1/core/css/themes/unolight/bootstrap.css +3 -0
- data/assets/themes/j1/core/css/themes/unolight/bootstrap.min.css +1 -1
- data/assets/themes/j1/core/js/template.js +165 -133
- data/assets/themes/j1/core/js/template.min.js +7 -7
- data/assets/themes/j1/core/js/template.min.js.map +1 -1
- data/lib/j1/version.rb +1 -1
- data/lib/starter_web/README.md +5 -5
- data/lib/starter_web/_config.yml +1 -1
- data/lib/starter_web/_data/blocks/footer.yml +6 -4
- data/lib/starter_web/_data/modules/defaults/blog_navigator.yml +89 -135
- data/lib/starter_web/_data/modules/defaults/speak2me.yml +8 -4
- data/lib/starter_web/_data/modules/navigator_menu.yml +14 -7
- data/lib/starter_web/_data/templates/feed.xml +1 -1
- data/lib/starter_web/_plugins/asciidoctor/carousel-block.rb +1 -1
- data/lib/starter_web/_plugins/asciidoctor/gallery-block.rb +1 -1
- data/lib/starter_web/_plugins/asciidoctor/lightbox-block.rb +1 -1
- data/lib/starter_web/_plugins/asciidoctor/masonry-block.rb +1 -1
- data/lib/starter_web/_plugins/asciidoctor/masterslider-block.rb +1 -1
- data/lib/starter_web/_plugins/asciidoctor/slick-block.rb +1 -1
- data/lib/starter_web/_plugins/index/lunr.rb +1 -1
- data/lib/starter_web/collections/posts/public/featured/_posts/0000-00-00-welcome-to-j1.adoc.erb +75 -71
- data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.adoc +110 -84
- data/lib/starter_web/collections/posts/public/featured/_posts/2021-02-01-static-site-generators.adoc +49 -33
- data/lib/starter_web/collections/posts/public/featured/_posts/2022-02-01-about-j1.adoc +47 -26
- data/lib/starter_web/package.json +1 -1
- data/lib/starter_web/pages/public/blog/navigator/archive/allview.html +66 -63
- data/lib/starter_web/pages/public/blog/navigator/archive/categoryview.html +76 -77
- data/lib/starter_web/pages/public/blog/navigator/archive/dateview.html +63 -64
- data/lib/starter_web/pages/public/blog/navigator/archive/tagview.html +79 -64
- data/lib/starter_web/pages/public/blog/navigator/index.html +55 -99
- data/lib/starter_web/pages/public/learn/roundtrip/_includes/documents/themes_bootstrap.asciidoc +2 -1
- data/lib/starter_web/pages/public/learn/roundtrip/asciidoc_extensions.adoc +39 -29
- data/lib/starter_web/pages/public/learn/roundtrip/bootstrap_themes.adoc +0 -3
- data/lib/starter_web/pages/public/learn/roundtrip/highlghter_rouge.adoc +1 -1
- data/lib/starter_web/pages/public/learn/roundtrip/icon_fonts.adoc +1 -0
- data/lib/starter_web/pages/public/learn/roundtrip/modal_extentions.adoc +1 -0
- data/lib/starter_web/pages/public/learn/roundtrip/present_images.adoc +44 -62
- data/lib/starter_web/pages/public/learn/roundtrip/responsive_tables.adoc +1 -0
- data/lib/starter_web/pages/public/learn/where_to_go.adoc +24 -13
- data/lib/starter_web/pages/public/legal/en/100_copyright.adoc +4 -1
- data/lib/starter_web/pages/public/legal/en/200_impress.adoc +4 -1
- data/lib/starter_web/pages/public/legal/en/300_privacy.adoc +632 -595
- data/lib/starter_web/pages/public/legal/en/400_comment_policy.adoc +12 -3
- data/lib/starter_web/pages/public/tools/previewer/preview_bootstrap_theme.adoc +3093 -3104
- data/lib/starter_web/utilsrv/_defaults/package.json +1 -1
- data/lib/starter_web/utilsrv/package.json +1 -1
- 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
|
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
|
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
|
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
|
108
|
-
* LightGallery
|
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
|
131
|
-
images. See how
|
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
|
168
|
-
|
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
|
182
|
-
a paragraph
|
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.
|
184
|
+
line.
|
185
185
|
|
186
186
|
[role="mt-4"]
|
187
187
|
=== Parallax Text Carousel
|
188
188
|
|
189
189
|
[role="mb-4"]
|
190
|
-
A more
|
191
|
-
you want to
|
192
|
-
|
193
|
-
|
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.
|
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
|
240
|
-
|
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
|
-
|
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
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
|
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
|
-
===
|
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
|
405
|
-
the bottom of a slideshow. Find two examples
|
406
|
-
|
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
|
-
.
|
409
|
-
masterslider::ms_00004[]
|
406
|
+
.Image controls
|
407
|
+
masterslider::ms_00004[role="mb-5"]
|
410
408
|
|
411
|
-
|
412
|
-
[
|
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
|
449
|
-
|
450
|
-
|
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
|
-
|
454
|
-
|
455
|
-
|
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
|
-
|
461
|
-
|
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
|
-
|
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
|
|
@@ -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
|
-
|
77
|
-
|
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-
|
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
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
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
|
-
|
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
|
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
|
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
|