j1-template 2024.3.27 → 2024.3.28

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 (66) hide show
  1. checksums.yaml +4 -4
  2. data/assets/data/banner.html +3 -1
  3. data/assets/theme/j1/adapter/js/masonry.js +6 -8
  4. data/assets/theme/j1/core/js/template.js +28 -1
  5. data/assets/theme/j1/core/js/template.min.js +4 -4
  6. data/assets/theme/j1/modules/lightGallery/js/lightgallery.js +4 -2
  7. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-autoplay.js +6 -3
  8. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-comment.js +6 -3
  9. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-fullscreen.js +6 -3
  10. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-hash.js +6 -3
  11. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-medium-zoom.js +6 -3
  12. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-pager.js +6 -3
  13. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-relative-caption.js +6 -3
  14. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-rotate.js +6 -4
  15. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-share.js +6 -3
  16. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-thumbnail.js +6 -3
  17. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-video.js +113 -76
  18. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-video.min.js +1 -2
  19. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-vimeo-thumbnail.js +6 -3
  20. data/assets/theme/j1/modules/lightGallery/js/plugins/lg-zoom.js +6 -3
  21. data/assets/theme/j1/modules/videojs/plugins/players/yt/js/youtube.js +21 -6
  22. data/assets/theme/j1/modules/videojs/plugins/players/yt/js/youtube.min.js +1 -1
  23. data/lib/j1/version.rb +1 -1
  24. data/lib/starter_web/README.md +5 -5
  25. data/lib/starter_web/_config.yml +1 -1
  26. data/lib/starter_web/_data/blocks/banner.yml +29 -18
  27. data/lib/starter_web/_data/blocks/panel.yml +79 -124
  28. data/lib/starter_web/_data/modules/blog_navigator.yml +1 -1
  29. data/lib/starter_web/_data/modules/defaults/blog_navigator.yml +2 -2
  30. data/lib/starter_web/_data/modules/gallery.yml +145 -19
  31. data/lib/starter_web/_data/modules/masonry.yml +9 -10
  32. data/lib/starter_web/_data/templates/feed.xml +1 -1
  33. data/lib/starter_web/_includes/attributes.asciidoc +2 -1
  34. data/lib/starter_web/_plugins/index/lunr.rb +1 -1
  35. data/lib/starter_web/assets/image/module/attic/1920x1280/nick-fewings.jpg +0 -0
  36. data/lib/starter_web/assets/image/module/attic/1920x1280/no-revisions.jpg +0 -0
  37. data/lib/starter_web/assets/image/module/attic/1920x1280/wolfgang-weiser.jpg +0 -0
  38. data/lib/starter_web/assets/image/page/features/example-content-1280x800.jpg +0 -0
  39. data/lib/starter_web/assets/image/page/features/google-lighthouse-1080x300.jpg +0 -0
  40. data/lib/starter_web/assets/image/page/features/google-lighthouse-scores.jpg +0 -0
  41. data/lib/starter_web/assets/image/page/features/master-header-1280x600.jpg +0 -0
  42. data/lib/starter_web/assets/image/page/features/nav-module-1280x300.jpg +0 -0
  43. data/lib/starter_web/assets/image/page/features/teaser-banner-1280x600.jpg +0 -0
  44. data/lib/starter_web/assets/image/page/features/tts-1280x500.jpg +0 -0
  45. data/lib/starter_web/assets/video/tracks/html5/peck_pocketed/captions/video.vtt +2 -3
  46. data/lib/starter_web/assets/video/tracks/html5/peck_pocketed/chapters/video.vtt +4 -6
  47. data/lib/starter_web/collections/posts/public/featured/_posts/0000-00-00-welcome-to-j1.adoc.erb +18 -20
  48. data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.adoc +6 -7
  49. data/lib/starter_web/collections/posts/public/featured/_posts/{2023-10-18-url-types.adoc → 2022-10-18-url-types.adoc} +7 -4
  50. data/lib/starter_web/collections/posts/public/featured/_posts/{2021-02-01-static-site-generators.adoc → 2023-02-01-static-site-generators.adoc} +5 -6
  51. data/lib/starter_web/collections/posts/public/featured/_posts/{2022-02-01-about-j1.adoc → 2024-02-01-about-j1.adoc} +4 -5
  52. data/lib/starter_web/index.html +17 -73
  53. data/lib/starter_web/package.json +1 -1
  54. data/lib/starter_web/pages/public/features/{general.adoc → core-features.adoc} +92 -47
  55. data/lib/starter_web/pages/public/features/{template.adoc → theme-features.adoc} +313 -195
  56. data/lib/starter_web/pages/public/tools/tester/app_tester_swiperjs.adoc +10 -15
  57. data/lib/starter_web/pages/public/tools/tester/videojs_macro_tester.adoc +43 -2
  58. data/lib/starter_web/pages/public/tour/asciidoc_extensions.adoc +13 -21
  59. data/lib/starter_web/pages/public/tour/audio_data.adoc +2 -2
  60. data/lib/starter_web/pages/public/tour/icon_fonts.adoc +1 -1
  61. data/lib/starter_web/pages/public/tour/image_data.adoc +138 -234
  62. data/lib/starter_web/pages/public/tour/responsive_tables.adoc +1 -1
  63. data/lib/starter_web/pages/public/tour/video_data.adoc +74 -85
  64. metadata +12 -9
  65. data/lib/starter_web/assets/image/module/attic/cookies-1920x1200.jpg +0 -0
  66. data/lib/starter_web/pages/public/tour/modal_extentions.adoc +0 -126
