j1-template 2024.2.0 → 2024.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. checksums.yaml +4 -4
  2. data/assets/data/gemini-ui.html +2 -2
  3. data/assets/themes/j1/adapter/js/advertising.js +2 -10
  4. data/assets/themes/j1/adapter/js/analytics.js +1 -5
  5. data/assets/themes/j1/adapter/js/bmd.js +195 -195
  6. data/assets/themes/j1/adapter/js/carousel.js +786 -786
  7. data/assets/themes/j1/adapter/js/clipboard.js +1 -0
  8. data/assets/themes/j1/adapter/js/comments.js +1 -0
  9. data/assets/themes/j1/adapter/js/cookieConsent.js +460 -466
  10. data/assets/themes/j1/adapter/js/customModule.js +5 -4
  11. data/assets/themes/j1/adapter/js/docsearch.js +1 -0
  12. data/assets/themes/j1/adapter/js/dropdowns.js +1 -0
  13. data/assets/themes/j1/adapter/js/fab.js +1 -0
  14. data/assets/themes/j1/adapter/js/gallery.js +495 -494
  15. data/assets/themes/j1/adapter/js/gemini.js +154 -128
  16. data/assets/themes/j1/adapter/js/iconPicker.js +257 -255
  17. data/assets/themes/j1/adapter/js/iconPickerPage.js +279 -279
  18. data/assets/themes/j1/adapter/js/iframer.js +3 -2
  19. data/assets/themes/j1/adapter/js/j1.js +3285 -3285
  20. data/assets/themes/j1/adapter/js/lazyLoader.js +241 -241
  21. data/assets/themes/j1/adapter/js/lightbox.js +242 -241
  22. data/assets/themes/j1/adapter/js/logger.js +1 -0
  23. data/assets/themes/j1/adapter/js/lunr.js +6 -10
  24. data/assets/themes/j1/adapter/js/masonry.js +427 -426
  25. data/assets/themes/j1/adapter/js/masterslider.js +526 -526
  26. data/assets/themes/j1/adapter/js/mmenu.js +1 -0
  27. data/assets/themes/j1/adapter/js/navigator.js +2 -2
  28. data/assets/themes/j1/adapter/js/particles.js +1 -0
  29. data/assets/themes/j1/adapter/js/rangeSlider.js +1 -0
  30. data/assets/themes/j1/adapter/js/rouge.js +288 -287
  31. data/assets/themes/j1/adapter/js/rtable.js +309 -309
  32. data/assets/themes/j1/adapter/js/slick.js +487 -487
  33. data/assets/themes/j1/adapter/js/slimSelect.js +3 -5
  34. data/assets/themes/j1/adapter/js/themeToggler.js +281 -280
  35. data/assets/themes/j1/adapter/js/themes.js +0 -1
  36. data/assets/themes/j1/adapter/js/toccer.js +1 -0
  37. data/assets/themes/j1/adapter/js/translator.js +1 -0
  38. data/assets/themes/j1/adapter/js/waves.js +1 -0
  39. data/assets/themes/j1/modules/cookieConsent/js/cookieConsent.js +23 -17
  40. data/assets/themes/j1/modules/js-cookies/js/js.cookie.js +147 -0
  41. data/assets/themes/j1/modules/js-cookies/js/js.cookie.min.js +2 -0
  42. data/lib/j1/version.rb +1 -1
  43. data/lib/starter_web/README.md +5 -5
  44. data/lib/starter_web/_config.yml +1 -1
  45. data/lib/starter_web/_data/modules/defaults/themes.yml +171 -171
  46. data/lib/starter_web/_data/resources.yml +26 -0
  47. data/lib/starter_web/_data/templates/feed.xml +1 -1
  48. data/lib/starter_web/_plugins/index/lunr.rb +1 -1
  49. data/lib/starter_web/package.json +1 -1
  50. data/lib/starter_web/pages/public/learn/roundtrip/present_images.adoc +500 -500
  51. metadata +4 -2
