Skip to content
Hyeyoon Kang edited this page Feb 27, 2026 · 3 revisions

πŸš€ Run the Page Locally Using Jekyll

First, install Ruby by following the instructions here.

To run the site locally, you can follow the official Jekyll setup guide here,
or simply use the commands below:

sudo gem install jekyll
sudo gem install rouge
jekyll serve

Once started, open your browser and go to http://localhost:4000 to view the site.


πŸ”„ Update Workflow

1. Clone the Repository and Create a New Branch

git clone https://github.com/postechsv/postechsv.github.io
cd postechsv.github.io
git checkout -b yourname

2. Make Changes and Push

😊 ...make your awesome edits...

git add .
git commit -m "Awesome change"
git push origin yourname

3. Submit a Pull Request on GitHub

Open GitHub and create a Pull Request from your branch.
Once submitted, just wait for approval πŸ‘

image image

4. Clean Up After Merge

Once your PR is merged, you can delete your working branch locally and remotely:

git branch -D yourname
git push origin --delete yourname

Homepage Structure

πŸ“ _data

ν™ˆνŽ˜μ΄μ§€μ—μ„œ μ‚¬μš©ν•˜λŠ” λ‹€μ–‘ν•œ 데이터 νŒŒμΌλ“€μ„ μ €μž₯ν•©λ‹ˆλ‹€.

  • faculty.yml
    : ꡐ수의 인적 사항을 μ €μž₯.
  • news.yml (/news) : λ‰΄μŠ€ νŽ˜μ΄μ§€μ˜ λ‚΄μš©μ„ μ €μž₯. λ‚ μ§œμˆœμœΌλ‘œ μžλ™ 정렬됨. 메인 νŽ˜μ΄μ§€μ—λŠ” μ΅œμ‹  8개만 좜λ ₯.
  • publist.yml (/publications) : 좜판 λ…Όλ¬Έ 리슀트. 연도 및 파일 λ‚΄ μž‘μ„± μˆœμ„œμ— 따라 정렬됨.
  • students.yml
    : ν•™μƒμ˜ 인적 사항 μ €μž₯ 및 LinkedIn, GitHub, ν™ˆνŽ˜μ΄μ§€ μ•„μ΄μ½˜ 유무.

πŸ“ _home (/)

메인 νŽ˜μ΄μ§€μ— λ“€μ–΄κ°ˆ μ„Ήμ…˜λ³„ λ‚΄μš©μ„ μ •μ˜ν•©λ‹ˆλ‹€.
각 μ„Ήμ…˜μ€ [XX-XXXX.md] ν˜•μ‹μ˜ Markdown 파일둜 κ΅¬μ„±λ©λ‹ˆλ‹€.

  • 01-about.md
  • 02-news.md
  • … (μΆ”κ°€ μ„Ήμ…˜ μž‘μ„± κ°€λŠ₯)

πŸ“ _pages

각 νƒ­ νŽ˜μ΄μ§€μ˜ λ ˆμ΄μ•„μ›ƒκ³Ό permalinkλ₯Ό μ •μ˜ν•˜λŠ” Markdown νŒŒμΌλ“€μ„ μ €μž₯ν•©λ‹ˆλ‹€.

  • members.md (/members)
  • news.md (/news)
  • publications.md (/publications)
  • research.md (/research)
  • research-topics.md (/research/topics)

πŸ“ _research (/research)

λ¦¬μ„œμΉ˜ νŽ˜μ΄μ§€ κ΅¬μ„±μš© 디렉토리. _homeκ³Ό λ™μΌν•œ λ°©μ‹μœΌλ‘œ Markdown νŒŒμΌμ„ κ΅¬μ„±ν•©λ‹ˆλ‹€.

  • 01-introduce.md
  • 02-research-topics.md
  • 03-video.md

πŸ“ _researchtopics (/research/*)

λ¦¬μ„œμΉ˜ νŽ˜μ΄μ§€ λ‚΄ research-topics μ„Ήμ…˜μ— 포함될 κ°œλ³„ 연ꡬ 주제 ν•­λͺ©μ„ μ €μž₯ν•©λ‹ˆλ‹€.
μƒˆλ‘œμš΄ λ¬Έμ„œλ₯Ό μž‘μ„±ν•˜κ³  싢은 경우 00-SAMPLE.md νŒŒμΌμ„ λ³΅μ‚¬ν•˜μ—¬ μ‚¬μš©ν•©λ‹ˆλ‹€.
파일λͺ…은 XX-name.md ν˜•μ‹(숫자 접두사 + ν•˜μ΄ν”ˆ)을 μ‚¬μš©ν•©λ‹ˆλ‹€.

  • 00-SAMPLE.md
  • ... (기타 연ꡬ 주제 파일)