👋 참여해주셔서 감사합니다!

[ooMia]

시작을 위해 필요한 내용을 설명 드리겠습니다.
원래라면 Git만 활용하면 되지만, 가장 편한 것은 IDE를 사용하는 것입니다.

1. 설치

➡️ Visual Studio Code 설치

• ➡️ 설치 후 Ctrl + Shift + ~를 누르거나, 커맨드 창을 띄웁니다.
• git config --list 결과가 다음처럼 뭐라도 나오면 됩니다.
  

➡️ 안 나오면 Git 설치

2. GitHub 연동

➡️ GitHub Blog-chain/v1 방문

• ➡️ Fork를 누릅니다.
  

• ➡️ 내용은 어떻게 바꾸든 상관 없습니다. Create fork를 누릅니다.
  

• 우리 각자 계정에 복사본이 생겼습니다.
  

• ➡️ <> Code를 누릅니다.
  

• ➡️ Copy url to Clipboard를 누릅니다.

  • 이 URL은 레포의 고유한 키라고 생각하면 됩니다.
    

➡️ Visual Studio Code를 실행합니다.

• 본인이 작업하기 편한 폴더를 엽니다. 어떤 폴더든 상관 없습니다.

• ➡️ 커맨드 창에 다음을 입력하고 실행합니다.

  • ➡️ git clone https://github.com/ooMia/v1.git
  • 여기서 ooMia는 제 닉네임이고, 실제로는 여러분들의 닉네임이 되어야 합니다.
  • 결과는 다음과 같아야 합니다.
    

• 이후 탐색기에서 v1(또는 본인이 명명한 이름) 폴더가 생성되었는지 확인합니다.
  

• ➡️ 터미널에 code v1을 실행하면 다운로드 받은 폴더로 프로젝트가 열립니다.

  • ➡️ 만약 안 된다면, 그냥 파일 > 폴더 열기로 열어줍니다.
    

마크다운 Preview

• ➡️ 마크다운 파일을 연 후에 오른쪽 아이콘을 클릭하면 결과물을 미리 볼 수 있습니다.
  
• 결과
  

git commit (로컬 파일 변화를 로컬 Git에 기록)

• 평소 자주 하는 일반적인 작업들은 IDE의 GUI를 활용하면 더 쉽게 처리할 수 있습니다.

• ➡️ 변동 사항이 있다면, 이렇게 소스 제어에 기록이 남습니다. 임의의 커밋 메세지를 남긴 후 커밋해줍니다.
  

  • ➡️ 만약 없다면 보기 > 소스 제어로 열어줍니다.
    

• ➡️ 엄밀한 제어를 원한다면, 스테이징 과정을 거쳐도 됩니다.
  

• ➡️ 스테이징 경고창이 뜬다면, 본인 스타일에 따라 예 또는 항상을 눌러서 커밋을 완료합니다.

git push (로컬 변화를 원격 저장소에 반영)

• 동기화로 버튼이 바뀌어 있을 것입니다.
  
• ➡️ 본인이 동기화를 진행하고 싶은 시점에 누릅니다.
• GitHub 자신의 레포에 들어가보면 변화가 반영되어 있는 것을 확인할 수 있습니다.
  

pull request (나의 복사본을 초기 원본에 반영하기)

• ➡️ Pull requests > Create pull request를 누릅니다.
  

• 기본은 ooMia/v1:main > Blog-chain/v1:main으로 되어있을 것입니다.

• ➡️ 여기서 다음과 같이 Blog-chain/v1의 브랜치를 develop으로 변경해줍니다.
  

• ➡️ Create pull request 누르기
  

• ➡️ 본인이 변경하려는 내용 등을 작성합니다.

  • v1은 내용 확보에 초점을 맞추기 때문에, 핵심을 간단히 작성하면 됩니다.
    
  • 역시나 Create pull request 누르면 됩니다.

• 어느샌가 Blog-chain/v1 레포로 자동 이동한 것을 볼 수 있습니다.
  

• 이후 최종 merge 승인을 통해 기여를 완료하게 됩니다.

  • 실제 서비스를 운영한다면 PR merge에 대한 제약을 좀 더 두겠지만, 필요성을 느끼기 전까지는 편하게 병합할 수 있도록 지원하겠습니다.

GitHub 프로젝트에서 작업 할당

➡️ 추가로 GitHub 프로젝트 링크에서 본인이 작성하길 원하는 키워드를 선정해서 In Progress로 옮겨두면 됩니다!

• ➡️ 본인이 원하는 내용이 없다면 직접 생성해도 좋습니다!
• ➡️ Assignee에 자신의 GitHub 닉네임을 선택하면 됩니다.

여기까지가 실질적인 튜토리얼의 끝입니다. 진행하시느라 수고하셨습니다!

README.md 수정 (Optional)

❗다음은 직접 README.md에 자신의 프로필을 추가하길 원하는 이들을 위한 가이드입니다. 선택적으로 원하는 분들만 수행하시면 되겠습니다.

• ➡️ README.md > ## Contributors에 있는 내용을 찾습니다.
  

1. ➡️ 기여자 이미지로 GitHub 프로필 사진을 사용하고 싶다면 다음을 실행합니다.

• GitHub 닉네임을 통해 자신의 프로필 사진을 가져오는 스크립트를 작성해두었습니다.
• ➡️ Powershell과 sh/bash 중 가능한 셸에서 스크립트를 실행합니다.
  
  • URL을 받아서 복사해두면 됩니다. 결과는 다음과 같습니다.
  • Powershell
    • 
  • sh/bash
    • 

2. ➡️ 프로필과는 별개로 업로드 한 이미지를 사용하고 싶다면 embed > profile 폴더에 자신이 첨부하길 원하는 사진을 넣어둡시다.
   

3. 표는 다음과 같은 markdown 테이블 형식으로 작성되어 있습니다.

| Option #1: GitHub-Profile <br/> oomia | Option #2: Local-Profile <br/> mia |
| :-: | :--: |
| [<img src="https://avatars.githubusercontent.com/u/96914905" height=150 width=150> <br/> @GitHub-Nickname](https://github.com/GitHub-Nickname) | [<img src="./embed/profile/nse-5354155414388309291-1000000474_1719950399348.png" height=150 width=150> <br/> @oomia](https://github.com/oomia) |

• ➡️ URL을 복사해두었다면 img 태그의 src 값에 붙여넣고, GitHub-Nickname을 자신의 것으로 바꿉니다.
  • [<img src="https://avatars.githubusercontent.com/u/96914905" height=150 width=150> <br/> @GitHub-Nickname](https://github.com/GitHub-Nickname)
• ➡️ 이미지 파일이 있다면 "./embed/profile/nse-5354155414388309291-1000000474_1719950399348.png"와 같이 img 태그의 src 값을 적절히 입력해주면 됩니다.

4. ➡️ (3)의 마크다운 형식에 따라서 옆으로 이어서 작성해줍니다.
   • ➡️ 이 떄, 줄바꿈 때문에 너무 복잡해보인다 싶으면, Alt + Z로 자동 줄바꿈을 해제할 수 있습니다.