From cc8405df9ee9750553d4751890d38cc009179eb9 Mon Sep 17 00:00:00 2001
From: Romain Manni-Bucau <rmannibucau@gmail.com>
Date: Mon, 12 Feb 2024 20:46:12 +0100
Subject: [PATCH] Updating the website with version 1.2.1-SNAPSHOT //
 2024-02-12T20:46:12.861002115+01:00

---
 mojo/minisite.html                  |   4 +-
 mojo/yupiik-tools-maven-plugin.html |   4 +-
 search.json                         |   2 +-
 sitemap.xml                         |   4 +-
 yem.html                            | 165 ++++++++++++++++++++++++++--
 5 files changed, 164 insertions(+), 15 deletions(-)

diff --git a/mojo/minisite.html b/mojo/minisite.html
index b751737a..2b59e831 100644
--- a/mojo/minisite.html
+++ b/mojo/minisite.html
@@ -88,12 +88,12 @@ <h1>yupiik-tools:minisite</h1>
  <ul>
   <li>
  <p>
-src/main/doc/content: contains a set of .adoc (converted to .html) 
+src/main/doc/content: contains a set of .adoc (converted to .html)
  </p>
   </li>
   <li>
  <p>
-src/main/doc/assets: contains a set of files moved &quot;as this&quot; to site output directory (css, js) 
+src/main/doc/assets: contains a set of files moved &quot;as this&quot; to site output directory (css, js)
  </p>
   </li>
   <li>
diff --git a/mojo/yupiik-tools-maven-plugin.html b/mojo/yupiik-tools-maven-plugin.html
index 1d6acf99..327d9d2f 100644
--- a/mojo/yupiik-tools-maven-plugin.html
+++ b/mojo/yupiik-tools-maven-plugin.html
@@ -94,12 +94,12 @@ <h2>Goals</h2>
  <ul>
   <li>
  <p>
-src/main/doc/content: contains a set of .adoc (converted to .html)  
+src/main/doc/content: contains a set of .adoc (converted to .html)
  </p>
   </li>
   <li>
  <p>
-src/main/doc/assets: contains a set of files moved &quot;as this&quot; to site output directory (css, js)  
+src/main/doc/assets: contains a set of files moved &quot;as this&quot; to site output directory (css, js)
  </p>
   </li>
   <li>
