如何將自訂字體匯入 LibreOffice Flatpak

範例： Mira 正在使用 LibreOffice Flatpak 準備一份董事會報告，需要使用設計團隊提供的名為「Northstar Sans」的授權字體。此處的字體名稱和情況均為假設。她將字體安裝到用戶字體目錄中，刷新字體緩存，然後重新啟動 LibreOffice。這樣，她的應用程式就可以使用該字體，而無需更改 Flatpak 套件或授予 LibreOffice 存取其用戶主目錄的廣泛權限。

Flatpak 目前的桌面整合文件解釋了此方法的原理：主機字體$XDG_DATA_HOME/fonts在沙盒內公開/run/host/user-fonts。 Flatpak 也會公開系統字體目錄。其文件指出，主機字體設定檔（fontconfig）不會公開，因此系統特定的字體規則可能無法保留。請參閱官方的Flatpak 字型文件。以下步驟適用於 Flathub LibreOffice 應用程式 ID org.libreoffice.LibreOffice。

為您的使用者帳戶安裝字體

首先檢查字型的授權協議，並僅使用您有權安裝的檔案。如果字體以 ZIP 壓縮包的形式提供，請將其解壓縮並找到實際的字體檔案。常見的桌上型字型格式包括 OpenType.otf和 TrueType .ttf。請勿將 ZIP 檔案本身複製到字型目錄中。

Mira 無需管理員權限即可安裝字型。通常情況下，每個使用者的字體目錄是 `<path>` ，這與使用標準 XDG 資料目錄時的~/.local/share/fonts情況相同。 Flatpak 的文件建議避免使用舊版目錄。$XDG_DATA_HOME/fonts~/.fonts

如果使用者字體目錄尚不存在，則建立該目錄：

mkdir -p "$HOME/.local/share/fonts"

將授權字型檔案複製到該資料夾中。將範例檔名替換為您實際收到的字型檔名：

cp "$HOME/Downloads/NorthstarSans-Regular.otf" "$HOME/.local/share/fonts/"

如果字型套件包含單獨的常規體、粗體、斜體或粗斜體文件，請安裝所需的每種字型。盡可能保留原始檔案名稱；不要為了模仿不同的字體系列或字重而重新命名字體檔案。對於多個字體系列，請建立子目錄以保持資料夾的有序性。

刷新字體快取

Fontconfig 會建立一個緩存，以便應用程式能夠找到已安裝的字型。在許多 Linux 系統中，該fc-cache快取由主機上的 fontconfig 軟體包提供。刷新每個使用者目錄的快取：

fc-cache -f "$HOME/.local/share/fonts"

此-f選項會強制掃描指定的目錄。如果 shell 報告fc-cache未找到目錄，請透過 Linux 發行版的軟體套件管理器安裝 fontconfig 工具，或使用其字型管理工具重新整理字型資訊。軟體包名稱和圖形工具因發行版而異。

若要檢查主機上的字體配置是否識別到該字體系列，請執行：

fc-list | grep -i "Northstar Sans"

將名稱替換為字體出版商提供的字體系列名稱。匹配成功是一項有用的檢查，但這並不能證明 LibreOffice 已更新其自身的字體清單。

重啟 LibreOffice Flatpak

儲存所有開啟的文件並關閉所有 LibreOffice 視窗。從應用程式選單重新啟動 Flatpak，或從終端啟動它：

flatpak run org.libreoffice.LibreOffice

LibreOffice 啟動時可能已經讀取了字體列表，因此如果在 Writer 保持開啟的情況下安裝字體，可能會導致舊的字體列表仍然顯示。在 Mira 的範例中，她等到 LibreOffice 套件完全關閉後，再重新啟動 Writer。如果字體仍然沒有出現，請先嘗試以下簡單的檢查，然後再重新啟動桌面會話；通常情況下，完全重新啟動系統並非首選的故障排除步驟。

確認 LibreOffice 中的字體。

打開 Writer，點擊格式工具列上的「字體系列」框，然後輸入完整的字體系列名稱。您也可以打開字體列表，按字母順序查找。建立一個簡短的測試行，套用新字體，並檢查字母是否顯示正常。如果字體包提供了多種字體，請分別嘗試常規和粗體樣式。

