如何使用 WhiskeyMate 知識庫

<h2>總覽</h2><p>The WhiskeyMate Knowledge Base 是一個應用程式內（iOS/Android）和網頁（瀏覽器）版的幫助文章庫。文章儲存在 Firestore 的 <code>knowledge_articles</code> 集合中，包含格式化的 HTML 內容、標籤/關鍵字以及計數器（瀏覽次數 + 有用投票）。</p><h2>開啟知識庫</h2><ul> <li><strong>iOS</strong>：開啟<strong>個人檔案</strong>，然後點擊<strong>幫助</strong>（在個人檔案選單中）。</li> <li><strong>Android</strong>：開啟應用程式的<strong>漢堡選單</strong> → <strong>幫助與資訊</strong> → <strong>知識庫</strong>。</li> <li><strong>網頁版</strong>：在瀏覽器中開啟 <code>whiskeymate.net/knowledge_articles.html</code>。</li></ul><h2>在 iOS 上使用知識庫</h2><ul> <li><strong>搜尋</strong>：使用搜尋欄位來比對文章的<strong>標題</strong>、<strong>副標題</strong>或<strong>搜尋關鍵字</strong>。</li> <li><strong>排序</strong>：切換<strong>最新</strong>、<strong>優先</strong>和<strong>最多瀏覽</strong>。</li> <li><strong>開啟文章</strong>：點擊文章以查看其特色圖片（如果可用）、中繼資料（瀏覽次數/作者/平台）和格式化的 HTML 內文。</li> <li><strong>投票有用/無用</strong>：您可以對文章進行評分；WhiskeyMate 會相應地更新文章的有用計數器。</li></ul><h2>在 Android 上使用知識庫</h2><ul> <li><strong>搜尋</strong>：使用搜尋欄位來比對文章的<strong>標題</strong>、<strong>副標題</strong>或<strong>搜尋關鍵字</strong>。</li> <li><strong>排序</strong>：切換<strong>最新</strong>、<strong>優先</strong>和<strong>最多瀏覽</strong>。</li> <li><strong>開啟文章</strong>：點擊文章以查看其特色圖片（如果可用）、中繼資料和格式化的 HTML 內文。</li> <li><strong>投票有用/無用</strong>：您可以對文章進行評分；WhiskeyMate 會相應地更新文章的有用計數器。</li></ul><h2>在網頁版上使用知識庫</h2><ul> <li><strong>依類別瀏覽</strong>：左側邊欄將文章按類別分組。類別可展開/收合以顯示其文章。</li> <li><strong>搜尋（側邊欄）</strong>：側邊欄搜尋會根據<strong>文章標題</strong>篩選文章列表。</li> <li><strong>搜尋（收合/行動版）</strong>：當側邊欄收合時，主內容區域的搜尋欄位會使用<strong>標題</strong>、<strong>副標題</strong>和<strong>內文</strong>來尋找符合項目。</li> <li><strong>上一頁/下一頁</strong>：使用頁面導覽按鈕，依 internalId 順序逐步瀏覽文章。</li> <li><strong>相關文章</strong>：如果文章包含 <code>relatedArticles</code>，頁面會顯示一個<strong>相關文章</strong>區塊，讓您可以直接跳轉到這些文章。</li></ul><h2>疑難排解</h2><ul> <li><strong>沒有結果？</strong> 嘗試使用較短的搜尋詞。在 iOS/Android 上，搜尋會比對標題/副標題/關鍵字（而非完整的內文）。</li> <li><strong>內容看起來很奇怪？</strong> 文章是從 HTML 渲染的；某些格式取決於平台應用程式內的渲染器。</li> <li><strong>計數未更新？</strong> 瀏覽/有用計數器透過 Firestore 更新，可能需要一些時間才能在所有地方反映。</li></ul>