<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.10.0">Jekyll</generator><link href="https://codgm.github.io/feed.xml" rel="self" type="application/atom+xml" /><link href="https://codgm.github.io/" rel="alternate" type="text/html" /><updated>2025-06-30T17:19:19+09:00</updated><id>https://codgm.github.io/feed.xml</id><title type="html">Codgm Blog</title><subtitle>:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.</subtitle><author><name>SEO GYUMIN</name></author><entry><title type="html">Github Jekyll 기반 개인 블로그 제작 회고</title><link href="https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/blog-making-review/" rel="alternate" type="text/html" title="Github Jekyll 기반 개인 블로그 제작 회고" /><published>2025-06-27T00:00:00+09:00</published><updated>2025-06-27T00:00:00+09:00</updated><id>https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/blog-making-review</id><content type="html" xml:base="https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/blog-making-review/"><![CDATA[<h2 id="jekyllminimal-mistakes-기반-개인-블로그-제작-회고">Jekyll(Minimal Mistakes) 기반 개인 블로그 제작 회고</h2>

<h2 id="1-시작하며"><strong>1. 시작하며</strong></h2>

<ul>
  <li>Jekyll과 Minimal Mistakes 테마로 블로그를 시작했습니다.</li>
  <li>단순히 글을 올리는 공간이 아니라, <strong>나만의 색상, UX, 기능</strong>을 갖춘 블로그를 만들고자 했습니다.</li>
  <li>오픈소스 테마의 구조를 분석하고, 원하는 대로 커스터마이징하는 과정에서 Jekyll의 빌드 구조와 Liquid 문법, SCSS, JS의 상호작용을 깊이 이해하게 됐습니다.</li>
  <li>블로그를 직접 운영하며, 실사용자 입장에서 필요한 기능과 디자인을 고민하게 됐습니다.</li>
</ul>

<h2 id="2-테마-커스터마이징"><strong>2. 테마 커스터마이징</strong></h2>

<ul>
  <li><code class="language-plaintext highlighter-rouge">_custom.scss</code>에서 CSS 변수로 <strong>다크/라이트 테마</strong> 색상을 일괄적으로 관리했습니다. 주요 색상, 배경, 텍스트, 포인트 컬러, 카드/코드/버튼/네비게이션 등 모든 UI 요소를 변수로 통일해 유지보수성을 높였습니다.</li>
</ul>

<div class="language-scss highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// _sass/minimal-mistakes/_custom.scss</span>
<span class="nt">body</span><span class="o">[</span><span class="nt">data-theme</span><span class="o">=</span><span class="s2">"dark"</span><span class="o">]</span> <span class="p">{</span>
  <span class="na">--bg-primary</span><span class="p">:</span> <span class="mh">#0f0f1a</span><span class="p">;</span>
  <span class="na">--accent-primary</span><span class="p">:</span> <span class="mh">#a855f7</span><span class="p">;</span>
  <span class="na">--text-primary</span><span class="p">:</span> <span class="mh">#ffffff</span><span class="p">;</span>
  <span class="nc">...</span>
<span class="p">}</span>
<span class="nt">body</span><span class="o">[</span><span class="nt">data-theme</span><span class="o">=</span><span class="s2">"light"</span><span class="o">]</span> <span class="p">{</span>
  <span class="na">--bg-primary</span><span class="p">:</span> <span class="mh">#fff</span><span class="p">;</span>
  <span class="na">--accent-primary</span><span class="p">:</span> <span class="mh">#7c3aed</span><span class="p">;</span>
  <span class="na">--text-primary</span><span class="p">:</span> <span class="mh">#1a1a1a</span><span class="p">;</span>
  <span class="nc">...</span>
<span class="p">}</span>
</code></pre></div></div>

<ul>
  <li>masthead, greedy-nav, 푸터, sidebar 등 주요 UI를 테마에 맞게 세밀하게 조정했습니다. 예를 들어, 네비게이션과 푸터의 배경/글자색, hover 효과, border-radius, box-shadow 등도 테마별로 다르게 적용했습니다.</li>
</ul>

<div class="language-scss highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// _sass/minimal-mistakes/_custom.scss</span>
<span class="nc">.masthead</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">color-mix</span><span class="p">(</span><span class="n">in</span> <span class="n">srgb</span><span class="o">,</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">bg-primary</span><span class="p">)</span> <span class="m">95%</span><span class="o">,</span> <span class="nb">transparent</span><span class="p">);</span>
  <span class="nl">border-bottom</span><span class="p">:</span> <span class="m">1</span><span class="mi">.5px</span> <span class="nb">solid</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">border-color</span><span class="p">);</span>
  <span class="nc">...</span>
<span class="p">}</span>
<span class="nc">.greedy-nav</span> <span class="nt">a</span><span class="o">,</span> <span class="nc">.masthead__menu</span> <span class="nt">a</span> <span class="p">{</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">text-primary</span><span class="p">);</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">8px</span><span class="p">;</span>
  <span class="nl">transition</span><span class="p">:</span> <span class="n">all</span> <span class="m">0</span><span class="mi">.2s</span> <span class="n">ease</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<ul>
  <li>skip navigation, 불필요한 마크업, 중복 padding/margin 등은 과감히 제거해 코드와 UI를 간결하게 만들었습니다.</li>
  <li>테마 토글 버튼을 masthead.html과 custom.js에서 구현하여, body에 data-theme 속성을 동적으로 적용했습니다. 토글 버튼은 Search 메뉴 옆에 고정시켜 접근성을 높였습니다.</li>
</ul>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">&lt;!-- _includes/masthead.html (일부) --&gt;</span>

</code></pre></div></div>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// assets/js/custom.js (일부)</span>
<span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="dl">'</span><span class="s1">DOMContentLoaded</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">themeToggle</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">querySelector</span><span class="p">(</span><span class="dl">'</span><span class="s1">#darkLightToggle</span><span class="dl">'</span><span class="p">);</span>
  <span class="kd">function</span> <span class="nx">applyTheme</span><span class="p">(</span><span class="nx">theme</span><span class="p">)</span> <span class="p">{</span>
    <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">setAttribute</span><span class="p">(</span><span class="dl">'</span><span class="s1">data-theme</span><span class="dl">'</span><span class="p">,</span> <span class="nx">theme</span><span class="p">);</span>
    <span class="p">...</span>
  <span class="p">}</span>
  <span class="kd">const</span> <span class="nx">savedTheme</span> <span class="o">=</span> <span class="nx">localStorage</span><span class="p">.</span><span class="nx">getItem</span><span class="p">(</span><span class="dl">'</span><span class="s1">theme</span><span class="dl">'</span><span class="p">);</span>
  <span class="k">if</span> <span class="p">(</span><span class="nx">savedTheme</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">applyTheme</span><span class="p">(</span><span class="nx">savedTheme</span><span class="p">);</span>
  <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
    <span class="nx">applyTheme</span><span class="p">(</span><span class="dl">'</span><span class="s1">dark</span><span class="dl">'</span><span class="p">);</span>
  <span class="p">}</span>
  <span class="k">if</span> <span class="p">(</span><span class="nx">themeToggle</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">themeToggle</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="dl">'</span><span class="s1">click</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">current</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">getAttribute</span><span class="p">(</span><span class="dl">'</span><span class="s1">data-theme</span><span class="dl">'</span><span class="p">);</span>
      <span class="kd">const</span> <span class="nx">next</span> <span class="o">=</span> <span class="nx">current</span> <span class="o">===</span> <span class="dl">'</span><span class="s1">light</span><span class="dl">'</span> <span class="p">?</span> <span class="dl">'</span><span class="s1">dark</span><span class="dl">'</span> <span class="p">:</span> <span class="dl">'</span><span class="s1">light</span><span class="dl">'</span><span class="p">;</span>
      <span class="nx">applyTheme</span><span class="p">(</span><span class="nx">next</span><span class="p">);</span>
      <span class="nx">localStorage</span><span class="p">.</span><span class="nx">setItem</span><span class="p">(</span><span class="dl">'</span><span class="s1">theme</span><span class="dl">'</span><span class="p">,</span> <span class="nx">next</span><span class="p">);</span>
    <span class="p">});</span>
  <span class="p">}</span>
