Wiki에 Git 리포지토리 게시

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

Git 리포지토리에서 이미 유지 관리하는 콘텐츠를 Azure DevOps Wiki에 게시할 수 있습니다. 리포지토리에는 SDK(소프트웨어 개발 키트), 제품 설명서, 추가 정보 콘텐츠 등에 대한 파일이 포함될 수 있습니다. 단일 팀 프로젝트에 대해 여러 위키를 게시할 수도 있습니다.

Markdown(.md) 파일을 Wiki에 게시하면 다음과 같은 몇 가지 이점이 있습니다.

• 콘텐츠를 관리되는 페이지 시퀀스 구조로 구성
• 목차 찾아보기 및 필터링
• 콘텐츠의 새 버전 게시
• 코드 베이스를 관리하는 것과 동일한 방식으로 콘텐츠 관리
• 위키 검색 기능을 사용하여 쉽게 위키 검색

자세한 내용은 설정된 위키와 위키로 게시된 코드를 참조하세요.

이 문서에서는 Azure DevOps 웹 포털 및 Azure DevOps CLI를 사용하여 Wiki에 게시된 콘텐츠를 추가하고 편집하는 방법을 설명합니다. 또한 Git 리포지토리 내에서 코드에서 공동 작업하는 것과 동일한 방식으로 오프라인으로 작업하고 위키 콘텐츠를 업데이트할 수 있습니다. 자세한 내용은 오프라인으로 위키 페이지 업데이트를 참조하세요.

필수 조건

Wiki 열기

지원되는 웹 브라우저를 사용하여 Azure DevOps 프로젝트에 연결하고 Wiki를 선택합니다.

팀 프로젝트를 전환해야 하는 경우 Azure DevOps를 선택하여 모든 팀 프로젝트와 팀을 찾아봅니다.

Wiki에 Git 리포지토리 게시

이 섹션에서는 Git 리포지토리를 Wiki에 게시하는 방법을 설명합니다. 브라우저에서 Azure DevOps UI로 직접 작업하거나 Azure DevOps CLI를 사용할 수 있습니다.

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {projectwiki, codewiki}]
                      [--version]

az devops wiki create --name "My Code Wiki" --type codewiki --repository MyCodeRepo --mapped-path /wikis --version main --output table

ID                                     Name            Type
------------------------------------   -------------   --------
0000aaaa-1b1b-2c2c-3d3d-444444eeeeee   My Code Wiki    codewiki

페이지 편집, 이름 바꾸기 또는 삭제

Azure DevOps 웹 포털에서 위키 페이지를 편집, 이름 바꾸기 또는 삭제할 수 있습니다.

1. 프로젝트에서 Repos>파일 또는 코드 > 파일을 선택하세요.

2. 파일 목록에서 작업할 페이지를 선택합니다.

3. 파일에 대한 추가 옵션을 선택한 다음 작업을 선택합니다.

   

다음 섹션에서는 작업을 더 자세히 완료하는 방법을 설명합니다.

페이지 편집

파일을 편집할 때 링크를 사용하여 변경 내용을 미리 보거나 이전 버전의 변경 내용을 강조 표시합니다.

• 변경 내용을 취소하려면 취소를 선택합니다. 지원되는 Markdown 기능에 대한 자세한 내용은 Markdown 사용에 대한 구문 지침을 참조하세요.

• 완료되면 업데이트에 대한 메모를 추가하고 커밋을 선택합니다.

  

  시스템에서 끌어오기 요청을 만들 수 있는 링크가 자동으로 표시됩니다. 위키 분기를 직접 편집할 때 이 메시지를 무시할 수 있습니다.

  

페이지 이름 바꾸기

위키 TOC에 표시하려는 모든 페이지는 Markdown(.md) 파일 형식을 사용해야 합니다. 이름 바꾸기 작업을 사용하여 파일 확장명 변경을 포함하여 파일 이름을 바꿀 수 있습니다.

다음 예제에서는 new-home-page.md 파일의 이름을 New-Home-Page.md. 위키 TOC에 "새 홈페이지"라는 레이블이 있는 해당 페이지가 표시됩니다.

