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 및 프로그램 버전 ...

2023-08-26: TIP 추가: gitignore 깃허브 가입과 설정 GitHub Home 에 가입한다. 새로운 저장소(Repository)를 만든다. 저장소의 주소를 확인한다.(Code 아이콘를 클릭) Github 제약사항 비공개 저장소(Private Repository): 유료에서 무료로 변경 (협업 3명까지) Github 가격페이지 (개인용플랜 Free, 유료플랜 Pro) Pro의 장점 비공개 저장소에 대한 페이지와 위키 제공 비공개 저장소에 대한 공동작업자 무제한 2019.1월 기준으로 모든 Repository 및 파일 무제한 단, 다음을 권장 모든 Repository의 갯수는 무제한 각 Repository를 1GB가 넘지 않도록 한다.(100GB Hard Limit) 각 파일은 100MB를 넘지 않는다. Github 등록 username, email address neosolaris/batutah@gmail.com git 설치 sudo apt install git Create Repository Repository Name: cmdTree Security Stat: Private initialize this repository with a README Add .gitignore: 깃허브로 올리지 않을 파일 선택 Add a license: 저장소 생성과 함께 라이센스 파일의 설치가 자동 수행 My Address: https://github.com/neosolaris/cmdTree Readme를 생성하지 말고 ...

Laste Updated: 2022.08.17 깃허브에서 정책이 변경되어 비밀번호로 인증을 더이상 지원하지 않는다. 다른 인증 방법은 github의 보안키 발급과 ssh key를 등록하는 방법이 있다. 여기에서는 ssh key를 만들어 github에 등록하여 사용하는 방법이다. CREATE SSH KEY: enter, enter, enter rsa로 키를 만들 경우 ssh-keygen -t rsa -b 4096 -C $email ls ~/.ssh/id_rsa #private key ls ~/.ssh/id_rsa.pub #public key ed25519로 키를 만들 경우 (추천: 보다 간결하고 강화된 방식) ssh-keygen -t ed25519 -C “yourmail@mail.com” ls ~/.ssh/id_ed25519 #private key ls ~/.ssh/id_ed25519.pub #public key 생성한 pub 키를 GitHub에 등록하기 생성한 키 중 pub키를 복사한다. 깃허브에 로그인하여 다음 메뉴를 찾아 클릭. |Github Home > Settings > SSH and GPG Keys > New SSH Key Title에 제목을 입력하고 “Add SSH Key"를 눌러 등록 완료. 터미널에서 새로운 프로토콜(SSH 인증방식)으로 연결 깃허브에 성공적으로 연결되는 지 확인 ssh -T git@github.com 깃허브에 연결 및 저장소 등록 git remote set-url origin git@github.com:user_name/repo_name.git Comment 이 방식은 https방식보다 간결한 URL과 편리한 사용법이 좋다. 또한 깃허브로부터 인증키를 받는 방식은 기간제한이 있다. 다른 컴퓨터에서 연결할 경우 ssh 키를 만들어 pub키를 깃허브에 추가해주면 된다. Reference https://medium.com/ntust-aivc/instruction-for-adding-an-ssh-key-to-your-github-account-ubuntu20-04-3-lts-f9f7802ed734

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/