Vimwiki

소개 마크다운 문서를 vimwiki로 작성하여 간단한 메모에서 부터 블로그, 리포트, 기술 문서에 이르기까지 손쉽게 만들 수 있다. 이를 기반으로 하여 깃허브에서 제공하는 무료 웹사이트에 올리는 방법을 설명하고자 한다. 아래는 간략한 개요이다. vimwiki + hugo + github.io 를 연결하는 프로젝트이다. vim의 vimwiki 플러그인을 사용하여 위키문서를 작성한다. 위키문서의 작성은 마크다운(markdown) 문법으로 한다. hugo를 사용하여 임시 로컬웹서버를 띄우고 위키문서를 html로 변환하고 브라우저에서 확인한다. 변환된 정적 html 문서를 깃허브에 올린다. 깃허브 페이지에서 이를 확인한다. UTF-8인코딩이라면 한글도 특별히 문제가 없고 잘 된다. 다만 마크다운 파일명에 공백이 들어가면 관리가 좋지 않으니 -등으로 연결해서 쓴다. 설치 환경 OS 및 프로그램 버전 ...

소개 마크다운 문서를 vimwiki로 작성하여 간단한 메모에서 부터 블로그, 리포트, 기술 문서에 이르기까지 손쉽게 만들 수 있다. 이를 기반으로 하여 깃허브에서 제공하는 무료 웹사이트에 올리는 방법을 설명하고자 한다. 아래는 간략한 개요이다. vimwiki + hugo + github.io 를 연결하는 프로젝트이다. vim의 vimwiki 플러그인을 사용하여 위키문서를 작성한다. 위키문서의 작성은 마크다운(../markdown) 문법으로 한다. hugo를 사용하여 임시 로컬웹서버를 띄우고 위키문서를 html로 변환하고 브라우저에서 확인한다. 변환된 정적 html 문서를 깃허브에 올린다. 깃허브 페이지에서 이를 확인한다. UTF-8인코딩이라면 한글도 특별히 문제가 없고 잘 된다. 다만 마크다운 파일명에 공백이 들어가면 관리가 좋지 않으니 -등으로 연결해서 쓴다. 설치 환경 OS 및 프로그램 버전 ...

2022.09.08 - 링크 수정, 오타 수정 Install ubuntu 에서 패키지로 설치 $ sudo apt install hugo $ hugo version Create a New SIte $ hugo new site my_site -f yml Add a Theme 설치와 설정에 대한 자세한 사항은 hugo papermod를 참고. PaperMod 테마 설치 $ cd my_site $ git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1 Update $ cd themes/PaperMod $ git pull Add theme set in config.yml $ echo 'theme: "PaperMod"' >> config.yml 또는 PaperMod 홈에 가서 config.yml을 복사한다. Sample Page 만들기 --- title: "My 1st post" date: 2020-09-15T11:30:03+00:00 # weight: 1 # aliases: ["/first"] tags: ["first"] author: "Me" # author: ["Me", "You"] # multiple authors showToc: true TocOpen: false draft: false hidemeta: false comments: false description: "Desc Text." canonicalURL: "https://canonical.url/to/page" disableHLJS: true # to disable highlightjs disableShare: false disableHLJS: false hideSummary: false searchHidden: true ShowReadingTime: true ShowBreadCrumbs: true ShowPostNavLinks: true ShowWordCount: true ShowRssButtonInSectionTermList: true UseHugoToc: true cover: image: "<image path/url>" # image path/url alt: "<alt text>" # alt text caption: "<text>" # display caption under cover relative: false # when using page bundles set this to true hidden: true # only hide on current single page editPost: URL: "https://github.com/<path_to_repo>/content" Text: "Suggest Changes" # edit text appendFilePath: true # to append file path to Edit link --- ## This is sample Page Hello World! 페이지 생성1: my_site/contents/sample.md가 들어간다. $ hugo new --kind post sample.md 페이지 생성2: my_site/contents/posts/my-first-post.md가 생성된다. $ hugo new posts/my-first-post.md LANGUAGE CODE 설정 my_site/langcode.yaml 을 추가하고 설정한다. - id: prev_page translation: "Prev" - id: next_page translation: "Next" - id: read_time translation: one: "1 min" other: "{{ .Count }} min" - id: words translation: one: "word" other: "{{ .Count }} words" - id: toc translation: "Table of Contents" - id: translations translation: "Translations" - id: home translation: "Home" - id: edit_post translation: "Edit" - id: code_copy translation: "copy" - id: code_copied translation: "copied!" Start the Hugo Server 아래와 같이 서버를 실행하고 브라우저에서 http://localhost:1313 으로 확인 실행 위치는 my_site/ 내에서 해야한다. $ hugo server -D Links https://cristianpb.github.io/blog/vimwiki-hugo https://gohugo.io/getting-started/quick-start/ https://themes.gohugo.io/themes/hugo-papermod/