페이지 제목은 대/소문자를 구분하며 폴더 내에서 고유해야 합니다. 제목은 235자 이하여야 합니다. 자세한 내용은 페이지 제목 명명 제한을 참조하세요.

페이지 삭제

위키에 표시하지 않으려는 Markdown 파일은 게시된 폴더에서 삭제할 수 있습니다. .order 파일에 파일을 포함하는 경우 .order 파일에서 해당 페이지 항목을 삭제합니다. 자세한 내용은 페이지 순서 변경, .order 파일 추가 또는 업데이트를 참조 하세요.

페이지 또는 여러 페이지 추가

게시된 위키에 페이지를 추가할 수 있는 방법에는 여러 가지가 있습니다.

• wiki 루트 폴더 또는 하위 폴더에 파일 추가
• 위키 루트 폴더 또는 하위 폴더에 파일 업로드
• 위키 TOC에서 페이지 시퀀스를 지정하기 위해 .order 파일을 추가하거나 업데이트합니다.

각 업데이트에 대해 변경 내용을 위키 리포지토리에 커밋해야 합니다. 그런 다음, 게시된 리포지토리에 대한 wiki를 새로 고쳐 변경 내용을 검토합니다.

웹 포털에서 페이지 추가

게시된 Wiki에 페이지를 추가하려면 다음 단계를 수행합니다.

1. Azure DevOps 웹 포털에서 게시된 리포지토리에 대한 Repos>파일 또는 코드>파일 로 이동합니다.

2. 리포지토리에 대한 추가 옵션을 선택한 다음, 새>파일을 선택합니다.

   

3. 대화 상자에서 Markdown(.md) 파일 형식을 포함하는 새 파일의 이름을 입력합니다.

   파일 이름은 위키 TOC에 표시하려는 페이지 제목에 해당해야 합니다. 페이지 제목에 있는 공백을 파일 이름의 하이픈(-)으로 바꿉니다. 페이지 제목은 대/소문자를 구분하며 폴더 내에서 고유해야 합니다. 제목은 235자 이하여야 합니다. 자세한 내용은 페이지 제목 명명 제한을 참조하세요.

   다음 예제에서는 페이지 제목이 "Page 4"인 위키 TOC에 표시되는 Page-4.md 파일을 추가합니다.

   

   선택하고생성합니다.

4. 페이지가 파일 목록에 나타나면 페이지를 선택한 다음 편집을 선택합니다. 페이지의 내용을 입력합니다. 자세한 내용은 Markdown 파일, 위젯, 위키 및 끌어오기 요청 주석에 대한 구문 지침을 참조하세요.

5. 완료되면 커밋을 선택하여 게시된 리포지토리에 새 페이지를 추가합니다.

폴더에 파일 업로드

게시된 wiki의 폴더에 파일을 업로드할 수도 있습니다. 이 옵션은 추가하려는 기존 콘텐츠가 있는 경우에 유용합니다.

1. Azure DevOps 웹 포털에서 게시된 리포지토리에 대한 Repos>파일 또는 코드>파일 로 이동합니다.

2. 리포지토리에 대한 추가 옵션을 선택한 다음 파일 업로드를 선택합니다.

   

3. 커밋 대화 상자에서 업로드할 폴더 및 파일을 선택합니다.

   

4. 완료되면 커밋을 선택하여 게시된 리포지토리에 파일을 업로드합니다.

하위 페이지가 있는 페이지 추가

위키의 페이지에 하위 페이지가 있도록 하려면 이름이 같은 Markdown 파일과 폴더가 필요합니다. 파일과 폴더는 동일한 wiki 폴더에 있어야 합니다.

1. 웹 포털에서 페이지 추가의 단계에 따라 새 Markdown 파일을 만듭니다.

2. 해당 폴더를 만들려면 리포지토리에 대한 추가 옵션을선택한 다음새>를 선택합니다.

3. 새 폴더 대화 상자에서 Markdown 파일 이름과 동일해야 하는 폴더 이름을 입력합니다.

   

   선택하고생성합니다.

4. 위키 파일 목록에서 새 폴더를 선택합니다. 하나 이상의 파일을 폴더에 하위 페이지로 추가합니다.

.order 파일 추가 또는 업데이트

