웹 편집기는 로컬 설정 없이 GitLab 리포지터리를 변경하는 브라우저 기반 도구입니다. 다음 작업을 수행할 수 있습니다.

• 단일 파일을 편집하고 커밋하기 전에 변경 사항을 미리 봅니다.
• 새 파일과 디렉터리를 생성합니다.
• 파일을 업로드하고 교체합니다.
• 버전 관리를 위한 브랜치와 태그를 생성합니다.
• 동시 편집 충돌을 방지하기 위해 파일을 잠급니다.
• Git을 로컬에 설정하지 않고 프로젝트에 기여합니다.

GitLab은 웹 편집기 커밋에 기본 이메일 주소를 사용합니다.

여러 파일을 변경하려면 웹 IDE를 사용합니다.

파일 관리#

웹 편집기를 사용하면 GitLab UI에서 바로 파일을 생성, 편집, 업로드, 삭제할 수 있습니다.

파일 생성#

웹 편집기에서 텍스트 파일을 생성하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 새 파일을 생성할 디렉터리로 이동합니다.

3. 디렉터리 이름 옆에서 더하기 아이콘(+) > New file을 선택합니다.

4. 브랜치 이름 옆에 파일 이름과 확장자를 입력합니다. 예를 들어 my_file.md 입니다.

5. 파일에 내용을 추가합니다.

6. Commit changes를 선택합니다.

7. Commit message 필드에 커밋 사유를 입력합니다.

8. 다음 옵션 중 하나를 선택합니다.

   • 미리 채워진 대상 브랜치에 파일을 생성하려면 Commit changes를 선택합니다.

   • 새 브랜치에 파일을 생성하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에 파일을 생성하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

내용이 미리 채워진 새 파일 편집기를 열려면 URL의 content 쿼리 파라미터를 사용합니다. 예를 들면 다음과 같습니다.

https://gitlab.com/<your-namespace>/<your-project>/-/new/main?content=your+content+here

템플릿에서#

웹 편집기에서 템플릿으로 텍스트 파일을 생성하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 새 파일을 생성할 디렉터리로 이동합니다.
3. 디렉터리 이름 옆에서 더하기 아이콘(+) > New file을 선택합니다.
4. Filename에 GitLab이 템플릿을 제공하는 이름을 입력합니다.
   • .gitignore
   • .gitlab-ci.yml
   • LICENSE
   • Dockerfile
5. Apply a template 드롭다운 목록에서 템플릿을 선택합니다.
6. 선택 사항. 필요에 따라 템플릿을 수정합니다.
7. 파일 생성 절차의 6단계부터 이어서 진행합니다.

파일 편집#

웹 편집기에서 텍스트 파일을 편집하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 편집할 파일로 이동합니다.

3. Edit > Edit single file을 선택합니다.

4. 변경 사항을 적용합니다.

5. Commit changes를 선택합니다.

6. Commit message 필드에 커밋 사유를 입력합니다.

7. 다음 옵션 중 하나를 선택합니다.

   • 미리 채워진 대상 브랜치에서 파일을 편집하려면 Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 편집하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 편집하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.
     5. 필드를 입력하고 Create merge request를 선택합니다.

특정 줄 연결#

웹 편집기에서 한 줄 또는 여러 줄에 연결하려면 URL의 파일 이름 부분에 해시 정보를 추가합니다. 예를 들면 다음과 같습니다.

• MY_FILE.js#L3은 MY_FILE.js의 3번째 줄을 강조 표시합니다.
• MY_FILE.js#L3-10은 MY_FILE.js의 3번째부터 10번째 줄까지 강조 표시합니다.

파일을 편집할 때 줄 번호를 선택하여 한 줄에 연결할 수도 있습니다.

포크된 머지 리퀘스트에서 파일 편집#

사전 요구 사항:

• 포크에서 온 머지 리퀘스트에서 작업하고 있어야 합니다.
• 업스트림 멤버의 커밋 허용이 활성화되어 있어야 합니다.

포크된 프로젝트에서 온 머지 리퀘스트에서 작업 중이면 파일을 편집하고 변경 사항을 커밋할 수 있습니다. 이 작업을 수행하려면 다음 단계를 따릅니다.

1. 머지 리퀘스트로 이동합니다.
2. 편집할 파일로 이동합니다.
3. Edit > Edit single file을 선택합니다.
4. Commit changes를 선택합니다.
5. Commit message에 커밋 사유를 입력합니다. 다음 정보가 표시됩니다. Your changes can be committed to <branch-name> because a merge request is open.
6. Commit changes를 선택합니다.

파일 미리보기#

웹 편집기에서 파일을 생성하거나 편집할 때 커밋하기 전에 내용을 미리 볼 수 있습니다.

내용을 미리 보려면 Preview 탭을 선택합니다. 표시되는 내용은 파일 확장자에 따라 달라집니다.