@@ -1,21 +1,22 @@
1
1
  ---
2
- title: Features
2
+ title: Theme Features
3
3
  tagline: Modules, Extensions and Integrations
4
4
 
5
5
  date: 2021-01-01
6
6
  #last_modified: 2023-01-01
7
7
 
8
8
  description: >
9
- J1 Template is a Bootstrap V5 website template for the static
10
- site generator Jekyll.
11
- For Jekyll, a huge number of templates are available that cover
12
- all typical use cases for websites. The bad story: most of them
13
- require programming and low-level customization. Deep knowledge
14
- of Jekyll and valuable experience using HTML, CSS, and Javascript
15
- is required. J1 Template is different: easy to use, no programming
16
- is needed.
9
+ Jekyll One Template (J1) is a free Jekyll Theme providing
10
+ a clean implementation for Jekyll to start new projects
11
+ for all businesses based on Bootstrap V5.
12
+ The template combines the best current software for the Web.
13
+ Jekyll One is open-source and free to use for private and
14
+ business purposes.
15
+
17
16
  keywords: >
18
- Jekyll, JekyllOne, Theme, Software, Modules, Extensions, Integrations
17
+ open source, free, template, theme,
18
+ jekyll, jekyllone, web, site, static,
19
+ jamstack, bootstrap, netlify
19
20
 
20
21
  categories: [ Features ]
21
22
  tags: [ Module, Extension, Integration ]
@@ -25,27 +26,23 @@ robots:
25
26
  follow: true
26
27
 
27
28
  image:
28
- path: /assets/image/module/attic/christina-1920x1280.jpg
29
+ path: /assets/image/module/attic/1920x1280/j1-launch.jpg
29
30
  width: 1920
30
31
  height: 1280
31
32
 
32
33
  regenerate: false
33
- permalink: /pages/public/features/template_features/
34
+ permalink: /pages/public/features/theme_features/
34
35
 
35
36
  resources: [
36
- amplitudejs, lightbox, carousel,
37
- master-slider, lightgallery, gallery,
38
- videojs, vimeo-player
37
+ amplitudejs, lightbox, lightgallery,
38
+ masonry, gallery, photoswipejs,
39
+ swiperjs, videojs, vimeo-player
39
40
  ]
40
41
  resource_options:
41
42
  - attic:
42
43
  slides:
43
- - url: /assets/image/module/attic/christina-1920x1280.jpg
44
- alt: Photo by Christina on Unsplash
45
- badge:
46
- type: unsplash
47
- author: Christina
48
- href: //unsplash.com/@wocintechchat
44
+ - url: /assets/image/module/attic/1920x1280/j1-launch.jpg
45
+ alt: Making is like wanting - but even better
49
46
  ---
50
47
 
51
48
  // Page Initializer
@@ -116,11 +113,9 @@ mdi:near-me[24px, md-blue ml-3 mr-2]
116
113
  mdi:lightbulb-on[24px, md-blue ml-3 mr-2]
117
114
  <<Lightboxes>> +
118
115
  mdi:view-carousel[24px, md-blue ml-3 mr-2]
119
- <<Text and Image Carousels>> +
116
+ <<Sliders>> +
120
117
  mdi:gesture-swipe[24px, md-blue ml-3 mr-2]
121
- <<Text and Image Sliders>> +
122
- mdi:folder-multiple-image[24px, md-blue ml-3 mr-2]
123
- <<Image and Video Galleries>>
118
+ <<Galleries>>
124
119
 
125
120
  [role="mt-5"]
126
121
  === Infinite scroll
