Split window title into topic + doc

Author: dteoh

devdocs-macos/DocumentationViewController.swift

@@ -4,6 +4,8 @@ import WebKit
 public extension Notification.Name {
     static let DocumentTitleDidChange = Notification.Name(
         rawValue: "DocumentationViewControllerDocumentTitleDidChangeNotification")
+    static let DocumentCategoryDidChange = Notification.Name(
+        rawValue: "DocumentationViewControllerDocumentCategoryDidChangeNotification")
     static let DocumentURLDidChange = Notification.Name(
         rawValue: "DocumentationViewControllerDocumentURLDidChangeNotification")
     static let DocumentViewerStateDidChange = Notification.Name(
@@ -26,6 +28,11 @@ class DocumentationViewController: NSViewController {
             NotificationCenter.default.post(name: .DocumentTitleDidChange, object: self)
         }
     }
+    private(set) var documentCategory: String? {
+        didSet {
+            NotificationCenter.default.post(name: .DocumentCategoryDidChange, object: self)
+        }
+    }
     var documentURL: URL? {
         didSet {
             NotificationCenter.default.post(name: .DocumentURLDidChange, object: self)
@@ -149,14 +156,21 @@ class DocumentationViewController: NSViewController {
     }
 
     private func handleTitleNotification(_ args: [AnyHashable: Any]) {
-        guard let title = args["title"] as! String? else {
-            return
+        if let topic = args["topic"] as! String? {
+            self.documentTitle = topic
+        } else if let title = args["title"] as! String? {
+            let suffix = " — DevDocs"
+            if title.hasSuffix(suffix) {
+                self.documentTitle = title.replacingOccurrences(of: suffix, with: "")
+            } else {
+                self.documentTitle = title
+            }
         }
-        let suffix = " — DevDocs"
-        if title.hasSuffix(suffix) {
-            self.documentTitle = title.replacingOccurrences(of: suffix, with: "")
+
+        if let doc = args["doc"] as! String? {
+            self.documentCategory = doc
         } else {
-            self.documentTitle = title
+            self.documentCategory = nil
         }
     }
 

devdocs-macos/DocumentationWindowController.swift

@@ -36,6 +36,11 @@ class DocumentationWindowController: NSWindowController {
                                                name: .DocumentTitleDidChange,
                                                object: dvc)
 
+        NotificationCenter.default.addObserver(self,
+                                               selector: #selector(observeDocumentCategory),
+                                               name: .DocumentCategoryDidChange,
+                                               object: dvc)
+
         NotificationCenter.default.addObserver(self,
                                                selector: #selector(observeDocumentURL),
                                                name: .DocumentURLDidChange,
@@ -65,6 +70,13 @@ class DocumentationWindowController: NSWindowController {
         self.window?.title = dvc.documentTitle ?? "DevDocs"
     }
 
+    @objc private func observeDocumentCategory() {
+        guard let dvc = documentationViewController else { return }
+        if #available(OSX 11.0, *) {
+            self.window?.subtitle = dvc.documentCategory ?? ""
+        }
+    }
+
     @objc private func observeDocumentURL() {
         guard let dvc = documentationViewController else { return }
         self.documentation.url = dvc.documentURL