cmaven

작업노트

:bulb: Jekyll 기반 GitHub 블로그의 SEO를 4편 시리즈로 정리한다. 이 글(1편)은 포스트 한 개 단위에서 끝낼 수 있는 frontmatter·메타태그 최적화를 다룬다. 같은 글에서 매번 챙기면 검색 유입이 가장 빠르게 늘어나는 영역이다.

:bulb: SEO 시리즈 구성

  • 1편 (이 글) — 포스트 단위 SEO: frontmatter, jekyll-seo-tag, permalink·파일명
  • 2편 — sitemap이 제대로 갱신되도록: _config.yml의 url·future·timezone 3줄 진단·수정
  • 3편 — 사이트 단위 SEO 감사: sitemap 품질, 검증 메타태그, 누락 description 일괄 보강, 404/아카이브 정리
  • 4편 — Google Search Console 잔여 이슈 정리: 404·리디렉션·”크롤링됨-색인 안 됨” 분류 진단과 noindex 메타태그 적용

[01] SEO란?

SEO(Search Engine Optimization) 는 검색 엔진이 웹페이지의 내용을 잘 이해하고, 검색 결과에서 높은 순위로 노출시킬 수 있도록 최적화하는 작업입니다.

  • Google은 웹 크롤러(Googlebot)가 페이지를 방문하여 <title>, <meta> 태그, 본문 내용, URL 구조 등을 분석
  • 이 정보를 바탕으로 검색 결과의 제목, 설명(스니펫), 순위를 결정
  • Jekyll 블로그에서는 frontmatter와 플러그인을 활용하여 이를 제어할 수 있음

[02] frontmatter SEO 최적화

Jekyll 포스트의 frontmatter에 SEO 관련 필드를 추가하면, 검색 엔진이 페이지를 더 정확하게 이해할 수 있습니다.

2-1. 적용 전 (기본 frontmatter)



1
2
3
4
5
6



---
title: "Ubuntu 24.04 한글 입력기 설치 및 한영 전환 설정"
date: 2026-03-16
categories: Linux
tags: [Ubuntu, fcitx, ibus, hangul, 한글입력]
---

이 상태에서 Google 검색 결과에 표시되는 정보:

항목 출처 문제점
검색 제목 title 값 적용됨 (OK)
검색 설명(스니펫) 본문에서 자동 추출 Google이 임의로 선택하므로 부정확할 수 있음
목록 미리보기 본문 첫 줄 의도하지 않은 내용이 표시될 수 있음
검색 키워드 범위 tags 5개 검색 유입 경로가 제한적

2-2. 적용 후 (SEO 최적화 frontmatter)



1
2
3
4
5
6
7
8



---
title: "Ubuntu 24.04 한글 입력기 설치 및 한영 전환 설정"
description: "Ubuntu 24.04에서 fcitx, ibus 한글 입력기 설치 방법과 한영 전환 단축키 설정 가이드"
excerpt: "Ubuntu 24.04 LTS 영어 설치 후 fcitx-hangul, ibus-hangul 한글 입력기 설치 및 한영 전환 단축키 설정 방법"
date: 2026-03-16
categories: Linux
tags: [Ubuntu, Ubuntu-24.04, fcitx, fcitx-hangul, ibus, ibus-hangul, 한글입력, 한영전환, Linux-한글, Korean-input]
---

개선된 결과:

항목 출처 개선점
검색 제목 title 값 동일
검색 설명(스니펫) description 값 의도한 설명이 표시됨
목록 미리보기 excerpt 값 블로그 목록 페이지에서 깔끔하게 표시
검색 키워드 범위 tags 10개 다양한 검색어로 유입 가능

2-3. 각 필드의 역할

description



1



description: "Ubuntu 24.04에서 fcitx, ibus 한글 입력기 설치 방법과 한영 전환 단축키 설정 가이드"
  • HTML의 <meta name="description"> 태그로 변환됨
  • Google 검색 결과의 스니펫(제목 아래 설명 텍스트)으로 사용
  • 50~160자 권장 (너무 짧으면 정보 부족, 너무 길면 잘림)
  • 핵심 키워드를 자연스럽게 포함

