blaat

Author: To1ne

script/update-docs.rb

@@ -15,6 +15,10 @@
 DATA_FILE = "#{SITE_ROOT}external/docs/data/docs.yml"
 DOCS_EXTRA_FILE = "#{SITE_ROOT}data/docs_extra.yml"
 
+def doc_ext(version)
+  Version.version_to_num(version) < 2_490_000 ? 'txt' : 'adoc'
+end
+
 def read_data
   if File.exist?(DATA_FILE)
     # `permitted_classes` required to allow running with Ruby v3.1
@@ -97,8 +101,7 @@ def index_l10n_doc(filter_tags, doc_list, get_content)
     l10n["tree_sha"] = tree_sha
     l10n["committed"] = ts
 
-    ext = ts < Time.parse('2025-03-03 18:00:56 +0100') ? 'txt' : 'adoc'
-
+    ext = doc_ext(name)
     tag_files = doc_list.call(tree_sha)
     doc_files = tag_files.select do |ent|
       ent.first =~
@@ -324,7 +327,7 @@ def index_doc(filter_tags, doc_list, get_content)
     version_data["committed"] = ts
     version_data["date"] = ts.strftime("%Y-%m-%d")
 
-    ext = Version.version_to_num(version) < 2_490_000 ? 'txt' : 'adoc'
+    ext = doc_ext(version)
     tag_files = doc_list.call(tree_sha)
     doc_files = tag_files.select do |ent|
       ent.first =~
@@ -366,7 +369,7 @@ def index_doc(filter_tags, doc_list, get_content)
         end
       generated = cmd_list.keys.inject({}) do |list, category|
         links = cmd_list[category].map do |cmd, attr|
-          cmd_file = tag_files.detect { |ent| ent.first == "Documentation/#{cmd}.txt" }
+          cmd_file = tag_files.detect { |ent| ent.first == "Documentation/#{cmd}.#{ext}" }
           next unless cmd_file
 
           content = get_content.call(cmd_file[1])
@@ -376,7 +379,7 @@ def index_doc(filter_tags, doc_list, get_content)
             "linkgit:#{cmd}[#{section}]::\n\t#{attr == 'deprecated' ? '(deprecated) ' : ''}#{match[1]}\n"
           end
         end
-        list.merge!("Documentation/cmds-#{category}.txt" => links.compact.join("\n"))
+        list.merge!("Documentation/cmds-#{category}.#{ext}" => links.compact.join("\n"))
       end
 
       tools = tag_files.select { |ent| ent.first =~ /^mergetools\// }.map do |entry|
@@ -389,8 +392,8 @@ def index_doc(filter_tags, doc_list, get_content)
       end
 
       can_merge, can_diff = tools.transpose.map(&:join)
-      generated["Documentation/mergetools-diff.txt"] = can_diff
-      generated["Documentation/mergetools-merge.txt"] = can_merge
+      generated["Documentation/mergetools-diff.#{ext}"] = can_diff
+      generated["Documentation/mergetools-merge.#{ext}"] = can_merge
 
       get_content_f = proc do |name|
         content_file = tag_files.detect { |ent| ent.first == name }