[ 깃허브 ] Hello World GitHub / What is GitHub?

 

Hello World 프로젝트는 컴퓨터 프로그래밍의 오랜 전통입니다. 새로운 것을 배울 때 시작하는 간단한 운동입니다. GitHub를 시작하겠습니다!

The Hello World project is a time-honored tradition in computer programming. It is a simple exercise that gets you started when learning something new. Let’s get started with GitHub!

 

다음과 같은 방법을 배우십시오.

• 저장소 생성 및 사용
• 새 지점 시작 및 관리
• 파일을 변경하고 GitHub에 커밋으로 푸시
• 풀 요청 열기 및 병합

You’ll learn how to:

• Create and use a repository
• Start and manage a new branch
• Make changes to a file and push them to GitHub as commits
• Open and merge a pull request

 

GitHub가 뭐죠?

GitHub는 버전 제어 및 협업을 위한 코드 호스팅 플랫폼입니다. 이를 통해 사용자와 다른 사용자가 어디에서나 프로젝트에 함께 참여할 수 있습니다.

이 튜토리얼에서는 리포지토리, 분기, 커밋 및 풀 요청과 같은 GitHub에 대해 설명합니다. 자신만의 Hello World 리포지토리를 만들고 코드를 생성하고 검토하는 인기 있는 방법인 GitHub의 Pull Request 워크플로우를 배울 수 있습니다.

코딩이 필요하지 않습니다.

이 튜토리얼을 완료하려면 GitHub.com 계정과 인터넷 액세스가 필요합니다. 코드화, 명령줄 사용 또는 Git(버전 제어 소프트웨어 GitHub가 기본 제공됨) 설치 방법을 알 필요가 없습니다.

Tip: 튜토리얼의 단계를 완료하는 동안 볼 수 있도록 별도의 브라우저 창(또는 탭)에서 이 가이드를 엽니다.

 

What is GitHub?

GitHub is a code hosting platform for version control and collaboration. It lets you and others work together on projects from anywhere.

This tutorial teaches you GitHub essentials like repositories, branches, commits, and Pull Requests. You’ll create your own Hello World repository and learn GitHub’s Pull Request workflow, a popular way to create and review code.

No coding necessary

To complete this tutorial, you need a GitHub.com account and Internet access. You don’t need to know how to code, use the command line, or install Git (the version control software GitHub is built on).

Tip: Open this guide in a separate browser window (or tab) so you can see it while you complete the steps in the tutorial.

 

1단계. 리포지토리를 만듭니다.

저장소는 일반적으로 단일 프로젝트를 구성하는 데 사용됩니다. 저장소는 프로젝트에 필요한 모든 폴더와 파일, 이미지, 비디오, 스프레드시트 및 데이터 세트를 포함할 수 있습니다. README 또는 프로젝트에 대한 정보가 있는 파일을 포함하는 것이 좋습니다. GitHub를 사용하면 새 저장소를 생성하는 동시에 쉽게 추가할 수 있습니다. 또한 라이센스 파일과 같은 다른 일반적인 옵션도 제공합니다.

Hello-world 저장소는 아이디어, 리소스를 저장하거나 다른 사람과 공유하거나 토론하는 장소가 될 수 있습니다.

 

Step 1. Create a Repository

A repository is usually used to organize a single project. Repositories can contain folders and files, images, videos, spreadsheets, and data sets – anything your project needs. We recommend including a README, or a file with information about your project. GitHub makes it easy to add one at the same time you create your new repository. It also offers other common options such as a license file.

Your hello-world repository can be a place where you store ideas, resources, or even share and discuss things with others.

 

새 저장소(리포지토리)를 만들려면

1. 오른쪽 상단에서 아바타 또는 ID 아이콘 옆의을 클릭 한 다음 새 리포지토리를 선택합니다.
2. 저장소 이름을 hello-world로 지정하십시오.
3. 간단한 설명을 작성하십시오.
4. README로 이 저장소 초기화를 선택하십시오.

To create a new repository

1. In the upper right corner, next to your avatar or identicon, click  and then select New repository.
2. Name your repository hello-world.
3. Write a short description.
4. Select Initialize this repository with a README.

저장소 작성을 클릭하십시오.

Click Create repository.

 

2단계. 브랜치를 작성합니다.

브랜치 기능은 한 번에 여러 버전의 저장소에서 작업하는 방법입니다.

기본적으로 저장소(리포지토리)에는 Master라는 이름의 지점이 하나 있으며, 이 지점은 최종 브랜치로 간주됩니다. 우리는 가지를 사용하여 실험을 하고 숙달하기 전에 편집을 합니다.

마스터 브랜치에서 브랜치를 생성할 때 마스터의 복사 또는 스냅샷을 해당 시점과 동일하게 만듭니다. 브랜치 작업을 수행하는 동안 다른 사용자가 마스터 브랜치를 변경한 경우 이러한 업데이트를 가져올 수 있습니다.

