GitHub 블로그 만들기(1)
본 문서는 GitHub 블로그 만들기 시리즈의 첫번째 단계로 Ruby와 Jekyll 설치 방법을 담고 있다. macOS와 Windows의 Ruby 설치 방법이 약간 다르다. Windows는 3. Ruby부터 시작하면 된다.
Jeklly과 Ruby
Jeklly(지킬)은 정적 사이트 생성기이며, Ruby 프로그래밍언어로 작성되었다. 따라서 Ruby를 설치한 뒤, Jeklly을 설치하는 과정이 필요하다.
- GitHub Pages를 통해 무료로 내가 만든 웹페이지를 인터넷상에 공개할 수 있다.
- Markdown을 사용한다.
1. Command Line Tools 설치
Xcode가 있는 경우 이 단계를 건너뛰어도 된다.
1
$ xcode-select --install
2. Homebrew 설치
Homebrew는 MacOS에서 일반적으로 사용되는 패키지 관리자로 여러가지 패키지 명령어를 한 줄로 간단하게 다운로드 해주는 도구이다.
1
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
잘 설치되었는지 확인하려면 아래와 같이 입력하면 된다.
1
$ brew
오류 - not found: brew
Mac에서 보통 Homebrew는 /opt/homebrew에 설치되기 때문에 다음과 같은 오류가 발생할 수 있다.
1
$ zsh: command not found: brew
환경변수 설정을 해주면 오류를 해결할 수 있다.
1
$ opt/homebrew/bin/brew doctor
위 command를 실행하면 가장 아래에 다음과 같은 해결책을 준다. 환경변수 설정을 하고 코드를 적용하면 이제 brew 가 잘 실행된다.
1
2
3
4
# 터미널에서 환경변수 설정
$ echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
# 코드 적용
$ source ~/.zshrc
3. Ruby 설치
Windows는 Ruby 다운로드 페이지에서 Ruby+Devkit 3.2.2-1 (x86)를 설치하면 된다. 설치가 완료되면 커맨드 창이 뜨며, Enter를 눌러 자동으로 셋업이 완료되게 하면 된다. 모든 설치가 완료되고 터미널에 아래와 같이 입력하여 버전 정보가 뜬다면 잘 설치가 된 것이다.
1
$ ruby -v
MacOS는 아래 단계를 따라 설치하면 된다.
3-1. rbenv(Ruby Version Manager) 설치
Ruby의 버전을 관리해주는 프로그램이다.
1
$ brew install rbenv
3-2. rbenv 설정
아래는 zsh를 사용할 때의 예시이며, bash를 사용할 경우 ~/.zshrc를 ~/.bash_profile로 수정하면 된다.
1
2
$ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
$ source ~/.zshrc
3-3. Ruby 다운로드
Ruby 공식홈페이지에서 최신/안정적인 버전을 확인하고 설치하면 된다. 아래는 3.3.0 버전을 설치하는 명령어이다.
1
$ rbenv install 3.3.0
전역에서 사용할 Ruby 버전을 지정한다.
1
$ rbenv global 3.3.0
잘 설치되었는지 확인하기 위해 아래의 명령어를 입력하면, 설치한 버전 정보를 알려준다.
1
2
$ rbenv versions
$ ruby -v
마지막으로 rehash를 한다.
1
$ rbenv rehash
4. Jekyll 설치
Ruby가 잘 설치되었다면 간단하게 Jekyll을 설치할 수 있다. 아래는 jekyll, bundler, github-pages를 함께 설치하는 명령어이다.
1
$ gem install jekyll bundler github-pages
bundler는 Gemfile과 Gemfile.lock 파일을 이용해 프로젝트 폴더에서 사용하는 다양한 패키지 버전들을 관리한다.
github-pages는 Github에서 사용하는 Jekyll과 관련된 의존성 패키지들을 지원한다.
아래의 명령어를 입력하여 버전 정보가 잘 뜬다면 잘 설치된 것이다.
1
2
3
$ jekyll -v
$ bundler -v
$ github-pages -v