:warning: description이 없으면 Google이 본문에서 임의로 추출하므로, 의도하지 않은 내용이 스니펫으로 표시될 수 있습니다.

excerpt



1



excerpt: "Ubuntu 24.04 LTS 영어 설치 후 fcitx-hangul, ibus-hangul 한글 입력기 설치 및 한영 전환 단축키 설정 방법"
  • Minimal Mistakes 테마에서 포스트 목록 페이지의 미리보기 텍스트로 사용
  • jekyll-seo-tag 플러그인 사용 시 description이 없으면 excerpt를 대신 사용
  • description과 다른 문장으로 작성하면 더 다양한 키워드를 커버할 수 있음

tags 확장



1
2
3
4
5



# Before
tags: [Ubuntu, fcitx, ibus, hangul, 한글입력]

# After
tags: [Ubuntu, Ubuntu-24.04, fcitx, fcitx-hangul, ibus, ibus-hangul, 한글입력, 한영전환, Linux-한글, Korean-input]
  • 사용자가 실제로 검색할 만한 키워드를 다양하게 포함
  • 한글/영문 혼용으로 양쪽 검색어 모두 커버
  • 버전 정보(Ubuntu-24.04)를 포함하여 특정 버전 검색에 대응
  • 패키지명(fcitx-hangul)을 포함하여 기술 검색에 대응

[03] jekyll-seo-tag 플러그인

3-1. 플러그인 역할

jekyll-seo-tag는 frontmatter의 title, description, excerpt 등을 자동으로 HTML <meta> 태그로 변환해주는 플러그인입니다.

적용 전후 비교:



1
2
3
4
5
6
7
8
9
10
11



<!-- jekyll-seo-tag 없이 (기본) -->
<title>Ubuntu 24.04 한글 입력기 설치 및 한영 전환 설정 - 블로그</title>

<!-- jekyll-seo-tag 적용 후 (자동 생성) -->
<title>Ubuntu 24.04 한글 입력기 설치 및 한영 전환 설정 - 블로그</title>
<meta name="description" content="Ubuntu 24.04에서 fcitx, ibus 한글 입력기 설치 방법과 한영 전환 단축키 설정 가이드">
<meta property="og:title" content="Ubuntu 24.04 한글 입력기 설치 및 한영 전환 설정">
<meta property="og:description" content="Ubuntu 24.04에서 fcitx, ibus ...">
<meta property="og:type" content="article">
<meta name="twitter:card" content="summary">
<link rel="canonical" href="https://xxx.github.io/linux/ubuntu-2404-korean-input-setup/">

:bulb: og:title, og:description 등의 Open Graph 태그가 자동 생성되어 SNS 공유 시에도 올바른 제목/설명이 표시됩니다.

3-2. 설치 방법

Gemfile에 추가:



1



gem "jekyll-seo-tag"

_config.yml plugins 섹션에 추가:



1
2
3
4
5
6
7
8



plugins:
  - jekyll-paginate
  - jekyll-sitemap
  - jekyll-gist
  - jekyll-feed
  - jekyll-include-cache
  - jemoji
  - jekyll-seo-tag    # 추가

터미널에서 설치:



1



bundle install

:warning: GitHub Pages에서 jekyll-seo-tag는 기본 지원 플러그인이므로 별도 설정 없이 _config.yml에 추가만 하면 동작합니다.

3-3. _config.yml 사이트 정보 보강

jekyll-seo-tag는 _config.yml의 사이트 정보도 활용합니다. 다음 항목이 설정되어 있는지 확인합니다.



1
2
3
4
5
6



# _config.yml
title: "블로그"
description: "작업노트"
url: "https://cmaven.github.io"   # 사이트 URL (비어 있으면 canonical URL 생성 불가)
author:
  name: "cmaven"

