From 2340f1f2c5d95848ef6de73ae25143524489c134 Mon Sep 17 00:00:00 2001
From: Eric Lippmann <eric.lippmann@icinga.com>
Date: Thu, 24 Oct 2024 13:31:25 +0200
Subject: [PATCH] Fully support template files including template files

This update enables markdown files in the template directory to include other
files from the same directory, providing full support for Jinja templates.
Previously, when a file included another file that was naturally ordered before
it, the templates were already resolved due to in-place modifications. Now,
rather than modifying template files directly and renaming them later, they are
written to the target location instead.
---
 build-docs.rb | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/build-docs.rb b/build-docs.rb
index 90fefe0..385bcc0 100755
--- a/build-docs.rb
+++ b/build-docs.rb
@@ -103,7 +103,15 @@ def build_page_index(full_docs_dir, project_docs_dir, package = "", product = ""
         # Get everything after last slash
         subfile_name = subfile.match(/([^\/]+$)/)
         if(is_template_dir)
-          %x(./parse_template.py -D product "#{product}" -D package "#{package}" -D icingaDocs true "#{full_docs_dir}" "#{subfile_path.gsub(/^doc\//, '')}")
+          subdir_name = File.basename(file)
+          new_subdir_name = subdir_name.gsub(/\.md.d$/, '')
+
+          subdir = file.gsub(subdir_name, new_subdir_name)
+          FileUtils.mkdir_p(subdir) unless File.directory?(subdir)
+
+          subfile = subfile.gsub(subdir_name, new_subdir_name)
+
+          %x(./parse_template.py -o "#{subfile}" -D product "#{product}" -D package "#{package}" -D icingaDocs true "#{full_docs_dir}" "#{subfile_path.gsub(/^doc\//, '')}")
 
           content = File.read(subfile)
           # Adjust self references
@@ -112,9 +120,7 @@ def build_page_index(full_docs_dir, project_docs_dir, package = "", product = ""
           content = content.gsub(/\[(.*)\]\((?!http|#)(.*)\)/, '[\1](../\2)')
           File.write(subfile, content)
 
-          # Adjust path, the directory will be renamed soon
-          subdir_name = File.basename(file)
-          subfile_path = subfile_path.gsub(subdir_name, subdir_name.gsub(/\.md.d$/, ''))
+          subfile_path = subfile_path.gsub(subdir_name, new_subdir_name)
         end
   
         header = titleize(subfile_name[1]) unless File.symlink?(subfile)
@@ -138,7 +144,7 @@ def build_page_index(full_docs_dir, project_docs_dir, package = "", product = ""
 
         # Rename template directory to mimic template references
         newTemplateDirPath = file.gsub(/\.md.d$/, '')
-        File.rename(file, newTemplateDirPath)
+        FileUtils.rm_r(file)
 
         # Attempt to create a index file
         index_content = %x(./parse_template.py -o - -D index true #{full_docs_dir} #{template_path.gsub(/^doc\//, '')})