웹사이트 전환 동기

• Hugo는 Go로 만들어진 오픈소스 정적 사이트 생성기로, Markdown 파일과 템플릿을 사용하여 정적 HTML 페이지를 생성.
• Quarto는 R, Python, Julia 등 여러 언어를 지원하며, 동적 문서, 발표, 웹사이트 및 책을 생성하는 오픈소스 출판 시스템.

전환 이유

• 파일 관리: Hugo는 index.md 파일을 요구하지만, Quarto는 index.qmd 파일 하나로 관리 가능.
• 기능 부족: Hugo 테마에서 LaTeX 수식, HTML과 Markdown 결합, 클라이언트 사이드 검색 등 여러 기능을 직접 구현해야 했으나, Quarto는 이러한 기능을 기본 제공.
• 언어 지원: Quarto는 R 외에도 Python과 D3에 대한 원활한 지원 제공.

변경 사항

• YAML 옵션: Hugo와 Quarto의 YAML 옵션이 다르므로 수정 필요. 예를 들어, slug 옵션이 Quarto에서는 제거됨.
• Shortcode 업데이트: Hugo의 shortcode는 Quarto에서 인식되지 않으므로, Quarto에 맞게 변경해야 함.
• 배포: GitHub Pages에 배포 시 GitHub Actions 스크립트 업데이트 필요.

어려운 점

• 웹사이트 구조: Hugo와 Quarto의 GitHub 저장소 구조 차이로 인한 URL 관리가 복잡함.
• 페이지 수: 57개의 블로그 포스트와 64개의 발표 페이지를 수동으로 업데이트해야 했음.

팁

• 단일 페이지를 렌더링할 때는 파일명을 _index.html로 변경하여 Quarto가 이를 인식하도록 할 수 있음.
• 웹사이트를 최소한의 버전으로 시작하여 점진적으로 블로그 포스트를 이전하는 것이 좋음.

댓글

불러오는 중…