@@ -1,500 +1,500 @@
1
- ---
2
- title: Image Content
3
- title_extention: Lightboxes, Carousels, Sliders, and Galleries for J1 Template
4
- tagline: Present Images
5
-
6
- date: 2020-11-03
7
- #last_modified: 2023-01-01
8
-
9
- description: >
10
- J1 Template support valuable features to manage your image-based
11
- content using lightboxes, carousels, sliders, and galleries.
12
- The image modules of J1 Template offer a wide range of complex
13
- functionality based on powerful Open Source libraries like
14
- Lightbox V2, Master Slider, lightGallery, or Justified Gallery
15
- for high-end, masonry-styled preview maps.
16
- keywords: >
17
- open source, free, template, jekyll, jekyllone, web,
18
- sites, static, jamstack, bootstrap,
19
- image, lightbox, carousel, slider, gallery,
20
- lightbox2, master slider, lightgallery, justifiedgallery
21
-
22
- categories: [ Roundtrip ]
23
- tags: [ Module, Carousel, Lightbox, Image, Slider, Slick ]
24
-
25
- image:
26
- path: /assets/images/modules/attics/1920x1280/quino-al-2.jpg
27
- width: 1920
28
- height: 1280
29
-
30
- regenerate: false
31
- permalink: /pages/public/learn/roundtrip/present_images/
32
-
33
- resources: [
34
- animate,
35
- carousel, gallery, lightbox, lightgallery,
36
- masterslider, masonry, rouge, slick
37
- ]
38
- resource_options:
39
- - toccer:
40
- collapseDepth: 4
41
- - attic:
42
- slides:
43
- - url: /assets/images/modules/attics/1920x1280/quino-al-2.jpg
44
- alt: Photo by Quino Al Angel on Unsplash
45
- badge:
46
- type: unsplash
47
- author: Quino Al Angel
48
- href: //unsplash.com/@quinoal
49
- ---
50
-
51
- // Page Initializer
52
- // =============================================================================
53
- // Enable the Liquid Preprocessor
54
- :page-liquid:
55
-
56
- // Set (local) page attributes here
57
- // -----------------------------------------------------------------------------
58
- // :page--attr: <attr-value>
59
- :images-dir: {imagesdir}/pages/roundtrip/100_present_images
60
-
61
- // Load Liquid procedures
62
- // -----------------------------------------------------------------------------
63
- {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
64
-
65
- // Load page attributes
66
- // -----------------------------------------------------------------------------
67
- {% include {{load_attributes}} scope="all" %}
68
-
69
- // Page content
70
- // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71
- [role="dropcap"]
72
- Welcome to the preview page focussing on image modules. This page shows
73
- all of the powerful features of the J1 Template to manage your image-based
74
- content using lightboxes, carousels, sliders, grids, and galleries.
75
-
76
- The image-related modules of the J1 Template offer a wide range of complex
77
- functionality based on powerful Open Source libraries like Lightbox Version 2,
78
- lightGallery Version 2, Slick Slider, Master Slider, or Masonry and
79
- Justified-Gallery to create masonry-styled preview maps.
80
-
81
- mdi:clock-time-five-outline[24px, md-gray mt-5 mr-2]
82
- *10-15 Minutes* to read
83
-
84
- // Include sub-documents (if any)
85
- // -----------------------------------------------------------------------------
86
- // [role="notranslate"]
87
- [role="mt-5"]
88
- == Lightboxes
89
-
90
- A lightbox is a helper which displays enlarged, almost screen-filling versions
91
- of images while dimming the remainder of the page. The technique, introduced
92
- by Lightbox Version 2, gained widespread popularity thanks to its simple style.
93
- The term *lightbox* has been employed since then for Javascript libraries to
94
- support such functionality.
95
-
96
- For J1 Template, different lightbox modules are available:
97
-
98
- * Lightbox Version 2 (default)
99
- * lightGallery Version 2 (optional)
100
- * Slick Lightbox (optional, currently for Slick Carousels only)
101
-
102
- The *default* tool employed by J1 Template is Lightbox V2, a Javascript
103
- library written by _Lokesh Dhakar_ free to use for private or business
104
- websites. For more complex use cases, like a thumbnail gallery preview or
105
- video support, *lightGallery* can be used alternatively.
106
-
107
- [CAUTION]
108
- ====
109
- lightGallery is *free* to use based on a GPLv3 license for *non-business*
110
- websites. If you have plans to use this lightbox for your business or on a
111
- commercial site, you need to subscribe a so-called *Commercial License*. Find
112
- more on the *paid* solution on the page:
113
- https://www.lightgalleryjs.com/license[lightGallery license, {browser-window--new}].
114
- ====
115
-
116
- All lightboxes are fully integrated to be used as standalone modules or
117
- used as helpers *under-the-hood* by other modules focussing on image-data
118
- like gallerys or carousels.
119
-
120
- [TIP]
121
- ====
122
- For details of the default lightbox of J1 Template, see the documentation
123
- under the link:{url-j1-docs--lightbox-module}[Lightbox module, {browser-window--new}].
124
- ====
125
-
126
- [role="mt-5"]
127
- === J1 Lightbox
128
-
129
- Find below an example of using the the default lightbox used for standalone
130
- images. See how individual images are linked.
131
-
132
- .Lightbox for standalone images
133
- lightbox::example-standalone[800, {data-images-standalone}, role="mt-4 mb-5"]
134
-
135
- The J1 lightbox module supports groups of images as well. Click on the image
136
- group below to see how a group is managed.
137
-
138
- .Lightbox for grouped images
139
- lightbox::example-group[395, {data-images-group}, group, role="mt-4 mb-4 wm-800"]
140
-
141
-
142
- [role="mt-5"]
143
- === J1 lightGallery
144
-
145
- lightGallery provides more complex image data functions than the default
146
- lightbox. The module supports a gallery-style thumbnail preview plus image
147
- resizing, a download dialog, sharing provider support, and more helpful.
148
- Check what lightGallery can do this by the following example.
149
-
150
- .J1 Gallery + lightGallery
151
- gallery::jg_old_times[role="mt-4 mb-4"]
152
-
153
- .lightGallery - Gallery or Lightbox
154
- [NOTE]
155
- ====
156
- The name lightGallery implies a sort of a gallery, but the library is a
157
- *lightbox*, and provides enhannced functionality on image-based data rather
158
- than enlarged displaying of images.
159
- ====
160
-
161
- [role="mt-5"]
162
- == J1 Carousel
163
-
164
- J1 Carousel is based on OWL Carousel V1 in the latest version. The carousel
165
- is a powerful jQuery plugin for creating fully responsive and touch-enabled
166
- carousel slideshows.
167
-
168
- [role="mt-4"]
169
- === Text Carousels
170
-
171
- A slider or carousel is typically used for displaying images. Still, the
172
- implementation for the J1 Template supports a lot more sources to be
173
- displayed as a slide show -- simple text for example.
174
-
175
- [role="mt-4"]
176
- ==== Base Text Carousel
177
-
178
- Important statements or topics can be placed on top of an article or
179
- a paragraph to give them better visibility. In one line, you can present
180
- many facts to know animated for the reader's attention within a single
181
- line.
182
-
183
- .Base Text Carousel
184
- carousel::demo_text_carousel[role="mb-4"]
185
-
186
- [role="mt-4"]
187
- ==== Parallax Text Carousel
188
-
189
- A more emphasized type of text-based carousel is a parallax text slider. If
190
- you want to focus the meaning, this kind of a slide show may be interesting.
191
- Image-based slide shows may draw off the reader's attention from the text,
192
- therefore a pure text-based presentation maybe the better choice.
193
-
194
- .Parallax Text Carousel
195
- carousel::demo_text_carousel_parallax[role="mb-4"]
196
-
197
- Parallax text shows can be placed as banners on a page. For text shows,
198
- different animations are available. Internally, J1 Template uses some of
199
- the great CSS styles offered by _animate.css_.
200
-
201
- [TIP]
202
- ====
203
- Have a look a https://daneden.github.io/animate.css/[Dan Eden's home page, {browser-window--new}]
204
- to see all the possible dynamic styles you can create based on pure CSS.
205
- Some of them are implemented for the J1 Carousel for animation. See the
206
- documentation for the
207
- link:{url-j1-docs--carousel-module}[Carousel module, {browser-window--new}]
208
- for more details.
209
- ====
210
-
211
- [role="mt-5"]
212
- === Image Carousels
213
-
214
- Carousels are mostly used for pictures data to animate the images as a series.
215
- Find with the following some examples of how to use a carousel for your image
216
- data.
217
-
218
- A simple image show is useful, for example, as an animated (or not animated)
219
- banner presenting exciting things about your site or the products offered.
220
-
221
- .Image Carousel
222
- carousel::demo_simple[role="mb-5"]
223
-
224
- [role="mt-4"]
225
- ==== Image Carousel + Lightbox
226
-
227
- Carousels are used for an exceptionally compact form of image galleries.
228
- This example shows some pictures having individual caption text and supports
229
- a lightbox to enlarge images full size.
230
-
231
- .Image Carousel + Lightbox
232
- carousel::demo_cats[role="mt-4 mb-5"]
233
-
234
- The J1 module lightbox is a simple Lightbox but offers a bunch of impressive
235
- features for displaying images. For example, the lightbox can display all
236
- images as a group. If one picture is opened in the lightbox, others are
237
- browsed by easy-to-use control buttons.
238
-
239
- [role="mt-4"]
240
- ==== One Slide Carousel + Lightbox
241
-
242
- The build-in carousel supports multiple and single image shows. Here you find
243
- an example of a single image slide show with controls enabled to browse all
244
- images back and forth. An indicator below the slider shows how many images
245
- the show contains.
246
-
247
- .One Slide Carousel
248
- carousel::demo_oneslide[role="mb-4"]
249
-
250
-
251
- [role="mt-5"]
252
- == J1 Slick Carousel
253
-
254
- [role="mb-4"]
255
- Slick is a popular jQuery plugin for creating responsive and fully
256
- customizable carousels. It allows developers to easily create beautiful
257
- and dynamic carousels that can display images, videos, or any other type
258
- of content in a visually appealing way.
259
-
260
- The plugin is designed to be lightweight, fast, and easy to use, making it
261
- a popular choice for all web developers. It has many features, including
262
- multiple navigation options, lazy loading, or autoplay. Slick carousels are
263
- compatible with all modern browsers and devices, making it a great choice to
264
- create a responsive and mobile-friendly website.
265
-
266
- All Slick carousels for the J1 Template can be easily customized in
267
- various ways, such as changing the number of posts displayed, the slider
268
- speed, or the navigation options like *Arrows* and *Dots*.
269
-
270
- [role="mt-4"]
271
- [[slick-image-carousel]]
272
- === Image Carousel
273
-
274
- [role="mb-4"]
275
- An _Slick_ image carousel typically consists of a container with images and
276
- a navigation system, including buttons, arrows, or dots that allow users to
277
- move back and forth between images or select a specific image. Image carousels
278
- can also include animation effects, such as fade-in or slide-in transitions
279
- between images, to make the presentation more engaging and visually appealing.
280
-
281
- .Carousel + Arrows + Dots + Captions + Lightbox
282
- slick::image_carousel_full[role="mt-4 mb-5"]
283
-
284
- [role="mt-4"]
285
- === Carousel from Collections
286
-
287
- [role="mb-4"]
288
- A carousel from a collection for J1 Template is a *pre-defined* element
289
- type to display *articles* from a Jekyll collection on a webpage. All
290
- carousels for collections display the article image and a link to the article
291
- as a caption.
292
-
293
- .Collection Biography + Arrows + Dots + Gutters
294
- slick::collection_carousel_biography[role="mt-4 mb-5"]
295
-
296
- [role="mt-4"]
297
- === Carousel from Posts
298
-
299
- A Carousel from posts for J1 Template is a *pre-defined* carousel type to
300
- display post articles on a webpage. It is a popular way to showcase a
301
- selection of post articles visually appealingly and can be useful for
302
- highlighting important or *featured* content for your posts content.
303
-
304
- [role="mb-4"]
305
- Post carousels pull news articles from a specific *group*. All Carousels for
306
- posts display the post category, the title, the author information and
307
- date.
308
-
309
- .Asciidoc configuration
310
- [source, apib, role="noclip mb-3"]
311
- ----
312
- slick::post_carousel_featured[]
313
- ----
314
-
315
- .Posts Carousel
316
- slick::post_carousel_featured[role="mt-5 mb-5"]
317
-
318
- [role="mt-4"]
319
- .More about Slick Carousels
320
- [TIP]
321
- ====
322
- If you're interested to learn more about _Slick_, go previewer page
323
- link:{url-j1-slick-previewer}[Slick Previewer, {browser-window--new}],
324
- ====
325
-
326
- [role="mt-5"]
327
- [[masterSlider]]
328
- == J1 Masterslider
329
-
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.
335
-
336
- [role="mt-4"]
337
- [[carousel_versus_slider]]
338
- === Carousel versus Slider
339
-
340
- Sliders and Carousels are focussing quite the same thing: presenting images
341
- dynamically. The features of Sliders go far beyond what simple carousels can
342
- do: presenting image-based data as slide *shows*.
343
-
344
- Well-known Office Products to create *presentations* are Powerpoint from
345
- _Microsoft_ or _Google Docs_. Modern sliders like _Master Slider_ provide
346
- similar features to present animated presentations based on digital image
347
- data combined with text elements, buttons, or overlay techniques for images
348
- or other digital data sources.
349
-
350
- In short: Carousels are used to present images, and sliders are used to create
351
- complex image-based presentations.
352
-
353
- [TIP]
354
- ====
355
- For more details of the implementation of Master Slider for J1 Template, find
356
- more helpful information at the page
357
- link:{url-j1-docs--masterslider-module}[Master Slider module, {browser-window--new}].
358
- ====
359
-
360
- [role="mt-5"]
361
- === Featured MS Slider
362
-
363
- The following slider uses the CSS filter feature of Master Slider. Filters
364
- can be used, for example, to *transform* the *style* of the images presented
365
- by a slider. In this example, the slider images are transformed from style
366
- *color* to *sepia*.
367
-
368
- [WARNING]
369
- ====
370
- Lightbox support is only available for the MS Lite version of J1 Template.
371
- The original Product versions *MS Lite* and *MS Pro* does not support
372
- lightboxes on sliders out-of-the-box.
373
- ====
374
-
375
- .Slider using Controls + Filters + Lightbox
376
- masterslider::ms_00002[role="mt-5 mb-5"]
377
-
378
- [TIP]
379
- ====
380
- Click on the Lightbox symbol mdi:image-outline[18px, md-gray] in the
381
- slides to see the *colored* images configured for the slider.
382
- ====
383
-
384
- [role="mt-5"]
385
- [[text_elements]]
386
- === MS Slider using Text Elements
387
-
388
- One of the major features of sliders is to present additional animated
389
- elements, like text data, connected to the images presented by an slideshow.
390
- MS Slider additionally provides functions to combine images and text by
391
- so-called *MSInfo* blocks out-of-the-box.
392
-
393
- .Slider using Images + Text
394
- masterslider::ms_00003[role="mt-4 mb-5"]
395
-
396
- [role="mt-4"]
397
- [[thumb_images]]
398
- === Slider using Thumb Elements
399
-
400
- To give the users better control over a slideshow, sliders provide complex UI
401
- elements to place dor example mini-images or short text elements side-by-side
402
- left or right, or at the bottom of a slideshow. Find two examples below how
403
- to control such a carousel element.
404
-
405
- .Image controls
406
- masterslider::ms_00004[role="mt-4 mb-5"]
407
-
408
- .Text controls
409
- masterslider::ms_00007[role="mt-4 mb-5"]
410
-
411
-
412
- [role="mt-4"]
413
- [[partialview]]
414
- === MS Slider using Layout PartialView
415
-
416
- The following slider presents a slideshow that combines an MSInfo element
417
- at the bottom and the MS Layout `partialview`. A slideshow typically presents
418
- a larger number of slides. The layout `partialview` accompanies the active
419
- slide by their neighbors on the left and the right.
420
-
421
- .Slider using PartialView
422
- masterslider::ms_00009[role="mt-4 mb-5"]
423
-
424
- [role="mt-4"]
425
- .More about Master Slider
426
- [TIP]
427
- ====
428
- If you're interested to learn more about Master Slider, go for the following
429
- documents:
430
-
431
- * MS Slider link:{url-j1-masterslider-previewer}[Previewer, {browser-window--new}]
432
- * MS Slider link:{url-j1-docs--masterslider-module}[Module documentation, {browser-window--new}]
433
- ====
434
-
435
-
436
- [role="mt-5"]
437
- == J1 Masonry
438
-
439
- Masonry for J1 is a great tool to create dynamic image galleries. Image
440
- galleries are popular on many websites, and masonry can be a useful tool for
441
- creating dynamic galleries.
442
-
443
- By using the Masonry module, you can create a gallery that displays images of
444
- different sizes in an aesthetically pleasing and functional way.
445
-
446
- .Grid of Images
447
- masonry::image_fixed_height_lb[role="mt-4 mb-5"]
448
-
449
- .More about Masonry
450
- [TIP]
451
- ====
452
- Find more on how the Masonry module can be used on the
453
- link:{url-j1-masonry-previewer}[Masonry Preview, {browser-window--new}] page.
454
- ====
455
-
456
-
457
- [role="mt-5"]
458
- == J1 Gallery
459
-
460
- link:{url-justified-gallery--home}[JustifiedGallery, {browser-window--new}]
461
- is a great _jQuery_ Plugin to create responsive, infinite, and high-quality
462
- justified image galleries. J1 Template combines the Gallery with the lightboxes
463
- supported to enlarge the images of a gallery. See the gallery in action; and
464
- for sure, all that you see is even responsive. Change the size of your current
465
- browser window, by width or height to see what will happen!
466
-
467
- [role="mb-4"]
468
- Pictures you've made are typically not even in size. Images may have the
469
- same size (resolution), but some are orientated landscapes, or others
470
- may be portraits. For that reason, a more powerful gallery is needed to create
471
- so-called justified views. J1 Gallery is based on Justified Gallery to create
472
- so-called masonry grid layouts.
473
-
474
- It works by placing elements in an optimal position based on available
475
- horizontal and vertical space. Sort of like mason fitting stones in a wall.
476
- For sure, you'll have seen it in action all over the Internet.
477
-
478
- .J1 Gallery of Images + lightGallery
479
- gallery::jg_mega_cities[role="mt-4 mb-4"]
480
-
481
-
482
- [role="mt-5"]
483
- == What next
484
-
485
- I hope, you've enjoyed exploring the possibilities J1 offers for managing
486
- and displaying digital image content. But much, much more can the J1 do for
487
- your web.
488
-
489
- The J1 Template support playing audio and video on web pages by using the
490
- HTML5 audio and video support, the new standard of HTML. HTML5 implements a
491
- pure HTML way to show play audio or playing video on the web. Modern browsers
492
- support the audio tag `<audio>` and the video tag `<video>` for the HTML5
493
- standard.
494
-
495
- The previous proprietary de facto standard software like a Flash Player,
496
- Quicktime, or Silverlight is no longer needed as the Theme JekyllOne provides
497
- HTML5 video for local content and from online sources on the Internet.
498
-
499
- [role="mb-7"]
500
- Incredible? See the next example page link:{url-roundtrip--present-audio-video}[Present Audio and Video].
1
+ ---
2
+ title: Image Content
3
+ title_extention: Lightboxes, Carousels, Sliders, and Galleries for J1 Template
4
+ tagline: Present Images
5
+
6
+ date: 2020-11-03
7
+ #last_modified: 2023-01-01
8
+
9
+ description: >
10
+ J1 Template support valuable features to manage your image-based
11
+ content using lightboxes, carousels, sliders, and galleries.
12
+ The image modules of J1 Template offer a wide range of complex
13
+ functionality based on powerful Open Source libraries like
14
+ Lightbox V2, Master Slider, lightGallery, or Justified Gallery
15
+ for high-end, masonry-styled preview maps.
16
+ keywords: >
17
+ open source, free, template, jekyll, jekyllone, web,
18
+ sites, static, jamstack, bootstrap,
19
+ image, lightbox, carousel, slider, gallery,
20
+ lightbox2, master slider, lightgallery, justifiedgallery
21
+
22
+ categories: [ Roundtrip ]
23
+ tags: [ Module, Carousel, Lightbox, Image, Slider, Slick ]
24
+
25
+ image:
26
+ path: /assets/images/modules/attics/1920x1280/quino-al-2.jpg
27
+ width: 1920
28
+ height: 1280
29
+
30
+ regenerate: false
31
+ permalink: /pages/public/learn/roundtrip/present_images/
32
+
33
+ resources: [
34
+ animate,
35
+ carousel, gallery, lightbox, lightgallery,
36
+ masterslider, masonry, rouge, slick
37
+ ]
38
+ resource_options:
39
+ - toccer:
40
+ collapseDepth: 4
41
+ - attic:
42
+ slides:
43
+ - url: /assets/images/modules/attics/1920x1280/quino-al-2.jpg
44
+ alt: Photo by Quino Al Angel on Unsplash
45
+ badge:
46
+ type: unsplash
47
+ author: Quino Al Angel
48
+ href: //unsplash.com/@quinoal
49
+ ---
50
+
51
+ // Page Initializer
52
+ // =============================================================================
53
+ // Enable the Liquid Preprocessor
54
+ :page-liquid:
55
+
56
+ // Set (local) page attributes here
57
+ // -----------------------------------------------------------------------------
58
+ // :page--attr: <attr-value>
59
+ :images-dir: {imagesdir}/pages/roundtrip/100_present_images
60
+
61
+ // Load Liquid procedures
62
+ // -----------------------------------------------------------------------------
63
+ {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
64
+
65
+ // Load page attributes
66
+ // -----------------------------------------------------------------------------
67
+ {% include {{load_attributes}} scope="all" %}
68
+
69
+ // Page content
70
+ // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71
+ [role="dropcap"]
72
+ Welcome to the preview page focussing on image modules. This page shows
73
+ all of the powerful features of the J1 Template to manage your image-based
74
+ content using lightboxes, carousels, sliders, grids, and galleries.
75
+
76
+ The image-related modules of the J1 Template offer a wide range of complex
77
+ functionality based on powerful Open Source libraries like Lightbox Version 2,
78
+ lightGallery Version 2, Slick Slider, Master Slider, or Masonry and
79
+ Justified-Gallery to create masonry-styled preview maps.
80
+
81
+ mdi:clock-time-five-outline[24px, md-gray mt-5 mr-2]
82
+ *10-15 Minutes* to read
83
+
84
+ // Include sub-documents (if any)
85
+ // -----------------------------------------------------------------------------
86
+ // [role="notranslate"]
87
+ [role="mt-5"]
88
+ == Lightboxes
89
+
90
+ A lightbox is a helper which displays enlarged, almost screen-filling versions
91
+ of images while dimming the remainder of the page. The technique, introduced
92
+ by Lightbox Version 2, gained widespread popularity thanks to its simple style.
93
+ The term *lightbox* has been employed since then for Javascript libraries to
94
+ support such functionality.
95
+
96
+ For J1 Template, different lightbox modules are available:
97
+
98
+ * Lightbox Version 2 (default)
99
+ * lightGallery Version 2 (optional)
100
+ * Slick Lightbox (optional, currently for Slick Carousels only)
101
+
102
+ The *default* tool employed by J1 Template is Lightbox V2, a Javascript
103
+ library written by _Lokesh Dhakar_ free to use for private or business
104
+ websites. For more complex use cases, like a thumbnail gallery preview or
105
+ video support, *lightGallery* can be used alternatively.
106
+
107
+ [CAUTION]
108
+ ====
109
+ lightGallery is *free* to use based on a GPLv3 license for *non-business*
110
+ websites. If you have plans to use this lightbox for your business or on a
111
+ commercial site, you need to subscribe a so-called *Commercial License*. Find
112
+ more on the *paid* solution on the page:
113
+ https://www.lightgalleryjs.com/license[lightGallery license, {browser-window--new}].
114
+ ====
115
+
116
+ All lightboxes are fully integrated to be used as standalone modules or
117
+ used as helpers *under-the-hood* by other modules focussing on image-data
118
+ like gallerys or carousels.
119
+
120
+ [TIP]
121
+ ====
122
+ For details of the default lightbox of J1 Template, see the documentation
123
+ under the link:{url-j1-docs--lightbox-module}[Lightbox module, {browser-window--new}].
124
+ ====
125
+
126
+ [role="mt-5"]
127
+ === J1 Lightbox
128
+
129
+ Find below an example of using the the default lightbox used for standalone
130
+ images. See how individual images are linked.
131
+
132
+ .Lightbox for standalone images
133
+ lightbox::example-standalone[800, {data-images-standalone}, role="mt-4 mb-5"]
134
+
135
+ The J1 lightbox module supports groups of images as well. Click on the image
136
+ group below to see how a group is managed.
137
+
138
+ .Lightbox for grouped images
139
+ lightbox::example-group[395, {data-images-group}, group, role="mt-4 mb-4 wm-800"]
140
+
141
+
142
+ [role="mt-5"]
143
+ === J1 lightGallery
144
+
145
+ lightGallery provides more complex image data functions than the default
146
+ lightbox. The module supports a gallery-style thumbnail preview plus image
147
+ resizing, a download dialog, sharing provider support, and more helpful.
148
+ Check what lightGallery can do this by the following example.
149
+
150
+ .J1 Gallery + lightGallery
151
+ gallery::jg_old_times[role="mt-4 mb-4"]
152
+
153
+ .lightGallery - Gallery or Lightbox
154
+ [NOTE]
155
+ ====
156
+ The name lightGallery implies a sort of a gallery, but the library is a
157
+ *lightbox*, and provides enhannced functionality on image-based data rather
158
+ than enlarged displaying of images.
159
+ ====
160
+
161
+ [role="mt-5"]
162
+ == J1 Carousel
163
+
164
+ J1 Carousel is based on OWL Carousel V1 in the latest version. The carousel
165
+ is a powerful jQuery plugin for creating fully responsive and touch-enabled
166
+ carousel slideshows.
167
+
168
+ [role="mt-4"]
169
+ === Text Carousels
170
+
171
+ A slider or carousel is typically used for displaying images. Still, the
172
+ implementation for the J1 Template supports a lot more sources to be
173
+ displayed as a slide show -- simple text for example.
174
+
175
+ [role="mt-4"]
176
+ ==== Base Text Carousel
177
+
178
+ Important statements or topics can be placed on top of an article or
179
+ a paragraph to give them better visibility. In one line, you can present
180
+ many facts to know animated for the reader's attention within a single
181
+ line.
182
+
183
+ .Base Text Carousel
184
+ carousel::demo_text_carousel[role="mb-4"]
185
+
186
+ [role="mt-4"]
187
+ ==== Parallax Text Carousel
188
+
189
+ A more emphasized type of text-based carousel is a parallax text slider. If
190
+ you want to focus the meaning, this kind of a slide show may be interesting.
191
+ Image-based slide shows may draw off the reader's attention from the text,
192
+ therefore a pure text-based presentation maybe the better choice.
193
+
194
+ .Parallax Text Carousel
195
+ carousel::demo_text_carousel_parallax[role="mb-4"]
196
+
197
+ Parallax text shows can be placed as banners on a page. For text shows,
198
+ different animations are available. Internally, J1 Template uses some of
199
+ the great CSS styles offered by _animate.css_.
200
+
201
+ [TIP]
202
+ ====
203
+ Have a look a https://daneden.github.io/animate.css/[Dan Eden's home page, {browser-window--new}]
204
+ to see all the possible dynamic styles you can create based on pure CSS.
205
+ Some of them are implemented for the J1 Carousel for animation. See the
206
+ documentation for the
207
+ link:{url-j1-docs--carousel-module}[Carousel module, {browser-window--new}]
208
+ for more details.
209
+ ====
210
+
211
+ [role="mt-5"]
212
+ === Image Carousels
213
+
214
+ Carousels are mostly used for pictures data to animate the images as a series.
215
+ Find with the following some examples of how to use a carousel for your image
216
+ data.
217
+
218
+ A simple image show is useful, for example, as an animated (or not animated)
219
+ banner presenting exciting things about your site or the products offered.
220
+
221
+ .Image Carousel
222
+ carousel::demo_simple[role="mb-5"]
223
+
224
+ [role="mt-4"]
225
+ ==== Image Carousel + Lightbox
226
+
227
+ Carousels are used for an exceptionally compact form of image galleries.
228
+ This example shows some pictures having individual caption text and supports
229
+ a lightbox to enlarge images full size.
230
+
231
+ .Image Carousel + Lightbox
232
+ carousel::demo_cats[role="mt-4 mb-5"]
233
+
234
+ The J1 module lightbox is a simple Lightbox but offers a bunch of impressive
235
+ features for displaying images. For example, the lightbox can display all
236
+ images as a group. If one picture is opened in the lightbox, others are
237
+ browsed by easy-to-use control buttons.
238
+
239
+ [role="mt-4"]
240
+ ==== One Slide Carousel + Lightbox
241
+
242
+ The build-in carousel supports multiple and single image shows. Here you find
243
+ an example of a single image slide show with controls enabled to browse all
244
+ images back and forth. An indicator below the slider shows how many images
245
+ the show contains.
246
+
247
+ .One Slide Carousel
248
+ carousel::demo_oneslide[role="mb-4"]
249
+
250
+
251
+ [role="mt-5"]
252
+ == J1 Slick Carousel
253
+
254
+ [role="mb-4"]
255
+ Slick is a popular jQuery plugin for creating responsive and fully
256
+ customizable carousels. It allows developers to easily create beautiful
257
+ and dynamic carousels that can display images, videos, or any other type
258
+ of content in a visually appealing way.
259
+
260
+ The plugin is designed to be lightweight, fast, and easy to use, making it
261
+ a popular choice for all web developers. It has many features, including
262
+ multiple navigation options, lazy loading, or autoplay. Slick carousels are
263
+ compatible with all modern browsers and devices, making it a great choice to
264
+ create a responsive and mobile-friendly website.
265
+
266
+ All Slick carousels for the J1 Template can be easily customized in
267
+ various ways, such as changing the number of posts displayed, the slider
268
+ speed, or the navigation options like *Arrows* and *Dots*.
269
+
270
+ [role="mt-4"]
271
+ [[slick-image-carousel]]
272
+ === Image Carousel
273
+
274
+ [role="mb-4"]
275
+ An _Slick_ image carousel typically consists of a container with images and
276
+ a navigation system, including buttons, arrows, or dots that allow users to
277
+ move back and forth between images or select a specific image. Image carousels
278
+ can also include animation effects, such as fade-in or slide-in transitions
279
+ between images, to make the presentation more engaging and visually appealing.
280
+
281
+ .Carousel + Arrows + Dots + Captions + Lightbox
282
+ slick::image_carousel_full[role="mt-4 mb-5"]
283
+
284
+ [role="mt-4"]
285
+ === Carousel from Collections
286
+
287
+ [role="mb-4"]
288
+ A carousel from a collection for J1 Template is a *pre-defined* element
289
+ type to display *articles* from a Jekyll collection on a webpage. All
290
+ carousels for collections display the article image and a link to the article
291
+ as a caption.
292
+
293
+ .Collection Biography + Arrows + Dots + Gutters
294
+ slick::collection_carousel_biography[role="mt-4 mb-5"]
295
+
296
+ [role="mt-4"]
297
+ === Carousel from Posts
298
+
299
+ A Carousel from posts for J1 Template is a *pre-defined* carousel type to
300
+ display post articles on a webpage. It is a popular way to showcase a
301
+ selection of post articles visually appealingly and can be useful for
302
+ highlighting important or *featured* content for your posts content.
303
+
304
+ [role="mb-4"]
305
+ Post carousels pull news articles from a specific *group*. All Carousels for
306
+ posts display the post category, the title, the author information and
307
+ date.
308
+
309
+ .Asciidoc configuration
310
+ [source, apib, role="noclip mb-3"]
311
+ ----
312
+ slick::post_carousel_featured[]
313
+ ----
314
+
315
+ .Posts Carousel
316
+ slick::post_carousel_featured[role="mt-5 mb-5"]
317
+
318
+ [role="mt-4"]
319
+ .More about Slick Carousels
320
+ [TIP]
321
+ ====
322
+ If you're interested to learn more about _Slick_, go previewer page
323
+ link:{url-j1-slick-previewer}[Slick Previewer, {browser-window--new}],
324
+ ====
325
+
326
+ [role="mt-5"]
327
+ [[masterSlider]]
328
+ == J1 Masterslider
329
+
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.
335
+
336
+ [role="mt-4"]
337
+ [[carousel_versus_slider]]
338
+ === Carousel versus Slider
339
+
340
+ Sliders and Carousels are focussing quite the same thing: presenting images
341
+ dynamically. The features of Sliders go far beyond what simple carousels can
342
+ do: presenting image-based data as slide *shows*.
343
+
344
+ Well-known Office Products to create *presentations* are Powerpoint from
345
+ _Microsoft_ or _Google Docs_. Modern sliders like _Master Slider_ provide
346
+ similar features to present animated presentations based on digital image
347
+ data combined with text elements, buttons, or overlay techniques for images
348
+ or other digital data sources.
349
+
350
+ In short: Carousels are used to present images, and sliders are used to create
351
+ complex image-based presentations.
352
+
353
+ [TIP]
354
+ ====
355
+ For more details of the implementation of Master Slider for J1 Template, find
356
+ more helpful information at the page
357
+ link:{url-j1-docs--masterslider-module}[Master Slider module, {browser-window--new}].
358
+ ====
359
+
360
+ [role="mt-5"]
361
+ === Featured MS Slider
362
+
363
+ The following slider uses the CSS filter feature of Master Slider. Filters
364
+ can be used, for example, to *transform* the *style* of the images presented
365
+ by a slider. In this example, the slider images are transformed from style
366
+ *color* to *sepia*.
367
+
368
+ [WARNING]
369
+ ====
370
+ Lightbox support is only available for the MS Lite version of J1 Template.
371
+ The original Product versions *MS Lite* and *MS Pro* does not support
372
+ lightboxes on sliders out-of-the-box.
373
+ ====
374
+
375
+ .Slider using Controls + Filters + Lightbox
376
+ masterslider::ms_00002[role="mt-5 mb-5"]
377
+
378
+ [TIP]
379
+ ====
380
+ Click on the Lightbox symbol mdi:image-outline[18px, md-gray] in the
381
+ slides to see the *colored* images configured for the slider.
382
+ ====
383
+
384
+ [role="mt-5"]
385
+ [[text_elements]]
386
+ === MS Slider using Text Elements
387
+
388
+ One of the major features of sliders is to present additional animated
389
+ elements, like text data, connected to the images presented by an slideshow.
390
+ MS Slider additionally provides functions to combine images and text by
391
+ so-called *MSInfo* blocks out-of-the-box.
392
+
393
+ .Slider using Images + Text
394
+ masterslider::ms_00003[role="mt-4 mb-5"]
395
+
396
+ [role="mt-4"]
397
+ [[thumb_images]]
398
+ === Slider using Thumb Elements
399
+
400
+ To give the users better control over a slideshow, sliders provide complex UI
401
+ elements to place dor example mini-images or short text elements side-by-side
402
+ left or right, or at the bottom of a slideshow. Find two examples below how
403
+ to control such a carousel element.
404
+
405
+ .Image controls
406
+ masterslider::ms_00004[role="mt-4 mb-5"]
407
+
408
+ .Text controls
409
+ masterslider::ms_00007[role="mt-4 mb-5"]
410
+
411
+
412
+ [role="mt-4"]
413
+ [[partialview]]
414
+ === MS Slider using Layout PartialView
415
+
416
+ The following slider presents a slideshow that combines an MSInfo element
417
+ at the bottom and the MS Layout `partialview`. A slideshow typically presents
418
+ a larger number of slides. The layout `partialview` accompanies the active
419
+ slide by their neighbors on the left and the right.
420
+
421
+ .Slider using PartialView
422
+ masterslider::ms_00009[role="mt-4 mb-5"]
423
+
424
+ [role="mt-4"]
425
+ .More about Master Slider
426
+ [TIP]
427
+ ====
428
+ If you're interested to learn more about Master Slider, go for the following
429
+ documents:
430
+
431
+ * MS Slider link:{url-j1-masterslider-previewer}[Previewer, {browser-window--new}]
432
+ * MS Slider link:{url-j1-docs--masterslider-module}[Module documentation, {browser-window--new}]
433
+ ====
434
+
435
+
436
+ [role="mt-5"]
437
+ == J1 Masonry
438
+
439
+ Masonry for J1 is a great tool to create dynamic image galleries. Image
440
+ galleries are popular on many websites, and masonry can be a useful tool for
441
+ creating dynamic galleries.
442
+
443
+ By using the Masonry module, you can create a gallery that displays images of
444
+ different sizes in an aesthetically pleasing and functional way.
445
+
446
+ .Grid of Images
447
+ masonry::image_fixed_height_lb[role="mt-4 mb-5"]
448
+
449
+ .More about Masonry
450
+ [TIP]
451
+ ====
452
+ Find more on how the Masonry module can be used on the
453
+ link:{url-j1-masonry-previewer}[Masonry Preview, {browser-window--new}] page.
454
+ ====
455
+
456
+
457
+ [role="mt-5"]
458
+ == J1 Gallery
459
+
460
+ link:{url-justified-gallery--home}[JustifiedGallery, {browser-window--new}]
461
+ is a great _jQuery_ Plugin to create responsive, infinite, and high-quality
462
+ justified image galleries. J1 Template combines the Gallery with the lightboxes
463
+ supported to enlarge the images of a gallery. See the gallery in action; and
464
+ for sure, all that you see is even responsive. Change the size of your current
465
+ browser window, by width or height to see what will happen!
466
+
467
+ [role="mb-4"]
468
+ Pictures you've made are typically not even in size. Images may have the
469
+ same size (resolution), but some are orientated landscapes, or others
470
+ may be portraits. For that reason, a more powerful gallery is needed to create
471
+ so-called justified views. J1 Gallery is based on Justified Gallery to create
472
+ so-called masonry grid layouts.
473
+
474
+ It works by placing elements in an optimal position based on available
475
+ horizontal and vertical space. Sort of like mason fitting stones in a wall.
476
+ For sure, you'll have seen it in action all over the Internet.
477
+
478
+ .J1 Gallery of Images + lightGallery
479
+ gallery::jg_mega_cities[role="mt-4 mb-4"]
480
+
481
+
482
+ [role="mt-5"]
483
+ == What next
484
+
485
+ I hope, you've enjoyed exploring the possibilities J1 offers for managing
486
+ and displaying digital image content. But much, much more can the J1 do for
487
+ your web.
488
+
489
+ The J1 Template support playing audio and video on web pages by using the
490
+ HTML5 audio and video support, the new standard of HTML. HTML5 implements a
491
+ pure HTML way to show play audio or playing video on the web. Modern browsers
492
+ support the audio tag `<audio>` and the video tag `<video>` for the HTML5
493
+ standard.
494
+
495
+ The previous proprietary de facto standard software like a Flash Player,
496
+ Quicktime, or Silverlight is no longer needed as the Theme JekyllOne provides
497
+ HTML5 video for local content and from online sources on the Internet.
498
+
499
+ [role="mb-7"]
500
+ Incredible? See the next example page link:{url-roundtrip--present-audio-video}[Present Audio and Video].