Step 2. Create a Branch

Branching is the way to work on different versions of a repository at one time.

By default your repository has one branch named master which is considered to be the definitive branch. We use branches to experiment and make edits before committing them to master.

When you create a branch off the master branch, you’re making a copy, or snapshot, of master as it was at that point in time. If someone else made changes to the master branch while you were working on your branch, you could pull in those updates.

 

이 다이어그램은 다음을 보여줍니다

• 마스터 브랜치 입니다.
• 기능이라는 새로운 지사(이 지점에서 '기능 작업'을 수행하고 있기 때문입니다.)
• 기능이 마스터로 병합되기 전에 수행하는 이동 경로입니다.

This diagram shows:

• The master branch
• A new branch called feature (because we’re doing ‘feature work’ on this branch)
• The journey that feature takes before it’s merged into master

 

다른 버전의 파일을 저장해 본 적이 있습니까? 다음과 같은 것이 있습니다.

Have you ever saved different versions of a file? Something like:

• story.txt
• story-joe-edit.txt
• story-joe-edit-reviewed.txt

 

Branches는 GitHub 저장소에서 유사한 목표를 달성합니다.

Branches accomplish similar goals in GitHub repositories.

 

여기서 GitHub에서 개발자, 작가 및 디자이너는 브랜치를 사용하여 버그 수정 및 기능 작업을 마스터 (프로덕션) 브랜치와 분리합니다. 변경이 준비되면 브랜치를 마스터로 병합합니다.

Here at GitHub, our developers, writers, and designers use branches for keeping bug fixes and feature work separate from our master (production) branch. When a change is ready, they merge their branch into master.

 

 

새 브랜치를 만들려면

1. 새로운 저장소 hello-world로 이동하십시오.
2. 파일 목록 상단에서 branch : master라고 표시된 드롭 다운을 클릭하십시오.
3. 새 브랜치 텍스트 상자에 브랜치 이름 readme-edits를 입력하십시오.
4. 파란색 브랜치 만들기 상자를 선택하거나 키보드에서 "Enter"를 누르십시오.

To create a new branch

1. Go to your new repository hello-world.
2. Click the drop down at the top of the file list that says branch: master.
3. Type a branch name, readme-edits, into the new branch text box.
4. Select the blue Create branch box or hit “Enter” on your keyboard.

 

이제 master와 readme-edits의 두 가지 브랜치가 있습니다. 그들은 정확히 똑같아 보이지만 오랫동안은 아닙니다! 다음으로 변경 사항을 새 지점에 추가합니다.

Now you have two branches, master and readme-edits. They look exactly the same, but not for long! Next we’ll add our changes to the new branch.

 

 

 

3 단계. 변경 및 커밋

브라보! 이제 마스터 사본 인 readme-edits 브랜치의 코드 뷰에 있습니다. 몇 가지 수정을하겠습니다.

GitHub에서 저장된 변경 사항을 커밋이라고합니다. 각 커밋에는 관련 커밋 메시지가 있으며, 이는 특정 변경이 이루어진 이유를 설명하는 설명입니다. 커밋 메시지는 변경 기록을 캡처하므로 다른 기고자가 수행 한 작업과 이유를 이해할 수 있습니다.

Step 3. Make and commit changes

Bravo! Now, you’re on the code view for your readme-edits branch, which is a copy of master. Let’s make some edits.

On GitHub, saved changes are called commits. Each commit has an associated commit message, which is a description explaining why a particular change was made. Commit messages capture the history of your changes, so other contributors can understand what you’ve done and why.

 

변경 및 커밋

1.  README.md 파일을 클릭하십시오.
2. 파일보기의 오른쪽 상단에있는 연필 아이콘을 클릭하여 편집하십시오.
3. 편집기에서 자신에 대해 조금 쓰십시오.
4. 변경 사항을 설명하는 커밋 메시지를 작성하십시오.
5. Commit changes 버튼을 클릭하십시오.

Make and commit changes

1. Click the README.md file.
2. Click the  pencil icon in the upper right corner of the file view to edit.
3. In the editor, write a bit about yourself.
4. Write a commit message that describes your changes.
5. Click Commit changes button.

이러한 변경 사항은 readme-edits 브랜치의 README 파일에만 적용되므로 이제 이 브랜치에는 마스터와 다른 컨텐츠가 포함됩니다.

These changes will be made to just the README file on your readme-edits branch, so now this branch contains content that’s different from master.

 

단계 4. 풀 요청 열기

좋은 편집! 이제 마스터에서 브랜치를 변경 했으므로 풀 요청을 열 수 있습니다.

풀 요청은 GitHub에서 공동 작업의 핵심입니다. 풀 요청을 열면 변경 사항을 제안하고 누군가가 내 기여를 검토하고 끌어와 브랜치로 병합하도록 요청합니다. 풀 요청은 두 브랜치의 컨텐츠 차이 또는 차이를 보여줍니다. 변경 사항, 덧셈 및 뺄셈은 녹색과 빨간색으로 표시됩니다.

