본문 바로가기

좋아하는 것_매직IT/96.IT 핫이슈

Git-Story : 커밋 히스토리를 애니메이션으로 만들어 설명하기

반응형

Git-Story : 커밋 히스토리를 애니메이션으로 만들어 설명하기를 소개합니다.

 

github에서는 아래와 같이 소개하고 있고요..
git-story
   - Tell the story of your Git project by creating video animations (.mp4) of your commit history directly from your Git repo.

한마디로, 커밋히스토리를 설명하기 위해서, 애니메이션으로 만들수 있는 기능힙니다. 

사용사례를 간단하게 살펴보니깐요..
 - Git 프로젝트 시각화
 - 팀과 워크플로의 원하는 부분 공유
 - 블로그 게시물 또는 YouTube용 애니메이션 Git 비디오 만들기
 - 새로운 개발자가 Git을 배울 수 있도록 지원

이라고 하고요..

요구 사항은 아래와 같습니다. 
 - 파이썬 3.9 이상
 - Pip(Python용 패키지 관리자)
 - Manim (Community version)
 - Git파이썬

특징은 아래와 같습니다. 

- Git 프로젝트를 시각화, 워크플로우를 팀과 공유 하는 등의 목적으로 사용
- Repo 에서 커맨드 한번으로 .mp4 애니메이션 생성
   - 시작 커밋 ID/Ref 지정 (기본값은 HEAD)
   - 포함할 커밋 갯수 지정 (기본값은 8)
   - HEAD, 브랜치명, Tag의 Ref Label을 기본 표시
- 커스텀 인트로/아웃트로 추가 가능
- 다크모드/라이트모드

빠르게 시작하려면 아래와 같이 하시면 될것 같고요..

Quickstart


1) Install manim and manim dependencies for your OS

2) Install GitPython:

$ pip3 install gitpython

3) Install git-story:

$ pip3 install git-story

4) Browse to the Git repository you want create an animation from:

$ cd path/to/project/root

5) Run the program:

$ git-story

6) A default animation .mp4 file will be created using the most recent 8 commits on your checked-out Git branch. By default, video output file is created in the current directory, within a subdirectory called git-story_media. The location this subdirectory is customizeable using the command line flag --media-dir=path/to/output.

7) Use command-line options for customization, see usage:

$ git-story -h

usage: git-story [-h] [--commits COMMITS] [--commit-id COMMIT_ID] [--hide-merged-chains] [--reverse] [--title TITLE] [--logo LOGO] [--outro-top-text OUTRO_TOP_TEXT]
                 [--outro-bottom-text OUTRO_BOTTOM_TEXT] [--show-intro] [--show-outro] [--max-branches-per-commit MAX_BRANCHES_PER_COMMIT] [--max-tags-per-commit MAX_TAGS_PER_COMMIT]
                 [--media-dir MEDIA_DIR] [--low-quality] [--light-mode] [--invert-branches]

optional arguments:
  -h, --help            show this help message and exit
  --commits COMMITS     The number of commits to display in the Git animation (default: 8)
  --commit-id COMMIT_ID
                        The ref (branch/tag), or first 6 characters of the commit to animate backwards from (default: HEAD)
  --hide-merged-chains  Hide commits from merged branches, i.e. only display mainline commits (default: False)
  --reverse             Display commits in reverse order in the Git animation (default: False)
  --title TITLE         Custom title to display at the beginning of the animation (default: Git Story, by initialcommit.com)
  --logo LOGO           The path to a custom logo to use in the animation intro/outro (default: /usr/local/lib/python3.9/site-packages/git_story/logo.png)
  --outro-top-text OUTRO_TOP_TEXT
                        Custom text to display above the logo during the outro (default: Thanks for using Initial Commit!)
  --outro-bottom-text OUTRO_BOTTOM_TEXT
                        Custom text to display below the logo during the outro (default: Learn more at initialcommit.com)
  --show-intro          Add an intro sequence with custom logo and title (default: False)
  --show-outro          Add an outro sequence with custom logo and text (default: False)
  --max-branches-per-commit MAX_BRANCHES_PER_COMMIT
                        Maximum number of branch labels to display for each commit (default: 2)
  --max-tags-per-commit MAX_TAGS_PER_COMMIT
                        Maximum number of tags to display for each commit (default: 1)
  --media-dir MEDIA_DIR
                        The path to output the animation data and video file (default: .)
  --low-quality         Render output video in low quality, useful for faster testing (default: False)
  --light-mode          Enable light-mode with white background (default: False)
  --invert-branches     Invert positioning of branches where applicable (default: False)

좀더 자세한 내용은 아래 github 페이지 참고하시면 될것 같네요...

블로그내용은 여기까지고요..
항상믿고 봐주셔서 감사합니다.

728x90
300x250