메인 컨텐츠로 이동

도큐사우루스 2.2

· 3분 읽기 분량
세바스티앵 로버(Sébastien Lorber)
세바스티앵 로버(Sébastien Lorber)
Docusaurus maintainer, This Week In React editor

We are happy to announce Docusaurus 2.2.

업그레이드 과정은 간단합니다. 도큐사우루스는 릴리스 프로세스 문서에 설명된 대로 시맨틱 버전 체계를 준수해 마이너 버전은 하위 호환성을 유지합니다.

Docusaurus 2.2 social card

새로 추가된 기능​

머메이드 다이어그램​

In #7490, we added support for Mermaid diagrams. This fills the gap between GitHub Flavored Markdown which also added support recently. 이제 여러분은 마크다운 코드 블록을 사용해 머메이드 다이어그램을 작성할 수 있습니다.

```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!
```
http://localhost:3000

Make sure to check the documentation, and the more advanced examples

Config headTags​

In #8151, we added the ability to apply arbitrary HTML <head> tags to all pages of your site.

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

접근성​

접근성 관련 몇 가지 기능을 개선했습니다.

  • #8207: improves keyboard navigation for mobile drawer hamburger button
  • #8161: improves keyboard navigation for tabs
  • #8204: makes the skip to content button support progressive enhancement
  • #8174: improves screen reader announcement when toggling between light/dark mode

개발자 경험​

유효성 검사를 더 엄격하게 만들고 오류 메시지를 개선했습니다.

  • #8234: in case of doc processing failure, prints the problematic markdown file path in the error message
  • #8192 and #8159: validates siteConfig.url more strictly and with better error message
  • #8066: makes config url and baseUrl fail-safe and less sensitive to the presence or absence of a leading or trailing slash

번역​

여러 언어에 대한 기본 테마 번역을 완료했습니다.

  • 🇹🇷 #8105: completes Turkish translations
  • 🇷🇺 #8253: completes Russian translations
  • 🇫🇷 #8243: completes French translations
  • 🇯🇵 #8075: completes Japanese translations
팁

테마 번역의 완료는 계속 관심이 필요한 요소이며 도큐사우루스에 기여할 수 있는 쉬운 방법입니다. 새로운 테마 기능을 계속 추가하고 있으며 이에 따라 새로운 번역이 필요한 경우가 많습니다.

기타 변경​

기타 주목할만한 변경 사항은 다음과 같습니다.

  • #8210: the docusaurus swizzle CLI has a new --config option
  • #8109: mobile navigation performance optimizations, prefetch resources earlier
  • #8059: versions/locales navbar dropdowns preserve hash and querystring on navigation
  • #8227: the client redirect plugin preserves hash and querystring on redirect

Check the 2.2.0 changelog entry for an exhaustive list of changes.