diff --git a/search.json b/search.json
index ab531197..698afe64 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"lang":"en","text":"The module ascii2svg is a fork of the go https://github.com/asciitosvg/asciitosvg library rewritten in Java. It enables to convert a string graph in SVG.\nFor example:\nWill be rendered as:\nimage:data:image/svg+xml,%3C!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.1//EN' 'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'%3E%3Csvg width='306px' height='112px' version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Cdefs%3E%3Cfilter id='dsFilter' width='150%25' height='150%25'%3E%3CfeOffset result='offOut' in='SourceGraphic' dx='2' dy='2'/%3E%3CfeColorMatrix result='matrixOut' in='offOut' type='matrix' values='0.2 0 0 0 0 0 0.2 0 0 0 0 0 0.2 0 0 0 0 0 1 0'/%3E%3CfeGaussianBlur result='blurOut' in='matrixOut' stdDeviation='3'/%3E%3CfeBlend in='SourceGraphic' in2='blurOut' mode='normal'/%3E%3C/filter%3E%3Cmarker id='iPointer' viewBox='0 0 10 10' refX='5' refY='5' markerUnits='strokeWidth' markerWidth='8' markerHeight='15' orient='auto'%3E%3Cpath d='M 10 0 L 10 10 L 0 5 z' /%3E%3C/marker%3E%3Cmarker id='Pointer' viewBox='0 0 10 10' refX='5' refY='5' markerUnits='strokeWidth' markerWidth='8' markerHeight='15' orient='auto'%3E%3Cpath d='M 0 0 L 10 5 L 0 10 z' /%3E%3C/marker%3E%3C/defs%3E%3Cg id='closed' stroke='%23000' stroke-width='2' fill='none'%3E%3Cpath id='closed0' fill='%23aa4444' d='M 4.5 18.0 Q 4.5 8.0 14.5 8.0 L 13.5 8.0 L 22.5 8.0 L 31.5 8.0 L 40.5 8.0 L 49.5 8.0 L 58.5 8.0 L 67.5 8.0 L 76.5 8.0 L 85.5 8.0 L 94.5 8.0 L 103.5 8.0 L 112.5 8.0 L 121.5 8.0 L 120.5 8.0 Q 130.5 8.0 130.5 18.0 L 130.5 24.0 L 130.5 30.0 Q 130.5 40.0 120.5 40.0 L 121.5 40.0 L 112.5 40.0 L 103.5 40.0 L 94.5 40.0 L 85.5 40.0 L 76.5 40.0 L 67.5 40.0 L 58.5 40.0 L 49.5 40.0 L 40.5 40.0 L 31.5 40.0 L 22.5 40.0 L 13.5 40.0 L 14.5 40.0 Q 4.5 40.0 4.5 30.0 L 4.5 24.0 Z' /%3E%3Cpath id='closed1' fill='%23ccccff' d='M 157.5 18.0 Q 157.5 8.0 167.5 8.0 L 166.5 8.0 L 175.5 8.0 L 184.5 8.0 L 193.5 8.0 L 202.5 8.0 L 211.5 8.0 L 220.5 8.0 L 229.5 8.0 L 238.5 8.0 L 247.5 8.0 L 256.5 8.0 L 265.5 8.0 L 274.5 8.0 L 283.5 8.0 L 282.5 8.0 Q 292.5 8.0 292.5 18.0 L 292.5 24.0 L 292.5 30.0 Q 292.5 40.0 282.5 40.0 L 283.5 40.0 L 274.5 40.0 L 265.5 40.0 L 256.5 40.0 L 247.5 40.0 L 238.5 40.0 L 229.5 40.0 L 220.5 40.0 L 211.5 40.0 L 202.5 40.0 L 193.5 40.0 L 184.5 40.0 L 175.5 40.0 L 166.5 40.0 L 167.5 40.0 Q 157.5 40.0 157.5 30.0 L 157.5 24.0 Z' /%3E%3C/g%3E%3Cg id='lines' stroke='%23000' stroke-width='2' fill='none'%3E%3C/g%3E%3Cg id='text' stroke='none'\nMore on the syntax there: https://github.com/asciitosvg/asciitosvg.","title":"Ascii2SVG","url":"/tools-maven-plugin/ascii2svg.html"},{"lang":"en","text":"The module asciidoc-java implements a light Asciidoc syntax parser in plain Java. It aims at making it easier and lighter than using JRuby to embed Asciidoc in any Java based (native or not) application.\nIts usage is pretty simple:\nYou get a Parser instance to load the model of your document in memory (AST),\nYou visit the model as you want (or reusing provided Visitor<?>) to render the loaded Document.\nthe Document instance is thread safe and can safely be reused accross multiple threads. The parser is also thread save but the visitors must be created per rendering instance.\nHere is a basic example:\nthe asciidoc syntax is not 100% implemented yet, if you encounter anything you miss, feel free to open an issue or pull request on our bugtracker.","title":"Asciidoc Java","url":"/tools-maven-plugin/asciidoc-java.html"},{"lang":"en","text":"Most Maven goals are available as CLI commands using yupiik-tools-cli.\nIt is a plain Java application but you can also download the fatjar jar which is executable: java -cp yupiik-tools-cli-$version-fatjar.jar <args>.","title":"CLI","url":"/tools-maven-plugin/cli.html"},{"lang":"en","lvl2":"Chain plugins\nPDF and latex formula\nPom-less PDF rendering\nMinisite\nBash CLI skeleton\nMaven Asciidoctor Macro\nSimple Dependencies\nYupiik OSS extension\nInline pom contributor extension\nCrypt mojos","lvl3":"Confluence Limitations\nBlog\nPre-Action\nExample\nPage attributes\nIndex generation\nEscaping\nSynchronize Releases Example\nUsage\nmaven_dependencies\nValue based mojo\nProperties based mojo","text":"To learn all goals available in the maven plugin read Yupiik Tools Maven Plugin dedicated page.\nMojo can be chained from the command like - without pom declaration.\nThis is the case of the git report one and PDF one for example:\nYou can enable latex formula support in PDF adding the related dependency:\nThen usage is as follow:\nYou can render an asciidoctor file without a pom nor pom declaration:\nminisite can push the minisite to a remote target (often git backed pages).\nas all plugins it requires Java 11 but if you want to use it with Java 8 you can use minisite-core module with exec-maven-plugin since version 1.1.1.\nHere is the related documentation.\nThe configuration supports a git entry if you want to upload to a Git branch the generated website (like gh-pages):\nThe configuration also supports an experimental Atlassian Confluence export support. It only works using the default template and require a configuration similar to git or ftp exports:\nthe nested support of this exporter is very experimental, and we recommend you to keep only one level of .adoc files using it.\nAssets are not uploaded so ensure to configure Asciidoctor to embed all assets in HTML,\nIt only works with the default theme since we extract metadata from there to enable to update the space,\nTo look nice, you can need to tune the Confluence space CSS to import admonitions, codeblocks, ... styling (can require some admin permissions).\nBlog is supported if pages contain at least one block metadata. Here is the list of available attributes you can use:\n:minisite-blog-published-date: yyyy-MM-dd: when the page will be rendered (if not set it is always rendered).\n:minisite-blog-categories: c1,c2: comma separated list of categories of this post\n:minisite-blog-authors: My, Myself: comma separated list of author names\n:minisite-blog-summary: Some short description.: the summary of this post used on post list pages.\nBlog page example:\nPre actions enables to generate some content from the project. It is typically used to generate configuration from code or things like that. It uses the documentation module classpath. Actions must implement Runnable and can have some (public) constructor parameters (we use parameter names to match so ensure to enable -parameters in maven compiler plugin):\nconfiguration (Map<String, String>): the action configuration, it enables to reuse it if needed or write generic actions\nsourceBase (Path): the base directory you can generate .adoc into (generally where you sources are, tip: use generated folder to be able to exclude it in .gitignore if desired)\noutputBase (Path): the base directory you can generate direct html assets\nUsing type=maven-plugin (recommended) or type=io.yupiik.maven.service.action.builtin.MojoDocumentationGeneration you can get a plugin.xml file parsed to generate:\nOne file per goal with some usage, the goal description and parameters (named <goal>.adoc)\nOne file listing all goals (named <goal-prefix>-maven-plugin.adoc)\nThe configuration of this action is:\npluginXml: file path or resource to find the plugin.xml file.\ntoBase: where to generate the adoc.\ndescription: a global plugin description for the \"listing\" page (default is empty and page will just list goals).\nUsing type=copy (recommended) or type=io.yupiik.maven.service.action.builtin.CopyFile will copy a file from a source to a destination: It is typically useful for assets (openapi.json for example).\nfrom: source file.\nto: destination.\nUsing type=jsonschema (recommended) or type=io.yupiik.maven.service.action.builtin.JsonSchemaGenerator will generate a JSON-Schema from a class:\nclass: the class to generate the schema from.\nto: destination of the schema.\ntype: JSON for a raw JSON-Schema (default) or ADOC for a textual, asciidoctor output.\nsetClassAsTitle: true to force object title to be the class name.\nuseReflectionForDefaults: true to force reflection to try to extract defaults of attributes.\npretty when type=JSON, should the JSON be prettified or not (default=true).\nlevelPrefix when type=ADOC, a title prefix (== for example), = by default.\ntitle and description enable to set class title/description for its json schema. It is required for type=ADOC.\nannotationOnlyProvidesTheDescription enable to never take the title from an annotation (@Description(value) case).\nthe model classes can use a custom @Description(title,description) annotation (note that @Doc is also supported and value method can be used instead of description). See JsonDocExtractor for more details.\nUsing type=jsonschema2adoc (recommended) or type=io.yupiik.maven.service.action.builtin.JsonSchema2AdocGenerator will generate an asciidoctor document from a JSON-Schema file (intended to be used with fusion mainly):\nschema: location of the schema (JSON).\nroot: key under schemas map of the root schema to generate a doc for.\nlevelPrefix: prefix to set for title (default =).\noutput: where to generate the .adoc.\nUsing type=openmetrics2adoc (recommended) or type=io.yupiik.tools.minisite.action.builtin.OpenMetricsToAsciidoc will generate an asciidoctor form from an OpenMetrics export.\nsource: path of the openmetrics dump.\nto: destination of the asciidoc generated from source.\nlevelPrefix: a prefix set before the part title (== by default for a second level title).\nlegend: should tables have a legend (name of the metric), default to true.\nheader: prefix the whole rendering (enables to set a title and some options if needed).\nUsing type=simple-configuration (recommended) or type=io.yupiik.tools.minisite.action.builtin.SimpleConfigurationGenerator will generate an asciidoctor from a configuration class passed in class <configuration> option.\nclass: root configuration fully qualified name.\noutput: where to generate the .adoc to.\nUsing type=download-unzip (recommended) or type=io.yupiik.tools.minisite.action.builtin.DownloadAndUnzip enables to download a zip from a HTTP url then extract it totally or partially to a particular folder. This can be used to download a git repository using Github/Gitlab/Gitea API for example.\nurl: the zip URL.\nsubpath: the subpath to copy in target. It filters the zip entries names by prefix.\nheaders: in properties format, a set of headers to set.\ntarget: where to copy the selected files.\nworkdir: temporary folder (to download the zip), temporary if not set.\nUsing type=replace-in-file (recommended) or type=io.yupiik.tools.minisite.action.builtin.ReplaceInFile will rewrite a text file replacing a string by another one.\nsource: file to rewrite.\ntoken: text to replace.\nreplacement: text replacing token.\nusing regex{xxx} as token will use a java regex to do the replacement.\nSome specific attributes enables to customize the generation. Here is their list:\nminisite-skip=[true|false] enables to skip a .adoc rendering even if not in _partials directory.\nminisite-path=<string> enables to force the relative path of the file, for example a file name foo-bar.adoc with the attribute minisite-path set to foo/bar.html will output a foo/bar.html file instead of foo-bar.html. Note however it does not rewrite the links to ensure to use link:.....html[] instead of ref to link this page then.\nminisite-highlightjs-skip enables to not setup highlight.js for the page (useful with swagger-ui for example).\nTo include a page in the index it must contain minisite-index attribute. Its value is the order of the entry in the index tiles.\nensure to not use 1, 2, 3, ... but rather 100, 200, ... to easily insert an item later.\nminisite-index-title attribute enables to override link text.\nminisite-index-icon attribute enables to override font awesome icon (without fa- prefix).\nminisite-index-description attribute enables to override the text in the index tile for the page entry.\nWhen you write some documentation in a language close to the minisite interpolation one (mustache for ex), it can be hard to use. To ease that, you can surround your snippet with and , included text will not support interpolations.\nThen run mvn yupiik-tools:synchronize-github-releases.\nscript-cli-skeleton enables to generates a skeleton layout to write a CLI in bash (helper commands for your project).\ncan be used on a pomless project: mvn io.yupiik.maven:yupiik-tools-maven-plugin:<version>:script-cli-skeleton -Dyupiik.script-cli-skeleton.directory=/path/to/script-project (version >= 1.0.26).\nTo add a command:\nCreate an index.sh containing the command script in commands folder\n(optional) create a commands/<your command name>/_cli/help.txt file containing the help description.\nThe project adds asciidoc macros to get back some maven build information. Note that it must be executed in the right lifecycle phase if using some project metadata (plugin does not require any resolution to be usable standalone).\nEnables to list the project dependencies.\nScope can be:\n- compile - runtime - compile+runtime - runtime+system - test - provided_only - compile_only - test_only - system_only - runtime_only\nThe optional attribute groupId is also supported and take a list (comma separated) of groupId to include.\nsimple-dependencies is a trivial and simple alternative to maven-dependency-plugin:list mojo which outputs the data in JSON.\nIt is convenient with minisite mojo to format with a custom action the dependencies according to a custom need.\nThis extension sets up the equivalent of a parent pom but enables to inherit or not from another parent and to benefit from upgrades for free.\nIt is configured in the root project through maven properties:\nJust enabling this extension will upgrade a few plugin, enforce the encoding and java version, enforce license check and much more.\nSee io.yupiik.maven.extension.YupiikOSSExtension.afterProjectsRead for details.\nIt enables to put in each module a YupiikContributor.java file which will be compiled and executed in afterProjectRead(MavenSession) callback.\nExample:\nThis enables to programmatically handle the pom (mainly intended for plugins since dependencies are not synchronized in maven poms when contributed this way).\nTo enable it, enable the related extension:\nsee io.yupiik.maven.extension.YupiikOSSExtension for a more complex participant example.\nCrypt mojos are intended to encrypt/decrypt (using AES/CBC/PKCS5Padding algorithm - like maven default encryption ) values. It supports either inline values or properties files.\nit is a neat way to handle secrets in a bundlebee placeholder properties file on CI/CD if you don't have a vault or equivalent mecanism for GitOps.\nyupiik-tools:crypt-value will enable to encrypt a value (symmetrically, decrypt-value will decrypt a value).\nConfiguration is:\nvalue: the value to crypt (decrypt),\nuseStdout: should the value be printed using Maven logger or simply stdout,\nmasterPassword: the master password for the ciphering.\ninput: path to the properties file to crypt (decrypt) values for (keys are never encrypted),\noutput: path to the properties file which will contain encrypted (decrypted) data,\nmasterPassword: the master password for the ciphering,\nincludedKeys: a list of values (direct key), start:<some prefix> prefixes or regex:<pattern> regex to filter the values to encrypt (decrypt) based on their keys,\nexcludedKeys: a list of values (direct key), start:<some prefix> prefixes or regex:<pattern> regex to filter the values to NOT encrypt (decrypt) based on their keys.\noutput always sorts the keys and will ignore comments. An already encoded value will not be re-encoded. This last point enables to set input=output to encrypt in place a file.","title":"Maven","url":"/tools-maven-plugin/mojos.html"},{"lang":"en","lvl2":"Inspiration\nConfiguration\nCLI\nAuto-path\nAlias support\nTIP\nShell/Bash setup","lvl3":"Commands","text":"Setting up dev environment can be a nightmare.yem intends to make it easier.\nyem is inspired from SDKMan, Chocolatey and other alternatives. The main differences are:\nyem does not come with a remote storage but it tries to reuse existing ones - priviledging immutable one when possible (compared to SDKMan where you can loose the version you picked),\nyem intends to be portable (linux/windows at least),\nyem is extensible if needed (new source or tool/distribution).\nthe atomic configuration is listed there but used on the command line you must ensure to prefix any option by - and replace dots by -. Example: central.base becomes --central-base.\ncentral.base (central_base) (default: \"https://repo.maven.apache.org/maven2/\"): Base repository URL..\ncentral.gavs (central_gavs) (default: \"org.apache.maven:apache-maven:tar.gz:bin\"): List of GAV to register (comma separated). Such a provider can be enabled/disabled using artifactId.enabled property..\ncentral.header (central_header): Headers to add if the repository is authenticated. Syntax uses HTTP one: --central-header 'Authorization: Basic xxxxx' for example.\ncentral.local (central_local) (default: System.getProperty(\"user.home\", \"\") + \"/.m2/repository\"): Local repository path..\ndelete.provider (delete_provider): Provider to use to delete the version (if not t is deduced from the tool/version parameters)..\ndelete.tool (delete_tool)*: Tool to delete..\ndelete.version (delete_version)*: Version of tool to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance..\nenv.defaultRc (env_defaultRc) (default: System.getProperty(\"user.home\") + \"/.yupiik/yem/rc\"): Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc..\nenv.enableAutoDetection (env_enableAutoDetection) (default: false): EXPERIMENTAL. If enabled and no .yemrc nor .sdkmanrc setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a pom.xml and the compiler version can be extracted for example) and Maven (pom.xml presence). Note that it is done using ./ folder and bubbles up with a max of 10 levels..\nenv.inlineRc (env_inlineRc): Enables to set inline a rc file, ex: eval $(yem env --inlineRc 'java.version=17.0.9'), you can use EOL too: eval $(yem env --inlineRc 'java.version=17.\\njava.relaxed = true'). Note that to persist the change even if you automatically switch from the global yemrc file the context, we set YEM_$TOOLPATHVARNAME_OVERRIDEN environment variable. To reset the value to the global configuration just unset this variable (ex: unset YEM_JAVA_PATH_OVERRIDEN). Note that you can also just set the values inline as args without that option: eval $(yem env --java-version 17. --java-relaxed true ...)..\nenv.rc (env_rc) (default: \"auto\"): Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present..\nenv.skipReset (env_skipReset) (default: false): By default if YEM_ORIGINAL_PATH exists in the environment variables it is used as PATH base to not keep appending path to the PATH indefinively. This can be disabled setting this property to false.\ngithub.base (github_base) (default: \"https://api.github.com\"): Base repository URL..\ngithub.header (github_header): Header to add to every request (authorization one for example)..\ngithub.local (github_local) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/github\"): Local repository path..\nhttp.address (http_address) (default: \"localhost\"): Binding address..\nhttp.cacheValidity (http_cacheValidity) (default: 86_400_000L): Cache validity of requests (1 day by default) in milliseconds. A negative or zero value will disable cache..\nhttp.cache (http_cache) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/cache/http\"): Where to cache slow updates (version fetching). none will disable cache..\nhttp.connectTimeout (http_connectTimeout) (default: 60_000L): Connection timeout in milliseconds..\nhttp.ignoreSSLErrors (http_ignoreSSLErrors) (default: false): Should SSL errors be ignored..\nhttp.log (http_log) (default: false): Should HTTP calls be logged..\nhttp.offlineMode (http_offlineMode) (default: false): Force offline mode..\nhttp.offlineTimeout (http_offlineTimeout) (default: 10_000): Check offline timeout. Per uri a test is done to verify the system is offline..\nhttp.open (http_open) (default: true): Should the server be opened ASAP if possible on your system or just the server be launched..\nhttp.port (http_port) (default: 0): Port to open the server to, by default it is random..\nhttp.proxy.host (http_proxy_host) (default: \"none\"): Proxy host. none means ignore..\nhttp.proxy.ignoredHosts (http_proxy_ignoredHosts) (default: java.util.List.of()): Hosts to connect directly to (ignoring the proxy)..\nhttp.proxy.password (http_proxy_password) (default: \"none\"): Proxy password. none means ignore..\nhttp.proxy.port (http_proxy_port) (default: 3128): Proxy port..\nhttp.proxy.username (http_proxy_username) (default: \"none\"): Proxy username. none means ignore..\nhttp.requestTimeout (http_requestTimeout) (default: 900_000L): Request timeout in milliseconds..\nhttp.threads (http_threads) (default: 4): Number of NIO threads..\ninstall.provider (install_provider): Provider to use to install the version (if not t is deduced from the tool/version parameters)..\ninstall.relaxed (install_relaxed) (default: false): Should version be matched with a startsWith logic (ex: install --install-tool java --install-relaxed true --install-version 21.)..\ninstall.skipProgress (install_skipProgress) (default: System.getenv(\"CI\") != null): Should progress bar be skipped (can be useful on CI for example)..\ninstall.tool (install_tool)*: Tool to install..\ninstall.version (install_version)*: Version of tool to install..\nlist-local.tool (list_local_tool): Tool to filter..\nlist.providers (list_providers): List of providers to use (comma separated)..\nlist.tools (list_tools): List of tools to list (comma separated)..\nmessages.disableColors (messages_disableColors) (default: \"auto\"): Are colors disabled for the terminal..\nmessages.disableEmoji (messages_disableEmoji) (default: \"auto\"): If false emoji are totally disabled. auto will test /usr/share/fonts/truetype/noto/NotoColorEmoji.ttf and /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf presence to enable emojis. true/false disable/enable emoji whatever the available fonts..\nmessages.errorColor (messages_errorColor) (default: \"31\"): Error message color..\nmessages.toolColor (messages_toolColor) (default: \"0;49;34\"): When color are enabled the tool name color..\nmessages.versionColor (messages_versionColor) (default: \"0;49;96\"): When color are enabled the version color..\nmessages.warningColor (messages_warningColor) (default: \"33\"): Warning message color..\nminikube.enabled (minikube_enabled) (default: false): Is Minikube (Github) support enabled. It is disabled by default cause it also depends on local dependencies (docker or cri depending how you plan to run - driver)..\nresolve.provider (resolve_provider): Provider to use to resolve the version (if not t is deduced from the tool/version parameters)..\nresolve.relaxed (resolve_relaxed) (default: false): Should version be matched with a startsWith logic (ex: resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.)..\nresolve.tool (resolve_tool)*: Tool to resolve..\nresolve.version (resolve_version)*: Version of tool to resolve..\nrun.defaultRc (run_defaultRc) (default: System.getProperty(\"user.home\") + \"/.yupiik/yem/rc\"): Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc..\nrun.rc (run_rc) (default: \".yemrc\"): Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present..\nsdkman.base (sdkman_base) (default: \"https://api.sdkman.io/2/\"): Base URL for SDKMan API..\nsdkman.enabled (sdkman_enabled) (default: true): Is SDKMan support enabled..\nsdkman.local (sdkman_local) (default: java.util.Optional.ofNullable(System.getenv(\"SDKMAN_DIR\")).map(b -> java.nio.file.Path.of(b).resolve(\"candidates\").toString()).orElseGet(() -> System.getProperty(\"user.home\", \"\") + \"/.sdkman/candidates\")): SDKMan local candidates directory, generally $HOME/.sdkman/candidates..\nsdkman.platform (sdkman_platform) (default: \"auto\"): SDKMan platform value - if auto it will be computed..\nzulu.apiBase (zulu_apiBase) (default: \"https://api.azul.com\"): This property is the Zulu API base URI..\nzulu.base (zulu_base) (default: \"https://cdn.azul.com/zulu/bin/\"): Base URL for zulu CDN archives..\nzulu.enabled (zulu_enabled) (default: true): Is Zulu CDN support enabled..\nzulu.local (zulu_local) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/zulu\"): Local cache of distributions..\nzulu.platform (zulu_platform) (default: \"auto\"): Zulu platform value - if auto it will be computed..\nzulu.preferApi (zulu_preferApi) (default: true): YEM is able to scrape the CDN index page but it is slow when not cached so by default we prefer the Zulu API. This property enables to use the scrapping by being set to false..\nzulu.preferJre (zulu_preferJre) (default: false): Should JRE be preferred over JDK..\nThe command line uses spaces between option and value: yem install --tool java --version 21.0.2.\nconfig: Show configuration.\nParameters: * --delete-provider: Provider to use to delete the version (if not t is deduced from the tool/version parameters). * --delete-tool: Tool to delete. * --delete-version: Version of tool to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance.\nParameters: * --env-defaultRc: Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc. * --env-enableAutoDetection: EXPERIMENTAL. If enabled and no .yemrc nor .sdkmanrc setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a pom.xml and the compiler version can be extracted for example) and Maven (pom.xml presence). Note that it is done using ./ folder and bubbles up with a max of 10 levels. * --env-inlineRc: Enables to set inline a rc file, ex: eval $(yem env --inlineRc 'java.version=17.0.9'), you can use EOL too: `eval $(yem env --inlineRc 'java.version=17. java.relaxed = true'). Note that to persist the change even if you automatically switch from the globalyemrcfile the context, we setYEM$TOOLPATHVARNAMEOVERRIDENenvironment variable. To reset the value to the global configuration justunsetthis variable (ex:unset YEMJAVAPATH_OVERRIDEN). Note that you can also just set the values inline as args without that option:eval $(yem env --java-version 17. --java-relaxed true ...)`. * --env-rc: Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present. * --env-skipReset: By default if YEM_ORIGINAL_PATH exists in the environment variables it is used as PATH base to not keep appending path to the PATH indefinively. This can be disabled setting this property to false\nParameters: * --http-address: Binding address. * --http-open: Should the server be opened ASAP if possible on your system or just the server be launched. * --http-port: Port to open the server to, by default it is random.\nParameters: * --install-provider: Provider to use to install the version (if not t is deduced from the tool/version parameters). * --install-relaxed: Should version be matched with a startsWith logic (ex: install --install-tool java --install-relaxed true --install-version 21.). * --install-skipProgress: Should progress bar be skipped (can be useful on CI for example). * --install-tool: Tool to install. * --install-version: Version of tool to install.\nParameters: * --list-providers: List of providers to use (comma separated). * --list-tools: List of tools to list (comma separated).\nParameters: * --list-local-tool: Tool to filter.\nlist-providers: List available providers.\nParameters: * --resolve-provider: Provider to use to resolve the version (if not t is deduced from the tool/version parameters). * --resolve-relaxed: Should version be matched with a startsWith logic (ex: resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.). * --resolve-tool: Tool to resolve. * --resolve-version: Version of tool to resolve.\nParameters: * --run-defaultRc: Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc. * --run-rc: Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present.\nA bit like SDKMan, yem supports to initialize an environment from a file but with some differences.\nThe file must be a properties file. Each tool/distribution setup has several properties:\nOnly the version property is required of prefix matches a tool name. You can get as much group of properties as needed tools (one for java 11, one for java 17, one for maven 4 etc...).\nThe run command supports aliases. They globally use a .yemrc file as for env command but support additional properties.\nThese additional properties must match the pattern xxx.alias = yyyy where xxx is an alias name and yyyy a command. The usage of yem run -- xxxx will be equivalent to run yyyy command (can have arguments predefined) in the context of the .yemrc file, including the environment - Java, Apache Maven etc...\nIf you need to see more logs from yem you can add the following system properties: -Djava.util.logging.manager=io.yupiik.logging.jul.YupiikLogManager -Dio.yupiik.logging.jul.handler.StandardHandler.level=FINEST -Dio.yupiik.level=FINEST.\nYou can also force some default configuration (typically central gavs or offlineMode) in ~/.yupiik/yem/rc. If you don't want this global file to be taken into account temporarly (or not) you can set the environment variable YEM_DISABLE_GLOBAL_RC_FILE to true.\nYem is portable but we detail there only shell setup.\nThe idea is to leverage env command. Add to your global ~/.bashrc (or ~/.profile) configuration the following line:\nif you don't use zsh shell you can simplify it:\nit is also recommended to set some default versions in ~/.yupiik/yem/rc","title":"YEM","url":"/tools-maven-plugin/yem.html"},{"lang":"en","text":"","title":"Yupiik Tools Plugin","url":"/tools-maven-plugin/index.html"},{"lang":"en","lvl2":"Goals","text":"src/main/doc/content: contains a set of .adoc (converted to .html)\nsrc/main/doc/assets: contains a set of files moved \"as this\" to site output directory (css, js)\nsrc/main/doc/templates: contains the templates for the layout and pages of the website - pdf : custom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes. - script-cli-skeleton : seed a simple bash CLI. - serve-minisite : minisite goa with HTTP server. - serve-slides : custom attributes. - simple-dependencies : which format to use to dump them. - slides : custom attributes. - synchronize-github-releases : fetch versions of the defined artifacts on a nexus and ensures it is set as github release artifacts. - watch-pdf : custom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.","title":"Yupiik-tools Maven Plugin","url":"/tools-maven-plugin/mojo/yupiik-tools-maven-plugin.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nUses the Yupiik asciidoc implementation to render an asciidoc file in HTML.\nTo call this goal from the command line execute: mvn yupiik-tools:asciidoc.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:asciidoc@my-execution command.\n* means the parameter is required.\ninput* (String)\nThe file to render. Property: ${yupiik.asciidoc.input}.\noutput* (String)\nWhere to write the output. Property: ${yupiik.asciidoc.output}.\nassets (List)\nattributes (Map)\nattributes. Property: ${yupiik.asciidoc.attributes}.\nbase (String)\ninclude resolution base directory. Property: ${yupiik.asciidoc.base}.\ndataUriForAscii2Svg (boolean)\nshould ascii2svg diagram be rendered as svg or img tag. Default value: true. Property: ${yupiik.asciidoc.dataUriForAscii2Svg}.\nopenBrowser (boolean)\nShould the browser be opened after the rendering in watch mode (ignored otherwise). Can be true/false. Default value: true. Property: ${yupiik.asciidoc.openBrowser}.\nport (int)\nPort to launch the server when opening the browser in watch mode. Default value: 4200. Property: ${yupiik.asciidoc.port}.\nrenderer (String)\nRenderer to use, can be io.yupiik.asciidoc.renderer.html.AsciidoctorLikeHtmlRenderer, io.yupiik.asciidoc.renderer.html.ShowerRenderer or any fully qualified name of a visitor. Default value: io.yupiik.asciidoc.renderer.html.AsciidoctorLikeHtmlRenderer. Property: ${yupiik.asciidoc.renderer}.\nsectionTag (String)\nsection tag for default asciidoctor like renderer. Default value: div. Property: ${yupiik.asciidoc.sectionTag}.\nskipGlobalContentWrapper (boolean)\nshould the div.content wrapper for the whole rendering be skipped. Default value: false. Property: ${yupiik.asciidoc.skipGlobalContentWrapper}.\nskipSectionBody (boolean)\nshould section body div wrappers be skipped (can be useful for some theming). Default value: false. Property: ${yupiik.asciidoc.skipSectionBody}.\nsupportsDataAttributes (boolean)\nshould html data attributes be supported. Default value: true. Property: ${yupiik.asciidoc.supportsDataAttributes}.\nwatch (long)\nIf positive the rendering will loop with a delay of this value. Default value: -1. Property: ${yupiik.asciidoc.watch}.","title":"yupiik-tools:asciidoc","url":"/tools-maven-plugin/mojo/asciidoc.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:audit.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:audit@my-execution command.\nattributes (Map)\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:audit","url":"/tools-maven-plugin/mojo/audit.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to crypt a properties file.\nTo call this goal from the command line execute: mvn yupiik-tools:crypt-properties.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:crypt-properties@my-execution command.\n* means the parameter is required.\ninput* (java.io.File)\nInput properties file path. Property: ${yupiik.crypt-properties.input}.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\noutput* (java.io.File)\nTarget location of the encrypted properties file. Property: ${yupiik.crypt-properties.output}.\nexcludedKeys (List)\nList of keys to not encrypt the value for. Property: ${yupiik.crypt-properties.excludedKeys}.\nincludedKeys (List)\nList of keys to encrypt the value for. Property: ${yupiik.crypt-properties.includedKeys}.\npreserveComments (boolean)\nShould properties structure be preserved (comments, order) or not. This can break properties structure in some rare cases, if so disable this. Default value: true. Property: ${yupiik.crypt-properties.preserveComments}.\nreduceDiff (boolean)\nIf true and output exists, it will be read to compare the encrypted values and keep them if they didnt change. Default value: true. Property: ${yupiik.crypt-properties.reduceDiff}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.","title":"yupiik-tools:crypt-properties","url":"/tools-maven-plugin/mojo/crypt-properties.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to crypt a value and log it.\nTo call this goal from the command line execute: mvn yupiik-tools:crypt-value.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:crypt-value@my-execution command.\n* means the parameter is required.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\nvalue* (String)\nValue to crypt. Property: ${yupiik.crypt.value}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.\nuseStdout (boolean)\nShould the encrypted value be printed using stdout or maven logger. Default value: false. Property: ${yupiik.crypt.useStdout}.","title":"yupiik-tools:crypt-value","url":"/tools-maven-plugin/mojo/crypt-value.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nConvert cucumber JSON report(s) into an asciidoc file which can be rendered with PDF or HTML goals.\nTo call this goal from the command line execute: mvn yupiik-tools:cucumber2asciidoc.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:cucumber2asciidoc@my-execution command.\nprefix (String)\nDefault value: = Cucumber Report. Property: ${yupiik.cucumber.prefix}.\nsource (java.io.File)\nDefault value: ${project.build.directory/cucumber-reports/. Property: ${yupiik.cucumber.source}.\nsuffix (String)\nProperty: ${yupiik.cucumber.suffix}.\ntarget (java.io.File)\nDefault value: ${project.build.directory}/generated-adoc/cucumber.report.adoc. Property: ${yupiik.cucumber.target}.","title":"yupiik-tools:cucumber2asciidoc","url":"/tools-maven-plugin/mojo/cucumber2asciidoc.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to decrypt an encrypted properties file.\nTo call this goal from the command line execute: mvn yupiik-tools:decrypt-properties.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:decrypt-properties@my-execution command.\n* means the parameter is required.\ninput* (java.io.File)\nInput properties file path. Property: ${yupiik.crypt-properties.input}.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\noutput* (java.io.File)\nTarget location of the encrypted properties file. Property: ${yupiik.crypt-properties.output}.\nexcludedKeys (List)\nList of keys to not encrypt the value for. Property: ${yupiik.crypt-properties.excludedKeys}.\nincludedKeys (List)\nList of keys to encrypt the value for. Property: ${yupiik.crypt-properties.includedKeys}.\npreserveComments (boolean)\nShould properties structure be preserved (comments, order) or not. This can break properties structure in some rare cases, if so disable this. Default value: true. Property: ${yupiik.crypt-properties.preserveComments}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.","title":"yupiik-tools:decrypt-properties","url":"/tools-maven-plugin/mojo/decrypt-properties.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to decrypt a value.\nTo call this goal from the command line execute: mvn yupiik-tools:decrypt-value.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:decrypt-value@my-execution command.\n* means the parameter is required.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\nvalue* (String)\nValue to decrypt. Property: ${yupiik.decrypt.value}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.\nuseStdout (boolean)\nShould the clear value be printed using maven logger or directly in stdout. Default value: false. Property: ${yupiik.decrypt.useStdout}.","title":"yupiik-tools:decrypt-value","url":"/tools-maven-plugin/mojo/decrypt-value.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch releases from github repo to generate a blog post. The search is between 2 dates.\nTo call this goal from the command line execute: mvn yupiik-tools:generate-blog-post-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:generate-blog-post-releases@my-execution command.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.generate-blog-post-releases.forceHttpV1}.\nfrom (String)\nProperty: ${yupiik.generate-blog-post-releases.from}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.generate-blog-post-releases.githubRepository}.\ngithubRepositories (List)\nProperty: ${yupiik.generate-blog-post-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.generate-blog-post-releases.githubServerId}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.generate-blog-post-releases.threads}.\nto (String)\nProperty: ${yupiik.generate-blog-post-releases.to}.\nuseMavenCredentials (boolean)\nDefault value: true. Property: ${yupiik.generate-blog-post-releases.useMavenCredentials}.\nworkdir (String)\nDefault value: ${project.build.directory}/generate-blog-post-releases-workdir. Property: ${yupiik.generate-blog-post-releases.workdir}.","title":"yupiik-tools:generate-blog-post-releases","url":"/tools-maven-plugin/mojo/generate-blog-post-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nGenerates a report from a .git folder.\nTo call this goal from the command line execute: mvn yupiik-tools:git-report.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:git-report@my-execution command.\n* means the parameter is required.\ndotGit* (java.io.File)\n\"Where .git folder to analyze is. Property: ${yupiik.git-report.dotGit}.\nfilters (io.yupiik.maven.mojo.GitReportMojo$GitLogFilter)\nOptions to filter the git log value. Property: ${yupiik.git-report.filters}.\nlogFormat (io.yupiik.maven.mojo.GitReportMojo$GitLogFormat)\nHow to format a log line if the renderer needs to. Property: ${yupiik.git-report.logFormat}.\noverwrite (boolean)\nIf true existing report is overwritten else it fails if it already exists. Default value: true. Property: ${yupiik.git-report.overwrite}.\nrenderers (io.yupiik.maven.mojo.GitReportMojo$Renderer[])\nKind of rendering. Default value: DEFAULT. Property: ${yupiik.git-report.renderer}.\ntarget (java.io.File)\nWhere to write the report. Default value: ${project.build.directory}/yupiik-git/report.adoc. Property: ${yupiik.git-report.target}.\ntitle (String)\nReport title. Default value: Report. Property: ${yupiik.git-report.title}.","title":"yupiik-tools:git-report","url":"/tools-maven-plugin/mojo/git-report.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nInjects a select in an already generated website - like minisite one - enabling to switch between listed version from a folder. It can be combined with some javascript to switch between the websites without regenerating everything.\nTo call this goal from the command line execute: mvn yupiik-tools:inject-version.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:inject-version@my-execution command.\n* means the parameter is required.\nreplacedString* (String)\nreplacingContent* (String)\nString to inject into the output. <!-- generatedversionsselect --> is replaced by a select with one option per version found. Property: ${yupiik.inject-version.replacingContent}.\nsource* (java.io.File)\nSource folder with the website to inject version to. Property: ${yupiik.inject-version.source}.\nversionFolderParent* (java.io.File)\nRoot folder containing all versions. Property: ${yupiik.inject-version.versionFolderParent}.\ncharset (String)\nWebsite encoding. Default value: ${project.build.sourceEncoding}. Property: ${yupiik.inject-version.target}.\nexcludes (List)\nList of exclusions (for file processing). Similar to includes but enables to force an exclusion. Property: ${yupiik.inject-version.excludes}.\nignoredVersionFolders (List)\nEnables to ignore some matching (to the pattern) version folders. Property: ${yupiik.inject-version.ignoredVersionFolders}.\ninPlace (boolean)\nShould the output be written in source (and target be ignored). Default value: false. Property: ${yupiik.inject-version.inPlace}.\nincludes (List)\nselectProperties (Map)\nAttributes to inject to the <select> when <!-- generatedversionsselect --> is used. Property: ${yupiik.inject-version.selectProperties}.\ntarget (java.io.File)\nOutput folder if not inplace. Property: ${yupiik.inject-version.target}.\nversionFoldersPattern (String)\nPattern to match version folders in versionFolderParent. Default value: v?\\p{Digit}+\\.\\p{Digit}+(\\.\\p{Digit}+?(\\-[a-zA-Z0-9]+)?). Property: ${yupiik.inject-version.versionFoldersPattern}.","title":"yupiik-tools:inject-version","url":"/tools-maven-plugin/mojo/inject-version.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch github releases between two dates.\nTo call this goal from the command line execute: mvn yupiik-tools:list-github-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:list-github-releases@my-execution command.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.list-github-releases.forceHttpV1}.\nfromDate (String)\nDefault value: auto. Property: ${yupiik.list-github-releases.from}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.list-github-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.list-github-releases.githubServerId}.\nprojects (List)\nProperty: ${yupiik.list-github-releases.artifacts}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.list-github-releases.threads}.\ntoDate (String)\nDefault value: auto. Property: ${yupiik.list-github-releases.to}.","title":"yupiik-tools:list-github-releases","url":"/tools-maven-plugin/mojo/list-github-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nMinisite goal. Enables to generate a small website. It needs a \"documentation\" module, it uses the following default layout:\nsrc/main/doc/content: contains a set of .adoc (converted to .html)\nsrc/main/doc/assets: contains a set of files moved \"as this\" to site output directory (css, js)\nsrc/main/doc/templates: contains the templates for the layout and pages of the website\nTo call this goal from the command line execute: mvn yupiik-tools:minisite.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:minisite@my-execution command.\naddCodeCopyButton (boolean)\nAdds a copy button to code snippets (highlightjs). Default value: true. Property: ${yupiik.minisite.addCodeCopyButton}.\naddIndexRegistrationPerCategory (boolean)\nShould blog categories pages be added to home page. Default value: true. Property: ${yupiik.minisite.addIndexRegistrationPerCategory}.\nasciidoctorExtensions (List)\nattributes (Map)\nblogCategoriesCustomizations (Map)\nblogPageSize (int)\nFor blog generated pages, the number of items to keep per page. Default value: 10. Property: ${yupiik.minisite.blogPageSize}.\nblogPublicationDate (String)\nMax date until when posts are published. today and infinite are supported as dynamic alias. Using default the minisite rendering uses today and the serve mode uses infinite to get local previews. Default value: default. Property: ${yupiik.minisite.blogPublicationDate}.\nclasses (java.io.File)\ntarget/classes for pre-actions if needed. Default value: ${project.build.outputDirectory}. Property: ${yupiik.minisite.classes}.\nconfluence (io.yupiik.maven.service.confluence.Confluence)\ncopyright (String)\ncopyright value in the footer when using default theme. Property: ${yupiik.minisite.copyright}.\ncustomHead (String)\nCustom head links (to add custom css easily). Property: ${yupiik.minisite.customHead}.\ncustomMenu (String)\nCustom html template for menus. Property: ${yupiik.minisite.customMenu}.\ncustomScripts (String)\nCustom scripts links (to add custom js easily). Property: ${yupiik.minisite.customScripts}.\ndescription (String)\nDefault HTML page description. Property: ${yupiik.minisite.description}.\nexcludedArtifacts (List)\nArtifacts to ignore in the classloader loading asciidoctor extensions and preactions. Default value: org.asciidoctor:asciidoctorj. Property: ${yupiik.minisite.excludedArtifacts}.\nftp (io.yupiik.maven.service.ftp.configuration.Ftp)\ngenerateBlog (boolean)\nGenerate blog pages if it has some blog entries - skipped otherwise. Default value: true. Property: ${yupiik.minisite.generateBlog}.\ngenerateIndex (boolean)\nGenerate index page. Default value: true. Property: ${yupiik.minisite.generateIndex}.\ngenerateSiteMap (boolean)\nGenerate sitemap page (xml). Default value: true. Property: ${yupiik.minisite.generateSiteMap}.\ngit (io.yupiik.maven.service.git.Git)\ngravatar (io.yupiik.tools.minisite.MiniSiteConfiguration$GravatarConfiguration)\nincludeProvidedScope (boolean)\nShould asciidoctor extensions and preactions be loaded with the provided dependencies in the classloader or not. Default value: true. Property: ${yupiik.minisite.includeProvidedScope}.\nindexSubTitle (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexSubTitle}.\nindexText (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexText}.\ninjectBlogMeta (boolean)\nAdd reading time on blog pages. Default value: true. Property: ${yupiik.minisite.injectBlogMeta}.\ninjectYupiikTemplateExtensionPoints (boolean)\nUse yupiik theme. Default value: true. Property: ${yupiik.minisite.injectYupiikTemplateExtensionPoints}.\nlinkedInCompany (String)\nlinkedInCompany name (in linkedin url). Default value: yupiik. Property: ${yupiik.minisite.linkedInCompany}.\nlogo (String)\nLogo url. Default value: //www.yupiik.io/images/favicon.png. Property: ${yupiik.minisite.logo}.\nlogoSideText (String)\nText next to the logo text. Default value: Docs. Property: ${yupiik.minisite.logoSideText}.\nlogoText (String)\nDefault logo text for default template. Property: ${yupiik.minisite.logoText}.\nnotIndexedPages (List)\npreActions (List)\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nreverseBlogOrder (boolean)\nShould page sorting be reversed (by published date). Default value: true. Property: ${yupiik.minisite.reverseBlogOrder}.\nrssFeedFile (String)\nRSS feed location (relative to the output) if set. Property: ${yupiik.minisite.rssFeedFile}.\nsearchIndexName (String)\nGenerate search json. Default value: search.json. Property: ${yupiik.minisite.searchIndexName}.\nsiteBase (String)\nDefault HTML page description. Default value: . Property: ${yupiik.minisite.siteBase}.\nskip (boolean)\nSkip mojo execution. Default value: false. Property: ${yupiik.minisite.skip}.\nskipIndexTitleDocumentationText (boolean)\nShould Documentation title suffix be skipped. Default value: false. Property: ${yupiik.minisite.skipIndexTitleDocumentationText}.\nskipRendering (boolean)\nSkip site rendering. Default value: false. Property: ${yupiik.minisite.skipRendering}.\nsource (java.io.File)\nWhere to read content (layout root) from. Default value: ${project.basedir}/src/main/minisite. Property: ${yupiik.minisite.source}.\ntarget (java.io.File)\nWhere to generate the site. Default value: ${project.build.directory}/${project.build.finalName}. Property: ${yupiik.minisite.target}.\ntemplateAddLeftMenu (boolean)\nShould left menu (global navigation) be added from index links. Default value: true. Property: ${yupiik.minisite.addLeftMenu}.\ntemplateDirs (List)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\ntemplateExtensionPoints (Map)\nCustom default theme extension points. An extension point is a placeholder in a template surrounded by 3 braces: } }. Property: ${yupiik.minisite.templateExtensionPoints}.\ntemplatePrefixes (List)\nTemplate file name added before the content. Default value: header.html,menu.html. Property: .\ntemplateSuffixes (List)\nTemplate file name added after the content. Default value: footer-top.html,footer-end.html. Property: .\ntitle (String)\nDefault HTML page title. Property: ${yupiik.minisite.title}.\nuseDefaultAssets (boolean)\nUse default assets. Default value: true. Property: ${yupiik.minisite.useDefaultAssets}.\nusePluginAsParentClassLoader (String)\nA boolean or auto (= if asciidoctorExtensions is not empty it behaves as true) to use the plugin classloader as parent for preaction and asciidoctor extension or not. Default value: auto. Property: ${yupiik.minisite.usePluginAsParentClassLoader}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:minisite","url":"/tools-maven-plugin/mojo/minisite.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:pdf.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:pdf@my-execution command.\nattributes (Map)\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:pdf","url":"/tools-maven-plugin/mojo/pdf.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nSeed a simple bash CLI.\nTo call this goal from the command line execute: mvn yupiik-tools:script-cli-skeleton.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:script-cli-skeleton@my-execution command.\n* means the parameter is required.\ndirectory* (java.io.File)\nWhere to create the bash CLI skeleton. Property: ${yupiik.script-cli-skeleton.directory}.\ngenerateHelloWorldCommand (boolean)\nWhere to create the bash CLI skeleton. Default value: true. Property: ${yupiik.script-cli-skeleton.generateHelloWorldCommand}.","title":"yupiik-tools:script-cli-skeleton","url":"/tools-maven-plugin/mojo/script-cli-skeleton.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nMinisite goa with HTTP server.\nTo call this goal from the command line execute: mvn yupiik-tools:serve-minisite.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:serve-minisite@my-execution command.\naddCodeCopyButton (boolean)\nAdds a copy button to code snippets (highlightjs). Default value: true. Property: ${yupiik.minisite.addCodeCopyButton}.\naddIndexRegistrationPerCategory (boolean)\nShould blog categories pages be added to home page. Default value: true. Property: ${yupiik.minisite.addIndexRegistrationPerCategory}.\nasciidoctorExtensions (List)\nattributes (Map)\nblogCategoriesCustomizations (Map)\nblogPageSize (int)\nFor blog generated pages, the number of items to keep per page. Default value: 10. Property: ${yupiik.minisite.blogPageSize}.\nblogPublicationDate (String)\nMax date until when posts are published. today and infinite are supported as dynamic alias. Using default the minisite rendering uses today and the serve mode uses infinite to get local previews. Default value: default. Property: ${yupiik.minisite.blogPublicationDate}.\nclasses (java.io.File)\ntarget/classes for pre-actions if needed. Default value: ${project.build.outputDirectory}. Property: ${yupiik.minisite.classes}.\nconfluence (io.yupiik.maven.service.confluence.Confluence)\ncopyright (String)\ncopyright value in the footer when using default theme. Property: ${yupiik.minisite.copyright}.\ncustomHead (String)\nCustom head links (to add custom css easily). Property: ${yupiik.minisite.customHead}.\ncustomMenu (String)\nCustom html template for menus. Property: ${yupiik.minisite.customMenu}.\ncustomScripts (String)\nCustom scripts links (to add custom js easily). Property: ${yupiik.minisite.customScripts}.\ndescription (String)\nDefault HTML page description. Property: ${yupiik.minisite.description}.\nexcludedArtifacts (List)\nArtifacts to ignore in the classloader loading asciidoctor extensions and preactions. Default value: org.asciidoctor:asciidoctorj. Property: ${yupiik.minisite.excludedArtifacts}.\nftp (io.yupiik.maven.service.ftp.configuration.Ftp)\ngenerateBlog (boolean)\nGenerate blog pages if it has some blog entries - skipped otherwise. Default value: true. Property: ${yupiik.minisite.generateBlog}.\ngenerateIndex (boolean)\nGenerate index page. Default value: true. Property: ${yupiik.minisite.generateIndex}.\ngenerateSiteMap (boolean)\nGenerate sitemap page (xml). Default value: true. Property: ${yupiik.minisite.generateSiteMap}.\ngit (io.yupiik.maven.service.git.Git)\ngravatar (io.yupiik.tools.minisite.MiniSiteConfiguration$GravatarConfiguration)\nincludeProvidedScope (boolean)\nShould asciidoctor extensions and preactions be loaded with the provided dependencies in the classloader or not. Default value: true. Property: ${yupiik.minisite.includeProvidedScope}.\nindexSubTitle (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexSubTitle}.\nindexText (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexText}.\ninjectBlogMeta (boolean)\nAdd reading time on blog pages. Default value: true. Property: ${yupiik.minisite.injectBlogMeta}.\ninjectYupiikTemplateExtensionPoints (boolean)\nUse yupiik theme. Default value: true. Property: ${yupiik.minisite.injectYupiikTemplateExtensionPoints}.\nlinkedInCompany (String)\nlinkedInCompany name (in linkedin url). Default value: yupiik. Property: ${yupiik.minisite.linkedInCompany}.\nlogo (String)\nLogo url. Default value: //www.yupiik.io/images/favicon.png. Property: ${yupiik.minisite.logo}.\nlogoSideText (String)\nText next to the logo text. Default value: Docs. Property: ${yupiik.minisite.logoSideText}.\nlogoText (String)\nDefault logo text for default template. Property: ${yupiik.minisite.logoText}.\nnotIndexedPages (List)\nopenBrowser (boolean)\nDefault value: true. Property: ${yupiik.minisite.openBrowser}.\nport (int)\nWhich port to bind. Default value: 4200. Property: ${yupiik.minisite.port}.\npreActions (List)\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nreverseBlogOrder (boolean)\nShould page sorting be reversed (by published date). Default value: true. Property: ${yupiik.minisite.reverseBlogOrder}.\nrssFeedFile (String)\nRSS feed location (relative to the output) if set. Property: ${yupiik.minisite.rssFeedFile}.\nsearchIndexName (String)\nGenerate search json. Default value: search.json. Property: ${yupiik.minisite.searchIndexName}.\nsiteBase (String)\nDefault HTML page description. Default value: . Property: ${yupiik.minisite.siteBase}.\nskip (boolean)\nSkip mojo execution. Default value: false. Property: ${yupiik.minisite.skip}.\nskipIndexTitleDocumentationText (boolean)\nShould Documentation title suffix be skipped. Default value: false. Property: ${yupiik.minisite.skipIndexTitleDocumentationText}.\nskipRendering (boolean)\nSkip site rendering. Default value: false. Property: ${yupiik.minisite.skipRendering}.\nsource (java.io.File)\nWhere to read content (layout root) from. Default value: ${project.basedir}/src/main/minisite. Property: ${yupiik.minisite.source}.\ntarget (java.io.File)\nWhere to generate the site. Default value: ${project.build.directory}/${project.build.finalName}. Property: ${yupiik.minisite.target}.\ntemplateAddLeftMenu (boolean)\nShould left menu (global navigation) be added from index links. Default value: true. Property: ${yupiik.minisite.addLeftMenu}.\ntemplateDirs (List)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\ntemplateExtensionPoints (Map)\nCustom default theme extension points. An extension point is a placeholder in a template surrounded by 3 braces: } }. Property: ${yupiik.minisite.templateExtensionPoints}.\ntemplatePrefixes (List)\nTemplate file name added before the content. Default value: header.html,menu.html. Property: .\ntemplateSuffixes (List)\nTemplate file name added after the content. Default value: footer-top.html,footer-end.html. Property: .\ntitle (String)\nDefault HTML page title. Property: ${yupiik.minisite.title}.\nuseDefaultAssets (boolean)\nUse default assets. Default value: true. Property: ${yupiik.minisite.useDefaultAssets}.\nusePluginAsParentClassLoader (String)\nA boolean or auto (= if asciidoctorExtensions is not empty it behaves as true) to use the plugin classloader as parent for preaction and asciidoctor extension or not. Default value: auto. Property: ${yupiik.minisite.usePluginAsParentClassLoader}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:serve-minisite","url":"/tools-maven-plugin/mojo/serve-minisite.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:serve-slides.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:serve-slides@my-execution command.\nattributes (Map)\ncustomCss (java.io.File)\nCustom css if needed, overrides default one. Property: ${yupiik.slides.customCss}.\ncustomScripts (String[])\nCustom js if needed. Property: ${yupiik.slides.customScripts}.\nmode (io.yupiik.tools.slides.SlidesConfiguration$Mode)\nWhich execution mode to use, WATCH and SERVE are for dev purposes. Default value: DEFAULT. Property: ${yupiik.slides.mode}.\nopenBrowser (boolean)\nDefault value: true. Property: ${yupiik.slides.openBrowser}.\nport (int)\nFor SERVE mode, which port to bind. Default value: 4200. Property: ${yupiik.slides.serve.port}.\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nslider (io.yupiik.tools.slides.SlidesConfiguration$SliderType)\nWhich renderer (slide) to use. Default value: BESPOKE_ENRICHED. Property: ${yupiik.slides.slider}.\nsource (java.io.File)\nSlide deck source file. Default value: ${project.basedir}/src/main/slides/index.adoc. Property: ${yupiik.slides.source}.\nsynchronizationFolders (List)\ntargetDirectory (java.io.File)\nWhere to render the slide deck. Default value: ${project.build.directory}/yupiik/slides. Property: ${yupiik.slides.target}.\ntemplateDirs (java.io.File)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:serve-slides","url":"/tools-maven-plugin/mojo/serve-slides.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nWhich format to use to dump them.\nTo call this goal from the command line execute: mvn yupiik-tools:simple-dependencies.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:simple-dependencies@my-execution command.\nformat (io.yupiik.maven.mojo.SimpleDependenciesMojo$Format)\nWhich format to use to dump them. Default value: JSON. Property: ${yupiik.simple-dependencies.format}.\noutput (String)\nWhere to dump the dependencies, log to log them, else a file path. Default value: ${project.build.directory/dependencies.adoc. Property: ${yupiik.simple-dependencies.source}.\nscope (String)\nWhich scope to include, use all to include them all. Default value: all. Property: ${yupiik.simple-dependencies.scope}.","title":"yupiik-tools:simple-dependencies","url":"/tools-maven-plugin/mojo/simple-dependencies.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:slides.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:slides@my-execution command.\nattributes (Map)\ncustomCss (java.io.File)\nCustom css if needed, overrides default one. Property: ${yupiik.slides.customCss}.\ncustomScripts (String[])\nCustom js if needed. Property: ${yupiik.slides.customScripts}.\nmode (io.yupiik.tools.slides.SlidesConfiguration$Mode)\nWhich execution mode to use, WATCH and SERVE are for dev purposes. Default value: DEFAULT. Property: ${yupiik.slides.mode}.\nport (int)\nFor SERVE mode, which port to bind. Default value: 4200. Property: ${yupiik.slides.serve.port}.\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nslider (io.yupiik.tools.slides.SlidesConfiguration$SliderType)\nWhich renderer (slide) to use. Default value: BESPOKE_ENRICHED. Property: ${yupiik.slides.slider}.\nsource (java.io.File)\nSlide deck source file. Default value: ${project.basedir}/src/main/slides/index.adoc. Property: ${yupiik.slides.source}.\nsynchronizationFolders (List)\ntargetDirectory (java.io.File)\nWhere to render the slide deck. Default value: ${project.build.directory}/yupiik/slides. Property: ${yupiik.slides.target}.\ntemplateDirs (java.io.File)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:slides","url":"/tools-maven-plugin/mojo/slides.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch versions of the defined artifacts on a nexus and ensures it is set as github release artifacts.\nTo call this goal from the command line execute: mvn yupiik-tools:synchronize-github-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:synchronize-github-releases@my-execution command.\nartifacts (List)\nProperty: ${yupiik.synchronize-github-releases.artifacts}.\nattachIfExists (boolean)\nDefault value: false. Property: ${yupiik.synchronize-github-releases.attachIfExists}.\ndryRun (boolean)\nProperty: ${yupiik.synchronize-github-releases.dryRun}.\nforce (boolean)\nDefault value: false. Property: ${yupiik.synchronize-github-releases.force}.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.synchronize-github-releases.forceHttpV1}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.synchronize-github-releases.githubRepository}.\ngithubRepository (String)\nProperty: ${yupiik.synchronize-github-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.synchronize-github-releases.githubServerId}.\nmavenRepositoryBaseUrl (String)\nDefault value: . Property: ${yupiik.synchronize-github-releases.mavenRepositoryBaseUrl}.\nnexusServerId (String)\nProperty: ${yupiik.synchronize-github-releases.nexusServerId}.\ntagPattern (String)\nProperty: ${yupiik.synchronize-github-releases.tagPattern}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.synchronize-github-releases.threads}.\nworkdir (String)\nDefault value: ${project.build.directory}/synchronize-github-releases-workdir. Property: ${yupiik.synchronize-github-releases.workdir}.","title":"yupiik-tools:synchronize-github-releases","url":"/tools-maven-plugin/mojo/synchronize-github-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:watch-pdf.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:watch-pdf@my-execution command.\nattributes (Map)\npauseBetweenChecks (long)\nHow long to pause between two check to see if sources must be re-rendered. Default value: 1000. Property: ${yupiik.pdf.pauseBetweenChecks}.\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:watch-pdf","url":"/tools-maven-plugin/mojo/watch-pdf.html"}]
\ No newline at end of file
+[{"lang":"en","text":"The module ascii2svg is a fork of the go https://github.com/asciitosvg/asciitosvg library rewritten in Java. It enables to convert a string graph in SVG.\nFor example:\nWill be rendered as:\nimage:data:image/svg+xml,%3C!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.1//EN' 'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'%3E%3Csvg width='306px' height='112px' version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Cdefs%3E%3Cfilter id='dsFilter' width='150%25' height='150%25'%3E%3CfeOffset result='offOut' in='SourceGraphic' dx='2' dy='2'/%3E%3CfeColorMatrix result='matrixOut' in='offOut' type='matrix' values='0.2 0 0 0 0 0 0.2 0 0 0 0 0 0.2 0 0 0 0 0 1 0'/%3E%3CfeGaussianBlur result='blurOut' in='matrixOut' stdDeviation='3'/%3E%3CfeBlend in='SourceGraphic' in2='blurOut' mode='normal'/%3E%3C/filter%3E%3Cmarker id='iPointer' viewBox='0 0 10 10' refX='5' refY='5' markerUnits='strokeWidth' markerWidth='8' markerHeight='15' orient='auto'%3E%3Cpath d='M 10 0 L 10 10 L 0 5 z' /%3E%3C/marker%3E%3Cmarker id='Pointer' viewBox='0 0 10 10' refX='5' refY='5' markerUnits='strokeWidth' markerWidth='8' markerHeight='15' orient='auto'%3E%3Cpath d='M 0 0 L 10 5 L 0 10 z' /%3E%3C/marker%3E%3C/defs%3E%3Cg id='closed' stroke='%23000' stroke-width='2' fill='none'%3E%3Cpath id='closed0' fill='%23aa4444' d='M 4.5 18.0 Q 4.5 8.0 14.5 8.0 L 13.5 8.0 L 22.5 8.0 L 31.5 8.0 L 40.5 8.0 L 49.5 8.0 L 58.5 8.0 L 67.5 8.0 L 76.5 8.0 L 85.5 8.0 L 94.5 8.0 L 103.5 8.0 L 112.5 8.0 L 121.5 8.0 L 120.5 8.0 Q 130.5 8.0 130.5 18.0 L 130.5 24.0 L 130.5 30.0 Q 130.5 40.0 120.5 40.0 L 121.5 40.0 L 112.5 40.0 L 103.5 40.0 L 94.5 40.0 L 85.5 40.0 L 76.5 40.0 L 67.5 40.0 L 58.5 40.0 L 49.5 40.0 L 40.5 40.0 L 31.5 40.0 L 22.5 40.0 L 13.5 40.0 L 14.5 40.0 Q 4.5 40.0 4.5 30.0 L 4.5 24.0 Z' /%3E%3Cpath id='closed1' fill='%23ccccff' d='M 157.5 18.0 Q 157.5 8.0 167.5 8.0 L 166.5 8.0 L 175.5 8.0 L 184.5 8.0 L 193.5 8.0 L 202.5 8.0 L 211.5 8.0 L 220.5 8.0 L 229.5 8.0 L 238.5 8.0 L 247.5 8.0 L 256.5 8.0 L 265.5 8.0 L 274.5 8.0 L 283.5 8.0 L 282.5 8.0 Q 292.5 8.0 292.5 18.0 L 292.5 24.0 L 292.5 30.0 Q 292.5 40.0 282.5 40.0 L 283.5 40.0 L 274.5 40.0 L 265.5 40.0 L 256.5 40.0 L 247.5 40.0 L 238.5 40.0 L 229.5 40.0 L 220.5 40.0 L 211.5 40.0 L 202.5 40.0 L 193.5 40.0 L 184.5 40.0 L 175.5 40.0 L 166.5 40.0 L 167.5 40.0 Q 157.5 40.0 157.5 30.0 L 157.5 24.0 Z' /%3E%3C/g%3E%3Cg id='lines' stroke='%23000' stroke-width='2' fill='none'%3E%3C/g%3E%3Cg id='text' stroke='none'\nMore on the syntax there: https://github.com/asciitosvg/asciitosvg.","title":"Ascii2SVG","url":"/tools-maven-plugin/ascii2svg.html"},{"lang":"en","text":"The module asciidoc-java implements a light Asciidoc syntax parser in plain Java. It aims at making it easier and lighter than using JRuby to embed Asciidoc in any Java based (native or not) application.\nIts usage is pretty simple:\nYou get a Parser instance to load the model of your document in memory (AST),\nYou visit the model as you want (or reusing provided Visitor<?>) to render the loaded Document.\nthe Document instance is thread safe and can safely be reused accross multiple threads. The parser is also thread save but the visitors must be created per rendering instance.\nHere is a basic example:\nthe asciidoc syntax is not 100% implemented yet, if you encounter anything you miss, feel free to open an issue or pull request on our bugtracker.","title":"Asciidoc Java","url":"/tools-maven-plugin/asciidoc-java.html"},{"lang":"en","text":"Most Maven goals are available as CLI commands using yupiik-tools-cli.\nIt is a plain Java application but you can also download the fatjar jar which is executable: java -cp yupiik-tools-cli-$version-fatjar.jar <args>.","title":"CLI","url":"/tools-maven-plugin/cli.html"},{"lang":"en","lvl2":"Chain plugins\nPDF and latex formula\nPom-less PDF rendering\nMinisite\nBash CLI skeleton\nMaven Asciidoctor Macro\nSimple Dependencies\nYupiik OSS extension\nInline pom contributor extension\nCrypt mojos","lvl3":"Confluence Limitations\nBlog\nPre-Action\nExample\nPage attributes\nIndex generation\nEscaping\nSynchronize Releases Example\nUsage\nmaven_dependencies\nValue based mojo\nProperties based mojo","text":"To learn all goals available in the maven plugin read Yupiik Tools Maven Plugin dedicated page.\nMojo can be chained from the command like - without pom declaration.\nThis is the case of the git report one and PDF one for example:\nYou can enable latex formula support in PDF adding the related dependency:\nThen usage is as follow:\nYou can render an asciidoctor file without a pom nor pom declaration:\nminisite can push the minisite to a remote target (often git backed pages).\nas all plugins it requires Java 11 but if you want to use it with Java 8 you can use minisite-core module with exec-maven-plugin since version 1.1.1.\nHere is the related documentation.\nThe configuration supports a git entry if you want to upload to a Git branch the generated website (like gh-pages):\nThe configuration also supports an experimental Atlassian Confluence export support. It only works using the default template and require a configuration similar to git or ftp exports:\nthe nested support of this exporter is very experimental, and we recommend you to keep only one level of .adoc files using it.\nAssets are not uploaded so ensure to configure Asciidoctor to embed all assets in HTML,\nIt only works with the default theme since we extract metadata from there to enable to update the space,\nTo look nice, you can need to tune the Confluence space CSS to import admonitions, codeblocks, ... styling (can require some admin permissions).\nBlog is supported if pages contain at least one block metadata. Here is the list of available attributes you can use:\n:minisite-blog-published-date: yyyy-MM-dd: when the page will be rendered (if not set it is always rendered).\n:minisite-blog-categories: c1,c2: comma separated list of categories of this post\n:minisite-blog-authors: My, Myself: comma separated list of author names\n:minisite-blog-summary: Some short description.: the summary of this post used on post list pages.\nBlog page example:\nPre actions enables to generate some content from the project. It is typically used to generate configuration from code or things like that. It uses the documentation module classpath. Actions must implement Runnable and can have some (public) constructor parameters (we use parameter names to match so ensure to enable -parameters in maven compiler plugin):\nconfiguration (Map<String, String>): the action configuration, it enables to reuse it if needed or write generic actions\nsourceBase (Path): the base directory you can generate .adoc into (generally where you sources are, tip: use generated folder to be able to exclude it in .gitignore if desired)\noutputBase (Path): the base directory you can generate direct html assets\nUsing type=maven-plugin (recommended) or type=io.yupiik.maven.service.action.builtin.MojoDocumentationGeneration you can get a plugin.xml file parsed to generate:\nOne file per goal with some usage, the goal description and parameters (named <goal>.adoc)\nOne file listing all goals (named <goal-prefix>-maven-plugin.adoc)\nThe configuration of this action is:\npluginXml: file path or resource to find the plugin.xml file.\ntoBase: where to generate the adoc.\ndescription: a global plugin description for the \"listing\" page (default is empty and page will just list goals).\nUsing type=copy (recommended) or type=io.yupiik.maven.service.action.builtin.CopyFile will copy a file from a source to a destination: It is typically useful for assets (openapi.json for example).\nfrom: source file.\nto: destination.\nUsing type=jsonschema (recommended) or type=io.yupiik.maven.service.action.builtin.JsonSchemaGenerator will generate a JSON-Schema from a class:\nclass: the class to generate the schema from.\nto: destination of the schema.\ntype: JSON for a raw JSON-Schema (default) or ADOC for a textual, asciidoctor output.\nsetClassAsTitle: true to force object title to be the class name.\nuseReflectionForDefaults: true to force reflection to try to extract defaults of attributes.\npretty when type=JSON, should the JSON be prettified or not (default=true).\nlevelPrefix when type=ADOC, a title prefix (== for example), = by default.\ntitle and description enable to set class title/description for its json schema. It is required for type=ADOC.\nannotationOnlyProvidesTheDescription enable to never take the title from an annotation (@Description(value) case).\nthe model classes can use a custom @Description(title,description) annotation (note that @Doc is also supported and value method can be used instead of description). See JsonDocExtractor for more details.\nUsing type=jsonschema2adoc (recommended) or type=io.yupiik.maven.service.action.builtin.JsonSchema2AdocGenerator will generate an asciidoctor document from a JSON-Schema file (intended to be used with fusion mainly):\nschema: location of the schema (JSON).\nroot: key under schemas map of the root schema to generate a doc for.\nlevelPrefix: prefix to set for title (default =).\noutput: where to generate the .adoc.\nUsing type=openmetrics2adoc (recommended) or type=io.yupiik.tools.minisite.action.builtin.OpenMetricsToAsciidoc will generate an asciidoctor form from an OpenMetrics export.\nsource: path of the openmetrics dump.\nto: destination of the asciidoc generated from source.\nlevelPrefix: a prefix set before the part title (== by default for a second level title).\nlegend: should tables have a legend (name of the metric), default to true.\nheader: prefix the whole rendering (enables to set a title and some options if needed).\nUsing type=simple-configuration (recommended) or type=io.yupiik.tools.minisite.action.builtin.SimpleConfigurationGenerator will generate an asciidoctor from a configuration class passed in class <configuration> option.\nclass: root configuration fully qualified name.\noutput: where to generate the .adoc to.\nUsing type=download-unzip (recommended) or type=io.yupiik.tools.minisite.action.builtin.DownloadAndUnzip enables to download a zip from a HTTP url then extract it totally or partially to a particular folder. This can be used to download a git repository using Github/Gitlab/Gitea API for example.\nurl: the zip URL.\nsubpath: the subpath to copy in target. It filters the zip entries names by prefix.\nheaders: in properties format, a set of headers to set.\ntarget: where to copy the selected files.\nworkdir: temporary folder (to download the zip), temporary if not set.\nUsing type=replace-in-file (recommended) or type=io.yupiik.tools.minisite.action.builtin.ReplaceInFile will rewrite a text file replacing a string by another one.\nsource: file to rewrite.\ntoken: text to replace.\nreplacement: text replacing token.\nusing regex{xxx} as token will use a java regex to do the replacement.\nSome specific attributes enables to customize the generation. Here is their list:\nminisite-skip=[true|false] enables to skip a .adoc rendering even if not in _partials directory.\nminisite-path=<string> enables to force the relative path of the file, for example a file name foo-bar.adoc with the attribute minisite-path set to foo/bar.html will output a foo/bar.html file instead of foo-bar.html. Note however it does not rewrite the links to ensure to use link:.....html[] instead of ref to link this page then.\nminisite-highlightjs-skip enables to not setup highlight.js for the page (useful with swagger-ui for example).\nTo include a page in the index it must contain minisite-index attribute. Its value is the order of the entry in the index tiles.\nensure to not use 1, 2, 3, ... but rather 100, 200, ... to easily insert an item later.\nminisite-index-title attribute enables to override link text.\nminisite-index-icon attribute enables to override font awesome icon (without fa- prefix).\nminisite-index-description attribute enables to override the text in the index tile for the page entry.\nWhen you write some documentation in a language close to the minisite interpolation one (mustache for ex), it can be hard to use. To ease that, you can surround your snippet with and , included text will not support interpolations.\nThen run mvn yupiik-tools:synchronize-github-releases.\nscript-cli-skeleton enables to generates a skeleton layout to write a CLI in bash (helper commands for your project).\ncan be used on a pomless project: mvn io.yupiik.maven:yupiik-tools-maven-plugin:<version>:script-cli-skeleton -Dyupiik.script-cli-skeleton.directory=/path/to/script-project (version >= 1.0.26).\nTo add a command:\nCreate an index.sh containing the command script in commands folder\n(optional) create a commands/<your command name>/_cli/help.txt file containing the help description.\nThe project adds asciidoc macros to get back some maven build information. Note that it must be executed in the right lifecycle phase if using some project metadata (plugin does not require any resolution to be usable standalone).\nEnables to list the project dependencies.\nScope can be:\n- compile - runtime - compile+runtime - runtime+system - test - provided_only - compile_only - test_only - system_only - runtime_only\nThe optional attribute groupId is also supported and take a list (comma separated) of groupId to include.\nsimple-dependencies is a trivial and simple alternative to maven-dependency-plugin:list mojo which outputs the data in JSON.\nIt is convenient with minisite mojo to format with a custom action the dependencies according to a custom need.\nThis extension sets up the equivalent of a parent pom but enables to inherit or not from another parent and to benefit from upgrades for free.\nIt is configured in the root project through maven properties:\nJust enabling this extension will upgrade a few plugin, enforce the encoding and java version, enforce license check and much more.\nSee io.yupiik.maven.extension.YupiikOSSExtension.afterProjectsRead for details.\nIt enables to put in each module a YupiikContributor.java file which will be compiled and executed in afterProjectRead(MavenSession) callback.\nExample:\nThis enables to programmatically handle the pom (mainly intended for plugins since dependencies are not synchronized in maven poms when contributed this way).\nTo enable it, enable the related extension:\nsee io.yupiik.maven.extension.YupiikOSSExtension for a more complex participant example.\nCrypt mojos are intended to encrypt/decrypt (using AES/CBC/PKCS5Padding algorithm - like maven default encryption ) values. It supports either inline values or properties files.\nit is a neat way to handle secrets in a bundlebee placeholder properties file on CI/CD if you don't have a vault or equivalent mecanism for GitOps.\nyupiik-tools:crypt-value will enable to encrypt a value (symmetrically, decrypt-value will decrypt a value).\nConfiguration is:\nvalue: the value to crypt (decrypt),\nuseStdout: should the value be printed using Maven logger or simply stdout,\nmasterPassword: the master password for the ciphering.\ninput: path to the properties file to crypt (decrypt) values for (keys are never encrypted),\noutput: path to the properties file which will contain encrypted (decrypted) data,\nmasterPassword: the master password for the ciphering,\nincludedKeys: a list of values (direct key), start:<some prefix> prefixes or regex:<pattern> regex to filter the values to encrypt (decrypt) based on their keys,\nexcludedKeys: a list of values (direct key), start:<some prefix> prefixes or regex:<pattern> regex to filter the values to NOT encrypt (decrypt) based on their keys.\noutput always sorts the keys and will ignore comments. An already encoded value will not be re-encoded. This last point enables to set input=output to encrypt in place a file.","title":"Maven","url":"/tools-maven-plugin/mojos.html"},{"lang":"en","lvl2":"Inspiration\nConfiguration\nCLI\nAuto-path\nAlias support\nTIP\nShell/Bash setup","lvl3":"Commands","text":"Setting up dev environment can be a nightmare.yem intends to make it easier.\nyem is inspired from SDKMan, Chocolatey and other alternatives. The main differences are:\nyem does not come with a remote storage but it tries to reuse existing ones - priviledging immutable one when possible (compared to SDKMan where you can loose the version you picked),\nyem intends to be portable (linux/windows at least),\nyem is extensible if needed (new source or tool/distribution).\nthe atomic configuration is listed there but used on the command line you must ensure to prefix any option by - and replace dots by -. Example: central.base becomes --central-base.\ncentral.base (central_base) (default: \"https://repo.maven.apache.org/maven2/\"): Base repository URL..\ncentral.gavs (central_gavs) (default: \"org.apache.maven:apache-maven:tar.gz:bin\"): List of GAV to register (comma separated). Such a provider can be enabled/disabled using artifactId.enabled property..\ncentral.header (central_header): Headers to add if the repository is authenticated. Syntax uses HTTP one: --central-header 'Authorization: Basic xxxxx' for example.\ncentral.local (central_local) (default: System.getProperty(\"user.home\", \"\") + \"/.m2/repository\"): Local repository path..\ndelete.provider (delete_provider): Provider to use to delete the version (if not t is deduced from the tool/version parameters)..\ndelete.tool (delete_tool)*: Tool to delete..\ndelete.version (delete_version)*: Version of tool to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance..\nenv.defaultRc (env_defaultRc) (default: System.getProperty(\"user.home\") + \"/.yupiik/yem/rc\"): Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc..\nenv.enableAutoDetection (env_enableAutoDetection) (default: false): EXPERIMENTAL. If enabled and no .yemrc nor .sdkmanrc setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a pom.xml and the compiler version can be extracted for example) and Maven (pom.xml presence). Note that it is done using ./ folder and bubbles up with a max of 10 levels..\nenv.inlineRc (env_inlineRc): Enables to set inline a rc file, ex: eval $(yem env --inlineRc 'java.version=17.0.9'), you can use EOL too: eval $(yem env --inlineRc 'java.version=17.\\njava.relaxed = true'). Note that to persist the change even if you automatically switch from the global yemrc file the context, we set YEM_$TOOLPATHVARNAME_OVERRIDEN environment variable. To reset the value to the global configuration just unset this variable (ex: unset YEM_JAVA_PATH_OVERRIDEN). Note that you can also just set the values inline as args without that option: eval $(yem env --java-version 17. --java-relaxed true ...)..\nenv.rc (env_rc) (default: \"auto\"): Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present..\nenv.skipReset (env_skipReset) (default: false): By default if YEM_ORIGINAL_PATH exists in the environment variables it is used as PATH base to not keep appending path to the PATH indefinively. This can be disabled setting this property to false.\ngithub.base (github_base) (default: \"https://api.github.com\"): Base repository URL..\ngithub.header (github_header): Header to add to every request (authorization one for example)..\ngithub.local (github_local) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/github\"): Local repository path..\nhttp.address (http_address) (default: \"localhost\"): Binding address..\nhttp.cacheValidity (http_cacheValidity) (default: 86_400_000L): Cache validity of requests (1 day by default) in milliseconds. A negative or zero value will disable cache..\nhttp.cache (http_cache) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/cache/http\"): Where to cache slow updates (version fetching). none will disable cache..\nhttp.connectTimeout (http_connectTimeout) (default: 60_000L): Connection timeout in milliseconds..\nhttp.ignoreSSLErrors (http_ignoreSSLErrors) (default: false): Should SSL errors be ignored..\nhttp.log (http_log) (default: false): Should HTTP calls be logged..\nhttp.offlineMode (http_offlineMode) (default: false): Force offline mode..\nhttp.offlineTimeout (http_offlineTimeout) (default: 10_000): Check offline timeout. Per uri a test is done to verify the system is offline..\nhttp.open (http_open) (default: true): Should the server be opened ASAP if possible on your system or just the server be launched..\nhttp.port (http_port) (default: 0): Port to open the server to, by default it is random..\nhttp.proxy.host (http_proxy_host) (default: \"none\"): Proxy host. none means ignore..\nhttp.proxy.ignoredHosts (http_proxy_ignoredHosts) (default: java.util.List.of()): Hosts to connect directly to (ignoring the proxy)..\nhttp.proxy.password (http_proxy_password) (default: \"none\"): Proxy password. none means ignore..\nhttp.proxy.port (http_proxy_port) (default: 3128): Proxy port..\nhttp.proxy.username (http_proxy_username) (default: \"none\"): Proxy username. none means ignore..\nhttp.requestTimeout (http_requestTimeout) (default: 900_000L): Request timeout in milliseconds..\nhttp.threads (http_threads) (default: 4): Number of NIO threads..\ninstall.provider (install_provider): Provider to use to install the version (if not t is deduced from the tool/version parameters)..\ninstall.relaxed (install_relaxed) (default: false): Should version be matched with a startsWith logic (ex: install --install-tool java --install-relaxed true --install-version 21.)..\ninstall.skipProgress (install_skipProgress) (default: System.getenv(\"CI\") != null): Should progress bar be skipped (can be useful on CI for example)..\ninstall.tool (install_tool)*: Tool to install..\ninstall.version (install_version)*: Version of tool to install..\nlist-local.tool (list_local_tool): Tool to filter..\nlist.providers (list_providers): List of providers to use (comma separated)..\nlist.tools (list_tools): List of tools to list (comma separated)..\nmessages.disableColors (messages_disableColors) (default: \"auto\"): Are colors disabled for the terminal..\nmessages.disableEmoji (messages_disableEmoji) (default: \"auto\"): If false emoji are totally disabled. auto will test /usr/share/fonts/truetype/noto/NotoColorEmoji.ttf and /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf presence to enable emojis. true/false disable/enable emoji whatever the available fonts..\nmessages.errorColor (messages_errorColor) (default: \"31\"): Error message color..\nmessages.toolColor (messages_toolColor) (default: \"0;49;34\"): When color are enabled the tool name color..\nmessages.versionColor (messages_versionColor) (default: \"0;49;96\"): When color are enabled the version color..\nmessages.warningColor (messages_warningColor) (default: \"33\"): Warning message color..\nminikube.enabled (minikube_enabled) (default: false): Is Minikube (Github) support enabled. It is disabled by default cause it also depends on local dependencies (docker or cri depending how you plan to run - driver)..\nresolve.provider (resolve_provider): Provider to use to resolve the version (if not t is deduced from the tool/version parameters)..\nresolve.relaxed (resolve_relaxed) (default: false): Should version be matched with a startsWith logic (ex: resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.)..\nresolve.tool (resolve_tool)*: Tool to resolve..\nresolve.version (resolve_version)*: Version of tool to resolve..\nrun.defaultRc (run_defaultRc) (default: System.getProperty(\"user.home\") + \"/.yupiik/yem/rc\"): Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc..\nrun.rc (run_rc) (default: \".yemrc\"): Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present..\nsdkman.base (sdkman_base) (default: \"https://api.sdkman.io/2/\"): Base URL for SDKMan API..\nsdkman.enabled (sdkman_enabled) (default: true): Is SDKMan support enabled..\nsdkman.local (sdkman_local) (default: java.util.Optional.ofNullable(System.getenv(\"SDKMAN_DIR\")).map(b -> java.nio.file.Path.of(b).resolve(\"candidates\").toString()).orElseGet(() -> System.getProperty(\"user.home\", \"\") + \"/.sdkman/candidates\")): SDKMan local candidates directory, generally $HOME/.sdkman/candidates..\nsdkman.platform (sdkman_platform) (default: \"auto\"): SDKMan platform value - if auto it will be computed..\nzulu.apiBase (zulu_apiBase) (default: \"https://api.azul.com\"): This property is the Zulu API base URI..\nzulu.base (zulu_base) (default: \"https://cdn.azul.com/zulu/bin/\"): Base URL for zulu CDN archives..\nzulu.enabled (zulu_enabled) (default: true): Is Zulu CDN support enabled..\nzulu.local (zulu_local) (default: System.getProperty(\"user.home\", \"\") + \"/.yupiik/yem/zulu\"): Local cache of distributions..\nzulu.platform (zulu_platform) (default: \"auto\"): Zulu platform value - if auto it will be computed..\nzulu.preferApi (zulu_preferApi) (default: true): YEM is able to scrape the CDN index page but it is slow when not cached so by default we prefer the Zulu API. This property enables to use the scrapping by being set to false..\nzulu.preferJre (zulu_preferJre) (default: false): Should JRE be preferred over JDK..\nThe command line uses spaces between option and value: yem install --tool java --version 21.0.2.\nconfig: Show configuration.\n--delete-provider: Provider to use to delete the version (if not t is deduced from the tool/version parameters).\n--delete-tool: Tool to delete.\n--delete-version: Version of tool to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance.\n--env-defaultRc: Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc.\n--env-enableAutoDetection: EXPERIMENTAL. If enabled and no .yemrc nor .sdkmanrc setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a pom.xml and the compiler version can be extracted for example) and Maven (pom.xml presence). Note that it is done using ./ folder and bubbles up with a max of 10 levels.\n--env-inlineRc: Enables to set inline a rc file, ex: eval $(yem env --inlineRc 'java.version=17.0.9'), you can use EOL too: `eval $(yem env --inlineRc 'java.version=17. java.relaxed = true'). Note that to persist the change even if you automatically switch from the globalyemrcfile the context, we setYEM$TOOLPATHVARNAMEOVERRIDENenvironment variable. To reset the value to the global configuration justunsetthis variable (ex:unset YEMJAVAPATH_OVERRIDEN). Note that you can also just set the values inline as args without that option:eval $(yem env --java-version 17. --java-relaxed true ...)`.\n--env-rc: Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present.\n--env-skipReset: By default if YEM_ORIGINAL_PATH exists in the environment variables it is used as PATH base to not keep appending path to the PATH indefinively. This can be disabled setting this property to false\n--http-address: Binding address.\n--http-open: Should the server be opened ASAP if possible on your system or just the server be launched.\n--http-port: Port to open the server to, by default it is random.\n--install-provider: Provider to use to install the version (if not t is deduced from the tool/version parameters).\n--install-relaxed: Should version be matched with a startsWith logic (ex: install --install-tool java --install-relaxed true --install-version 21.).\n--install-skipProgress: Should progress bar be skipped (can be useful on CI for example).\n--install-tool: Tool to install.\n--install-version: Version of tool to install.\n--list-providers: List of providers to use (comma separated).\n--list-tools: List of tools to list (comma separated).\n--list-local-tool: Tool to filter.\nlist-providers: List available providers.\n--resolve-provider: Provider to use to resolve the version (if not t is deduced from the tool/version parameters).\n--resolve-relaxed: Should version be matched with a startsWith logic (ex: resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.).\n--resolve-tool: Tool to resolve.\n--resolve-version: Version of tool to resolve.\n--run-defaultRc: Should ~/.yupiik/yem/rc be ignored or not. If present it defines default versions and uses the same syntax than yemrc.\n--run-rc: Env file location to read to generate the script. Note that auto will try to pick .yemrc and if not there will use .sdkmanrc if present.\nA bit like SDKMan, yem supports to initialize an environment from a file but with some differences.\nThe file must be a properties file. Each tool/distribution setup has several properties:\nOnly the version property is required of prefix matches a tool name. You can get as much group of properties as needed tools (one for java 11, one for java 17, one for maven 4 etc...).\nThe run command supports aliases. They globally use a .yemrc file as for env command but support additional properties.\nThese additional properties must match the pattern xxx.alias = yyyy where xxx is an alias name and yyyy a command. The usage of yem run -- xxxx will be equivalent to run yyyy command (can have arguments predefined) in the context of the .yemrc file, including the environment - Java, Apache Maven etc...\nIf you need to see more logs from yem you can add the following system properties: -Djava.util.logging.manager=io.yupiik.logging.jul.YupiikLogManager -Dio.yupiik.logging.jul.handler.StandardHandler.level=FINEST -Dio.yupiik.level=FINEST.\nYou can also force some default configuration (typically central gavs or offlineMode) in ~/.yupiik/yem/rc. If you don't want this global file to be taken into account temporarly (or not) you can set the environment variable YEM_DISABLE_GLOBAL_RC_FILE to true.\nYem is portable but we detail there only shell setup.\nThe idea is to leverage env command. Add to your global ~/.bashrc (or ~/.profile) configuration the following line:\nif you don't use zsh shell you can simplify it:\nit is also recommended to set some default versions in ~/.yupiik/yem/rc","title":"YEM","url":"/tools-maven-plugin/yem.html"},{"lang":"en","text":"","title":"Yupiik Tools Plugin","url":"/tools-maven-plugin/index.html"},{"lang":"en","lvl2":"Goals","text":"src/main/doc/content: contains a set of .adoc (converted to .html)\nsrc/main/doc/assets: contains a set of files moved \"as this\" to site output directory (css, js)\nsrc/main/doc/templates: contains the templates for the layout and pages of the website - pdf : custom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes. - script-cli-skeleton : seed a simple bash CLI. - serve-minisite : minisite goa with HTTP server. - serve-slides : custom attributes. - simple-dependencies : which format to use to dump them. - slides : custom attributes. - synchronize-github-releases : fetch versions of the defined artifacts on a nexus and ensures it is set as github release artifacts. - watch-pdf : custom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.","title":"Yupiik-tools Maven Plugin","url":"/tools-maven-plugin/mojo/yupiik-tools-maven-plugin.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nUses the Yupiik asciidoc implementation to render an asciidoc file in HTML.\nTo call this goal from the command line execute: mvn yupiik-tools:asciidoc.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:asciidoc@my-execution command.\n* means the parameter is required.\ninput* (String)\nThe file to render. Property: ${yupiik.asciidoc.input}.\noutput* (String)\nWhere to write the output. Property: ${yupiik.asciidoc.output}.\nassets (List)\nattributes (Map)\nattributes. Property: ${yupiik.asciidoc.attributes}.\nbase (String)\ninclude resolution base directory. Property: ${yupiik.asciidoc.base}.\ndataUriForAscii2Svg (boolean)\nshould ascii2svg diagram be rendered as svg or img tag. Default value: true. Property: ${yupiik.asciidoc.dataUriForAscii2Svg}.\nopenBrowser (boolean)\nShould the browser be opened after the rendering in watch mode (ignored otherwise). Can be true/false. Default value: true. Property: ${yupiik.asciidoc.openBrowser}.\nport (int)\nPort to launch the server when opening the browser in watch mode. Default value: 4200. Property: ${yupiik.asciidoc.port}.\nrenderer (String)\nRenderer to use, can be io.yupiik.asciidoc.renderer.html.AsciidoctorLikeHtmlRenderer, io.yupiik.asciidoc.renderer.html.ShowerRenderer or any fully qualified name of a visitor. Default value: io.yupiik.asciidoc.renderer.html.AsciidoctorLikeHtmlRenderer. Property: ${yupiik.asciidoc.renderer}.\nsectionTag (String)\nsection tag for default asciidoctor like renderer. Default value: div. Property: ${yupiik.asciidoc.sectionTag}.\nskipGlobalContentWrapper (boolean)\nshould the div.content wrapper for the whole rendering be skipped. Default value: false. Property: ${yupiik.asciidoc.skipGlobalContentWrapper}.\nskipSectionBody (boolean)\nshould section body div wrappers be skipped (can be useful for some theming). Default value: false. Property: ${yupiik.asciidoc.skipSectionBody}.\nsupportsDataAttributes (boolean)\nshould html data attributes be supported. Default value: true. Property: ${yupiik.asciidoc.supportsDataAttributes}.\nwatch (long)\nIf positive the rendering will loop with a delay of this value. Default value: -1. Property: ${yupiik.asciidoc.watch}.","title":"yupiik-tools:asciidoc","url":"/tools-maven-plugin/mojo/asciidoc.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:audit.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:audit@my-execution command.\nattributes (Map)\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:audit","url":"/tools-maven-plugin/mojo/audit.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to crypt a properties file.\nTo call this goal from the command line execute: mvn yupiik-tools:crypt-properties.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:crypt-properties@my-execution command.\n* means the parameter is required.\ninput* (java.io.File)\nInput properties file path. Property: ${yupiik.crypt-properties.input}.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\noutput* (java.io.File)\nTarget location of the encrypted properties file. Property: ${yupiik.crypt-properties.output}.\nexcludedKeys (List)\nList of keys to not encrypt the value for. Property: ${yupiik.crypt-properties.excludedKeys}.\nincludedKeys (List)\nList of keys to encrypt the value for. Property: ${yupiik.crypt-properties.includedKeys}.\npreserveComments (boolean)\nShould properties structure be preserved (comments, order) or not. This can break properties structure in some rare cases, if so disable this. Default value: true. Property: ${yupiik.crypt-properties.preserveComments}.\nreduceDiff (boolean)\nIf true and output exists, it will be read to compare the encrypted values and keep them if they didnt change. Default value: true. Property: ${yupiik.crypt-properties.reduceDiff}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.","title":"yupiik-tools:crypt-properties","url":"/tools-maven-plugin/mojo/crypt-properties.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to crypt a value and log it.\nTo call this goal from the command line execute: mvn yupiik-tools:crypt-value.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:crypt-value@my-execution command.\n* means the parameter is required.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\nvalue* (String)\nValue to crypt. Property: ${yupiik.crypt.value}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.\nuseStdout (boolean)\nShould the encrypted value be printed using stdout or maven logger. Default value: false. Property: ${yupiik.crypt.useStdout}.","title":"yupiik-tools:crypt-value","url":"/tools-maven-plugin/mojo/crypt-value.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nConvert cucumber JSON report(s) into an asciidoc file which can be rendered with PDF or HTML goals.\nTo call this goal from the command line execute: mvn yupiik-tools:cucumber2asciidoc.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:cucumber2asciidoc@my-execution command.\nprefix (String)\nDefault value: = Cucumber Report. Property: ${yupiik.cucumber.prefix}.\nsource (java.io.File)\nDefault value: ${project.build.directory/cucumber-reports/. Property: ${yupiik.cucumber.source}.\nsuffix (String)\nProperty: ${yupiik.cucumber.suffix}.\ntarget (java.io.File)\nDefault value: ${project.build.directory}/generated-adoc/cucumber.report.adoc. Property: ${yupiik.cucumber.target}.","title":"yupiik-tools:cucumber2asciidoc","url":"/tools-maven-plugin/mojo/cucumber2asciidoc.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to decrypt an encrypted properties file.\nTo call this goal from the command line execute: mvn yupiik-tools:decrypt-properties.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:decrypt-properties@my-execution command.\n* means the parameter is required.\ninput* (java.io.File)\nInput properties file path. Property: ${yupiik.crypt-properties.input}.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\noutput* (java.io.File)\nTarget location of the encrypted properties file. Property: ${yupiik.crypt-properties.output}.\nexcludedKeys (List)\nList of keys to not encrypt the value for. Property: ${yupiik.crypt-properties.excludedKeys}.\nincludedKeys (List)\nList of keys to encrypt the value for. Property: ${yupiik.crypt-properties.includedKeys}.\npreserveComments (boolean)\nShould properties structure be preserved (comments, order) or not. This can break properties structure in some rare cases, if so disable this. Default value: true. Property: ${yupiik.crypt-properties.preserveComments}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.","title":"yupiik-tools:decrypt-properties","url":"/tools-maven-plugin/mojo/decrypt-properties.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nEnables to decrypt a value.\nTo call this goal from the command line execute: mvn yupiik-tools:decrypt-value.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:decrypt-value@my-execution command.\n* means the parameter is required.\nmasterPassword* (String)\nMaster password for the enryption (AES/CBC/PKCS5Padding). Property: ${yupiik.crypt.masterPassword}.\nvalue* (String)\nValue to decrypt. Property: ${yupiik.decrypt.value}.\nuseAES256GCM (boolean)\nShould AES256 GCM be used else AES/CBC/PKCS5Padding is used. Default value: fase. Property: ${yupiik.crypt.useAES256GCM}.\nuseStdout (boolean)\nShould the clear value be printed using maven logger or directly in stdout. Default value: false. Property: ${yupiik.decrypt.useStdout}.","title":"yupiik-tools:decrypt-value","url":"/tools-maven-plugin/mojo/decrypt-value.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch releases from github repo to generate a blog post. The search is between 2 dates.\nTo call this goal from the command line execute: mvn yupiik-tools:generate-blog-post-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:generate-blog-post-releases@my-execution command.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.generate-blog-post-releases.forceHttpV1}.\nfrom (String)\nProperty: ${yupiik.generate-blog-post-releases.from}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.generate-blog-post-releases.githubRepository}.\ngithubRepositories (List)\nProperty: ${yupiik.generate-blog-post-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.generate-blog-post-releases.githubServerId}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.generate-blog-post-releases.threads}.\nto (String)\nProperty: ${yupiik.generate-blog-post-releases.to}.\nuseMavenCredentials (boolean)\nDefault value: true. Property: ${yupiik.generate-blog-post-releases.useMavenCredentials}.\nworkdir (String)\nDefault value: ${project.build.directory}/generate-blog-post-releases-workdir. Property: ${yupiik.generate-blog-post-releases.workdir}.","title":"yupiik-tools:generate-blog-post-releases","url":"/tools-maven-plugin/mojo/generate-blog-post-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nGenerates a report from a .git folder.\nTo call this goal from the command line execute: mvn yupiik-tools:git-report.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:git-report@my-execution command.\n* means the parameter is required.\ndotGit* (java.io.File)\n\"Where .git folder to analyze is. Property: ${yupiik.git-report.dotGit}.\nfilters (io.yupiik.maven.mojo.GitReportMojo$GitLogFilter)\nOptions to filter the git log value. Property: ${yupiik.git-report.filters}.\nlogFormat (io.yupiik.maven.mojo.GitReportMojo$GitLogFormat)\nHow to format a log line if the renderer needs to. Property: ${yupiik.git-report.logFormat}.\noverwrite (boolean)\nIf true existing report is overwritten else it fails if it already exists. Default value: true. Property: ${yupiik.git-report.overwrite}.\nrenderers (io.yupiik.maven.mojo.GitReportMojo$Renderer[])\nKind of rendering. Default value: DEFAULT. Property: ${yupiik.git-report.renderer}.\ntarget (java.io.File)\nWhere to write the report. Default value: ${project.build.directory}/yupiik-git/report.adoc. Property: ${yupiik.git-report.target}.\ntitle (String)\nReport title. Default value: Report. Property: ${yupiik.git-report.title}.","title":"yupiik-tools:git-report","url":"/tools-maven-plugin/mojo/git-report.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nInjects a select in an already generated website - like minisite one - enabling to switch between listed version from a folder. It can be combined with some javascript to switch between the websites without regenerating everything.\nTo call this goal from the command line execute: mvn yupiik-tools:inject-version.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:inject-version@my-execution command.\n* means the parameter is required.\nreplacedString* (String)\nreplacingContent* (String)\nString to inject into the output. <!-- generatedversionsselect --> is replaced by a select with one option per version found. Property: ${yupiik.inject-version.replacingContent}.\nsource* (java.io.File)\nSource folder with the website to inject version to. Property: ${yupiik.inject-version.source}.\nversionFolderParent* (java.io.File)\nRoot folder containing all versions. Property: ${yupiik.inject-version.versionFolderParent}.\ncharset (String)\nWebsite encoding. Default value: ${project.build.sourceEncoding}. Property: ${yupiik.inject-version.target}.\nexcludes (List)\nList of exclusions (for file processing). Similar to includes but enables to force an exclusion. Property: ${yupiik.inject-version.excludes}.\nignoredVersionFolders (List)\nEnables to ignore some matching (to the pattern) version folders. Property: ${yupiik.inject-version.ignoredVersionFolders}.\ninPlace (boolean)\nShould the output be written in source (and target be ignored). Default value: false. Property: ${yupiik.inject-version.inPlace}.\nincludes (List)\nselectProperties (Map)\nAttributes to inject to the <select> when <!-- generatedversionsselect --> is used. Property: ${yupiik.inject-version.selectProperties}.\ntarget (java.io.File)\nOutput folder if not inplace. Property: ${yupiik.inject-version.target}.\nversionFoldersPattern (String)\nPattern to match version folders in versionFolderParent. Default value: v?\\p{Digit}+\\.\\p{Digit}+(\\.\\p{Digit}+?(\\-[a-zA-Z0-9]+)?). Property: ${yupiik.inject-version.versionFoldersPattern}.","title":"yupiik-tools:inject-version","url":"/tools-maven-plugin/mojo/inject-version.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch github releases between two dates.\nTo call this goal from the command line execute: mvn yupiik-tools:list-github-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:list-github-releases@my-execution command.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.list-github-releases.forceHttpV1}.\nfromDate (String)\nDefault value: auto. Property: ${yupiik.list-github-releases.from}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.list-github-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.list-github-releases.githubServerId}.\nprojects (List)\nProperty: ${yupiik.list-github-releases.artifacts}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.list-github-releases.threads}.\ntoDate (String)\nDefault value: auto. Property: ${yupiik.list-github-releases.to}.","title":"yupiik-tools:list-github-releases","url":"/tools-maven-plugin/mojo/list-github-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nMinisite goal. Enables to generate a small website. It needs a \"documentation\" module, it uses the following default layout:\nsrc/main/doc/content: contains a set of .adoc (converted to .html)\nsrc/main/doc/assets: contains a set of files moved \"as this\" to site output directory (css, js)\nsrc/main/doc/templates: contains the templates for the layout and pages of the website\nTo call this goal from the command line execute: mvn yupiik-tools:minisite.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:minisite@my-execution command.\naddCodeCopyButton (boolean)\nAdds a copy button to code snippets (highlightjs). Default value: true. Property: ${yupiik.minisite.addCodeCopyButton}.\naddIndexRegistrationPerCategory (boolean)\nShould blog categories pages be added to home page. Default value: true. Property: ${yupiik.minisite.addIndexRegistrationPerCategory}.\nasciidoctorExtensions (List)\nattributes (Map)\nblogCategoriesCustomizations (Map)\nblogPageSize (int)\nFor blog generated pages, the number of items to keep per page. Default value: 10. Property: ${yupiik.minisite.blogPageSize}.\nblogPublicationDate (String)\nMax date until when posts are published. today and infinite are supported as dynamic alias. Using default the minisite rendering uses today and the serve mode uses infinite to get local previews. Default value: default. Property: ${yupiik.minisite.blogPublicationDate}.\nclasses (java.io.File)\ntarget/classes for pre-actions if needed. Default value: ${project.build.outputDirectory}. Property: ${yupiik.minisite.classes}.\nconfluence (io.yupiik.maven.service.confluence.Confluence)\ncopyright (String)\ncopyright value in the footer when using default theme. Property: ${yupiik.minisite.copyright}.\ncustomHead (String)\nCustom head links (to add custom css easily). Property: ${yupiik.minisite.customHead}.\ncustomMenu (String)\nCustom html template for menus. Property: ${yupiik.minisite.customMenu}.\ncustomScripts (String)\nCustom scripts links (to add custom js easily). Property: ${yupiik.minisite.customScripts}.\ndescription (String)\nDefault HTML page description. Property: ${yupiik.minisite.description}.\nexcludedArtifacts (List)\nArtifacts to ignore in the classloader loading asciidoctor extensions and preactions. Default value: org.asciidoctor:asciidoctorj. Property: ${yupiik.minisite.excludedArtifacts}.\nftp (io.yupiik.maven.service.ftp.configuration.Ftp)\ngenerateBlog (boolean)\nGenerate blog pages if it has some blog entries - skipped otherwise. Default value: true. Property: ${yupiik.minisite.generateBlog}.\ngenerateIndex (boolean)\nGenerate index page. Default value: true. Property: ${yupiik.minisite.generateIndex}.\ngenerateSiteMap (boolean)\nGenerate sitemap page (xml). Default value: true. Property: ${yupiik.minisite.generateSiteMap}.\ngit (io.yupiik.maven.service.git.Git)\ngravatar (io.yupiik.tools.minisite.MiniSiteConfiguration$GravatarConfiguration)\nincludeProvidedScope (boolean)\nShould asciidoctor extensions and preactions be loaded with the provided dependencies in the classloader or not. Default value: true. Property: ${yupiik.minisite.includeProvidedScope}.\nindexSubTitle (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexSubTitle}.\nindexText (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexText}.\ninjectBlogMeta (boolean)\nAdd reading time on blog pages. Default value: true. Property: ${yupiik.minisite.injectBlogMeta}.\ninjectYupiikTemplateExtensionPoints (boolean)\nUse yupiik theme. Default value: true. Property: ${yupiik.minisite.injectYupiikTemplateExtensionPoints}.\nlinkedInCompany (String)\nlinkedInCompany name (in linkedin url). Default value: yupiik. Property: ${yupiik.minisite.linkedInCompany}.\nlogo (String)\nLogo url. Default value: //www.yupiik.io/images/favicon.png. Property: ${yupiik.minisite.logo}.\nlogoSideText (String)\nText next to the logo text. Default value: Docs. Property: ${yupiik.minisite.logoSideText}.\nlogoText (String)\nDefault logo text for default template. Property: ${yupiik.minisite.logoText}.\nnotIndexedPages (List)\npreActions (List)\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nreverseBlogOrder (boolean)\nShould page sorting be reversed (by published date). Default value: true. Property: ${yupiik.minisite.reverseBlogOrder}.\nrssFeedFile (String)\nRSS feed location (relative to the output) if set. Property: ${yupiik.minisite.rssFeedFile}.\nsearchIndexName (String)\nGenerate search json. Default value: search.json. Property: ${yupiik.minisite.searchIndexName}.\nsiteBase (String)\nDefault HTML page description. Default value: . Property: ${yupiik.minisite.siteBase}.\nskip (boolean)\nSkip mojo execution. Default value: false. Property: ${yupiik.minisite.skip}.\nskipIndexTitleDocumentationText (boolean)\nShould Documentation title suffix be skipped. Default value: false. Property: ${yupiik.minisite.skipIndexTitleDocumentationText}.\nskipRendering (boolean)\nSkip site rendering. Default value: false. Property: ${yupiik.minisite.skipRendering}.\nsource (java.io.File)\nWhere to read content (layout root) from. Default value: ${project.basedir}/src/main/minisite. Property: ${yupiik.minisite.source}.\ntarget (java.io.File)\nWhere to generate the site. Default value: ${project.build.directory}/${project.build.finalName}. Property: ${yupiik.minisite.target}.\ntemplateAddLeftMenu (boolean)\nShould left menu (global navigation) be added from index links. Default value: true. Property: ${yupiik.minisite.addLeftMenu}.\ntemplateDirs (List)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\ntemplateExtensionPoints (Map)\nCustom default theme extension points. An extension point is a placeholder in a template surrounded by 3 braces: } }. Property: ${yupiik.minisite.templateExtensionPoints}.\ntemplatePrefixes (List)\nTemplate file name added before the content. Default value: header.html,menu.html. Property: .\ntemplateSuffixes (List)\nTemplate file name added after the content. Default value: footer-top.html,footer-end.html. Property: .\ntitle (String)\nDefault HTML page title. Property: ${yupiik.minisite.title}.\nuseDefaultAssets (boolean)\nUse default assets. Default value: true. Property: ${yupiik.minisite.useDefaultAssets}.\nusePluginAsParentClassLoader (String)\nA boolean or auto (= if asciidoctorExtensions is not empty it behaves as true) to use the plugin classloader as parent for preaction and asciidoctor extension or not. Default value: auto. Property: ${yupiik.minisite.usePluginAsParentClassLoader}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:minisite","url":"/tools-maven-plugin/mojo/minisite.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:pdf.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:pdf@my-execution command.\nattributes (Map)\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:pdf","url":"/tools-maven-plugin/mojo/pdf.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nSeed a simple bash CLI.\nTo call this goal from the command line execute: mvn yupiik-tools:script-cli-skeleton.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:script-cli-skeleton@my-execution command.\n* means the parameter is required.\ndirectory* (java.io.File)\nWhere to create the bash CLI skeleton. Property: ${yupiik.script-cli-skeleton.directory}.\ngenerateHelloWorldCommand (boolean)\nWhere to create the bash CLI skeleton. Default value: true. Property: ${yupiik.script-cli-skeleton.generateHelloWorldCommand}.","title":"yupiik-tools:script-cli-skeleton","url":"/tools-maven-plugin/mojo/script-cli-skeleton.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nMinisite goa with HTTP server.\nTo call this goal from the command line execute: mvn yupiik-tools:serve-minisite.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:serve-minisite@my-execution command.\naddCodeCopyButton (boolean)\nAdds a copy button to code snippets (highlightjs). Default value: true. Property: ${yupiik.minisite.addCodeCopyButton}.\naddIndexRegistrationPerCategory (boolean)\nShould blog categories pages be added to home page. Default value: true. Property: ${yupiik.minisite.addIndexRegistrationPerCategory}.\nasciidoctorExtensions (List)\nattributes (Map)\nblogCategoriesCustomizations (Map)\nblogPageSize (int)\nFor blog generated pages, the number of items to keep per page. Default value: 10. Property: ${yupiik.minisite.blogPageSize}.\nblogPublicationDate (String)\nMax date until when posts are published. today and infinite are supported as dynamic alias. Using default the minisite rendering uses today and the serve mode uses infinite to get local previews. Default value: default. Property: ${yupiik.minisite.blogPublicationDate}.\nclasses (java.io.File)\ntarget/classes for pre-actions if needed. Default value: ${project.build.outputDirectory}. Property: ${yupiik.minisite.classes}.\nconfluence (io.yupiik.maven.service.confluence.Confluence)\ncopyright (String)\ncopyright value in the footer when using default theme. Property: ${yupiik.minisite.copyright}.\ncustomHead (String)\nCustom head links (to add custom css easily). Property: ${yupiik.minisite.customHead}.\ncustomMenu (String)\nCustom html template for menus. Property: ${yupiik.minisite.customMenu}.\ncustomScripts (String)\nCustom scripts links (to add custom js easily). Property: ${yupiik.minisite.customScripts}.\ndescription (String)\nDefault HTML page description. Property: ${yupiik.minisite.description}.\nexcludedArtifacts (List)\nArtifacts to ignore in the classloader loading asciidoctor extensions and preactions. Default value: org.asciidoctor:asciidoctorj. Property: ${yupiik.minisite.excludedArtifacts}.\nftp (io.yupiik.maven.service.ftp.configuration.Ftp)\ngenerateBlog (boolean)\nGenerate blog pages if it has some blog entries - skipped otherwise. Default value: true. Property: ${yupiik.minisite.generateBlog}.\ngenerateIndex (boolean)\nGenerate index page. Default value: true. Property: ${yupiik.minisite.generateIndex}.\ngenerateSiteMap (boolean)\nGenerate sitemap page (xml). Default value: true. Property: ${yupiik.minisite.generateSiteMap}.\ngit (io.yupiik.maven.service.git.Git)\ngravatar (io.yupiik.tools.minisite.MiniSiteConfiguration$GravatarConfiguration)\nincludeProvidedScope (boolean)\nShould asciidoctor extensions and preactions be loaded with the provided dependencies in the classloader or not. Default value: true. Property: ${yupiik.minisite.includeProvidedScope}.\nindexSubTitle (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexSubTitle}.\nindexText (String)\nWhen index is generated the content page title. Property: ${yupiik.minisite.indexText}.\ninjectBlogMeta (boolean)\nAdd reading time on blog pages. Default value: true. Property: ${yupiik.minisite.injectBlogMeta}.\ninjectYupiikTemplateExtensionPoints (boolean)\nUse yupiik theme. Default value: true. Property: ${yupiik.minisite.injectYupiikTemplateExtensionPoints}.\nlinkedInCompany (String)\nlinkedInCompany name (in linkedin url). Default value: yupiik. Property: ${yupiik.minisite.linkedInCompany}.\nlogo (String)\nLogo url. Default value: //www.yupiik.io/images/favicon.png. Property: ${yupiik.minisite.logo}.\nlogoSideText (String)\nText next to the logo text. Default value: Docs. Property: ${yupiik.minisite.logoSideText}.\nlogoText (String)\nDefault logo text for default template. Property: ${yupiik.minisite.logoText}.\nnotIndexedPages (List)\nopenBrowser (boolean)\nDefault value: true. Property: ${yupiik.minisite.openBrowser}.\nport (int)\nWhich port to bind. Default value: 4200. Property: ${yupiik.minisite.port}.\npreActions (List)\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nreverseBlogOrder (boolean)\nShould page sorting be reversed (by published date). Default value: true. Property: ${yupiik.minisite.reverseBlogOrder}.\nrssFeedFile (String)\nRSS feed location (relative to the output) if set. Property: ${yupiik.minisite.rssFeedFile}.\nsearchIndexName (String)\nGenerate search json. Default value: search.json. Property: ${yupiik.minisite.searchIndexName}.\nsiteBase (String)\nDefault HTML page description. Default value: . Property: ${yupiik.minisite.siteBase}.\nskip (boolean)\nSkip mojo execution. Default value: false. Property: ${yupiik.minisite.skip}.\nskipIndexTitleDocumentationText (boolean)\nShould Documentation title suffix be skipped. Default value: false. Property: ${yupiik.minisite.skipIndexTitleDocumentationText}.\nskipRendering (boolean)\nSkip site rendering. Default value: false. Property: ${yupiik.minisite.skipRendering}.\nsource (java.io.File)\nWhere to read content (layout root) from. Default value: ${project.basedir}/src/main/minisite. Property: ${yupiik.minisite.source}.\ntarget (java.io.File)\nWhere to generate the site. Default value: ${project.build.directory}/${project.build.finalName}. Property: ${yupiik.minisite.target}.\ntemplateAddLeftMenu (boolean)\nShould left menu (global navigation) be added from index links. Default value: true. Property: ${yupiik.minisite.addLeftMenu}.\ntemplateDirs (List)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\ntemplateExtensionPoints (Map)\nCustom default theme extension points. An extension point is a placeholder in a template surrounded by 3 braces: } }. Property: ${yupiik.minisite.templateExtensionPoints}.\ntemplatePrefixes (List)\nTemplate file name added before the content. Default value: header.html,menu.html. Property: .\ntemplateSuffixes (List)\nTemplate file name added after the content. Default value: footer-top.html,footer-end.html. Property: .\ntitle (String)\nDefault HTML page title. Property: ${yupiik.minisite.title}.\nuseDefaultAssets (boolean)\nUse default assets. Default value: true. Property: ${yupiik.minisite.useDefaultAssets}.\nusePluginAsParentClassLoader (String)\nA boolean or auto (= if asciidoctorExtensions is not empty it behaves as true) to use the plugin classloader as parent for preaction and asciidoctor extension or not. Default value: auto. Property: ${yupiik.minisite.usePluginAsParentClassLoader}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:serve-minisite","url":"/tools-maven-plugin/mojo/serve-minisite.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:serve-slides.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:serve-slides@my-execution command.\nattributes (Map)\ncustomCss (java.io.File)\nCustom css if needed, overrides default one. Property: ${yupiik.slides.customCss}.\ncustomScripts (String[])\nCustom js if needed. Property: ${yupiik.slides.customScripts}.\nmode (io.yupiik.tools.slides.SlidesConfiguration$Mode)\nWhich execution mode to use, WATCH and SERVE are for dev purposes. Default value: DEFAULT. Property: ${yupiik.slides.mode}.\nopenBrowser (boolean)\nDefault value: true. Property: ${yupiik.slides.openBrowser}.\nport (int)\nFor SERVE mode, which port to bind. Default value: 4200. Property: ${yupiik.slides.serve.port}.\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nslider (io.yupiik.tools.slides.SlidesConfiguration$SliderType)\nWhich renderer (slide) to use. Default value: BESPOKE_ENRICHED. Property: ${yupiik.slides.slider}.\nsource (java.io.File)\nSlide deck source file. Default value: ${project.basedir}/src/main/slides/index.adoc. Property: ${yupiik.slides.source}.\nsynchronizationFolders (List)\ntargetDirectory (java.io.File)\nWhere to render the slide deck. Default value: ${project.build.directory}/yupiik/slides. Property: ${yupiik.slides.target}.\ntemplateDirs (java.io.File)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:serve-slides","url":"/tools-maven-plugin/mojo/serve-slides.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nWhich format to use to dump them.\nTo call this goal from the command line execute: mvn yupiik-tools:simple-dependencies.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:simple-dependencies@my-execution command.\nformat (io.yupiik.maven.mojo.SimpleDependenciesMojo$Format)\nWhich format to use to dump them. Default value: JSON. Property: ${yupiik.simple-dependencies.format}.\noutput (String)\nWhere to dump the dependencies, log to log them, else a file path. Default value: ${project.build.directory/dependencies.adoc. Property: ${yupiik.simple-dependencies.source}.\nscope (String)\nWhich scope to include, use all to include them all. Default value: all. Property: ${yupiik.simple-dependencies.scope}.","title":"yupiik-tools:simple-dependencies","url":"/tools-maven-plugin/mojo/simple-dependencies.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:slides.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:slides@my-execution command.\nattributes (Map)\ncustomCss (java.io.File)\nCustom css if needed, overrides default one. Property: ${yupiik.slides.customCss}.\ncustomScripts (String[])\nCustom js if needed. Property: ${yupiik.slides.customScripts}.\nmode (io.yupiik.tools.slides.SlidesConfiguration$Mode)\nWhich execution mode to use, WATCH and SERVE are for dev purposes. Default value: DEFAULT. Property: ${yupiik.slides.mode}.\nport (int)\nFor SERVE mode, which port to bind. Default value: 4200. Property: ${yupiik.slides.serve.port}.\npreferYupiikAsciidoc (boolean)\nShould Yupiik asciidoctor-java be used instead of asciidoctorj (over jruby). While this is likely faster to bootstrap and render it is not as complete as asciidoctor as of today and requires to run at least on Java 17. Default value: false. Property: ${yupiik.minisite.preferYupiikAsciidoc}.\nrequires (List)\nslider (io.yupiik.tools.slides.SlidesConfiguration$SliderType)\nWhich renderer (slide) to use. Default value: BESPOKE_ENRICHED. Property: ${yupiik.slides.slider}.\nsource (java.io.File)\nSlide deck source file. Default value: ${project.basedir}/src/main/slides/index.adoc. Property: ${yupiik.slides.source}.\nsynchronizationFolders (List)\ntargetDirectory (java.io.File)\nWhere to render the slide deck. Default value: ${project.build.directory}/yupiik/slides. Property: ${yupiik.slides.target}.\ntemplateDirs (java.io.File)\nTemplate directory if set. Property: ${yupiik.slides.templateDirs}.\nwatchDelay (int)\nHow long to wait to check if render must be re-done in watch mode (in ms). Default value: 150. Property: ${yupiik.slides.watchDelay}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:slides","url":"/tools-maven-plugin/mojo/slides.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nFetch versions of the defined artifacts on a nexus and ensures it is set as github release artifacts.\nTo call this goal from the command line execute: mvn yupiik-tools:synchronize-github-releases.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:synchronize-github-releases@my-execution command.\nartifacts (List)\nProperty: ${yupiik.synchronize-github-releases.artifacts}.\nattachIfExists (boolean)\nDefault value: false. Property: ${yupiik.synchronize-github-releases.attachIfExists}.\ndryRun (boolean)\nProperty: ${yupiik.synchronize-github-releases.dryRun}.\nforce (boolean)\nDefault value: false. Property: ${yupiik.synchronize-github-releases.force}.\nforceHttpV1 (boolean)\nDefault value: true. Property: ${yupiik.synchronize-github-releases.forceHttpV1}.\ngithubBaseApi (String)\nDefault value: . Property: ${yupiik.synchronize-github-releases.githubRepository}.\ngithubRepository (String)\nProperty: ${yupiik.synchronize-github-releases.githubRepository}.\ngithubServerId (String)\nDefault value: github.com. Property: ${yupiik.synchronize-github-releases.githubServerId}.\nmavenRepositoryBaseUrl (String)\nDefault value: . Property: ${yupiik.synchronize-github-releases.mavenRepositoryBaseUrl}.\nnexusServerId (String)\nProperty: ${yupiik.synchronize-github-releases.nexusServerId}.\ntagPattern (String)\nProperty: ${yupiik.synchronize-github-releases.tagPattern}.\nthreads (int)\nDefault value: 16. Property: ${yupiik.synchronize-github-releases.threads}.\nworkdir (String)\nDefault value: ${project.build.directory}/synchronize-github-releases-workdir. Property: ${yupiik.synchronize-github-releases.workdir}.","title":"yupiik-tools:synchronize-github-releases","url":"/tools-maven-plugin/mojo/synchronize-github-releases.html"},{"lang":"en","lvl2":"Coordinates\nConfiguration","text":"\nCustom attributes. By default _partials and images folders are set to partialsdir and imagesdir attributes.\nTo call this goal from the command line execute: mvn yupiik-tools:watch-pdf.\nTo bind this goal in the build you can use:\nYou can execute this goal particularly with mvn yupiik-tools:watch-pdf@my-execution command.\nattributes (Map)\npauseBetweenChecks (long)\nHow long to pause between two check to see if sources must be re-rendered. Default value: 1000. Property: ${yupiik.pdf.pauseBetweenChecks}.\nrequires (List)\nsourceDirectory (java.io.File)\nSource directory or file to render, if a directory all files with extension .adoc will be selected. Default value: ${project.basedir}/src/main/pdf. Property: ${yupiik.pdf.source}.\ntargetDirectory (java.io.File)\nWhere to render the asciidoc files to. Default value: ${project.build.directory}/yupiik/pdf. Property: ${yupiik.pdf.target}.\nthemeDir (java.io.File)\nTheme directory (name of the theme is yupiik), let it null to inherit from the default theme. Property: ${yupiik.pdf.themeDir}.\nworkDir (java.io.File)\nWhere to extract files needed for the rendering. Default value: ${project.build.directory}/yupiik-workdir. Property: ${yupiik.workDir}.","title":"yupiik-tools:watch-pdf","url":"/tools-maven-plugin/mojo/watch-pdf.html"}]
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index a3e5220d..64107095 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -9,11 +9,11 @@
         <lastmod>2024-02-12</lastmod>
     </url>
     <url>
