본 웹사이트는 올해로 20주년을 맞이하는 우분투한국커뮤니티의 연례 가장 큰 행사인 UbuCon Korea 2025 개최를 위해 제작된 웹사이트로, UbuCon Asia의 웹사이트 템플릿을 기반으로 하고 있습니다.
우분투 디자인 가이드에 따라 색상과 글꼴을 적용하고 있으며, 원활한 구현을 위해 Vanilla Framework를 사용합니다.
- 한글 글꼴의 원활한 표시를 위해 2023년부터 Pretendard Variable을 웹 글꼴로 함께 사용하여, Ubuntu 가변 글꼴의 대체 글꼴로 지정하고 있습니다.
- Marked 라이브러리를 이용하여 후원사 소개 영역에서 마크다운 문법을 지원하고 있습니다.
- Indico API를 기반으로 자체 시간표 페이지를 제공하고 있습니다.
- 우분투한국커뮤니티 Discourse가 존재함에 따라, 최근 소식을 Discourse에서 불러오도록 설정되어 있습니다.
- 조직위원회, 최근 소식 등 일부 UI를 다르게 변경하여 적용 중에 있습니다.
여기에 기재되지 않은 자잘한 변경사항도 포함되어 있습니다.
본 프로젝트는 Astro 프레임워크를 사용하고 있으며, 패키지 매니저로 npm을 사용하고 있습니다.
원활한 실시간 변경사항 반영을 위해 가급적 WSL 환경보다는 Ubuntu 등 리눅스 환경과 macOS에서 테스트하시는 것을 추천드립니다.
- 먼저 본 저장소를 작업할 계정에 fork합니다.
- fork한 저장소를
git clone하여 개인 기기에 내려받습니다. npm i명령어로 필요한 패키지를 설치하신 후, 원하시는 IDE 또는 에디터를 열어 수정할 수 있습니다.- 개발 서버를 사용하실 때에는
npm run dev명령어를 이용해주세요. - PR을 열어 변경을 요청하실 수 있습니다.
- 본 페이지의 다국어화를 위해 사용 중인 Paraglide에서 Sherlock 플러그인 설치를 권장하고 있으나, 해당 플러그인의 버그로 작업 중 문자열이 소실되는 문제가 있어 설치하지 않거나 커밋 시 각별히 주의하실 것을 권장드립니다.
- 후원사 소개 데이터가 담긴
/data/sponsors.ts에서 일부 항목은 정상적인 줄바꿈과 문법 적용을 위해 들여쓰기가 독특한 형태로 되어 있습니다. 해당 부분을 수정할 경우 코드 블럭 등의 예기치 못한 방식으로 표현될 수 있으므로 수정 후 개발 서버로 구동되는 웹페이지에서 결과를 반드시 확인해주세요. - Paraglide의 업그레이드는 현재 Astro에 대해 SSG(정적 사이트 생성) 모드를 제공하지 않고 있어 부득이하게 현 시점에서는 구버전을 사용하고 있습니다.
- 일주일 이상 전에 동기화하신 경우에는, 충돌 최소화를 위해 가급적 원본 소스와의 동기화 후 작업하시기를 권장드립니다.
ubuntu-kr/2025.ubuntu-kr.org 저장소의 이슈 트래커, Discord/Matrix의 ubucon-kr 채널, [email protected] 이메일로 어려움을 겪고 계신 점을 말씀주시면 확인하여 담당자가 수정할 수 있도록 하겠습니다.