From ee74edbbb1c2fd2264f8ef8c85903c258b76ec2b Mon Sep 17 00:00:00 2001
From: Oleksiy Syvokon <oleksiy@zed.dev>
Date: Sat, 26 Apr 2025 09:52:02 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20Add=20=E2=80=B9=E2=80=BA=20navigation?=
 =?UTF-8?q?=20buttons=20(#29461)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

While visually unintrusive, these navigation links enable proper
navigation in readers and extensions like Vimium that rely on
rel=next/prev

Release Notes:

- N/A
---
 docs/theme/css/chrome.css | 30 ++++++++++++++++++++++++++++++
 docs/theme/index.hbs      | 17 +++++++++++++++++
 2 files changed, 47 insertions(+)

diff --git a/docs/theme/css/chrome.css b/docs/theme/css/chrome.css
index 79021bb5a148ae928741a8aeeeb9bff84f408e1c..8e5c286a067b01face7c884082cabbde62270dc8 100644
--- a/docs/theme/css/chrome.css
+++ b/docs/theme/css/chrome.css
@@ -177,6 +177,36 @@ a > .hljs {
   display: none;
 }
 
+.nav-wrapper {
+  margin-block-start: 50px;
+  display: block;
+}
+
+.nav-buttons {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin: 20px 0;
+  padding: 0 10px;
+}
+
+.nav-button {
+  align-items: center;
+  padding: 8px 12px;
+  background-color: var(--bg);
+  color: var(--fg) !important;
+  text-decoration: none;
+}
+
+.nav-button:hover {
+  background-color: var(--theme-hover);
+  color: var(--icons-hover) !important;
+}
+
+.nav-button i {
+  padding: 0 6px;
+}
+
 .mobile-nav-chapters {
   font-size: 2.5em;
   text-align: center;
diff --git a/docs/theme/index.hbs b/docs/theme/index.hbs
index c6171d74ade31f5bdfa645bb8c5c09e03ab12220..ca873fa4e6beac9c23cf2f5a0db4ff728641bc8e 100644
--- a/docs/theme/index.hbs
+++ b/docs/theme/index.hbs
@@ -200,6 +200,23 @@
                       </div>
                       {{{ content }}}
                     </main>
+
+                    <!-- Navigation arrows -->
+                    <div class="nav-wrapper">
+                      <div class="nav-buttons">
+                        {{#previous}}
+                          <a rel="prev" href="{{link}}" class="nav-button" title="{{title}}" aria-label="Previous chapter">
+                            <i class="fa fa-angle-left"></i>
+                          </a>
+                        {{/previous}}
+
+                        {{#next}}
+                          <a rel="next" href="{{link}}" class="nav-button" title="{{title}}" aria-label="Next chapter">
+                            <i class="fa fa-angle-right"></i>
+                          </a>
+                        {{/next}}
+                      </div>
+                    </div>
                 </div>
             </div>
         </div>