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.
- checksums.yaml +4 -4
- data/assets/data/banner.html +3 -1
- data/assets/theme/j1/adapter/js/masonry.js +6 -8
- data/assets/theme/j1/core/js/template.js +28 -1
- data/assets/theme/j1/core/js/template.min.js +4 -4
- data/assets/theme/j1/modules/lightGallery/js/lightgallery.js +4 -2
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-autoplay.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-comment.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-fullscreen.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-hash.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-medium-zoom.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-pager.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-relative-caption.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-rotate.js +6 -4
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-share.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-thumbnail.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-video.js +113 -76
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-video.min.js +1 -2
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-vimeo-thumbnail.js +6 -3
- data/assets/theme/j1/modules/lightGallery/js/plugins/lg-zoom.js +6 -3
- data/assets/theme/j1/modules/videojs/plugins/players/yt/js/youtube.js +21 -6
- data/assets/theme/j1/modules/videojs/plugins/players/yt/js/youtube.min.js +1 -1
- data/lib/j1/version.rb +1 -1
- data/lib/starter_web/README.md +5 -5
- data/lib/starter_web/_config.yml +1 -1
- data/lib/starter_web/_data/blocks/banner.yml +29 -18
- data/lib/starter_web/_data/blocks/panel.yml +79 -124
- data/lib/starter_web/_data/modules/blog_navigator.yml +1 -1
- data/lib/starter_web/_data/modules/defaults/blog_navigator.yml +2 -2
- data/lib/starter_web/_data/modules/gallery.yml +145 -19
- data/lib/starter_web/_data/modules/masonry.yml +9 -10
- data/lib/starter_web/_data/templates/feed.xml +1 -1
- data/lib/starter_web/_includes/attributes.asciidoc +2 -1
- data/lib/starter_web/_plugins/index/lunr.rb +1 -1
- data/lib/starter_web/assets/image/module/attic/1920x1280/nick-fewings.jpg +0 -0
- data/lib/starter_web/assets/image/module/attic/1920x1280/no-revisions.jpg +0 -0
- data/lib/starter_web/assets/image/module/attic/1920x1280/wolfgang-weiser.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/example-content-1280x800.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/google-lighthouse-1080x300.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/google-lighthouse-scores.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/master-header-1280x600.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/nav-module-1280x300.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/teaser-banner-1280x600.jpg +0 -0
- data/lib/starter_web/assets/image/page/features/tts-1280x500.jpg +0 -0
- data/lib/starter_web/assets/video/tracks/html5/peck_pocketed/captions/video.vtt +2 -3
- data/lib/starter_web/assets/video/tracks/html5/peck_pocketed/chapters/video.vtt +4 -6
- data/lib/starter_web/collections/posts/public/featured/_posts/0000-00-00-welcome-to-j1.adoc.erb +18 -20
- data/lib/starter_web/collections/posts/public/featured/_posts/2021-01-01-about-cookies.adoc +6 -7
- data/lib/starter_web/collections/posts/public/featured/_posts/{2023-10-18-url-types.adoc → 2022-10-18-url-types.adoc} +7 -4
- 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
- data/lib/starter_web/collections/posts/public/featured/_posts/{2022-02-01-about-j1.adoc → 2024-02-01-about-j1.adoc} +4 -5
- data/lib/starter_web/index.html +17 -73
- data/lib/starter_web/package.json +1 -1
- data/lib/starter_web/pages/public/features/{general.adoc → core-features.adoc} +92 -47
- data/lib/starter_web/pages/public/features/{template.adoc → theme-features.adoc} +313 -195
- data/lib/starter_web/pages/public/tools/tester/app_tester_swiperjs.adoc +10 -15
- data/lib/starter_web/pages/public/tools/tester/videojs_macro_tester.adoc +43 -2
- data/lib/starter_web/pages/public/tour/asciidoc_extensions.adoc +13 -21
- data/lib/starter_web/pages/public/tour/audio_data.adoc +2 -2
- data/lib/starter_web/pages/public/tour/icon_fonts.adoc +1 -1
- data/lib/starter_web/pages/public/tour/image_data.adoc +138 -234
- data/lib/starter_web/pages/public/tour/responsive_tables.adoc +1 -1
- data/lib/starter_web/pages/public/tour/video_data.adoc +74 -85
- metadata +12 -9
- data/lib/starter_web/assets/image/module/attic/cookies-1920x1200.jpg +0 -0
- 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
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
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
|
-
|
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/
|
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/
|
34
|
+
permalink: /pages/public/features/theme_features/
|
34
35
|
|
35
36
|
resources: [
|
36
|
-
amplitudejs, lightbox,
|
37
|
-
|
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/
|
44
|
-
alt:
|
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
|
-
<<
|
116
|
+
<<Sliders>> +
|
120
117
|
mdi:gesture-swipe[24px, md-blue ml-3 mr-2]
|
121
|
-
<<
|
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::
|
137
|
+
.Emancipator · From Dusk To Dawn (Trip-Hop)
|
138
|
+
amplitude::emancipator_large[role="mb-4"]
|
144
139
|
|
145
|
-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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
|
239
|
+
.Translator configuration
|
241
240
|
[source, yaml, role="noclip"]
|
242
241
|
----
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
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-
|
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
|
-
|
447
|
+
==== Text Sliders
|
405
448
|
|
406
|
-
|
407
|
-
for
|
408
|
-
|
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
|
453
|
+
.Markup to place a Base Text Slider
|
411
454
|
[source, apib, role="noclip"]
|
412
455
|
----
|
413
|
-
.
|
414
|
-
|
456
|
+
.Base Text Swiper
|
457
|
+
swiper::swiper_text_base[role="mt-4 mb-5"]
|
415
458
|
----
|
416
459
|
|
417
|
-
.
|
418
|
-
|
460
|
+
.Base Text Swiper
|
461
|
+
swiper::swiper_text_base[role="mt-4 mb-5"]
|
419
462
|
|
420
|
-
|
421
|
-
|
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
|
467
|
+
.Markup to place a Extended Text Swiper
|
424
468
|
[source, apib, role="noclip"]
|
425
469
|
----
|
426
|
-
.Text
|
427
|
-
|
470
|
+
.Extended Text Swiper · Parallax
|
471
|
+
swiper::swiper_text_parallax[role="mt-4 mb-5"]
|
428
472
|
----
|
429
473
|
|
430
|
-
.Text
|
431
|
-
|
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
|
-
|
438
|
-
|
439
|
-
// ----
|
440
|
-
// .Parallax carousel
|
441
|
-
// carousel::demo_text_carousel_parallax[role="mb-3"]
|
442
|
-
// ----
|
478
|
+
[role="mt-4"]
|
479
|
+
==== Image Sliders
|
443
480
|
|
444
|
-
|
445
|
-
|
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
|
-
|
448
|
-
|
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
|
-
|
451
|
-
|
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
|
-
|
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
|
-
|
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-
|
462
|
-
===
|
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
|
-
|
472
|
-
|
473
|
-
|
474
|
-
.Image
|
475
|
-
|
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
|
-
.
|
479
|
-
gallery::
|
538
|
+
.Gallery of Images + lightGaller
|
539
|
+
gallery::jg_mega_cities[role="mt-4 mb-4"]
|
480
540
|
|
481
|
-
|
482
|
-
|
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
|
-
|
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
|
488
|
-
gallery::
|
556
|
+
.YouTube Video · Adele and James Cordon
|
557
|
+
gallery::jg_video_youtube_james_and_adele[]
|
489
558
|
----
|
490
559
|
|
491
|
-
.Video
|
492
|
-
gallery::
|
560
|
+
.YouTube Video · Adele and James Cordon
|
561
|
+
gallery::jg_video_youtube_james_and_adele[role="mb-4"]
|
493
562
|
|
494
|
-
|
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
|
-
|
505
|
-
<<Blog Post Navigation>> +
|
574
|
+
|
506
575
|
mdi:format-annotation-plus[24px, md-blue ml-3 mr-2]
|
507
|
-
<<
|
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
|
-
<<
|
582
|
+
<<Blog Navigation>> +
|
583
|
+
|
510
584
|
mdi:content-duplicate[24px, md-blue ml-3 mr-2]
|
511
|
-
<<
|
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-
|
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-
|
576
|
-
===
|
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
|
-
|
599
|
-
|
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
|
-
|
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
|
-
|
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-
|
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
|
765
|
+
.Comments configuration for Hyvor
|
681
766
|
[source, yaml, role="noclip"]
|
682
767
|
----
|
683
|
-
|
684
|
-
|
685
|
-
|
686
|
-
|
687
|
-
|
688
|
-
|
689
|
-
|
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
|
-
|
692
|
-
|
800
|
+
# ----------------------------------------------------------------------------
|
801
|
+
# Provider settings
|
802
|
+
# ----------------------------------------------------------------------------
|
803
|
+
provider: hyvor
|
804
|
+
site_id: your-site-id
|
693
805
|
|
694
|
-
|
695
|
-
|
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-
|
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
|
827
|
+
.Google Analytics configuration
|
716
828
|
[source, yaml, role="noclip"]
|
717
829
|
----
|
718
|
-
|
719
|
-
|
720
|
-
|
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
|
-
|
723
|
-
|
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-
|
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
|
-
|
768
|
-
|
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.
|