fetch-external-docs: Fix HABPanel docs migration & Adjust HABot sidebar entry to reference to add-on docs

Signed-off-by: Florian Hotze <dev@florianhotze.com>

Author: florian-h05

scripts/fetch-external-content.rb

@@ -134,12 +134,12 @@ def main
   # HABPanel Config Docs
   copy_file_safe(
     File.join(RESOURCE_FOLDER, "openhab-webui/bundles/org.openhab.ui.habpanel/doc/habpanel.md"),
-    File.join(BASE_DIR, "docs/configuration/habpanel.md"),
+    File.join(BASE_DIR, "docs/ui/habpanel/habpanel.md"),
     "https://github.com/openhab/openhab-webui/blob/main/bundles/org.openhab.ui.habpanel/doc/habpanel.md"
   )
   copy_dir_safe(
     File.join(RESOURCE_FOLDER, "openhab-webui/bundles/org.openhab.ui.habpanel/doc/images"),
-    File.join(BASE_DIR, "docs/configuration/images")
+    File.join(BASE_DIR, "docs/ui/habpanel/images")
   )
 
   # openHABian Install Docs (excluding NEWSLOG.md)
@@ -219,10 +219,10 @@ def main
     process_directory(
       src: ui_components_src,
       dst: ui_components_dst,
-      source_root: "https://github.com/openhab/openhab-webui/blob/main/bundles/org.openhab.ui/doc/components"
+      source_root: "https://github.com/openhab/openhab-webui/blob/main/bundles/org.openhab.ui/doc/components",
     ) { |path| !path.to_s.split(File::SEPARATOR).include?("src") }
 
-    puts "    ✔ Copied and processed UI components reference documentation"
+    puts "    ✔ Copied UI components reference documentation"
   else
     warn "    ⚠️ UI components source directory does not exist: #{ui_components_src}"
   end

scripts/lib/add_placeholders.rb

@@ -13,12 +13,9 @@ def add_placeholder_pages
     "docs/apps/android.md",
     "docs/apps/garmin",
     "docs/apps/sailfishos",
-    "docs/configuration/habpanel",
     "docs/configuration/iconsets/classic",
     "docs/ui/components/index.md",
-    "docs/ui/habpanel",
     "docs/ui/habpanel/habpanel.md",
-    "docs/ui/habot",
     "docs/ui/basic",
     "docs/ecosystem/alexa",
     "docs/ecosystem/google-assistant",

scripts/lib/process_utils.rb

@@ -154,7 +154,7 @@ def process_markdown(indir, file, outdir, source, outfile = nil)
       line.gsub!(%r{https?://(?:www\.)?openhab\.org/docs/}, "/docs/")
 
       # Log these replacements as they indicate issues in the source that should be fixed
-      log_replace.call(%r{https?://docs\.openhab\.org/addons/uis/habpanel/readme\.html}, "/docs/configuration/habpanel.html")
+      log_replace.call(%r{https?://docs\.openhab\.org/addons/uis/habpanel/readme\.html}, "/docs/ui/habpanel/habpanel.html")
       log_replace.call(%r{https?://docs\.openhab\.org/addons/uis/basic/readme\.html}, "/addons/ui/basic/")
       log_replace.call(%r{https?://docs\.openhab\.org/addons/(.*)/(.*)/readme\.html}, '/addons/\1/\2/')
       log_replace.call(%r{https?://docs\.openhab\.org/}, "/docs/")
@@ -204,6 +204,7 @@ def process_markdown(indir, file, outdir, source, outfile = nil)
 # @param src [String, Pathname] the source directory to copy from
 # @param dst [String, Pathname] the destination directory to copy to
 # @param source_root [String, nil] the GitHub URL prefix used for edit links
+# @param process_md [Boolean] whether to process markdown files (true) or just copy them directly (false)
 # @yield [Pathname] an optional block to filter which files to process (receives the Pathname of each file)
 # @yieldreturn [Boolean] whether to process the file (true) or skip it (false)
 #

scripts/prepare-docs.rb

@@ -8,14 +8,8 @@
 SRC_ROOT = "src"
 DST_ROOT = "docs"
 
-clean = !ARGV.include?("--no-clean")
 placeholders = !ARGV.include?("--no-placeholders")
 
-if clean
-  puts "🧹 Cleaning destination directory: #{DST_ROOT}"
-  FileUtils.rm_rf(DST_ROOT)
-end
-
 puts "➡️ Deploying the main documentation pages"
 process_directory src: SRC_ROOT, dst: DST_ROOT, source_root: "https://github.com/openhab/openhab-docs/blob/main/src"