-        <loc>/tools-maven-plugin/mojos.html</loc>
+        <loc>/tools-maven-plugin/cli.html</loc>
         <lastmod>2024-02-12</lastmod>
     </url>
     <url>
-        <loc>/tools-maven-plugin/cli.html</loc>
+        <loc>/tools-maven-plugin/mojos.html</loc>
         <lastmod>2024-02-12</lastmod>
     </url>
     <url>
diff --git a/yem.html b/yem.html
index 14fecbcb..68066aab 100644
--- a/yem.html
+++ b/yem.html
@@ -475,7 +475,25 @@ <h3>Commands</h3>
  <ul>
   <li>
  <div class="paragraph">
- <p>Parameters: * --delete-provider: Provider to use to delete the version (if not t is deduced from the tool/version parameters). * --delete-tool: Tool to delete. * --delete-version: Version of <code>tool</code> to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance.</p>
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <p>
+--delete-provider: Provider to use to delete the version (if not t is deduced from the tool/version parameters).
+ </p>
+  </li>
+  <li>
+ <p>
+--delete-tool: Tool to delete.
+ </p>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--delete-version: Version of <code>tool</code> to delete - we recommend to use the actual identifier to avoid to delete more than the expected instance.</p>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
  </ul>
@@ -488,7 +506,35 @@ <h3>Commands</h3>
  <ul>
   <li>
  <div class="paragraph">
