옛 사이트는 2023년에 멈췄습니다

제 개인 사이트의 마지막 콘텐츠 업데이트는 2023년 10월 23일이었습니다. 다음 날 푸시한 뒤, 그 사이트는 3년 동안 인터넷 한쪽 구석에서 먼지를 뒤집어쓰고 있었습니다.

다시 들여다보는 일은 고고학에 가까웠습니다. Hexo 6.3.0, 강의 노트 네 편, JPEG 표지 아홉 장, Bulma + jQuery + Fancybox, 약 25 MB의 저장소. About 페이지는 여전히 저를 “junior undergraduate”라고 소개했고, CV는 2023년 버전이었으며, 내비게이션에는 오타가 있었습니다 — “Intership-Experience”. 마치 오랜 친구를 만났는데 이름을 잘못 불러 맞이하는 기분이었습니다.

솔직히 말하면 그건 제 첫 개인 사이트 시도였습니다. 엔지니어링은 미숙했고 디자인도 아직 자리를 잡아가는 중이었습니다. 하지만 일부는 웃픈 이야기로 끝나지 않았습니다. 모바일에서 확대가 비활성화되어 있어 글자를 키우려면 보물지도라도 보듯 화면에 얼굴을 가까이 대야 했고, 분석 스크립트는 주석 처리되었지만 구조는 그대로 남아 있었으며, 무언가를 바꾸고 싶을 때마다 2023년의 제 정신 상태로 돌아가야 했습니다. 아무도 관리하지 않는 사이트는 서서히 시대에 뒤떨어진 자기소개가 됩니다.

더 가벼운 기반

새 사이트는 Astro 7로 구축되어 정적 출력으로 배포됩니다. Markdown과 콘텐츠 컬렉션이 콘텐츠를 담당하며, 프로젝트, 논문, 블로그 글을 위한 컬렉션이 각각 분리되어 있습니다. 스타일은 직접 작성한 디자인 토큰이고, 모든 폰트는 자체 호스팅되며(Google Fonts 없음), RSS, 사이트맵, 404 페이지는 빌드에서 생성됩니다. 배포는 GitHub Actions를 거쳐 GitHub Pages로 이루어집니다.

시각적 방향도 바뀌었습니다. 따뜻한 아카이브 종이, 거의 검정에 가까운 잉크, 약간의 번트 오렌지; 제목에는 Newsreader, 본문에는 Public Sans, 라벨에는 IBM Plex Mono; Firefox에서는 단색 표면으로 대체되는 3중 유리 내비게이션. 1.78초짜리 “QL signal lock” 인트로가 있습니다 — 새로고침할 때 재생되고, 페이지를 이동할 때는 재생되지 않습니다. 아무 정보도 담고 있지 않습니다. 그저 이 사이트를 진지하게 다루고 있다고 말할 뿐입니다.

영어가 원본입니다. 중국어 간체와 일본어는 빌드 시 생성되며, 번역된 모든 문자열은 저장소에 캐시되므로 CI에 API 키가 필요하지 않습니다. 세 개의 정적 사이트, 각각 자체 RSS 피드를 가집니다.

로컬 DeepSeek에게 일을 맡기기

이번 재구축에서 실행의 대부분은 제가 한 줄씩 직접 타이핑한 것이 아니었습니다. 모델은 에어갭된 Mac mini(M 시리즈 칩, 조용히 웅웅거리는)에서 로컬로 실행되며, DeepSeek Harness를 통해 실제로 일을 할 수 있는 에이전트에 연결됩니다. 저장소 문서를 읽고, 파일을 편집하고, npm run check와 빌드를 실행하고, Playwright를 구동해 세 브라우저에서 스크린샷을 찍고 클릭하며, axe를 실행해 접근성을 점검하고, 결과를 제게 건네줍니다.

제 역할은 편집과 승인에 더 가까웠습니다. 이 콘텐츠가 사실인지, 날짜와 역할이 맞는지, 이 디자인을 유지할지, 이 변경을 푸시할 수 있는지. 모델은 반복적인 점검(회귀 테스트에서 90개의 페이지, 뷰포트, 브라우저 조합 같은)을 끝내는 데 능하고, 제가 문제를 설명하면 작동하는 패치를 만들어냅니다. 하지만 제 경험 중 어느 부분이 진짜인지는 알지 못하므로, 사실에 관한 모든 것은 제 서명을 거칩니다.

실질적인 이점은 지속 가능성입니다. 예전에는 사이트를 바꾸려면 환경을 다시 구축하고 옛 명령을 파헤쳐야 했습니다. 이제는 규칙이 문서에 있고 에이전트가 그것을 따릅니다. 점검을 실행하고, 실패한 것을 고치고, 제 승인을 기다립니다. 게으름을 피우지 않고, 커피도 필요로 하지 않습니다 — 다만 그것이 커피를 마시는지는 잘 모르겠습니다.

몇 가지 구체적인 함정

  • 세 언어는 세 개의 페이지가 아니라 세 개의 정적 문서입니다. 언어를 전환하면 전체 페이지가 다시 로드되므로 브라우저가 맨 위로 돌아갑니다. 스크롤 위치를 기록하는 작은 스크립트로 이 문제를 해결했습니다. 이제 언어를 전환해도 실제로 보던 위치가 유지됩니다.
  • 번역에는 캐시가 필요합니다. 영어 원문이 바뀌면 새 문자열만 번역에 보내고 나머지는 재사용합니다. CI는 오프라인 캐시에서 다시 빌드하며 문자열이 누락되면 실패합니다. 페이지에서 빈틈을 발견하는 것보다 훨씬 낫습니다.
  • 접근성은 기능으로 다루어야 합니다. 예전 사이트에서 user-scalable=no를 제거한 것은 시작에 불과했습니다. 포커스 스타일, 건너뛰기 링크, aria-current, 대비, 모션 감소 설정이 모두 회귀 검사에 포함되어야 합니다.
  • 블로그에는 분류가 필요합니다. 3년간의 강의 노트 끝에 블로그에 life, course, project 분류와 키워드 검색을 추가했습니다. 검색은 렌더링된 텍스트를 읽으므로 중국어 페이지는 중국어로, 일본어 페이지는 일본어로 검색합니다.

현재

사이트가 다시 운영 중입니다. 2023년 강의 노트 네 편은 “Course notes”로 표시된 채 그대로 있으며, 공개 프로젝트, 논문, 경력은 제 CV와 대조해 확인했습니다. 예전 사이트의 이미지와 2023년 PDF는 여전히 저장소 루트에 있습니다. 개인 사이트에 대한 첫 시도였고 기술적으로 미숙했지만 버리기 아까운 자료입니다.

3년 된 사이트를 되살리는 비용은 예상보다 적었습니다. 요령은 변경 방법, 검증 방법, 배포 허용 시점을 문서로 남기고, 지치지 않는 실행자가 그 규칙을 따르게 하는 것입니다. 판단은 여전히 제 몫입니다.