i3wm-themer 프로젝트 기여 가이드

i3wm-themer는 i3 윈도우 관리자를 위한 다양한 테마를 손쉽게 관리하고 전환할 수 있도록 돕는 유용한 도구입니다. 이 가이드는 i3wm-themer 프로젝트 개발에 참여하고, 직접 제작한 테마를 공유하여 오픈 소스 커뮤니티에 기여하는 방법을 안내합니다.

참여의 이점

i3wm-themer 프로젝트에 참여하는 것은 개인의 기술 역량을 강화하고 오픈 소스 커뮤니티에서 인정을 받을 수 있는 좋은 기회입니다. 코드 기여 또는 테마 제작을 통해 다음과 같은 이점을 얻을 수 있습니다:

• i3wm-themer의 기능 향상 및 안정성 강화에 기여합니다.
• 다른 i3wm 사용자 및 개발자와 교류하며 경험을 공유합니다.
• 자신만의 디자인 감각을 선보일 기회를 얻습니다.
• i3wm 생태계의 발전에 직접적으로 기여합니다.

개발 환경 설정

기여를 시작하기 전에 개발 환경을 준비해야 합니다. 다음 단계를 따르십시오:

1. i3wm-themer 저장소를 클론합니다:

   git clone https://gitcode.com/gh_mirrors/i3/i3wm-themer

2. 프로젝트 디렉토리로 이동합니다:

   cd i3wm-themer

3. 필요한 의존성을 설치합니다. 각 Linux 배포판에 맞는 설치 스크립트를 실행하십시오:
   • Arch Linux: ./install_arch.sh
   • Debian: ./install_debian.sh
   • Ubuntu: ./install_ubuntu.sh

코드 기여: 새 기능 개발 및 버그 수정

i3wm-themer에 새로운 기능을 추가하거나 버그를 수정하고자 하는 개발자는 다음 절차를 따를 수 있습니다.

프로젝트 구조 파악

i3wm-themer의 주요 코드베이스는 다음과 같은 디렉토리로 구성됩니다:

• i3wmthemer/: 핵심 로직을 포함하는 디렉토리
  • enumeration/: 열거형 정의
  • models/: 데이터 모델
  • utils/: 유틸리티 함수
• scripts/: 프로젝트 관련 스크립트
• tests/: 테스트 코드 모음

개발 절차

1. 새 기능 또는 버그 수정에 대한 브랜치를 생성합니다:

   git checkout -b feature/새로운-기능-이름

2. 코드 개발을 진행하며, 프로젝트의 코딩 표준을 준수합니다.
3. 작성한 코드가 정상적으로 동작하는지 확인하기 위해 tests/ 디렉토리에 테스트 케이스를 추가하거나 기존 테스트를 활용합니다.
4. 변경 사항을 커밋하고 Pull Request(PR)를 제출합니다.

테마 공유: 자신만의 테마 생성 및 제출

i3wm-themer의 핵심 기능 중 하나는 사용자가 직접 테마를 만들어 공유할 수 있다는 점입니다. 자신만의 개성 있는 테마를 제작하여 커뮤니티와 공유해 보세요.

테마 파일 구성

각 테마는 고유한 ID를 가지며, 두 개의 파일로 이루어집니다:

• JSON 파일 ([테마-ID].json): 테마의 색상 팔레트 및 설정 정보를 정의합니다.
• YAML 파일 ([테마-ID].yml): 테마의 메타데이터(이름, 저자, 설명 등)를 포함합니다.

테마 파일은 themes/ 디렉토리 내에 위치해야 합니다.

테마 생성 단계

1. 템플릿 파일을 복사하여 새로운 테마의 기본 구조를 만듭니다:

   cp templates/theme_template.json themes/[새로운-테마-ID].json

2. JSON 파일을 편집하여 테마의 색상과 설정을 구성합니다. 주요 설정 섹션은 다음과 같습니다:
   • xresources: X 리소스 색상 설정
   • i3wm: i3 윈도우 관리자 색상 설정
   • polybar: Polybar 상태바 설정
   • wallpaper: 사용할 배경화면 파일 이름
3. 해당 테마에 대한 YAML 파일을 생성하고, 테마의 이름, 저자, 간단한 설명 등의 메타데이터를 추가합니다.
4. 테마의 스크린샷을 찍어 themes/screenshots/ 디렉토리에 저장합니다. 스크린샷은 테마의 전체적인 시각적 효과를 명확히 보여주어야 합니다.
5. themes/README.md 파일을 업데이트하여 새로 추가된 테마 정보를 명시합니다.

테마 제출 기준

모든 테마의 품질과 일관성을 유지하기 위해 다음 기준을 따르십시오:

• 테마 이름은 간결하고 테마의 특징을 잘 나타내야 합니다.
• 색상 조합은 시각적으로 조화롭고 가독성이 높아야 합니다.
• 스크린샷은 테마의 전체적인 적용 모습을 명확히 보여줘야 하며, 최소 1360x641 해상도를 권장합니다.
• 다양한 화면 크기 및 해상도에서 테마가 정상적으로 표시되는지 확인합니다.

커뮤니티 소통 및 지원

기여 과정에서 궁금한 점이나 문제가 발생하면 다음 채널을 통해 도움을 요청하거나 의견을 공유할 수 있습니다:

• 프로젝트의 Issue 페이지에 질문을 게시합니다.
• 프로젝트 토론 포럼에 참여하여 다른 기여자들과 교류합니다.