Documentation

Hexo 문서에 오신 것을 환영합니다. Hexo 사용 중 문제가 발생한다면 troubleshooting guide를 살펴보세요. 이슈가 발생했다면 GitHub 또는 Google Group 에 내용을 등록해 주세요.

Hexo는 무엇인가요?

Hexo는 빠르고 간단하고 파워풀한 블로그 프레임워크입니다. Markdown(또는 다른 언어)을 사용하여 포스트를 작성하면 Hexo는 금세 멋진 테마를 가미해서 정적인 파일을 생성해 드립니다.

설치하기

It only takes a few minutes to set up Hexo. 설치 시 문제가 생겼는데 해결책을 찾지 못했다면, submit a GitHub issue에 등록해 주세요. 제가 해결해 드리겠습니다.

요구사항

Hexo의 설치는 꽤 쉽습니다. 하지만, 설치 전에 몇 가지 요구사항이 있습니다.

  • Node.js (Should be at least Node.js 10.13, recommends 12.0 or higher)
  • Git

컴퓨터에 이미 이런 것들이 설치되어 있다면, 축하드립니다! 이제 npm을 이용하여 Hexo를 설치하기만 하면 됩니다.

설치되어 있지 않다면, 아래의 설명을 따라 요구사항들을 설치하세요.

Git을 설치하세요

  • Windows: git 에서 다운로드해서 설치하세요.
  • Mac: Homebrew, MacPorts, installer 중 하나 선택해서 설치하세요.
  • Linux (Ubuntu, Debian): sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core
For Mac users

컴파일 중에 몇 가지 문제가 발생할 수 있습니다. 우선 앱스토어를 통해 Xcode를 설치하세요. 그 다음, Xcode를 실행하고 Preferences -> Download -> Command Line Tools -> Install 의 방법으로 command line tool을 설치하세요.

Node.js를 설치하세요

Node.js provides official installer for most platforms.

Alternative installation methods:

  • Windows: Install it with nvs (recommended) or nvm.
  • Mac: Install it with Homebrew or MacPorts.
  • Linux (DEB/RPM-based): Install it with NodeSource.
  • Others: Install it through respective package manager. Refer to the guide provided by Node.js.

nvs is also recommended for Mac and Linux to avoid possible permission issue.

Windows

If you use the official installer, make sure Add to PATH is checked (it’s checked by default).

Mac / Linux

If you encounter EACCES permission error when trying to install Hexo, please follow the workaround provided by npmjs; overriding with root/sudo is highly discouraged.

Linux

If you installed Node.js using Snap, you may need to manually run npm install in the target folder when initializing a blog.

Hexo 설치하기

위의 요구사항을 모두 설치하셨다면, npm을 통해 Hexo를 설치하세요.

$ npm install -g hexo-cli

Advanced installation and usage

Advanced users may prefer to install and use hexo package instead.

$ npm install hexo

Once installed, you can run Hexo in two ways:

  1. npx hexo <command>
  2. Linux users can set relative path of node_modules/ folder:
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

then run Hexo using hexo <command>

Required Node.js version

If you are stuck with older Node.js, you can consider installing a past version of Hexo.

Please note we do not provide bugfixes to past versions of Hexo.

We highly recommend to always install the latest version of Hexo and the recommended version of Node.js, whenever possible.

Hexo version Minimum (Node.js version) Less than (Node.js version)
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 unknown
3.0 - 3.1 0.10 or iojs unknown
0.0.1 - 2.8 0.10 unknown
Next