al-folio 적용

github.io를 시작하며 일어난 오류 정리

1. al-folio clone

al-folio를 참고한다.

git clone https://github.com/alshedivat/al-folio

2. git repo 설정

설명에 나와있는대로 Settings -> Actions -> General -> Workflow permissions and give Read and write permissions to GitHub Actions. 을 적용해준다.

나중에 배포하는 과정에서 아래와 같은 에러가 발생할 수 있다.

Liquid Exception: Liquid syntax error (line 42): Unknown tag 'toc' in /_layouts/post.html

gh-pages라는 브랜치를 만들어 Settings -> Pages -> Build and deployment 에서 기본 브랜치를 gh-pages로 설정해준다.

3. customizing

나에게 맞게 _config.yml을 적용하고 publication, cv, teaching, profiles nav는 나에게 필요없었기 때문에 _pages/파일.md에서 nav를 false로 바꾸어 보이지 않게 설정하였다.

4. install

docker를 설치하고, 해당 폴더로 이동한 뒤 다음 명령어를 실행해준다.

docker compose pull
docker compose up

5. deploy

깃을 통해 레포에 푸시한 뒤 Action 탭에서 제대로 Deploy가 되는지 확인한다. 적용된 깃허브 블로그는 **여기에서 확인할 수 있다.