순서

1. 깃허브 fork + 로컬 서버로 실행

  • johngrib skeleton fork
  • repo > settings > Pages > Bracnh 설정(master/root/) 후 Save
  • gem install jekyll bundler
gem install jekyll bundler
bundle install
bundle exec jekyll serve

2. vim 설치

  • gvim, nvim
  • 플러그인 설치
    • vimwiki 설치 위한 vim-plug 설치
      • plug.vim 파일 다운로드 후 autoload 폴더에 집어넣기
      • gVim열기 > :PlugInstall 엔터 > Vimwiki 메뉴 설정 뜸
    • vimwiki, startify 플러그인 설치
    • .vimrc(mac) / _vimrc(window) 아래 코드 추가
let wiki = {}
let wiki.path = '~/microz42.github.io/_wiki/' --> 내 주소로 변경
let wiki.ext = '.md'

let g:vimwiki_list = [wiki]
let g:vimwiki_conceallevel = 0

그 뒤 Vimwiki 설정 참고

vimwiki 기본 정보 변경

  • giscus, google-site-verification, keybase, etc.
    • giscus
      • 공개 저장소, giscus 앱 설치(configure 우측 상단 버튼 클릭), discussion 기능 활성화
    • _config.yml + about.md 수정
    • google analytics
    • google adsense
      • meta 태그 header.html에 추가
    • google site-verification
      • google search console > 접두어 > html 파일 다운로드 > root에 추가 커밋 푸시 > 확인
    • google search console - sitemap.xml URL 검사(색인 생성 완료 후)
      • 색인생성 > Sitemaps에서 sitemap.xml 링크 추가
    • favicon 변경
    • https://www.favicon-generator.org/

Git hooks 추가

새로운 글 등록시 메타 데이터 자동 업데이트를 위해 Git hooks 추가

cp tool/pre-commit ./.git/hooks

# 필요시 권한 부여
chmod +x generateData.js
chmod +x tool/save-images.sh

# 메타 데이터 생성 위한 yamljs 설치
npm install

.vimrc 파일

  • 메타데이터 updated 항목 자동 업데이트
  • 새로운 문서 파일 기본 형식 입력 되도록
  • 참고: johngrib dotfiles

windows 경로 슬래시 문제

  • windows에는 uuidgen.exe가 기본 설치가 되어있지 않음
  • 나중에 윈도우 설정 파일 + 문제 해결 방법 작성

사용법

  • 인덱스(root-index.md)에 폴더와 문서 적고 작성

ToDo

  • 디자인 변경
  • save-images.sh 변경 필요
  • vimwiki 설정 내용 추가
  • sitemap 추가

timeline

  • 250507: google search console에 sitemap 추가
  • 250505: vimwiki 설정 내용 수정
  • 250429: image 업로드 이슈