팟캐스트 Jekyll로 한 페이지에서 여러 형식 파일 생성하기

🎙️ 오늘의 팟캐스트

Jekyll로 한 페이지에서 여러 형식 파일 생성하기

 

📌 에피소드 주요 내용

• Jekyll의 단일 형식 생성 제약을 다중 형식 파일 생성으로 해결하는 방법
• 마크다운 한 페이지로 HTML과 iCal을 동시에 생성하는 실무 사례
• GitHub Actions 자동화를 통한 효율적인 콘텐츠 관리 전략

 

 

🎧 전체 대본

지혜: 안녕하세요, 지혜입니다. 오늘은 웹 개발의 실무적 고민을 함께 나눌 건데요. 노교수님, 은퇴 후에 Jekyll이라는 도구로 강의 자료를 만드셨다고요?

박교수: 그렇습니다. 대학에서 학생들을 위해 무료 온라인 강좌 자료를 정리하려고 GitHub Pages와 Jekyll을 선택했거든요. 비용도 들지 않고 버전 관리도 쉬우니까요. 하지만 생각지 못한 문제가 생겼습니다.

지혜: 어떤 문제였어요?

박교수: 강의 일정을 올릴 때 말입니다. 학생들은 웹페이지에서도 보고 싶어 했지만, 동시에 자신의 캘린더 앱—Google Calendar나 Outlook—에 자동으로 추가될 수 있는 iCal 형식도 원했어요. 같은 내용을 두 가지 형식으로 유지하려니 비효율적이었습니다.

지혜: 아, 그래서 한 번에 여러 형식으로 만들 수 없나 하신 거네요.

박교수: 정확합니다. 알고 보니 Jekyll의 근본적인 한계였습니다. Jekyll은 마크다운 파일 하나당 기본적으로 HTML 형식 하나만 생성하거든요. 웹 버전, PDF, 인쇄본 같이 현실에선 여러 형식이 필요한데 말입니다.

지혜: 그럼 어떻게 해결하셨어요?

박교수: 가능한 방법이 몇 가지 있습니다. 첫째는 Jekyll 플러그인으로 커스텀 제너레이터를 만드는 것입니다. 루비 스크립트로 마크다운을 읽은 후 여러 형식으로 변환하는 방식이죠. 둘째는 출력 폴더를 여러 개 만드는 전략도 있고요.

지혜: 그 중에 교수님은 어떤 걸 선택하셨어요?

박교수: 저는 세 번째 방법을 택했습니다. Jekyll이 HTML을 생성한 후, Node.js 스크립트가 추가로 처리하는 방식이에요. 마크다운 파일을 순회해서 iCal이나 JSON으로 변환한 후 배치하는 겁니다. GitHub Actions로 자동화했으니까 유지보수도 간편합니다.

지혜: 와, 그럼 강의 일정을 수정할 때도 마크다운 파일 하나만 바꾸면 되는 거네요?

박교수: 정확히 그렇습니다. 빌드 프로세스가 자동으로 모든 형식을 업데이트하죠. 학창 시절에는 완벽한 이론을 배웠지만, 실무에선 작동하는 솔루션이 더 중요합니다. Jekyll의 제약을 원망하기보다, 그 위에 기능을 덧붙이는 게 효율적이라는 걸 배웠어요.

지혜: 정말 실용적인 접근이네요. 더 자세한 구현 방법이나 실제 코드는 블로그 원문에서 확인하실 수 있어요!

 

🔑 핵심 키워드

Jekyll, 다중형식생성, 자동화, GitHub Pages, Node.js

 

🔗 관련 링크

• 원문 보기: Jekyll로 한 페이지에서 여러 형식 파일 생성하기
• 블로그 홈: damesek.com