Differences

This shows you the differences between two versions of the page.

--- kb:common:asciidoctor [2023/03/28 12:45] – alexander.elbert
+++ kb:common:asciidoctor [2025/03/12 12:55] (current) – [Asciidoctor] alexander.elbert
@@ Line 1: / Line 1: @@
 ====== Asciidoctor ======
-====== Manual Installation ======
+===== Manual Installation =====
-=== Ruby ===
+==== Ruby ====
+On Windows:
   * https://rubyinstaller.org/downloads/
-    * as of 2023-03-28: ''rubyinstaller-3.2.1-1-x64'' (without devkit)
+    * as of 2025-03-12: ''rubyinstaller-3.4.2-1-x64'' (without devkit)
+    * **install for local user only**
     * install MSYS2 base installation
-    * reboot computer!
+    * **reboot computer!**
+On RHEL:
-=== Asciidoctor ===
+Disable default Ruby AppStream module on your system
+    $ sudo dnf module reset ruby -y
+To specify the module version, use the command:
+    $ sudo yum install @ruby:3.1
+==== Asciidoctor ====
 //Asciidoctor is a Ruby tool and is therefore installed via Ruby's packet manager ''gem''//
@@ Line 18: / Line 26: @@
   * https://asciidoctor.org/docs/asciidoctor-diagram/
   * https://asciidoctor.org/docs/asciidoctor-pdf/
+In the windows menu look for ''Start Command Prompt with Ruby'' and execute the following commands:
      $ gem install asciidoctor
-     $ gem install asciidoctor-diagram
+     $ gem install asciidoctor-diagram                     OR:       gem install asciidoctor-kroki
      $ gem install asciidoctor-pdf
+<WRAP left round download 100%>
+For RAT: Generation of the diagrams will either take place via the ruby gem asciidoctor-diagram or asciidoctor-kroki. This can be configured via [[code:commercial:rat:tools:documentr#configuration|a documentr variable]].
+asciidoctor-diagram requires java and graphviz and asciidoctor-kroki requires communication to a kroki server.
+</WRAP>
 == Offline Installation of gems ==
 If no direct network connection is available, you can use [[https://bundler.io|Bundler.io]] to export packages and their dependencies from an online PC.
-. [[https://rubygems.org/gems/bundler|Download bundler from rubygems]] (latest version at the moment is v2.1.4) and install it locally via
+. [[https://rubygems.org/gems/bundler|Download bundler from rubygems]] (latest version at the moment is v2.5.7) and install it locally via
-    $ gem install --force --local bundler-2.1.4.gem
+    $ gem install --force --local bundler-2.5.7.gem
-. Download our ready-made [[https://download.hampel-soft.com/_install/RAT-Ruby-Gems_20200409.zip|Bundler package for local (offline) installation]] containing all necessary gems. Extract the archive to a local directory.
+. Download our ready-made [[https://download.hampel-soft.com/ProjectSend/download.php?id=140&token=7jHDJKiK7dpRNKqBZyudhk6rrZM3681o|Bundler package for local (offline) installation]] containing all necessary gems. Extract the archive to a local directory.
 . Run the following command from the above directory where the ''Gemfile'', ''Gemfile.lock'' and the ''/vendor/cache/'' subdirectory are available: