GitHub 블로그 테마 이주 #3 - 사이트 설정

M3. GitHub 블로그 테마 이주 #3 - 사이트 설정

GitHub 블로그 테마 이주 #3 - 사이트 설정

이 글에서는 Minimal Mistakes의 설정 매뉴얼을 따라 하나씩 설정합니다.

제 경우에 필요하거나 대다수 블로그 운영시 필요한 설정 위주로 설명합니다. 본인에게 필요한 설정에 대한 설명이 빠져있을 수 있으니, 해당 매뉴얼을 대략이나마 훝어보기를 권합니다.

특별한 설명이 없으면 루트 디렉토리에 위치한 _config.yml 파일을 수정합니다.

관련글
테스트 서버 구성
기존 데이터 복사
사이트 설정
커스터마이징 (Part 1)
커스터마이징 (Part 2)
운영 사이트에 반영
테스트 사이트의 수정 사항 일괄 반영

사이트 설정 (Site settings)

테마 (Theme)

GitHub 리포지토리로 클론하였기에 따로 설정할 필요가 없습니다. 로컬(local)에서 테스트하고자 하는 경우 필요합니다.

스킨 (Skin)

기본 설정이 무난해서 설정하지 않았습니다.

사이트 언어 (Site locale)

ko-KR로 설정합니다. _data/ui-text.yml 파일에 언어별로 각 용어에 대한 번역이 있습니다. 예를 들어 recent_posts는 영어로는 Recent Posts, 한국어로는 최근 포스트로 설정되어 있습니다. 한국어로 누가 번역했는지 모르겠지만 감사하게 잘 쓰겠습니다.

less _data/ui-text.yml
# Korean
# ------
ko: &DEFAULT_KO
  skip_links                 :
  skip_primary_nav           :
  skip_content               :
  skip_footer                :
  page                       : "페이지"
  pagination_previous        : "이전"
  pagination_next            : "다음"
  breadcrumb_home_label      : "Home"
  breadcrumb_separator       : "/"

_config.yml에서 locale 항목을 찾아 고쳐주면 됩니다. 대개의 설정은 값만 고치고, 필요한 경우 언코멘트(uncomment)하면 사용할수 있게 되어 있습니다.

locale: "ko-KR"

사이트 타이틀 (Site title)

사이트 타이틀은 페이지명 뒤에 |와 함께 덧붙여지는 용도로 사용됩니다. 아래와 같은 경우 안녕하세요라는 페이지는 안녕하세요 | 퀀트강의 슬기로운 주식 정보로 표시되게 됩니다.

title          : "퀀트강의 슬기로운 주식 정보"
title_separator: "|"

사이트 서브타이틀 (Site subtitle)

설정하지 않았습니다.

사이트명 (Site name)

사이트 명칭인 줄 알았는데, 저자명을 쓰라고 합니다. 나중에 보니 화면 하단에 저작권(copyright) 표시에 사용되고 있었습니다.

name: "퀀트강"

사이트 설명 (Site description)

사이트 설명을 한 줄로 적어 넣었습니다.

description: "성공적인 주식 투자를 위하여 데이터 기반의 분석 결과와 유익한 정보를 제공합니다."

사이트 URL (Site URL)

자동 설정되고 대개는 따로 설정할 필요가 없습니다.

사이트 베이스 URL (Site base URL)

자동 설정되고 대개 따로 설정할 필요가 없습니다.

사이트 리포지토리 (Site Repository)

자동 설정되고 대개 따로 설정할 필요가 없습니다.

사이트 스크립트 (Site Scripts)

대개 설정할 필요는 없습니다. head_scripts<head>에, footer_scripts</body> 앞에 위치합니다.

사이트 기본 티저 이미지 (Site default teaser image)

글 하단에 관련 글 목록을 보여줄 때, 글에 그림이 없는 경우 보여주는 기본 그림입니다. 기본 설정이 없으며, 제 경우에는 관련 글 목록 기능을 사용하지 않으므로 설정하지 않았습니다.

웹페이지에서 사이트 이름 앞에 보여주는 로고입니다. 기본 설정은 없으며, 제 경우에는 로고를 만들어 둔 것이 있어 이를 설정했습니다.

로고를 이미 만든 경우 다양한 크기별로 이미지를 생성하고자 하는 경우 Favicon & App Icon Generator와 같은 사이트를 이용하면 됩니다.

logo: "/assets/logos/logo@96px.png"

사이트 마스트 헤드 타이틀 (Site masthead title)

설정하지 않으면, 앞에서 설정한 저자 이름의 사이트명이 사용됩니다. 만일 사이트명이 너무 길거나 다른 이름으로 표시하고 싶은 경우 설정하면 됩니다. 제 경우에는 따로 설정하지 않았습니다.

브레드크럼(빵 부스러기) 네비게이션 (Breadcrumb navigation)

영구 경로를 /:categories/:title/로 설정하는 경우 경로가 복잡해 집니다. 이런 경우 사용자가 본인이 어디에 위치하고 있는지 쉽게 파악하고, 원하는 곳으로 이동하기 편하게 도와주는 기능입니다. 제 경우에는 필요하지 않아 따로 설정하지 않았습니다.

포스트 날짜 (Post dates)

글 제목 아래에 작성 날짜를 보여주는 기능입니다. 기본으로 설정 되어 있지 않습니다. 제 경우에는 필요하지 않아 따로 설정하지 않았습니다. 이 기능이 필요한 글에만 show_date: true로 설정할 수 있습니다.

글 읽기 소요 예상 시간 (Reading time)

글 제목 아래에 읽는 데 소요되는 예상 시간을 표시하는 기능입니다. 기본으로 켜져 있으며, 제 경우에는 필요치 않아 설정을 껐습니다.

