저장소 구조 인덱스
저장소 구조 인덱스
한 줄 요약
띵스플로우 기술 블로그를 GitHub Pages로 배포하는 Jekyll 정적 사이트다 (_config.yml, CNAME, 2026-09-19 읽음).
스택
- 콘텐츠·템플릿: Markdown, HTML, Liquid, YAML (
_posts/,_layouts/,_includes/,_config.yml, 2026-09-19 읽음). - 런타임·생성기: Ruby 기반 Jekyll 3.9.0과
github-pages223 (docs/Gemfile.lock, 2026-09-19 읽음). - 플러그인:
jekyll-paginate,jekyll-sitemap,jekyll-gist,jekyll-feed,jekyll-include-cache(_config.yml, 2026-09-19 읽음). - 패키지 관리자: Bundler (
docs/Gemfile,docs/Gemfile.lock, 2026-09-19 읽음).
기본 브랜치와 배포
- 기본 브랜치는
master다 (gh api repos/thingsflow/techblog.thingsflow.com, 2026-09-19 조회). .github/workflows/의 YAML 워크플로는 0개이며 최근 Actions 실행도 0건이다(트리 및gh run list --limit 20, 2026-09-19 조회).- GitHub Pages는
master의/를 소스로 쓰고https://techblog.thingsflow.com/에 배포된다. 사용자 정의 도메인은techblog.thingsflow.com, HTTPS 강제는 활성이다(Settings > Pages, 2026-09-19 조회 및 재확인).
디렉터리
_authors/— 추적 파일 20개, 작성자 프로필을 소유한다._data/— 추적 파일 2개, 탐색 메뉴와 UI 문구를 소유한다._includes/— 추적 파일 54개, Liquid 조각과 외부 기능 provider를 소유한다._layouts/— 추적 파일 14개, 페이지·목록·게시글 레이아웃을 소유한다._pages/— 추적 파일 6개, 404와 archive 등 고정 페이지를 소유한다._posts/— 추적 파일 25개, 게시글을 소유한다._sass/— 추적 파일 70개, Minimal Mistakes SCSS를 소유한다.assets/— 추적 파일 156개, CSS·JavaScript·이미지·작성자 자산을 소유한다.docs/— 추적 파일 663개, 테마 문서와 예제 사이트를 보존한다.test/— 추적 파일 184개, 테마 테스트 fixture를 보존한다.
이 저장소의 문서는 어디에 있나
docs/는 Minimal Mistakes 테마 문서와 예제 사이트의 원본을 유지한다. 이 INDEX는 원문을 옮기지 않고 진입점을 연결한다.
| 찾는 것 | 가는 곳 |
|---|---|
| 테마 빠른 시작 | docs/_docs/01-quick-start-guide.md |
| 테마 구조 | docs/_docs/02-structure.md |
| 테마 기여 안내 | docs/_docs/19-contributing.md |
진입점
- 사이트 홈 진입점은
index.html이며layout: home을 사용한다(2026-09-19 읽음). - 의존성 설치는
cd docs && bundle install로 확인된다 (README.md,docs/Gemfile, 2026-09-19 읽음). - 로컬 실행은 저장소 루트에서
jekyll serve로 기록돼 있고 기본 확인 주소는http://127.0.0.1:4000/이다(기존README.md, 2026-09-19 읽음). - 별도 자동 테스트 명령은 현재 문서와 워크플로에서 확인되지 않았다
(미확인).
내부 설계
Jekyll은 _config.yml에서 collection, include 경로, permalink, 플러그인을 읽고 index.html, _pages/, _posts/의 front matter를 _layouts/와 _includes/로 렌더링한다. _data/와 _authors/가 탐색·작성자 메타데이터를 공급하고 _sass/와 assets/가 표현 자산을 제공한다. 결과 사이트는 CNAME과 GitHub Pages 설정의 사용자 정의 도메인으로 공개된다(각 경로 및 Settings > Pages, 2026-09-19 확인).
다른 저장소와 어떻게 이어지나
확인된 사내 저장소 관계 없음 (워크플로·매니페스트·서브모듈·호스트 호출, 2026-09-19 조회)
규약(실측)
- 원격 브랜치 3개 중 접두사 없음 2개(
master,post),feature/1개다 (git for-each-ref refs/remotes/origin, 2026-09-19 조회). - 최근 커밋 100개는
Merge20개,fix15개,docs8개,update9개, 이모지 접두사 9개, 기타 39개다 (git log -100 --format=%s, 2026-09-19 조회). .github/PULL_REQUEST_TEMPLATE.md가 있고 이슈 템플릿 4개가 있으며 CODEOWNERS는 없다 (.github/트리, 2026-09-19 조회).- Actions는 모든 action과 reusable workflow를 허용하고 기본
GITHUB_TOKEN읽기·쓰기를 허용한다. SHA 고정 요구는 비활성이다(Settings > Actions, 2026-09-19 조회 및 재확인).
PR 흐름(실측)
- 머지된 PR 표본은 전체 27건이며 base는
master27건이다 (gh pr list --state merged --limit 30, 2026-09-19 조회). - base←head는
master←post15건,master←master3건, 나머지 9개 head가 각각 1건이다. 나머지는about-storyplay-web,feature/logo,jj,min/react-csr-deploy-strategy,post_admin_page,post_chaeeun.seol,post_yonggi.son,serim,seyoung이다(같은 조회). - 리뷰 수는 0건인 PR 25개, 1건인 PR 2개이며 승인 리뷰가 있는 PR은 2개다(같은 조회).
- merge commit, squash merge, rebase merge가 모두 허용된다 (
gh api repos/thingsflow/techblog.thingsflow.com, 2026-09-19 조회). master브랜치 보호 API는 404여서 보호 없음으로 확정했고 ruleset은 0개다. 필수 검사는 0개, 필수 승인자 수는null이다(브랜치 보호·ruleset API, 2026-09-19 조회).
흡수한 문서
- 기존
README.md에서 사이트 목적, 로컬 실행, 작성자 등록, 게시글 경로와 PR 흐름을 흡수했다. 원문은structure/legacy-readme.md에 그대로 보존한다(2026-09-19 읽음). .github/CONTRIBUTING.md와.github/PULL_REQUEST_TEMPLATE.md의 브랜치·PR 안내를 작업 규칙의 근거로 연결했다(2026-09-19 읽음).- 별도
DESIGN.md,ARCHITECTURE.md, 폴더별 README는 0개다 (find, 2026-09-19 조회).
이관 기록
- 이관 5건: 사이트 주소, Ruby 참고 링크, 설치·실행 명령, 작성자 등록 경로, 게시글 작성 경로와 형식.
- legacy 보존 2건: 원격 저장소를 직접 pull하는 준비 절차,
post브랜치 직접 push 지시. 현재 실측 정보와 함께 판단할 수 있도록 원문에만 유지한다.
근거
- 로컬 경로:
README.md,_config.yml,CNAME,index.html,_data/navigation.yml,docs/Gemfile,docs/Gemfile.lock,.github/전체를 2026-09-19에 읽었다. - 구조 측정:
python3 /Users/jun/Developer/newa/_gov/ax-native/measure.py /Users/jun/Developer/newa/repos/techblog.thingsflow.com및git ls-files기반 디렉터리별 계수(2026-09-19 실행). - GitHub 조회: 저장소 API, branch protection API, rulesets API,
gh pr list,gh run list를 2026-09-19에 실행했다. - 설정 화면:
https://github.com/thingsflow/techblog.thingsflow.com/settings/actions와https://github.com/thingsflow/techblog.thingsflow.com/settings/pages를 로그인된 읽기 전용 브라우저로 열고 다시 열어 확인했다(2026-09-19). - 기존 추적 파일에서 파일명·토큰·Authorization 헤더·개인키 표식 기반 시크릿 경로를 검사했으며 발견 0건이다. 값은 출력하지 않았다(2026-09-19).