본문 바로가기

기타/블로그

우분투 Jekyll 설치 및 github 블로그 테마 적용하기

프로그래밍 공부하면서 정보를 공유하기도 하며, 일상 생활과 생각을 정리하기 위하여 블로그를 생성하기로 하였다.
사실 네이버에서도 블로그를 해보았는데, 지식 공유 블로그로 깃허브와 티스토리를 생각하고 있었고 깃허브 블로그를 만들어 보게 되었다.
블로그를 꾸미기 위하여 간단하게 웹사이트를 제작해주는 jekyll을 찾아보았다.

루비 설치

블로그 준비에 앞서, jekyll을 설치하기 위하여 루비 프로그램이 설치되어 있어야 하는데, 현재 데스크탑 운영체제가 윈도우이기 때문에 따로 윈도우용 루비 프로그램을 설치해야 한다.

하지만, 오랜만에 리눅스 운영체제를 접하고 싶어서 가상 운영체제를 사용하기로 했다.

대표적인 가상 머신 프로그램으로 Virtualbox와 Vmware가 있는데, Vmware가 상대적으로 오류가 덜 발생하면서 접근하기 쉬었다.
그렇게 가상 운영체제 Vmware 프로그램을 사용하면서 우분투를 설치하고 그 안에서 ruby를 설치하였다.

sudo apt-get install ruby ruby-dev build-essential

Jekyll 설치

루비를 설치하면 해당 명령어로 jekyll을 설치한다.

sudo gem install jekyll bundler

설치가 완료되면, jekyll new [name] 명령어를 입력하여 새프로젝트 생성을 확인 한 후, 해당 디렉토리로 이동하여 jekyll serve 명령어를 실행한다.

인터넷 브라우저에서 localhost:4000 으로 접속을 하게 되면 샘플용 페이지를 확인할 수 있다.

여기까지는 현재 자신의 로컬에서만 구축된 사이트를 확인 할 수 있다.

Gitgub repository 생성

모든 인터넷 사용자가 확인할 수 있는 깃허브 블로그에 사이트를 개설하기 위해서는 먼저 깃허브에서 repository를 생성한 후 테마 파일들을 저장해야 한다.
주의할 점은 현재 자신의 [username].github.io로 이름을 설정하여 생성한다.

그 후 우분투에서 git을 사용하여, 생성된 repository를 clone한다.

git clone https://github.com/[username]/[username].github.io

jekyll 테마 적용

jekyll new를 통해 간단한 블로그 테마를 확인해보았지만 보다 화려한 테마를 적용시키기 위하여 jekyllthemes사이트를 둘러보았다.
마음에 드는 테마를 다운로드하여 압축을 풀면 아래와 같이 많은 테마 구성파일이 보이는데, 이러한 파일들을 복사하여 깃허브에서 clone한 디렉토리 내에 붙여넣기 한다.

그 후, _config.yml 파일을 편집하여 블로그의 title, name, email 등을 수정하고 추가로 baseurl: "", url:"깃허브 주소"로 설정한다.

jekyll serve 를 통하여 현재 적용된 테마를 로컬호스트에서 확인해볼 수 있는데,

Traceback (most recent call last):
    5: from /home/fullstack/gems/bin/jekyll:23:in <main>'
    4: from /home/fullstack/gems/bin/jekyll:23:inload'
3: from /var/lib/gems/2.5.0/gems/jekyll-3.8.5/exe/jekyll:11:in <top (required)>'
    2: from /var/lib/gems/2.5.0/gems/jekyll-3.8.5/lib/jekyll/plugin_manager.rb:48:inrequire_from_bundler'
1: from /usr/lib/ruby/2.5.0/rubygems/core_ext/kernel_require.rb:59:in require'
/usr/lib/ruby/2.5.0/rubygems/core_ext/kernel_require.rb:59:inrequire': cannot load such file -- bundler (LoadError)

이러한 오류가 발생하게 된다면 Gemfile.lock 파일을 삭제하고 bundle install, jekyll serve 명령어를 실행하면 된다.

깃허브 업로드

깃허브 원격저장소에 파일을 push하기 전에, git config로 업로드할 주체를 설정한다.

git config --global --list

git config --global user.name "username"
git config --global user.email "useremail"

git add *
git status      //변경 내역 확인
git commit -m '커밋 메시지'
git push origin master

테마를 구현한 깃허브 블로그를 확인할 수 있다.

'기타 > 블로그' 카테고리의 다른 글

티스토리 블로그에 하이라이트 코드 적용하기  (0) 2019.10.25