j1-template 2024.2.0 → 2024.2.1

Sign up to get free protection for your applications and to get access to all the features.
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].