Fix all broken links and baseurl issues - CSS/JS files and internal navigation now working correctly

Author: byerlikaya

docs/_config.yml

@@ -1,6 +1,6 @@
 title: SmartRAG Documentation
 description: A powerful and intelligent RAG library for .NET applications
-baseurl: ""
+baseurl: "/SmartRAG"
 url: "https://byerlikaya.github.io"
 
 # SEO and Search Engine Optimization

docs/_layouts/default.html

@@ -14,29 +14,29 @@
 
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="website">
-    <meta property="og:url" content="{{ site.url }}{{ page.url }}">
+    <meta property="og:url" content="{{ site.url }}{{ site.baseurl }}{{ page.url }}">
     <meta property="og:title" content="{% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %}">
     <meta property="og:description" content="{{ page.description | default: site.description }}">
-    <meta property="og:image" content="{{ site.url }}{{ page.image | default: site.image | default: '/assets/images/logo.svg' }}">
+    <meta property="og:image" content="{{ site.url }}{{ site.baseurl }}{{ page.image | default: site.image | default: '/assets/images/logo.svg' }}">
     <meta property="og:site_name" content="{{ site.title }}">
     <meta property="og:locale" content="en_US">
 
     <!-- Twitter -->
     <meta property="twitter:card" content="summary_large_image">
-    <meta property="twitter:url" content="{{ site.url }}{{ page.url }}">
+    <meta property="twitter:url" content="{{ site.url }}{{ site.baseurl }}{{ page.url }}">
     <meta property="twitter:title" content="{% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %}">
     <meta property="twitter:description" content="{{ page.description | default: site.description }}">
-    <meta property="twitter:image" content="{{ site.url }}{{ page.image | default: site.image | default: '/assets/images/logo.svg' }}">
+    <meta property="twitter:image" content="{{ site.url }}{{ site.baseurl }}{{ page.image | default: site.image | default: '/assets/images/logo.svg' }}">
     <meta property="twitter:creator" content="@{{ site.twitter.username }}">
 
     <!-- Canonical URL -->
-    <link rel="canonical" href="{{ site.url }}{{ page.url }}">
+    <link rel="canonical" href="{{ site.url }}{{ site.baseurl }}{{ page.url }}">
 
     <!-- Favicon and Icons -->
-    <link rel="icon" type="image/x-icon" href="/favicon.ico">
-    <link rel="apple-touch-icon" sizes="180x180" href="/assets/images/apple-touch-icon.png">
-    <link rel="icon" type="image/png" sizes="32x32" href="/assets/images/favicon-32x32.png">
-    <link rel="icon" type="image/png" sizes="16x16" href="/assets/images/favicon-16x16.png">
+    <link rel="icon" type="image/x-icon" href="{{ site.baseurl }}/favicon.ico">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ site.baseurl }}/assets/images/apple-touch-icon.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="{{ site.baseurl }}/assets/images/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="{{ site.baseurl }}/assets/images/favicon-16x16.png">
 
     <!-- Bootstrap 5 CSS -->
     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
@@ -60,7 +60,7 @@
         "@type": "SoftwareApplication",
         "name": "SmartRAG",
         "description": "{{ site.description }}",
-        "url": "{{ site.url }}",
+        "url": "{{ site.url }}{{ site.baseurl }}",
         "applicationCategory": "DeveloperApplication",
         "operatingSystem": ".NET",
         "programmingLanguage": "C#",

docs/api-reference.md

