From d7618ccc44a1dfbd568af18f21c9ec4dd4c51c62 Mon Sep 17 00:00:00 2001
From: CrazyMax <crazy-max@users.noreply.github.com>
Date: Wed, 20 Jul 2022 12:46:43 +0200
Subject: [PATCH 1/2] jekyll: add include_remote plugin

Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
---
 _plugins/include_remote.rb | 54 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 _plugins/include_remote.rb

diff --git a/_plugins/include_remote.rb b/_plugins/include_remote.rb
new file mode 100644
index 0000000000..e0400aae01
--- /dev/null
+++ b/_plugins/include_remote.rb
@@ -0,0 +1,54 @@
+module Jekyll
+  class IncludeRemoteTag < Liquid::Tag
+    def initialize(tag_name, params, tokens)
+      @page, @line_start, @line_end = params.split
+      @line_start, @line_end = resolve_line_numbers(@line_start, @line_end)
+      super
+    end
+
+    def render(context)
+      site = context.registers[:site]
+      page = context.registers[:page]
+
+      beginning_time = Time.now
+      Jekyll.logger.info "Starting plugin include_remote.rb..."
+
+      if context[@page.strip]
+        @page = context[@page.strip]
+      end
+
+      inc = File.join("_includes", @page)
+      Jekyll.logger.info "  Inject #{inc} to #{page['path']}"
+
+      lines = File.readlines(inc)[@line_start..@line_end]
+
+      site.config['defaults'].each do |default|
+        if default['scope']['path'] == inc
+          page['edit_url'] = default['values']['edit_url']
+          page['issue_url'] = default['values']['issue_url']
+          Jekyll.logger.info "    edit_url:  #{page['edit_url']}"
+          Jekyll.logger.info "    issue_url: #{page['issue_url']}"
+          break
+        end
+      end
+
+      end_time = Time.now
+      Jekyll.logger.info "done in #{(end_time - beginning_time)} seconds"
+
+      lines.join
+    end
+
+    def resolve_line_numbers(first, last)
+      if first.nil? && last.nil?
+        first = 0
+        last  = -1
+      elsif last.nil?
+        last = first
+      end
+      [first.to_i, last.to_i]
+    end
+  end
+
+end
+
+Liquid::Template.register_tag('include_remote', Jekyll::IncludeRemoteTag)

From 57144bd5e2428037c547eaa2b0ccef5dbe150152 Mon Sep 17 00:00:00 2001
From: CrazyMax <crazy-max@users.noreply.github.com>
Date: Wed, 20 Jul 2022 12:48:34 +0200
Subject: [PATCH 2/2] dockerfile: create stub file with frontmatter

Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
---
 _config.yml                 |  2 +-
 engine/reference/builder.md | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)
 create mode 100644 engine/reference/builder.md

diff --git a/_config.yml b/_config.yml
index ae86b4f36b..631de42b46 100644
--- a/_config.yml
+++ b/_config.yml
@@ -179,6 +179,6 @@ fetch-remote:
     default_branch: "master"
     ref: "master"
     paths:
-      - dest: "engine/reference/builder.md"
+      - dest: "_includes/dockerfile/reference.md"
         src:
           - "frontend/dockerfile/docs/reference.md"
diff --git a/engine/reference/builder.md b/engine/reference/builder.md
new file mode 100644
index 0000000000..409b33121e
--- /dev/null
+++ b/engine/reference/builder.md
@@ -0,0 +1,10 @@
+---
+title: Dockerfile reference
+description: "Dockerfiles use a simple DSL which allows you to automate the steps you would normally manually take to create an image."
+keywords: build, dockerfile, reference
+toc_max: 3
+redirect_from:
+- /reference/builder/
+---
+
+{% include_remote dockerfile/reference.md 2 -1 -%}