오프라인으로 Wiki 콘텐츠 복제 및 업데이트

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

Wiki를 오프라인으로 업데이트하는 프로세스는 Git 리포지토리에서 코드를 개발하는 프로세스와 동일합니다. 기본 설정 클라이언트 및 git 명령줄 도구를 사용하여 위키 페이지를 오프라인으로 업데이트할 수 있습니다. Git 리포지토리 및 지원되는 도구 작업에 대한 자세한 내용은 Azure Repos Git 설명서를 참조하세요.

위키 콘텐츠를 오프라인으로 업데이트하는 기본 단계는 다음과 같습니다.

위키 Git 리포지토리를 로컬 IDE(대화형 개발 환경) 또는 작업 영역에 복제합니다.
로컬 Git 리포지토리 분기에 파일 또는 폴더를 추가합니다.
페이지 및 하위 페이지에 대한 시퀀스 변경 내용을 반영하도록 .order 파일을 업데이트합니다.
업데이트를 커밋하고 로컬 Git 분기에 푸시합니다.

필수 조건

범주	요구 사항
프로젝트 액세스	위키가 있는 프로젝트의 구성원입니다. 필요에 따라 프로젝트 관리자에게 액세스를 요청할 수 있습니다.
사용 권한	- 기여자 그룹의 구성원입니다. - 코드를 wiki로 게시하려면 리포지토리 사용 권한을 만듭니다 . 기본적으로 이 권한은 프로젝트 관리자 그룹멤버에 대해 설정됩니다.
액세스 수준	적어도 기본 액세스.
작업	- Wiki Git 리포지토리의 기본 구조를 이해합니다. - 프로비전된 위키와 위키로 게시된 코드의 차이점을 이해합니다.

위키 복제

위키 리포지토리는 페이지, 이미지, 첨부 파일 및 페이지 및 하위 페이지 시퀀스를 저장합니다. 시작할 위키를 복제합니다.

프로젝트(https://dev.azure.com/<Organization>/<Project>)에 로그인합니다.
위키를 선택한 다음, 추가 작업(...) > 을 선택합니다.위키 복제:
리포지토리 복제 대화 상자에서 복제 URL을 클립보드에 복사 아이콘을 선택합니다.
URL을 브라우저에 붙여넣습니다. WikiMain 분기 아래에 정의된 파일을 볼 수 있는 Git 리포지토리 페이지가 열립니다. 다음 예제에서는 CanaryBuilds 프로젝트의 Git 리포지토리에 있는 파일을 보여 줍니다.

중요하다

Git 자격 증명 생성 기능은 제거될 예정입니다. Git 복제 작업에 사용할 수 있는 모든 인증 방법에 대한 Git 인증 설명서를 검토합니다.
복사한 URL을 사용하여 원하는 IDE에서 리포지토리를 복제합니다. 자세한 내용은 다음 문서를 참조하세요.

로컬 Git 리포지토리에 페이지 추가

Git 리포지토리 페이지는 Markdown (.md) 파일로 형식이 지정됩니다. 위키에 추가하려는 각 페이지에 대해 로컬 분기에 Markdown 파일을 만듭니다. 페이지를 추가한 후 .order 파일을 업데이트하여 새 페이지를 포함하도록 페이지 순서를 조정합니다.

페이지 추가

루트(\) 폴더 및 다른 폴더에서 위키 구조의 맨 위에 페이지를 추가할 수 있습니다.

새 페이지의 콘텐츠를 사용하여 Markdown(.md) 파일을 만듭니다. 대부분의 경우 파일 이름은 페이지 제목과 일치합니다. 파일 이름에서 제목에 있는 모든 공백을 하이픈(-)으로 바꿉니다. 페이지 콘텐츠를 만드는 방법에 대한 자세한 내용은 위키 페이지 추가를 참조하세요.
루트 폴더와 같은 로컬 분기의 wiki 구조 내에서 원하는 폴더에 파일을 배치합니다. CanaryBuilds 프로젝트 예제 루트 폴더는 다음과 같습니다 C:\Users\UserName\Source\Repos\CanaryBuilds.wiki.
새 페이지 파일을 배치한 폴더에서 .order 파일을 업데이트합니다. 페이지의 항목 텍스트는 Markdown 확장명(.md)이 없는 파일 이름입니다. CanaryBuilds 프로젝트 예제에서는 새 페이지 "기여 방법" How-to-contribute에 해당하는 페이지를 추가합니다.
```
Welcome
Roadmap  
How-to-contribute  
Home  
Reference  
```
.order 파일에 대한 자세한 내용은 페이지 시퀀스 및 .order 파일을 참조하세요.

하위 페이지 추가

위키에서 페이지에 대한 하위 페이지를 만들 수도 있습니다.

부모 페이지로 사용할 폴더를 만듭니다. 자세한 내용은 리포지토리 파일 및 폴더 구조를 참조하세요.
각 하위 페이지에 대한 Markdown 파일을 만들고 상위 페이지 폴더에 파일을 배치합니다. CanaryBuilds 프로젝트 예제에서는 기여 방법 폴더를 부모 페이지로 추가합니다.
상위 페이지 폴더에 .order 파일을 만들어 하위 페이지에 대한 시퀀스를 위키에 표시할 순서를 정의합니다. 이 예제에서는 가능한 하위 페이지 순서를 보여 줍니다.
```
Request-extensions  
Licensing  
Smoke-test  
Coding-guidelines  
```