[Trouble Shooting] 깃허브 블로그 생성 과정 Jekyll 오류 모음

minimal-mistakes 기반 github blog를 만들면서 생기는 오류들을 추가할 예정

---

1. 댓글 설정 - disqus shortname

• Setting -> General 에 들어가면 shotrname을 확인 할 수 있다.
• Website Name 이 git.blog 면 Shorname 은 git-blog 로 표시된다.

2. Timezone

첫 번째 시도 : tzinfo, tzinfo-data 설치

tzinfo 설치

gem install tzinfo 설치 

tzinfo-data 설치

gem install tzinfo-data

설치 후 jekyll serve 실행

bundle exec jekyll serve 

❗ 여전히 동일한 오류 발생

If you've run Jekyll with bundle exec, ensure that you have included the tzinfo gem in your Gemfile as well.

---

두번째 시도 : Gemfile 파일 tzinfo 내용 추가

1. Gemfile 파일 열기
   

2. 내용 수정

gem 'tzinfo'
gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw]

❕오류 해결

---

출처 : Jekyll 빌드 오류 - tzinfo 종속성 , 타임존 관리

---

3. LaTeX 수식 문법

• 문제 상황 : $$ LaTeX 수식 $$ 으로 표기시 올바르게 표시가 안되는 경우 발생

• 해결 방법 : mathjax-support.html의 코드 수정

        tex2jax: {
          inlineMath: [ ['$','$'], ["\\(","\\)"] ],
          displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
        processEscapes: true,
      }

4. breadcrumbs 한글 깨짐 현상

• 문제 상황 : 포스트 상단 계층구조 표시 부분에서 한국어 깨짐 현상 발생

• 해결 방법 : breadcrumbs.html 에서 각 crumb을 디코딩한 변수를 만들도록 수정

<nav class="breadcrumbs">
  <ol itemscope itemtype="https://schema.org/BreadcrumbList">
    
    <!--디코딩된 Crumb 변수 생성-->
    {% assign crumbs = page.url | split: '/' %}
    {% assign i = 1 %}
    {% for crumb in crumbs offset: 1 %}
      {% assign decoded_crumb = crumb | url_decode %}
      {% if forloop.first %}
        <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
          <a href="{{ '/' | relative_url }}" itemprop="item"><span itemprop="name">{{ site.data.ui-text[site.locale].breadcrumb_home_label | default: "Home" }}</span></a>
          <meta itemprop="position" content="{{ i }}" />
        </li>
        <span class="sep">{{ site.data.ui-text[site.locale].breadcrumb_separator | default: "/" }}</span>
      {% endif %}
      {% if forloop.last %}
        <li class="current">{{ decoded_crumb }}</li>
      {% else %}
        {% assign i = i | plus: 1 %}
        <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
          <a href="{{ decoded_crumb | downcase | replace: ' ', '-' | prepend: path_type | prepend: crumb_path | relative_url }}" itemprop="item">
            <span itemprop="name">{{ decoded_crumb | replace: '-', ' ' | replace: '%20', ' ' | capitalize }}</span>
          </a>
          <meta itemprop="position" content="{{ i }}" />
        </li>
        <span class="sep">{{ site.data.ui-text[site.locale].breadcrumb_separator | default: "/" }}</span>
      {% endif %}
    {% endfor %}
  </ol>
</nav>

• 결과