@@ -139,21 +134,25 @@ previews of blog articles.
139
134
  J1 Template provides playing audio on web pages by HTML5 and supports custom
140
135
  players created by AmplitudeJS to playback audio individually.
141
136
 
142
- .Emancipator · From Dusk To Dawn
143
- amplitude::free_emancipator_large[role="mt-3 mb-5"]
137
+ .Emancipator · From Dusk To Dawn (Trip-Hop)
138
+ amplitude::emancipator_large[role="mb-4"]
144
139
 
145
- [role="mt-4"]
140
+
141
+ [role="mt-5"]
146
142
  === Screen reader
147
143
 
148
144
  Speak2Me for J1 Template is a speech synthesise (TTS) module that enables a
149
145
  so-called screen reader. The reader functionality allows users to sit back
150
146
  and listen to the browser read aloud the important contents on a Web page.
151
147
 
148
+ .TTS Control
149
+ lightbox::images--tts[ 1920, {data-images--tts} ]
150
+
152
151
  The *screen reader* on websites created by J1 Template is started by
153
152
  clicking on the *speaker* symbol mdi:speaker[24px, md-blue] placed top
154
153
  right in the *menu bar*.
155
154
 
156
- [role="mt-4"]
155
+ [role="mt-5"]
157
156
  === Animate on Scroll
158
157
 
159
158
  Scroll-triggered animation (AOS) is an effective way to animate website
@@ -162,7 +161,7 @@ as users scroll down a page. Scroll animations are more likely to grab the
162
161
  user's attention, making websites look and feel more dynamic and
163
162
  interesting.
164
163
 
165
- [role="mt-4"]
164
+ [role="mt-5"]
166
165
  === Floating Action Buttons
167
166
 
168
167
  The *Floating Action Button* (FAB) is an element of Google's Material Design.
@@ -177,7 +176,7 @@ The template system supports Floating Action Buttons for in-page navigation.
177
176
  When the FAB is pressed, it provides more related actions like showing the
178
177
  content table or scrolling a page chapter-wise up and down.
179
178
 
180
- [role="mt-4"]
179
+ [role="mt-5"]
181
180
  === Full-text search engine
182
181
 
183
182
  Full-text search (FTS) for a website is an advanced method of searching
@@ -192,7 +191,7 @@ to be small but full-featured. Lunr enables developers to provide visitors
192
191
  with a great search experience without the need for external, server-sided
193
192
  search services like Google on the internet.
194
193
 
195
- [role="mt-4"]
194
+ [role="mt-5"]
196
195
  === Cookie Consent
197
196
 
198
197
  Running websites in the EU and many other countries, implementing the
@@ -213,7 +212,7 @@ accepting the use of cookies.
213
212
  The Template system provides a configurable GDPR compliant module to manage
214
213
  the consent of your visitors on cookies.
215
214
 
216
- [role="mt-4"]
215
+ [role="mt-6"]
217
216
  === Translator
218
217
 
219
218
  A Website translation service is useful in a wide range of situations.
@@ -237,17 +236,51 @@ Translation makes it easier for users to browse content and find what they’re
237
236
  looking for. An excellent user experience and understanding the language are
238
237
  key for building trust in the content you provide.
239
238
 
240
- .Translator configuration (j1_config.yml)
239
+ .Translator configuration
241
240
  [source, yaml, role="noclip"]
242
241
  ----
243
- translation:
244
- enabled: true
245
- provider: google
246
-
247
- google:
248
- layout: default
249
- sourcelanguage: en
250
- translationlanguages: [auto]
242
+ # ------------------------------------------------------------------------------
243
+ # ~/_data/modules/translator.yml
244
+ # User configuration ssettings for J1 Translator module
245
+ #
246
+ # Product/Info:
247
+ # https://jekyll.one
248
+ #
249
+ # Copyright (C) 2023-2025 Juergen Adams
250
+ #
251
+ # J1 Template is licensed under the MIT License.
252
+ # See: https://github.com/jekyll-one-org/j1-template/blob/main/LICENSE
253
+ # ------------------------------------------------------------------------------
254
+
255
+ # ------------------------------------------------------------------------------
256
+ # Description
257
+ #
258
+ description:
259
+ title: J1 Translator
260
+ scope: User settings
261
+ location: _data/modules/translator.yml
262
+
263
+ # ------------------------------------------------------------------------------
264
+ # User configuration settings
265
+ #
266
+ settings:
267
+
268
+ # ----------------------------------------------------------------------------
269
+ # GENERAL options
270
+ # ----------------------------------------------------------------------------
271
+ #
272
+ enabled: true
273
+
274
+ # ----------------------------------------------------------------------------
275
+ # Translator options
276
+ # ----------------------------------------------------------------------------
277
+ translatorName: google
278
+ contentLanguage: en
279
+ dialogLanguage: auto
280
+ translationLanguage: de
281
+
282
+ # ------------------------------------------------------------------------------
283
+ # END config
251
284
  ----
