j1-template 2023.2.7 → 2023.3.1

data/lib/starter_web/pages/public/learn/roundtrip/icon_fonts.adoc

@@ -103,7 +103,7 @@ repository and MD style specification.
 |1x
 |no modifier set
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 No modifiers +
@@ -116,7 +116,7 @@ mdi:account[1x]
 |3x
 |no modifier set
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 No modifiers +
@@ -129,7 +129,7 @@ mdi:account[3x]
 |5x
 |no modifier set
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 No modifiers +
@@ -142,7 +142,7 @@ mdi:account[5x]
 |5x
 |`mdi-rotate-45`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Rotate 45 degrees +
@@ -155,7 +155,7 @@ mdi:account[5x mdi-rotate-45]
 |5x
 |`mdi-rotate-315`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Rotate 315 degrees +
@@ -169,7 +169,7 @@ mdi:account[5x mdi-rotate-315]
 |`mdi-light` +
 `mdi-flip-v`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Color set to (md) light-grey and flipped vertical +
@@ -182,7 +182,7 @@ mdi:alert[5x mdi-light mdi-flip-v]
 |5x
 |`md-indigo`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Color set to (md) indigo +
@@ -195,7 +195,7 @@ mdi:alert[5x md-indigo]
 |5x
 |`md-pink`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Color set to (md) pink +
@@ -208,7 +208,7 @@ mdi:alert[5x md-pink]
 |5x
 |`mdi-spin`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Added animation of type rotate (spin) +
@@ -222,7 +222,7 @@ mdi:loading[5x mdi-spin]
 |`md-red-900` +
 `mdi-pulsed`
 |All icons can be found for preview at the
-link:{url-material-design-icons--cheatsheet}[MDI Icons, {browser-window--new}]
+link:{url-font-icons--icon-picker}[Font Icon Picker, {browser-window--new}]
 page online. +
 
 Color  set to (md) color dark-red and added animation of type pulsed +

data/lib/starter_web/pages/public/learn/roundtrip/present_images.adoc

@@ -60,8 +60,8 @@ resource_options:
 :url-j1-docs--lightbox-module:          https://jekyll.one/pages/public/manuals/modules/lightbox/
 :url-j1-docs--masterslider-module:      https://jekyll.one/pages/public/manuals/modules/masterslider/
 
-:url-j1-masterslider-previewer:         https://jekyll.one/pages/public/previewer/masterslider/
-:url-j1-slick-previewer:                https://jekyll.one/pages/public/previewer/slick/
+:url-j1-masterslider-previewer:         https://jekyll.one/pages/public/tools/previewer/masterslider/
+:url-j1-slick-previewer:                https://jekyll.one/pages/public/tools/previewer/slick/
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -246,7 +246,7 @@ lazy loading, or autoplay. Slick carousels are compatible with all modern
 browsers and devices, making it a great choice to create a responsive and
 mobile-friendly website.
 
-=== Slick Image Carousel
+=== Image Carousel
 
 [role="mb-4"]
 An _Slick_ image carousel typically consists of a container with images and
@@ -258,7 +258,7 @@ between images, to make the presentation more engaging and visually appealing.
 .Carousel + Arrows + Dots + Captions + Lightbox
 slick::image_carousel_full[role="mb-5"]
 
-=== Slick Carousel from Collections
+=== Carousel from Collections
 
 [role="mb-4"]
 A carousel from a collection for J1 Template is a *pre-defined* carousel
@@ -272,6 +272,29 @@ like *Arrows* and *Dots*.
 .Collection Biography + Arrows + Dots + Gutters
 slick::collection_carousel_biography[role="mb-5"]
 
+=== Carousel from Posts
+
+A Carousel from posts for J1 Template is a *pre-defined* carousel type to
+display post articles on a webpage. It is a popular way to showcase a
+selection of post articles visually appealingly and can be useful for
+highlighting important or *featured* content for your posts content.
+
+[role="mb-4"]
+Post carousels pull news articles from a specific *group*. All Carousels for
+posts display the post category, the title, the author information and
+date. All Slick carousels for the J1 Theme can be easily customized in
+various ways, such as changing the number of posts displayed, the slider
+speed, or the navigation options like *Arrows* and *Dots*.
+
+.Asciidoc configuration
+[source, config, role="noclip mb-3"]
+----
+slick::post_carousel_featured[]
+----
+
+.Post Carousel (Featured Posts)
+slick::post_carousel_featured[role="mb-4"]
+
 === More about Slick Carousels
 
 [role="mb-4"]
