TIL - Jekyll(just-the-docs) 한국 검색 기능 추가

2023.11.25 (SAT)


기존 Just the Docs에서는 lunr.js를 이용한 검색 기능을 제공한다.
하지만, 한국어는 정식으로 지원하지 않는 lunr다..

그래서 해결책은 lunr-languages에서 제공한 js를 이용하는 것이다.

  1. lunr.ko.js, lunr.multi.js, lunr.stemmer.support.js를 다운 받아, assets/js/vendor 디렉토리(lunr.min.js가 존재하는 디렉토리)에 넣어준다.

    1번 이미지

  2. lunr.min.js가 임포트 된 head.html에 다음과 같은 순서로 임포트한다.

    2번 이미지

    가장 오랜 시간을 잡아먹은,,, 순서를 지키지 않았더니, 한글 검색은 물론이고 영어 검색도 먹통이 되었다.

  3. just-the-docs.js 파일에 아래 코드를 추가시켜준다.

     var index = lunr(function(){
             this.use(lunr.multiLanguage('en', 'ko'));
             // ...
    
  • 아래와 같이 한글 검색 기능도 된다! 3번 이미지