Devel

소개 마크다운 문서를 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/

소개 깃허브에서 제공하는 깃페이지 github io에 웹 블로그 환경을 만들 수 있는 프로젝트이다. 현재 나는 hugo로 전환하였다. 이 문서는 더 이상 업데이트 되지 않을 것이다. 혹시 이 문서를 보는 분을 위하여 가장 잘 설명해 놓은 곳을 소개한다. https://devinlife.com/howto/ Install sudo apt update sudo apt install ruby ruby-dev cat>>EOF >> ~/.bashrc # Ruby exports export GEM_HOME=$HOME/gems export PATH=$HOME/gems/bin:$PATH EOF source ~/.bashrc gem install jekyll bundler 개발 사이트 만들기 프로젝트 생성 후 서버 시작 jekyll new www cd www/ bundle exec jekyll serve jekyll 서버 실행 에러시 cd www/ echo 'gem "webrick"' >> Gemfile bundle install bundle exec jekyll serve --host 127.0.0.1 --port 4000 브라우저에서 다음 URL로 확인 http://127.0.0.1:4000 폴더 내의 변경은 자동 업데이트된다. 그러나 _config.yml의 경우는 jekyll serve를 재실행 해주어야 한다. 테마 프로젝트 설치 minimal mistakes Links https://devinlife.com/howto Jekill 홈페이지