<span class="p">});</span>
</code></pre></div></div>

<ul>
  <li>반응형 디자인도 신경써서, 모바일 환경에서 sidebar, 카드, 네비게이션, 테마 토글 버튼의 위치와 크기를 최적화했습니다.</li>
</ul>

<h2 id="3-검색-기능-개선"><strong>3. 검색 기능 개선</strong></h2>

<ul>
  <li>기존 Lunr 기반 검색에서 Google CSE로도 전환할 수 있도록 구조를 파악하고 설정했습니다. <code class="language-plaintext highlighter-rouge">_config.yml</code>에서 search_provider를 쉽게 바꿀 수 있도록 했고, 실제로 Algolia, Lunr, Google CSE 등 다양한 검색 엔진을 실험했습니다.</li>
</ul>

<div class="language-yml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># _config.yml (일부)</span>
<span class="na">search</span><span class="pi">:</span> <span class="no">true</span>
<span class="na">search_provider</span><span class="pi">:</span> <span class="s">algolia</span> <span class="c1"># lunr, algolia, google_cse 등</span>
</code></pre></div></div>

<ul>
  <li>검색창을 상단 고정, 오버레이, 네비게이션 토글 등 다양한 방식으로 시도했습니다. 특히, 네비게이션의 “Search” 메뉴 클릭 시 오버레이 검색창이 뜨도록 JS/HTML 구조를 변경해 UX를 개선했습니다.</li>
</ul>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// assets/js/custom.js (일부)</span>
<span class="kd">var</span> <span class="nx">navSearch</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">querySelector</span><span class="p">(</span><span class="dl">'</span><span class="s1">.nav-search-link</span><span class="dl">'</span><span class="p">);</span>
<span class="kd">var</span> <span class="nx">overlay</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="dl">'</span><span class="s1">searchOverlay</span><span class="dl">'</span><span class="p">);</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">navSearch</span> <span class="o">&amp;&amp;</span> <span class="nx">overlay</span><span class="p">)</span> <span class="p">{</span>
  <span class="nx">navSearch</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="dl">'</span><span class="s1">click</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">e</span><span class="p">.</span><span class="nx">preventDefault</span><span class="p">();</span>
    <span class="nx">overlay</span><span class="p">.</span><span class="nx">classList</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="dl">'</span><span class="s1">active</span><span class="dl">'</span><span class="p">);</span>
    <span class="p">...</span>
  <span class="p">});</span>
<span class="p">}</span>
</code></pre></div></div>

<ul>
  <li>검색 결과는 카드형 UI로, 다크/라이트 테마 모두 자연스럽게 적용되도록 했습니다. 검색 결과가 많을 때도 가독성을 해치지 않도록 카드 배경, 텍스트, 하이라이트 색상을 테마 변수로 통일했습니다.</li>
</ul>

<div class="language-scss highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// _sass/minimal-mistakes/_custom.scss</span>
<span class="nc">.card</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">card-bg</span><span class="p">);</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">text-primary</span><span class="p">);</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">18px</span><span class="p">;</span>
  <span class="nc">...</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="4-댓글리액션disqus-다크모드-연동"><strong>4. 댓글/리액션/Disqus 다크모드 연동</strong></h2>

<ul>
  <li>Disqus(디스커스) 댓글 영역이 iframe이라 SCSS로 직접 커스텀할 수 없었습니다. 대신, JS에서 사이트의 data-theme을 감지해 Disqus에 postMessage로 테마를 전달하도록 구현했습니다.</li>