:warning: url 값이 비어 있으면 canonical 태그와 Open Graph URL이 생성되지 않으므로 반드시 설정해야 합니다.

[04] sitemap.xml 활용

4-1. 자동 생성 확인

jekyll-sitemap 플러그인이 이미 설치되어 있다면, 빌드 시 자동으로 sitemap.xml이 생성됩니다.



1



https://cmaven.github.io/sitemap.xml

4-2. 새 포스트 작성 후 인덱싱 요청

새 포스트를 push한 후, Google Search Console에서 빠르게 인덱싱하려면:

  1. Google Search Console 접속
  2. 상단 검색창에 새 포스트의 URL 입력
  3. 색인 생성 요청 클릭

또는 Sitemaps 메뉴에서 sitemap.xml을 재제출하면 전체 사이트를 다시 크롤링합니다.

:bulb: 새 포스트 push 후 Google이 자동으로 크롤링하기까지 수일이 걸릴 수 있습니다. 색인 생성 요청을 하면 더 빨리 반영됩니다.

[05] URL 구조 최적화

URL에 의미 있는 키워드가 포함되면 검색 엔진이 페이지 내용을 더 잘 파악합니다.



1
2
3
4
5
6
7
8
9



# _config.yml

# 기본값 (날짜 포함)
permalink: /:categories/:year/:month/:day/:title/
# → /linux/2026/03/16/ubuntu-2404-korean-input-setup/

# 간결한 형태 (권장)
permalink: /:categories/:title/
# → /linux/ubuntu-2404-korean-input-setup/

:bulb: 파일명 자체가 URL의 일부가 되므로, 파일명에 핵심 키워드를 포함하는 것이 중요합니다.

5-2. 파일명 작성 팁



1
2
3
4
5
6



# 좋은 예 - 키워드가 명확
2026-03-16-ubuntu-2404-korean-input-setup.md

# 피해야 할 예 - 키워드 부족
2026-03-16-setup-guide.md
2026-03-16-post1.md

[06] 체크리스트

새 포스트를 작성할 때 아래 항목을 확인하면 Google 검색 유입을 높일 수 있습니다.

순서 항목 확인
1 title에 핵심 키워드 포함 ☐
2 description 50~160자 작성 ☐
3 excerpt 작성 (목록 미리보기용) ☐
4 tags에 한글/영문 키워드 다양하게 포함 ☐
5 파일명에 핵심 키워드 포함 ☐
6 jekyll-seo-tag 플러그인 설치 여부 ☐
7 _config.yml의 url 값 설정 여부 ☐
8 push 후 Google Search Console에서 색인 요청 ☐

:star: frontmatter의 description과 tags 보강만으로도 검색 유입이 크게 개선될 수 있습니다. jekyll-seo-tag 플러그인까지 적용하면 Open Graph, canonical URL 등이 자동으로 생성되어 SEO 효과가 극대화됩니다.

[07] 다음 편 예고

1편은 포스트 한 개 단위에서 끝낼 수 있는 SEO만 다뤘다. 그런데 새 글을 push해도 Google Search Console의 sitemap Last read가 갱신되지 않고 새 글이 색인되지 않는 문제가 종종 발생한다. 일반론적인 원인(크롤링 예산, 콘텐츠 품질) 이전에 _config.yml 설정 누락이라는 명확한 코드 문제일 수 있다.

2편 에서는 _config.yml의 url·future·timezone 3줄 누락을 sitemap 미갱신·색인 누락의 실제 원인으로 짚어내는 진단 과정과 수정 방법을 정리한다.

이어 3편 에서는 sitemap이 제대로 갱신되기 시작했으니 sitemap 자체의 품질(저가치 URL 제거, 검증 메타태그, 누락 description 보강, 404 페이지 등)을 사이트 단위 감사로 끌어올린다. 4편 은 sitemap 등록 이후 Search Console에 남는 4가지 분류의 잔여 이슈를 noindex/trailing slash로 마무리한다.

참고