Merge pull request #2675 from 5long/opentofu

New docs: Opentofu

Author: simon04

assets/javascripts/news.json

@@ -1,4 +1,8 @@
 [
+  [
+    "2026-05-26",
+    "New documentation: <a href=\"/opentofu/\">OpenTofu</a>"
+  ],
   [
     "2026-02-14",
     "New documentation: <a href=\"/couchdb/\">CouchDB</a>"

assets/stylesheets/application.css.scss

@@ -88,6 +88,7 @@
 @use 'pages/octave';
 @use 'pages/openjdk';
 @use 'pages/openlayers';
+@use 'pages/opentofu';
 @use 'pages/perl';
 @use 'pages/phalcon';
 @use 'pages/phaser';

assets/stylesheets/pages/_opentofu.scss

@@ -0,0 +1,22 @@
+@use 'pages/simple';
+
+._opentofu {
+  .theme-code-block figure {
+    margin-inline-start: 0;
+  }
+
+  // "sr" means screen reader
+  .sr-only {
+    clip: rect(0,0,0,0);
+    border-width: 0;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    position: absolute;
+    width: 1px
+  }
+
+  .font-bold {
+    font-weight: var(--boldFontWeight);
+  }
+}

lib/docs/filters/opentofu/clean_html.rb

@@ -0,0 +1,30 @@
+module Docs
+  class Opentofu
+    class CleanHtmlFilter < Filter
+      def fix_syntax_highlight
+        css('pre').each do |node|
+          node['data-language'] = node['class'][/language-(\w+)/, 1] if node['class']
+          node.content = node.css('.token-line').map(&:content).join("\n")
+          node.remove_attribute('class')
+          node.remove_attribute('style')
+        end
+
+        css('[class*="buttonGroup_"]').remove
+      end
+
+      # Some SVG icons are just too big and not needed.
+      def remove_svg_icons
+        css('[role="alert"] svg').remove
+      end
+
+      def call
+        @doc = at_css("main article > .prose")
+
+        remove_svg_icons
+        fix_syntax_highlight
+
+        doc
+      end
+    end
+  end
+end

lib/docs/filters/opentofu/entries.rb

@@ -0,0 +1,21 @@
+module Docs
+  class Opentofu
+    class EntriesFilter < Docs::EntriesFilter
+      def get_name
+        at_css('main article h1').content
+      end
+
+      def get_type
+        segments = slug.split('/')
+        if segments[0..1] == ['language', 'functions']
+          # We have too many functions (120+ out of ~300 pages)
+          "Function"
+        elsif segments.first == 'cli'
+          "CLI"
+        else
+          segments.first.titlecase
+        end
+      end
+    end
+  end
+end

lib/docs/scrapers/opentofu.rb

@@ -0,0 +1,47 @@
+module Docs
+  class Opentofu < UrlScraper
+    self.name = 'OpenTofu'
+    self.type = 'opentofu'
+    self.links = {
+      home: 'https://opentofu.org/',
+    }
+
+    html_filters.push 'opentofu/entries', 'opentofu/clean_html'
+
+    # Empty spans are used by Prism for code highlighting.
+    # Don't clean them
+    options[:clean_text] = false
+    options[:trailing_slash] = true
+    # https://github.com/opentofu/opentofu/blob/main/LICENSE
+    options[:attribution] = <<-HTML
+      Copyright (c) The OpenTofu Authors<br>
+      Copyright (c) 2014 HashiCorp, Inc.<br>
+      Mozilla Public License, version 2.0
+    HTML
+
+    def get_latest_version(opts)
+      contents = get_latest_github_release('opentofu', 'opentofu', opts)
+      contents.sub("v", "")
+    end
+
+    version '1.12' do
+      self.release = '1.12.0'
+      self.base_url = "https://opentofu.org/docs/v#{self.version}/"
+    end
+
+    version '1.11' do
+      self.release = '1.11.5'
+      self.base_url = "https://opentofu.org/docs/v#{self.version}/"
+    end
+
+    version '1.10' do
+      self.release = '1.10.9'
+      self.base_url = "https://opentofu.org/docs/v#{self.version}/"
+    end
+
+    version '1.9' do
+      self.release = '1.9.4'
+      self.base_url = "https://opentofu.org/docs/v#{self.version}/"
+    end
+  end
+end

public/icons/docs/opentofu/16.png

@@ -0,0 +1,2 @@
+https://github.com/opentofu/opentofu.org/blob/main/static/favicons/favicon-16x16.png
+https://github.com/opentofu/opentofu.org/blob/main/static/favicons/favicon-32x32.png