카나리 릴리스

도큐사우루스에 카나리(Canary) 릴리스 시스템을 도입했습니다.

It permits you to test new unreleased features as soon as the pull requests are merged.

It is a good way to give feedback to maintainers, ensuring the newly implemented feature works as intended.

참고

카나리 릴리스를 운영중인 사이트에 반영하는 것은 위험해보이지만 실제로는 그렇지 않습니다.

카나리 릴리스는 모든 자동화 테스트를 통과했으며 현재 운영중인 도큐사우루스 사이트에 먼저 반영해서 사용하고 있는 기능입니다.

경고

The canary version shown below may not be up-to-date. Please go to the npm page to find the actual version name.

카나리 npm 배포 태그

For any code-related commit on main, the continuous integration will publish a canary release under the @canary npm dist tag. 이 작업은 대략 10분 정도 걸립니다.

You can see on npm the current dist tags:

• latest: stable releases (Current: 3.9.2)
• canary: canary releases (예시: 0.0.0-4922)

팁

Make sure to use the latest canary release and check the publication date (sometimes the publish process fails).

참고

Canary versions follow the naming convention 0.0.0-commitNumber.

카나리 릴리스 사용하기

Take the latest version published under the canary npm dist tag (예시: 0.0.0-4922).

Use it for all the @docusaurus/* dependencies in your package.json:

-  "@docusaurus/core": "^3.9.2",
-  "@docusaurus/preset-classic": "^3.9.2",
+  "@docusaurus/core": "0.0.0-4922",
+  "@docusaurus/preset-classic": "0.0.0-4922",

종속적인 모듈을 설치한 후 사이트를 시작합니다.

npm

npm install
npm start

Yarn

yarn install
yarn start

pnpm

pnpm install
pnpm start

Bun

bun install
bun start

You can also upgrade the @docusaurus/* packages with command line:

npm

npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary

Yarn

yarn add --exact @docusaurus/core@canary @docusaurus/preset-classic@canary

pnpm

pnpm add --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary

Bun

bun add --exact @docusaurus/core@canary @docusaurus/preset-classic@canary

경고

Make sure to include all the @docusaurus/* packages.

For canary releases, prefer using an exact version instead of a semver range (avoid the ^ prefix).