Markdown

소개 Hugo로 홈페이지를 제작할 때 주로 마크다운(markdown)으로 작업을 한다. 코드블럭을 사용할 때 원래 소스파일이 변경되면 다시 마크다운 문서도 수정을 해야한다. 이 때 직접 소스 파일을 읽어서 페이지를 만든다면 해당 소스파일만 관리하면 문서에 일관성이 생기고 변경하더라도 즉시 반영된다. Hugo에서는 shortcode라는 방법을 제공하여 사용자만의 shortcode를 작성할 수 있다. Shortcode Include - 마크다운 파일 포함하기 Hugo Project 내에 다음 파일을 작성: layouts/shortcodes/include.html {{- $relPath := .Get 0 -}} {{- $baseDir := .Page.File.Dir -}} {{- $fullPath := path.Join $baseDir $relPath -}} {{- readFile $fullPath | markdownify -}} 작성된 shortcode 사용하기: content/posts/mypost.md에 foo.md를 포함하기 {{< include "foo.md" >}} Shortcode Code - 코드 파일 포함하기 Hugo Project 내에 다음 파일을 작성: layouts/shortcodes/code.html {{ $language := .Get "language" }} {{ $source := .Get "source" }} {{ $options := .Get "options" }} {{ with $source | readFile }} {{ highlight (trim . "\n\r") $language $options }} {{ end }} 작성된 shortcode 사용하기: content/posts/mypost.md에 foo.c를 포함하기 코드블럭 내에 아래 코드를 넣으면 foo.c를 채워 넣고 language옵션에 따라 컬러가 지원된다. {{< code source="example/foo.c" >}} REFERENCE How to include code examples from file with hugo: https://marcusolsson.dev/how-to-include-code-examples-from-file-with-hugo/ ...

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/

firefox: markdown viewer 플러그인 firefox의 플러그인으로 로컬내에서 마크다운을 html 페이지로 보여준다. vim과 연동하여 마크다운파일을 작성하고 실시간으로 볼 때 유용하다. Laste Updated: 2022.08.11 설치 및 설정 firefox plugin은 markdown viewer Webext 이다. 이를 설치. cat <<EOF > ~/.local/share/mime/packages/text-markdown.xml <?xml version="1.0"?> <mime-info xmlns='http://www.freedesktop.org/standards/shared-mime-info'> <mime-type type="text/plain"> <glob pattern="*.md"/> <glob pattern="*.mkd"/> <glob pattern="*.mkdn"/> <glob pattern="*.mdwn"/> <glob pattern="*.mdown"/> <glob pattern="*.markdown"/> </mime-type> </mime-info> EOF update-mime-database ~/.local/share/mime 확인 테스트 방법1) 브라우저에서 로컬에 있는 md 파일을 불러서 잘 동작하는 지 확인. ...

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 ...