novelWriter 2.2.1__py3-none-any.whl → 2.3b1__py3-none-any.whl

novelwriter/dialogs/{projsettings.py → projectsettings.py}

@@ -3,7 +3,8 @@ novelWriter – GUI Project Settings
 ==================================
 
 File History:
-Created: 2018-09-29 [0.0.1] GuiProjectSettings
+Created:   2018-09-29 [0.0.1] GuiProjectSettings
+Rewritten: 2024-01-26 [2.3b1] GuiProjectSettings
 
 This file is a part of novelWriter
 Copyright 2018–2024, Veronica Berglyd Olsen
@@ -25,75 +26,105 @@ from __future__ import annotations
 
 import logging
 
-from typing import TYPE_CHECKING
-
-from PyQt5.QtGui import QCloseEvent, QIcon, QPixmap, QColor
+from PyQt5.QtGui import QCloseEvent, QColor, QIcon, QPixmap
 from PyQt5.QtCore import Qt, pyqtSignal, pyqtSlot
 from PyQt5.QtWidgets import (
-    QColorDialog, QComboBox, QDialogButtonBox, QHBoxLayout, QLabel, QLineEdit,
-    QPushButton, QTreeWidget, QTreeWidgetItem, QVBoxLayout, QWidget, qApp
+    QColorDialog, QDialog, QDialogButtonBox, QHBoxLayout, QLineEdit,
+    QPushButton, QStackedWidget, QTreeWidget, QTreeWidgetItem, QVBoxLayout,
+    QWidget, qApp
 )
 
 from novelwriter import CONFIG, SHARED
 from novelwriter.common import simplified
 from novelwriter.extensions.switch import NSwitch
-from novelwriter.extensions.pageddialog import NPagedDialog
-from novelwriter.extensions.configlayout import NConfigLayout
-
-if TYPE_CHECKING:  # pragma: no cover
-    from novelwriter.guimain import GuiMain
+from novelwriter.extensions.modified import NComboBox
+from novelwriter.extensions.configlayout import NColourLabel, NFixedPage, NScrollableForm
+from novelwriter.extensions.pagedsidebar import NPagedSideBar
 
 logger = logging.getLogger(__name__)
 
 
-class GuiProjectSettings(NPagedDialog):
+class GuiProjectSettings(QDialog):
 
-    TAB_MAIN    = 0
-    TAB_STATUS  = 1
-    TAB_IMPORT  = 2
-    TAB_REPLACE = 3
+    PAGE_SETTINGS = 0
+    PAGE_STATUS   = 1
+    PAGE_IMPORT   = 2
+    PAGE_REPLACE  = 3
 
-    newProjectSettingsReady = pyqtSignal()
+    newProjectSettingsReady = pyqtSignal(bool)
 
-    def __init__(self, mainGui: GuiMain, focusTab: int = TAB_MAIN) -> None:
-        super().__init__(parent=mainGui)
+    def __init__(self, parent: QWidget, gotoPage: int = PAGE_SETTINGS) -> None:
+        super().__init__(parent=parent)
 
         logger.debug("Create: GuiProjectSettings")
         self.setObjectName("GuiProjectSettings")
-
-        self.mainGui = mainGui
-        SHARED.project.countStatus()
         self.setWindowTitle(self.tr("Project Settings"))
 
-        wW = CONFIG.pxInt(570)
-        wH = CONFIG.pxInt(375)
-        pOptions = SHARED.project.options
-
-        self.setMinimumWidth(wW)
-        self.setMinimumHeight(wH)
+        options = SHARED.project.options
+        self.setMinimumSize(CONFIG.pxInt(500), CONFIG.pxInt(400))
         self.resize(
-            CONFIG.pxInt(pOptions.getInt("GuiProjectSettings", "winWidth",  wW)),
-            CONFIG.pxInt(pOptions.getInt("GuiProjectSettings", "winHeight", wH))
+            CONFIG.pxInt(options.getInt("GuiProjectSettings", "winWidth", CONFIG.pxInt(650))),
+            CONFIG.pxInt(options.getInt("GuiProjectSettings", "winHeight", CONFIG.pxInt(500)))
         )
 
