Docusaurus는 문서를 build/의 정적 사이트로 빌드합니다. 모든 문서와 블로그 글이 HTML이 되며, 검색과 탐색은 브라우저에서 실행됩니다. Lobsite는 그 폴더를 호스팅합니다. npm run build를 실행한 다음 npx lobsite를 실행하면 HTTPS가 적용된 *.lobsite.app 주소로 문서가 공개됩니다. 배포마다 전용 URL도 생기므로 공개 전에 문서 변경 사항을 검토하기 편리합니다.
작동 방식
npm run build로 문서를 빌드하세요. Docusaurus가build/에 사이트를 작성하며, 기본적으로 깨진 링크가 있으면 빌드가 실패합니다.- 프로젝트에서
npx lobsite를 실행하세요.static/이 아닌build/를 배포합니다. 첫 배포는 계정이 필요 없으며 6시간 동안 유지됩니다. - 가져오기 링크로 무료 계정에 사이트를 유지하세요. 그 후
npm run build && npx lobsite로 같은 주소가 업데이트됩니다.
url, baseUrl, 후행 슬래시
// docusaurus.config.js
export default {
url: "https://my-docs.lobsite.app",
baseUrl: "/",
};
- **
url**은 사이트 주소입니다. Docusaurus는 이를 대표 링크와 사이트맵에 사용합니다. - **
baseUrl**은 Lobsite에서/입니다. GitHub Pages 프로젝트 사이트는/repo-name/을 사용하며, 이를 그대로 두면 모든 에셋 링크가 깨집니다. - **
trailingSlash**는 생략할 수 있습니다.docs/intro/index.html로 빌드된 문서는/docs/intro/에서 열리고,/docs/intro는 그곳으로 리디렉션됩니다.
문서 변경 사항 검토
문서는 많은 사람이 작성하고 다른 사람이 검토하는 경우가 많습니다. lobsite deploy --preview는 공개 문서를 건드리지 않고 빌드를 전용 URL에 게시하므로, 검토자는 실제 모습 그대로 변경 사항을 읽을 수 있습니다. lobsite promote로 공개하고, lobsite rollback으로 한 단계에 이전 버전으로 돌아갑니다. 페이지를 옮기나요? 검색 결과와 다른 사이트의 링크가 계속 작동하도록 이전 경로의 리디렉션을 lobsite.toml에 추가하세요. 리디렉션 생성기가 규칙을 작성해 줍니다. AI 코딩 에이전트는 질문하느라 멈추지 않는 npx -y lobsite --yes로 같은 배포를 실행할 수 있습니다.
공개 전에 미리 보세요. 리디렉션까지 포함해 클릭 한 번으로 롤백합니다.
파일은 해시로 저장됩니다. 변경되지 않은 사이트를 다시 배포하면 0바이트가 업로드됩니다.
모든 사이트는 첫 배포부터 HTTPS가 적용된 *.lobsite.app 주소를 받습니다.
리디렉션, 헤더, 폼은 lobsite.toml에 있으며 각 배포와 함께 이동합니다.
에이전트에서 실행하면 질문하지 않으며, URL과 가져오기 링크가 담긴 Tell the user: 줄을 출력합니다.
모든 한도가 공개되어 있고, 모든 오류는 다음에 할 일을 알려 줍니다.
Docusaurus 호스트 비교
| Lobsite | GitHub Pages | Netlify | Vercel | |
|---|---|---|---|---|
| 문서 빌드 | 아니요: build/ 배포 |
GitHub Actions 또는 docusaurus deploy |
예 | 예 |
| 배포별 미리보기 URL | 예 | 아니요 | 예 | 예 |
| 한 단계 롤백 | 예 | 커밋 되돌리기 | 예 | 예 |
| 첫 배포 전 계정 | 불필요: 6시간 공개 후 무료로 유지 | 필요, 저장소도 필요 | 필요 | 필요 |
| 커스텀 도메인 | 예, 무료 | 예, 무료 | 예 | 예 |
GitHub Pages는 코드 옆에 두는 오픈 소스 문서에 잘 맞습니다. Lobsite는 로컬이나 CI에서 빌드하고, 호스팅을 위한 Git 워크플로 없이 미리 보고, 승격하고, 롤백하려는 문서에 적합합니다.
자주 묻는 질문
Lobsite에서 Docusaurus는 어떤 baseUrl을 사용해야 하나요?
/입니다. 사이트는 주소의 최상위에서 제공됩니다. /repo-name/은 GitHub Pages 프로젝트 사이트에만 필요합니다.
Docusaurus 검색이 정적 호스트에서 작동하나요?
네. Algolia DocSearch는 방문자의 브라우저에서 실행되고, 로컬 검색 플러그인은 인덱스를 build/에 빌드합니다. 둘 다 서버가 필요 없습니다.
버전이 있는 Docusaurus 문서를 호스팅할 수 있나요?
네. 모든 버전이 자체 페이지로 build/에 빌드되어 함께 배포됩니다. 마지막 배포 이후 변경된 파일만 업로드됩니다.
Docusaurus 사이트는 얼마나 클 수 있나요?
무료 플랜에서는 배포당 파일 100개, 50MB까지이며 대부분의 문서 사이트에 충분합니다. 버전이나 이미지가 많은 큰 문서는 곧 제공될 유료 플랜이 필요합니다. 모든 한도는 한도 표에 있습니다.