MouseBall54’s ToolBox 블로그 운영 규정

1. 프로젝트 개요

규칙 1: 모든 포스트는 반드시 한국어와 영어 버전을 함께 작성해야 합니다.
- 한국어 파일: _posts/YYYY-MM-DD-post-title-ko.md
- 영어 파일: _posts/YYYY-MM-DD-post-title-en.md
- 두 파일은 동일한 날짜와 기본 title을 공유해야 하며, 내용은 각 언어에 맞게 자연스럽게 번역 및 현지화되어야 합니다.
규칙 2: AI가 작성한 느낌이 나지 않도록 자연스럽고 가독성 높은 글을 작성해야 합니다.
- 지침: 딱딱한 번역 투나 기계적인 문체를 피하고, 실제 사람이 쓴 것처럼 부드러운 어조를 사용합니다. 최신 트렌드와 유행하는 표현을 적절히 사용하여 독자의 흥미를 유발합니다.
규칙 3: 모든 포스트는 명확한 구조를 따라야 합니다.
- 구조:
  1. 도구 소개: 어떤 문제를 해결하는 도구인지 명확히 설명합니다.
  2. 주요 기능: 핵심 기능을 목록이나 소제목으로 나누어 상세히 설명합니다.
  3. 사용 방법: 사용자가 쉽게 따라 할 수 있도록 단계별 가이드를 제공합니다. (코드 예제, 스크린샷 포함)
  4. 활용 예시: 실제 사용 사례를 보여주어 활용도를 높입니다.
  5. 결론 및 요약: 내용을 정리하고 독자에게 행동을 유도합니다. (예: “지금 바로 사용해보세요!”)

규칙 4: 모든 포스트는 구글 및 네이버 검색에 최적화되어야 합니다.
- 제목(Title): 핵심 키워드를 포함하여 명확하고 매력적으로 작성합니다. (예: “이미지 라벨링 시간을 획기적으로 줄여주는 Easy Labeling 사용법”)
- 메타 설명(Description): 포스트 내용을 150자 내외로 요약하고, 핵심 키워드를 포함합니다.
- 키워드(Keywords/Tags): 관련성 높은 키워드를 5개 이상 tags로 추가합니다. (예: yolo, pytorch, image-labeling, deep-learning)
- URL: permalink는 포스트 내용과 관련 있는 영어 단어로 구성합니다.
규칙 5: 이미지에는 항상 alt 태그를 추가하여 검색 엔진이 이해할 수 있도록 합니다.
- 예시: ![Easy Labeling 실행 화면](/assets/images/easy-labeling-screenshot.png){: .align-center}

규칙 6: 블로그 디자인은 항상 세련되고 현대적인 스타일을 유지해야 합니다.
- 주요 수정 파일:
  - _sass/minimal-mistakes/_variables.scss: 폰트, 색상 등 전역 스타일 변수.
  - assets/css/main.scss: 커스텀 CSS 추가.
  - _layouts/: 페이지 구조 변경.
  - _includes/: 헤더, 푸터 등 재사용 컴포넌트.
- 지침: 디자인 변경 시, 기존 minimal-mistakes 테마의 구조를 최대한 존중하면서 필요한 부분만 커스터마이징합니다.
규칙 7: 네비게이션 메뉴는 사용자가 쉽게 도구를 찾을 수 있도록 직관적으로 구성해야 합니다.
- 수정 파일: _data/navigation.yml
- 지침: 새로운 도구 소개 페이지가 추가되면, 해당 페이지로 연결되는 링크를 네비게이션에 추가합니다.

규칙 8: 블로그에서 소개하는 모든 도구는 외부에서 접근 가능한 URL을 통해 제공되어야 합니다.
- 지침: GitHub Pages, Heroku 등 정적/동적 호스팅 서비스를 활용하여 도구를 배포하고, 블로그 포스트에는 해당 도구로 바로 연결되는 링크를 포함해야 합니다.
규칙 9: 도구 소개 포스트는 사용자가 도구를 사용해보고 싶게 만들어야 합니다.
- 지침: 도구의 장점과 차별점을 명확히 부각하고, 실제 사용 화면을 담은 이미지나 GIF를 적극적으로 활용하여 이해를 돕습니다.

규칙 10: 파일 및 디렉토리 구조는 Jekyll 표준을 엄격히 준수합니다.
- _posts: 블로그 포스트 (날짜-제목.md 형식)
- _pages: 정적 페이지 (About, Contact 등)
- assets: CSS, JS, 이미지 등 리소스
- images: 포스트 본문에 삽입되는 이미지 (포스트별 디렉토리 생성 권장)
규칙 11: 모든 작업은 논리적 단위로 커밋하며, 커밋 메시지는 명확하게 작성합니다.
- 커밋 메시지 형식: feat: Easy Labeling 기능 소개 포스트 추가 (한/영)
- 지침: feat, fix, docs, style, refactor, chore 등의 접두사를 사용하여 커밋 목적을 명확히 합니다.
규칙 12: GEMINI.md 파일에 모든 작업 내역을 기록하여 추적 가능하도록 합니다.
- 지침: 날짜와 함께 수행한 작업 내용을 간결하게 요약하여 기록합니다.

절대 금지:
- 한국어 또는 영어 버전 중 하나만 작성하고 다른 버전을 누락하는 행위.
- SEO 기본 원칙(제목, 설명, 키워드)을 지키지 않는 행위.
- GEMINI.md 파일에 작업 내역을 기록하지 않는 행위.
- 최종 사용자에게 혼란을 줄 수 있는 미완성된 포스트나 기능을 배포하는 행위.