[268] Obsidian과 Hugo를 활용한 블로깅 워크플로우 설정 가이드 소개

Obsidian과 Hugo를 활용한 블로깅 워크플로우 설정 가이드

아래는 글에서 설명된 Obsidian과 Hugo를 통합하여 자동화된 블로깅 워크플로우를 구축하는 방법을 단계별로 정리한 설명입니다.

1. Obsidian과 Hugo란?

• Obsidian: 강력한 마크다운 편집기로, 비선형적이고 유연하게 지식을 관리할 수 있는 도구입니다. 모든 플랫폼에서 사용 가능하며, 개인 노트 관리 및 글 작성에 적합합니다.
• Hugo: Golang으로 제작된 초고속 정적 웹사이트 생성기입니다. 마크다운 파일을 기반으로 웹사이트를 생성하며, 블로그 제작에 자주 사용됩니다.

2. 목표

이 설정의 목표는 다음과 같습니다:

• 단일 Obsidian Vault(저장소)를 사용
• 블로그 게시물 작성을 위한 간단한 Obsidian 템플릿 제공
• 개인 Vault 폴더를 비공개로 유지
• Obsidian 핫키를 통해 자동 게시
• 모든 마크다운 파일을 공개 GitHub 저장소에 저장하여 사용자 피드백 가능

3. 기존 워크플로우 개요

1. Obsidian에서 Hugo 프로젝트의content폴더 안에서 글 작성 및 편집.
2. Hugo 명령어 실행으로 정적 사이트 생성.
3. 변경 사항을 GitHub에 푸시.
4. Render.com에서 자동으로 변경 사항을 배포.

4. 설정 과정

4.1 폴더 구조

• blog/: Hugo 프로젝트 폴더 (블로그 관련 파일 저장).
  • blog/content: Hugo의 마크다운 파일 저장 디렉토리.
• vault/: 개인 Obsidian Vault 폴더.
  • vault/Blog: 블로그 관련 마크다운 파일 저장 디렉토리.

폴더 동기화 문제 해결

1. 실수 1: 심볼릭 링크 사용
   • blog/content와vault/Blog를 심볼릭 링크로 연결했으나, GitHub에서 파일이 표시되지 않아 사용자 피드백 불가능.
2. 실수 2: 폴더 동기화 스크립트
   • 크론잡(cron job)으로 동기화 스크립트를 실행했으나, 항상 백그라운드에서 실행되는 것은 비효율적.

해결 방법

• 수동 스크립트 대신 Obsidian 플러그인(obsidian-shellcommands)을 활용하여 핫키로 동기화 실행.

4.2 Obsidian 템플릿 설정

1. Obsidian의 템플릿 기능 활성화.
2. 템플릿 폴더에Blog Post라는 파일 생성. 아래 내용을 템플릿에 추가:

• 이 템플릿은 Hugo의 Front Matter 형식에 맞춰 제목, 설명, 날짜 등을 자동으로 입력.

4.3 폴더 동기화

필요 플러그인 설치

• Obsidian 플러그인obsidian-shellcommands설치 및 활성화.

동기화 명령어 설정

1. 플러그인 옵션에서 새 쉘 명령어 추가:
   • Linux/MacOS:

     cp -a ~/Documents/vault/Blog/. ~/Documents/blog/content/
   • Windows:

     robocopy "%USERPROFILE%\vault\Blog""%USERPROFILE%\blog\content" /E /COPYALL
2. 핫키 지정 (예:Ctrl + 0).

작동 방식

• 핫키를 누르면vault/Blog폴더의 모든 파일이blog/content폴더로 복사됨.

4.4 자동 게시 스크립트

스크립트 작성

아래 스크립트를 작성하여 자동 게시 기능 구현:

1. 위 스크립트를 파일(push.sh)로 저장.
2. 실행 권한 부여:

   chmod +x ./push.sh

핫키 설정

1. 플러그인에서 새 쉘 명령어 추가:

   ~/Documents/blog/push.sh
2. 핫키 지정 (예:Ctrl + P).

작동 방식

• 핫키를 누르면 Hugo가 사이트를 빌드하고, 변경 사항을 GitHub에 푸시하여 배포.

5. 최종 워크플로우

1. Obsidian에서 새 파일 생성 후 템플릿 삽입.
2. 글 작성 후 핫키(Ctrl + 0)로 Hugo 디렉토리에 복사.
3. 또 다른 핫키(Ctrl + P)로 사이트 빌드 및 게시.

이 과정을 통해 효율적이고 자동화된 블로그 관리가 가능합니다!