<div id="readability-page-1" class="page"><article>
    <div>

                
                <div>
                    <details open="">
                        <summary accesskey="c" title="(Alt + C)">
                            <p>Table of Contents</p>
                        </summary>
                        <nav id="TableOfContents">
  <ul>
    <li>
      <ul>
        <li><a href="#전환하면서-느낀-점">전환하면서 느낀 점</a></li>
        <li><a href="#전환-작업하면서-알아야-했던-것들">전환 작업하면서 알아야 했던 것들</a></li>
        <li><a href="#전체적인-소감">전체적인 소감</a></li>
      </ul>
    </li>
  </ul>
</nav>
                    </details>
                </div>
                
                <p>사용하던 github pages 기반 툴을 <code>jekyll</code> 에서 <code>hugo</code> 로 전환해보았다. 아래는 그 과정에서 느낀 점을 정리해보았다.</p>
<h2 id="전환하면서-느낀-점">전환하면서 느낀 점</h2>
<h3 id="hugo-전환한-이유"><code>hugo</code> 전환한 이유</h3>
<p><code>jekyll</code> 에서 <code>hugo</code> 로 전환한 이유는 아래와 같다.</p>
<ul>
<li><code>hugo</code> 가 반응속도가 훨~~씬 빠르다는 것. (jekyll 은 2 s, hugo 는 70ms )</li>
<li>theme 를 커스터마이징 하기가 손쉽다는 것.</li>
<li>매뉴얼이 잘 구성되어 있고, 심지어 영상으로 소개해준다는 것.</li>
<li>그리고 무엇보다 <code>jekyll-paginate v2</code> 를 쓰다가 <code>github page</code> 에서 동작을 안해서.. (사실 이게 제일 크다)</li>
</ul>
<h3 id="hugo-에서-불편한-점"><code>hugo</code> 에서 불편한 점</h3>
<ul>
<li><code>jekyll</code> 에서는 plugin 으로 구현 가능한 것들이 직접 핸들링 해줘야 하는 부분들이 있었다.</li>
<li><code>github page</code> 가 native 로 연결되지 않아서 별도로 관리해주어야 한다는 점.</li>
<li>템플릿 문법이 상대적으로 낯설어서 적응하는데 애를 먹었다. (RTFM)</li>
</ul>
<h2 id="전환-작업하면서-알아야-했던-것들">전환 작업하면서 알아야 했던 것들</h2>
<ul>
<li>
<p>theme 는 별도로 구성하는게 편하다</p>
<p>매뉴얼에는 별도의 theme 프로젝트를 git submodule 로 관리하는걸 안내하고 있다. 내 경우는 아예 새로 만들었다.</p>
</li>
<li>
<p>기본 템플릿</p>
<p><code>hugo</code> 에는 list 템플릿, single 템플릿 두 가지가 기본 템플릿이다. 테마를 구성한다면 요 차이를 명확하게 구분하자.</p>
</li>
<li>
<p>pagination 은 jekyll 이 더 편해보인다.</p>
</li>
<li>
<p>seo, tag archive 같은 기능은 별도로 custom page 를 만들어서 쓰는게 편했다.</p>
</li>
<li>
<p>shortcode 라는 별도의 custom 단축기능을 만들 수 있다. 내 경우는 CSS class 와 맞추기 위해서 아래처럼 구성해서 썼다.</p>
<div><pre><code data-lang="html">&lt;<span>figure</span> <span>class</span><span>=</span><span>"full-width caption"</span> {{ <span>with</span> .<span>Get</span> "<span>border</span>" }} <span>style</span><span>=</span><span>"border: 1px solid #ededed;"</span> {{ <span>end</span> }}&gt;
    &lt;<span>img</span> <span>src</span><span>=</span><span>"{{ .Get "</span><span>src</span>" }}" <span>alt</span><span>=</span><span>"{{ .Get "</span><span>alt</span>" }}"/&gt;
    {{ with .Get "caption" }}
    &lt;<span>figcaption</span> <span>class</span><span>=</span><span>"caption-text"</span>&gt;{{ . }}&lt;/<span>figcaption</span>&gt;
    {{ end }}
&lt;/<span>figure</span>&gt;
</code></pre></div></li>
<li>
<p>related post 를 구성하는 건 옵션이 많으니 입맛에 맞게 잘 맞춰야 한다.</p>
</li>
</ul>
<h2 id="전체적인-소감">전체적인 소감</h2>
<p><code>hugo</code>는 <code>github page</code> 를 직접 지원하지 않아서 별도의 <strong>build &amp; push</strong> 를 해줘야 하지만 이건 크게 문제되지 않는 것 같다. 오히려 빨라진 반응 속도가 더 쾌적한 느낌이 들고,
빠른 업데이트와 함께 매뉴얼이 잘 마련되어 있다는 점이 긍정적이라고 느껴진다. 찔끔찔끔 마이그레이션 하느라 시간은 2주 정도 걸렸는데 하고나니 잘 했다는 느낌이다. 이제는 테마는 그만좀 고치고 글을 좀 더 써야 할텐데..</p>

                

                <hr>
                

                





<p><a href="https://disqus.com/">comments powered by </a>



            </p></div>
</article></div>

Soo Story

Jung-Soo Ahn

사용하던 github pages 기반 툴을 jekyll 에서 hugo 로 전환해보았다. 아래는 그 과정에서 느낀 점을 정리해보았다.

jekyll 에서 hugo 로 전환한 소감

댓글