252
285
 
253
286
  J1 integrates the *free* translation service provided by Google Translate
@@ -263,7 +296,7 @@ visitors do not agree on cookies required to use Google Translate, GT gets
263
296
  automatically disabled, and all cookies from Google are deleted from the
264
297
  user's system.
265
298
 
266
- [role="mt-4"]
299
+ [role="mt-5"]
267
300
  === Master Header
268
301
 
269
302
  The most-top position of a web page is important; this postion is presented to
@@ -400,66 +433,74 @@ gallery::jg_old_times[ role="mb-4 wm-800" ]
400
433
  .LightGallery
401
434
  gallery::jg_old_times[ role="mb-4 wm-800" ]
402
435
 
436
+
437
+ [role="mt-4"]
438
+ === Sliders
439
+
440
+ SwiperJS is a Javascript API that creates modern slider shows. All sliders
441
+ use hardware-accelerated features like 3D transitions to perform best on modern
442
+ devices. SwiperJS-based sliders are intended to be displayed at their best on
443
+ all types of websites, such as those viewed on desktop computers, tablets, or
444
+ smartphones.
445
+
403
446
  [role="mt-4"]
404
- === Text and Image Carousels
447
+ ==== Text Sliders
405
448
 
406
- J1 Carousel is based on OWL Carousel, a clean and neat jQuery slider plugin
407
- for creating fully responsive and touch-enabled carousel sliders. Carousels
408
- are mostly used for pictures data to animate the images as a series.
449
+ Swipers are mnainly used for displaying images. Still, the implementation
450
+ for the J1 Template supports a lot more *sources* to be displayed as a *slide*.
451
+ Simple *text* for example.
409
452
 
410
- .Markup to place a Image carousel (Asciidoc)
453
+ .Markup to place a Base Text Slider
411
454
  [source, apib, role="noclip"]
412
455
  ----
413
- .Image carousel
414
- carousel::demo_simple[role="mb-3"]
456
+ .Base Text Swiper
457
+ swiper::swiper_text_base[role="mt-4 mb-5"]
415
458
  ----
416
459
 
417
- .Image carousel
418
- carousel::demo_simple[role="mb-3"]
460
+ .Base Text Swiper
461
+ swiper::swiper_text_base[role="mt-4 mb-5"]
419
462
 
420
- In general, J1 Carousel supports many more sources to be displayed as a
421
- slide show: simple text, for example.
463
+ A more *emphasized* type of a **text**-based swiper is a *parallax* text
464
+ swiper. If you want to *focus* the meaning, this kind of a swiper may be
465
+ nteresting. Parallax text sliders can be placed as *banners* on a page.
422
466
 
423
- .Markup to place a Text carousel (Asciidoc)
467
+ .Markup to place a Extended Text Swiper
424
468
  [source, apib, role="noclip"]
425
469
  ----
426
- .Text carousel
427
- carousel::demo_text_carousel[role="mb-3"]
470
+ .Extended Text Swiper · Parallax
471
+ swiper::swiper_text_parallax[role="mt-4 mb-5"]
428
472
  ----
429
473
 
430
- .Text carousel
431
- carousel::demo_text_carousel[role="mb-3"]
474
+ .Extended Text Swiper · Parallax
475
+ swiper::swiper_text_parallax[role="mt-4 mb-5"]
432
476
 
433
- // A more eye-minded type of text-based slide show is a parallax text slider.
434
- // If you want to emphasize your statements focussing on the meaning, this kind
435
- // of slide show may be interesting.
436
477
 
437
- // .Markup to place a Parallax carousel (Asciidoc)
438
- // [source, apib, role="noclip"]
439
- // ----
440
- // .Parallax carousel
441
- // carousel::demo_text_carousel_parallax[role="mb-3"]
442
- // ----
478
+ [role="mt-4"]
479
+ ==== Image Sliders
443
480
 
444
- // .Parallax text carousel
445
- // carousel::demo_text_carousel_parallax[role="mb-3"]
481
+ Swipers (sliders or carousels) are mainly used for pictures *animated* as a
482
+ managed *group*. Find below some examples of using simple (base) swipers for
483
+ presenting images using the Swiper App.
446
484
 