</ul>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">&lt;!-- _includes/comments-providers/disqus.html (일부) --&gt;</span>
<span class="nt">&lt;script&gt;</span>
  <span class="kd">var</span> <span class="nx">disqus_config</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
    <span class="k">this</span><span class="p">.</span><span class="nx">callbacks</span><span class="p">.</span><span class="nx">onReady</span> <span class="o">=</span> <span class="p">[</span><span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
      <span class="kd">var</span> <span class="nx">theme</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">getAttribute</span><span class="p">(</span><span class="dl">'</span><span class="s1">data-theme</span><span class="dl">'</span><span class="p">)</span> <span class="o">||</span> <span class="dl">'</span><span class="s1">light</span><span class="dl">'</span><span class="p">;</span>
      <span class="kd">var</span> <span class="nx">iframe</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="dl">'</span><span class="s1">disqus_thread</span><span class="dl">'</span><span class="p">)?.</span><span class="nx">querySelector</span><span class="p">(</span><span class="dl">'</span><span class="s1">iframe</span><span class="dl">'</span><span class="p">);</span>
      <span class="k">if</span> <span class="p">(</span><span class="nx">iframe</span><span class="p">)</span> <span class="p">{</span>
        <span class="nx">iframe</span><span class="p">.</span><span class="nx">contentWindow</span><span class="p">.</span><span class="nx">postMessage</span><span class="p">({</span>
          <span class="na">type</span><span class="p">:</span> <span class="dl">'</span><span class="s1">set-theme</span><span class="dl">'</span><span class="p">,</span>
          <span class="na">theme</span><span class="p">:</span> <span class="nx">theme</span>
        <span class="p">},</span> <span class="dl">'</span><span class="s1">https://disqus.com</span><span class="dl">'</span><span class="p">);</span>
      <span class="p">}</span>
    <span class="p">}];</span>
  <span class="p">};</span>
  <span class="kd">var</span> <span class="nx">observer</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">MutationObserver</span><span class="p">(</span><span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
    <span class="kd">var</span> <span class="nx">theme</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">getAttribute</span><span class="p">(</span><span class="dl">'</span><span class="s1">data-theme</span><span class="dl">'</span><span class="p">)</span> <span class="o">||</span> <span class="dl">'</span><span class="s1">light</span><span class="dl">'</span><span class="p">;</span>
    <span class="nx">updateDisqusTheme</span><span class="p">(</span><span class="nx">theme</span><span class="p">);</span>
  <span class="p">});</span>
  <span class="nx">observer</span><span class="p">.</span><span class="nx">observe</span><span class="p">(</span><span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">,</span> <span class="p">{</span> <span class="na">attributes</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span> <span class="na">attributeFilter</span><span class="p">:</span> <span class="p">[</span><span class="dl">'</span><span class="s1">data-theme</span><span class="dl">'</span><span class="p">]</span> <span class="p">});</span>
<span class="nt">&lt;/script&gt;</span>
</code></pre></div></div>

<ul>
  <li>테마 토글 시에도 MutationObserver로 자동 동기화되도록 했습니다. 즉, 사용자가 다크/라이트 테마를 바꿀 때마다 댓글 영역도 즉시 테마가 맞춰집니다.</li>
  <li>리액션, 정렬, 공유 등 모든 텍스트/아이콘이 테마에 맞게 바뀌도록 했습니다. 댓글 영역 외에도, 공유 버튼, 리액션 아이콘 등도 테마별로 색상과 hover 효과를 다르게 적용했습니다.</li>
  <li>댓글 기능은 _config.yml에서 provider만 바꾸면 Disqus, Giscus, Utterances 등 다양한 서비스로 쉽게 전환할 수 있도록 구조화했습니다.</li>
</ul>

<h2 id="5-코드디자인-세부-개선"><strong>5. 코드/디자인 세부 개선</strong></h2>

<ul>
  <li>코드블록 스타일에서 border, radius, box-shadow 등 불필요한 부분을 제거하고, 색상 변수를 통일했습니다. 코드블록, 인라인 코드, pre 태그 모두 다크/라이트에 맞는 배경과 글자색, border, radius를 적용했습니다.</li>
</ul>

<div class="language-scss highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// _sass/minimal-mistakes/_custom.scss</span>
<span class="nc">.highlight</span><span class="o">,</span> <span class="nt">pre</span><span class="o">,</span> <span class="nt">code</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">code-bg</span><span class="p">)</span> <span class="o">!</span><span class="n">important</span><span class="p">;</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">code-text</span><span class="p">)</span> <span class="o">!</span><span class="n">important</span><span class="p">;</span>
  <span class="nl">font-family</span><span class="p">:</span> <span class="s1">'JetBrains Mono'</span><span class="o">,</span> <span class="s1">'Fira Code'</span><span class="o">,</span> <span class="s1">'Monaco'</span><span class="o">,</span> <span class="nb">monospace</span><span class="p">;</span>
  <span class="nc">...</span>
<span class="p">}</span>
<span class="nt">code</span><span class="nd">:not</span><span class="o">(</span><span class="nt">pre</span> <span class="nt">code</span><span class="o">)</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">hover-bg</span><span class="p">)</span> <span class="o">!</span><span class="n">important</span><span class="p">;</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">accent-primary</span><span class="p">)</span> <span class="o">!</span><span class="n">important</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">3px</span> <span class="m">8px</span><span class="p">;</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">6px</span><span class="p">;</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">border-color</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>

<ul>
  <li>sidebar, pagination, meta, share, comments 등 모든 컴포넌트의 색상, 간격, hover 효과를 테마에 맞게 반복적으로 개선했습니다. 예를 들어, pagination의 현재 페이지, hover, disabled 상태까지 모두 변수로 관리했습니다.</li>
</ul>

<div class="language-scss highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// _sass/minimal-mistakes/_custom.scss</span>
<span class="nc">.pagination</span> <span class="nt">li</span> <span class="nt">a</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nb">transparent</span><span class="p">;</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">text-secondary</span><span class="p">);</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">border-color</span><span class="p">);</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">8px</span><span class="p">;</span>
  <span class="nc">...</span>
<span class="p">}</span>
<span class="nc">.pagination</span> <span class="nt">li</span> <span class="nt">a</span><span class="nd">:hover</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">accent-primary</span><span class="p">);</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="o">--</span><span class="n">pagination-hover-text</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>

<ul>
  <li>404, about, 각종 archive 페이지 등도 세부적으로 다듬었습니다. 각 페이지의 배경, 카드, 타이틀, 링크, 버튼 등도 일관성 있게 커스터마이징했습니다.</li>
  <li>반응형 레이아웃, 스크롤바, selection, 링크 스타일 등도 세밀하게 조정해, 모바일/PC 어디서나 일관된 경험을 제공하도록 했습니다.</li>
</ul>

<h2 id="6-시행착오--배운-점"><strong>6. 시행착오 &amp; 배운 점</strong></h2>

<ul>
  <li>JS/CSS 변수명 불일치로 테마 토글이 동작하지 않는 문제, body에 data-theme를 둘지 html에 둘지 고민하며 해결했습니다. 실제로 여러 번 변수명을 잘못 써서 테마가 적용되지 않는 버그를 겪었습니다.</li>
  <li>검색창 위치와 동작(상단 고정, 오버레이, 네비게이션 연동 등)을 여러 번 실험했습니다. 오버레이 방식이 UX에 가장 적합하다고 판단해 적용했습니다.</li>
  <li>Disqus 등 외부 서비스와 다크모드 연동은 JS postMessage로 해결했습니다. iframe 구조의 한계와 postMessage의 활용법을 실전에서 익혔습니다.</li>
  <li>이미지 경로, 파일 위치, Jekyll의 baseurl/url 설정 등도 꼼꼼히 체크해야 했습니다. 특히, 커스텀 도메인이나 GitHub Pages에서 경로가 꼬이지 않도록 _config.yml의 url/baseurl 세팅을 반복적으로 점검했습니다.</li>
  <li>SCSS 변수, JS 로컬스토리지, MutationObserver 등 다양한 웹 기술을 실전에서 활용하며, 유지보수성과 확장성을 모두 고려하게 됐습니다.</li>
</ul>

<h2 id="7-마치며"><strong>7. 마치며</strong></h2>

