๐™ถ๐š’๐š๐™ท๐šž๐š‹

1-2. github.io ํŽ˜์ด์ง€ ๋งŒ๋“ค๊ธฐ (Ruby, Jekyll ์„ค์น˜)

ํ•ด๋ฒ„๋‹ˆ 2023. 7. 19. 12:52
๋ฐ˜์‘ํ˜•

Github ๋ธ”๋กœ๊ทธ๋Š” Github Page, Jekyll(์ง€ํ‚ฌ), Ruby(๋ฃจ๋น„)๊ฐ€ ํ•„์ˆ˜์ด๋‹ค.

 

 

1. Jekyll ํ…Œ๋งˆ ๊ณ ๋ฅด๊ธฐ

http://jekyllthemes.org/

 

Jekyll Themes

 

jekyllthemes.org

์œ„ ํŽ˜์ด์ง€์— ๋“ค์–ด๊ฐ€ ๋งˆ์Œ์— ๋“œ๋Š” ํ…Œ๋งˆ๋ฅผ ๊ณ ๋ฅธ๋‹ค.

 

 

 

 

http://jekyllthemes.org/themes/agency/

 

Agency

This is the Agency Bootstrap theme converted to a gem-based Jekyll theme with GitHub Pages support. While this had been done before, (here, here, and here), these are outdated and have not been updated or maintained for years. I built this theme from the m

jekyllthemes.org

๋ณธ์ธ์ด ์›ํ•˜๋Š” ํ…Œ๋งˆ๋ฅผ ๊ณจ๋ผ์ค€๋‹ค.

ํ•„์ž๋Š” ์ด ํ…Œ๋งˆ๋กœ ๋‹ค์šด๋กœ๋“œ๋ฅผ ๋ฐ›์•˜๋‹ค. 

 

 

 

Jekyll์ด๋ž€?

์ง€ํ‚ฌ์€ ๊นƒํ—ˆ๋ธŒ ์„ค๋ฆฝ์ž ์ค‘์˜ ํ•œ ๋ช…์ด Ruby ์–ธ์–ด๋ฅผ ํ†ตํ•ด ๊ฐœ๋ฐœํ•œ ํ”„๋ ˆ์ž„์›Œํฌ์ด๋‹ค.

์ฆ‰, HTML/Markdown๋“ฑ์˜ ๋งˆํฌ์—… ์–ธ์–ด๋กœ ๊ธ€์„ ์ž‘์„ฑํ•˜๋ฉด ์ด๊ฒƒ์„ ๋ฏธ๋ฆฌ ์ •์˜ํ•ด๋†“์€ ๊ทœ์น™์— ๋”ฐ๋ผ ๋‹ค์–‘ํ•œ ๋ ˆ์ด์•„์›ƒ์œผ๋กœ ํฌ์žฅํ•˜์—ฌ ์ •์  ์›น์‚ฌ์ดํŠธ๋ฅผ ๋งŒ๋“ค์–ด์ค€๋‹ค.

๋˜ํ•œ ์ •์  ์‚ฌ์ดํŠธ ๋นŒ๋”์ด๋‹ค.(Static Website Builder)(์ •์  ์›น ํŽ˜์ด์ง€ ์ƒ์„ฑ๊ธฐ)

 

 

 

 

 

 

2. Ruby ์„ค์น˜

 

Ruby๋ž€?

-  ์Šคํฌ๋ฆฝํŠธ ์–ธ์–ด์˜ ์ผ์ข…์ด๋‹ค. 

์Šคํฌ๋ฆฝํŠธ ์–ธ์–ด๋ž€? ๊ธฐ์กด์— ์ด๋ฏธ ์กด์žฌํ•˜๋Š” ์†Œํ”„ํŠธ์›จ์–ด (์• ํ”Œ๋ฆฌ์ผ€์ด์…˜)์„ ์ œ์–ดํ•˜๊ธฐ ์œ„ํ•œ ์šฉ๋„๋กœ ์“ฐ์ด๋Š” ์–ธ์–ด.

์Šคํฌ๋ฆฝํŠธ ์–ธ์–ด์˜ ์˜ˆ : JavaScript, Python

 