- <p>Parameters: * --env-defaultRc: Should <code>~/.yupiik/yem/rc</code> be ignored or not. If present it defines default versions and uses the same syntax than <code>yemrc</code>. * --env-enableAutoDetection: EXPERIMENTAL. If enabled and no <code>.yemrc</code> nor <code>.sdkmanrc</code> setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a <code>pom.xml</code> and the compiler version can be extracted for example) and Maven (<code>pom.xml</code> presence). Note that it is done using <code>./</code> folder and bubbles up with a max of 10 levels. * --env-inlineRc: Enables to set inline a rc file, ex: <code>eval $(yem env --inlineRc 'java.version=17.0.9')</code>, you can use EOL too: `eval $(yem env --inlineRc 'java.version=17. java.relaxed = true')<code>. Note that to persist the change even if you automatically switch from the global</code>yemrc<code>file the context, we set</code>YEM<i>$TOOLPATHVARNAME</i>OVERRIDEN<code>environment variable. To reset the value to the global configuration just</code>unset<code>this variable (ex:</code>unset YEM<i>JAVA</i>PATH_OVERRIDEN<code>). Note that you can also just set the values inline as args without that option:</code>eval $(yem env --java-version 17. --java-relaxed true ...)`. * --env-rc: Env file location to read to generate the script. Note that <code>auto</code> will try to pick <code>.yemrc</code> and if not there will use <code>.sdkmanrc</code> if present. * --env-skipReset: By default if <code>YEM_ORIGINAL_PATH</code> exists in the environment variables it is used as <code>PATH</code> base to not keep appending path to the <code>PATH</code> indefinively. This can be disabled setting this property to <code>false</code></p>
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <div class="paragraph">
+ <p>--env-defaultRc: Should <code>~/.yupiik/yem/rc</code> be ignored or not. If present it defines default versions and uses the same syntax than <code>yemrc</code>.</p>
+ </div>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--env-enableAutoDetection: EXPERIMENTAL. If enabled and no <code>.yemrc</code> nor <code>.sdkmanrc</code> setup any tool (ie empty does not count) then try to detect some well known tools like Java (there is a <code>pom.xml</code> and the compiler version can be extracted for example) and Maven (<code>pom.xml</code> presence). Note that it is done using <code>./</code> folder and bubbles up with a max of 10 levels.</p>
+ </div>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--env-inlineRc: Enables to set inline a rc file, ex: <code>eval $(yem env --inlineRc 'java.version=17.0.9')</code>, you can use EOL too: `eval $(yem env --inlineRc 'java.version=17. java.relaxed = true')<code>. Note that to persist the change even if you automatically switch from the global</code>yemrc<code>file the context, we set</code>YEM<i>$TOOLPATHVARNAME</i>OVERRIDEN<code>environment variable. To reset the value to the global configuration just</code>unset<code>this variable (ex:</code>unset YEM<i>JAVA</i>PATH_OVERRIDEN<code>). Note that you can also just set the values inline as args without that option:</code>eval $(yem env --java-version 17. --java-relaxed true ...)`.</p>
+ </div>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--env-rc: Env file location to read to generate the script. Note that <code>auto</code> will try to pick <code>.yemrc</code> and if not there will use <code>.sdkmanrc</code> if present.</p>
+ </div>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--env-skipReset: By default if <code>YEM_ORIGINAL_PATH</code> exists in the environment variables it is used as <code>PATH</code> base to not keep appending path to the <code>PATH</code> indefinively. This can be disabled setting this property to <code>false</code></p>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
  </ul>
