본문으로 건너뛰기

도큐사우르스를 시작 할 때

초기설정​

  1. /docusaurus.config.js 대부분으 설정은 이곳에서 한다.
    설정해야 할 것들이 상당히 많다.

  2. /sidebars.js 사이드바에 대한 설정을 이곳에서 한다.
    추가하거나 이름변경을 하려면 이곳에서 한다.

  3. /src/components/index.js 잘 모르겠으면 일단은 내 사이트에 맞게 적절히 수정한다.

  4. /pages/index.js
    홈 화면과 헤더에 대한 설정을 이곳에서 한다.

i18n 적용​

/i18n/ja 식으로 디렉토리를 만들고
그 밑에

/i18n/ja/docusaurus-plugin-content-blog  
/i18n/ja/docusaurus-plugin-content-docs  
/i18n/ja/docusaurus-theme-classic

이렇게 각각 따로 디렉토리를 만들고 json설정파일을 작성.
그 후에 번역된 컨텐츠물을 위치시킨다

docusaurus.config.js에 언어설정 기능을 추가한다

디자인용 svg를 준비​

맘에드는 png파일을 찾고, 이를 svg로 변형하여 사용한다.

draft:true 옵션을 활용​

슬슬 md파일을 작성해보게 되는데 이 때 초기에 들어있는 md파일을 굳이 지우지 않아도 된다.
draft:true를 하게되면 초안상태가 되므로 dev에서는 보이나, 실제 build할때는 적용되지 않는다.

검색기능​

검색기능은 여러가지 방식이 있다.
algoria는 소스를 오픈해야 하므로 개인적으로 쓰고싶지 않다.
lunr.js로 작업하는것이 나을것으로 판단된다.

Syntax Highlight​

기본적으로 코드 레벨에서의 Syntax Highlight기능은 빠져있는듯 싶다.
Java코드를 입력 해 봤는데 변동이 없다.
이부분도 추가로 옵션을 찾아보고 작업해야 할 것 같다.