render article links with the article title instead of the file path

Author: tayloraswift

Assets/css/Main.css

@@ -385,7 +385,6 @@ let package:Package = .init(
         .target(name: "SwiftinitPages", dependencies:
             [
                 .target(name: "GitHubAPI"),
-                .target(name: "MarkdownRendering"),
                 .target(name: "SwiftinitRender"),
                 .target(name: "UnidocAPI"),
                 .target(name: "UnidocProfiling"),
@@ -396,6 +395,7 @@ let package:Package = .init(
             [
                 .target(name: "HTTP"),
                 .target(name: "HTML"),
+                .target(name: "MarkdownRendering"),
                 .target(name: "Media"),
                 .target(name: "Swiftinit"),
                 .target(name: "UnidocRecords"),

Assets/css/Main.css.map

@@ -1,6 +1,7 @@
 import HTML
 import LexicalPaths
 import MarkdownABI
+import MarkdownRendering
 import Signatures
 import SwiftinitRender
 import Symbols
@@ -154,13 +155,6 @@ extension IdentifiablePageContext where ID:VersionedPageIdentifier
 
     var domain:Unidoc.VolumeMetadata.Domain { .init(self.volume) }
 
-    func link(module:Unidoc.Scalar) -> HTML.Link<Symbol.Module>?
-    {
-        self.cache[culture: module].map
-        {
-            .init(display: $0.module.id, target: $1)
-        }
-    }
     func link(decl:Unidoc.Scalar) -> HTML.Link<String>?
     {
         self.cache[decl: decl].map
@@ -190,6 +184,23 @@ extension IdentifiablePageContext where ID:VersionedPageIdentifier
 extension IdentifiablePageContext:Swiftinit.VersionedPageContext
     where ID:VersionedPageIdentifier
 {
+    @usableFromInline internal
+    func link(article:Unidoc.Scalar) -> HTML.Link<MarkdownBytecode.SafeView>?
+    {
+        self.cache[article: article].map
+        {
+            .init(display: $0.headline.safe, target: $1)
+        }
+    }
+    @usableFromInline internal
+    func link(module:Unidoc.Scalar) -> HTML.Link<Symbol.Module>?
+    {
+        self.cache[culture: module].map
+        {
+            .init(display: $0.module.id, target: $1)
+        }
+    }
+
     @usableFromInline internal
     func vector<Display, Vector>(_ vector:Vector,
         display:Display) -> HTML.VectorLink<Display, Vector>

Package.swift

@@ -1,6 +1,7 @@
 import HTML
 import MarkdownABI
 import MarkdownRendering
+import SymbolGraphs
 import Unidoc
 import UnidocRecords
 
@@ -63,6 +64,13 @@ extension ProseSection:HyperTextRenderableMarkdown
             html[.code] = text
 
         case .path(let stem, let scalars):
+            if  let scalar:Unidoc.Scalar = scalars.first,
+                SymbolGraph.Plane.article.contains(scalar.citizen)
+            {
+                html ?= self.context.link(article: scalar)
+                return
+            }
+
             //  Take the suffix of the stem, because it may include a module namespace,
             //  and we never render the module namespace, even if it was written in the
             //  codelink text.

Sources/SwiftinitPages/Contexts/IdentifiablePageContext.swift

@@ -1,4 +1,7 @@
 import HTML
+import MarkdownABI
+import MarkdownRendering
+import Symbols
 import Unidoc
 import UnidocRecords
 
@@ -11,6 +14,10 @@ extension Swiftinit
 public
 protocol _SwiftinitVersionedPageContext:AnyObject
 {
+    func link(article:Unidoc.Scalar) -> HTML.Link<MarkdownBytecode.SafeView>?
+
+    func link(module:Unidoc.Scalar) -> HTML.Link<Symbol.Module>?
+
     func vector<Display, Vector>(_ vector:Vector,
         display:Display) -> HTML.VectorLink<Display, Vector>
         where Vector:Sequence<Unidoc.Scalar>

Sources/SwiftinitPages/Sections/ProseSection.swift

@@ -24,10 +24,14 @@ section.details table
         padding-left: 0;
     }
 }
-section.details table.dependencies
+section.details table.dependencies,
+section.details table.platforms,
+section.details table.tags
 {
     width: 100%;
-
+}
+section.details table.dependencies
+{
     td:first-child
     {
         font-style: italic;
@@ -39,8 +43,6 @@ section.details table.dependencies
 }
 section.details table.tags
 {
-    width: 100%;
-
     tr.modern
     {
         font-weight: 700;