Docusaurus

Docusaurus는 React와 Node.js로 만들어진 정적 사이트 생성기입니다. Markdown 파일을 가져와 사용자가 기대하는 모든 기능을 갖춘 완전한 문서 웹사이트를 생성합니다. 처음부터 웹사이트를 만드는 것과 달리, Docusaurus는 어려운 부분을 대신 처리해 줍니다.

이 도구는 MDX를 사용하여 Markdown 파일 안에 바로 인터랙티브한 React 컴포넌트를 추가할 수 있습니다. 이를 통해 추가 작업 없이도 문서를 더욱 흥미롭게 만들 수 있습니다. Algolia가 지원하는 내장 검색 기능, 다양한 제품 릴리스를 위한 버전 관리, 70개 이상의 언어를 지원하는 번역 도구도 포함되어 있습니다.

정적 파일을 생성하기 때문에 문서가 빠르게 로드되며 어디서든 호스팅할 수 있습니다. 사이트는 모바일 기기에서도 잘 작동하며 속도와 접근성을 위한 최신 웹 표준을 준수합니다.

Docusaurus 시작은 간단하며 몇 분만 투자하면 됩니다:

• 컴퓨터에 Node.js 버전 20 이상을 설치한 후, 터미널에서 설정 명령어를 실행하여 새 사이트를 만드세요.

• docs 폴더 안에 Markdown 파일로 문서를 작성하세요. 각 파일은 웹사이트의 한 페이지가 됩니다.

• 구성 파일을 편집하여 디자인을 맞춤 설정하세요. 색상 변경, 로고 추가, 내비게이션 메뉴 설정이 가능합니다.

• 로컬 미리보기 명령어를 사용해 작업 중인 변경 사항을 브라우저에서 즉시 확인하세요.

• blog 폴더에 날짜가 포함된 파일명으로 Markdown 파일을 만들어 블로그 게시물을 추가하세요.

• 게시할 준비가 되면 빌드 명령어를 실행해 정적 파일을 생성한 후, GitHub Pages, Netlify, Vercel 등 원하는 웹 호스트에 업로드하세요.

이 도구는 자세한 가이드와 도움이 되는 커뮤니티를 포함하고 있어 문제가 생기면 지원받을 수 있습니다.

• MIT 라이선스를 가진 무료 오픈 소스

• React와 Node.js로 구축

• Markdown 및 MDX로 콘텐츠 작성

• Algolia DocSearch가 내장된 검색 기능

• 제품 출시를 위한 버전 관리

• 70개 이상의 언어 지원

• 블로그와 문서가 하나의 사이트에 통합

• 다크 모드 및 반응형 디자인

• 빠른 정적 사이트 생성

• 어떤 호스트에도 손쉬운 배포