[Docs] - Switch from <base> tag to explicit base path for absolute URLs.

matthew-carroll · matthew-carroll · commit 87907fffd2fc · 2025-04-13T17:29:58.000-07:00
diff --git a/doc/website/bin/main.dart b/doc/website/bin/main.dart
@@ -15,20 +15,16 @@ Future<void> main(List<String> arguments) async {
     ..plugin(const PrettyUrlsPlugin())
     ..plugin(const RedirectsPlugin())
     ..plugin(const SassPlugin())
-    
     ..plugin(const PubPackagePlugin({
       "lucid",
     }))
-    
-    
     ..plugin(
       GitHubContributorsPlugin(
         // To load the contributors for a given GitHub package using credentials,
         // place your GitHub API token in an environment variable with the following name.
         authToken: Platform.environment["github_doc_website_token"],
       ),
     )
-    
     ..plugin(DraftingPlugin(
       showDrafts: arguments.contains("preview"),
     ));
diff --git a/doc/website/source/_data.yaml b/doc/website/source/_data.yaml
@@ -20,15 +20,16 @@ github:
       
       - { organization: Flutter-Bounty-Hunters, name: lucid }
       
+# The path to use as the base for all absolute URLs. When writing an absolute URL
+# in HTML, you should write them as "{{ base_path }}the/file/path"
+base_path: /lucid/
 
 # The default layout applied to all pages in this website.
 layout: layouts/docs_page.jinja
 
 # The global navigation manu for all documentation pages in this website.
 navigation:
-  
   show_contributors: true
-  
 
   items:
     - title: Welcome
diff --git a/doc/website/source/_includes/layouts/docs_page.jinja b/doc/website/source/_includes/layouts/docs_page.jinja
@@ -6,16 +6,14 @@
     <title>{{   title   }}</title>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-    <base href="https://flutter-bounty-hunters.github.io/lucid/">
-
-    <link rel="apple-touch-icon" sizes="180x180" href="/images/favicon/apple-touch-icon.png">
-    <link rel="icon" type="image/png" sizes="32x32" href="/images/favicon/favicon-32x32.png">
-    <link rel="icon" type="image/png" sizes="16x16" href="/images/favicon/favicon-16x16.png">
-    <link rel="manifest" href="/images/favicon/site.webmanifest">
-    <link rel="mask-icon" href="/images/favicon/safari-pinned-tab.svg" color="#5bbad5">
-    <link rel="shortcut icon" href="/images/favicon/favicon.ico">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ base_path }}images/favicon/apple-touch-icon.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="{{ base_path }}images/favicon/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="{{ base_path }}images/favicon/favicon-16x16.png">
+    <link rel="manifest" href="{{ base_path }}images/favicon/site.webmanifest">
+    <link rel="mask-icon" href="{{ base_path }}images/favicon/safari-pinned-tab.svg" color="#5bbad5">
+    <link rel="shortcut icon" href="{{ base_path }}images/favicon/favicon.ico">
     <meta name="msapplication-TileColor" content="#da532c">
-    <meta name="msapplication-config" content="/images/favicon/browserconfig.xml">
+    <meta name="msapplication-config" content="{{ base_path }}images/favicon/browserconfig.xml">
     <meta name="theme-color" content="#ffffff">
 
     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-QWTKZyjpPEjISv5WaRU9OFeRpok6YctnYmDr5pNlyT2bRjXh0JMhjY6hW+ALEwIH" crossorigin="anonymous">
@@ -30,15 +28,15 @@
 
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3" />
 
-    <link rel="stylesheet" href="/styles/docs_page_layout.css">
-    <link rel="stylesheet" href="/styles/docs_page_layout_light.css">
-    <link rel="stylesheet" href="/styles/docs_page_layout_dark.css">
+    <link rel="stylesheet" href="{{ base_path }}styles/docs_page_layout.css">
+    <link rel="stylesheet" href="{{ base_path }}styles/docs_page_layout_light.css">
+    <link rel="stylesheet" href="{{ base_path }}styles/docs_page_layout_dark.css">
   </head>
 
   <body>
     <nav class="navbar navbar-expand-lg">
       <div class="container">
-        <a class="navbar-brand" href="/"><img src="/images/branding/logo.png" height="32"><span class="name">{{  package.title  }}</span></a>
+        <a class="navbar-brand" href="{{ base_path }}"><img src="{{ base_path }}images/branding/logo.png" height="32"><span class="name">{{  package.title  }}</span></a>
 
         <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#drawerNav" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
           <span class="navbar-toggler-icon"></span>
