도큐사우루스 2 베타가 나왔습니다!!!

After a lengthy alpha stage in order to ensure feature parity and quality, we are excited to officially release the first Docusaurus 2 beta.

With the announcement of this beta, the team is even more confident that Docusaurus 2 is ready for mainstream adoption!

도큐사우루스를 사용해도 될까요?

Don't fear the beta tag!

도큐사우루스 2는 이미 많은 곳에서 사용하고 있으며 빠르게 성장하고 있습니다.

To get a fuller understanding of the quality of current Docusaurus 2 sites, our new showcase page allows you to filter Docusaurus sites by features, so you may get inspired by real-world production sites with a similar use-case as yours!

Don't miss our favorite sites; they all stand out with something unique:

도큐사우루스 2는 왜 그렇게 알파 기간이 길었나요?

It's hard to believe that the first alpha release v2.0.0-alpha.0 was 2 years ago 😳 , unusually long for a software alpha.

코드 바닥부터 아키텍처를 다시 만들었기 때문에 베타 단계로 넘어가기 전에 도큐사우루스 2의 안정성과 기능에 대한 확신이 필요했습니다. 베타라는 건 높은 수준의 품질을 보장해야 하기 때문이죠. We are happy to say that Docusaurus 2 has reached feature parity with Docusaurus 1 with i18n, and it has been successfully adopted by many Docusaurus sites (see i18n showcase).

이제 우리는 도큐사우루스 2의 핵심 기능이 베타 단계로 넘어갈 만큼 충분히 안정적이라고 확신합니다.

베타에서는 어떤 작업이 남아있나요?

이제 도큐사우루스 2는 주요 기능이 완성됐으며 안정적인 수준에 올라왔습니다. 베타 단계에서의 목표는 새로운 사용자에게는 도큐사우루스 2를 제품으로 사용할 수 있다는 것에 대한 확신을 심어주고 도큐사우루스 1 사용자는 버전 2로 이전하고 공식적으로 도큐사우루스 1을 더는 사용하지 않도록 하는 것입니다. 물론 발견되는 이슈와 버그는 계속 대응해나갈 것입니다.

In addition, we will use the beta phase to improve our theming system.

우리가 하고 싶은 목표는 아래와 같습니다.

• easier to implement a custom theme, including for ourselves. We want to provide multiple official themes (including Tailwind CSS) for a long time.

• safer to extend an existing theme: it can be painful to upgrade a highly customized Docusaurus site, as customizations can conflict with internal changes. 그래서 좀 더 명확하게 정의된 테마 API가 공개되어야 하고 안전하게 코드를 수정할 수 있도록 보장해주어야 합니다.

We will build a better theming infrastructure and refactor the classic theme to use it.

여러분이 사이트를 커스터마이징할 때 이런 개선들은 유용하게 반영될 겁니다.

새로운 소식이 있나요?

아마 아는 분들도 있겠지만, 최근 추가된 2가지 기능은 아래와 같습니다.

• Auto-generated sidebars: no need to maintain a sidebars.js file anymore!
• Webpack 5 / PostCSS 8: persistent caching significantly speeds up rebuild time!

다음 단계는 뭔가요?

2.0 공식 버전을 릴리스할 겁니다!

To get there, we will continue to fix bugs and implement the most wanted features, including:

• Sidebar category index pages
• Better mobile navigation UX
• Better admonition design
• CSS-in-JS support
• Improve build time performance
• Extend Docusaurus plugins, CMS integration
• Fix trailing slashes and relative link issues
• Better compatibility with CommonMark
• Upgrade to MDX 2.0

글을 마치며

도큐사우루스는 흥미진진한 나날을 보내고 있습니다.

We are inspired by the positive feedback about Docusaurus, and discover new sites online every single day.

이번 베타 릴리스는 정말 기대되는 작업입니다. 우리는 도큐사우루스를 더 많은 이들이 사용할 수 있도록 노력하면서 품질과 안정성을 높이고 있습니다. 기존 도큐사우루스 사이트를 도큐사우루스 2로 이전하는 것이 어려웠던 분들에게는 지금이 딱 좋은 시기입니다. 베타 기간이 끝나면 도큐사우루스 1은 사용 중단(deprecate) 상태가 됩니다. 그 전에 최신 버전으로 옮기는 것을 권장합니다. 도움이 필요하다면 언제든지 알려주세요.

새로운 소식을 읽어주신 분들과 도큐사우루스를 지원하는 모든 커뮤니티에 항상 감사하고 있습니다. 🤗