447
- [role="mt-4"]
448
- === Text and Image Sliders
485
+ Find an example of a *full-width* slider with *pagination* control *enabled*
486
+ to browse all images *back* and *forth*. Additionally, the pagination bullets
487
+ below the Swiper App indicate how *many* slides (images) the slide show
488
+ *contains* for improved usage experience.
449
489
 
450
- Master Slider is a premium image and content slider for any purposes, with
451
- super smooth hardware accelerated transitions. MS is a well-known Slider Plugin
452
- for _WordPress_. J1 implements the *free* version MS Lite of version v2.85.13
453
- (Feb 2022).
490
+ .Image Swiper · Full-width + Pagination
491
+ swiper::swiper_image_base_full_width_pagination[role="mt-3 mb-4"]
454
492
 
455
- masterslider::ms_00005[role="mt-4 mb-5"]
493
+ Important statements or topics can be placed on top of an article or
494
+ a paragraph to give them better visibility. In one line, you can present
495
+ many facts to know animated for the reader's attention within a
496
+ *single line*.
456
497
 
457
- masterslider::ms_00006[role="mt-4 mb-5"]
498
+ .Equal Image Sizes · Captions + Navigation + Pagination
499
+ swiper::swiper_image_base_navigation_pagination[role="mt-3 mb-3"]
458
500
 
459
- masterslider::ms_00009[role="mt-4 mb-5"]
460
501
 
461
- [role="mt-5"]
462
- === Image and Video Galleries
502
+ [role="mt-4"]
503
+ === Galleries
463
504
 
464
505
  Image and Video Galleries allow you to lay out groups of images or videos
465
506
  in very different ways. J1 supports JustifiedGallery is a great jQuery plugin
@@ -468,30 +509,59 @@ The gallery uses a so-called masonry grid layout. It works by placing
468
509
  elements in an optimal position based on available horizontal and vertical
469
510
  space. Sort of like mason fitting stones in a wall.
470
511
 
471
- .Markup to place the Image Gallery (Asciidoc)
472
- [source, apib, role="noclip"]
473
- ----
474
- .Image Gallery
475
- gallery::jg_example[role="mb-5"]
476
- ----
512
+ [role="mt-4"]
513
+ ==== Image Galleries
514
+
515
+ *Masonry* for J1 is a great tool to create dynamic image galleries. Image
516
+ galleries are popular on many websites, and masonry can be a useful tool for
517
+ creating dynamic galleries.
518
+
519
+ By using the Masonry module, you can create a gallery that displays images of
520
+ different sizes in an aesthetically pleasing and functional way.
521
+
522
+ .Grid of Images
523
+ masonry::image_fixed_height_lb[role="mt-4 mb-5"]
524
+
525
+ link:{url-justified-gallery--home}[JustifiedGallery, {browser-window--new}]
526
+ is a great _jQuery_ Plugin to create responsive, infinite, and high-quality
527
+ justified image galleries. J1 Template combines the Gallery with the lightboxes
528
+ supported to enlarge the images of a gallery. See the gallery in action; and
529
+ for sure, all that you see is even responsive. Change the size of your current
530
+ browser window, by width or height to see what will happen!
531
+
532
+ // [role="mb-4"]
533
+ Pictures you've made are typically not even in size. Images may have the
534
+ same size (resolution), but some are orientated landscapes, or others
535
+ may be portraits. For that reason, a more powerful gallery is needed to create
536
+ so-called justified views.
477
537
 
478
- .Image Gallery
479
- gallery::jg_customizer[role="mb-5"]
538
+ .Gallery of Images + lightGaller
539
+ gallery::jg_mega_cities[role="mt-4 mb-4"]
480
540
 
481
- A JustifiedGallery provides not only images. See the next example of a gallery
482
- for HTML5 video content.
541
+ It works by placing elements in an optimal position based on available
542
+ horizontal and vertical space. Sort of like mason fitting stones in a wall.
543
+ For sure, you'll have seen it in action all over the Internet.
483
544
 
484
- .Markup to place the Video Gallery (Asciidoc)
545
+ [role="mt-5"]
546
+ ==== Video Galleries
547
+
548
+ Video galleries are collections that display videos organized around a
549
+ specific theme, topic, or purpose. The gallery module (lightGallery) for
550
+ J1 Template is a fast, modular, and responsive plugin for creating
551
+ beautiful-looking, featured image and video galleries.
552
+
553
+ .Markup to place the Video Gallery
485
554
  [source, apib, role="noclip"]
486
555
  ----