-        self.tabMain    = GuiProjectEditMain(self)
-        self.tabStatus  = GuiProjectEditStatus(self, True)
-        self.tabImport  = GuiProjectEditStatus(self, False)
-        self.tabReplace = GuiProjectEditReplace(self)
-
-        self.addTab(self.tabMain,    self.tr("Settings"))
-        self.addTab(self.tabStatus,  self.tr("Status"))
-        self.addTab(self.tabImport,  self.tr("Importance"))
-        self.addTab(self.tabReplace, self.tr("Auto-Replace"))
+        # Title
+        self.titleLabel = NColourLabel(
+            self.tr("Project Settings"), SHARED.theme.helpText,
+            parent=self, scale=NColourLabel.HEADER_SCALE, indent=CONFIG.pxInt(4)
+        )
 
-        self.buttonBox = QDialogButtonBox(QDialogButtonBox.Ok | QDialogButtonBox.Cancel)
+        # SideBar
+        self.sidebar = NPagedSideBar(self)
+        self.sidebar.setLabelColor(SHARED.theme.helpText)
+        self.sidebar.addButton(self.tr("Settings"), self.PAGE_SETTINGS)
+        self.sidebar.addButton(self.tr("Status"), self.PAGE_STATUS)
+        self.sidebar.addButton(self.tr("Importance"), self.PAGE_IMPORT)
+        self.sidebar.addButton(self.tr("Auto-Replace"), self.PAGE_REPLACE)
+        self.sidebar.buttonClicked.connect(self._sidebarClicked)
+
+        # Buttons
+        self.buttonBox = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Save | QDialogButtonBox.StandardButton.Cancel
+        )
         self.buttonBox.accepted.connect(self._doSave)
         self.buttonBox.rejected.connect(self.close)
-        self.rejected.connect(self.close)
-        self.addControls(self.buttonBox)
 
-        # Focus Tab
-        self._focusTab(focusTab)
+        # Content
+        SHARED.project.countStatus()
+
+        self.settingsPage = _SettingsPage(self)
+        self.statusPage = _StatusPage(self, True)
+        self.importPage = _StatusPage(self, False)
+        self.replacePage = _ReplacePage(self)
+
+        self.mainStack = QStackedWidget(self)
+        self.mainStack.addWidget(self.settingsPage)
+        self.mainStack.addWidget(self.statusPage)
+        self.mainStack.addWidget(self.importPage)
+        self.mainStack.addWidget(self.replacePage)
+
+        # Assemble
+        self.topBox = QHBoxLayout()
+        self.topBox.addWidget(self.titleLabel)
+        self.topBox.addStretch(1)
+
+        self.mainBox = QHBoxLayout()
+        self.mainBox.addWidget(self.sidebar)
+        self.mainBox.addWidget(self.mainStack)
+        self.mainBox.setContentsMargins(0, 0, 0, 0)
+
+        self.outerBox = QVBoxLayout()
+        self.outerBox.addLayout(self.topBox)
+        self.outerBox.addLayout(self.mainBox)
+        self.outerBox.addWidget(self.buttonBox)
+        self.outerBox.setSpacing(CONFIG.pxInt(8))
+
+        self.setLayout(self.outerBox)
+        self.setSizeGripEnabled(True)
+
+        # Jump to Specified Page
+        self.sidebar.setSelected(gotoPage)
+        self._sidebarClicked(gotoPage)
 
         logger.debug("Ready: GuiProjectSettings")
 
@@ -103,9 +134,13 @@ class GuiProjectSettings(NPagedDialog):
         logger.debug("Delete: GuiProjectSettings")
         return
 
+    ##
+    #  Events
+    ##
+
     def closeEvent(self, event: QCloseEvent) -> None:
-        """Capture the close event and perform cleanup."""
-        self._saveGuiSettings()
+        """Capture the user closing the window and save settings."""
+        self._saveSettings()
         event.accept()
         self.deleteLater()
         return
@@ -114,40 +149,52 @@ class GuiProjectSettings(NPagedDialog):
     #  Private Slots
     ##
 
+    @pyqtSlot(int)
+    def _sidebarClicked(self, pageId: int) -> None:
+        """Process a user request to switch page."""
+        if pageId == self.PAGE_SETTINGS:
+            self.mainStack.setCurrentWidget(self.settingsPage)
+        elif pageId == self.PAGE_STATUS:
+            self.mainStack.setCurrentWidget(self.statusPage)
+        elif pageId == self.PAGE_IMPORT:
+            self.mainStack.setCurrentWidget(self.importPage)
+        elif pageId == self.PAGE_REPLACE:
+            self.mainStack.setCurrentWidget(self.replacePage)
+        return
+
     @pyqtSlot()
     def _doSave(self) -> None:
         """Save settings and close dialog."""
         project    = SHARED.project
