폴더 및 파일

폴더 구조

obsidian/
└── blog/
    ├── post1.md
    ├── post2.md
    └── ...
blog_hugo/
├── archetypes/
├── content/
├── layouts/
├── static/
├── themes/
├── config.toml

폴더 및 파일 설명

• archetypes/: Hugo에서 새로운 콘텐츠를 생성할 때 사용할 템플릿이 저장되는 디렉토리입니다.
• content/: 사이트의 콘텐츠 파일이 저장되는 디렉토리입니다.
• layouts/: Hugo 템플릿 파일이 저장되는 디렉토리입니다.
  • partials/: 사이트의 일부(예: 사이드바)를 정의하는 파셜 템플릿이 저장되는 폴더입니다.
    • sidebar.html: 트리 구조의 사이드바를 정의하는 템플릿 파일입니다.
  • _default/: 기본 레이아웃 템플릿이 저장되는 폴더입니다.
    • baseof.html: 모든 페이지에 공통으로 적용되는 기본 레이아웃 파일입니다.
• static/: 정적 파일(CSS, JavaScript 등)이 저장되는 디렉토리입니다.
  • css/: 사용자 정의 CSS 파일이 저장되는 폴더입니다.
    • custom.css: 트리 구조 사이드바의 스타일을 정의하는 CSS 파일입니다.
  • js/: 사용자 정의 JavaScript 파일이 저장되는 폴더입니다.
    • custom.js: 트리 구조 사이드바의 확장/축소 기능을 구현하는 JavaScript 파일입니다.
• themes/: Hugo 테마가 저장되는 디렉토리입니다.
  • PaperMod/: PaperMod 테마가 저장되는 폴더입니다.
• config.toml: Hugo 사이트의 설정 파일입니다.

Hugo.toml vs Config.toml

Hugo는 설정 파일의 이름을 자유롭게 지정할 수 있는 기능을 제공하며, 기본적으로는 config.toml을 사용하지만, 다른 이름의 파일을 사용할 수도 있습니다. 최상위 폴더에 hugo.toml 파일이 있는 경우, 이는 프로젝트의 설정 파일로 사용되고 있을 가능성이 큽니다. Hugo는 기본적으로 config.toml을 찾지만, 특정 설정 파일을 명시적으로 지정할 수 있습니다.

설정 파일의 관계

• config.toml
  • Hugo의 기본 설정 파일입니다.
  • 이 파일이 존재하면 Hugo는 이 파일을 사이트의 설정으로 사용합니다.
• hugo.toml
  • 프로젝트에서 설정 파일의 이름을 hugo.toml로 지정했다면, 이 파일이 사이트의 설정을 정의합니다. Hugo는 여러 설정 파일을 병합하거나 우선 순위를 두고 사용하는 기능을 제공하지 않습니다. 따라서 여러 설정 파일이 있는 경우, 명시적으로 사용할 파일을 지정해야 합니다.

설정 파일 지정 방법

Hugo는 실행 시 특정 설정 파일을 명시적으로 지정할 수 있습니다. 예를 들어, hugo.toml 파일을 사용하려면 다음과 같이 명령어를 사용할 수 있습니다

hugo server --config hugo.toml

Buy me a coffee