487
- .Video Gallery (HTML5)
488
- gallery::jg_video_html5[role="mb-5"]
556
+ .YouTube Video · Adele and James Cordon
557
+ gallery::jg_video_youtube_james_and_adele[]
489
558
  ----
490
559
 
491
- .Video Gallery (HTML5)
492
- gallery::jg_video_html5[role="mb-5"]
560
+ .YouTube Video · Adele and James Cordon
561
+ gallery::jg_video_youtube_james_and_adele[role="mb-4"]
493
562
 
494
- [role="mt-4"]
563
+
564
+ [role="mt-5"]
495
565
  == Extensions
496
566
 
497
567
  Frameworks like _Bootstrap_ and Asciidoc are enormously flexible and customizable.
@@ -501,18 +571,23 @@ simple to use, and usable out-of-the-box.
501
571
 
502
572
  mdi:bootstrap[24px, md-blue ml-3 mr-2]
503
573
  <<Bootstrap extensions>> +
504
- mdi:group[24px, md-blue ml-3 mr-2]
505
- <<Blog Post Navigation>> +
574
+
506
575
  mdi:format-annotation-plus[24px, md-blue ml-3 mr-2]
507
- <<Block elements>> +
576
+ <<Asciidoc extensions>> +
577
+
578
+ mdi:group[24px, md-blue ml-3 mr-2]
579
+ <<Banner and Panel>> +
580
+
508
581
  mdi:near-me[24px, md-blue ml-3 mr-2]
509
- <<Asciidoctor extensions>> +
582
+ <<Blog Navigation>> +
583
+
510
584
  mdi:content-duplicate[24px, md-blue ml-3 mr-2]
511
- <<Featured example content>> +
585
+ <<Sample content>> +
586
+
512
587
  mdi:image[24px, md-blue ml-3 mr-2]
513
588
  <<Royalty Free Images>>
514
589
 
515
- [role="mt-4"]
590
+ [role="mt-5"]
516
591
  === Bootstrap extensions
517
592
 
518
593
  A set of Advanced Bootstrap Modals (ABM), based on the free package of Material
@@ -548,32 +623,9 @@ Post's front matter by specifying a new date/time in the format
548
623
  `2008-12-14 10:30:00 +0900`).
549
624
  |===
550
625
 
551
- [role="mt-4"]
552
- === Blog Post Navigation
553
-
554
- To make your Blog Articles available to your vistors, J1 offers an easy to use
555
- navigation module for all your posts. The Blog Post Navigator automatically
556
- generates different views to explore articles by Categoy, Date, or all posts
557
- from an Archive View.
558
-
559
- .Blog Post Navigator
560
- lightbox::images--blog-post-navigator[ 1920, {data-images--blog-post-navigator} ]
561
-
562
- [role="mt-4"]
563
- === Block elements
564
-
565
- Banners and panels are complex but configurable building blocks, typically
566
- used for home and landing pages. Examples how to use banners and panels
567
- can be found with the included starter web for the homepage.
568
-
569
- .Teaser Banner
570
- lightbox::images--teaser-banner[ 1920, {data-images--teaser-banner} ]
571
-
572
- .Intro Panel
573
- lightbox::images--intro-panel[ 1920, {data-images--intro-panel} ]
574
626
 
575
- [role="mt-4"]
576
- === Asciidoctor extensions
627
+ [role="mt-5"]
628
+ === Asciidoc extensions
577
629
 
578
630
  J1 Template implements a bunch of incubating Ruby-based extensions for
579
631
  Asciidoctor. Using Asciidoctor extensions, it's easy to integrate lightboxes,
@@ -595,8 +647,43 @@ mdi:font-awesome[2x, ml-3 mr-2 mb-2] Brand icon +
595
647
  mdi:apple[2x, md-indigo ml-3 mr-2] Brand icon (colored)
596
648
  ====
597
649
 
598
- [role="mt-4"]
599
- === Featured example content
650
+
651
+ [role="mt-5"]
652
+ === Banner and Panel
653
+
654
+ Banners and panels are complex but configurable building blocks, typically
655
+ used for home and landing pages. Examples how to use banners and panels
656
+ can be found with the included starter web for the homepage.
657
+
658
+ .Teaser Banner
659
+ lightbox::images--teaser-banner[ 1920, {data-images--teaser-banner} ]
660
+
661
+
662
+ [role="mt-5"]
663
+ === Blog Navigation
664
+
665
+ To make your Blog Articles available to your vistors, J1 offers an easy to use
666
+ navigation module for all your posts. The Blog Post Navigator automatically
667
+ generates different views to explore articles by Categoy, Date, or all posts
668
+ from an Archive View.
669
+
670
+ .Blog Post Navigator
671
+ lightbox::images--blog-post-navigator[ 1920, {data-images--blog-post-navigator} ]
672
+
673
+
674
+ [role="mt-5"]
675
+ === Block elements
676
+
677
+ Banners and panels are complex but configurable building blocks, typically
678
+ used for home and landing pages. Examples how to use banners and panels
679
+ can be found with the included starter web for the homepage.
680
+
681
+ .Teaser Banner
682
+ lightbox::images--teaser-banner[ 1920, {data-images--teaser-banner} ]
683
+
684
+
685
+ [role="mt-5"]
686
+ === Sample content
600
687
 