defaults:
  - scope:
    values:
      read_time: false 

페이지 메타 구분자 (Page meta separator)

작성 날짜와 글 읽기 예상 소요 시간이 둘 다 켜져 있을 때, 그 사이에 들어가는 구분자를 지정하는 기능입니다. CSS를 수정해야 합니다. 제 경우에는 둘 다 사용하지 않으니, 그대로 두었습니다.

코멘트 (Comments)

글에 대한 코멘트를 남기는 기능입니다. 기본으로 설정되어 있지 않습니다. 제 경우에는 필요하지 않은 기능입니다.

커스텀 피드 URL

Atom 형식의 피드로 /feed.xml이 기본 설정입니다. 따로 추가 설정하지 않았습니다.

네이버 서치 어드바이저의 경우 Atom 형식의 피드를 받지 않기 때문에, RSS 2.0 형식으로 만들어야 합니다.

피드 아이콘 비활성화 (Disable Feed Icons)

Atom feed 링크 앞에 아이콘을 표시하는 기능입니다. Atom feed 링크를 아예 표시하지 않게 설정할 예정이므로 그대로 두었습니다.

검색 기능을 켜는 설정입니다. 검색 기능을 제공할 예정이므로 이 기능을 설정했습니다.

검색 서비스로 Lunr, Algolia, 구글 커스텀 검색 엔진 (Google Custom Search Engine) 중에 하나로 지정할 수 있습니다. 기본 설정은 Lunr이고, 매뉴얼에는 Algolia가 빠르고 더 정확한 것으로 설명하고 있습니다. Algolia를 쓰기 위해서는 몇 가지 추가 설정을 하여야 합니다…

search: true

검색최적화, 소셜 공유, 애널리틱스 설정

구글/빙/네이버 검색 등록

구글/빙/네이버와 같은 검색 서비스에 본인 소유의 사이트라는 것을 알리는 확인 코드를 설정하는 기능입니다. 신기하게도 네이버 항목도 있습니다.

기존 사이트의 HTML 페이지 소스를 확인해서 코드를 설정했습니다. 빙의 경우 구글 써치 콘솔에서 가져온 것이라서 확인용 코드를 확인할 수 없었습니다.

얀덱스와 바이두도 있는데, 딱히 등록할 필요가 없어서 설정하지 않았습니다.

google_site_verification : "<YOUR ID>"
naver_site_verification  : "<YOUR ID>"

설정 후 사이트 업데이트를 해서 확인하면 다음과 같이 <meta> 태그가 추가됩니다.

<meta name="google-site-verification" content="<YOUR ID>" />
<meta name="naver-site-verification" content="<YOUR ID>">

트위터/페이스북 설정

둘 다 하지 않고 있어 따로 설정하지 않았습니다.

소셜 프로필 설정

마찬가지로 따로 설정하지 않았습니다.

애널리틱스 (Analytics)

구글 애널리틱스와 네이버 애널리틱스를 사용하고 있습니다. 테스트 서버에서 발생한 트래픽이 애널리틱스 쪽으로 가는 것을 막기 위해 따로 설정하지 않았습니다.

참고
현재 동작하는 사이트가 테스트 사이트인 경우 코드가 실행되지 않도록 설정하는 것이 코드를 관리하는데 더 나을 듯 합니다.

사이트 저자 (Site author)

왼쪽에 저자 정보를 담은 사이드바를 보여줄 수 있습니다. 여기에 나올 정보를설정합니다.

제 경우에는 블로그 사이트가 아니라서 사이트 저자를 표시하지 않을 예정입니다. 왼쪽 사이드바 기능을 끌 계획이므로, 일단 값만 채워두었습니다.

author:
  name             : "퀀트강"
  links:
    - label: "Website"
      icon: "fas fa-fw fa-link"
    - label: "GitHub"
      icon: "fab fa-fw fa-github"```

페이지 하단에 보여주는 링크 목록을 설정할 수 있습니다. 예제는 블로그 주인의 소셜 사이트 목록입니다만, 다른 종류의 링크 목록을 보여주는 용도로도 활용이 가능합니다.

제 경우에는 필요치 않고, 이 기능을 끌 예정이므로, 값만 채워 두었습니다.

footer:
  links:
    - label: "GitHub"
      icon: "fab fa-fw fa-github"
      url: "https://github.com/QuantKang"

글 읽기 관련 설정

기본으로 설정되어 있는 저자 프로필, 공유 링크, 관련 글 목록은 사용하지 않는 것으로 설정했습니다.

defaults:
  - scope:
    values:
      author_profile: false
      share: false
      related: false

글 목록에서 몇 건의 글을 보여줄 지 (기본 5건) 설정하는 것도 그대로 두었습니다.

시간대 설정 (Timezone)

timezoneAsia/Seoul로 설정했습니다. timezone은 문자열이 아니네요.

timezone: Asia/Seoul

아카이브 설정 (Archive settings)

카테고리와 태그에 대해 글 목록을 보여줄 지 설정하는 기능입니다. 제 경우에는 필요하지 않아 설정하지 않았습니다.

HTML 압축

통신 트래픽 양을 줄이기 위해 HTML을 압축하는 기능에 대한 설정입니다. 한 번 사용해 보고 싶은 기능이긴 합니다. 주의 사항이 있으니 사용해 보고 싶으신 분은 꼭 읽어 보시기 바랍니다.

댓글

이 블로그의 인기 게시물

국내 주가 데이터 특성 비교 (FinanceDataReader, PyKrx, macap)

주가는 기업 이익(EPS)에 어느 정도 선행하는가? (개별 기업의 사례)

레버리지, 인버스 주요 종목 수익률과 비용