fix: improve pandoc highlight style compatibility and add robust fallback for markdown conversion

Author: hghalebi

.github/workflows/docs.yml

@@ -491,60 +491,59 @@ jobs:
             <div class="container">
         EOF
         
-        # Convert markdown to beautiful HTML using pandoc
-        if [ -f "mcp_rust_tutorial.md" ]; then
-          echo "Converting tutorial markdown to beautiful HTML..."
-          pandoc mcp_rust_tutorial.md \
-            -f markdown+smart+pipe_tables+fenced_code_blocks+definition_lists \
-            -t html5 \
-            --standalone \
-            --toc \
-            --toc-depth=4 \
-            --section-divs \
-            --html-q-tags \
-            --highlight-style=github \
-            --template=target/doc/tutorials/template.html \
-            -o target/doc/tutorials/mcp_rust_tutorial.html \
-            --metadata title="MCP Rust Tutorial - Complete Learning Resource"
-          
-          # Add closing tags
-          echo '</div><div class="footer">🦀 <strong>MCP Rust Tutorial</strong> | Built with ❤️ for the Rust Community</div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
-          
-          echo "✅ Beautiful tutorial HTML created successfully!"
-        else
-          echo "⚠️ Tutorial markdown not found, creating placeholder..."
-          cat target/doc/tutorials/template.html > target/doc/tutorials/mcp_rust_tutorial.html
-          echo '<h1>🚧 Tutorial Coming Soon</h1><p>The comprehensive MCP Rust tutorial will be available soon.</p></div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
-        fi
+                          # Convert markdown to beautiful HTML using pandoc
+         if [ -f "mcp_rust_tutorial.md" ]; then
+           echo "Converting tutorial markdown to beautiful HTML..."
+           
+           # Try pandoc with advanced features first
+           if pandoc mcp_rust_tutorial.md \
+             -f markdown+smart+pipe_tables+fenced_code_blocks+definition_lists \
+             -t html5 \
+             --standalone \
+             --toc \
+             --toc-depth=4 \
+             --section-divs \
+             --html-q-tags \
+             --highlight-style=tango \
+             --template=target/doc/tutorials/template.html \
+             -o target/doc/tutorials/mcp_rust_tutorial.html \
+             --metadata title="MCP Rust Tutorial - Complete Learning Resource" 2>/dev/null; then
+             
+             # Add closing tags
+             echo '</div><div class="footer">🦀 <strong>MCP Rust Tutorial</strong> | Built with ❤️ for the Rust Community</div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
+             echo "✅ Beautiful tutorial HTML created successfully with pandoc!"
+           
+           else
+             echo "⚠️ Pandoc failed, trying simpler conversion..."
+             # Fallback to basic pandoc conversion
+             if pandoc mcp_rust_tutorial.md \
+               -f markdown \
+               -t html5 \
+               --standalone \
+               --toc \
+               --template=target/doc/tutorials/template.html \
+               -o target/doc/tutorials/mcp_rust_tutorial.html 2>/dev/null; then
+               
+               echo '</div><div class="footer">🦀 <strong>MCP Rust Tutorial</strong> | Built with ❤️ for the Rust Community</div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
+               echo "✅ Tutorial HTML created with basic pandoc conversion!"
+             
+             else
+               echo "⚠️ Pandoc conversion failed, creating manual HTML..."
+               # Manual HTML creation as ultimate fallback
+               cat target/doc/tutorials/template.html > target/doc/tutorials/mcp_rust_tutorial.html
+               # Use a simple Python one-liner for markdown conversion
+               python3 -c "import markdown; print(markdown.markdown(open('mcp_rust_tutorial.md').read(), extensions=['toc', 'codehilite', 'tables']))" >> target/doc/tutorials/mcp_rust_tutorial.html
+               echo '</div><div class="footer">🦀 <strong>MCP Rust Tutorial</strong> | Built with ❤️ for the Rust Community</div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
+               echo "✅ Tutorial HTML created with Python markdown!"
+             fi
+           fi
+         else
+           echo "⚠️ Tutorial markdown not found, creating placeholder..."
+           cat target/doc/tutorials/template.html > target/doc/tutorials/mcp_rust_tutorial.html
+           echo '<h1>🚧 Tutorial Coming Soon</h1><p>The comprehensive MCP Rust tutorial will be available soon.</p></div></body></html>' >> target/doc/tutorials/mcp_rust_tutorial.html
+         fi
         
-        # Create a CSS file for tutorials
-        cat > target/doc/tutorials/tutorial-style.css << 'EOF'
-        /* Additional styles for tutorial content */
-        .tutorial-content {
-            max-width: none;
-        }
-        .highlight {
-            background-color: #fff3cd;
-            border: 1px solid #ffeaa7;
-            border-radius: 4px;
-            padding: 15px;
-            margin: 20px 0;
-        }
-        .note {
-            background-color: #d4edda;
-            border: 1px solid #c3e6cb;
-            border-radius: 4px;
-            padding: 15px;
-            margin: 20px 0;
-        }
-        .warning {
-            background-color: #f8d7da;
-            border: 1px solid #f1b2b7;
-            border-radius: 4px;
-            padding: 15px;
-            margin: 20px 0;
-        }
-        EOF
+
     
     # Step 5.6: Create additional navigation and utility pages
     - name: Create site navigation and utilities

mcp-rust-examples-linux-x64.tar.gz

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_01_hello_world: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_01_hello_world.rs

release-binaries/example_01_hello_world

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_02_calculator: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_02_calculator.rs

release-binaries/example_01_hello_world.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_03_text_processor: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_03_text_processor.rs

release-binaries/example_02_calculator

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_04_simple_client: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_04_simple_client.rs

release-binaries/example_02_calculator.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_05_resource_provider: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_05_resource_provider.rs

release-binaries/example_03_text_processor

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_06_configurable_server: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_06_configurable_server.rs

release-binaries/example_03_text_processor.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_07_file_operations: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_07_file_operations.rs

release-binaries/example_04_simple_client

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_08_http_client: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_08_http_client.rs

release-binaries/example_04_simple_client.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_09_database: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_09_database.rs

release-binaries/example_05_resource_provider

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_10_streaming: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_10_streaming.rs

release-binaries/example_05_resource_provider.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_11_monitoring: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_11_monitoring.rs

release-binaries/example_06_configurable_server

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_12_task_queue: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_12_task_queue.rs

release-binaries/example_06_configurable_server.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_13_auth_service: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_13_auth_service.rs

release-binaries/example_07_file_operations

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_14_notification_service: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_14_notification_service.rs

release-binaries/example_07_file_operations.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_15_data_pipeline: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_15_data_pipeline.rs

release-binaries/example_08_http_client

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_16_search_service: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_16_search_service.rs

release-binaries/example_08_http_client.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_17_blockchain_integration: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_17_blockchain_integration.rs

release-binaries/example_09_database

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_18_ml_model_server: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_18_ml_model_server.rs

release-binaries/example_09_database.d

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_19_microservice_gateway: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_19_microservice_gateway.rs

release-binaries/example_10_streaming

@@ -0,0 +1 @@
+/Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/target/x86_64-unknown-linux-gnu/release/example_20_enterprise_server: /Users/hamzeghalebi/projects/learning/rust/llms/mcps/tutorial/src/examples/example_20_enterprise_server.rs