Web Editor는 로컬 설정 없이 GitLab 리포지터리를 변경할 수 있는 브라우저 기반 도구입니다. 다음을 수행할 수 있습니다:

• 단일 파일을 편집하고 Markdown 미리보기를 실시간으로 확인합니다.
• 새 파일과 디렉토리를 생성합니다.
• 파일을 업로드하고 교체합니다.
• 버전 관리를 위해 브랜치와 태그를 생성합니다.
• 동시 편집 충돌을 방지하기 위해 파일을 잠급니다.
• 로컬에 Git을 설정하지 않고 프로젝트에 기여합니다.

GitLab은 Web Editor 커밋에 기본 이메일 주소를 사용합니다.

여러 파일 변경에는 Web IDE를 사용하세요.

파일 관리#

GitLab UI에서 직접 Web Editor로 파일을 생성, 편집, 업로드, 삭제할 수 있습니다.

파일 생성#

Web Editor에서 텍스트 파일을 생성하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 디렉토리 이름 옆에서 더하기 아이콘 (+) > 새 파일을 선택합니다.

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

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

6. 변경 사항 커밋을 선택합니다.

7. 커밋 메시지 필드에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에 파일을 생성하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에 파일을 생성하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에 파일을 생성하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

URL 파라미터를 사용한 미리 채워진 내용으로 파일 만들기#

미리 채워진 내용으로 새 파일 편집기를 열려면 URL의 content 쿼리 파라미터를 사용합니다. 예:

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

템플릿에서#

Web Editor에서 템플릿으로 텍스트 파일을 생성하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 새 파일을 생성할 디렉토리로 이동합니다.
3. 디렉토리 이름 옆에서 더하기 아이콘 (+) > 새 파일을 선택합니다.
4. 파일 이름에 GitLab이 템플릿을 제공하는 이름을 입력합니다:
   • .gitignore
   • .gitlab-ci.yml
   • LICENSE
   • Dockerfile
5. 템플릿 적용 드롭다운 목록에서 템플릿을 선택합니다.
6. 선택 사항. 원하는 대로 템플릿을 업데이트합니다.
7. 파일 생성 과정의 6단계에서 계속합니다.

파일 편집#

Web Editor에서 텍스트 파일을 편집하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 편집 > 단일 파일 편집을 선택합니다.

4. 변경합니다.

5. 변경 사항 커밋을 선택합니다.

6. 커밋 메시지 필드에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에서 파일을 편집하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 편집하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 편집하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.
     5. 필드를 채우고 머지 리퀘스트 생성을 선택합니다.

Markdown 미리보기#

Web Editor에서 Markdown 파일을 미리보려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 미리볼 파일로 이동합니다.
3. 편집 > 단일 파일 편집을 선택합니다.
4. 미리보기 탭을 선택합니다.

내용 옆에서 Markdown 미리보기를 실시간으로 볼 수 있습니다.

미리보기 패널을 닫으려면 작성 탭을 선택합니다.

특정 줄 연결#

Web Editor의 특정 단일 또는 여러 줄에 연결하려면 URL의 파일 이름 세그먼트에 해시 정보를 추가합니다. 예를 들어:

• MY_FILE.js#L3은 MY_FILE.js의 3번 줄을 강조 표시합니다.
• MY_FILE.js#L3-10은 MY_FILE.js의 3번~10번 줄을 강조 표시합니다.

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

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

사전 요구사항:

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

포크된 프로젝트의 머지 리퀘스트에서 작업하는 경우, 파일을 편집하고 변경 사항을 커밋할 수 있습니다. 이렇게 하려면:

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

파일 업로드#

Web Editor에서 파일을 업로드하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 디렉토리 이름 옆에서 더하기 아이콘 (+) > 파일 업로드를 선택합니다.

4. 추가할 파일을 드롭하거나 업로드합니다.

5. 커밋 메시지 필드에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에서 파일을 업로드하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 업로드하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 업로드하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.
     5. 필드를 채우고 머지 리퀘스트 생성을 선택합니다.

파일 삭제#

Web Editor에서 파일을 삭제하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 삭제를 선택합니다.

4. 커밋 메시지에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에서 파일을 삭제하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 삭제하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 삭제하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

파일 교체#

Web Editor에서 파일을 교체하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

3. 교체를 선택합니다.

4. 업로드하여 기존 파일을 교체할 파일을 드롭하거나 업로드합니다.

5. 커밋 메시지에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에서 파일을 교체하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 교체하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 파일을 교체하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

파일 변경 취소#

Web Editor에서 파일 변경, 편집, 업로드 또는 삭제를 취소하려면:

1. 취소를 선택합니다.

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

   • 변경 취소를 확인하려면: 확인을 선택합니다.
   • 변경을 취소하지 않으려면: 취소를 선택합니다.

작업 메뉴에서 파일 작업#

작업 (⋮) 메뉴는 드롭다운 목록에 파일 작업을 통합합니다. 이 메뉴에서 다음을 수행할 수 있습니다:

• 파일 편집.
• 파일 업로드.
• 파일 삭제.
• 파일 교체.

이러한 작업을 완료하려면:

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

디렉토리 생성#

Web Editor에서 디렉토리를 생성하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

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

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

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

5. 커밋 메시지에 커밋 이유를 입력합니다.

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

   • 미리 채워진 대상 브랜치에서 디렉토리를 생성하려면 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 디렉토리를 생성하고 변경 사항을 커밋하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택 해제되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

   • 새 브랜치에서 디렉토리를 생성하고, 변경 사항을 커밋하고, 머지 리퀘스트를 생성하려면:

     1. 새 브랜치에 커밋을 선택합니다.
     2. 브랜치 이름을 입력합니다.
     3. 이 변경 사항에 대한 머지 리퀘스트 생성 체크박스가 선택되어 있는지 확인합니다.
     4. 변경 사항 커밋을 선택합니다.

브랜치 생성#

Web Editor에서 브랜치를 생성하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 리포지터리 이름 옆에서 더하기 아이콘 (+) > 새 브랜치를 선택합니다.
3. 필드를 작성합니다.
4. 브랜치 생성을 선택합니다.

태그 생성#

프로덕션 릴리스 및 릴리스 후보 등의 마일스톤을 표시하기 위해 태그를 생성할 수 있습니다. Web Editor에서 태그를 생성하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 리포지터리 이름 옆에서 더하기 아이콘 (+) > 새 태그를 선택합니다.
3. 필드를 작성합니다.
4. 태그 생성을 선택합니다.

편집기 접근성 옵션#

웹 편집기는 여러 접근성 기능을 갖춘 Monaco Editor를 기반으로 합니다:

관련 주제#

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