• Markdown 파일은 입력하는 대로 갱신되는 실시간 미리보기를 내용 옆에 표시합니다.
• AsciiDoc, Org, reStructuredText 같은 다른 마크업 파일은 렌더링된 마크업을 표시합니다.
• 그 밖의 모든 파일은 변경 사항의 diff를 표시합니다.

내용으로 돌아가려면 Write 탭을 선택합니다.

마크업 파일이 아닌 파일을 편집하면 탭 이름이 Preview changes로 표시됩니다.

파일 업로드#

웹 편집기에서 파일을 업로드하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 파일을 업로드할 디렉터리로 이동합니다.

3. 디렉터리 이름 옆에서 더하기 아이콘(+) > Upload file을 선택합니다.

4. 추가할 파일을 끌어다 놓거나 업로드합니다.

5. Commit message 필드에 커밋 사유를 입력합니다.

6. 다음 옵션 중 하나를 선택합니다.

   • 미리 채워진 대상 브랜치에 파일을 업로드하려면 Commit changes를 선택합니다.

   • 새 브랜치에 파일을 업로드하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에 파일을 업로드하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.
     5. 필드를 입력하고 Create merge request를 선택합니다.

파일 삭제#

웹 편집기에서 파일을 삭제하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 삭제할 파일로 이동합니다.

3. Delete를 선택합니다.

4. Commit message에 커밋 사유를 입력합니다.

5. 다음 옵션 중에서 선택합니다.

   • 미리 채워진 대상 브랜치에서 파일을 삭제하려면 Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 삭제하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 삭제하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

파일 교체#

웹 편집기에서 파일을 교체하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 교체할 파일로 이동합니다.

3. Replace를 선택합니다.

4. 업로드하여 기존 파일을 대체할 파일을 끌어다 놓거나 업로드합니다.

5. Commit message에 커밋 사유를 입력합니다.

6. 다음 옵션 중에서 선택합니다.

   • 미리 채워진 대상 브랜치에서 파일을 교체하려면 Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 교체하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에서 파일을 교체하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

파일 변경 취소#

웹 편집기에서 파일 변경, 편집, 업로드, 삭제를 취소하려면 다음 단계를 수행합니다.

1. Cancel을 선택합니다.

2. 다음 중 하나를 선택합니다.

   • 변경을 취소하려면 OK를 선택합니다.
   • 변경을 취소하지 않으려면 Cancel을 선택합니다.

작업 메뉴에서 파일 작업#

Actions (⋮) 메뉴는 파일 작업을 드롭다운 목록 하나로 모아 줍니다. 이 메뉴에서 다음 작업을 수행할 수 있습니다.

• 파일을 편집합니다.
• 파일을 업로드합니다.
• 파일을 삭제합니다.
• 파일을 교체합니다.

이러한 작업을 수행하려면 다음 단계를 따릅니다.

1. GitLab에서 파일을 엽니다.
2. 오른쪽 상단 모서리의 파일 이름 옆에서 Actions (⋮)를 선택합니다.
3. 원하는 작업을 선택합니다.

디렉터리 생성#

웹 편집기에서 디렉터리를 생성하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 새 디렉터리를 생성할 디렉터리로 이동합니다.

3. 디렉터리 이름 옆에서 더하기 아이콘(+) > New directory를 선택합니다.

4. Directory name 필드에 디렉터리 이름을 입력합니다.

5. Commit message에 커밋 사유를 입력합니다.

6. 다음 옵션 중에서 선택합니다.

   • 미리 채워진 대상 브랜치에 디렉터리를 생성하려면 Commit changes를 선택합니다.

   • 새 브랜치에 디렉터리를 생성하고 변경 사항을 커밋하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택 해제되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

   • 새 브랜치에 디렉터리를 생성하고 변경 사항을 커밋한 후 머지 리퀘스트를 생성하려면 다음 단계를 수행합니다.

     1. Commit to a new branch를 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. Create a merge request for this change 체크박스가 선택되어 있는지 확인합니다.
     4. Commit changes를 선택합니다.

브랜치 생성#

웹 편집기에서 브랜치를 생성하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 리포지터리 이름 옆에서 더하기 아이콘(+) > New branch를 선택합니다.
3. 필드를 입력합니다.
4. Create branch를 선택합니다.

태그 생성#

프로덕션 릴리스나 릴리스 후보 같은 마일스톤을 표시하기 위해 태그를 생성할 수 있습니다. 웹 편집기에서 태그를 생성하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 리포지터리 이름 옆에서 더하기 아이콘(+) > New tag를 선택합니다.
3. 필드를 입력합니다.
4. Create tag를 선택합니다.

편집기 접근성 옵션#

웹 편집기는 Monaco Editor를 기반으로 하며, 다음을 포함한 여러 접근성 기능을 제공합니다.

관련 주제#

• 머지 리퀘스트 생성
• 브랜치
  • 기본 브랜치
  • 보호된 브랜치
• 웹 IDE
• 파일 트리 브라우저