@@ -500,10 +546,28 @@ <h3>Commands</h3>
 http: Show configuration in a web browser. <div class="ulist">
  <ul>
   <li>
+ <div class="paragraph">
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <p>
+--http-address: Binding address.
+ </p>
+  </li>
+  <li>
  <p>
-Parameters: * --http-address: Binding address. * --http-open: Should the server be opened ASAP if possible on your system or just the server be launched. * --http-port: Port to open the server to, by default it is random.
+--http-open: Should the server be opened ASAP if possible on your system or just the server be launched.
  </p>
   </li>
+  <li>
+ <p>
+--http-port: Port to open the server to, by default it is random.
+ </p>
+  </li>
+ </ul>
+ </div>
+ </div>
+  </li>
  </ul>
  </div>
  </div>
@@ -514,7 +578,35 @@ <h3>Commands</h3>
  <ul>
   <li>
  <div class="paragraph">
- <p>Parameters: * --install-provider: Provider to use to install the version (if not t is deduced from the tool/version parameters). * --install-relaxed: Should version be matched with a <code>startsWith</code> logic (ex: <code>install --install-tool java --install-relaxed true --install-version 21.</code>). * --install-skipProgress: Should progress bar be skipped (can be useful on CI for example). * --install-tool: Tool to install. * --install-version: Version of <code>tool</code> to install.</p>
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <p>
+--install-provider: Provider to use to install the version (if not t is deduced from the tool/version parameters).
+ </p>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--install-relaxed: Should version be matched with a <code>startsWith</code> logic (ex: <code>install --install-tool java --install-relaxed true --install-version 21.</code>).</p>
+ </div>
+  </li>
+  <li>
+ <p>
+--install-skipProgress: Should progress bar be skipped (can be useful on CI for example).
+ </p>
+  </li>
+  <li>
+ <p>
+--install-tool: Tool to install.
+ </p>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--install-version: Version of <code>tool</code> to install.</p>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
  </ul>
