j1-template 2021.1.26 → 2021.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (143) hide show
  1. checksums.yaml +4 -4
  2. data/_includes/themes/j1/layouts/content_generator_article_navigator.html +1 -1
  3. data/_includes/themes/j1/layouts/content_generator_blog_archive.html +6 -4
  4. data/_includes/themes/j1/layouts/content_generator_post.html +3 -0
  5. data/_includes/themes/j1/modules/navigator/generator.html +1 -1
  6. data/_includes/themes/j1/procedures/posts/collate_timeline.proc +1 -1
  7. data/_includes/themes/j1/procedures/posts/create_series_header.proc +6 -6
  8. data/_layouts/default.html +1 -0
  9. data/assets/data/mdil_icons.json +2417 -0
  10. data/assets/data/panel.html +0 -15
  11. data/assets/themes/j1/adapter/js/j1.js +6 -6
  12. data/assets/themes/j1/adapter/js/j1scroll.js +143 -46
  13. data/assets/themes/j1/core/css/icon-fonts/materialdesign-light.css +1222 -0
  14. data/assets/themes/j1/core/css/icon-fonts/materialdesign-light.min.css +1 -0
  15. data/assets/themes/j1/core/css/icon-fonts/materialdesign.css +1 -1
  16. data/assets/themes/j1/core/css/themes/uno-light/bootstrap.css +42 -0
  17. data/assets/themes/j1/core/css/themes/uno-light/bootstrap.min.css +1 -1
  18. data/assets/themes/j1/core/fonts/material_design_icons_light/fonts/eot/materialdesignicons-light-webfont.eot +0 -0
  19. data/assets/themes/j1/core/fonts/material_design_icons_light/fonts/materialdesignicons-light-webfont.woff +0 -0
  20. data/assets/themes/j1/core/fonts/material_design_icons_light/fonts/materialdesignicons-light-webfont.woff2 +0 -0
  21. data/assets/themes/j1/core/fonts/material_design_icons_light/fonts/svg/materialdesignicons-light-webfont.svg +801 -0
  22. data/assets/themes/j1/core/fonts/material_design_icons_light/fonts/ttf/materialdesignicons-light-webfont.ttf +0 -0
  23. data/assets/themes/j1/core/js/template.js +4 -4
  24. data/assets/themes/j1/core/js/template.js.map +1 -1
  25. data/assets/themes/j1/core/js/template.min.js +4 -4
  26. data/assets/themes/j1/core/js/template.min.js.map +1 -1
  27. data/assets/themes/j1/modules/j1Scroll/css/theme/uno.css +4 -50
  28. data/assets/themes/j1/modules/j1Scroll/css/theme/uno.min.css +1 -1
  29. data/assets/themes/j1/modules/j1Scroll/js/j1scroll.js +263 -188
  30. data/assets/themes/j1/modules/j1Scroll/js/j1scroll.min.js +16 -0
  31. data/assets/themes/j1/modules/mdiPreviewer/css/previewer.css +1 -1
  32. data/assets/themes/j1/modules/mdiPreviewer/css/previewer.min.css +1 -1
  33. data/assets/themes/j1/modules/mdiPreviewer/js/previewer.js +5 -15
  34. data/assets/themes/j1/modules/mdiPreviewer/js/previewer.min.js +1 -1
  35. data/assets/themes/j1/modules/mdilPreviewer/css/previewer.css +97 -0
  36. data/assets/themes/j1/modules/mdilPreviewer/css/previewer.min.css +15 -0
  37. data/assets/themes/j1/modules/mdilPreviewer/js/previewer.js +125 -0
  38. data/assets/themes/j1/modules/mdilPreviewer/js/previewer.min.js +15 -0
  39. data/assets/themes/j1/modules/showOnScroll/js/showOnScroll.js +73 -74
  40. data/assets/themes/j1/modules/showOnScroll/js/showOnScroll.min.js +15 -15
  41. data/lib/j1/commands/generate.rb +5 -8
  42. data/lib/j1/version.rb +3 -3
  43. data/lib/starter_web/Gemfile +1 -1
  44. data/lib/starter_web/_config.yml +3 -3
  45. data/lib/starter_web/_data/blocks/banner.yml +4 -5
  46. data/lib/starter_web/_data/blocks/panel.yml +217 -183
  47. data/lib/starter_web/_data/builder/blog_navigator.yml +1 -0
  48. data/lib/starter_web/_data/layouts/home.yml +20 -16
  49. data/lib/starter_web/_data/modules/defaults/navigator.yml +1 -1
  50. data/lib/starter_web/_data/modules/j1scroll.yml +67 -0
  51. data/lib/starter_web/_data/modules/navigator_menu.yml +3 -3
  52. data/lib/starter_web/_data/resources.yml +41 -44
  53. data/lib/starter_web/_includes/attributes.asciidoc +1 -1
  54. data/lib/starter_web/_plugins/lunr_index.rb +1 -1
  55. data/lib/starter_web/assets/images/modules/attics/annie-spratt-1920x1280.jpg +0 -0
  56. data/lib/starter_web/assets/images/modules/attics/antonino-visalli-1920x1280.jpg +0 -0
  57. data/lib/starter_web/assets/images/modules/attics/humble-lamb-1920x1280.jpg +0 -0
  58. data/lib/starter_web/assets/images/modules/attics/library-1920x1280.jpg +0 -0
  59. data/lib/starter_web/assets/images/modules/attics/romain-vignes-1920x1280.jpg +0 -0
  60. data/lib/starter_web/assets/images/modules/attics/sigmund-1920x1280.jpg +0 -0
  61. data/lib/starter_web/assets/images/{pages/videos → modules/attics}/szabo-viktor-1920x1280.jpg +0 -0
  62. data/lib/starter_web/assets/images/pages/asciidoc_skeletons/example-pdf-screenshot.png +0 -0
  63. data/lib/starter_web/collections/posts/public/featured/_posts/{2020-01-01-about-cookies.adoc → 2021-01-01-about-cookies.adoc} +0 -0
  64. data/lib/starter_web/collections/posts/public/featured/_posts/{2021-03-01-site-generators.adoc → 2021-02-01-site-generators.adoc} +0 -0
  65. data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-20-minneapolis.adoc → series/_posts/2020-01-01-post-wiki-series.adoc} +11 -10
  66. data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-24-narcisse-snake-dens.adoc → series/_posts/2020-01-02-post-wiki-series.adoc} +15 -13
  67. data/lib/starter_web/collections/posts/public/{wikipedia/_posts/2016-11-26-columbia-river.adoc → series/_posts/2020-01-03-post-wiki-series.adoc} +28 -11
  68. data/lib/starter_web/collections/posts/public/{wikipedia → series}/_posts/_includes/attributes.asciidoc +0 -0
  69. data/lib/starter_web/collections/posts/public/{wikipedia → series}/_posts/_includes/documents/readme +0 -0
  70. data/lib/starter_web/collections/posts/public/{wikipedia → series}/_posts/_includes/tables/readme +0 -0
  71. data/lib/starter_web/index.html +2 -2
  72. data/lib/starter_web/package.json +1 -1
  73. data/lib/starter_web/pages/public/asciidoc_skeletons/{book → documentation}/000_intro.adoc +5 -7
  74. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/100_converter.adoc +43 -0
  75. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/200_themes.adoc +61 -0
  76. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/attributes.asciidoc +95 -0
  77. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/000_intro.asciidoc +54 -0
  78. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/100_converter/000_basic_example.asciidoc +31 -0
  79. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/100_converter/111_about_the_converter.asciidoc +111 -0
  80. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/100_converter/112_getting_started.asciidoc +95 -0
  81. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/100_converter/113_themes.asciidoc +39 -0
  82. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/100_converter.asciidoc +8 -0
  83. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/200_themes/211_language_overview.asciidoc +122 -0
  84. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/200_themes/212_values.asciidoc +502 -0
  85. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/200_themes/213_fonts.asciidoc +261 -0
  86. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/_includes/documents/200_themes.asciidoc +8 -0
  87. data/lib/starter_web/pages/public/asciidoc_skeletons/{book → documentation}/a2p.bat +1 -1
  88. data/lib/starter_web/pages/public/asciidoc_skeletons/{book → documentation}/a2p.sh +2 -2
  89. data/lib/starter_web/pages/public/asciidoc_skeletons/{book/book.a2p → documentation/documentation.a2p} +2 -8
  90. data/lib/starter_web/pages/public/asciidoc_skeletons/documentation/documentation.adoc +86 -0
  91. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/_includes/documents/100_chapter.asciidoc +848 -40
  92. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/_includes/documents/200_chapter.asciidoc +149 -38
  93. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/multi.adoc +2 -7
  94. data/lib/starter_web/pages/public/asciidoc_skeletons/simple-document/simple.adoc +312 -119
  95. data/lib/starter_web/pages/public/blog/navigator/index.html +3 -2
  96. data/lib/starter_web/pages/public/previewer/mdi_icons_preview.adoc +2 -2
  97. data/lib/starter_web/pages/public/previewer/mdil_icons_preview.adoc +76 -0
  98. data/lib/starter_web/utilsrv/_defaults/package.json +1 -1
  99. data/lib/starter_web/utilsrv/package.json +1 -1
  100. metadata +52 -59
  101. data/assets/themes/j1/adapter/js/infiniteScroll.js +0 -259
  102. data/assets/themes/j1/modules/infiniteScroll/css/theme/uno.css +0 -150
  103. data/assets/themes/j1/modules/infiniteScroll/css/theme/uno.min.css +0 -15
  104. data/assets/themes/j1/modules/infiniteScroll/js/infiniteScroll.js +0 -1915
  105. data/assets/themes/j1/modules/infiniteScroll/js/infiniteScroll.min.js +0 -17
  106. data/lib/starter_web/_data/modules/defaults/infiniteScroll.yml +0 -73
  107. data/lib/starter_web/_data/modules/infiniteScroll.yml +0 -66
  108. data/lib/starter_web/collections/posts/public/series/_posts/2020-01-01-post-test-series.adoc +0 -128
  109. data/lib/starter_web/collections/posts/public/series/_posts/2020-01-02-post-test-series.adoc +0 -131
  110. data/lib/starter_web/collections/posts/public/series/_posts/2020-01-03-post-test-series.adoc +0 -131
  111. data/lib/starter_web/collections/posts/public/series/_posts/2020-01-04-post-test-series.adoc +0 -132
  112. data/lib/starter_web/pages/infinite-scroll-tester-5.adoc +0 -119
  113. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/asciidoc-extensions/blindtext.asciidoc +0 -11
  114. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/asciidoc-extensions/font_icons.asciidoc +0 -23
  115. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/asciidoc-extensions/gallery.asciidoc +0 -5
  116. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/asciidoc-extensions/lightbox.asciidoc +0 -7
  117. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/documents/chapter_document.asciidoc +0 -9
  118. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/documents/entry_document.asciidoc +0 -3
  119. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/images/image.asciidoc +0 -6
  120. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_2_column.asciidoc +0 -12
  121. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_2_column_options.asciidoc +0 -30
  122. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_3_column.asciidoc +0 -16
  123. data/lib/starter_web/pages/public/asciidoc_skeletons/_templates/tables/table_4_column.asciidoc +0 -25
  124. data/lib/starter_web/pages/public/asciidoc_skeletons/book/100_chapter.adoc +0 -62
  125. data/lib/starter_web/pages/public/asciidoc_skeletons/book/200_chapter.adoc +0 -64
  126. data/lib/starter_web/pages/public/asciidoc_skeletons/book/900_references.adoc +0 -73
  127. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/attributes.asciidoc +0 -74
  128. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/000_intro.asciidoc +0 -33
  129. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter/100_chapter_document.asciidoc +0 -21
  130. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter/110_chapter_document.asciidoc +0 -36
  131. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/100_chapter.asciidoc +0 -7
  132. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/200_chapter/200_chapter_document.asciidoc +0 -53
  133. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/200_chapter.asciidoc +0 -5
  134. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/900_references/000_intro.asciidoc +0 -23
  135. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/900_references/100_chapter_document.asciidoc +0 -33
  136. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/900_references/200_chapter_document.asciidoc +0 -26
  137. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/900_references/900_sources.asciidoc +0 -81
  138. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/900_references.asciidoc +0 -23
  139. data/lib/starter_web/pages/public/asciidoc_skeletons/book/_includes/documents/tables/110_material_design_icons.asciidoc +0 -102
  140. data/lib/starter_web/pages/public/asciidoc_skeletons/book/book.adoc +0 -136
  141. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/100_chapter.asciidoc +0 -60
  142. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/200_chapter.asciidoc +0 -59
  143. data/lib/starter_web/pages/public/asciidoc_skeletons/multi-document/_includes/documents/tables/110_material_design_icons.asciidoc +0 -102