2023-08-31: 오타 수정, 할일과 일기 항목 내용 추가 2023-08-04: nvim에서의 설정 추가, 오타 및 링크 수정 2022-09-12: vimwiki cheatsheet 링크 추가 vim에서 설치 vim의 vimwiki 플러그인을 설정 추가하고 설치한다. vim ~/.vimrc 설정 추가 내용 "vimwiki 플러그인 Plug 'vimwiki/vimwiki', {'branch': 'dev'} "vimwiki의 편한 시작을 위한 vim starter tool Plug 'mhinz/vim-startify' 플러그인 설치 $ vim +PluginInstall +qall vim에서 설정 $ vim ~/.vimrc " vimwiki 설정 " 공개용 위키(github와 연동), 개인용 위키 두개를 설정(gdrive, dropbox 연동) let g:vimwiki_list = [ \{ \ 'path': '/data/vimwiki/wiki', \ 'syntax' : 'markdown', \ 'ext' : '.md', \ 'diary_rel_path': '.', \}, \{ \ 'path': '/data/vimwiki/mywiki', \ 'ext' : '.md', \ 'diary_rel_path': '.', \}, \] " vimwiki의 conceallevel 을 끄는 것이 좋다 let g:vimwiki_conceallevel = 0 " vimwiki 설정이 markdown 설정을 침투하지 않게 하기 let g:vimwiki_global_ext = 0 Neovim에서 설치 플러그인 등록: ~/.config/nvim/lua/plugins.lua use {'vimwiki/vimwiki'} 플러그인 설치: nvim 내에서 :PackerInstall 플러그인 설치: shell 내에서 $ nvim + $ nvim +PluginInstall +qall Neovim에서 설정 설정: ~/.config/nvim/lua/settings.lua -- vimwiki - https://github.com/vimwiki/vimwiki ---------------------------------------------------------------- vim.cmd([[ iabbr __email abcd@efgh.com iabbr <expr> __time strftime("%Y-%m-%d %H:%M:%S") iabbr <expr> __date strftime("%FT%R:%S+09:00") iabbr <expr> __today strftime("%F") iabbr <expr> __file expand('%:p') iabbr <expr> __name expand('%') iabbr <expr> __pwd expand('%:p:h') iabbr <expr> __front system("/home/borisu/bin/frontmatter.sh") iabbr <expr> __luajit '#!/usr/bin/env luajit' ]]) -- Key Mapping nmap('<C-l>', ':VimwikiToggleListItem<CR>') -- Contol + Space is default -- vim.g.vimwiki_autowriteall = true -- automatically save a modified wiki buffer -- vimwiki의 conceallevel 을 끔 vim.g.vimwiki_conceallevel = 0 -- vimwiki 설정이 markdown 설정을 침투하지 않게 하기 vim.g.vimwiki_global_ext = 0 -- 모든 마크다운에 대해 동작하지 않도록 함 vim.g.vimwiki_list = { { path = '$HOME/vimwiki/', syntax = 'markdown', ext = '.md', diary_rel_path = '.', } } 재인식 :luafile % -- 또는 :so % 기본 키정의 :h vimwiki-local-mappings – See default key binding ...