옵시디언을 활용한 휴고 블로그 설정과 글 작성 가이드

맥북으로 코드 작성

옵시디언을 활용한 휴고 블로그 설정과 글 작성 가이드

이전에는 옵시디언이 왜 휴고와 어울리는지, 그리고 휴고 설치와 여러 가지 방법들을 설명했습니다. 최종적으로 옵시디언을 어떻게 휴고 테마에 사용하는지, 그리고 휴고에 필요한 것들은 무엇인지 알려드리겠습니다.

휴고와 마크다운

휴고는 일반적으로 마크다운 파일을 통해 글을 작성합니다. 따라서 웬만한 마크다운 언어들은 다 지원합니다. Mermaid까지도요! 또한 각각의 테마에서도 지원하는 다른 기능들이 있을 수 있으니 꼭 테마 사용 설명서를 정독해주세요. 카드 혹은 유튜브를 직접 링크할수도 있습니다.

파일들의 위치

옵시디언에 출력할 글들인 마크다운 파일들은 hugo의 content 폴더에 있어야 합니다. 그러므로 편리한 사용을 위해 hugo 내부의 content 폴더에 직접 블로그용 vault를 링크하는 걸 추천합니다. 이를 통해 옵시디언에서 작성한 글을 휴고로 손쉽게 관리하고 업로드할 수 있습니다.

Vault 생성하기

Hugo에서 옵시디언을 활용하려면 Vault를 설정해야 합니다. 이 Vault는 Hugo 프로젝트 내의 content 폴더와 연결되어야 합니다. 다음은 Vault를 생성하고 이를 Hugo 프로젝트와 연결하는 방법입니다.

옵시디언에서 Managed Vault 열기
- 옵시디언을 열고, 새로운 Vault를 생성할 때 Managed Vault 옵션을 선택합니다.
- 이때, Hugo 프로젝트의 content 폴더를 Vault로 설정해 주세요.
옵시디언 설정 파일 생성
- Vault를 생성하고 연결하면, Hugo의 content 폴더 내에 옵시디언의 설정 파일이 자동으로 생성됩니다.
- 이 설정 파일들은 옵시디언의 내부 동작을 지원하며, 나중에 글을 작성할 때 유용하게 사용됩니다.
GitHub Pages에 파일 업로드 시 주의사항
- Hugo에서 글을 작성하고 GitHub Pages에 업로드할 때, 옵시디언의 설정 파일이나 휴지통에 해당하는 파일들은 함께 업로드되면 안 됩니다.
- 따라서, GitHub에 업로드할 때 불필요한 파일들이 포함되지 않도록 .gitignore 파일에 다음과 같은 설정을 추가합니다:
```
/content/.obsidian
/content/.trash
```
- 위 설정을 통해 옵시디언의 설정 파일(.obsidian)이나 휴지통에 포함된 파일(.trash)이 GitHub에 업로드되지 않도록 할 수 있습니다. 이렇게 하면 불필요한 파일들이 저장소에 포함되는 것을 방지할 수 있습니다.

프론트 매터 (Front Matter) 설정

마크다운 파일 내에서 사용되는 front matter는 글의 메타데이터를 설정하는 중요한 부분입니다. 일반적으로 사용되는 속성은 다음과 같습니다:

title: 제목
weight: 글 중요도 (넘버링)
description: 메타 설명
draft: true

title: 글의 제목을 설정합니다.
weight: 글의 중요도를 설정하는 숫자로, 번호가 낮을수록 상위에 표시됩니다. weight는 선택 사항이지만, 글의 순서를 조정하려면 유용합니다.
description: 해당 글의 메타 설명을 설정하여 검색 엔진 최적화(SEO)에 도움이 됩니다.
draft: 글을 임시 저장하려면 true로 설정합니다. false로 설정하면 바로 발행됩니다.

위 네 가지는 매우 기본적이고 유용한 설정입니다. weight와 draft는 선택 사항이지만, 발행을 제어하고 싶다면 꼭 필요한 설정입니다.

마크다운 파일의 제목은 휴고 사이트에서 해당 글의 URL 주소가 됩니다. 실제 제목은 title이며 글의 url은 마크다운의 파일의 제목이니 유의해서 작성하길 바랍니다.

글 발행

마지막으로, 글을 작성한 후 draft: false로 설정하고, GitHub에 푸시하면 GitHub Pages 또는 다른 배포 서비스를 통해 사이트가 자동으로 업데이트됩니다.

결론

옵시디언과 휴고를 연동하여 효율적인 웹사이트 운영을 할 수 있습니다. 옵시디언의 강력한 마크다운 작성 기능과 휴고의 빠른 빌드 속도를 결합하여, 블로그나 문서 사이트를 관리하는 데 큰 도움이 될 것입니다. 이 설정을 통해 글을 편리하게 작성하고, 관리하며, 발행하는 과정이 매끄럽게 이루어집니다.

휴고와 옵시디언의 연동은 한 번 설정해두면 이후 글 작성과 사이트 관리가 매우 간편해집니다. 글을 작성할 때마다 draft를 설정하여 필요한 시점에 발행하고, Git을 통해 버전 관리가 가능하므로 매우 효율적입니다.