깃허브 데스크탑 이용해서 커밋하기

1. 처음에 레포지토리 선택할 때 정보를 저장할 폴더 경로를 선택한다

2. 나의 경우에는 "C:/Users/HANJAESU/github_desktop/study-blog" 이다

3. study-blog 폴더에 가보면 _notebooks 폴더가 있는데 거기서 작업한 주피터 노트북 파일은 깃허브 데스크탑 changes에 표시된다

4. 커밋할 파일 하나를 클릭하고 하단에 메시지를 같이 남긴다

5. 변동 내역 메시지를 작성하고 커밋을 했으면 마지막으로 푸쉬를 한다

6. 깃허브에 변동 내역이 저장된다

- 아무 것도 변경하지 않고 save만 해도 깃허브 데스크탑 changes에서 감지된다

- 아무 것도 변경하지 않았는데 커밋이 된다는 의미 ---> 아무짝에도 쓸모 없다 ---> 이런 경우에는 커밋을 하지 말고 냅두자

- 파일이 제대로 푸쉬가 안됐다면? ---> 깃허브 _notebook 파일에 있는 history를 보자

- 만약 빨간색으로 $\times$표시가 되어있다면 클릭 ---> error메시지를 볼 수 있음 ---> 이를 보고 오류 수정 하면 됨

작업 공간

- 이제부터 작업은 나의 깃허브 레포지토리(study-blog) 저장 폴더인 study-blog에 있는 _notebooks에서 해야 한다

- 만약 "C:/Users/HANJAESU/github_desktop/study-blog/_notebooks" 에서 작업하지 않으면 깃허브 데스크탑 changes에 기록되지 않는다

Liquid Exception: Liquid syntax error 해결

- Jekyll에서 사용되는 liquid는 {{ 와 }}를 escape 문자로 사용 ---> 마크다운에 {{ 과 }}이 있으면 커밋이 error가 나고 {{ 과 }} 사이에 있는 내용은 무시됨

- 해결 방법 ---> 여는 중괄호 앞에 {% raw %}를 닫는 중괄호 뒤에 {% endraw %}를 추가함

- 참고: Liquid syntax error 해결

- 참고: How to escape liquid template tags

Latex math alignment not working

- Liquid syntax error를 예상하고 {% raw %}와 {% endraw %}를 사용했는데 오류가 발생했음

- Liquid Exception: Liquid syntax error (line 732): Unknown tag 'endraw'

- 뭐가 문제인지 삽질하다가 {% raw %}와 {% endraw %}를 모두 없앴는데 오류가 해결됨

- 교훈 : 미리 사용하지 말고 오류가 발생하면 사용하자

- 그런데 또 다른 문제가 생겼다 ---> 블로그에 수식이 랜더링되지 않음

- 수식을 등호를 기준으로 정렬하려고 \begin{align} ~ \end{align} 을 사용했는데 이게 문제를 일으킴

- 찾아보니 align 대신 aligned를 사용하면 된다고 한다

- ref : https://github.com/fastai/fastpages/issues/439

YAML Exception: found character that cannot start any token

- YAML에서 @와 같은 특정 문자를 사용할 때 에러가 발생할 수 있음

- 나의 경우 데코레이터를 설명하고자 title에 @를 사용했는데 에러가 발생했다

- @이 포함된 문장을 따옴표로 감싸주니 에러가 사라졌다

깃허브 서버 오류 확인

- 깃허브 데스크탑으로 커밋을 하려는데 오류가 발생했음

- 왜 그런가 찾아보니 내 문제가 아니라 서버 문제였다

- 갑자기 오류가 생겼는데 내 문제가 아닌 것 같으면 서버 상태를 확인해보자

- site: 깃허브 서버 오류 확인