-        projName   = self.tabMain.editName.text()
-        bookTitle  = self.tabMain.editTitle.text()
-        bookAuthor = self.tabMain.editAuthor.text()
-        projLang   = self.tabMain.projLang.currentData()
-        spellLang  = self.tabMain.spellLang.currentData()
-        doBackup   = not self.tabMain.doBackup.isChecked()
+        projName   = self.settingsPage.projName.text()
+        projAuthor = self.settingsPage.projAuthor.text()
+        projLang   = self.settingsPage.projLang.currentData()
+        spellLang  = self.settingsPage.spellLang.currentData()
+        doBackup   = not self.settingsPage.doBackup.isChecked()
 
         project.data.setName(projName)
-        project.data.setTitle(bookTitle)
-        project.data.setAuthor(bookAuthor)
+        project.data.setAuthor(projAuthor)
         project.data.setDoBackup(doBackup)
         project.data.setSpellLang(spellLang)
         project.setProjectLang(projLang)
 
-        if self.tabStatus.colChanged:
-            newList, delList = self.tabStatus.getNewList()
+        rebuildTrees = False
+
+        if self.statusPage.wasChanged:
+            newList, delList = self.statusPage.getNewList()
             project.setStatusColours(newList, delList)
+            rebuildTrees = True
 
-        if self.tabImport.colChanged:
-            newList, delList = self.tabImport.getNewList()
+        if self.importPage.wasChanged:
+            newList, delList = self.importPage.getNewList()
             project.setImportColours(newList, delList)
+            rebuildTrees = True
 
-        if self.tabStatus.colChanged or self.tabImport.colChanged:
-            self.mainGui.rebuildTrees()
-
-        if self.tabReplace.arChanged:
-            newList = self.tabReplace.getNewList()
+        if self.replacePage.wasChanged:
+            newList = self.replacePage.getNewList()
             project.data.setAutoReplace(newList)
 
-        self.newProjectSettingsReady.emit()
+        self.newProjectSettingsReady.emit(rebuildTrees)
         qApp.processEvents()
         self.close()
 
@@ -157,134 +204,103 @@ class GuiProjectSettings(NPagedDialog):
     #  Internal Functions
     ##
 
-    def _focusTab(self, tab: int) -> None:
-        """Change which is the focused tab."""
-        if tab == self.TAB_MAIN:
-            self.setCurrentWidget(self.tabMain)
-        elif tab == self.TAB_STATUS:
-            self.setCurrentWidget(self.tabStatus)
-        elif tab == self.TAB_IMPORT:
-            self.setCurrentWidget(self.tabImport)
-        elif tab == self.TAB_REPLACE:
-            self.setCurrentWidget(self.tabReplace)
-        return
-
-    def _saveGuiSettings(self) -> None:
+    def _saveSettings(self) -> None:
         """Save GUI settings."""
         winWidth    = CONFIG.rpxInt(self.width())
         winHeight   = CONFIG.rpxInt(self.height())
-        replaceColW = CONFIG.rpxInt(self.tabReplace.listBox.columnWidth(0))
-        statusColW  = CONFIG.rpxInt(self.tabStatus.listBox.columnWidth(0))
-        importColW  = CONFIG.rpxInt(self.tabImport.listBox.columnWidth(0))
+        statusColW  = CONFIG.rpxInt(self.statusPage.columnWidth())
+        importColW  = CONFIG.rpxInt(self.importPage.columnWidth())
+        replaceColW = CONFIG.rpxInt(self.replacePage.columnWidth())
 
         logger.debug("Saving State: GuiProjectSettings")
-        pOptions = SHARED.project.options
-        pOptions.setValue("GuiProjectSettings", "winWidth",    winWidth)
-        pOptions.setValue("GuiProjectSettings", "winHeight",   winHeight)
-        pOptions.setValue("GuiProjectSettings", "replaceColW", replaceColW)
-        pOptions.setValue("GuiProjectSettings", "statusColW",  statusColW)
-        pOptions.setValue("GuiProjectSettings", "importColW",  importColW)
+        options = SHARED.project.options
+        options.setValue("GuiProjectSettings", "winWidth", winWidth)
+        options.setValue("GuiProjectSettings", "winHeight", winHeight)
+        options.setValue("GuiProjectSettings", "statusColW", statusColW)
+        options.setValue("GuiProjectSettings", "importColW", importColW)
+        options.setValue("GuiProjectSettings", "replaceColW", replaceColW)
 
         return
 
 # END Class GuiProjectSettings
 
 
-class GuiProjectEditMain(QWidget):
+class _SettingsPage(NScrollableForm):
 
     def __init__(self, parent: QWidget) -> None:
         super().__init__(parent=parent)
 