601
688
  All pages from the roundtrip section are provided by the starter web
602
689
  included with the J1 Template. Many real-world examples for your content
@@ -605,7 +692,8 @@ could be taken from these pages and are easy to use with your website.
605
692
  .Example Content (Icon Fonts)
606
693
  lightbox::images--example-content[ 1920, {data-images--example-content} ]
607
694
 
608
- [role="mt-4"]
695
+
696
+ [role="mt-5"]
609
697
  === Royalty Free Images
610
698
 
611
699
  All images for a *Starter Web*, for example, from the roundtrip section, are
@@ -627,14 +715,11 @@ mdi:comment[2x, md-blue ml-3 mr-2]
627
715
  <<Comment providers>> +
628
716
  mdi:google-analytics[2x, md-blue ml-3 mr-2]
629
717
  <<Google Analytics>> +
630
- mdi:google-ads[2x, md-blue ml-3 mr-2]
631
- <<Google Adsense>> +
632
- mdi:youtube[2x, md-blue ml-3 mr-2]
633
- <<YouTube Video>> +
634
- mdi:vimeo[2x, md-blue ml-3 mr-2]
635
- <<Vimeo Video>>
718
+ // mdi:google-ads[2x, md-blue ml-3 mr-2]
719
+ // <<Google Adsense>>
636
720
 
637
- [role="mt-4"]
721
+
722
+ [role="mt-5"]
638
723
  === Bootstrap Themes
639
724
 
640
725
  The Themes for the template system J1 are based on the free and Open Source
@@ -657,7 +742,7 @@ link:{url-bootswatch--home}[Bootswatch, {browser-window--new}] is at least a
657
742
  good base for your modifications: your unique design. J1 integrates all
658
743
  available themes from _Bootswatch_ with the navigator module.
659
744
 
660
- [role="mt-4"]
745
+ [role="mt-5"]
661
746
  === Comment providers
662
747
 
663
748
  Comments became an integral part of almost each website on the web. People
@@ -677,22 +762,49 @@ configuration, and you're done. On all posts or pages you want to use for
677
762
  comments, the comment interface is shown automatically and can be used by
678
763
  your visitors.
679
764
 
680
- .Comments configuration for Hyvor (j1_config.yml)
765
+ .Comments configuration for Hyvor
681
766
  [source, yaml, role="noclip"]
682
767
  ----
683
- comments:
684
- enabled: true
685
- provider: hyvor
686
-
687
- comments_headline:
688
- en: Leave a comment
689
- de: Kommentieren
768
+ # ------------------------------------------------------------------------------
769
+ # ~/_data/modules/comments.yml
770
+ # User configuration settings for J1 Comments Module
771
+ #
772
+ # Product/Info:
773
+ # https://jekyll.one
774
+ #
775
+ # Copyright (C) 2023-2025 Juergen Adams
776
+ #
777
+ # J1 Template is licensed under the MIT License.
778
+ # See: https://github.com/jekyll-one-org/j1-template/blob/main/LICENSE
779
+ # ------------------------------------------------------------------------------
780
+
781
+ # ------------------------------------------------------------------------------
782
+ # Description
783
+ #
784
+ description:
785
+ title: J1 Comments
786
+ scope: User settings
787
+ location: _data/modules/comments.yml
788
+
789
+ # ------------------------------------------------------------------------------
790
+ # User configuration settings
791
+ #
792
+ settings:
793
+
794
+ # ----------------------------------------------------------------------------
795
+ # GENERAL options
796
+ # ----------------------------------------------------------------------------
797
+ #
798
+ enabled: false
690
799
 
691
- hyvor:
692
- site_id: 'hyvor-site-id'
800
+ # ----------------------------------------------------------------------------
801
+ # Provider settings
802
+ # ----------------------------------------------------------------------------
803
+ provider: hyvor
804
+ site_id: your-site-id
693
805
 