- ์›์‹œ ์ž๋ฃŒํ˜•์ด ์กด์žฌํ•˜์ง€ ์•Š๊ณ  ๋ชจ๋“  ๊ฒƒ์ด ๊ฐ์ฒด์ธ ์ˆœ์ˆ˜ํ•œ ๊ฐ์ฒด์ง€ํ–ฅ ์–ธ์–ด์ด๋‹ค.

 

 

 

https://rubyinstaller.org/downloads/

 

Downloads

Which version to download? If you don’t know what version to install and you’re getting started with Ruby, we recommend that you use the Ruby+Devkit 3.2.X (x64) installer. It provides the biggest number of compatible gems and installs the MSYS2 Devkit

rubyinstaller.org

 

Ruby + Devkit 3.2.2-1 (*86) ์œผ๋กœ ๋‹ค์šด๋ฐ›์•„์•ผ ํ•œ๋‹ค. (2023๋…„)

 

 

 

 

ํ•„์ž๋Š”.. 2.7.9-1 (*64)๋กœ ์ž˜๋ชป ๋‹ค์šด ๋ฐ›์•˜๋”๋‹ˆ ๋ฐ‘๊ณผ ๊ฐ™์€ ์˜ค๋ฅ˜๊ฐ€ ๊ณ„์† ๋–ด๋‹ค.

์—ฌ๋Ÿฌ ํ•ด๊ฒฐ์ฑ…์„ ์จ๋ดค๋Š”๋ฐ ์œ„ ์˜ค๋ฅ˜๋Š” ํ•ด๊ฒฐ๋  ๊ธฐ๋ฏธ๊ฐ€ ๋ณด์ด์ง€ ์•Š์•˜๊ณ ,,

๊ฒฐ๊ตญ Ruby๋ฅผ ์ง€์› ๋‹ค๊ฐ€ ๋‹ค์‹œ ์„ค์น˜ํ–ˆ๋‹ค.

 

(ํ•˜๋ฃจ๊ฐ€...ํ›„๋”ฑ ๊ฐ€๋ฒ„๋ฆผ)

- ruby ์—…๋ฐ์ดํŠธ๋„ ํ•ด๋ณด๊ณ  (gem update --system)

- jekyll ์—…๋ฐ์ดํŠธ๋„ ํ•ด๋ณด๊ณ  (gem update jekyll)

- Sass ์ปดํŒŒ์ผ๋Ÿฌ ๋ฒ„์ „ ํ™•์ธ๋„ ํ•ด๋ณด๊ณ  (gem update sass)

- Sass ์ง€์› ๋‹ค๊ฐ€ ๋‹ค์‹œ ๊น”์•„๋„ ๋ณด๊ณ  (gem uninstall sass, gem install sass)

- ๋ชจ๋“ ๊ฑธ(?) ์ง€์› ๋‹ค๊ฐ€ ์žฌ์„ค์น˜๋„ ํ•ด๋ดค์ง€๋งŒ ๋ง์งฑ๋„๋ฃจ๋ฌต

(gem uninstall sass
gem uninstall sass-embedded
gem uninstall jekyll-sass-converter
gem uninstall jekyll
gem install sass
gem install jekyll-sass-converter
gem install jekyll)

 

 

 

 

 

 

 

๋ฒ„์ „ ํ™•์ธ์„ ์ž˜ํ•˜๊ณ  ๋ฃจ๋น„๋ฅผ ๋‹ค์šด๋ฐ›์•„์ค€๋‹ค.

(10 - 20๋ถ„ ๊ฑธ๋ฆฐ๋‹ค)

 

 

 

 

 

 

 

 

์œˆ๋„์šฐ์— ruby๋ฅผ ๊ฒ€์ƒ‰ํ•œ ํ›„ Start Command Prompt with Ruby๋ฅผ ์‹คํ–‰์‹œ์ผœ์ค€๋‹ค.

 

 

 

 

 

cd C:\Users\4ckdn\OneDrive\๋ฌธ์„œ\GitHub\haeburney.github.io

