나만의 위키 만들기 johngrib-jekyll-skeleton 포크해서 시작하기
vimwiki johngrib
순서
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) 아래 코드 추가
- vimwiki 설치 위한 vim-plug 설치
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/
- giscus
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 업로드 이슈