694
- disqus:
695
- site_id: '<your-site-short-name>'
806
+ # ------------------------------------------------------------------------------
807
+ # END config
696
808
  ----
697
809
 
698
810
  DQC is fully integrated with the GDPR-compatible Cookie Consent module. If
@@ -700,7 +812,7 @@ your visitors do not agree on cookies needed for Diqus, DQC gets
700
812
  automatically disabled, and all related cookies are deleted from the user's
701
813
  system.
702
814
 
703
- [role="mt-4"]
815
+ [role="mt-5"]
704
816
  === Google Analytics
705
817
 
706
818
  Google Analytics (GAL) provides access to a massive amount of data related
@@ -712,57 +824,63 @@ Google Analytics is integrated by pure configuration. Simply enable the
712
824
  provider and set your your access credentials to the configuration, and
713
825
  you're done.
714
826
 
715
- .Google Analytics configuration (j1_config.yml)
827
+ .Google Analytics configuration
716
828
  [source, yaml, role="noclip"]
717
829
  ----
718
- analytics:
719
- enabled: true
720
- provider: google
830
+ # ------------------------------------------------------------------------------
831
+ # ~/_data/modules/analytics.yml
832
+ # User configuration settings for J1 Analytics module
833
+ #
834
+ # Product/Info:
835
+ # https://jekyll.one
836
+ #
837
+ # Copyright (C) 2023-2025 Juergen Adams
838
+ #
839
+ # J1 Template is licensed under the MIT License.
840
+ # See: https://github.com/jekyll-one-org/j1-template/blob/main/LICENSE
841
+ # ------------------------------------------------------------------------------
842
+
843
+ # ------------------------------------------------------------------------------
844
+ # Description
845
+ #
846
+ description:
847
+ title: J1 Analytics
848
+ scope: User settings
849
+ location: _data/modules/analytics.yml
850
+
851
+ # ------------------------------------------------------------------------------
852
+ # User configuration settings
853
+ #
854
+ settings:
855
+
856
+ # ----------------------------------------------------------------------------
857
+ # GENERAL options
858
+ # ----------------------------------------------------------------------------
859
+ #
860
+ enabled: false
861
+ skipAllHosts: localhost, 127.0.0.1
862
+ trackingID: <your-tracking-id>
721
863
 
722
- google:
723
- tracking_id: '<your-tracking-id>'
864
+ # ----------------------------------------------------------------------------
865
+ # Provider settings
866
+ # ----------------------------------------------------------------------------
867
+ google:
868
+ anonymizeIP: false
869
+
870
+ # ------------------------------------------------------------------------------
871
+ # END config
724
872
  ----
725
873
 
874
+ [role="mb-8"]
726
875
  GAL is fully integrated with the GDPR-compatible Cookie Consent module.
727
876
  If your visitors do not agree on cooies for *Analysis*, Google Analytics gets
728
877
  automatically disabled and all cookies from Google are deleted from the
729
878
  user's system.
730
879
 
731
- [role="mt-4"]
732
- === Google Adsense
733
-
734
- Google Adsense (GAD) is integrated by pure configuration. Simply enable the
735
- provider and set your your access credentials to the configuration, and
736
- you're done.
737
-
738
- [role="mt-4"]
739
- === YouTube Video
740
-
741
- J1 Template supports YouTube and Vimeo video content out-of-the-box.
742
- The type of content is *automatically detected* with your video galleries
743
- configured, and the player is started as needed.
744
-
745
- .Asciidoc Markup
746
- [source, apib, role="noclip"]
747
- ----
748
- gallery::jg_video_online_youtube_james_and_adele[]
749
- ----
750
-
751
- .YouTube Video
752
- gallery::jg_video_online_youtube_james_and_adele[role="mb-5"]
753
-
754
- [role="mt-4"]
755
- === Vimeo Video
756
-
757
- J1 Template supports Vimeo video content out-of-the-box. The type of content
758
- is *automatically detected* with your video galleries configured, and the
759
- player is started as needed.
760
-
761
- .Asciidoc Markup
762
- [source, apib, role="noclip"]
763
- ----
764
- gallery::jg_video_online_vimeo[role="mb-5"]
765
- ----
880
+ // [role="mt-5"]
881
+ // === Google Adsense
766
882
 
767
- .Vimeo Video
768
- gallery::jg_video_online_vimeo[role="mb-7"]
883
+ // [role="mb-8"]
884
+ // Google Adsense (GAD) is integrated by pure configuration. Simply enable the
885
+ // provider and set your your access credentials to the configuration, and
886
+ // you're done.