-        # The Form
-        self.mainForm = NConfigLayout()
-        self.mainForm.setHelpTextStyle(SHARED.theme.helpText)
-        self.setLayout(self.mainForm)
-
-        self.mainForm.addGroupLabel(self.tr("Project Settings"))
-
-        xW = CONFIG.pxInt(250)
-        pData = SHARED.project.data
-
-        self.editName = QLineEdit()
-        self.editName.setMaxLength(200)
-        self.editName.setMaximumWidth(xW)
-        self.editName.setText(pData.name)
-        self.mainForm.addRow(
-            self.tr("Project name"),
-            self.editName,
-            self.tr("Should be set only once.")
+        xW = CONFIG.pxInt(200)
+        data = SHARED.project.data
+        self.setHelpTextStyle(SHARED.theme.helpText)
+        self.setRowIndent(0)
+
+        # Project Name
+        self.projName = QLineEdit(self)
+        self.projName.setMaxLength(200)
+        self.projName.setMinimumWidth(xW)
+        self.projName.setText(data.name)
+        self.addRow(
+            self.tr("Project name"), self.projName,
+            self.tr("Changing this will affect the backup path."),
+            stretch=(3, 2)
         )
 
-        self.editTitle = QLineEdit()
-        self.editTitle.setMaxLength(200)
-        self.editTitle.setMaximumWidth(xW)
-        self.editTitle.setText(pData.title)
-        self.mainForm.addRow(
-            self.tr("Novel title"),
-            self.editTitle,
-            self.tr("Change whenever you want!")
+        # Project Author
+        self.projAuthor = QLineEdit(self)
+        self.projAuthor.setMaxLength(200)
+        self.projAuthor.setMinimumWidth(xW)
+        self.projAuthor.setText(data.author)
+        self.addRow(
+            self.tr("Author(s)"), self.projAuthor,
+            self.tr("Only used when building the manuscript."),
+            stretch=(3, 2)
         )
 
-        self.editAuthor = QLineEdit()
-        self.editAuthor.setMaxLength(200)
-        self.editAuthor.setMaximumWidth(xW)
-        self.editAuthor.setText(pData.author)
-        self.mainForm.addRow(
-            self.tr("Author(s)"),
-            self.editAuthor,
-            self.tr("Change whenever you want!")
-        )
-
-        self.projLang = QComboBox(self)
-        self.projLang.setMaximumWidth(xW)
+        # Project Language
+        self.projLang = NComboBox(self)
+        self.projLang.setMinimumWidth(xW)
         for tag, language in CONFIG.listLanguages(CONFIG.LANG_PROJ):
             self.projLang.addItem(language, tag)
-        self.mainForm.addRow(
-            self.tr("Project language"),
-            self.projLang,
-            self.tr("Used when building the manuscript.")
+        self.addRow(
+            self.tr("Project language"), self.projLang,
+            self.tr("Only used when building the manuscript."),
+            stretch=(3, 2)
         )
+        if (idx := self.projLang.findData(data.language)) != -1:
+            self.projLang.setCurrentIndex(idx)
 
-        langIdx = 0
-        if pData.language is not None:
-            langIdx = self.projLang.findData(pData.language)
-        if langIdx == -1:
-            langIdx = self.projLang.findData("en_GB")
-        if langIdx != -1:
-            self.projLang.setCurrentIndex(langIdx)
-
-        self.spellLang = QComboBox(self)
-        self.spellLang.setMaximumWidth(xW)
+        # Spell Check Language
+        self.spellLang = NComboBox(self)
+        self.spellLang.setMinimumWidth(xW)
         self.spellLang.addItem(self.tr("Default"), "None")
         if CONFIG.hasEnchant:
             for tag, language in SHARED.spelling.listDictionaries():
                 self.spellLang.addItem(language, tag)
-        self.mainForm.addRow(
-            self.tr("Spell check language"),
-            self.spellLang,
-            self.tr("Overrides main preferences.")
+        self.addRow(
+            self.tr("Spell check language"), self.spellLang,
+            self.tr("Overrides main preferences."),
+            stretch=(3, 2)
         )
+        if (idx := self.spellLang.findData(data.spellLang)) != -1:
+            self.spellLang.setCurrentIndex(idx)
 
-        langIdx = 0
-        if pData.spellLang is not None:
-            langIdx = self.spellLang.findData(pData.spellLang)
-        if langIdx != -1:
-            self.spellLang.setCurrentIndex(langIdx)
-
+        # Backup on Close
         self.doBackup = NSwitch(self)
-        self.doBackup.setChecked(not pData.doBackup)
-        self.mainForm.addRow(
-            self.tr("No backup on close"),
-            self.doBackup,
+        self.doBackup.setChecked(not data.doBackup)
+        self.addRow(
+            self.tr("Disable backup on close"), self.doBackup,
             self.tr("Overrides main preferences.")
         )
 
+        self.finalise()
+
         return
 
-# END Class GuiProjectEditMain
+# END Class _SettingsPage
 
 
-class GuiProjectEditStatus(QWidget):
+class _StatusPage(NFixedPage):
 
     COL_LABEL = 0
     COL_USAGE = 1
@@ -297,57 +313,55 @@ class GuiProjectEditStatus(QWidget):
         super().__init__(parent=parent)
 
         if isStatus:
-            self.theStatus = SHARED.project.data.itemStatus
-            pageLabel = self.tr("Novel File Status Levels")
+            status = SHARED.project.data.itemStatus
+            pageLabel = self.tr("Novel Document Status Levels")
             colSetting = "statusColW"
         else:
-            self.theStatus = SHARED.project.data.itemImport
-            pageLabel = self.tr("Note File Importance Levels")
+            status = SHARED.project.data.itemImport
+            pageLabel = self.tr("Project Note Importance Levels")
             colSetting = "importColW"
 
         wCol0 = CONFIG.pxInt(
             SHARED.project.options.getInt("GuiProjectSettings", colSetting, 130)
         )
 
-        self.colDeleted = []
-        self.colChanged = False
-        self.selColour = QColor(100, 100, 100)
+        self._changed = False
+        self._colDeleted = []
+        self._selColour = QColor(100, 100, 100)
 
         self.iPx = SHARED.theme.baseIconSize
 
-        # The List
-        # ========
+        # Title
+        self.pageTitle = NColourLabel(
+            pageLabel, SHARED.theme.helpText, parent=self,
+            scale=NColourLabel.HEADER_SCALE
+        )
 
-        self.listBox = QTreeWidget()
-        self.listBox.setHeaderLabels([
-            self.tr("Label"), self.tr("Usage"),
-        ])
+        # List Box
+        self.listBox = QTreeWidget(self)
+        self.listBox.setHeaderLabels([self.tr("Label"), self.tr("Usage")])
         self.listBox.itemSelectionChanged.connect(self._selectedItem)
         self.listBox.setColumnWidth(self.COL_LABEL, wCol0)
         self.listBox.setIndentation(0)
 
-        for key, entry in self.theStatus.items():
+        for key, entry in status.items():
             self._addItem(key, entry["name"], entry["cols"], entry["count"])
 
         # List Controls
-        # =============
-
-        self.addButton = QPushButton(SHARED.theme.getIcon("add"), "")
+        self.addButton = QPushButton(SHARED.theme.getIcon("add"), "", self)
         self.addButton.clicked.connect(self._newItem)
 
-        self.delButton = QPushButton(SHARED.theme.getIcon("remove"), "")
+        self.delButton = QPushButton(SHARED.theme.getIcon("remove"), "", self)
         self.delButton.clicked.connect(self._delItem)
 
-        self.upButton = QPushButton(SHARED.theme.getIcon("up"), "")
+        self.upButton = QPushButton(SHARED.theme.getIcon("up"), "", self)
         self.upButton.clicked.connect(lambda: self._moveItem(-1))
 
-        self.dnButton = QPushButton(SHARED.theme.getIcon("down"), "")
+        self.dnButton = QPushButton(SHARED.theme.getIcon("down"), "", self)
         self.dnButton.clicked.connect(lambda: self._moveItem(1))
 
         # Edit Form
-        # =========
-
-        self.editName = QLineEdit()
+        self.editName = QLineEdit(self)
         self.editName.setMaxLength(40)
         self.editName.setPlaceholderText(self.tr("Select item to edit"))
         self.editName.setEnabled(False)
@@ -364,8 +378,6 @@ class GuiProjectEditStatus(QWidget):
         self.saveButton.clicked.connect(self._saveItem)
 
         # Assemble
-        # ========
-
         self.listControls = QVBoxLayout()
         self.listControls.addWidget(self.addButton)
         self.listControls.addWidget(self.delButton)
@@ -387,16 +399,25 @@ class GuiProjectEditStatus(QWidget):
         self.innerBox.addLayout(self.listControls)
 
         self.outerBox = QVBoxLayout()
-        self.outerBox.addWidget(QLabel("<b>%s</b>" % pageLabel))
+        self.outerBox.addWidget(self.pageTitle)
         self.outerBox.addLayout(self.innerBox)
 
-        self.setLayout(self.outerBox)
+        self.setCentralLayout(self.outerBox)
 
         return
 
+    @property
+    def wasChanged(self) -> bool:
+        """The user changed these settings."""
+        return self._changed
+
+    ##
+    #  Methods
+    ##
+
     def getNewList(self) -> tuple[list, list]:
         """Return list of entries."""
-        if self.colChanged:
+        if self._changed:
             newList = []
             for n in range(self.listBox.topLevelItemCount()):
                 item = self.listBox.topLevelItem(n)
@@ -406,10 +427,13 @@ class GuiProjectEditStatus(QWidget):
                         "name": item.text(self.COL_LABEL),
                         "cols": item.data(self.COL_LABEL, self.COL_ROLE),
                     })
-            return newList, self.colDeleted
-
+            return newList, self._colDeleted
         return [], []
 
+    def columnWidth(self) -> int:
+        """Return the size of the header column."""
+        return self.listBox.columnWidth(0)
+
     ##
     #  Private Slots
     ##
@@ -417,12 +441,12 @@ class GuiProjectEditStatus(QWidget):
     @pyqtSlot()
     def _selectColour(self) -> None:
         """Open a dialog to select the status icon colour."""
-        if self.selColour is not None:
+        if self._selColour is not None:
             newCol = QColorDialog.getColor(
-                self.selColour, self, self.tr("Select Colour")
+                self._selColour, self, self.tr("Select Colour")
             )
             if newCol.isValid():
-                self.selColour = newCol
+                self._selColour = newCol
                 pixmap = QPixmap(self.iPx, self.iPx)
                 pixmap.fill(newCol)
                 self.colButton.setIcon(QIcon(pixmap))
@@ -433,7 +457,7 @@ class GuiProjectEditStatus(QWidget):
     def _newItem(self) -> None:
         """Create a new status item."""
         self._addItem(None, self.tr("New Item"), (100, 100, 100), 0)
-        self.colChanged = True
+        self._changed = True
         return
 
     @pyqtSlot()
@@ -446,8 +470,8 @@ class GuiProjectEditStatus(QWidget):
                 SHARED.error(self.tr("Cannot delete a status item that is in use."))
             else:
                 self.listBox.takeTopLevelItem(iRow)
-                self.colDeleted.append(selItem.data(self.COL_LABEL, self.KEY_ROLE))
-                self.colChanged = True
+                self._colDeleted.append(selItem.data(self.COL_LABEL, self.KEY_ROLE))
+                self._changed = True
         return
 
     @pyqtSlot()
@@ -458,9 +482,9 @@ class GuiProjectEditStatus(QWidget):
             selItem.setText(self.COL_LABEL, simplified(self.editName.text()))
             selItem.setIcon(self.COL_LABEL, self.colButton.icon())
             selItem.setData(self.COL_LABEL, self.COL_ROLE, (
-                self.selColour.red(), self.selColour.green(), self.selColour.blue()
+                self._selColour.red(), self._selColour.green(), self._selColour.blue()
             ))
-            self.colChanged = True
+            self._changed = True
         return
 
     @pyqtSlot()
@@ -474,7 +498,7 @@ class GuiProjectEditStatus(QWidget):
             name = selItem.text(self.COL_LABEL)
             pixmap = QPixmap(self.iPx, self.iPx)
             pixmap.fill(QColor(*cols))
-            self.selColour = QColor(*cols)
+            self._selColour = QColor(*cols)
             self.editName.setText(name)
             self.colButton.setIcon(QIcon(pixmap))
             self.editName.selectAll()
@@ -485,7 +509,7 @@ class GuiProjectEditStatus(QWidget):
         else:
             pixmap = QPixmap(self.iPx, self.iPx)
             pixmap.fill(QColor(100, 100, 100))
-            self.selColour = QColor(100, 100, 100)
+            self._selColour = QColor(100, 100, 100)
             self.editName.setText("")
             self.colButton.setIcon(QIcon(pixmap))
             self.editName.setEnabled(False)
@@ -498,16 +522,16 @@ class GuiProjectEditStatus(QWidget):
     ##
 
     def _addItem(self, key: str | None, name: str,
-                 cols: tuple[int, int, int], count: int) -> None:
+                 colour: tuple[int, int, int], count: int) -> None:
         """Add a status item to the list."""
         pixmap = QPixmap(self.iPx, self.iPx)
-        pixmap.fill(QColor(*cols))
+        pixmap.fill(QColor(*colour))
 
         item = QTreeWidgetItem()
         item.setText(self.COL_LABEL, name)
         item.setIcon(self.COL_LABEL, QIcon(pixmap))
         item.setData(self.COL_LABEL, self.KEY_ROLE, key)
-        item.setData(self.COL_LABEL, self.COL_ROLE, cols)
+        item.setData(self.COL_LABEL, self.COL_ROLE, colour)
         item.setData(self.COL_LABEL, self.NUM_ROLE, count)
         item.setText(self.COL_USAGE, self._usageString(count))
 
@@ -533,30 +557,29 @@ class GuiProjectEditStatus(QWidget):
 
         if cItem is not None:
             cItem.setSelected(True)
-        self.colChanged = True
+        self._changed = True
 
         return
 
     def _getSelectedItem(self) -> QTreeWidgetItem | None:
         """Get the currently selected item."""
-        selItem = self.listBox.selectedItems()
-        if len(selItem) > 0:
-            return selItem[0]
+        if items := self.listBox.selectedItems():
+            return items[0]
         return None
 
-    def _usageString(self, nUse: int) -> str:
+    def _usageString(self, count: int) -> str:
         """Generate usage string."""
-        if nUse == 0:
+        if count == 0:
             return self.tr("Not in use")
-        elif nUse == 1:
+        elif count == 1:
             return self.tr("Used once")
         else:
-            return self.tr("Used by {0} items").format(nUse)
+            return self.tr("Used by {0} items").format(count)
 
-# END Class GuiProjectEditStatus
+# END Class _StatusPage
 
 
-class GuiProjectEditReplace(QWidget):
+class _ReplacePage(NFixedPage):
 
     COL_KEY  = 0
     COL_REPL = 1
@@ -564,24 +587,24 @@ class GuiProjectEditReplace(QWidget):
     def __init__(self, parent: QWidget) -> None:
         super().__init__(parent=parent)
 
-        self.arChanged = False
+        self._changed = False
 
         wCol0 = CONFIG.pxInt(
             SHARED.project.options.getInt("GuiProjectSettings", "replaceColW", 130)
         )
-        pageLabel = self.tr("Text Replace List for Preview and Export")
 
-        # List Box
-        # ========
+        # Title
+        self.pageTitle = NColourLabel(
+            self.tr("Text Auto-Replace for Preview and Build"),
+            SHARED.theme.helpText, parent=self, scale=NColourLabel.HEADER_SCALE
+        )
 
+        # List Box
         self.listBox = QTreeWidget()
-        self.listBox.setHeaderLabels([
-            self.tr("Keyword"),
-            self.tr("Replace With"),
-        ])
-        self.listBox.itemSelectionChanged.connect(self._selectedItem)
+        self.listBox.setHeaderLabels([self.tr("Keyword"), self.tr("Replace With")])
         self.listBox.setColumnWidth(self.COL_KEY, wCol0)
         self.listBox.setIndentation(0)
+        self.listBox.itemSelectionChanged.connect(self._selectedItem)
 
         for aKey, aVal in SHARED.project.data.autoReplace.items():
             newItem = QTreeWidgetItem(["<%s>" % aKey, aVal])
@@ -591,8 +614,6 @@ class GuiProjectEditReplace(QWidget):
         self.listBox.setSortingEnabled(True)
 
         # List Controls
-        # =============
-
         self.addButton = QPushButton(SHARED.theme.getIcon("add"), "")
         self.addButton.clicked.connect(self._addEntry)
 
@@ -600,14 +621,12 @@ class GuiProjectEditReplace(QWidget):
         self.delButton.clicked.connect(self._delEntry)
 
         # Edit Form
-        # =========
-
-        self.editKey = QLineEdit()
+        self.editKey = QLineEdit(self)
         self.editKey.setPlaceholderText(self.tr("Select item to edit"))
         self.editKey.setEnabled(False)
         self.editKey.setMaxLength(40)
 
-        self.editValue = QLineEdit()
+        self.editValue = QLineEdit(self)
         self.editValue.setEnabled(False)
         self.editValue.setMaxLength(80)
 
@@ -615,8 +634,6 @@ class GuiProjectEditReplace(QWidget):
         self.saveButton.clicked.connect(self._saveEntry)
 
         # Assemble
-        # ========
-
         self.listControls = QVBoxLayout()
         self.listControls.addWidget(self.addButton)
         self.listControls.addWidget(self.delButton)
@@ -636,50 +653,61 @@ class GuiProjectEditReplace(QWidget):
         self.innerBox.addLayout(self.listControls)
 
         self.outerBox = QVBoxLayout()
-        self.outerBox.addWidget(QLabel("<b>%s</b>" % pageLabel))
+        self.outerBox.addWidget(self.pageTitle)
         self.outerBox.addLayout(self.innerBox)
 
-        self.setLayout(self.outerBox)
+        self.setCentralLayout(self.outerBox)
 
         return
 
+    @property
+    def wasChanged(self) -> bool:
+        """The user changed these settings."""
+        return self._changed
+
+    ##
+    #  Methods
+    ##
+
     def getNewList(self) -> dict:
         """Extract the list from the widget."""
         new = {}
         for n in range(self.listBox.topLevelItemCount()):
-            tItem = self.listBox.topLevelItem(n)
-            if tItem is not None:
+            if tItem := self.listBox.topLevelItem(n):
                 aKey = self._stripNotAllowed(tItem.text(0))
                 aVal = tItem.text(1)
                 if len(aKey) > 0:
                     new[aKey] = aVal
         return new
 
+    def columnWidth(self) -> int:
+        """Return the size of the header column."""
+        return self.listBox.columnWidth(0)
+
     ##
-    #  Internal Functions
+    #  Private Slots
     ##
 
-    def _selectedItem(self) -> bool:
+    @pyqtSlot()
+    def _selectedItem(self) -> None:
         """Extract the details from the selected item and populate the
         edit form.
         """
-        selItem = self._getSelectedItem()
-        if selItem is None:
-            return False
-        editKey = self._stripNotAllowed(selItem.text(0))
-        editVal = selItem.text(1)
-        self.editKey.setText(editKey)
-        self.editValue.setText(editVal)
-        self.editKey.setEnabled(True)
-        self.editValue.setEnabled(True)
-        self.editKey.selectAll()
-        self.editKey.setFocus()
-        return True
+        if selItem := self._getSelectedItem():
+            editKey = self._stripNotAllowed(selItem.text(0))
+            editVal = selItem.text(1)
+            self.editKey.setText(editKey)
+            self.editValue.setText(editVal)
+            self.editKey.setEnabled(True)
+            self.editValue.setEnabled(True)
+            self.editKey.selectAll()
+            self.editKey.setFocus()
+        return
 
+    @pyqtSlot()
     def _saveEntry(self) -> None:
         """Save the form data into the list widget."""
-        selItem = self._getSelectedItem()
-        if selItem:
+        if selItem := self._getSelectedItem():
             newKey = self.editKey.text()
             newVal = self.editValue.text()
             saveKey = self._stripNotAllowed(newKey)
@@ -691,38 +719,36 @@ class GuiProjectEditReplace(QWidget):
                 self.editKey.setEnabled(False)
                 self.editValue.setEnabled(False)
                 self.listBox.clearSelection()
-                self.arChanged = True
+                self._changed = True
         return
 
+    @pyqtSlot()
     def _addEntry(self) -> None:
         """Add a new list entry."""
         saveKey = "<keyword%d>" % (self.listBox.topLevelItemCount() + 1)
-        newVal  = ""
-        newItem = QTreeWidgetItem([saveKey, newVal])
-        self.listBox.addTopLevelItem(newItem)
+        self.listBox.addTopLevelItem(QTreeWidgetItem([saveKey, ""]))
         return
 
+    @pyqtSlot()
     def _delEntry(self) -> None:
         """Delete the selected entry."""
-        selItem = self._getSelectedItem()
-        if selItem:
+        if selItem := self._getSelectedItem():
             self.listBox.takeTopLevelItem(self.listBox.indexOfTopLevelItem(selItem))
-            self.arChanged = True
+            self._changed = True
         return
 
+    ##
+    #  Internal Functions
+    ##
+
     def _getSelectedItem(self) -> QTreeWidgetItem | None:
         """Extract the currently selected item."""
-        selItem = self.listBox.selectedItems()
-        if len(selItem) == 0:
-            return None
-        return selItem[0]
+        if items := self.listBox.selectedItems():
+            return items[0]
+        return None
 
     def _stripNotAllowed(self, key: str) -> str:
         """Clean up the replace key string."""
-        result = ""
-        for c in key:
-            if c.isalnum():
-                result += c
-        return result
+        return "".join(c for c in key if c.isalnum())
 
-# END Class GuiProjectEditReplace
+# END Class _ReplacePage