@@ -279,6 +302,7 @@ If you're interested to learn more about _Slick_, go previewer page
 link:{url-j1-slick-previewer}[Slick Previewer, {browser-window--new}],
 
 
+[#masterSlider]
 == J1 Master Slider
 
 The Javascript tool _Master Slider_ is a 3rd party plugin fully integrated
@@ -293,6 +317,7 @@ all features: the functionality of  *filters*, *layouts* are limited and no
 // platforms, like mobiles or tablets, initializing an MS Slider will take
 // a while to be finished.
 
+[#carouselSlider]
 === Carousels versus Sliders
 
 Sliders and Carousels are focussing quite the same thing: presenting image data
@@ -311,6 +336,7 @@ TIP: For more details of the dimplementation of Master Slider of J1 Theme, see
 find  documentation at
 link:{url-j1-docs--masterslider-module}[Master Slider module, {browser-window--new}].
 
+[#controlsFiltersLightbox]
 === MS Slider using Controls + Filters + Lightbox
 
 The following slider uses the (CSS) filter feature of Master Slider.
@@ -328,6 +354,7 @@ slides to see the *colored* images configured for the slider.
 .Slider using Controls
 masterslider::ms_00001[role="mb-5"]
 
+[#textElements]
 === MS Slider using Text Elements (MSInfo)
 
 One of the major features of sliders is to present additional (animated)
@@ -338,6 +365,7 @@ elements: the MSInfo element.
 .Slider using Text Elements
 masterslider::ms_00003[role="mb-5"]
 
+[#thumbImages]
 === MS Slider using ThumbImages
 
 To give the users better control over a slideshow, sliders provide complex UI
@@ -348,6 +376,7 @@ the bottom of a slideshow. Find two examples to control a slideshow by
 .Slider using ThumbImages
 masterslider::ms_00004[role="mb-5"]
 
+[#thumbInfo]
 === MS Slider using ThumbInfo
 
 To give the users better control over a slideshow, MS Slider provides
@@ -357,6 +386,7 @@ top, or at the bottom of a slideshow.
 .Slider using ThumbInfo
 masterslider::ms_00007[role="mb-5"]
 
+[#partialview]
 === MS Slider using Layout partialview
 
 The following slider presents a slideshow that combines an MSInfo element
@@ -367,6 +397,7 @@ slide by their neighbors on the left and the right.
 .Slider using Layout partialview
 masterslider::ms_00009[role="mb-5"]
 
+[#aboutMasterSlider]
 === More about Master Slider
 
 If you're interested to learn more about MS Slider, go for the following

data/lib/starter_web/pages/public/learn/roundtrip/responsive_tables.adoc

@@ -76,18 +76,18 @@ needs for tables viewed on desktop and mobile devices, two types of
 .Types of responsive tables
 [cols="3a,3a,6a", options="header", width="100%", role="rtable mt-4"]
 |===
-|Type |Style |Description
+|Style |Type |Description
 
-|R Table (J1)
 |`rtable`
+|*R Table (J1)*
 |J Table are used by J1 Theme for default. Those tables are using the
 *responsive text* feature (see link:{url-roundtrip--typography}[Typography])
 with no additional CSS classes to be applied. For smaller viewports, the text
 scales down and should fit the cells automatically. The default text size for
 J1 is `r-text-300`.
 
-|B Table (Bootstrap)
 |`table-responsive`
+|*B Table (Bootstrap)*
 |If adding the class `table-responsive`, it creates a responsive table based
 on Bootstrap CSS styles. The table will then scroll horizontally on small
 devices. Making any table responsive across all viewports, the additional

data/lib/starter_web/pages/public/learn/where_to_go.adoc

@@ -15,7 +15,7 @@ categories:                             [ Info ]
 tags:                                   [ Introduction ]
 
 image:
-  path:                                 /assets/images/modules/attics/1920x1280/alexander-redl.jpg
+  path:                                 /assets/images/modules/attics/1920x1280/brigitta-schneiter.jpg
   width:                                1920
   height:                               1280
   alt:                                  Photo by Alexander Redl on Unsplash
@@ -28,12 +28,12 @@ resources:                              [ animate, comments ]
 resource_options:
   - attic:
       slides:
-        - url:                          /assets/images/modules/attics/1920x1280/alexander-redl.jpg
-          alt:                          Photo by Alexander Redl on Unsplash
+        - url:                          /assets/images/modules/attics/1920x1280/brigitta-schneiter.jpg
+          alt:                          Photo by Brigitta Schneiter on Unsplash
           badge:
             type:                       unsplash
-            author:                     Alexander Redl
-            href:                       https://unsplash.com/@alexanderredl
+            author:                     Brigitta Schneiter
+            href:                       https://unsplash.com/de/@brisch27
 ---
 
 // Page Initializer
@@ -44,7 +44,10 @@ resource_options:
 // Set (local) page attributes here
 // -----------------------------------------------------------------------------
 // :page--attr:                         <attr-value>
-:url-j1-jupyter-notebooks--where-to-go: /pages/public/jupyter/where-to-go/
+:url-j1--jekyll-collections:            /pages/public/learn/bookshelf/jekyll_collections/
+:url-j1--cheatsheet-template:           https://jekyll.one/pages/public/tools/cheatsheet/j1/
+:url-j1--tutorial-j1-in-a-day:          https://jekyll.one/pages/public/learn/kickstart/web_in_a_day/meet_and_greet/
+:url-j1--tutorial-learning-seo:         https://jekyll.one/pages/public/learn/kickstart/learning_seo/what_seo_is/
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -57,15 +60,16 @@ resource_options:
 // Page content
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [role="dropcap"]
-Welcome to the info pages of J1 Theme. A good decision to get on that page
-first. Certainly, there is no better place to learn what J1 Theme can do
-and what pages are available to experience more.
+Welcome to the learning pages of JekyllOne, the J1 Theme. A good decision to
+get on that page first. Certainly, there is no better place to start learning
+what the J1 Theme can do and what pages are available to experience more.
 
 // Include sub-documents (if any) (if any)
 // -----------------------------------------------------------------------------
 The crucial first step in finding your way to Jekyll is done. Congratulations.
-The *Learn* section contains all you need to learn what Jekyll and J1 can do
-for your website, for your new static web - if you like.
+The *Learn* section contains all you need to expirience what Jekyll and J1
+can do for your new website, for your new static web. You are welcome to spend
+some time diving into the techniques of creating modern static webs.
 
 Roundtrip::
 In this section, you’ll find a tour to show some of the main features of
@@ -79,41 +83,29 @@ If you're interested what J1 Theme can do, continue by walking through the
 roundtrip examples by starting an inspiring tour
 link:{url-j1-roundtrip--present-images}[from here].
 
-Rocketstart::
-J1 Theme is fully JAM-Stack ready. If you're interested in creating and
-deploying an amazing J1 based site on the Internet in minutes without
-installing any software locally on your PC, go for Netlify's One-Click-Deploy.
-Rocketstart took about fifteen minutes and guides you through this easy
-3-step-process. Fire your rocket now at
-link:{url-j1--rocketstart}[Rocketstart, {browser-window--new}].
-
-Site Development::
-The tutorial link:{url-j1--devstart}[Site Development, {browser-window--new}]
-accompanies you to learn how to set up a development environment for Jekyll
-and J1 Theme to manage and create your first website locally on your PC in
-minutes. J1 Theme comes with a built-in Web, a skeleton for a new website created
-using Jekyll. This website is called the `Starter Web`, a general-purpose
-scaffold for modifying a new site for your needs.
-
-J1 in a Day::
-The workshop `J1 in a Day` is a tutorial learning to create modern websites
-using _Jekyll_ and the J1 Theme. This Tutorial focuses on the basics of
-_Jekyll_ and J1, which all people need to know for a successful way to a
-modern static website. Jekyll (and JekyllOne) is quite different from classic
-Content Management Systems (CMS).
-
-If you would like to learn more about the use of Jekyll and J1 Theme, the
-tutorials present what you need to know:
-
-* The basics of modern static webs
-* Creating an awesome Site
-* Development System
-* Project Management
-* Create Content
-
-It sounds much, spending a whole day to get Jekyll and J1 to know. Yes, it is
-much. But it makes sense to get a full overview of what can be achieved by
-modern static websites.
-
-To experience what's possible today using modern websites static webs, go for
-link:{url-j1-web-in-a-day--meet-and-greet}[J1 in a Day, {browser-window--new}].
+Cheatsheet::
+Cheat sheets are concise reference guides or summaries that provide quick
+and handy information about a topic or subject. They help you to remember
+key concepts, formulas, commands, or other essential details without
+consulting extensive documentation or resources. Find convenient quick
+references for _YAML_, _Git_ and more. For example using the `j1` command
+to manage a project for J1 Template, go for the cheatsheet
+link:{url-j1--cheatsheet-template}[J1 Template, {browser-window--new}].
+
+Collections::
+Collections are Jekyll’s most powerful and simultaneously least understood
+feature of the generator. Collections add another possibility, or use-case,
+outside of Jekyll’s post- and page-publishing functionality. Learn more
+about collections for more powerful static websites. To learn more what
+collections are, check
+link:{url-j1--jekyll-collections}[Jekyll Collections, {browser-window--new}].
+
+Tutorials::
+To become more familiar with using J1, go to the tutorial section. Have
+fun experiencing what Jekyll and J1 can do. A good starting point for using
+J1 Template is
+link:{url-j1--tutorial-j1-in-a-day}[Jekll in a Day, {browser-window--new}].
+
+Optimizing a website for search engines (SEO) is important for success.
+Read more about SEO and how to implement working strategies for a Jekyll-based
+websites at link:{url-j1--tutorial-learning-seo}[Learning SEO, {browser-window--new}].

data/lib/starter_web/pages/public/legal/en/100_copyright.adoc

@@ -12,8 +12,8 @@ categories:                             [ Site ]
 tags:                                   [ Copyright ]
 
 robots:
-  index:                                false
-  follow:                               false
+  index:                                true
+  follow:                               true
 
 image:
   path:                                 /assets/images/modules/attics/1920x1280/j1-starter-mockup-1.jpg

data/lib/starter_web/pages/public/legal/en/300_privacy.adoc

@@ -11,8 +11,8 @@ categories:                             [ Site ]
 tags:                                   [ Privacy, Policy ]
 
 robots:
-  index:                                false
-  follow:                               false
+  index:                                true
+  follow:                               true
 
 image:
   path:                                 /assets/images/modules/attics/1920x1280/j1-starter-mockup-1.jpg

data/lib/starter_web/pages/public/legal/en/400_comment_policy.adoc

@@ -11,8 +11,8 @@ categories:                             [ Site ]
 tags:                                   [ Comments, Policy ]
 
 robots:
-  index:                                false
-  follow:                               false
+  index:                                true
+  follow:                               true
 
 image:
   path:                                 /assets/images/modules/attics/1920x1280/j1-starter-mockup-1.jpg

data/lib/starter_web/pages/public/tools/cheatsheet/gem.adoc

@@ -0,0 +1,255 @@
+---
+title:                                  Gem
+tagline:                                Cheatsheet for daily use
+date:                                   2023-05-19 00:00:00 +100
+description: >
+                                        The Cheatsheet discuss RubyGems commands for daily use.
+                                        RubyGems is a package manager for the Ruby programming language. It provides
+                                        a convenient way to distribute and manage software packages, called gems,
+                                        written in Ruby. With RubyGems, developers can easily install, uninstall, and
+                                        manage Ruby libraries and applications.
+keywords: >
+                                        Jekyll, Theme, JekyllOne, Info, Manual, Cheatsheet, Ruby, Gem
+
+categories:                             [ Manual ]
+tags:                                   [ Cheatsheet, Gem ]
+
+image:
+  path:                                 /assets/images/modules/attics/1920x1280/recha-oktaviani.jpg
+  width:                                1920
+  height:                               1280
+  alt:                                  Photo by Recha Oktaviani on Unsplash
+
+regenerate:                             false
+permalink:                              /pages/public/tools/cheatsheet/gem/
+
+resources:                              [ animate, clipboard, rouge ]
+resource_options:
+  - attic:
+      slides:
+        - url:                          /assets/images/modules/attics/1920x1280/recha-oktaviani.jpg
+          alt:                          Photo by Recha Oktaviani on Unsplash
+          badge:
+            type:                       unsplash
+            author:                     Recha Oktaviani
+            href:                       https://unsplash.com/de/@rechaoktaviani
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+
+//  Load Liquid procedures
+// -----------------------------------------------------------------------------
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="global" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+[role="dropcap"]
+The Cheatsheet discuss RubyGems commands for daily use.
+RubyGems is a package manager for the Ruby programming language. It provides
+a convenient way to distribute and manage software packages, called GEMs.
+With RubyGems, developers can easily install, uninstall, and manage Ruby
+libraries and applications. It simplifies obtaining and managing the
+dependencies needed for a Ruby project by automatically resolving and
+installing the GEMs required.
+
+NOTE: The term `gem` is related to the *tool* provided by RubyGems. `GEM`
+(capital letters) means the *library* to be managed by the command `gem`
+at the command line.
+
+RubyGems also provides a centralized *repository*, the RubyGems website
+at https://rubygems.org/[rubygems.org, {browser-window--new}], where developers
+can publish their *GEMs* for others to use. The website serves as a searchable
+catalog of available GEMs, allowing developers to discover and download GEMs
+for their projects.
+
+TIP: In addition to the default RubyGems repository, developers can
+configure their own GEM sources or specify alternative sources when
+installing GEMs. This flexibility allows private GEM repositories or
+custom sources to be used as needed.
+
+RubyGems comes pre-installed with a Ruby installation. It provides
+a command-line interface, the `gem` command, for performing various
+operations, such as installing GEMS, listing installed libraries,
+updating GEMs, and managing library sources.
+
+Here are *common* commands you can use with the RubyGems `gem` command:
+
+* *install*     -- Installs a GEM from the default RubyGems repository
+* *uninstall*   -- Uninstalls a GEM
+* *update*      -- Updates installed GEMs to their latest versions
+* *search*      -- Searches for GEMs matching a specific term
+* *list*        -- Lists all installed GEMs
+* *info*        -- Provides information about a specific GEM
+* *cleanup*     -- Removes old versions of installed GEMs, keeping only the latest version
+
+The following examples give your an overview of the most *common* used
+commands managing Ruby GEMs for daily use. All examples are focussing the *J1*
+template to make it easier for users using the template system. Anyway, all
+commands can be used for *any* Ruby Appication by simply replacing the *name*
+of the GEM as required.
+
+// Include sub-documents (if any)
+// -----------------------------------------------------------------------------
+[role="mt-5"]
+== Install commands
+
+The `install` command installs software packages (libraries) in the
+Ruby programming language. The command will then search for the
+GEM specified on the _RubyGems_ website (or a diifrerebt GEM
+repository configured), download it, and finally install it on your
+system.
+
+=== Install from a Gemfile
+
+Add this line to your application's Gemfile:
+
+[source, sh]
+----
+gem 'j1_template', '~> 2023.3.1'
+----
+
+and install the locally created RubGem as:
+
+[source, sh]
+----
+gem install --local j1-template --no-document
+----
+
+=== Install globally
+
+bla ... latest version ...
+
+[source, sh]
+----
+gem install j1-template
+----
+
+=== Install with no docs
+
+bla ... latest version ...
+
+[source, sh]
+----
+gem install j1-template --no-document
+----
+
+=== Install userized
+
+bla ... latest version ...
+
+When you use the `--user-install` option, RubyGems will install the GEMs
+to a directory inside your *home* directory under `~/.gem/ruby/3.1.0`
+for Ruby version `3.1.x`. The *commands* provided by the GEMs you have
+installed will end up in folder `~/.gem/ruby/3.1.0/bin`.
+
+[source, sh]
+----
+gem install j1-template --user-install --no-document
+----
+
+For GEMs installed *userized* that contain *programs*, you need to add
+the folder `~/.gem/ruby/3.1.0/bin` to your `PATH` environment variable
+to get access.
+
+=== Install a specific version
+
+bla ... specific version ...
+
+[source, sh]
+----
+gem install j1-template -v 2023.3.1 --user-install --no-document
+----
+
+You can also use *version* comparators like `>=` or `~>`.
+
+[source, sh]
+----
+gem install j1-template -v "~> 2023.3.1" --user-install --no-document
+----
+
+=== Install from a different source
+
+bla ... specific version ...
+
+[source, sh]
+----
+gem install j1-template -v 2023.3.1 --source 'https://gem.fury.io/jekyll-one-org/' --user-install --no-document
+----
+
+[role="mt-5"]
+== Uninstall commands
+
+bla
+
+
+[role="mt-5"]
+== Update commands
+
+bla
+
+
+[role="mt-5"]
+== Search commands
+
+bla
+
+
+[role="mt-5"]
+== List commands
+
+bla
+
+
+[role="mt-5"]
+== Info commands
+
+bla
+
+
+[role="mt-5"]
+== Cleanup commands
+
+bla
+
+[role="mt-5"]
+=== Clean up old GEM versions
+
+To clean up old versions on your `GEM_PATH` of installed gems use
+below command:
+
+[source, sh]
+----
+gem cleanup <GEMNAME …>
+----
+
+The cleanup command removes old versions of gems from GEM_HOME that are not
+required to meet a dependency. If a gem is installed elsewhere in GEM_PATH
+the cleanup command won’t delete it.
+
+If no gems are named all gems in GEM_HOME are cleaned.
+
+
+[role="mt-5"]
+== Update Rubygems
+
+[source, sh]
+----
+gem install rubygems-update
+update_rubygems
+gem update --system
+----