From 611ff47c73a0f4a926951307b6390267550fb50b Mon Sep 17 00:00:00 2001
From: David Irvine <david.irvine@maidsafe.net>
Date: Sun, 29 Dec 2024 11:37:45 +0000
Subject: [PATCH] docs: fix code block styling and broken documentation links

---
 docs/api/nodejs/README.md  |  6 +--
 docs/api/python/README.md  |  6 +--
 docs/api/rust/README.md    |  6 +--
 docs/stylesheets/extra.css | 82 +++++++++++++++++++++++++++++++++++---
 4 files changed, 85 insertions(+), 15 deletions(-)

diff --git a/docs/api/nodejs/README.md b/docs/api/nodejs/README.md
index a74f119c0a..ac69209d0d 100644
--- a/docs/api/nodejs/README.md
+++ b/docs/api/nodejs/README.md
@@ -409,8 +409,8 @@ interface Client {
 
 ## Further Reading
 
-- [Web Development Guide](../guides/web_development.md)
-- [Quantum Security Details](../guides/quantum_security.md)
-- [Advanced Error Handling](../guides/error_handling.md)
+- [Web Development Guide](/guides/web_development)
+- [Quantum Security Guide](/guides/quantum_security)
+- [Error Handling Guide](/guides/error_handling)
 - [API Reference](https://autonomi.dev/api)
 - [Examples Repository](https://github.com/autonomi/examples)
diff --git a/docs/api/python/README.md b/docs/api/python/README.md
index 2779969abf..e0d870051a 100644
--- a/docs/api/python/README.md
+++ b/docs/api/python/README.md
@@ -374,8 +374,8 @@ def update_pointer(self, address: Address, target: Address) -> None: ...
 
 ## Further Reading
 
-- [Data Science Guide](../guides/data_science.md)
-- [Quantum Security Details](../guides/quantum_security.md)
-- [Advanced Error Handling](../guides/error_handling.md)
+- [Data Science Guide](/guides/data_science)
+- [Quantum Security Guide](/guides/quantum_security)
+- [Error Handling Guide](/guides/error_handling)
 - [API Reference](https://autonomi.readthedocs.io)
 - [Examples Repository](https://github.com/autonomi/examples)
diff --git a/docs/api/rust/README.md b/docs/api/rust/README.md
index bd83f012b8..5d61d5be14 100644
--- a/docs/api/rust/README.md
+++ b/docs/api/rust/README.md
@@ -328,8 +328,8 @@ client.update_pointers_batch(updates).await?;
 
 ## Further Reading
 
-- [Rust Performance Guide](../guides/rust_performance.md)
-- [Quantum Security Details](../guides/quantum_security.md)
-- [Advanced Error Handling](../guides/error_handling.md)
+- [Rust Performance Guide](/guides/rust_performance)
+- [Quantum Security Guide](/guides/quantum_security)
+- [Error Handling Guide](/guides/error_handling)
 - [API Reference](https://docs.rs/autonomi)
 - [Examples Repository](https://github.com/autonomi/examples)
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index 894693eade..42ad9abc45 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -50,17 +50,87 @@ body {
 
 /* Code Blocks */
 .md-typeset pre {
-    background-color: #1a1a1a;
-    border-radius: 8px;
-    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+    background-color: #f8f9fa !important;
+    color: #212529 !important;
 }
 
 .md-typeset code {
-    background-color: rgba(98, 0, 238, 0.1);
-    border-radius: 4px;
-    padding: 0.2em 0.4em;
+    background-color: #f8f9fa !important;
+    color: #212529 !important;
+}
+
+/* Syntax highlighting for light mode */
+.highlight .k {
+    color: #0033b3 !important;
+}
+
+/* Keyword */
+.highlight .s {
+    color: #067d17 !important;
+}
+
+/* String */
+.highlight .n {
+    color: #000000 !important;
+}
+
+/* Name */
+.highlight .c {
+    color: #8c8c8c !important;
+}
+
+/* Comment */
+.highlight .o {
+    color: #000000 !important;
+}
+
+/* Operator */
+.highlight .p {
+    color: #000000 !important;
+}
+
+/* Punctuation */
+.highlight .m {
+    color: #1750eb !important;
 }
 
+/* Number */
+.highlight .f {
+    color: #0033b3 !important;
+}
+
+/* Function */
+.highlight .kc {
+    color: #0033b3 !important;
+}
+
+/* Keyword.Constant */
+.highlight .kd {
+    color: #0033b3 !important;
+}
+
+/* Keyword.Declaration */
+.highlight .na {
+    color: #000000 !important;
+}
+
+/* Name.Attribute */
+.highlight .nb {
+    color: #0033b3 !important;
+}
+
+/* Name.Builtin */
+.highlight .nc {
+    color: #000000 !important;
+}
+
+/* Name.Class */
+.highlight .nf {
+    color: #000000 !important;
+}
+
+/* Name.Function */
+
 /* Navigation */
 .md-nav__link:hover {
     color: var(--md-accent-fg-color);