{"id":26786207,"url":"https://github.com/junho100/init-tools","last_synced_at":"2025-03-29T11:36:08.896Z","repository":{"id":283983627,"uuid":"953472333","full_name":"junho100/init-tools","owner":"junho100","description":"initialize new laptop","archived":false,"fork":false,"pushed_at":"2025-03-23T13:53:13.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-23T14:19:27.451Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/junho100.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-23T13:01:07.000Z","updated_at":"2025-03-23T13:53:16.000Z","dependencies_parsed_at":"2025-03-23T14:29:36.894Z","dependency_job_id":null,"html_url":"https://github.com/junho100/init-tools","commit_stats":null,"previous_names":["junho100/init-tools"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junho100%2Finit-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junho100%2Finit-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junho100%2Finit-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junho100%2Finit-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/junho100","download_url":"https://codeload.github.com/junho100/init-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246180886,"owners_count":20736458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-29T11:36:08.270Z","updated_at":"2025-03-29T11:36:08.889Z","avatar_url":"https://github.com/junho100.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mac 초기 설정 자동화 도구\n\n새로운 맥북을 설정할 때 필요한 도구들을 설치하고 터미널 환경을 구성하는 도구입니다.\n\n## 전제 조건\n\n- Git이 이미 설치되어 있어야 합니다. (저장소를 클론하기 위해 필요)\n\n## 설치되는 도구들\n\n### 의존성 (수동 설치)\n\n의존성은 `DEPENDENCIES.md` 문서를 참고하여 수동으로 설치합니다:\n\n- XCode Command Line Tools\n- Homebrew\n- k9s (쿠버네티스 CLI 툴)\n- kubectx (쿠버네티스 컨텍스트 전환 툴)\n- iTerm2 (터미널 에뮬레이터)\n- Rectangle (창 관리 도구)\n- VSCode (코드 에디터)\n- Cursor (AI 지원 코드 에디터)\n- MesloLGS NF (폰트)\n\n### 터미널 설정 (자동 설치)\n\n다음 항목들은 `setup_terminal.sh` 스크립트로 자동 설치됩니다:\n\n- Oh My Zsh (Zsh 구성 관리 프레임워크)\n- Powerlevel10k (Zsh 테마)\n- git 플러그인 (Git 관련 기능)\n- z 플러그인 (디렉토리 이동 유틸리티)\n- zsh-autosuggestions (Zsh 자동 완성 플러그인)\n- k9s alias 설정 (폰트 깨짐 방지)\n\n## 새 맥북에서 설정하는 방법\n\n1. 이 저장소를 클론합니다:\n\n   ```bash\n   git clone https://github.com/your-username/init-tools.git\n   cd init-tools\n   ```\n\n2. 실행 권한을 부여합니다:\n\n   ```bash\n   chmod +x install.sh setup_terminal.sh config.sh\n   ```\n\n3. 필요한 경우 `config.sh` 파일을 수정하여 원하는 설정을 변경합니다.\n\n4. 설치 스크립트를 실행합니다:\n\n   ```bash\n   ./install.sh\n   ```\n\n   메뉴에서 다음 옵션 중 하나를 선택할 수 있습니다:\n\n   - 1: 의존성 설치 가이드 보기 (수동으로 설치해야 함)\n   - 2: 터미널 설정 (자동으로 설치됨)\n   - q: 종료\n\n## 모듈식 설치\n\n이 도구는 두 단계로 나누어 설치할 수 있습니다:\n\n1. **의존성 설치** (DEPENDENCIES.md 참조)\n\n   - 의존성 설치 가이드 문서를 참고하여 필요한 도구들을 수동으로 설치합니다.\n   - 각 도구의 설치 명령어와 설정 방법이 상세히 기재되어 있습니다.\n   - k9s 폰트 깨짐 방지를 위한 alias 설정 방법도 포함되어 있습니다.\n\n2. **터미널 설정** (setup_terminal.sh)\n   - Oh My Zsh 설치 및 설정\n   - Powerlevel10k 테마 설정\n   - 플러그인 설치 및 구성\n   - k9s alias 설정 (폰트 깨짐 방지)\n   - 설정 검증 및 디버깅 정보 수집\n\n각 단계는 독립적으로 실행할 수 있으며, 문제가 발생할 경우 디버깅 정보가 자동으로 수집됩니다.\n\n## 문제 해결 및 디버깅\n\n터미널 설정 중 문제가 발생하면 자동으로 디버깅 정보가 수집됩니다. 디버깅 파일은 `debug_info_YYYYMMDD_HHMMSS.log` 형식으로 저장되며, 다음 정보를 포함합니다:\n\n- OS 정보\n- Shell 정보 및 ZSH 버전\n- Homebrew 버전\n- PATH 환경변수\n- .zshrc 파일 내용\n- .p10k.zsh 파일 존재 여부\n- 설정 파일 위치\n- 폰트 설치 상태\n- Oh My Zsh 설치 상태\n\n문제 해결을 위해 이 디버깅 파일을 개발자에게 공유할 수 있습니다.\n\n## 설치 후 확인 사항\n\n- iTerm2 폰트 설정: Preferences \u003e Profiles \u003e Text \u003e Font에서 `MesloLGS NF` 선택\n- iTerm2 컬러 테마 설정: Preferences \u003e Profiles \u003e Colors \u003e Color Presets\n- Homebrew 설치 확인: `brew --version`\n- k9s alias 설정 확인: `alias | grep k9s`\n- Oh My Zsh 플러그인이 ~/.zshrc 파일에 포함되어 있는지 확인\n\n## 설정 사용자 정의\n\n`config.sh` 파일을 수정하여 다음 설정을 변경할 수 있습니다:\n\n### ZSH 플러그인\n\n기본적으로 다음 플러그인이 설치됩니다:\n\n- git\n- z\n- zsh-autosuggestions\n\n`config.sh` 파일에서 `ZSH_PLUGINS` 배열을 수정하여 설치할 플러그인을 변경할 수 있습니다.\n\n### ZSH 테마\n\n기본 테마는 `powerlevel10k/powerlevel10k`입니다.\n\n### VSCode 확장 프로그램\n\n설치가 권장되는 확장 프로그램은 `DEPENDENCIES.md` 문서를 참고하세요.\n\n### iTerm2 컬러 테마\n\n`config.sh` 파일에서 `ITERM2_COLOR_THEME` 변수를 설정하여 원하는 테마를 지정할 수 있습니다.\n\n## Powerlevel10k 테마 설정\n\nPowerlevel10k 테마는 자동으로 설치되며, `config` 디렉토리의 `.p10k.zsh` 파일이 홈 디렉토리에 자동으로 복사됩니다.\n\n이 설정 파일은 **매우 중요**합니다. 만약 `config/.p10k.zsh` 파일이 존재하지 않으면 설치 과정에서 Powerlevel10k 설정이 제대로 적용되지 않을 수 있습니다.\n\n### 설정 파일 위치 확인\n\n설치 전에 다음 명령어로 p10k 설정 파일이 제대로 존재하는지 확인하세요:\n\n```bash\nls -la config/.p10k.zsh\n```\n\n파일이 없는 경우:\n\n1. p10k 설정 파일을 다운로드하거나 생성하여 `config/.p10k.zsh` 경로에 저장하세요.\n2. 또는 기존 p10k 설정 파일을 복사하여 저장소의 `config/.p10k.zsh` 위치에 복사하세요.\n\n### Nerd Fonts\n\nPowerlevel10k에 필요한 MesloLGS NF 폰트는 `DEPENDENCIES.md` 문서의 안내에 따라 수동으로 설치해야 합니다. iTerm2에서 폰트 설정을 해주어야 아이콘이 제대로 표시됩니다.\n\n## 문제 해결\n\n### 폰트 표시 문제\n\n폰트 아이콘이 제대로 표시되지 않는 경우, iTerm2 설정에서 폰트를 `MesloLGS NF`로 설정했는지 확인하세요.\n\n### k9s 폰트 깨짐 문제\n\nk9s에서 폰트가 깨져 보이는 경우 다음 alias가 적용되었는지 확인하세요:\n\n```bash\nalias k9s=\"LANG=de_DE.UTF-8 k9s\"\n```\n\n### p10k 설정 문제\n\nPowerlevel10k가 제대로 설정되지 않는 경우 다음을 확인하세요:\n\n1. `config/.p10k.zsh` 파일이 존재하는지 확인\n2. 설치 후 `~/.p10k.zsh` 파일이 생성되었는지 확인\n3. `~/.zshrc` 파일에 다음 코드가 포함되어 있는지 확인:\n   ```bash\n   [[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh\n   ```\n4. 수동으로 설정을 적용하려면 터미널에서 다음 명령어를 실행:\n   ```bash\n   echo 'source ~/.p10k.zsh' \u003e\u003e ~/.zshrc\n   source ~/.zshrc\n   ```\n\n### 구성 초기화\n\n설정을 초기화하려면 `p10k configure` 명령어를 실행하세요.\n\n## 개발 및 테스트\n\n이 도구는 macOS에서 개발 및 테스트되었습니다. 새 사용자 계정에서 테스트하여 모든 기능이 올바르게 작동하는지 확인하는 것이 좋습니다.\n\n## 라이센스\n\nMIT 라이센스\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunho100%2Finit-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunho100%2Finit-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunho100%2Finit-tools/lists"}