DocFlow
StaticSite
Guide
휴고 프로젝트 시작

휴고 프로젝트 시작

Hugo 사이트 생성

새로운 Hugo 사이트를 생성하려면 아래 명령어를 사용합니다.

hugo new site DocFlow_web
cd DocFlow_web

이 명령어는 DocFlow_web이라는 새로운 디렉토리를 만들고, Hugo 사이트 구조를 초기화합니다.

사이트 디렉토리를 Git 리포지토리로 초기화

사이트 디렉토리를 Git 리포지토리로 초기화하여 버전 관리를 시작합니다.

git init

참고

사이트 생성 시 옵션

Hugo 사이트를 생성할 때 사용할 수 있는 몇 가지 옵션이 있습니다. 이러한 옵션들은 사이트 생성 시 특정 설정을 자동으로 적용할 수 있게 도와줍니다.

  • --force: 기존에 같은 이름의 디렉토리가 있어도 강제로 덮어씁니다.
  • --format: 구성 파일의 형식을 설정합니다. 기본값은 toml입니다.
    • --format yaml: 구성 파일의 형식을 yaml로 지정합니다.
    • --format json: 구성 파일의 형식을 json으로 지정합니다.
  • --config: 생성 시 사용할 추가 구성 파일을 지정합니다. 예시
hugo new site DocFlow_web --format yaml

--config

--config 옵션은 Hugo 프로젝트를 다양한 환경에서 쉽게 설정하고 관리할 수 있게 해줍니다. 여러 구성 파일을 사용하여 환경별로 다른 설정을 적용하고, 필요에 따라 설정을 병합할 수 있습니다. 이를 통해 Hugo 사이트의 유연성과 관리 효율성을 높일 수 있습니다.

  • 추가 구성 파일 사용: 기본 config.toml 파일 외에 추가 구성 파일을 사용할 수 있습니다.
  • 환경별 설정 관리: 개발, 테스트, 배포 등 다양한 환경에 맞춘 설정 파일을 지정할 수 있습니다.
  • 구성 파일 병합: 여러 구성 파일을 지정하여 설정을 병합할 수 있습니다.

사용 방법

Hugo 사이트를 생성할 때 --config 옵션을 사용하여 추가 구성 파일을 지정합니다. 이 명령어는 yaml 형식의 구성 파일을 사용하여 새로운 사이트를 생성합니다.

hugo new site DocFlow --config config.toml,config-dev.toml

위 명령어는 DocFlow 디렉토리를 생성하고, config.toml과 config-dev.toml 파일을 사용하여 사이트를 구성합니다.

예시

1. 기본 구성 파일

기본적으로 hugo new site 명령어를 사용하면 config.toml 파일이 생성됩니다. 이 파일에는 사이트의 기본 설정이 포함됩니다.

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"

2. 추가 구성 파일

환경별로 다른 설정을 적용하기 위해 추가 구성 파일을 생성할 수 있습니다. 예를 들어, 개발 환경용 구성 파일을 config-dev.toml로 생성합니다.

# config-dev.toml
baseURL = "http://localhost:1313/"

3. 구성 파일 병합

Hugo는 기본 구성 파일과 추가 구성 파일을 병합하여 최종 설정을 생성합니다. --config 옵션을 사용하여 사이트를 생성하거나 서버를 실행할 때, 여러 구성 파일을 지정할 수 있습니다.

hugo server --config config.toml,config-dev.toml

이 명령어는 config.toml과 config-dev.toml 파일을 병합하여 서버를 실행합니다. 병합된 설정에서는 baseURL이 config-dev.toml 파일의 값인 http://localhost:1313/로 설정됩니다.

Buy me a coffee Buy me a coffee
Hextra 테마 설치