Adds feature to use pipes and multi lines for plugin documentation

Author: LordHepipud

lib/core/framework/Publish-IcingaPluginDocumentation.psm1

@@ -126,10 +126,17 @@ function Publish-IcingaPluginDocumentation()
             foreach ($parameter in $PluginHelp.parameters.parameter) {
                 [string]$ParamDescription = $parameter.description.Text;
                 if ([string]::IsNullOrEmpty($ParamDescription) -eq $FALSE) {
-                    $ParamDescription = $ParamDescription.Replace("`r`n", ' ');
-                    $ParamDescription = $ParamDescription.Replace("`r", ' ');
-                    $ParamDescription = $ParamDescription.Replace("`n", ' ');
+                    $ReplacementString = '<br /> ';
+
+                    $ParamDescription = $ParamDescription.Replace("`r`n", $ReplacementString);
+                    $ParamDescription = $ParamDescription.Replace("`r", $ReplacementString);
+                    $ParamDescription = $ParamDescription.Replace("`n", $ReplacementString);
+
+                    if ($ParamDescription.Contains('|')) {
+                        $ParamDescription = $ParamDescription.Replace('|', '&#124;');
+                    }
                 }
+
                 [string]$TableContent = [string]::Format(
                     '| {0} | {1} | {2} | {3} | {4} |',
                     $parameter.name,

lib/core/tools/Get-IcingaCheckCommandConfig.psm1

@@ -376,11 +376,19 @@ function Get-IcingaCheckCommandConfig()
             $IcingaDataType = [string]::Format('Icinga\Module\Director\DataType\DataType{0}', $IcingaDataType)
 
             if ($Basket.Datafield.Values.varname -ne $IcingaCustomVariable) {
+                $DataFieldDescription = $parameter.Description.Text;
+
+                # Remove HTML code tags and replace them with markdown tags
+                if ([string]::IsNullOrEmpty($DataFieldDescription) -eq $FALSE) {
+                    $DataFieldDescription = $DataFieldDescription.Replace('<pre>', '```');
+                    $DataFieldDescription = $DataFieldDescription.Replace('</pre>', '```');
+                }
+
                 $Basket.Datafield.Add(
                     [string]$FieldID, @{
                         'varname'     = $IcingaCustomVariable;
                         'caption'     = $parameter.Name;
-                        'description' = $parameter.Description.Text;
+                        'description' = $DataFieldDescription;
                         'datatype'    = $IcingaDataType;
                         'format'      = $NULL;
                         'originalId'  = [string]$FieldID;