프로비저닝된 wiki와 코드 wiki로 게시된 위키
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
팀 프로젝트 위키 또는 게시된 코드 위키에서 위키 콘텐츠를 유지할 수 있습니다. 코드 위키로 게시된 경우 Azure Repos를 사용하도록 설정한 경우에만 사용할 수 있지만 콘텐츠 요구 사항을 지원하기 위해 버전이 지정된 여러 위키를 유지할 수 있습니다.
두 옵션 모두 Git 리포지토리에서 Wiki 콘텐츠를 유지 관리하지만 Wiki 콘텐츠를 추가, 업데이트 및 관리하는 방법은 다릅니다.
참고 항목
코드 위키 기능으로 게시된 기능은 현재 Azure DevOps Server 2018 이상 버전에서 사용할 수 있습니다. 이전 버전의 경우 팀 프로젝트에 대한 wiki만 프로비전할 수 있습니다.
Wiki 페이지 메뉴 옵션
프로비전된 위키를 사용하여 위키 내에서 직접 페이지를 추가하고 편집할 수 있습니다. 프로비전된 위키에 대한 모든 콘텐츠 업데이트는 위키 내에서 발생합니다.
게시된 코드 위키를 사용하여 Repos 또는 Code의 콘텐츠를 추가, 편집 및 업데이트할 수 있습니다.
다음 이미지는 프로비전된 Wiki에 대한 옵션을 보여 있습니다. 이러한 옵션 중 일부는 코드 위키 페이지로 게시된 경우 지원되지 않습니다.
예를 들어 게시된 코드 위키에 대한 리포지토리에서 편집 옵션은 리포지토리 페이지로 이동하여 해당 특정 페이지를 편집합니다. 위키에 대해 선택한 분기의 페이지에 대한 업데이트가 위키에 자동으로 게시됩니다.
지원되는 기능 및 운영 차이점
두 가지 유형의 Wiki 모두 다음 기능을 지원합니다.
- Markdown 형식
- HTML 태그
- 이미지 삽입 및 크기 조정
- 수학 표기법 및 문자
- 를 사용하여 작업 항목에 연결 #
- 파일 첨부
- Wiki 콘텐츠 필터링
- Wiki 페이지 인쇄
- 오프라인으로 콘텐츠 업데이트
- Wiki에서 페이지 추가 또는 편집
다음 표에는 위키 유형에 따라 다를 수 있는 작업 또는 기능이 요약되어 있습니다.
| 연산 | 프로비전된 wiki | 코드 wiki로 게시됨 |
|---|---|---|
| 여러 위키 지원, 위키 이름 지정 | ✔️ | |
| Repos>파일 또는 코드>파일에서 페이지 추가 또는 편집 | ✔️ | |
| Wiki에서 이전 수정 버전으로 되돌리기 | ✔️ | |
| 리포지토리 또는 코드에서 이전 수정 버전으로 되돌리기 | ✔️ | ✔️ |
| 버전이 지정된 Wiki 유지 관리 | ✔️ | |
| 위키 버전 선택 | ✔️ | |
| 코드 위키 게시 취소 | ✔️ |
페이지 추가
두 가지 유형의 wiki 모두에 대해 새 페이지 또는 하위 페이지 추가를 선택합니다. 자세한 내용은 위키 페이지 추가 및 편집을 참조 하세요.
탐색 창의 페이지 시퀀스 및 페이지 목록
프로비전된 Wiki는 탐색 창 내에서 페이지를 추가하거나 이동할 때 페이지 시퀀스와 페이지 목록을 자동으로 관리합니다.
게시된 코드 위키에 대한 탐색 창의 페이지 목록을 구성하려면 루트 및 하위 페이지가 포함된 각 하위 폴더 또는 부모 페이지에 대해 파일을 정의 *.order* 합니다.
두 유형의 위키 모두 동일한 파일 구조를 따르며, 코드 위키로 게시된 경우 페이지 순서를 수동으로 유지 관리해야 합니다.
파일 작업에 .order 대한 자세한 내용은 Wiki Git 리포지토리 파일 및 파일 구조를 참조 하세요.
페이지 수정 버전 및 이전 버전으로 되돌리기
위키에서 위키 페이지의 수정 내용을 볼 수 있습니다. 수정 버전 또는 수정 버전 보기 메뉴 옵션을 선택합니다.
그러나 되돌리기 프로세스는 위키 페이지 유형에 따라 다릅니다.
- 프로비전된 위키 페이지의 경우 프로비전된 위키 페이지로 커밋 되돌리기에서 설명한 대로 되돌리기를 선택합니다.
- 코드 위키 페이지로 게시된 경우 로컬 분기에서 작업하고 끌어오기 요청을 제출하여 작업 중인 분기를 업데이트합니다.
Wiki 버전 관리 및 게시 취소
버전 관리를 사용하면 Git 리포지토리의 버전이 지정된 분기에 따라 서로 다른 콘텐츠 버전을 고유한 Wiki에 게시할 수 있습니다. 위키에 코드를 게시하여 위키를 만든 경우에만 위키의 버전을 지정하고 게시를 취소할 수 있습니다. 자세한 내용은 코드 위키 게시 취소를 참조 하세요.
프로젝트 위키 삭제
참고 항목
Wiki REST API는 프로젝트 위키 삭제를 지원하지 않습니다. 따라서 위키 리포지토리를 대신 삭제해야 합니다.
위키 리포지토리를 복제하여 모든 콘텐츠를 백업합니다. 기타 옵션에는 위키를 복제하는 데 사용할 수 있는 복제 위키 URL이 있습니다.
위키를 백업하는 git 리포지토리 ID를 가져옵니다. REST API를 사용하여 프로젝트의 모든 위키를 가져올 수 있습니다.
예를 들어
GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1프로젝트의 모든 Wiki를 반환하므로 삭제할 위키를 선택할 수 있습니다.REST API를 사용하여 지원 Git 리포지토리를 삭제합니다. 이전 단계에서 찾은 프로젝트 wiki의 리포지토리 ID를 사용하고 리포지토리 ID를 다시 확인하므로 잘못된 리포지토리 ID를 제거하지 않습니다.
예를 들어
DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1
오프라인으로 위키 업데이트
오프라인 또는 로컬 분기에서 작업하여 프로비전된 wiki의 콘텐츠를 업데이트하고 코드 위키로 게시할 수 있습니다. 자세한 내용은 오프라인으로 위키 페이지 복제 및 업데이트를 참조하세요.