diff --git a/resources/asciidoctor/lib/chunker/extension.rb b/resources/asciidoctor/lib/chunker/extension.rb
index 75b29d5f4701..cd12b2639b8c 100644
--- a/resources/asciidoctor/lib/chunker/extension.rb
+++ b/resources/asciidoctor/lib/chunker/extension.rb
@@ -9,6 +9,7 @@
require_relative 'find_related'
require_relative 'footnotes'
require_relative 'nav'
+require_relative 'url_to_v3'
##
# HTML5 converter that chunks like docbook.
@@ -49,6 +50,7 @@ def convert_document(doc)
)
doc.attributes['next_section'] = find_next_in doc, 0
add_nav doc
+ add_url_to_v3 doc
yield
end
@@ -81,6 +83,11 @@ def add_nav(doc)
doc.blocks.append nav.footer
end
+ def add_url_to_v3(doc)
+ url_to_v3 = UrlToV3.new doc
+ doc.blocks.insert 0, url_to_v3.url
+ end
+
def correct_xref(node)
refid = node.attributes['refid']
return unless (ref = node.document.catalog[:refs][refid])
@@ -108,6 +115,8 @@ def form_section_into_page(doc, section, html)
def add_subdoc_sections(doc, subdoc, html)
nav = Nav.new subdoc
+ url_to_v3 = UrlToV3.new subdoc
+ subdoc << url_to_v3.url
subdoc << nav.header
subdoc << Asciidoctor::Block.new(subdoc, :pass, source: html)
subdoc << footnotes(doc, subdoc) if doc.footnotes?
@@ -143,6 +152,7 @@ def subdoc_attrs(doc, section)
attrs['subdoc'] = true # Mark the subdoc so we don't try and chunk it
attrs['title-separator'] = ''
attrs['canonical-url'] = section.attributes['canonical-url']
+ attrs['current-url'] = "#{section.id}.html"
attrs.merge! find_related(section)
attrs
end
diff --git a/resources/asciidoctor/lib/chunker/url_to_v3.rb b/resources/asciidoctor/lib/chunker/url_to_v3.rb
new file mode 100644
index 000000000000..916b6a411587
--- /dev/null
+++ b/resources/asciidoctor/lib/chunker/url_to_v3.rb
@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Chunker
+ # Add a warning to the page with a link to docs v3
+ class UrlToV3
+ attr_reader :url
+
+ def initialize(doc)
+ current_url = doc.attr('current-url')
+ outdir = doc.attr('outdir')
+ current_url ||= 'index.html'
+ m = mapping
+ # This only works in CI.
+ segments = outdir.sub('/tmp/docsbuild/target_repo/raw', '').split('/')
+ version = segments[-1] || 'unknown'
+ actual_url = get_actual_url(outdir, current_url)
+ new_url = if m.key?(actual_url)
+ m[actual_url]
+ else
+ '/docs'
+ end
+ render_warning(doc, version, new_url)
+ end
+
+ def mapping
+ file_path = File.expand_path('v3-mapping.json', __dir__)
+ JSON.parse(File.read(file_path)) if File.exist?(file_path)
+ end
+
+ def get_path_dir(outdir)
+ segments = outdir.sub('/tmp/docsbuild/target_repo/raw', '').split('/')
+ if segments.empty?
+ ''
+ elsif segments.length > 1
+ segments[0...-1].join('/')
+ else
+ segments[0]
+ end
+ end
+
+ def get_actual_url(outdir, current_url)
+ get_path_dir(outdir) + '/*/' + current_url
+ end
+
+ def render_warning(doc, version, new_url)
+ if version == '8.18'
+ @url = Asciidoctor::Block.new(doc, :pass, source: <<~HTML)
+
+ HTML
+ else
+ @url = Asciidoctor::Block.new(doc, :pass, source: <<~HTML)
+
+
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the
current release documentation
+