j1-template 2024.3.12 → 2024.3.13
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/j1/version.rb +1 -1
- data/lib/starter_web/README.md +560 -577
- data/lib/starter_web/_config.yml +1 -1
- data/lib/starter_web/_data/modules/navigator_menu.yml +803 -831
- data/lib/starter_web/_data/templates/feed.xml +1 -1
- data/lib/starter_web/_plugins/index/lunr.rb +1 -1
- data/lib/starter_web/package.json +1 -1
- data/lib/starter_web/pages/public/tools/previewer/_includes/attributes.asciidoc +16 -0
- data/lib/starter_web/pages/public/tour/_includes/attributes.asciidoc +2 -2
- data/lib/starter_web/pages/public/tour/playback_audio.adoc +188 -197
- data/lib/starter_web/pages/public/tour/present_images.adoc +2 -1
- metadata +2 -8
- data/lib/starter_web/pages/public/tools/previewer/_includes/documents/amplitudejs.large.css.asciidoc +0 -505
- data/lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.hover.html +0 -69
- data/lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.nested.html +0 -75
- data/lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.textarea.html +0 -57
- data/lib/starter_web/pages/public/tools/previewer/_includes/documents/my.content.html +0 -112
- data/lib/starter_web/pages/public/tools/previewer/preview_amplitudejs.adoc +0 -172
@@ -57,7 +57,7 @@
|
|
57
57
|
<id>{{ page.url | absolute_url | xml_escape }}</id>
|
58
58
|
<post_limited>{{ limit_posts }}</post_limited>
|
59
59
|
<template_name>J1 Theme</template_name>
|
60
|
-
<template_version>2024.3.
|
60
|
+
<template_version>2024.3.13</template_version>
|
61
61
|
|
62
62
|
{% assign title = site.title | default: site.name %}
|
63
63
|
{% if page.collection != "posts" %}
|
@@ -19,6 +19,22 @@ tag::urls[]
|
|
19
19
|
|
20
20
|
:url-asciidoc-extensions--gist-example: //gist.github.com/mojavelinux/5546622
|
21
21
|
|
22
|
+
:url-tour--data-slider-picker: /pages/public/tour/data_slider_picker
|
23
|
+
:url-tour--image_headers: /pages/public/tour/image_header
|
24
|
+
:url-tour--readme-first: /pages/public/learn/read_me_first/
|
25
|
+
:url-tour--present-images: /pages/public/tour/present_images/
|
26
|
+
:url-tour--playback-audio: /pages/public/tour/playback_audio/
|
27
|
+
:url-tour--playback-video: /pages/public/tour/playback_video/
|
28
|
+
:url-tour--cards: /pages/public/tour/cards/
|
29
|
+
:url-tour--typography: /pages/public/tour/typography/
|
30
|
+
:url-tour--asciidoc-extensions: /pages/public/tour/asciidoc_extensions/
|
31
|
+
:url-tour--rouge-hightlighter: /pages/public/tour/rouge/
|
32
|
+
:url-tour--extended-modals: /pages/public/tour/modals/
|
33
|
+
:url-tour--icon-fonts: /pages/public/tour/mdi_icon_font/
|
34
|
+
:url-tour--responsive-tables: /pages/public/tour/responsive_tables/
|
35
|
+
:url-tour--themes: /pages/public/tour/themes/
|
36
|
+
:url-tour--quicksearch: /pages/public/tour/quicksearch/
|
37
|
+
|
22
38
|
end::urls[]
|
23
39
|
|
24
40
|
|
@@ -39,8 +39,8 @@ tag::urls[]
|
|
39
39
|
:url-tour--image_headers: /pages/public/tour/image_header
|
40
40
|
:url-tour--readme-first: /pages/public/learn/read_me_first/
|
41
41
|
:url-tour--present-images: /pages/public/tour/present_images/
|
42
|
-
:url-tour--
|
43
|
-
:url-tour--
|
42
|
+
:url-tour--playback-audio: /pages/public/tour/playback_audio/
|
43
|
+
:url-tour--playback-video: /pages/public/tour/playback_video/
|
44
44
|
:url-tour--cards: /pages/public/tour/cards/
|
45
45
|
:url-tour--typography: /pages/public/tour/typography/
|
46
46
|
:url-tour--asciidoc-extensions: /pages/public/tour/asciidoc_extensions/
|
@@ -1,197 +1,188 @@
|
|
1
|
-
---
|
2
|
-
title: Audio Player
|
3
|
-
title_extention: Playback Audio using J1 Template
|
4
|
-
tagline: Playback Audio
|
5
|
-
|
6
|
-
date: 2024-04-16
|
7
|
-
#last_modified: 2024-01-01
|
8
|
-
|
9
|
-
description: >
|
10
|
-
J1 Template provides playing audio on web pages
|
11
|
-
by HTML5 and supports custom players created
|
12
|
-
by AmplitudeJS to playback audio individually.
|
13
|
-
keywords: >
|
14
|
-
open source, free, template, jekyll, jekyllone, web,
|
15
|
-
sites, static, jamstack, bootstrap, html, html5,
|
16
|
-
asciidoctor, audio
|
17
|
-
|
18
|
-
categories: [ Tour ]
|
19
|
-
tags: [ Audio, Module ]
|
20
|
-
|
21
|
-
image:
|
22
|
-
path: /assets/image/modules/attics/1920x1280/alexey-ruban.jpg
|
23
|
-
width: 1920
|
24
|
-
height: 1280
|
25
|
-
|
26
|
-
tts: true
|
27
|
-
comments: false
|
28
|
-
exclude_from_search: false
|
29
|
-
regenerate: false
|
30
|
-
personalization: true
|
31
|
-
permalink: /pages/public/tour/playback_audio/
|
32
|
-
|
33
|
-
resources: [ amplitudejs ]
|
34
|
-
resource_options:
|
35
|
-
- toccer:
|
36
|
-
collapseDepth: 2
|
37
|
-
- attic:
|
38
|
-
slides:
|
39
|
-
- url: /assets/image/modules/attics/1920x1280/alexey-ruban.jpg
|
40
|
-
alt: Photo by Alexey Ruban on Unsplash
|
41
|
-
badge:
|
42
|
-
type: unsplash
|
43
|
-
author: Alexey Ruban
|
44
|
-
href: //unsplash.com/de/@intelligenciya
|
45
|
-
---
|
46
|
-
|
47
|
-
// Page Initializer
|
48
|
-
// =============================================================================
|
49
|
-
// Enable the Liquid Preprocessor
|
50
|
-
:page-liquid:
|
51
|
-
|
52
|
-
// Set (local) page attributes here
|
53
|
-
// -----------------------------------------------------------------------------
|
54
|
-
// :page--attr: <attr-value>
|
55
|
-
|
56
|
-
|
57
|
-
// Load Liquid procedures
|
58
|
-
// -----------------------------------------------------------------------------
|
59
|
-
{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
|
60
|
-
|
61
|
-
// Load page attributes
|
62
|
-
// -----------------------------------------------------------------------------
|
63
|
-
{% include {{load_attributes}} scope="all" %}
|
64
|
-
|
65
|
-
// See: https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Audio_codecs
|
66
|
-
// See: https://docs.asciidoctor.org/asciidoc/latest/macros/audio-and-video/
|
67
|
-
//
|
68
|
-
[role="dropcap"]
|
69
|
-
The Audio tag in HTML5 is a great way to add audio media to web pages.
|
70
|
-
However, the browser fully controls the audio playback interface,
|
71
|
-
which can limit or even break a page's design if audio media is used.
|
72
|
-
|
73
|
-
AmplitudeJS for J1 Template offers a straightforward solution for web
|
74
|
-
developers. It allows them to easily customize the appearance of their audio
|
75
|
-
players without the need for complex scripting. By leveraging J1 Template
|
76
|
-
and Amplitude's API, web designers can craft unique interfaces that define
|
77
|
-
the visual and functional aspects of a player's audio control elements.
|
78
|
-
|
79
|
-
mdi:clock-time-five-outline[24px, md-gray mt-4 mb-5 mr-2]
|
80
|
-
*5-10 Minutes* to read
|
81
|
-
|
82
|
-
|
83
|
-
[role="mt-5"]
|
84
|
-
== HTML 5 Audio
|
85
|
-
|
86
|
-
Audio players can easily be embedded in web pages using the *audio* tag
|
87
|
-
`<audio>.` Browsers have a built-in framework for decoding and playing audio
|
88
|
-
content directly within a webpage.
|
89
|
-
|
90
|
-
.Ambient Piano
|
91
|
-
audio::/assets/audio/sound-effects/ambient-piano.mp3[role="mt-4 mb-5"]
|
92
|
-
|
93
|
-
|
94
|
-
[role="mt-5"]
|
95
|
-
== AmplitudeJS Audio
|
96
|
-
|
97
|
-
The J1 Template implements custom players based on the (default) theme Uno.
|
98
|
-
The color scheme used matches the look and feel of the template to preserve
|
99
|
-
the page design.
|
100
|
-
|
101
|
-
Three types of AmplitudeJS players are build-in for the J1 template system:
|
102
|
-
|
103
|
-
* Mini Player
|
104
|
-
* Compact Player (default
|
105
|
-
* Large Player
|
106
|
-
|
107
|
-
[role="mt-4"]
|
108
|
-
[NOTE]
|
109
|
-
====
|
110
|
-
Amplitude players for the J1 Template are mobile-friendly. Instead of
|
111
|
-
clicking on the appropriate elements, touch events are applied to all
|
112
|
-
mobile devices.
|
113
|
-
====
|
114
|
-
|
115
|
-
|
116
|
-
[role="mt-5"]
|
117
|
-
== Mini Player
|
118
|
-
|
119
|
-
In the context of complex components on a web page, like an audio player,
|
120
|
-
a mini player refers to a minimized version of full players. It typically
|
121
|
-
offers basic playback controls, such as pause, play, and
|
122
|
-
volume adjustment, while taking up less screen space.
|
123
|
-
|
124
|
-
Mini players are beneficial when you want to listen to audio in the
|
125
|
-
background without dedicating the entire screen to the player. They
|
126
|
-
are commonly found on music streaming services, podcast platforms, and
|
127
|
-
websites with embedded audio content.
|
128
|
-
|
129
|
-
.Emancipator · From Dusk To Dawn
|
130
|
-
amplitude::free_emancipator_mini[role="mt-3 mb-5"]
|
131
|
-
|
132
|
-
.Royalty Free Music · Disco 80th
|
133
|
-
amplitude::free_disco_mini[role="mt-3 mb-5"]
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
|
142
|
-
|
143
|
-
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
|
181
|
-
|
182
|
-
|
183
|
-
|
184
|
-
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
pure HTML way to show play video on the web. Modern browsers
|
190
|
-
support the the video tag `<video>` for the current HTML5 standard.
|
191
|
-
|
192
|
-
The previous proprietary de facto standard software like a Flash Player,
|
193
|
-
Quicktime, or Silverlight is no longer needed as the Theme JekyllOne provides
|
194
|
-
HTML5 video for local content and from online sources on the Internet.
|
195
|
-
|
196
|
-
[role="mb-7"]
|
197
|
-
Incredible? See the next example page link:{url-tour--present-video}[Video Player].
|
1
|
+
---
|
2
|
+
title: Audio Player
|
3
|
+
title_extention: Playback Audio using J1 Template
|
4
|
+
tagline: Playback Audio
|
5
|
+
|
6
|
+
date: 2024-04-16
|
7
|
+
#last_modified: 2024-01-01
|
8
|
+
|
9
|
+
description: >
|
10
|
+
J1 Template provides playing audio on web pages
|
11
|
+
by HTML5 and supports custom players created
|
12
|
+
by AmplitudeJS to playback audio individually.
|
13
|
+
keywords: >
|
14
|
+
open source, free, template, jekyll, jekyllone, web,
|
15
|
+
sites, static, jamstack, bootstrap, html, html5,
|
16
|
+
asciidoctor, audio
|
17
|
+
|
18
|
+
categories: [ Tour ]
|
19
|
+
tags: [ Audio, Module ]
|
20
|
+
|
21
|
+
image:
|
22
|
+
path: /assets/image/modules/attics/1920x1280/alexey-ruban.jpg
|
23
|
+
width: 1920
|
24
|
+
height: 1280
|
25
|
+
|
26
|
+
tts: true
|
27
|
+
comments: false
|
28
|
+
exclude_from_search: false
|
29
|
+
regenerate: false
|
30
|
+
personalization: true
|
31
|
+
permalink: /pages/public/tour/playback_audio/
|
32
|
+
|
33
|
+
resources: [ amplitudejs ]
|
34
|
+
resource_options:
|
35
|
+
- toccer:
|
36
|
+
collapseDepth: 2
|
37
|
+
- attic:
|
38
|
+
slides:
|
39
|
+
- url: /assets/image/modules/attics/1920x1280/alexey-ruban.jpg
|
40
|
+
alt: Photo by Alexey Ruban on Unsplash
|
41
|
+
badge:
|
42
|
+
type: unsplash
|
43
|
+
author: Alexey Ruban
|
44
|
+
href: //unsplash.com/de/@intelligenciya
|
45
|
+
---
|
46
|
+
|
47
|
+
// Page Initializer
|
48
|
+
// =============================================================================
|
49
|
+
// Enable the Liquid Preprocessor
|
50
|
+
:page-liquid:
|
51
|
+
|
52
|
+
// Set (local) page attributes here
|
53
|
+
// -----------------------------------------------------------------------------
|
54
|
+
// :page--attr: <attr-value>
|
55
|
+
|
56
|
+
|
57
|
+
// Load Liquid procedures
|
58
|
+
// -----------------------------------------------------------------------------
|
59
|
+
{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
|
60
|
+
|
61
|
+
// Load page attributes
|
62
|
+
// -----------------------------------------------------------------------------
|
63
|
+
{% include {{load_attributes}} scope="all" %}
|
64
|
+
|
65
|
+
// See: https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Audio_codecs
|
66
|
+
// See: https://docs.asciidoctor.org/asciidoc/latest/macros/audio-and-video/
|
67
|
+
//
|
68
|
+
[role="dropcap"]
|
69
|
+
The Audio tag in HTML5 is a great way to add audio media to web pages.
|
70
|
+
However, the browser fully controls the audio playback interface,
|
71
|
+
which can limit or even break a page's design if audio media is used.
|
72
|
+
|
73
|
+
AmplitudeJS for J1 Template offers a straightforward solution for web
|
74
|
+
developers. It allows them to easily customize the appearance of their audio
|
75
|
+
players without the need for complex scripting. By leveraging J1 Template
|
76
|
+
and Amplitude's API, web designers can craft unique interfaces that define
|
77
|
+
the visual and functional aspects of a player's audio control elements.
|
78
|
+
|
79
|
+
mdi:clock-time-five-outline[24px, md-gray mt-4 mb-5 mr-2]
|
80
|
+
*5-10 Minutes* to read
|
81
|
+
|
82
|
+
|
83
|
+
[role="mt-5"]
|
84
|
+
== HTML 5 Audio
|
85
|
+
|
86
|
+
Audio players can easily be embedded in web pages using the *audio* tag
|
87
|
+
`<audio>.` Browsers have a built-in framework for decoding and playing audio
|
88
|
+
content directly within a webpage.
|
89
|
+
|
90
|
+
.Ambient Piano
|
91
|
+
audio::/assets/audio/sound-effects/ambient-piano.mp3[role="mt-4 mb-5"]
|
92
|
+
|
93
|
+
|
94
|
+
[role="mt-5"]
|
95
|
+
== AmplitudeJS Audio
|
96
|
+
|
97
|
+
The J1 Template implements custom players based on the (default) theme Uno.
|
98
|
+
The color scheme used matches the look and feel of the template to preserve
|
99
|
+
the page design.
|
100
|
+
|
101
|
+
Three types of AmplitudeJS players are build-in for the J1 template system:
|
102
|
+
|
103
|
+
* Mini Player
|
104
|
+
* Compact Player (default player)
|
105
|
+
* Large Player
|
106
|
+
|
107
|
+
[role="mt-4"]
|
108
|
+
[NOTE]
|
109
|
+
====
|
110
|
+
Amplitude players for the J1 Template are mobile-friendly. Instead of
|
111
|
+
clicking on the appropriate elements, touch events are applied to all
|
112
|
+
mobile devices.
|
113
|
+
====
|
114
|
+
|
115
|
+
|
116
|
+
[role="mt-5"]
|
117
|
+
== Mini Player
|
118
|
+
|
119
|
+
In the context of complex components on a web page, like an audio player,
|
120
|
+
a mini player refers to a minimized version of full players. It typically
|
121
|
+
offers basic playback controls, such as pause, play, and
|
122
|
+
volume adjustment, while taking up less screen space.
|
123
|
+
|
124
|
+
Mini players are beneficial when you want to listen to audio in the
|
125
|
+
background without dedicating the entire screen to the player. They
|
126
|
+
are commonly found on music streaming services, podcast platforms, and
|
127
|
+
websites with embedded audio content.
|
128
|
+
|
129
|
+
.Emancipator · From Dusk To Dawn
|
130
|
+
amplitude::free_emancipator_mini[role="mt-3 mb-5"]
|
131
|
+
|
132
|
+
.Royalty Free Music · Disco 80th
|
133
|
+
amplitude::free_disco_mini[role="mt-3 mb-5"]
|
134
|
+
|
135
|
+
|
136
|
+
[role="mt-5"]
|
137
|
+
== Compact Player
|
138
|
+
|
139
|
+
A complex component like an audio player on a web page, *compact*
|
140
|
+
typically refers to a design or layout that minimizes the component's
|
141
|
+
space while maintaining its functionality and usability.
|
142
|
+
|
143
|
+
A *compact* design allows the audio player to fit neatly within the web
|
144
|
+
page's layout without overwhelming or dominating the content around it.
|
145
|
+
The design aims to balance functionality and space efficiency, ensuring
|
146
|
+
users can easily access and control the audio playback without sacrificing
|
147
|
+
too much screen space.
|
148
|
+
|
149
|
+
.Emancipator · From Dusk To Dawn
|
150
|
+
amplitude::free_emancipator_compact[role="mt-3 mb-5"]
|
151
|
+
|
152
|
+
.Royalty Free Music · Disco 80th
|
153
|
+
amplitude::free_disco_compact[role="mt-3 mb-5"]
|
154
|
+
|
155
|
+
|
156
|
+
[role="mt-5"]
|
157
|
+
== Large Player
|
158
|
+
|
159
|
+
A large player supports a design for displaying all components but requires
|
160
|
+
the full (horizontal) space in a webpage. This player type makes it easy for
|
161
|
+
all users to navigate and plaback all titles provided.
|
162
|
+
|
163
|
+
.Emancipator · From Dusk To Dawn
|
164
|
+
amplitude::free_emancipator_large[role="mt-3 mb-5"]
|
165
|
+
|
166
|
+
.Royalty Free Music · Disco 80th
|
167
|
+
amplitude::free_disco_large[role="mt-3 mb-5"]
|
168
|
+
|
169
|
+
|
170
|
+
[role="mt-5"]
|
171
|
+
== What next
|
172
|
+
|
173
|
+
I hope, you've enjoyed exploring the possibilities J1 offers for playing
|
174
|
+
digital audio content. But much, much more can the J1 do for your web in
|
175
|
+
terms of multimedia.
|
176
|
+
|
177
|
+
The J1 Template support playing video on web pages by using the
|
178
|
+
HTML5 video support, the new standard of HTML. HTML5 implements a
|
179
|
+
pure HTML way to show play video on the web. Modern browsers
|
180
|
+
support the the video tag `<video>` for the current HTML5 standard.
|
181
|
+
|
182
|
+
The previous proprietary de facto standard software like a Flash Player,
|
183
|
+
Quicktime, or Silverlight is no longer needed as the Theme JekyllOne provides
|
184
|
+
HTML5 video for local content and from online sources on the Internet.
|
185
|
+
|
186
|
+
[role="mb-7"]
|
187
|
+
Incredible? See the next examples on how to playback video on the page
|
188
|
+
link:{url-tour--playback-video}[Video Player].
|
@@ -493,4 +493,5 @@ Quicktime, or Silverlight is no longer needed as the Theme JekyllOne provides
|
|
493
493
|
HTML5 video for local content and from online sources on the Internet.
|
494
494
|
|
495
495
|
[role="mb-7"]
|
496
|
-
Incredible? See the next example page
|
496
|
+
Incredible? See the next example page forcussing on playing audio:
|
497
|
+
link:{url-tour--playback-audio}[Audio Player].
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: j1-template
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 2024.3.
|
4
|
+
version: 2024.3.13
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- juergen_jekyll_one
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2024-08-
|
11
|
+
date: 2024-08-07 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: jekyll
|
@@ -2859,13 +2859,7 @@ files:
|
|
2859
2859
|
- lib/starter_web/pages/public/plans/_includes/attributes.asciidoc
|
2860
2860
|
- lib/starter_web/pages/public/plans/plans.adoc
|
2861
2861
|
- lib/starter_web/pages/public/tools/previewer/_includes/attributes.asciidoc
|
2862
|
-
- lib/starter_web/pages/public/tools/previewer/_includes/documents/amplitudejs.large.css.asciidoc
|
2863
|
-
- lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.hover.html
|
2864
|
-
- lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.nested.html
|
2865
|
-
- lib/starter_web/pages/public/tools/previewer/_includes/documents/frame.textarea.html
|
2866
|
-
- lib/starter_web/pages/public/tools/previewer/_includes/documents/my.content.html
|
2867
2862
|
- lib/starter_web/pages/public/tools/previewer/_includes/documents/readme
|
2868
|
-
- lib/starter_web/pages/public/tools/previewer/preview_amplitudejs.adoc
|
2869
2863
|
- lib/starter_web/pages/public/tools/previewer/preview_bootstrap_theme.adoc
|
2870
2864
|
- lib/starter_web/pages/public/tour/_includes/attributes.asciidoc
|
2871
2865
|
- lib/starter_web/pages/public/tour/_includes/documents/100_gistblock.asciidoc
|