๋ณธ์ธ์˜ git Clone ๊ฒฝ๋กœ(ํด๋”)๋กœ ์ด๋™ํ•œ๋‹ค.

(์œˆ๋„์šฐ์—์„œ GitHub๊ฒ€์ƒ‰ํ•ด์„œ ๋œฌ ํด๋”๋กœ ๋‚˜์˜ github.io ํด๋”๋ฅผ ์ฐพ์•„๋ƒˆ๋‹ค.

 

 

 

 

 

์ด๋™ํ•œ ๋’ค, ์ธ์ฝ”๋”ฉ์„ ํ•œ๋‹ค.

chcp 65001

 

๋ช…๋ น์–ด ์ž…๋ ฅ ํ›„ Active code page:650001 ์ด๋ผ๋Š” ๊ธ€์ž๊ฐ€ ํ™•์ธ๋œ๋‹ค๋ฉด ์ •์ƒ์ด๋‹ค.

 

 

 

 

3. Jekyll ์„ค์น˜

gem install jekyll bundler
gem install webrick

gem install jekyll bundler ๋ช…๋ น์–ด ์ž…๋ ฅํ•˜๊ณ  ์ด๋Ÿฐ ํ™”๋ฉด์ด ๋ณด์ธ๋‹ค๋ฉด ์„ฑ๊ณต

๋‹ค ์„ค์น˜ํ•˜๋Š”๋ฐ 3~5๋ถ„์ด ๊ฑธ๋ ธ๋‹ค.

 

 

gem install webrick ๋ช…๋ น์–ด๋ฅผ ์ž…๋ ฅํ•˜๊ณ  ์ด๋Ÿฐ ํ™”๋ฉด์ด ๋ณด์ธ๋‹ค๋ฉด ์„ฑ๊ณต์ด ๋ช…๋ น์–ด๋Š” 5~10์ดˆ๋งŒ์—? ์„ค์น˜๊ฐ€ ์™„๋ฃŒ๋œ๋‹ค.

 

 

 

 

 

jekyll ์ƒ์„ฑ

jekyll new ./
-- ์ฒซ๋ฒˆ์งธ ๋ฌธ์žฅ์ด ์•ˆ ๋œ๋‹ค๋ฉด ์„ธ๋ฒˆ์งธ ๋ฌธ์žฅ์„ ์‹คํ–‰ํ•ด๋ณด์ž ( ํ˜„์ด ์–ธ๋‹ˆ๊ฐ€ ์•Œ๋ ค์คŒ ํ—ฟ โ™ก) 
jekyll new ./ -f

 

์„ค์น˜ ์„ฑ๊ณต 

 

 

 

 

 

 

bundle ์„ค์น˜

bundle install

 

 

 

 

 

jekyll ์„œ๋ฒ„ ๋™์ž‘

bundle exec jekyll serve
bundle exec jekyll serve --trace

-- 1๋ฒˆ ๋ฌธ์žฅ์ด ์•ˆ ๋œ๋‹ค๋ฉด 2๋ฒˆ ๋ฌธ์žฅ์„ ์จ๋ณด์ž.

 

 

 

 

http://127.0.0.1:4000/# 

์ฃผ์†Œ๋กœ ๋“ค์–ด๊ฐ”์„ ๋•Œ ๋ฐ‘๊ณผ ๊ฐ™์ด ๋ณด์ด๋ฉด ์—ฐ๋™ ์„ฑ๊ณต์ด๋‹ค! 

 

 

 

์—ฌ๊ธฐ๊นŒ์ง€ ๋์œผ๋ฉด ํ•œ ๋ฒˆ ์†Œ๋ฆฌ๋ฅผ ์งˆ๋Ÿฌ์ค๋‹ˆ๋‹ค

๊บ„ํ•˜~~~~~~

๋‹ค์Œ ๊ฒŒ์‹œ๋ฌผ์€ jekyll ํ…Œ๋งˆ๋ฅผ ์ ์šฉํ•ด๋ณด๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด์„œ ํฌ์ŠคํŒ…ํ•ด๋ณด๊ฒŸ์Šต๋‹ˆ๋‹ค

 

 

๋ฐ˜์‘ํ˜•