為了進行實際驗證，米拉打開了一份報告模板，將 Northstar Sans 字體應用於標題和段落，保存測試副本，關閉文檔，然後重新打開。這只是一個範例，並非實際測試報告。目的是確認字體系列出現在清單中，並且重新開啟後預期的樣式仍然有效。

為什麼標準的 Flatpak 字體路徑更受歡迎

Flatpak 的設計旨在隔離應用程序，但它透過特定路徑提供宿主字體。文件中記錄的使用者字體對應意味著$XDG_DATA_HOME/fonts無需授予辦公室應用程式存取整個宿主文件系統的權限即可發現字體。--filesystem=host對於這種標準工作流程，無需進行廣泛的權限覆蓋，並且這種覆蓋提供的存取權限遠超字體安裝所需的範圍。

Flatpak 將字體從 ` /usr/share/fonts<path> ` 對應到 ` <path> /run/host/fonts`，從 `<path> ` 對應到 `<path>`，並將使用者資料字體目錄對應到 `<path>`。這涵蓋了常見的系統級和用戶級安裝，但打包、運行時或主機特定的問題仍可能影響個別設定。主機的 fontconfig 設定檔不會暴露給沙盒；這與字體檔案本身是分開的。/usr/local/share/fonts/run/host/local-fonts/run/host/user-fonts

排查仍缺少的字體問題

檢查實際目錄：運行printf '%s\n' "${XDG_DATA_HOME:-$HOME/.local/share}/fonts"。如果XDG_DATA_HOME設定為非標準位置，請將字體放在其fonts子目錄下，而不是假設~/.local/share/fonts。
檢查文件類型和提取方式：確保資料夾包含可用文件.otf或.ttf字體文件，而不僅僅是壓縮文件、預覽 PDF 或許可文件。
檢查字體族名稱：字體檔案名稱並不總是與 LibreOffice 中顯示的字體族名稱相符。請使用fc-list`fontconfig` 指令檢查 fontconfig 偵測到的名稱。
刷新並重新啟動：重新fc-cache -f運行命令並選擇正確的目錄，然後完全關閉並重新開啟 LibreOffice。現有視窗可以保留先前的字體清單。
確認 Flatpak ID：如果 LibreOffice 是從其他來源安裝的，或使用了其他應用程式 ID，flatpak run org.libreoffice.LibreOffice則可能無法啟動該副本。請使用以下命令檢查已安裝的應用程序flatpak list，並使用顯示的 ID 進行安裝。
測試另一個應用程式：如果宿主機的字體清單也找不到該字體，請先修復宿主機的字體安裝。如果宿主機工具可以找到該字體但 Flatpak 找不到，請檢查 Flatpak 運行時和包配置，然後使用應用程式 ID 和運行時詳細資訊存取 Flatpak 包的問題追蹤器。

字體可能出現在您的電腦上，但在其他人的電腦上可能會被替換。文件通常會使用名稱來指稱字型系列，但這並不能保證每個收件者都安裝了相同的字型。如果收件人需要一份完全相同的視覺副本，並且不需要編輯文本，請匯出 PDF 文件並在共享前進行檢查。如果文件必須保持可編輯狀態，請與收件者協調字型的可用性和許可情況。

安裝後預期效果

實際效果顯而易見：新字體系列會出現在 LibreOffice 的字體選擇器中，應用於文本，並且在重新開啟文件時仍保持選取狀態。如果未出現此效果，請在變更沙盒權限之前檢查使用者資料路徑和字型檔案。標準的 Flatpak 映射涵蓋了通常的每個使用者的字體位置；自訂字體配置規則、特殊的 XDG 路徑、備用 LibreOffice 套件以及字體許可限制可能需要單獨處理。

Mira 的假設報告在 Writer 中顯示 Northstar Sans 字體且已儲存的測試副本保持預期格式後即可完成。對於其他用戶，同樣的檢查可以區分缺少宿主字體和應用程式刷新或打包問題，而不會不必要地削弱 Flatpak 沙盒的安全性。