<ul>
  <li>단순히 테마만 바꾼 것이 아니라, <strong>내가 원하는 UX/디자인/기능</strong>을 직접 구현하며 Jekyll 블로그에 대한 이해가 깊어졌습니다.</li>
  <li>시행착오를 겪으며 CSS/JS 구조, Jekyll의 동작 원리, 외부 서비스 연동까지 폭넓게 경험했습니다. 특히, 오픈소스 테마를 내 입맛대로 바꾸는 과정에서 웹 프론트엔드의 다양한 노하우를 쌓았습니다.</li>
  <li>앞으로도 새로운 기능과 디자인을 계속 실험하며 성장할 예정입니다. 예를 들어, 다국어 지원, 접근성 개선, SEO 최적화, 더 다양한 댓글/검색/공유 기능 등도 도전해보고 싶습니다.</li>
  <li>블로그 커스터마이징을 직접 해보면, 단순히 예쁜 테마를 고르는 것 이상의 실전 경험과 성장의 기회를 얻을 수 있습니다.</li>
</ul>

<hr />

<p><strong>최종 결과:</strong></p>
<ul>
  <li>다크/라이트 테마를 완벽하게 지원했습니다. (body[data-theme], CSS 변수, JS 토글, 로컬스토리지, MutationObserver 등 활용)</li>
  <li>네비게이션, 푸터, 목차, 코드, 댓글, 검색 등 모든 UI/UX를 세밀하게 커스터마이징했습니다. (모든 컴포넌트의 색상/간격/hover/반응형까지 일관성 있게 적용)</li>
  <li>검색, 댓글, 리액션, 코드블록 등 실전에서 자주 쓰는 기능을 내 스타일로 완성했습니다. (검색 엔진 전환, 댓글 서비스 전환, 실시간 테마 동기화 등)</li>
</ul>

<blockquote>
  <p>블로그 커스터마이징, 직접 해보면 정말 많이 배울 수 있습니다! 🚀</p>
</blockquote>]]></content><author><name>SEO GYUMIN</name></author><category term="블로그제작" /><category term="프로젝트" /><category term="Jekyll" /><category term="Minimal Mistakes" /><category term="블로그" /><category term="커스터마이징" /><category term="회고" /><category term="Coding" /><summary type="html"><![CDATA[Jekyll(Minimal Mistakes) 기반 개인 블로그 제작 회고]]></summary></entry><entry><title type="html">Next.js 기반 포트폴리오 사이트 제작 회고</title><link href="https://codgm.github.io/%ED%8F%AC%ED%8A%B8%ED%8F%B4%EB%A6%AC%EC%98%A4%20%EC%82%AC%EC%9D%B4%ED%8A%B8%20%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/portfolio-site-making-review/" rel="alternate" type="text/html" title="Next.js 기반 포트폴리오 사이트 제작 회고" /><published>2025-06-27T00:00:00+09:00</published><updated>2025-06-27T00:00:00+09:00</updated><id>https://codgm.github.io/%ED%8F%AC%ED%8A%B8%ED%8F%B4%EB%A6%AC%EC%98%A4%20%EC%82%AC%EC%9D%B4%ED%8A%B8%20%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/portfolio-site-making-review</id><content type="html" xml:base="https://codgm.github.io/%ED%8F%AC%ED%8A%B8%ED%8F%B4%EB%A6%AC%EC%98%A4%20%EC%82%AC%EC%9D%B4%ED%8A%B8%20%EC%A0%9C%EC%9E%91/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8/portfolio-site-making-review/"><![CDATA[<h2 id="nextjs-기반-포트폴리오-사이트-제작-회고">Next.js 기반 포트폴리오 사이트 제작 회고</h2>

<h2 id="1-시작하며"><strong>1. 시작하며</strong></h2>

<ul>
  <li>Next.js와 TypeScript로 포트폴리오 사이트를 직접 설계하고 개발했습니다.</li>
  <li>단순한 정적 페이지가 아니라, 데이터 중심 설계, 커스텀 UI/UX, SEO, 반응형, 실전 배포까지 실무에서 필요한 요소를 모두 경험했습니다.</li>
  <li>프로젝트를 진행하며, 유지보수성과 확장성을 고려한 구조로 설계하는 것이 얼마나 중요한지 체감했습니다.</li>
</ul>

<h2 id="2-seo-및-글로벌-대응-커스터마이징"><strong>2. SEO 및 글로벌 대응 커스터마이징</strong></h2>

<ul>
  <li><code class="language-plaintext highlighter-rouge">app/layout.tsx</code>에서 SEO를 위한 메타데이터, 오픈그래프, 트위터 카드, 키워드 등을 직접 추가했습니다.</li>
  <li>실제로 구글, 네이버 등 검색엔진에서 ‘서규민 포트폴리오’, ‘Codgm Portfolio’ 등으로 검색 시 사이트가 노출될 수 있도록 키워드와 설명을 신경써서 작성했습니다.</li>
  <li><code class="language-plaintext highlighter-rouge">&lt;html lang="ko,en"&gt;</code>로 다국어 접근성을 높였고, 글로벌 사용자도 쉽게 접근할 수 있도록 했습니다.</li>
  <li>SEO 최적화의 효과로, 사이트가 검색엔진에 빠르게 색인되고, 소셜 미디어 공유 시 미리보기 이미지와 설명이 잘 노출되는 것을 경험했습니다.</li>
</ul>

<div class="language-ts highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">export</span> <span class="kd">const</span> <span class="nx">metadata</span> <span class="o">=</span> <span class="p">{</span>
  <span class="na">title</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
  <span class="na">description</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
  <span class="na">keywords</span><span class="p">:</span> <span class="p">[</span><span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span> <span class="p">...],</span>
  <span class="na">openGraph</span><span class="p">:</span> <span class="p">{</span> <span class="p">...</span> <span class="p">},</span>
  <span class="na">twitter</span><span class="p">:</span> <span class="p">{</span> <span class="p">...</span> <span class="p">},</span>
<span class="p">};</span>
</code></pre></div></div>

<h2 id="3-모바일-ux-반응형-접근성"><strong>3. 모바일 UX, 반응형, 접근성</strong></h2>

<ul>
  <li>모바일 환경에서는 커스텀 커서가 보이지 않도록 조건부 렌더링을 적용했습니다.</li>
  <li>모든 주요 섹션은 반응형 레이아웃으로 설계했고, 버튼/링크/이미지에 alt, aria-label 등 접근성 속성을 신경써서 작성했습니다.</li>
  <li>실제 모바일 기기에서 테스트하며, 터치 UX와 레이아웃 깨짐, 커서 비노출 등 세부적인 부분까지 점검했습니다.</li>
  <li>반응형 메뉴(햄버거 버튼), 스크롤에 따라 변화하는 헤더, 부드러운 스크롤 이동 등 다양한 UI/UX를 직접 구현했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="p">[</span><span class="nx">isMobile</span><span class="p">,</span> <span class="nx">setIsMobile</span><span class="p">]</span> <span class="o">=</span> <span class="nx">useState</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span>