커밋을 마치면 코드가 완성되기 전에 풀 요청을 열고 토론을 시작할 수 있습니다.

풀 요청 메시지에 GitHub의 @mention 시스템을 사용하면 특정 직원이나 팀이 복도에 있거나 시간대가 10 개 떨어져 있는지 여부에 대한 피드백을 요청할 수 있습니다.

자체 저장소(리포지토리)에서 풀 요청을 열고 직접 병합 할 수도 있습니다. 대규모 프로젝트를 수행하기 전에 GitHub 흐름을 배우는 좋은 방법입니다.

Step 4. Open a Pull Request

Nice edits! Now that you have changes in a branch off of master, you can open a pull request.

Pull Requests are the heart of collaboration on GitHub. When you open a pull request, you’re proposing your changes and requesting that someone review and pull in your contribution and merge them into their branch. Pull requests show diffs, or differences, of the content from both branches. The changes, additions, and subtractions are shown in green and red.

As soon as you make a commit, you can open a pull request and start a discussion, even before the code is finished.

By using GitHub’s @mention system in your pull request message, you can ask for feedback from specific people or teams, whether they’re down the hall or 10 time zones away.

You can even open pull requests in your own repository and merge them yourself. It’s a great way to learn the GitHub flow before working on larger projects.

Open a Pull Request for changes to the README

 

Step

Click the  Pull Request tab, then from the Pull Request page, click the green New pull request button.	풀 요청 탭을 클릭 한 다음 풀 요청 페이지에서 녹색 새 풀 요청 버튼을 클릭하십시오.
In the Example Comparisons box, select the branch you made, readme-edits, to compare with master (the original).	예제 비교 상자에서 master (원본)와 비교할 readme-edits 브랜치를 선택하십시오.
Look over your changes in the diffs on the Compare page, make sure they’re what you want to submit.	비교 페이지에서 차이점의 변경 사항을 살펴보고 제출하려는 내용인지 확인하십시오.
When you’re satisfied that these are the changes you want to submit, click the big green Create Pull Request button.	제출하려는 변경 사항이 만족 스러우면 초록색 큰 풀 요청 작성 단추를 클릭하십시오.
Give your pull request a title and write a brief description of your changes.	풀 요청에 제목을 부여하고 변경 사항에 대한 간단한 설명을 작성하십시오.

 

메시지가 끝나면 풀 요청 만들기를 클릭하십시오.

When you’re done with your message, click Create pull request!

 

5 단계. 풀 요청 병합

이 마지막 단계에서는 변경 사항을 모아서 readme-edits 브랜치를 마스터 브랜치에 병합해야합니다.

1. 녹색 병합 풀 요청 버튼을 클릭하여 변경 사항을 마스터에 병합합니다.
2. 병합 확인을 클릭하십시오.
3. 자주색 상자에 브랜치 삭제 버튼을 사용하여 브랜치가 변경되었으므로 브랜치를 삭제하십시오.

 

Step 5. Merge your Pull Request

In this final step, it’s time to bring your changes together – merging your readme-edits branch into the master branch.

1. Click the green Merge pull request button to merge the changes into master.
2. Click Confirm merge.
3. Go ahead and delete the branch, since its changes have been incorporated, with the Delete branch button in the purple box.

 

축하해요!

이 튜토리얼을 완료함으로써 프로젝트를 만들고 GitHub에서 풀 요청을 하는 방법을 배웠습니다!

 

Celebrate!

By completing this tutorial, you’ve learned to create a project and make a pull request on GitHub!

 

이 튜토리얼에서 수행 한 작업은 다음과 같습니다.

• 오픈 소스 리포지토리 생성
• 새 지점 시작 및 관리
• 파일을 변경하고 해당 변경 사항을 GitHub에 커밋
• 풀 요청 열기 및 병합

Here’s what you accomplished in this tutorial:

• Created an open source repository
• Started and managed a new branch
• Changed a file and committed those changes to GitHub
• Opened and merged a Pull Request

 

GitHub 프로필을 살펴보면 새로운 기여 사각형을 볼 수 있습니다!

풀 요청의 기능에 대한 자세한 내용은 GitHub 흐름 가이드를 읽는 것이 좋습니다. GitHub Explore를 방문하여 오픈 소스 프로젝트에 참여할 수도 있습니다.

Tip: GitHub 시작 방법에 대한 자세한 내용은 다른 가이드, YouTube 채널 및 주문형 교육을 확인하십시오.

 

 

Take a look at your GitHub profile and you’ll see your new contribution squares!

To learn more about the power of Pull Requests, we recommend reading the GitHub flow Guide. You might also visit GitHub Explore and get involved in an Open Source project.

---

Tip: Check out our other Guides, YouTube Channel and On-Demand Training for more on how to get started with GitHub.

 

 

 

 

 

 

 

 

[출처 : https://guides.github.com/activities/hello-world/]