자바스크립트를 활성화 해주세요

h001 hugo, 제일 심플하게 설치하기

 ·  ☕ 3 min read

    여러 블로그를 시도하던 도중 hugo와 git을 사용하여 블로그를 사용할 수 있다는 것을 알게 됩니다. 쉽게 쉽게 아주 간단한 방법으로 블로그 포스트를 작성하고 싶었는데 어떻게 하면 좋을까요?

    설치

    hugo 설치는 간단했습니다.

    우선, 블로그글을 Markdown으로 사용하신다면, 적어도 터미널에서 Vim이나 Emacs를 사용해서 작성하시는 고수분들도 가끔 보게됩니다.
    예를 들면 easy-go같은

    scoop install hugo
    

    이 명령어 하나면 path까지 설정해서 hugo 커맨드를 실행할 수 있게 해주었습니다.
    추가로 scoop install hugo-extended 해 두셔도 좋습니다. theme에 따라서 다음과 같은 에러메시지가 나타나는 경우가 있는데, text/x-scss도 다룰 수 있게 확장해 줍니다.

    TOCSS: failed to transform "main_parsed.scss" (text/x-scss): this feature is not available in your current Hugo version
    

    chocolately를 사용하신다면 choco 커맨드로 설치하시면 됩니다.

    1
    2
    
    choco install hugo
    choco install hugo-extended
    

    정상적인 수순이라면 hugo new site <site name>명령으로 site 디렉토리를 만들고 포스트를 작성합니다

    어떤 분은 다음과 같이 git 레포지토리를 2개를 준비하라고 합니다.

    • 렌더링하기 전의 구성을 올릴 private 레포지토리
    • 렌더링한 후의 public 을 올릴 public 레포지토리

    저는 렌더링전의 구성을 올릴 레포지토리 하나만 있으면 그 안에 테마들을 설치하고 갈아끼우고 하면 될 줄 알았습니다만, 테마를 변경하면 아예 문서 구조를 재정의 하여 쓰는 경우도 많았습니다. 테마를 바꾸면 기존의 구성을 그대로 사용할 수 있는 경우가 많았던 겁니다.

    그래서 저는 데이타가 되는 레포지토리와 테마설정한 레포지토리를 분리해 두어야 했습니다. 그러다 보니, 레포지토리가 여러개가 만들어 지게 되었습니다.

    • content의 markdown 파일들을 모아둔 private 레포지토리
    • 테마를 설치하고 config설정을 해 둔 레포지토리의 집합
    • 렌더링한 후의 public 을 올릴 public 레포지토리
    • 스크립트를 모아둔 모듈 레포지토리

    포스트를 작성하려면

    다음의 hugo 커맨드로 작성할 수 있습니다.

    hugo new post/test1.md
    

    이 커맨드, 아무곳에서나 실행해도 되는 걸까요?

    C:\temp>hugo new post/test1.md
    Error: Unable to locate config file or config directory. Perhaps you need to create a new site.
           Run `hugo help new` for details.
    

    아니요. hugo new site blog 를 한 곳이 아니면 안되었습니다.

    한글로도 post를 만들 수 있습니다. utf8 입력을 할 수 있는 환경이라면 일본어로도 파일을 만들 수 있습니다.
    저는 한글파일명을 그다지 좋아하지 않았지만, 파일명은 hugo블로그안에서 여러가지 용도로 사용하고 있기 때문에 한글 이름으로 생성했는데, 나중에는 file explorer에서도 내용을 한 눈에 알 수 있게 작성하는 요령이 붙어 나중에는 문제되지 않게 되어 다행이라고 생각했습니다.

    hugo new "hugo/hugo post만들기.md"
    

    저는 utf8입력이 필요한 터미널 작업은 일반적으로 code의 terminal을 사용하는 편입니다만, cmder도 가끔 사용하기도 합니다. powershell_ise도 있구요, 하지만, 역시 영어로 타이핑하는 경우가 제일 많고, 그때는 디폴트로 설치되어있는 cmd를 사용합니다.

    C:\Users\Administrator\blog>tree
    C:.
    ├─archetypes
    ├─content
    │  ├─hugo
    │  └─post
    ├─data
    ├─layouts
    ├─resources
    │  └─_gen
    │      ├─assets
    │      └─images
    ├─static
    └─themes
        └─ananke
            ├─archetypes
            ├─data
            ├─exampleSite
            │  ├─content
            │  │  ├─about
            │  │  └─post
            │  └─static
            │      └─images
            ├─i18n
            ├─images
            ├─layouts
            │  ├─page
            │  ├─partials
            │  │  ├─func
            │  │  └─svg
            │  ├─post
            │  ├─shortcodes
            │  └─_default
            ├─src
            │  ├─css
            │  └─js
            └─static
                ├─dist
                │  ├─css
                │  └─js
                └─images
    

    레퍼런스

    공유하기

    tkim
    글쓴이
    tkim
    Software Engineer