<span class="nx">useEffect</span><span class="p">(()</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="k">if</span> <span class="p">(</span><span class="k">typeof</span> <span class="nb">window</span> <span class="o">!==</span> <span class="dl">"</span><span class="s2">undefined</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">checkMobile</span> <span class="o">=</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">ua</span> <span class="o">=</span> <span class="nb">navigator</span><span class="p">.</span><span class="nx">userAgent</span><span class="p">;</span>
      <span class="k">return</span> <span class="sr">/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="nx">ua</span><span class="p">);</span>
    <span class="p">};</span>
    <span class="nx">setIsMobile</span><span class="p">(</span><span class="nx">checkMobile</span><span class="p">());</span>
  <span class="p">}</span>
<span class="p">},</span> <span class="p">[]);</span>
<span class="p">...</span>
<span class="p">{</span><span class="o">!</span><span class="nx">isMobile</span> <span class="o">&amp;&amp;</span> <span class="p">&lt;</span><span class="nc">CustomCursor</span> <span class="p">/&gt;}</span>
</code></pre></div></div>

<h2 id="4-데이터-중심-설계와-프로젝트-카드-확장"><strong>4. 데이터 중심 설계와 프로젝트 카드 확장</strong></h2>

<ul>
  <li><code class="language-plaintext highlighter-rouge">data/portfolioData.ts</code>에서 프로젝트, 스킬, 소개, 경력, 학력 등 모든 데이터를 객체로 관리했습니다.</li>
  <li>데이터만 추가하면 UI가 자동으로 확장되어 유지보수성이 매우 높아졌습니다.</li>
  <li>Skills, About, Projects, Contact 등 모든 섹션이 데이터 기반으로 동작해, 확장성과 일관성을 확보했습니다.</li>
  <li><code class="language-plaintext highlighter-rouge">ProjectCard.tsx</code>에서는 blog 링크가 있을 때만 “📝 Details” 버튼이 나타나도록 조건부 렌더링을 적용했습니다.</li>
</ul>

<div class="language-ts highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">export</span> <span class="kd">const</span> <span class="nx">projects</span> <span class="o">=</span> <span class="p">[</span>
  <span class="p">{</span>
    <span class="na">title</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">desc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">stack</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">link</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">github</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">blog</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span>
  <span class="p">},</span>
  <span class="c1">// ...</span>
<span class="p">];</span>
</code></pre></div></div>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="nx">blog</span> <span class="o">&amp;&amp;</span> <span class="p">(</span>
  <span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">blog</span><span class="si">}</span> <span class="err">...</span><span class="p">&gt;</span>📝 Details<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
<span class="p">)}</span>
</code></pre></div></div>

<h2 id="5-커스텀-uiux와-부가-효과"><strong>5. 커스텀 UI/UX와 부가 효과</strong></h2>

<h3 id="5-1-커스텀-커서와-트레일-효과">5-1. 커스텀 커서와 트레일 효과</h3>

<ul>
  <li><code class="language-plaintext highlighter-rouge">components/CustomCursor.tsx</code>에서 마우스 위치에 따라 커서와 트레일 이펙트를 직접 구현했습니다.</li>
  <li>커서와 트레일이 부드럽게 따라다니며, 사이트의 개성을 살렸습니다.</li>
  <li>모바일에서는 UX를 위해 커서가 아예 렌더링되지 않습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nx">useEffect</span><span class="p">(()</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">cursor</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="dl">'</span><span class="s1">cursor</span><span class="dl">'</span><span class="p">);</span>
  <span class="kd">const</span> <span class="nx">handleMouseMove</span> <span class="o">=</span> <span class="p">(</span><span class="na">e</span><span class="p">:</span> <span class="nx">MouseEvent</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
    <span class="k">if</span> <span class="p">(</span><span class="nx">cursor</span><span class="p">)</span> <span class="p">{</span>
      <span class="nx">cursor</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">left</span> <span class="o">=</span> <span class="nx">e</span><span class="p">.</span><span class="nx">clientX</span> <span class="o">+</span> <span class="dl">'</span><span class="s1">px</span><span class="dl">'</span><span class="p">;</span>
      <span class="nx">cursor</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">top</span> <span class="o">=</span> <span class="nx">e</span><span class="p">.</span><span class="nx">clientY</span> <span class="o">+</span> <span class="dl">'</span><span class="s1">px</span><span class="dl">'</span><span class="p">;</span>
    <span class="p">}</span>
    <span class="c1">// 트레일 효과</span>
    <span class="kd">const</span> <span class="nx">trail</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">createElement</span><span class="p">(</span><span class="dl">'</span><span class="s1">div</span><span class="dl">'</span><span class="p">);</span>
    <span class="nx">trail</span><span class="p">.</span><span class="nx">className</span> <span class="o">=</span> <span class="dl">'</span><span class="s1">cursor-trail</span><span class="dl">'</span><span class="p">;</span>
    <span class="nx">trail</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">left</span> <span class="o">=</span> <span class="nx">e</span><span class="p">.</span><span class="nx">clientX</span> <span class="o">+</span> <span class="dl">'</span><span class="s1">px</span><span class="dl">'</span><span class="p">;</span>
    <span class="nx">trail</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">top</span> <span class="o">=</span> <span class="nx">e</span><span class="p">.</span><span class="nx">clientY</span> <span class="o">+</span> <span class="dl">'</span><span class="s1">px</span><span class="dl">'</span><span class="p">;</span>
    <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">appendChild</span><span class="p">(</span><span class="nx">trail</span><span class="p">);</span>
    <span class="nx">setTimeout</span><span class="p">(()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nx">trail</span><span class="p">.</span><span class="nx">remove</span><span class="p">();</span> <span class="p">},</span> <span class="mi">500</span><span class="p">);</span>
  <span class="p">};</span>
  <span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="dl">'</span><span class="s1">mousemove</span><span class="dl">'</span><span class="p">,</span> <span class="nx">handleMouseMove</span><span class="p">);</span>
  <span class="k">return</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="nb">document</span><span class="p">.</span><span class="nx">removeEventListener</span><span class="p">(</span><span class="dl">'</span><span class="s1">mousemove</span><span class="dl">'</span><span class="p">,</span> <span class="nx">handleMouseMove</span><span class="p">);</span>
<span class="p">},</span> <span class="p">[]);</span>
</code></pre></div></div>

<h3 id="5-2-배경-애니메이션">5-2. 배경 애니메이션</h3>

