메인 컨텐츠로 이동

도큐사우루스 2021년 회고

· 10분 읽기 분량
조슈아 첸(Joshua Chen)
도큐사우루스에 헌신하고 있습니다.

도큐사우루스는 2021년에도 엄청난 일들을 해냈습니다! We've seen a lot of traction and just crossed 30k stars on GitHub!

We've reached full feature parity with v1 after the release of internationalization, announced our first beta, and welcomed significantly more users this year.

The official v2 release is just around the corner! Follow the roadmap issue for any latest news.

새로 추가된 기능

2021년에 추가된 몇 가지 주요 사항을 살펴보는 것으로 시작해보죠. Remember the todo-list from half a year ago? 다시 꺼내서 우리가 얼마나 멀리 왔는지를 살펴볼 시간입니다!

  • Internationalization: officially released four months after its initial landing in late 2020. Seen great success in many projects
  • Autogenerated sidebars: no need to maintain a big sidebars.js anymore
  • Webpack 5: significantly improved build performance
  • Trailing slash config: seamless integration with any content hosting provider
  • Redesigned mobile navigation: mobile users now enjoy all navigation features as on desktop
  • UI improvements: more accessible quotes, better admonitions, back-to-top button...
  • Blog multi-authors: credit all the amazing contributors that collaborated on one blog post!
  • More blog features: archive page, structured data for SEO, full post content in feeds – empowering you to ship a fully-featured blog in no time
  • Asset collocation: no need for a bloated static folder anymore: colocate your images with Markdown files
  • Sidebar category index pages: category labels can now be associated with pages, enabling better doc organization

시간이 지나면서 코드도 안정적으로 다듬었습니다. 테스트 범위를 개선하고 모든 패키지를 타입스크립트로 이전했습니다. 배포하는 번들 크기도 최대 60%까지 줄였습니다.



도큐사우루스 v2는 지속적으로 성장하고 있습니다. v2는 v1에 비해 8배 많은 설치 횟수를 기록했습니다. 주간 단위 내려받기 숫자도 1월 초 28,066건에서 12월 중순 86,846건으로 3배(+209.4%)가 늘어난 것을 확인했습니다.

Docusaurus v1 vs. v2 npm trends of the year 2021. 도큐사우루스 v2의 설치는 지속적으로 증가하고 있으며 v1은 거의 일정한 추세를 보여주고 있습니다. v1 설치는 10000 정도에서 유지되는 반면 v2는 30000에서 90000으로 증가했습니다. There's a sharp drop from 90000 to 40000 just before the Jan 2022 line.

(하지만, 크리스마스 시즌 하락세는 피해갈 수 없었습니다).

