dx: add edit links for docs and blog pages #265

Made-with: Cursor

Author: Shivampal157

mkdocs.yml

@@ -1,6 +1,10 @@
 site_name: Open Science Labs
 site_url: https://opensciencelabs.org
 
+# Repository / edit links (used to build "Edit this page on GitHub" URLs)
+repo_url: https://github.com/OpenScienceLabs/opensciencelabs.github.io
+edit_uri: edit/main/
+
 docs_dir: pages
 site_dir: build
 

theme/base.html

@@ -373,6 +373,16 @@ <h2 class="accordion-header" id="h-{{ pid }}">
                 {% block content_inner %}
                   {{ page.content }}
                 {% endblock content_inner %}
+
+                {# Inline "Edit this page on GitHub" helper. Uses MkDocs page.edit_url. #}
+                {% if page.edit_url %}
+                <div class="mt-4 edit-on-github">
+                  <a href="{{ page.edit_url }}" target="_blank" rel="noopener"
+                     class="edit-link small text-secondary">
+                    Found an issue? <span class="edit-link-text">Edit this page on GitHub ↗</span>
+                  </a>
+                </div>
+                {% endif %}
               </div>
             </div>
           </section>

theme/css/content.css

@@ -42,3 +42,14 @@ blockquote{
   display: grid; place-items: center;
 }
 .to_top .icon { width: 24px; height: 24px; }
+
+/* "Edit this page on GitHub" helper */
+.edit-on-github {
+  margin-top: 1.25rem;
+}
+.edit-on-github .edit-link {
+  text-decoration: none;
+}
+.edit-on-github .edit-link:hover {
+  text-decoration: underline;
+}