게시된 리포지토리에 파일 또는 폴더를 추가한 후 마지막 단계는 새 폴더 또는 업데이트된 폴더에 대한 .order 파일을 추가하거나 업데이트하는 것입니다. 새 파일 및 폴더가 예상대로 wiki TOC에 표시되도록 페이지 순서를 업데이트합니다.

자세한 내용은 페이지 순서 변경, .order 파일 추가 또는 업데이트를 참조하세요. .order 파일에 나열되지 않은 파일은 페이지 시퀀스의 사전순 목록 끝에 추가됩니다.

.order 파일을 사용하여 페이지 순서 변경

wiki 루트의 .order 파일은 루트 수준의 페이지에 대한 표시 시퀀스를 지정합니다. 이 파일은 시작, 지원, rel-2025 등 폴더의 Markdown 파일에 해당하는 페이지 이름의 일반 텍스트 목록입니다. 위키 내의 각 폴더에는 해당 폴더의 페이지 순서를 정의하는 .order 파일도 있습니다.

폴더에 대한 주문 시퀀스 파일을 설정하려면 다음 단계를 수행합니다.

1. 코드 > 파일 페이지에서 새 파일을 선택합니다. 파일 이름을 .order로 지정합니다.

2. 파일 내용을 편집하여 폴더의 Markdown 파일에 대한 표시 순서를 정의합니다.

   위키 사용자에게 표시하려는 폴더의 각 페이지 파일에 해당하는 항목을 추가합니다.

   페이지 제목은 대/소문자를 구분합니다. 항목 텍스트는 파일 이름에 사용되는 페이지 제목 및 대/소문자와 일치해야 하지만 Markdown(.md) 파일 형식은 포함하지 않습니다.

다음 예제에서는 5개의 파일이 있는 폴더에 대한 .order 파일을 보여줍니다.

readme-version-9
Project-Overview
Get-Started
Submit-a-pull-request
team-contacts

위키 홈페이지 설정

Azure DevOps 웹 포털에서 Wiki 를 선택하면 위키의 홈페이지가 열립니다.

기본적으로 위키를 만들 때 추가하는 첫 번째 페이지는 위키 홈페이지로 설정됩니다. 위키에 여러 페이지가 있는 경우 사전순의 첫 번째 파일이 홈페이지로 설정됩니다.

위키 루트의 .order 파일에서 페이지 시퀀스를 설정하여 홈페이지로 사용할 페이지를 지정할 수 있습니다. 루트 .order 파일의 맨 위 줄에 홈 페이지 이름을 배치합니다.

Wiki-Welcome
Project-Overview
Get-Started
Submit-a-pull-request
team-contacts
readme-version-9

폴더를 위키 페이지로 승격

리포지토리의 폴더를 위키의 페이지로 표시할 수 있습니다. 이 프로세스를 페이지로 폴더 를 승격하는 것으로 알려져 있습니다.

이 시나리오에서는 다음 구성이 필요합니다.

• 폴더와 이름이 같은 Wiki의 Markdown(.md) 파일입니다.

• Markdown 파일과 폴더는 위키 파일 목록에서 동일한 위치에 나란히 있어야 합니다.

다음 예제에서는 이름이 Test인 폴더와 Markdown(.md) 파일을 보여 줍니다. 동일한 위치에 이름이 같은 피어가 있으면 위키 시퀀스에서 이름이 같은 페이지가 만들어집니다.

위키 버전 선택

위키에 게시된 버전이 여러 개인 경우 최신 버전이 기본적으로 표시됩니다.

분기 드롭다운 목록을 확장하고 표시할 버전을 선택하여 다른 Wiki 버전을 선택할 수 있습니다.

코드 위키 게시 취소

Git 리포지토리를 위키로 더 이상 게시하지 않으려면 위키를 게시 취소할 수 있습니다.

1. 위키 목록에서 게시 취소할 위키를 선택하고 추가 옵션(...) > 을 선택합니다.위키 게시 취소:

   

   게시 취소 작업을 선택하면 확인을 위한 대화 상자가 열립니다.

2. 확인 대화 상자에서 게시 취소를 선택합니다.

   

관련 콘텐츠

• 프로비전된 위키와 게시된 wiki 비교
• 오프라인으로 wiki 업데이트
• Wiki 마크다운 지침