1 minute read

페이지 등록 개요

: 단순하게 포스트만 등록해보았다. 이번에는 페이지를 구현해본다.

페이지(page)

: 지킬에서의 게시물은 크게 post와 page로 구분된다. 여기서 page 를 설명한다.

  • page는 사이트 내 특정 주소에 보여줄 (날짜와 관련없는) 글을 작성할때 사용된다.
    • 예시1) 블로그 소개페이지 /about/
    • 예시2) 주인장 소개 페이지 /pofile/
    • 예시3) 사이트맵 페이지

위와 같이 날짜와 관련없는 페이지들이 있을 수 있다. 이런 경우를 위해서 지킬은 page를 지원한다.

페이지(page) 디폴트 설정

: _config.yml에서 page의 YFM을 추가하면, 각 page 의 기본 설정이 된다. 이 기본 설정이 page 에서 YFM로 다시 재정의가 되면 그 값으로 변경이 되고, page 에서 정의가 되어 있지 않다면 _config.yml에서의 기본 설정값을 그대로 쓰게 된다.

/_config.yml

# Defaults
defaults:
  # _posts
  - scope:
      path: ""
      type: posts
    values:
      layout: single
      author_profile: true
      read_time: true
      comments: # 블로그 댓글 기능 true
      share: true
      related: true

  # _pages
  - scope:
      path: ""
      type: pages
    values:
      layout: single
      author_profile: true
      read_time: false
      comments: false
      share: true
      related: false

위 내용을 보면 페이지의 기본 레이아웃이 single 로 잡혀있다. 즉, 따로 오버라이딩하지 않으면 이 기본 설정이 적용되어진다.

이전 포스팅에서 설명했듯이 post 도 동일한 개념이다.

등록 과정

: 페이지를 등록하는 과정은 다음과 같다.

잠깐)
minimal-mistakes theme의 초기상태는 _pages 폴더가 없다.

  1. _pages 폴더 생성
  2. 페이지 파일 생성 (형식없음)
  3. 내용을 규칙에 맞게 작성

등록

: 실제로 등록해본다. 여기서는 테스트페이지.md 라고 작성하겠다.

/_pages/테스트페이지.md

  1. _pages 폴더 생성
    루트 경로에 생성한다.
     mkdir /_pages
    
    
  2. 페이지 파일 생성 (형식없음)
    포스트와 다르게 파일명 규칙이 없다.
     cd /_pages
     touch 테스트페이지.md
    
    
  3. 내용을 규칙에 맞게 작성
    YFM(YAML Front Matter) 포맷에 맞게 작성한다.

    YFM(YAML Front Matter)

    • markdown 파일의 최상단에 위치하며 3개의 하이픈으로 시작과 끝을 표시한다.
    • YAML은 오픈 소스 프로젝트에서 많이 사용하는 구조화된 데이터 형식이라고만 알고 넘어가자.
    • YFM은 이 YAML을 사용해서 글의 제목, 날짜, 카테고리, 태그, 레이아웃 등을 정의할 수 있다.
     vi 테스트페이지.md
    
     ---
     title: "테스트페이지"
     excerpt: "테스트포스트 입니다."
     permalink: /about/
     layout: single
     ---
    
     # 테스트제목
     : 테스트 내용
    
    
    • 페이지의 YFM영역을 보면 permalink, layout 정도가 추가되었다.
    • layout 은 디폴트가 single 이라서 오버라이딩 되어도 의미가 없다. (그냥 넣어봤다.)

    permlink 란?
    page 글에서는 이 페이지가 블로그 내에서 어느 주소에서 표시될지를 결정하는 주소를 지정해줘야 한다. 이것이 permlink 이다.

    Example)
    깃블로그 호스트주소+permalink 가 이 페이지의 주소가 된다.
    즉, /about/ 이라면 https://blangs.github.io/about 주소가 이 페이지의 주소가 된다.
    간단하게 말하면 permalink 에 명시된 경로로 요청하면 이 페이지로 접속된다.

결과 확인

: 브라우저에서 permalink 으로 요청해보면 페이지가 잘 출력한다.

Leave a comment