@@ -479,7 +479,7 @@ var chunkContent = content.Substring(validatedStart, validatedEnd - validatedSta
 
 ## 📝 Usage Examples
 
-See [Getting Started](getting-started.md) for complete usage examples and configuration.
+See [Getting Started]({{ site.baseurl }}/getting-started) for complete usage examples and configuration.
 
 ## 🆘 Support
 

docs/examples.md

@@ -291,9 +291,9 @@ public class DocumentServiceIntegrationTests : IClassFixture<TestWebApplicationF
 
 ## Next Steps
 
-- [Getting Started Guide](getting-started.md) - Learn the basics
-- [Configuration](configuration.md) - Configure your setup
-- [API Reference](api-reference.md) - Detailed API documentation
-- [Troubleshooting](troubleshooting.md) - Solve common issues
+- [Getting Started Guide]({{ site.baseurl }}/getting-started) - Learn the basics
+- [Configuration]({{ site.baseurl }}/configuration) - Configure your setup
+- [API Reference]({{ site.baseurl }}/api-reference) - Detailed API documentation
+- [Troubleshooting]({{ site.baseurl }}/troubleshooting) - Solve common issues
 
-For more examples and community contributions, visit our [GitHub repository](https://github.com/yourusername/SmartRAG).
+For more examples and community contributions, visit our [GitHub repository](https://github.com/byerlikaya/SmartRAG).

docs/getting-started.md

@@ -247,12 +247,12 @@ services.AddSmartRAG(configuration, options =>
 
 ## 🚀 Next Steps
 
-1. **[Choose Your AI Provider](configuration.md#ai-providers)** - Configure OpenAI, Anthropic, Gemini, etc.
-2. **[Select Storage Backend](configuration.md#storage-providers)** - Set up Qdrant, Redis, SQLite, etc.
-3. **[Upload Documents](api-reference.md#document-management)** - Learn about supported formats
-4. **[Ask Questions](api-reference.md#ai-question-answering--chat)** - Master the RAG pipeline
-5. **[Advanced Configuration](configuration.md)** - Fine-tune your setup
-6. **[Performance Tuning](configuration.md#performance-tuning)** - Optimize for your use case
+1. **[Choose Your AI Provider]({{ site.baseurl }}/configuration#ai-providers)** - Configure OpenAI, Anthropic, Gemini, etc.
+2. **[Select Storage Backend]({{ site.baseurl }}/configuration#storage-providers)** - Set up Qdrant, Redis, SQLite, etc.
+3. **[Upload Documents]({{ site.baseurl }}/api-reference#document-management)** - Learn about supported formats
+4. **[Ask Questions]({{ site.baseurl }}/api-reference#ai-question-answering--chat)** - Master the RAG pipeline
+5. **[Advanced Configuration]({{ site.baseurl }}/configuration)** - Fine-tune your setup
+6. **[Performance Tuning]({{ site.baseurl }}/configuration#performance-tuning)** - Optimize for your use case
 
 ## 🔍 Understanding the RAG Pipeline
 

docs/index.md

@@ -19,7 +19,7 @@ nav_order: 1
             Build intelligent applications with advanced document processing, AI-powered embeddings, and semantic search capabilities.
         </p>
         <div class="hero-buttons">
-            <a href="getting-started" class="btn btn-primary btn-lg me-3">
+            <a href="{{ site.baseurl }}/getting-started" class="btn btn-primary btn-lg me-3">
                 <i class="fas fa-rocket me-2"></i>Get Started
             </a>
             <a href="https://github.com/byerlikaya/SmartRAG" class="btn btn-outline-primary btn-lg me-3">
@@ -113,7 +113,7 @@ var document = await documentService.UploadDocumentAsync(file);
                 <i class="fas fa-rocket fa-2x text-primary mb-3"></i>
                 <h5 class="card-title">Getting Started</h5>
                 <p class="card-text">Quick installation and setup guide to get you up and running.</p>
-                <a href="getting-started" class="btn btn-primary">Get Started</a>
+                <a href="{{ site.baseurl }}/getting-started" class="btn btn-primary">Get Started</a>
             </div>
         </div>
     </div>
@@ -123,7 +123,7 @@ var document = await documentService.UploadDocumentAsync(file);
                 <i class="fas fa-cog fa-2x text-success mb-3"></i>
                 <h5 class="card-title">Configuration</h5>
                 <p class="card-text">Detailed configuration options and best practices.</p>
-                <a href="configuration" class="btn btn-success">Configure</a>
+                <a href="{{ site.baseurl }}/configuration" class="btn btn-success">Configure</a>
             </div>
         </div>
     </div>
@@ -133,7 +133,7 @@ var document = await documentService.UploadDocumentAsync(file);
                 <i class="fas fa-code fa-2x text-warning mb-3"></i>
                 <h5 class="card-title">API Reference</h5>
                 <p class="card-text">Complete API documentation with examples and usage patterns.</p>
-                <a href="api-reference" class="btn btn-warning">View API</a>
+                <a href="{{ site.baseurl }}/api-reference" class="btn btn-warning">View API</a>
             </div>
         </div>
     </div>
@@ -148,7 +148,7 @@ var document = await documentService.UploadDocumentAsync(file);
                 <i class="fas fa-lightbulb fa-2x text-info mb-3"></i>
                 <h5 class="card-title">Examples</h5>
                 <p class="card-text">Real-world examples and sample applications to learn from.</p>
-                <a href="examples" class="btn btn-info">View Examples</a>
+                <a href="{{ site.baseurl }}/examples" class="btn btn-info">View Examples</a>
             </div>
         </div>
     </div>
@@ -158,7 +158,7 @@ var document = await documentService.UploadDocumentAsync(file);
                 <i class="fas fa-tools fa-2x text-danger mb-3"></i>
                 <h5 class="card-title">Troubleshooting</h5>
                 <p class="card-text">Common issues and solutions to help you resolve problems.</p>
-                <a href="troubleshooting" class="btn btn-danger">Get Help</a>
+                <a href="{{ site.baseurl }}/troubleshooting" class="btn btn-danger">Get Help</a>
             </div>
         </div>
     </div>

docs/troubleshooting.md

@@ -358,4 +358,4 @@ Include:
 
 ---
 
-**Need more help?** Check our [Getting Started Guide](getting-started.md) or [Configuration Guide](configuration.md).
+**Need more help?** Check our [Getting Started Guide]({{ site.baseurl }}/getting-started) or [Configuration Guide]({{ site.baseurl }}/configuration).