@@ -1,74 +0,0 @@
1
- // ~/document_base_folder/000_includes
2
- // Asciidoc attribute includes: attributes.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- // URLs - Internal references and/or sources on the Internet
6
- // -----------------------------------------------------------------------------
7
- tag::urls[]
8
- :url-j1--home: https://jekyll.one
9
- :url-wikipedia--chapter: https://en.wikipedia.org/wiki/Chapter_(books)/
10
- :url-wikipedia-en--writing: https://en.wikipedia.org/wiki/Introduction_(writing)/
11
- :url-wikipedia-en--asciidoc: https://en.wikipedia.org/wiki/AsciiDoc
12
-
13
- :url-fontawesome--home: https://fontawesome.com/
14
- :url-fontawesome--icons: https://fontawesome.com/icons?d=gallery/
15
- :url-fontawesome--get-started: https://fontawesome.com/get-started/
16
-
17
- :url-mdi--home: https://materialdesignicons.com/
18
- :url-mdi-icons--cheatsheet: https://cdn.materialdesignicons.com/3.3.92/
19
-
20
- :url-iconify--home: https://iconify.design/
21
- :url-iconify--icon-sets: https://iconify.design/icon-sets/
22
- :url-iconify--medical-icons: https://iconify.design/icon-sets/medical-icon/
23
- :url-iconify--brand-icons: https://iconify.design/icon-sets/logos/
24
-
25
- :url-roundtrip--mdi-icons: /pages/public/learn/roundtrip/mdi_icon_font/#material-design-icons
26
- :url-roundtrip--fontawesome-icons: /pages/public/learn/roundtrip/mdi_icon_font/#fontawesome-icons
27
- :url-roundtrip--iconify-icons: /pages/public/learn/roundtrip/mdi_icon_font/#iconify-icons
28
- :url-roundtrip--asciidoc-extensions: /pages/public/learn/roundtrip/asciidoc_extensions/
29
-
30
- :url-asciidoctor--asciidoc-writers-guide: https://asciidoctor.org/docs/asciidoc-writers-guide/
31
- :url-asciidoctor--asciidoc-manual: https://docs.asciidoctor.org/asciidoc/latest/
32
- end::urls[]
33
-
34
-
35
- // FOOTNOTES, global asciidoc attributes (variables)
36
- // -----------------------------------------------------------------------------
37
- tag::footnotes[]
38
- end::footnotes[]
39
-
40
-
41
- // Tags - Asciidoc attributes used internally
42
- // -----------------------------------------------------------------------------
43
- tag::tags[]
44
- end::tags[]
45
-
46
-
47
- // Data - Data elements for Asciidoctor extensions
48
- // -----------------------------------------------------------------------------
49
- tag::data[]
50
- :data-images-standalone: "pages/roundtrip/100_present_images/lightbox-image-1.jpg, Golden Gate Bridge with San Francisco in distance, pages/roundtrip/100_present_images/lightbox-image-2.jpg, Forest with mountains behind"
51
- :data-images-group: "pages/roundtrip/100_present_images/lightbox-image-1.jpg, Golden Gate Bridge with San Francisco in distance, pages/roundtrip/100_present_images/lightbox-image-2.jpg, Forest with mountains behind"
52
- end::data[]
53
-
54
-
55
- // Images - Images from local include/images folder
56
- // -----------------------------------------------------------------------------
57
- tag::images[]
58
- end::images[]
59
-
60
-
61
- // PRODUCTS, local product information (e.g. release)
62
- // -----------------------------------------------------------------------------
63
- tag::products[]
64
- :license: e.g. Apache License, Version 2.0
65
- :revdate: e.g. 2018
66
- :revnumber: e.g. 1.2.3
67
- end::products[]
68
-
69
-
70
- // AUTHORS, local author information (e.g. article)
71
- // -----------------------------------------------------------------------------
72
- tag::authors[]
73
- :uri-author-xxx: https://xxx
74
- end::authors[]
@@ -1,33 +0,0 @@
1
- // ~/document_base_folder/000_includes/documents
2
- // Intro document: 000_intro.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- == Introduction
6
-
7
- {url-wikipedia-en--writing}[From Wikipedia, {browser-window--new}]
8
-
9
- In an essay, article, or book, an introduction (also known as a prolegomenon)
10
- is a beginning section which states the purpose and goals of the following
11
- writing. This is generally followed by the body and conclusion.
12
-
13
- The introduction typically describes the scope of the document and gives
14
- the brief explanation or summary of the document. It may also explain certain
15
- elements that are important to the essay if explanations are not part of
16
- the main text. The readers can have an idea about the following text before
17
- they actually start reading it.
18
-
19
- ln technical writing, the introduction typically includes one or more standard
20
- subsections: abstract or summary, preface, acknowledgments, and foreword.
21
- Alternatively, the section labeled introduction itself may be a brief
22
- section found side-by-side with abstract, foreword, etc. (rather than
23
- containing them). In this case the set of sections that come before the
24
- body of the book are known as the front matter. When the book is divided
25
- into numbered chapters, by convention the introduction and any other
26
- front-matter sections are unnumbered and precede chapter 1.
27
-
28
- Keeping the concept of the introduction the same, different documents
29
- have different styles to introduce the written text. For example,
30
- the introduction of a Functional Specification consists of information
31
- that the whole document is yet to explain. If a Userguide is written,
32
- the introduction is about the product. In a report, the introduction gives
33
- a summary about the report contents.
@@ -1,21 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/100_chapter/
2
- // Chapter document: 100_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- == Chapter 1
6
-
7
- J1 Template support popular icons font sets out-of-the-box:
8
-
9
- * link:{url-mdi--home}[Material Design Icons, {browser-window--new}] (MDI)
10
- * link:{url-fontawesome--home}[FontAwesome Icons V5, {browser-window--new}] (FA)
11
- * link:{url-iconify--home}[Iconify Icons, {browser-window--new}] (II)
12
-
13
- The icon sets MDI and FA are very good in design and have a rich set of
14
- different icons for many categories used for the Web. See below some details
15
- for link:{url-roundtrip--mdi-icons}[Material Design Icons, {browser-window--new}]
16
- and link:{url-roundtrip--fontawesome-icons}[FontAwesome Icons, {browser-window--new}].
17
-
18
- Iconify icons is not a locally stored icon-set like MDI or FA. All icons are
19
- loaded over the Internet using the so-called *Unified OpenSource Icon
20
- Framework*. See section link:{url-roundtrip--iconify-icons}[Iconify Icons, {browser-window--new}]
21
- for more information.
@@ -1,36 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/100_chapter/
2
- // Chapter document: 110_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- === Section
6
-
7
- The primary icon-set for J1 Template is
8
- link:{url-mdi--home}[Material Design Icons, {browser-window--new}],
9
- because it is extremely rich set providing more than 5900+ icons for the
10
- current version (v5.9.55). From a design perspective, _MDI_ has an excellen
11
- *Material Design* support an comes with the original icon set created by
12
- _Google_ build-in.
13
-
14
- _Material Design Icons_ (MDI) is a beneficial design resource for Web Design
15
- that is based on _Google_'s Material Design. _MDI_ is a community-driven
16
- project to create an increased number of icons based on _Google_'s official
17
- repository and MD style specification.
18
-
19
- ==== Subsection
20
-
21
- _MDI_ is a growing collection to allow designers and developers targeting
22
- various platforms to download icons in the format, color and size they need
23
- for any project. The repo contains today 2100+ icons plus converted icons from
24
- the official set created by _Google_.
25
-
26
- // include::{documentdir}/tables/110_material_design_icons.asciidoc
27
- // include::{tabledir}/110_material_design_icons.asciidoc
28
- include::../tables/110_material_design_icons.asciidoc[]
29
-
30
- NOTE: Using Material Design Icons with Asciidoc is quite easy as an inline
31
- macro `mdi:` is available to place icons where ever you want. See more about
32
- this in section
33
- link:{url-roundtrip--asciidoc-extensions}#icon-fonts[Asciidoc Extensions, {browser-window--new}]
34
-
35
- _J1 Template_ supports the full set of _MDI_ for the Web (Webfont, WOFF). The
36
- icon set is fully integrated and can be used out-of-the-box.
@@ -1,7 +0,0 @@
1
- // ~/document_base_folder/_includes/documents
2
- // Sublevel Entry Document: 100_chapter.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- include::100_chapter/100_chapter_document.asciidoc[]
6
-
7
- include::100_chapter/110_chapter_document.asciidoc[]
@@ -1,53 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/200_chapter/
2
- // Chapter document: 200_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- == Chapter 2
6
-
7
- A Lightbox, in general, is a helper which displays enlarged, almost
8
- screen-filling versions of pictures (or videos), while dimming the rest of the
9
- page. The technique, introduced by Lightbox V2, gained widespread popularity
10
- due to its simple and elegant style. The term lightbox is used since then for
11
- Javascript libraries to support such functionality.
12
-
13
- For J1 Template, two different lightboxes can be used:
14
-
15
- * Lightbox V2 (lightbox)
16
- * LightGallery
17
-
18
- The default lightbox used by J1 Template is Lightbox V2, a Javascript library
19
- written by _Lokesh Dhakar_. The name of that (build-in) is simply: lightbox.
20
- For more complex use cases, like a thumbnail gallery preview or video support,
21
- LightGallery can be used alternatively.
22
-
23
- NOTE: The name LightGallery implies a sort of a Gallery, but the library is a
24
- _lightbox_. And, LightGallery provides much more functionality on image-based
25
- data rather than enlarged displaying of images. See the examples below to check
26
- for the differences in comparison to the simpler Lightbox V2 lightbox.
27
-
28
- Both lightboxes are fully integrated to be used as standalone modules or to be
29
- used as helpers _under-the-hood_ by other apps or modules focussing on
30
- image-data like gallery or carousel, the build-in carousel module.
31
-
32
- === Section
33
-
34
- Find below an example of using the lightbox Lightbox standalone. See how
35
- single (individual) images are linked for the use with Lightbox.
36
-
37
- .Lightbox block for standalone images
38
- lightbox::example-standalone[ 400, {data-images-standalone} ]
39
-
40
- For a group of images (image sets), Lightbox support image groups. Click
41
- on the images below to see how Lightbox manage image groups.
42
-
43
- .Lightbox block for grouped images
44
- lightbox::example-group[ 400, {data-images-group}, group ]
45
-
46
- ==== Subsection
47
-
48
- LightGallery provides more complex functions on image data. The lightbox
49
- supports a gallery-style thumbnail preview plus image resizing, a dowload
50
- dialogue, sharing provider support and some more helpful. Check what
51
- LightGallery can do by the following example.
52
-
53
- gallery::jg_example[]
@@ -1,5 +0,0 @@
1
- // ~/document_base_folder/_includes/documents
2
- // Sublevel Entry Document: 200_chapter.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- include::200_chapter/200_chapter_document.asciidoc[]
@@ -1,23 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/900_sources/
2
- // Chapter document: 100_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- // URIs may moved to ~/000_includes/attributes.asciidoc
6
- // -----------------------------------------------------------------------------
7
- :url-wikipedia--introduction: https://en.wikipedia.org/wiki/Introduction_(writing)
8
-
9
- === Introduction
10
-
11
- .References - Introduction
12
- [cols="3,^.>5a,^1,^1,^1,^1", subs=+macros, options="header", role="rtable mt-3 mb-5"]
13
- |===============================================================================
14
- |Author |Title |Year |Level |Cite |Source
15
-
16
- |Wikipedia
17
- |{url-wikipedia--introduction}[Introduction (writing), {browser-window--new}]
18
- |na
19
- |{level--beginner}
20
- |{icon-checked}
21
- |{icon-checked}
22
-
23
- |===============================================================================
@@ -1,33 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/900_sources/
2
- // Chapter document: 100_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- === Chapter 1
6
-
7
- .References - Chapter 1
8
- [cols="3,^.>5a,^1,^1,^1,^1", subs=+macros, options="header", role="rtable mt-3 mb-5"]
9
- |===============================================================================
10
- |Author |Title |Year |Level |Cite |Source
11
-
12
- |Austin Andrews
13
- |{url-mdi--home}[Material Design Icons, {browser-window--new}]
14
- |2021
15
- |{level--advanced}
16
- |{icon-checked}
17
- |{icon-times}
18
-
19
- |Fonticons, Inc.
20
- |{url-fontawesome--home}[FontAwesome Icons V5, {browser-window--new}]
21
- |2021
22
- |{level--advanced}
23
- |{icon-checked}
24
- |{icon-times}
25
-
26
- |Iconify OÜ
27
- |{url-iconify--home}[Iconify Icons, {browser-window--new}]
28
- |2021
29
- |{level--advanced}
30
- |{icon-checked}
31
- |{icon-times}
32
-
33
- |===============================================================================
@@ -1,26 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/900_sources/
2
- // Chapter document: 200_chapter_document.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- === Chapter 2
6
-
7
- .References - Chapter 2
8
- [cols="3,^.>5a,^1,^1,^1,^1", subs=+macros, options="header", role="rtable mt-3 mb-5"]
9
- |===============================================================================
10
- |Author |Title |Year |Level |Cite |Source
11
-
12
- |Sachin N
13
- |{url-lightbox-v2--home}[LightGallery, {browser-window--new}]
14
- |2021
15
- |{level--advanced}
16
- |{icon-checked}
17
- |{icon-times}
18
-
19
- |Lokesh Dhakar
20
- |{url-light-gallery--home}[Lightbox V2, {browser-window--new}]
21
- |2021
22
- |{level--advanced}
23
- |{icon-checked}
24
- |{icon-times}
25
-
26
- |===============================================================================
@@ -1,81 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/900_sources/
2
- // Chapter document: 900_sources.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- === Legend
6
-
7
- Find with the following the explanation on all symbols used.
8
-
9
- ==== Levels
10
-
11
- Level of experience required to read and understand what is presented.
12
-
13
- * {level--beginner} beginner
14
- * {level--intermediate} intermediate
15
- * {level--advanced} advanced
16
- * {level--expert} expert
17
-
18
- ==== Usage
19
-
20
- The following symbols indicate, if sth. was used or *not* used.
21
-
22
- * {icon-checked} used
23
- * {icon-times} unused
24
-
25
- === Sources of Information
26
-
27
- Find with this section all references and sources used. Sections <<Articles>>,
28
- <<HowTos>> or <<Blogs and Platforms>> may give additional information for
29
- further reading.
30
-
31
-
32
- ==== Articles
33
-
34
- .Sources - Articles
35
- [cols="3,^.>5a,^1,^1,^1,^1", options="header", width="100%", role="rtable"]
36
- |===============================================================================
37
- |Author |Title |Year |Level |Cite |Source
38
-
39
- |Wikipedia
40
- |{url-wikipedia-en--asciidoc}[Asciidoc, {browser-window--new}]
41
- |na
42
- |{level--beginner}
43
- |{icon-times}
44
- |{icon-times}
45
-
46
- |===============================================================================
47
-
48
-
49
- ==== HowTos
50
-
51
- .Sources - HowTos
52
- [cols="3,^.>5a,^1,^1,^1,^1", options="header", width="100%", role="rtable mt-3"]
53
- |===============================================================================
54
- |Author |Title |Year |Level |Cite |Source
55
-
56
- |asciidoctor.org
57
- |{url-asciidoctor--asciidoc-writers-guide}[AsciiDoc Writer’s Guide, {browser-window--new}]
58
- |na
59
- |{level--intermediate}
60
- |{icon-times}
61
- |{icon-times}
62
-
63
-
64
- |===============================================================================
65
-
66
-
67
- ==== Blogs and Platforms
68
-
69
- .Sources - Blogs and Platforms
70
- [cols="3,^.>5a,^1,^1,^1,^1", options="header", width="100%", role="rtable mt-3"]
71
- |===============================================================================
72
- |Author |Title |Year |Level |Cite |Source
73
-
74
- |asciidoctor.org
75
- |{url-asciidoctor--asciidoc-manual}[AsciiDoc Manual, {browser-window--new}]
76
- |2021
77
- |{level--advanced}
78
- |{icon-checked}
79
- |{icon-times}
80
-
81
- |===============================================================================
@@ -1,23 +0,0 @@
1
- // ~/document_base_folder/_includes/documents
2
- // Sublevel Entry Document: 900_sources.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- == References
6
-
7
- This section lists all references and sources used in all chapters of this
8
- document. The sections <<Articles>>, <<HowTos>> or <<Blogs and Platforms>>
9
- may give additional information for further reading.
10
-
11
- Some documents are using symbols. Find an explanation in section <<legend>>.
12
-
13
-
14
- // Include references by chapters
15
- // -----------------------------------------------------------------------------
16
-
17
- include::900_references/000_intro.asciidoc[]
18
-
19
- include::900_references/100_chapter_document.asciidoc[]
20
-
21
- include::900_references/200_chapter_document.asciidoc[]
22
-
23
- include::900_references/900_sources.asciidoc[]
@@ -1,102 +0,0 @@
1
- // ~/document_base_folder/_includes/documents/tables
2
- // Table document: 110_material_design_icons.asciidoc
3
- // -----------------------------------------------------------------------------
4
-
5
- .Material Design Icons
6
- [cols="2a,3a,4a,^", options="header", width="100%", role="rtable mt-3"]
7
- |===============================================================================
8
- |Size |Modifier |Markup |Render
9
-
10
- |1x
11
- |no modifier set
12
- |All `icon_name` can be found on the Preview page for MDI Icon Previewer +
13
- [source, adoc, role="noclip"]
14
- ----
15
- mdi:account[1x]
16
- ----
17
- |mdi:account[1x]
18
-
19
- |3x
20
- |no modifier set
21
- |All `icon_name` can be found on the Preview page for MDI Icon Previewer +
22
- [source, adoc, role="noclip"]
23
- ----
24
- mdi:account[3x]
25
- ----
26
- |mdi:account[3x]
27
-
28
- |5x
29
- |no modifier set
30
- |All `icon_name` can be found on the Preview page for MDI Icon Previewer
31
- [source, adoc, role="noclip"]
32
- ----
33
- mdi:account[5x]
34
- ----
35
- |mdi:account[5x]
36
-
37
- |5x
38
- |`mdi-rotate-45`
39
- |Rotate 45 degrees
40
- [source, adoc, role="noclip"]
41
- ----
42
- mdi:account[5x mdi-rotate-45]
43
- ----
44
- |mdi:account[5x mdi-rotate-45]
45
-
46
- |5x
47
- |`mdi-rotate-315`
48
- |Rotate 315 degrees
49
- [source, adoc, role="noclip"]
50
- ----
51
- mdi:account[5x mdi-rotate-315]
52
- ----
53
- |mdi:account[5x mdi-rotate-315]
54
-
55
- |5x
56
- |`mdi-light` +
57
- `mdi-flip-v`
58
- |Colour set to MDI Light (Grey) and flipped vertical
59
- [source, adoc, role="noclip"]
60
- ----
61
- mdi:alert[5x mdi-light mdi-flip-v]
62
- ----
63
- |mdi:alert[5x mdi-light mdi-flip-v]
64
-
65
- |5x
66
- |`md-indigo`
67
- |Colour set to MDI Indigo
68
- [source, adoc, role="noclip"]
69
- ----
70
- mdi:alert[5x md-indigo]
71
- ----
72
- |mdi:account[5x md-indigo]
73
-
74
- |5x
75
- |`md-pink`
76
- |Colour set to MDI Pink
77
- [source, adoc, role="noclip"]
78
- ----
79
- mdi:alert[5x md-pink]
80
- ----
81
- |mdi:account[5x md-pink]
82
-
83
- |5x
84
- |`mdi-spin`
85
- |Added animation of type Rotate (Spin)
86
- [source, adoc, role="noclip"]
87
- ----
88
- mdi:loading[5x mdi-spin]
89
- ----
90
- |mdi:loading[5x mdi-spin]
91
-
92
- |5x
93
- |`md-red-900` +
94
- `mdi-pulsed`
95
- |Colour set to MDI Dark Red and added animation of type Pulsed
96
- [source, adoc, role="noclip"]
97
- ----
98
- mdi:heart[5x md-red-900 mdi-pulsed]
99
- ----
100
- |mdi:heart[5x md-red-900 mdi-pulsed]
101
-
102
- |===============================================================================
@@ -1,136 +0,0 @@
1
- ---
2
- # Master Document HTML conversion: book.adoc
3
- #
4
- title: Skeleton
5
- tagline: book
6
- date: 2021-01-01 00:00:00 +100
7
- description: >
8
- A document of type book typically consists in a large number of chapters and
9
- sections. To make this manageable, book-type documents are splitted in multiple
10
- files placed in a nested folder structure. Complex AsciiDoc projects of type
11
- book can be easily worked on by multiple authors.
12
-
13
- categories: [ Knowledge ]
14
- tags: [ Asciidoc, Skeleton, Book ]
15
-
16
- sitemap: false
17
- advertising: false
18
- comments: false
19
-
20
- robots:
21
- index: false
22
- follow: false
23
-
24
- permalink: /pages/public/skeleton/book/
25
- regenerate: false
26
-
27
- resources: [ lightbox, lightGallery, justifiedGallery ]
28
- resource_options:
29
- - toccer:
30
- collapseDepth: 4
31
- - attic:
32
- padding_top: 400
33
- padding_bottom: 50
34
- opacity: 0.5
35
- slides:
36
- - url: /assets/images/pages/skeleton/humble-lamb-1920x1280.jpg
37
- alt: Photo by Humble Lamb on Unsplash
38
- alignY: top
39
- badge:
40
- type: unsplash
41
- author: Humble Lamb
42
- href: https://unsplash.com/@humblelamb
43
- ---
44
-
45
- // Page Initializer
46
- // =============================================================================
47
- // Enable the Liquid Preprocessor
48
- :page-liquid:
49
-
50
- // Set (local) page attributes here
51
- // -----------------------------------------------------------------------------
52
- // :page--attr: <attr-value>
53
-
54
- // Load Liquid procedures
55
- // -----------------------------------------------------------------------------
56
- {% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
57
-
58
- // Load page attributes
59
- // -----------------------------------------------------------------------------
60
- {% include {{load_attributes}} scope="all" %}
61
-
62
-
63
- // Page content
64
- // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
65
-
66
- The Asciidoc *Skeleton book* a helper for setting up a base file and folder
67
- structure for complex *multi-chapter* AsciiDoc projects of type *book*
68
- based on _Jekyll_ and _J1 Template_. You need *both* to use this skeleton
69
- creating AsciiDoc documents from it.
70
-
71
- A document of type book typically consists in a large number of chapters and
72
- sections. To make this manageable, book-type documents are splitted in multiple
73
- files placed in a nested folder structure. Complex AsciiDoc projects of type
74
- *book* can be easily worked on by multiple authors.
75
-
76
- [NOTE]
77
- ====
78
- .Converting the Skeleton
79
-
80
- The Asciidoc Skeleton *book* is fully *relocateable* and can be placed in
81
- any subfolder of your Jekyll site for *HTML* output. For *PDF* output, a
82
- single variable `BASE_PATH` has to be set for your environment.
83
-
84
- See the *batch* files `a2p.bat` for _Windows_ (`cmd.exe`) or `a2p.sh` used
85
- on _Unix_ or _Linux_ OS for the shell (bash).
86
- ====
87
-
88
- The skeleton can be used to create HTML output (backend *html5*) for websites
89
- and *PDF* output (backend *pdf*) for offline reading as well. _J1 Template_
90
- comes with the full support of _Asciidoctor PDF_, a Ruby-based add-on for
91
- _Asciidoctor_ using the Ruby PDF writer _Prawn_.
92
-
93
- Prawn is a pure Ruby PDF generation library that provides a lot of great
94
- functionality while trying to remain simple and reasonably performant.
95
-
96
- Some of the important features of the *PDF* writer _Prawn_ are:
97
-
98
- * Vector drawing support, including lines, polygons, curves,
99
- ellipses, etc.
100
- * Extensive text rendering support, including flowing text
101
- nd limited inline formatting options.
102
- * Support for both PDF builtin fonts as well as embedded TrueType
103
- fonts
104
- * A variety of low level tools for basic layout needs, including a
105
- simple grid system
106
- * PNG and JPG image embedding, with flexible scaling options
107
- * Security features including encryption and password protection
108
- * Tools for rendering repeatable content (i.e headers, footers, and
109
- page numbers)
110
- * Comprehensive internationalization features, including full support
111
- for UTF-8 based fonts, right-to-left text rendering, fallback font support,
112
- and extension points for customizable text wrapping.
113
- * Support for PDF outlines for document navigation
114
-
115
- [role="mb-5"]
116
- *Happy Jekylling!*
117
-
118
-
119
- // Include Intro
120
- // -----------------------------------------------------------------------------
121
-
122
- include::{documentdir}/000_intro.asciidoc[]
123
-
124
-
125
- // Include Sublevel Entry Documents
126
- // -----------------------------------------------------------------------------
127
-
128
- include::{documentdir}/100_chapter.asciidoc[]
129
-
130
- include::{documentdir}/200_chapter.asciidoc[]
131
-
132
-
133
- // Include References
134
- // -----------------------------------------------------------------------------
135
-
136
- include::{documentdir}/900_references.asciidoc[]