add content to product pages, and generate sidebars for them

Author: tayloraswift

Assets/css/Main.css

@@ -48,13 +48,13 @@ extension IdentifiablePageContext.Cache where ID:VersionedPageIdentifier
 }
 extension IdentifiablePageContext.Cache where ID:VersionedPageIdentifier
 {
-    subscript(article scalar:Unidoc.Scalar) -> (master:Unidoc.Vertex.Article, url:String?)?
+    subscript(culture scalar:Unidoc.Scalar) -> (vertex:Unidoc.Vertex.Culture, url:String?)?
     {
         mutating get
         {
-            if  case .article(let master)? = self.vertices[scalar]
+            if  case .culture(let vertex)? = self.vertices[scalar]
             {
-                (master, self.load(scalar) { Swiftinit.Docs[$0, master.shoot] })
+                (vertex, self.load(scalar) { Swiftinit.Docs[$0, vertex.shoot] })
             }
             else
             {
@@ -63,13 +63,13 @@ extension IdentifiablePageContext.Cache where ID:VersionedPageIdentifier
         }
     }
 
-    subscript(culture scalar:Unidoc.Scalar) -> (master:Unidoc.Vertex.Culture, url:String?)?
+    subscript(article scalar:Unidoc.Scalar) -> (vertex:Unidoc.Vertex.Article, url:String?)?
     {
         mutating get
         {
-            if  case .culture(let master)? = self.vertices[scalar]
+            if  case .article(let vertex)? = self.vertices[scalar]
             {
-                (master, self.load(scalar) { Swiftinit.Docs[$0, master.shoot] })
+                (vertex, self.load(scalar) { Swiftinit.Docs[$0, vertex.shoot] })
             }
             else
             {
@@ -78,13 +78,13 @@ extension IdentifiablePageContext.Cache where ID:VersionedPageIdentifier
         }
     }
 
-    subscript(decl scalar:Unidoc.Scalar) -> (master:Unidoc.Vertex.Decl, url:String?)?
+    subscript(decl scalar:Unidoc.Scalar) -> (vertex:Unidoc.Vertex.Decl, url:String?)?
     {
         mutating get
         {
-            if  case .decl(let master)? = self.vertices[scalar]
+            if  case .decl(let vertex)? = self.vertices[scalar]
             {
-                (master, self.load(scalar) { Swiftinit.Docs[$0, master.shoot] })
+                (vertex, self.load(scalar) { Swiftinit.Docs[$0, vertex.shoot] })
             }
             else
             {

Assets/css/Main.css.map

@@ -185,19 +185,19 @@ extension IdentifiablePageContext:Swiftinit.VersionedPageContext
     where ID:VersionedPageIdentifier
 {
     @usableFromInline internal
-    func link(article:Unidoc.Scalar) -> HTML.Link<MarkdownBytecode.SafeView>?
+    func link(module:Unidoc.Scalar) -> HTML.Link<Symbol.Module>?
     {
-        self.cache[article: article].map
+        self.cache[culture: module].map
         {
-            .init(display: $0.headline.safe, target: $1)
+            .init(display: $0.module.id, target: $1)
         }
     }
     @usableFromInline internal
-    func link(module:Unidoc.Scalar) -> HTML.Link<Symbol.Module>?
+    func link(article:Unidoc.Scalar) -> HTML.Link<MarkdownBytecode.SafeView>?
     {
-        self.cache[culture: module].map
+        self.cache[article: article].map
         {
-            .init(display: $0.module.id, target: $1)
+            .init(display: $0.headline.safe, target: $1)
         }
     }
 

Sources/SwiftinitPages/Contexts/IdentifiablePageContext.Cache.swift

@@ -1,20 +1,21 @@
 import HTML
 
-enum AutomaticHeading
+enum AutomaticHeading:Equatable, Comparable
 {
     case packageTags
 
     case packageRepository
     case packageDependencies
     case platformRequirements
     case snapshotInformation
-    case allProducts
     case allModules
+    case allProducts
+    case allProductConstituents
 
     case miscellaneous
-    case otherProducts
     case otherModules
     case otherMembers
+    case otherProducts
 
     case seeAlso
 
@@ -42,13 +43,14 @@ extension AutomaticHeading:Identifiable
         case .packageDependencies:      "ss:package-dependencies"
         case .platformRequirements:     "ss:platform-requirements"
         case .snapshotInformation:      "ss:snapshot-information"
-        case .allProducts:              "ss:all-products"
         case .allModules:               "ss:all-modules"
+        case .allProducts:              "ss:all-products"
+        case .allProductConstituents:   "ss:all-product-constituents"
 
         case .miscellaneous:            "ss:misc"
-        case .otherProducts:            "ss:other-products"
-        case .otherModules:             "ss:other-modules"
         case .otherMembers:             "ss:other-members"
+        case .otherModules:             "ss:other-modules"
+        case .otherProducts:            "ss:other-products"
 
         case .seeAlso:                  "ss:see-also"
 
@@ -77,13 +79,14 @@ extension AutomaticHeading:CustomStringConvertible
         case .packageDependencies:      "Package Dependencies"
         case .platformRequirements:     "Platform Requirements"
         case .snapshotInformation:      "Snapshot Information"
-        case .allProducts:              "Products"
         case .allModules:               "Modules"
+        case .allProducts:              "Products"
+        case .allProductConstituents:   "Product Constituents"
 
         case .miscellaneous:            "Miscellaneous"
-        case .otherProducts:            "Other Products"
-        case .otherModules:             "Other Modules"
         case .otherMembers:             "Other Members in Extension"
+        case .otherModules:             "Other Modules"
+        case .otherProducts:            "Other Products"
 
         case .seeAlso:                  "See Also"