Forgejo 커스텀 테마와 한국어 번역

deploy/                           # Forgejo CustomPath에 복사할 내용
  options/locale/locale_ko-KR.ini # 패치를 적용한 전체 번역 (생성 파일)
  public/assets/css/              # 직접 수정하는 커스텀 테마
  public/assets/fonts/            # 테마에서 사용하는 폰트
  templates/custom/               # 커스텀 CSS를 불러오는 템플릿
upstream/                         # 원본 및 참조 파일 보관
  options/locale/locale_ko-KR.ini # 설치 버전에 맞는 원본 번역
  public/assets/css/              # 기존 CSS 백업 보관
patches/locale_ko-KR.ini          # 유지할 한국어 번역 수정 항목
scripts/build_locale.py           # 원본에 번역 패치를 적용하는 도구
preview/index.html               # 현재 테마의 통합 미리보기
preview/heatmap.html             # 실제 Forgejo 히트맵 샘플
LOCALE.md                         # 번역 패치 상세 안내

수정 및 생성

테마는 deploy/public/assets/css/custom-theme-forgejo-auto.css를 직접 수정합니다. 번역은 patches/locale_ko-KR.ini를 수정한 뒤 프로젝트 루트에서 실행합니다.

python scripts/build_locale.py

Python 3이 필요하며 추가 패키지는 없습니다. 생성된 번역 파일을 직접 수정하면 다음 생성 때 덮어쓰므로 번역 수정은 패치에 기록하세요. deploy/의 CSS, 폰트, 템플릿은 생성 도구가 변경하지 않습니다.

테마 미리보기

프로젝트 루트에서 다음 명령을 실행하고 http://127.0.0.1:8000/preview/를 엽니다.

python -m http.server 8000 --bind 127.0.0.1

미리보기는 참조용 Forgejo CSS와 현재 배포용 CSS를 직접 불러옵니다. 라이트·다크 모드, 강조색 15단계, 알파 단계, 버튼·링크 상태, 히트맵을 확인할 수 있습니다. CSS를 수정한 뒤 CSS 새로 읽기를 누르면 반영됩니다. 히트맵 샘플은 preview/heatmap.html 한 곳에서 관리합니다. 파일을 직접 여는 대신 로컬 서버를 사용해야 샘플 로딩과 모드 전환이 동작합니다.

팔레트는 저단계의 밝기·채도를 억제하면서 자주색에서 분홍색으로 색상각이 자연스럽게 이어지도록 설계했습니다. 범용 강조색은 밝은 쪽에서 따뜻한 분홍색으로 이어지고, 히트맵은 각 모드에서 기본 강조색의 한쪽 범위만 사용합니다. 알파 단계는 기본 강조색을 그대로 사용하며 불투명도만 달라집니다.

정리한 과거 비교안은 preview/archive/에 로컬 ZIP 백업으로 보관하며 Git에서는 제외합니다. preview/는 검토용이므로 서버 배포 대상에 포함하지 않습니다.

배포

deploy/ 안의 options/, public/, templates/를 Forgejo의 실제 CustomPath에 병합 복사합니다. deploy 폴더 자체를 복사하는 것이 아닙니다.

deploy/options/   → <CustomPath>/options/
deploy/public/    → <CustomPath>/public/
deploy/templates/ → <CustomPath>/templates/

서버의 기존 conf/ 등 다른 파일은 유지하세요. 배포 후 Forgejo를 재시작합니다. upstream/, patches/, scripts/와 안내 문서는 배포하지 않습니다.

Forgejo 업데이트

새 버전에 맞는 원본 번역으로 upstream/options/locale/locale_ko-KR.ini를 교체하고, 생성 명령을 다시 실행한 뒤 배포합니다. 기존 수정 항목은 patches/에 남습니다. 자세한 방법은 한국어 번역 패치 안내를 참고하세요.

Test Sample

for diff test
- 기존 내용
+ 수정한 내용