프로비저닝된 wiki와 코드 wiki로 게시된 위키

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

팀 프로젝트 위키 또는 게시된 코드 위키에서 위키 콘텐츠를 유지할 수 있습니다. 코드 위키로 게시된 경우 콘텐츠 요구 사항을 지원하기 위해 버전이 지정된 여러 위키를 유지할 수 있습니다. 이 옵션은 Azure Repos를 사용하도록 설정할 때 사용할 수 있습니다.

두 옵션 모두 Git 리포지토리에서 Wiki 콘텐츠를 유지 관리하지만 Wiki 콘텐츠를 추가, 업데이트 및 관리하는 방법은 다릅니다.

위키 콘텐츠 유지 관리

두 가지 유형의 Wiki 모두 GitHub에서 직접 작업하거나 오프라인으로 작업한 다음 변경 내용을 리포지토리에 푸시할 수 있습니다.

프로비전된 위키의 경우 리포지토리의 Wiki 페이지 섹션 내에서 직접 위키>페이지를 추가하고 유지 관리합니다. 프로비전된 위키에 대한 모든 콘텐츠 업데이트는 위키 자체 내에서 발생합니다.

코드 위키로 게시된 경우 리포지토리에서 위키 콘텐츠를 코드 파일로 추가하고 유지 관리합니다. GitHub에서 리포지토리의 Repos 또는 Code 섹션 내에 있는 파일에 액세스합니다.

다음 이미지는 프로비전된 wiki에 대한 메뉴 옵션을 보여줍니다.

일부 메뉴 옵션은 코드 위키 페이지로 게시할 수 없습니다. 코드 위키로 게시된 경우 리포지토리에서 편집 옵션이 현재 페이지를 열어 콘텐츠를 편집할 수 있습니다. 위키에 대해 선택한 분기의 페이지에 대한 업데이트가 자동으로 wiki에 게시됩니다.

위키 페이지 추가

새 페이지 및 하위 페이지 추가 메뉴 옵션은 GitHub의 두 가지 위키 유형 모두에 사용할 수 있습니다. 자세한 내용은 위키 페이지 추가 및 편집을 참조 하세요.

페이지 시퀀스 및 페이지 목록 조정

두 유형의 wiki는 모두 Git 리포지토리 내에서 동일한 폴더와 파일 구조를 적용합니다. 차이점은 페이지 시퀀스를 유지하는 방법에 있습니다.

프로비전된 Wiki의 경우 GitHub는 탐색 창 내에서 페이지를 추가하거나 이동할 때 페이지 시퀀스 및 페이지 목록을 자동으로 관리합니다.

코드 wiki로 게시된 경우 페이지 순서를 수동으로 유지 관리해야 합니다. 탐색 창에서 페이지 목록을 구성하려면 루트 및 하위 페이지가 포함된 각 하위 폴더 또는 부모 페이지에 대한 .order 파일을 정의합니다. 자세한 내용은 Wiki Git 리포지토리 파일 및 파일 구조를 참조하세요.

페이지 수정 버전 보기 및 이전 버전으로 되돌리기

Git 리포지토리에 대한 Wiki 페이지에서 위키 내의 모든 페이지의 수정 내용을 볼 수 있습니다. 수정 버전 또는 수정 버전 보기 메뉴 옵션을 사용합니다. 현재 페이지 콘텐츠를 이전 버전으로 되돌리려면 위키 페이지 유형에 따라 프로세스가 다릅니다.

프로비전된 위키 페이지의 경우 [되돌리기] 메뉴 옵션을 선택합니다. 자세한 내용은 프로비전된 위키 페이지로 커밋 되돌리기를 참조하세요.

코드 위키 페이지로 게시된 경우, 로컬 브랜치에서 작업한 후, 작업 중인 브랜치를 업데이트하기 위해 끌어오기 요청을 제출합니다.

버전 관리 사용 및 위키 게시 취소

버전 관리 지원을 사용하면 Git 리포지토리의 버전이 지정된 분기에 따라 서로 다른 콘텐츠 버전을 고유한 Wiki에 게시할 수 있습니다.

위키를 만들기 위해 코드를 게시한 사용자인 경우에만 위키의 버전을 지정하고 게시를 취소할 수 있습니다. 자세한 내용은 코드 위키 게시 취소를 참조 하세요.

프로젝트 위키 삭제

다음 단계에서는 프로젝트 wiki를 삭제하는 방법을 설명합니다.

1. 위키 리포지토리를 복제하여 모든 콘텐츠를 백업합니다. 기타 옵션 메뉴(...)에서 위키 URL을 찾을 수 있습니다.

2. Wiki와 연결된 Git 리포지토리 ID를 가져옵니다. REST API를 사용하여 프로젝트의 모든 위키를 가져올 수 있습니다.

   예를 들어 이 GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 명령은 프로젝트의 모든 wiki를 반환합니다. 명령을 실행하고 삭제할 wiki를 선택합니다.

3. REST API를 사용하여 Wiki와 연결된 Git 리포지토리를 삭제합니다. 이전에 찾은 프로젝트 wiki의 리포지토리 ID를 사용합니다. 리포지토리 ID를 다시 확인하여 잘못된 wiki를 제거하지 않도록 합니다.

   예를 들어 DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 명령은 wiki를 삭제합니다. <repositoryId>을 삭제할 wiki의 리포지토리 ID로 바꾸십시오.

오프라인 상태에서 wiki 업데이트

오프라인 또는 로컬 분기에서 작업하여 두 유형의 wiki에 대한 콘텐츠를 업데이트할 수 있습니다. 자세한 내용은 오프라인으로 위키 페이지 복제 및 업데이트를 참고하세요.

다른 기능 및 작업 살펴보기

두 가지 유형의 Wiki는 다음과 같은 몇 가지 다른 기능과 작업을 지원합니다.

• Markdown 형식
• HTML 태그
• 이미지 삽입 및 크기 조정
• 수학 표기법 및 문자
• 해시 태그가 있는 항목에 연결(#)
• 파일 첨부
• Wiki 콘텐츠 필터링
• Wiki 페이지 인쇄
• 오프라인으로 콘텐츠 업데이트
• Wiki에서 페이지 추가 또는 편집

한 가지 유형의 wiki에만 몇 가지 작업 및 기능을 사용할 수 있거나 사용 방법이 다릅니다.

관련 콘텐츠

• 팀 프로젝트에 대한 wiki 만들기
• Wiki Git 리포지토리 파일 및 파일 구조
• Wiki에 Git 리포지토리 게시