@@ -526,25 +618,46 @@ <h3>Commands</h3>
 list: List remote (available) distributions. <div class="ulist">
  <ul>
   <li>
+ <div class="paragraph">
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <p>
+--list-providers: List of providers to use (comma separated).
+ </p>
+  </li>
+  <li>
  <p>
-Parameters: * --list-providers: List of providers to use (comma separated). * --list-tools: List of tools to list (comma separated).
+--list-tools: List of tools to list (comma separated).
  </p>
   </li>
  </ul>
  </div>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
   <li>
  <div class="paragraph">
 list-local: List local available distributions. <div class="ulist">
+ <ul>
+  <li>
+ <div class="paragraph">
+Parameters: <div class="ulist">
  <ul>
   <li>
  <p>
-Parameters: * --list-local-tool: Tool to filter.
+--list-local-tool: Tool to filter.
  </p>
   </li>
  </ul>
  </div>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
   <li>
@@ -558,7 +671,30 @@ <h3>Commands</h3>
  <ul>
   <li>
  <div class="paragraph">
- <p>Parameters: * --resolve-provider: Provider to use to resolve the version (if not t is deduced from the tool/version parameters). * --resolve-relaxed: Should version be matched with a <code>startsWith</code> logic (ex: <code>resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.</code>). * --resolve-tool: Tool to resolve. * --resolve-version: Version of <code>tool</code> to resolve.</p>
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <p>
+--resolve-provider: Provider to use to resolve the version (if not t is deduced from the tool/version parameters).
+ </p>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--resolve-relaxed: Should version be matched with a <code>startsWith</code> logic (ex: <code>resolve --resolve-tool java --resolve-relaxed true --resolve-version 21.</code>).</p>
+ </div>
+  </li>
+  <li>
+ <p>
+--resolve-tool: Tool to resolve.
+ </p>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--resolve-version: Version of <code>tool</code> to resolve.</p>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
  </ul>
@@ -571,7 +707,20 @@ <h3>Commands</h3>
  <ul>
   <li>
  <div class="paragraph">
- <p>Parameters: * --run-defaultRc: Should <code>~/.yupiik/yem/rc</code> be ignored or not. If present it defines default versions and uses the same syntax than <code>yemrc</code>. * --run-rc: Env file location to read to generate the script. Note that <code>auto</code> will try to pick <code>.yemrc</code> and if not there will use <code>.sdkmanrc</code> if present.</p>
+Parameters: <div class="ulist">
+ <ul>
+  <li>
+ <div class="paragraph">
+ <p>--run-defaultRc: Should <code>~/.yupiik/yem/rc</code> be ignored or not. If present it defines default versions and uses the same syntax than <code>yemrc</code>.</p>
+ </div>
+  </li>
+  <li>
+ <div class="paragraph">
+ <p>--run-rc: Env file location to read to generate the script. Note that <code>auto</code> will try to pick <code>.yemrc</code> and if not there will use <code>.sdkmanrc</code> if present.</p>
+ </div>
+  </li>
+ </ul>
+ </div>
  </div>
   </li>
  </ul>