메인 컨텐츠로 이동
Version: 2.0.0-beta.16 🚧

문서 개요

문서 기능을 사용해 계층 구조 내에서 사용자는 마크다운 파일을 작성할 수 있습니다.

info

전체 옵션 목록은 문서 플러그인 API 레퍼런스 문서를 참고하세요.

문서 ID

모든 문서는 유일한 id를 가집니다. 기본적으로 문서 id는 루트 디렉터리에 상대 경로로 표시되는 (확장자를 제외한)문서 이름과 같습니다.

예를 들어 greeting.md 문서의 id는 greeting입니다. 그리고 guide/hello.md 문서의 id is guide/hello입니다.

website # Root directory of your site
└── docs
├── greeting.md
└── guide
└── hello.md

However, the last part of the id can be defined by the user in the front matter. 예를 들어 guide/hello.md 문서에서 아래와 같이 프런트 매터를 정의했다면 idguide/part1이 됩니다.

---
id: part1
---

Lorem ipsum

문서 URL의 마지막에 오는 항목을 좀 더 조작하고 싶다면 slug(기본값은 id와 같습니다)를 추가할 수도 있습니다.

---
id: part1
slug: part1.html
---

Lorem ipsum
note

다음과 같이 사용할 수 있습니다.

  • 절대 경로 슬러그: slug: /mySlug, slug: /...
  • 상대 경로 슬러그: slug: mySlug, slug: ./../mySlug...

홈페이지 문서

If you want a document to be available at the root, and have a path like https://docusaurus.io/docs/, you can use the slug front matter:

---
id: my-home-doc
slug: /
---

Lorem ipsum

문서 전용 모드

A freshly initialized Docusaurus site has the following structure:

example.com/                                -> generated from `src/pages/index.js`

example.com/docs/intro -> generated from `docs/intro.md`
example.com/docs/tutorial-basics/... -> generated from `docs/tutorial-basics/...`
...

example.com/blog/2021/08/26/welcome -> generated from `blog/2021-08-26-welcome/index.md`
example.com/blog/2021/08/01/mdx-blog-post -> generated from `blog/2021-08-01-mdx-blog-post.mdx`
...

All docs will be served under the subroute docs/. But what if your site only has docs, or you want to prioritize your docs by putting them at the root?

Assume that you have the following in your configuration:

docusaurus.config.js
module.exports = {
// ...
presets: [
'@docusaurus/preset-classic',
{
docs: {
/* docs plugin options */
},
blog: {
/* blog plugin options */
},
// ...
},
],
};

To enter docs-only mode, change it to like this:

docusaurus.config.js
module.exports = {
// ...
presets: [
'@docusaurus/preset-classic',
{
docs: {
routeBasePath: '/', // Serve the docs at the site's root
/* other docs plugin options */
},
blog: false, // Optional: disable the blog plugin
// ...
},
],
};

Note that you don't necessarily have to give up on using the blog or other plugins; all that routeBasePath: '/' does is that instead of serving the docs through https://example.com/docs/some-doc, they are now at the site root: https://example.com/some-doc. The blog, if enabled, can still be accessed through the blog/ subroute.

Don't forget to put some page at the root (https://example.com/) through adding the front matter:

docs/intro.md
---
slug: /
---

This page will be the home page when users visit https://example.com/.
caution

If you added slug: / to a doc to make it the homepage, you should delete the existing homepage at ./src/pages/index.js, or else there will be two files mapping to the same route!

Now, the site's structure will be like the following:

example.com/                       -> generated from `docs/intro.md`
example.com/tutorial-basics/... -> generated from `docs/tutorial-basics/...`
...
tip

도큐사우루스 2의 블로그 기능만 사용하고자 할 때는 "블로그 전용 모드"를 적용할 수 있습니다. 문서 전용 모드와 비슷한 방법을 적용합니다. 블로그 전용 모드에서 안내하는 설치 절차를 참고하세요.