We released 18 versions, going from 2.0.0-alpha.71 to 2.0.0-beta.14. 20일마다 한 번씩 출시한 속도입니다.


  • Stars: 20,460 → 29,679 (+45.1% y/y). 그리고 이 글을 쓰기 직전에 별 3만개를 달성했습니다.
  • Total contributors: 512 → 773 (+51.0% y/y)
  • Dependents: 5,039 → 14,579 (+189.3% y/y) for v2, and 6,311 → 7,581 (+20.1% y/y) for v1
  • Commits: 1,187 commits in the past year, averaging 23 commits every week
  • Issues: 619 issues opened, 505 of them eventually resolved
  • A new core team member (yep, that's me 😝)

별이 증가하는 추세는 매우 긍정적입니다. Compared to similar projects, we are growing at a faster rate:

Stars trend by year of 9 static site generators. Next.js grows the fastest, with Docusaurus at the 4th place in terms of growth rate.

With an 8.4k increase in stars, we are ranked number 3 in this year's JavaScript rising stars of static site generators, preceded only by Next.js and Astro.

Docusaurus placing 3rd in the "Static Sites" ranking list

주요 사용자 사이트

Our showcase has welcomed a few new "favorite" sites that showcase the true potential of Docusaurus 2's pluggable architecture.

Iota wiki light modeIota wiki dark mode

Dyte light modeDyte dark mode

Ionic light modeIonic dark mode


도큐사우루스 사용자의 창의성은 상상을 초월합니다. 🤩 우리는 도큐사우루스의 콘텐츠 기능을 사용하면서 독창적인 테마 디자인을 적용하는 사용자가 점점 더 많아지기를 기대합니다! If your site uses Docusaurus, we would love to have it in our showcase.


As an active moderator on Discord, I can clearly see the community thriving. 자주 묻는 질문을 문서에 추가했고 일부 기능 요청도 반영했습니다. 프로젝트와 커뮤니티는 서로에게 도움이 됩니다. 예를 들어 저는 프로젝트 관리자가 되기 전에 커뮤니티 기여자였습니다.

트위터에서도 굉장한 피드백이 자주 언급되고 있습니다.

@docusaurus is amazing! 이렇게 간단한 사용법은 믿을 수가 없습니다.

추가적인 플러그인, 도구, 컴파일 단계는 필요 없습니다. 지금 바로 사용할 수 있어요.

I love @docusaurus. 도큐사우루스가 없었다면 API, 튜토리얼, 블로그를 워크플로우에 포함해 효율적이고 우아하게 만들 수 없었을 겁니다.

And we keep every one of them in our little box 😄 If you enjoy Docusaurus yourself, keep tagging us with your comments!

As we approach the official release, we are interested in knowing more about what people are doing out there: plugin authors, creators of customized sites, and all new users – please keep us posted about your achievements so we can steer our development to better serve your needs.

앞으로의 일정

지난 몇 달 동안 우리는 도큐사우루스 RC 버전에 대해 이야기해왔으며 이제 거의 다 왔습니다. We have created a dedicated milestone to keep track of all issues to solve before we can confidently progress to the next stage. In short, we want to build a more robust theming workflow, empowering creative site creators to customize our default theme without fearing breaking changes as they upgrade. 여기에는 다음과 같은 사항이 포함됩니다.

  • Guidelines on component organization. 테마 컴포넌트가 적절하게 분류되어 사이트에서 수정하고자 하는 기능을 수행하는 컴포넌트를 바로 찾을 수 있게 합니다.
  • Improvements to the swizzle CLI. 사용자가 불편함 없이 사용할 수 있고 가능한 모든 시나리오에 적용할 수 있게 합니다.
  • Refactoring our theme APIs. 바꿀 수 있는 모든 컴포넌트는 실제로 바꿀 수 있도록 UI가 아닌 컴포넌트를 재배치합니다.
  • Docs. 코드를 처음 작성하는 개발자부터 숙련된 개발자까지 모두가 필요한 정보를 문서에서 얻을 수 있기를 바랍니다. 모든 기술 수준에 도움을 줄 수 있는 좀 더 진보적인 튜토리얼을 구성합니다.

Read more about plans for Docusaurus 2.0 in this roadmap issue. 2.0은 커뮤니티의 도움으로 더 큰 릴리스 될 것입니다. 마일스톤 이슈에 대한 의견과 제안은 언제든지 공유해주세요!

코어 팀에서 GA 릴리스를 제공하기 위해 열심히 노력하고 있으며 2.0 이후 다른 유용한 기능은 마이너 버전으로 릴리스할 계획입니다. We have even made further plans for architectural changes in 3.0!

도큐사우루스 2.0 공식 출시와 함께 훨씬 더 많은 v1 사이트에서 이를 채택하고 마이그레이션할 것을 확신하고 있습니다.

We'd like to express our gratitude to all the contributors in 2021, including:

  • The core team: Alexey Pyltsyn, Sébastien Lorber, Joshua Chen, and Yangshun Tay for moderating the community, publicizing Docusaurus, triaging issues, and implementing new features
  • Joel Marcey for creating Docusaurus and supporting its development all along
  • The Algolia team for helping Docusaurus users migrate to the new DocSearch and answering search-related questions
  • 코드에 기여하고 문서를 개선하고 디스코드에서 질문에 답변해주신 모든 커뮤니티 회원에게 감사드립니다.

2021년에도 모두 수고하셨습니다. 멋진 2022년을 맞이하자구요!