跳至主要內容

Docusaurus 2.2

·3 分鐘閱讀
Sébastien Lorber
Sébastien Lorber
Docusaurus 維護人員、This Week in React 編輯器

我們很高興宣布推出Docusaurus 2.2。

升級應該很簡單：正如我們的版本流程文件中所說明的，次要版本會遵守語意化版本控管。

Docusaurus 2.2 social card

重點​

Mermaid 圖表​

在#7490，我們加入了對 Mermaid 圖表的支援。這填補了 GitHub Flavored Markdown 的空白，而他也最近加入支援。你可以使用 Markdown 程式碼區塊來建立 Mermaid 圖表

```mermaid
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Health check
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!
```
https://127.0.0.1:3000

請務必查看文件，以及較進階的範例

配置headTags​

在 #8151 中，我們新增了套用任意 HTML <head> 標籤至您網站所有頁面的功能。

docusaurus.config.js
module.exports = {
  headTags: [
    {
      tagName: 'link',
      attributes: {
        rel: 'icon',
        href: '/img/docusaurus.png',
      },
    },
  ],
};

無障礙​

我們進行了多項無障礙改善

  • #8207：改善行動裝置抽屜漢堡按鈕的鍵盤導覽
  • #8161：改善索引標籤的鍵盤導覽
  • #8204：讓跳轉至內容按鈕支援漸進式增強功能
  • #8174：在明暗模式之間切換時改善螢幕朗讀

開發人員體驗​

我們讓驗證更嚴格，並改善錯誤訊息

  • #8234：在文件處理失敗的情況下，在錯誤訊息中列印有問題的標記檔案路徑
  • #8192 與 #8159：更嚴格且搭配更好錯誤訊息地驗證 siteConfig.url
  • #8066：讓組態 url 和 baseUrl 防呆，並降低對開頭或結尾斜線存在與否的敏感度

翻譯​

我們完成了支援多國語言的預設佈景主題翻譯

  • 🇹🇷 #8105：完成土耳其語翻譯
  • 🇷🇺 #8253：完成俄語翻譯
  • 🇫🇷 #8243：完成法語翻譯
  • 🇯🇵 #8075：完成日語翻譯
提示

完成主題翻譯是一項進行中的工作，也是為 Docusaurus 做出貢獻的簡易方式。我們定期新增主題功能，為了這些功能，我們常常會需要新的翻譯。

其他變更​

其他值得注意的變更包括

  • #8210：docusaurus swizzle CLI 已有新的 --config 選項
  • #8109：行動裝置導覽效能最佳化，提早預先擷取資源
  • #8059：版本/語言導覽列下拉式選單在導覽時會保留雜湊值和查詢字串
  • #8227：客戶端重新導向外掛程式在重新導向時會保留雜湊值和查詢字串

查看2.2.0 變更記事條目，以取得完整變更清單。