Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
팀 프로젝트에 대한 위키 Git 리포지토리 를 설정한 후 위키 및 페이지 콘텐츠에 대한 제목을 추가할 수 있습니다. Azure DevOps UI는 페이지를 편집하고 작업할 때 변경 내용을 미리 볼 수 있는 병렬 환경을 제공합니다.
편집 창에서 Markdown 형식 구문을 사용하여 페이지 콘텐츠를 입력합니다. 이미지, 첨부 파일 및 링크를 삽입할 수도 있습니다. 변경하면 미리 보기 창의 콘텐츠가 업데이트됩니다. 제목, 목록, 링크 및 이미지와 같은 특수 서식이 있는 콘텐츠는 미리 보기 창에 서식 있는 텍스트로 표시됩니다.
페이지를 편집하는 동안 Ctrl+S 바로 가기 키를 사용하여 작업을 빠르게 저장합니다. "추가된 페이지 링크"와 같은 사용자 지정 수정 메시지로 작업을 저장할 수도 있습니다. 이 옵션은 저장
드롭다운 메뉴에서 사용할 수 있습니다.
다른 바로 가기 키를 사용할 수 있습니다. 자세한 내용은 위키 페이지를 관리하는 바로 가기 키를 참조하세요.
참고
이 문서에서는 팀 프로젝트를 위해 만든 위키에서 페이지를 추가하고 편집하는 방법을 설명합니다. Git 리포지토리에서 게시된 위키에 페이지를 추가하거나 편집하려면 위키에 Git 리포지토리 게시를 참조하세요.
Wiki 명령줄 도구
Azure DevOps CLI 명령을 사용하여 위키 콘텐츠를 관리할 수 있습니다. 다음 표에서는 특정 명령을 사용하는 방법을 설명하는 이 문서의 섹션에 대한 링크를 제공합니다.
| 명령어 | 설명 |
|---|---|
| az devops wiki show 명령어는 Wiki 페이지의 내용을 표시합니다. | 위키를 열고 위키 홈페이지를 표시합니다. |
| az devops 위키 페이지 표시 | 위키에 특정 페이지를 표시합니다. |
| az devops wiki 페이지 생성 | 위키에 새 페이지를 추가합니다. |
| az devops 위키 페이지 업데이트 | 위키에서 기존 페이지를 편집합니다. |
| az devops wiki page delete (위키 페이지 삭제) | 위키에서 페이지를 삭제합니다. |
필수 조건
| 범주 | 요구 사항 |
|---|---|
| 프로젝트 액세스 | 위키가 있는 프로젝트의 구성원입니다. 필요에 따라 프로젝트 관리자에게 액세스를 요청할 수 있습니다. |
| 사용 권한 | 기여자 그룹의 구성원입니다. |
| 액세스 수준 | 적어도 기본 액세스. |
| 작업 | 프로젝트에 대해 프로비전된 Wiki 를 준비합니다. |
Wiki 열기
브라우저에서 Azure DevOps에서 팀 프로젝트에 대한 위키 페이지를 열고 보거나 Azure DevOps CLI를 사용할 수 있습니다.
지원되는 웹 브라우저를 사용하여 프로젝트에 연결하고 Wiki를 선택합니다.
팀 프로젝트를 전환해야 하는 경우 
Azure DevOps를 선택하여 모든 팀 프로젝트와 팀을 찾아봅니다.
위키 페이지 추가
이 섹션에서는 위키에 페이지를 추가하는 방법을 설명합니다. 브라우저에서 Azure DevOps UI로 직접 작업하거나 Azure DevOps CLI를 사용할 수 있습니다.
위키에 새 페이지를 추가하려면 두 가지 옵션이 있습니다. 먼저 목록에서 페이지(예: 홈페이지)를 선택합니다.
현재 페이지와 동일한 수준에서 페이지를 추가하려면 Azure DevOps UI 아래쪽에서 새 페이지를 선택합니다.
현재 페이지에 하위 페이지를 추가하려면 추가 옵션(...) > 을 선택합니다.하위 페이지를 추가합니다.
바로 가기 키를 사용하여 페이지를 추가할 수도 있습니다. 현재 페이지를 선택한 다음 n 을 선택하여 새 페이지를 추가하거나 c를 선택하여 하위 페이지를 추가 합니다. 자세한 내용은 위키 페이지를 관리하는 바로 가기 키를 참조하세요.
페이지 제목 및 파일 이름
페이지의 고유한 제목을 입력합니다. 값은 대/소문자를 구분합니다. 제목은 페이지의 파일 이름으로 사용됩니다. 파일 이름에서 페이지 제목의 공백은 하이픈(-)으로 바뀝니다. 예를 들어 페이지 제목 "기여 방법"은 파일 이름 How-to-contribute.md 해당합니다. 파일의 완전한 경로는 235자 이하여야 합니다.
다른 파일 이름 제한은 Wiki Git 리포지토리 파일 및 파일 구조, 파일 명명 규칙을 참조하세요.
페이지 제목 및 파일 이름 제한
각 위키 페이지는 wiki Git 리포지토리의 파일에 해당합니다. 페이지 파일 이름 및 파일 크기에는 다음과 같은 제한 사항이 적용됩니다.
파일 이름: 페이지 파일의 이름을 선택할 때 파일의 정규화된 경로는 235자 이하여야 합니다. 페이지의 전체 경로는 리포지토리 URL, 페이지 파일의 폴더 경로 및 페이지 파일 이름으로 구성됩니다. 예:
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.고유성: 페이지 파일 이름은 wiki 리포지토리 계층 구조의 폴더 위치 내에서 고유해야 합니다. 이름은 대/소문자를 구분합니다.
특수 문자: 페이지 파일 이름에는 다음 특수 문자에 대한 제한이 있습니다.
- 유니코드 컨트롤 문자 또는 서로게이트 문자 없음
- 인쇄할 수 있는 문자 없음: 슬래시
/, 역슬래시\, 해시# - 이름의 시작 또는 끝에 마침표
.기호가 없습니다.
파일 크기: 최대 페이지 파일 크기는 18MB입니다.
첨부 파일 크기: 페이지 파일에 대한 첨부 파일의 최대 크기는 19MB입니다.
허용되는 특수 문자
콜론 : 및 하이픈 -과 같은 여러 특수 문자가 페이지 파일 이름에 허용됩니다. 예를 들어 Markdown 파일의 이름을 FAQ:0525 또는 Setup-Guide로 지정할 수 있습니다.
중요합니다
페이지 구문 및 브라우저 탐색에서 오류를 방지하려면 페이지 파일 이름에 공백 문자( )를 사용하지 마세요. 페이지 제목에 따라 페이지 파일의 이름을 지정하는 경우 페이지 제목에 있는 공백을 파일 이름에 하이픈(-)으로 바꿉니다.
다음 표에서는 위키 페이지 파일 이름에 허용되는 특수 문자와 해당 URI로 인코딩된 문자열을 나열합니다.
| 캐릭터 | 기호 | URI 문자열 |
|---|---|---|
| 콜론 | : |
%3A |
| 왼쪽 꺾쇠 괄호 | < |
%3C |
| 오른쪽 각괄호 | > |
%3E |
| 별표 (와일드카드) | * |
%2A |
| 물음표 | ? |
%3F |
| 파이프 | | |
%7C |
| 하이픈 (이음표) (대시 (빗금)) | - |
%2D |
| 큰따옴표 | " |
22% |
예를 들어 파일 이름 FAQ:0525 는 로 인코딩됩니다 FAQ%3A0525.
위키 홈페이지 설정
기본적으로 위키를 만들 때 추가하는 첫 번째 페이지는 위키 홈페이지로 설정됩니다. 다른 페이지가 더 관련성이 높아지면 위키 홈페이지를 변경할 수 있습니다. 자세한 내용은 위키 페이지 다시 정렬 또는 이동을 참조하세요.
위키 페이지 편집 및 삭제
이 섹션에서는 위키에서 페이지를 편집하거나 삭제하는 방법을 설명합니다. 브라우저에서 Azure DevOps UI로 직접 작업하거나 Azure DevOps CLI를 사용할 수 있습니다.
브라우저에서 기존 위키 페이지를 편집하는 방법에는 여러 가지가 있습니다.
- 위키 페이지를 열고 편집을 선택합니다.
- 위키 페이지를 열고 바로 가기 키 e를 사용합니다.
- 페이지 목록에서 위키 페이지를 선택한 다음, 추가 옵션(...) > 을 선택합니다.편집합니다.
특정 편집 함수에 대한 자세한 내용은 Markdown 지침 사용을 참조 하세요.
리포지토리 내 코드 위키에서 편집
코드를 위키로 게시할 때 리포지토리 허브에서 위키 페이지를 편집할 수 있습니다. Markdown 도구 모음 서식 지정 옵션과 동일한 병렬 편집기 환경을 사용할 수 있습니다. 리포지토리에서 편집 편집> 을 선택하여 분기를 만들고 편집을 계속합니다.
리포지토리에서 편집 옵션은 분기 정책을 사용하도록 설정된 코드 위키에만 사용할 수 있습니다. 옵션이 표시되지 않으면 위키가 코드 위키가 아니거나 분기 정책이 활성화되지 않았기 때문일 수 있습니다. 자세한 내용은 분기 정책 및 설정을 참조 하세요.
브라우저에서 위키 페이지 삭제
위키 페이지를 삭제하려면 페이지 목록에서 위키 페이지를 선택한 다음 추가 옵션(...) > 을 선택합니다.삭제합니다. 페이지의 오른쪽 클릭 메뉴에서 삭제 를 선택할 수도 있습니다.
삭제를 선택한 후 대화 상자에서 삭제를 확인합니다.
참고
위키 페이지를 삭제하면 페이지에 대한 모든 메타데이터와 페이지에 연결된 모든 하위 페이지도 삭제됩니다.
위키 페이지 순서 다시 지정 또는 이동
브라우저에서 위키 트리 보기의 페이지 순서를 다시 지정하여 페이지가 원하는 순서로 표시되도록 할 수 있습니다. 기본 시퀀스는 파일 이름으로 사전순입니다. 문서, 범주 또는 의도한 대상 그룹별로 페이지 순서를 변경하도록 시퀀스를 변경할 수 있습니다.
트리 보기의 페이지 제목에서 끌어서 놓기 작업을 사용하여 다음 작업을 완료할 수 있습니다.
이동: 페이지의 페이지/하위 페이지 관계를 변경합니다. 위키 시퀀스 내에서 페이지를 이동하면 다른 위키 페이지에서 페이지로 연결되는 링크가 끊어질 수 있습니다. 페이지를 이동한 후 이러한 링크를 수동으로 수정 할 수 있습니다.
순서 변경: 위키 시퀀스 내의 페이지 순서를 변경합니다. 위키 시퀀스 내의 페이지 순서를 다시 지정해도 페이지 링크에는 영향을 주지 않습니다.
페이지 이동 후 끊어진 링크 수정
위키 시퀀스에서 페이지를 이동한 후 끊어진 링크를 수정하려면 다음 단계를 수행합니다.
위키의 다른 페이지를 테스트하고 이동된 페이지에 대한 링크를 찾습니다.
페이지에서 오류 메시지 또는 누락된 콘텐츠를 확인합니다.
끊어진 링크가 있는 페이지를 열고 편집을 선택한 다음 페이지 콘텐츠의 끊어진 링크로 이동합니다.
콘텐츠에서 끊어진 링크를 찾으려면 이동된 페이지의 이름, 이동된 페이지의 원래 파일 경로 또는 끊어진 링크에 대한 링크 텍스트를 검색할 수 있습니다.
끊어진 링크를 업데이트합니다. 일반적인 수정 사항은 링크의 URL 또는 경로를 변경하여 이동된 페이지의 새 위치를 대상으로 지정하는 것입니다.
링크가 업데이트되도록 페이지에 변경 내용을 저장합니다.
브라우저에서 업데이트된 페이지를 열고 링크를 테스트합니다. 이동된 페이지가 성공적으로 열리는지 확인합니다.
최상위 페이지 순서 변경
바로 가기 키를 사용하여 위키 시퀀스의 최상위 페이지 순서를 변경할 수 있습니다. 이 작업은 하위 페이지에는 작동하지 않습니다.
위키 페이지 목록에서 페이지를 선택하고 CTRL + 위쪽 화살표 또는 CTRL + 아래쪽 화살표 바로 가기를 사용하여 시퀀스 내에서 페이지를 이동합니다. 변경 내용은 즉시 적용됩니다.
페이지/하위 페이지 순서 변경
위키 시퀀스의 모든 페이지에 대한 페이지/하위 페이지 순서를 변경할 수도 있습니다.
위키 페이지 목록에서 이동할 페이지를 선택합니다.
기타 옵션 선택(...) >이동- 페이지 이동 대화 상자가 열립니다.
페이지 이동 대화 상자에서 새 부모 페이지로 사용할 페이지를 선택합니다.
새 부모 페이지를 선택하면 시스템에서 페이지 이동에 따라 잠재적인 끊어진 링크를 검색합니다. 조정해야 하는 링크를 보고합니다.
페이지 및 작업 항목에서 영향을 받는 링크 업데이트(권장) 옵션을 선택한 다음 이동을 선택하여 페이지 이동을 완료합니다.
전체 바로 가기 키 목록은 위키 페이지를 관리하는 바로 가기 키에서 확인하세요.