<ul>
  <li><code class="language-plaintext highlighter-rouge">components/BackgroundEffects.tsx</code>에서 다양한 배경 효과를 직접 DOM 조작으로 구현했습니다.</li>
  <li>랜덤 플로팅 요소, 매트릭스 레인, 회로 패턴, 데이터 스트림 등 다양한 애니메이션을 각각 함수로 분리해 관리했습니다.</li>
  <li>윈도우 리사이즈 시에도 애니메이션이 자연스럽게 재생성되도록 했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="nx">createMatrixRain</span> <span class="o">=</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">container</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="dl">'</span><span class="s1">matrixRain</span><span class="dl">'</span><span class="p">);</span>
  <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">container</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span>
  <span class="nx">container</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="dl">''</span><span class="p">;</span>
  <span class="kd">const</span> <span class="nx">columns</span> <span class="o">=</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nb">window</span><span class="p">.</span><span class="nx">innerWidth</span> <span class="o">/</span> <span class="mi">20</span><span class="p">);</span>
  <span class="kd">const</span> <span class="nx">matrixChars</span> <span class="o">=</span> <span class="dl">'</span><span class="s1">ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789@#$%^&amp;*()</span><span class="dl">'</span><span class="p">;</span>
  <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">columns</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">column</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">createElement</span><span class="p">(</span><span class="dl">'</span><span class="s1">div</span><span class="dl">'</span><span class="p">);</span>
    <span class="nx">column</span><span class="p">.</span><span class="nx">className</span> <span class="o">=</span> <span class="dl">'</span><span class="s1">matrix-column</span><span class="dl">'</span><span class="p">;</span>
    <span class="nx">column</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">left</span> <span class="o">=</span> <span class="s2">`</span><span class="p">${</span><span class="nx">i</span> <span class="o">*</span> <span class="mi">20</span><span class="p">}</span><span class="s2">px`</span><span class="p">;</span>
    <span class="nx">column</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">animationDelay</span> <span class="o">=</span> <span class="s2">`</span><span class="p">${</span><span class="nb">Math</span><span class="p">.</span><span class="nx">random</span><span class="p">()</span> <span class="o">*</span> <span class="mi">3</span><span class="p">}</span><span class="s2">s`</span><span class="p">;</span>
    <span class="nx">column</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">animationDuration</span> <span class="o">=</span> <span class="s2">`</span><span class="p">${</span><span class="mi">3</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">random</span><span class="p">()</span> <span class="o">*</span> <span class="mi">2</span><span class="p">}</span><span class="s2">s`</span><span class="p">;</span>
    <span class="kd">let</span> <span class="nx">chars</span> <span class="o">=</span> <span class="dl">''</span><span class="p">;</span>
    <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">j</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">j</span> <span class="o">&lt;</span> <span class="mi">20</span><span class="p">;</span> <span class="nx">j</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
      <span class="nx">chars</span> <span class="o">+=</span> <span class="nx">matrixChars</span><span class="p">[</span><span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nb">Math</span><span class="p">.</span><span class="nx">random</span><span class="p">()</span> <span class="o">*</span> <span class="nx">matrixChars</span><span class="p">.</span><span class="nx">length</span><span class="p">)]</span> <span class="o">+</span> <span class="dl">'</span><span class="s1">&lt;br&gt;</span><span class="dl">'</span><span class="p">;</span>
    <span class="p">}</span>
    <span class="nx">column</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="nx">chars</span><span class="p">;</span>
    <span class="nx">container</span><span class="p">.</span><span class="nx">appendChild</span><span class="p">(</span><span class="nx">column</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">};</span>
</code></pre></div></div>

<h2 id="6-주요-섹션별-컴포넌트-구조"><strong>6. 주요 섹션별 컴포넌트 구조</strong></h2>

<h3 id="6-1-헤더내비게이션">6-1. 헤더/내비게이션</h3>

<ul>
  <li>스크롤에 따라 스타일이 바뀌고, 모바일에서는 햄버거 메뉴로 전환되어 UX를 높였습니다.</li>
  <li>부드러운 스크롤 이동, 접근성, 반응형 등 다양한 UI/UX를 직접 구현했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="nx">navItems</span> <span class="o">=</span> <span class="p">[</span>
  <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">'</span><span class="s1">Home</span><span class="dl">'</span><span class="p">,</span> <span class="na">href</span><span class="p">:</span> <span class="dl">'</span><span class="s1">#...</span><span class="dl">'</span> <span class="p">},</span>
  <span class="p">{</span> <span class="na">name</span><span class="p">:</span> <span class="dl">'</span><span class="s1">About</span><span class="dl">'</span><span class="p">,</span> <span class="na">href</span><span class="p">:</span> <span class="dl">'</span><span class="s1">#...</span><span class="dl">'</span> <span class="p">},</span>
  <span class="c1">// ...</span>
<span class="p">];</span>
<span class="p">&lt;</span><span class="nt">nav</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="s2">`</span><span class="p">${</span><span class="nx">styles</span><span class="p">.</span><span class="nx">nav</span><span class="p">}</span><span class="s2"> </span><span class="p">${</span><span class="nx">isMenuOpen</span> <span class="p">?</span> <span class="nx">styles</span><span class="p">.</span><span class="nx">open</span> <span class="p">:</span> <span class="dl">''</span><span class="p">}</span><span class="s2">`</span><span class="si">}</span><span class="p">&gt;</span>
  <span class="si">{</span><span class="nx">navItems</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">item</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
    <span class="p">&lt;</span><span class="nt">a</span>
      <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">item</span><span class="p">.</span><span class="nx">name</span><span class="si">}</span>
      <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">item</span><span class="p">.</span><span class="nx">href</span><span class="si">}</span>
      <span class="na">onClick</span><span class="p">=</span><span class="si">{</span><span class="nx">handleNavClick</span><span class="si">}</span>
      <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">navLink</span><span class="si">}</span>
    <span class="p">&gt;</span>
      <span class="si">{</span><span class="nx">item</span><span class="p">.</span><span class="nx">name</span><span class="si">}</span>
    <span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
  <span class="p">))</span><span class="si">}</span>
<span class="p">&lt;/</span><span class="nt">nav</span><span class="p">&gt;</span>
</code></pre></div></div>

<h3 id="6-2-aboutsection">6-2. AboutSection</h3>

<ul>
  <li>소개, 경력, 학력 정보를 모두 데이터 기반으로 렌더링했습니다.</li>
  <li>경력, 학력도 각각 timeline, 리스트 형태로 시각화하여, 한눈에 경로를 파악할 수 있도록 했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">aboutText</span><span class="si">}</span><span class="p">&gt;</span>
  <span class="p">&lt;</span><span class="nt">h3</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">aboutName</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">about</span><span class="p">.</span><span class="nx">name</span><span class="si">}</span><span class="p">&lt;/</span><span class="nt">h3</span><span class="p">&gt;</span>
  <span class="si">{</span><span class="nx">about</span><span class="p">.</span><span class="nx">description</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">text</span><span class="p">,</span> <span class="nx">index</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
    <span class="p">&lt;</span><span class="nt">p</span> <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">index</span><span class="si">}</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">aboutDescription</span><span class="si">}</span><span class="p">&gt;</span>
      <span class="si">{</span><span class="nx">text</span><span class="si">}</span>
    <span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
  <span class="p">))</span><span class="si">}</span>
  <span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">aboutStats</span><span class="si">}</span><span class="p">&gt;</span>
    <span class="si">{</span><span class="nx">about</span><span class="p">.</span><span class="nx">stats</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">stat</span><span class="p">,</span> <span class="nx">index</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
      <span class="p">&lt;</span><span class="nt">div</span> <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">index</span><span class="si">}</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">stat</span><span class="si">}</span><span class="p">&gt;</span>
        <span class="p">&lt;</span><span class="nt">span</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">statNumber</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">stat</span><span class="p">.</span><span class="kr">number</span><span class="si">}</span><span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>
        <span class="p">&lt;</span><span class="nt">span</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">statLabel</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">stat</span><span class="p">.</span><span class="nx">label</span><span class="si">}</span><span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>
      <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
    <span class="p">))</span><span class="si">}</span>
  <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
</code></pre></div></div>

<h3 id="6-3-skillssection">6-3. SkillsSection</h3>

<ul>
  <li>탭별로 스킬을 분류하고, 각 스킬의 숙련도, 경험, 프로젝트 수를 시각적으로 보여줬습니다.</li>
  <li>탭 클릭 시 해당 카테고리의 스킬만 보여주고, 마우스 오버 시 상세 툴팁이 나타나도록 했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillsTabs</span><span class="si">}</span><span class="p">&gt;</span>
  <span class="si">{</span><span class="nx">skillCategories</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">category</span><span class="p">,</span> <span class="nx">index</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
    <span class="p">&lt;</span><span class="nt">button</span>
      <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">category</span><span class="p">.</span><span class="nx">title</span><span class="si">}</span>
      <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="s2">`</span><span class="p">${</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillTab</span><span class="p">}</span><span class="s2"> </span><span class="p">${</span><span class="nx">selectedCategory</span> <span class="o">===</span> <span class="nx">index</span> <span class="p">?</span> <span class="nx">styles</span><span class="p">.</span><span class="nx">active</span> <span class="p">:</span> <span class="dl">''</span><span class="p">}</span><span class="s2">`</span><span class="si">}</span>
      <span class="na">onClick</span><span class="p">=</span><span class="si">{</span><span class="p">()</span> <span class="o">=&gt;</span> <span class="nx">setSelectedCategory</span><span class="p">(</span><span class="nx">index</span><span class="p">)</span><span class="si">}</span>
      <span class="na">style</span><span class="p">=</span><span class="si">{</span><span class="p">{</span> <span class="dl">'</span><span class="s1">--tab-color</span><span class="dl">'</span><span class="p">:</span> <span class="nx">category</span><span class="p">.</span><span class="nx">color</span> <span class="p">}</span> <span class="k">as</span> <span class="nx">React</span><span class="p">.</span><span class="nx">CSSProperties</span><span class="si">}</span>
    <span class="p">&gt;</span>
      <span class="p">&lt;</span><span class="nt">span</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">tabIcon</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">category</span><span class="p">.</span><span class="nx">icon</span><span class="si">}</span><span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>
      <span class="si">{</span><span class="nx">category</span><span class="p">.</span><span class="nx">title</span><span class="si">}</span>
    <span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span>
  <span class="p">))</span><span class="si">}</span>
<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
<span class="p">...</span>
<span class="o">&lt;</span><span class="nx">div</span> <span class="nx">className</span><span class="o">=</span><span class="p">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillsGrid</span><span class="p">}</span><span class="o">&gt;</span>
  <span class="p">{</span><span class="nx">skillCategories</span><span class="p">[</span><span class="nx">selectedCategory</span><span class="p">].</span><span class="nx">skills</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">skill</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
    <span class="p">&lt;</span><span class="nt">div</span>
      <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">skill</span><span class="p">.</span><span class="nx">name</span><span class="si">}</span>
      <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillCard</span><span class="si">}</span>
      <span class="na">onMouseEnter</span><span class="p">=</span><span class="si">{</span><span class="p">()</span> <span class="o">=&gt;</span> <span class="nx">setHoveredSkill</span><span class="p">(</span><span class="nx">skill</span><span class="p">.</span><span class="nx">name</span><span class="p">)</span><span class="si">}</span>
      <span class="na">onMouseLeave</span><span class="p">=</span><span class="si">{</span><span class="p">()</span> <span class="o">=&gt;</span> <span class="nx">setHoveredSkill</span><span class="p">(</span><span class="kc">null</span><span class="p">)</span><span class="si">}</span>
    <span class="p">&gt;</span>
      <span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillHeader</span><span class="si">}</span><span class="p">&gt;</span>
        <span class="p">&lt;</span><span class="nt">h3</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillName</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">skill</span><span class="p">.</span><span class="nx">name</span><span class="si">}</span><span class="p">&lt;/</span><span class="nt">h3</span><span class="p">&gt;</span>
        <span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillLevel</span><span class="si">}</span><span class="p">&gt;</span><span class="si">{</span><span class="nx">skill</span><span class="p">.</span><span class="nx">level</span><span class="si">}</span>%<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
      <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
      <span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillBar</span><span class="si">}</span><span class="p">&gt;</span>
        <span class="p">&lt;</span><span class="nt">div</span> 
          <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">skillProgress</span><span class="si">}</span> 
          <span class="na">style</span><span class="p">=</span><span class="si">{</span><span class="p">{</span> 
            <span class="na">width</span><span class="p">:</span> <span class="s2">`</span><span class="p">${</span><span class="nx">skill</span><span class="p">.</span><span class="nx">level</span><span class="p">}</span><span class="s2">%`</span><span class="p">,</span>
            <span class="na">backgroundColor</span><span class="p">:</span> <span class="nx">skillCategories</span><span class="p">[</span><span class="nx">selectedCategory</span><span class="p">].</span><span class="nx">color</span>
          <span class="p">}</span><span class="si">}</span>
        <span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
      <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
      ...
    <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
  <span class="p">))}</span>
<span class="p">&lt;</span><span class="err">/</span><span class="na">div</span><span class="p">&gt;</span>
</code></pre></div></div>

<h3 id="6-4-projectssection--projectcard">6-4. ProjectsSection &amp; ProjectCard</h3>

<ul>
  <li>프로젝트 리스트를 map으로 렌더링하고, 각 카드는 props로 받아서 표시했습니다.</li>
  <li>각 프로젝트는 Live Demo, GitHub, Details(블로그) 버튼을 조건부로 보여줍니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">&lt;</span><span class="nt">div</span> <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">links</span><span class="si">}</span><span class="p">&gt;</span>
  <span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">link</span><span class="si">}</span> <span class="err">...</span><span class="p">&gt;</span>🔗 Live Demo<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
  <span class="si">{</span><span class="nx">github</span> <span class="o">&amp;&amp;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">github</span><span class="si">}</span> <span class="err">...</span><span class="p">&gt;</span>📂 GitHub<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span><span class="si">}</span>
  <span class="si">{</span><span class="nx">blog</span> <span class="o">&amp;&amp;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">blog</span><span class="si">}</span> <span class="err">...</span><span class="p">&gt;</span>📝 Details<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span><span class="si">}</span>
<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
</code></pre></div></div>

<h3 id="6-5-contactsection">6-5. ContactSection</h3>

<ul>
  <li>이메일, GitHub 등 연락처 정보를 배열로 관리하고, map으로 렌더링했습니다.</li>
  <li>접근성을 위해 이메일은 mailto, GitHub는 새 창으로 열리도록 처리했습니다.</li>
</ul>

<div class="language-tsx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="nx">contactInfo</span> <span class="o">=</span> <span class="p">[</span>
  <span class="p">{</span>
    <span class="na">icon</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">label</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Email</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...@....com</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">link</span><span class="p">:</span> <span class="dl">"</span><span class="s2">mailto:...@....com</span><span class="dl">"</span>
  <span class="p">},</span>
  <span class="p">{</span>
    <span class="na">icon</span><span class="p">:</span> <span class="dl">"</span><span class="s2">...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">label</span><span class="p">:</span> <span class="dl">"</span><span class="s2">GitHub</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">value</span><span class="p">:</span> <span class="dl">"</span><span class="s2">github.com/...</span><span class="dl">"</span><span class="p">,</span>
    <span class="na">link</span><span class="p">:</span> <span class="dl">"</span><span class="s2">https://github.com/...</span><span class="dl">"</span>
  <span class="p">},</span>
<span class="p">];</span>
<span class="p">...</span>
<span class="p">{</span><span class="nx">contactInfo</span><span class="p">.</span><span class="nx">map</span><span class="p">((</span><span class="nx">contact</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">(</span>
  <span class="p">&lt;</span><span class="nt">a</span> 
    <span class="na">key</span><span class="p">=</span><span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">label</span><span class="si">}</span>
    <span class="na">href</span><span class="p">=</span><span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">link</span><span class="si">}</span> 
    <span class="na">className</span><span class="p">=</span><span class="si">{</span><span class="nx">styles</span><span class="p">.</span><span class="nx">contactLink</span><span class="si">}</span>
    <span class="na">target</span><span class="p">=</span><span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">link</span><span class="p">.</span><span class="nx">startsWith</span><span class="p">(</span><span class="dl">'</span><span class="s1">http</span><span class="dl">'</span><span class="p">)</span> <span class="p">?</span> <span class="dl">"</span><span class="s2">_blank</span><span class="dl">"</span> <span class="p">:</span> <span class="kc">undefined</span><span class="si">}</span>
    <span class="na">rel</span><span class="p">=</span><span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">link</span><span class="p">.</span><span class="nx">startsWith</span><span class="p">(</span><span class="dl">'</span><span class="s1">http</span><span class="dl">'</span><span class="p">)</span> <span class="p">?</span> <span class="dl">"</span><span class="s2">noopener noreferrer</span><span class="dl">"</span> <span class="p">:</span> <span class="kc">undefined</span><span class="si">}</span>
  <span class="p">&gt;</span>
    <span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">icon</span><span class="si">}</span> <span class="si">{</span><span class="nx">contact</span><span class="p">.</span><span class="nx">label</span><span class="si">}</span>
  <span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
<span class="p">))}</span>
</code></pre></div></div>

<h2 id="7-실전-배포-및-운영-경험"><strong>7. 실전 배포 및 운영 경험</strong></h2>

<ul>
  <li>Vercel을 통한 CI/CD, 커스텀 도메인, 환경변수 관리, 빌드 최적화 등 실전 운영 경험을 쌓았습니다.</li>
  <li>구글 서치 콘솔에 사이트맵을 등록하고, 색인 요청을 통해 검색 노출 속도를 높였습니다.</li>
  <li>소셜 미디어 공유 시 미리보기 이미지, 설명, 타이틀이 정확히 노출되는 것을 확인했습니다.</li>
</ul>

<h2 id="8-시행착오--배운-점"><strong>8. 시행착오 &amp; 배운 점</strong></h2>

<ul>
  <li>모바일 UX, SEO, 데이터 중심 설계, 커스텀 UI/UX, 실전 배포 등 실무에서 자주 마주치는 문제를 직접 해결하며 성장했습니다.</li>
  <li>코드와 데이터의 분리, 컴포넌트화, 조건부 렌더링, DOM 조작, 접근성 등 다양한 웹 개발 노하우를 실제로 체득했습니다.</li>
  <li>각종 애니메이션, 반응형, 접근성, SEO 등 실전에서 바로 적용 가능한 노하우를 쌓았습니다.</li>
</ul>

<h2 id="9-마치며"><strong>9. 마치며</strong></h2>

<ul>
  <li>단순한 포트폴리오가 아니라, 실전에서 필요한 모든 기능을 직접 구현하며 Next.js, TypeScript, SEO, 반응형, 데이터 설계 등 다양한 역량을 키웠습니다.</li>
  <li>앞으로도 새로운 기능과 디자인을 계속 실험하며 성장할 예정입니다.</li>
</ul>

<blockquote>
  <p>직접 커스터마이징하며 실전 경험을 쌓는 것이 가장 큰 성장의 기회였습니다! 🚀</p>
</blockquote>]]></content><author><name>SEO GYUMIN</name></author><category term="포트폴리오 사이트 제작" /><category term="프로젝트" /><category term="Next.js" /><category term="TypeScript" /><category term="포트폴리오" /><category term="커스터마이징" /><category term="회고" /><category term="Coding" /><summary type="html"><![CDATA[Next.js 기반 포트폴리오 사이트 제작 회고]]></summary></entry><entry><title type="html">나의 첫 블로그 포스트</title><link href="https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8/first/" rel="alternate" type="text/html" title="나의 첫 블로그 포스트" /><published>2025-06-25T00:00:00+09:00</published><updated>2025-06-25T00:00:00+09:00</updated><id>https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8/first</id><content type="html" xml:base="https://codgm.github.io/%EB%B8%94%EB%A1%9C%EA%B7%B8/first/"><![CDATA[<h1 id="오늘-처음-블로그-생성">오늘 처음 블로그 생성</h1>

<p>화이팅!</p>]]></content><author><name>SEO GYUMIN</name></author><category term="블로그" /><category term="블로그" /><summary type="html"><![CDATA[오늘 처음 블로그 생성]]></summary></entry></feed>