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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Git 리포지토리에서 코드를 개발하는 것과 같은 방식으로 오프라인에서 Wiki 페이지를 업데이트할 수 있습니다.

원하는 클라이언트 또는 git 명령줄 도구를 사용하여 위키를 오프라인으로 업데이트할 수 있습니다. Git 리포지토리 및 지원되는 도구 작업에 대한 자세한 내용은 Git 리포지토리를 참조하세요.

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

  1. 위키 Git 리포지토리를 로컬 IDE 또는 작업 영역에 복제합니다.
  2. 로컬 Git 분기에 파일 또는 폴더를 추가합니다.
  3. 페이지 및 하위 페이지를 반영하도록 .order 파일을 업데이트합니다.
  4. 로컬 git 분기에 수행한 업데이트를 커밋하고 푸시합니다.

필수 조건

다음 단계를 수행하여 Markdown 페이지를 다른 위키에서 팀 프로젝트 위키 또는 코드로 게시한 콘텐츠로 위키로 마이그레이션합니다.

위키 복제

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

  1. 프로젝트(https://dev.azure.com/{Your_Organization/Your_Project})에 로그인한 다음 위키를 선택합니다.

  2. 기타 작업 상황에 맞는 메뉴를 열고 위키 복제를 선택합니다.

    Wiki Git 리포지토리 복제

  3. 복제 리포지토리 대화 상자에서 클립보드에 복제 URL 복사를 선택합니다.

    위키 URL 복사

    브라우저에 입력하여 wikiMaster 분기 아래에 정의된 파일을 봅니다.

    Wiki 기본 파일

  4. 복사한 URL을 사용하여 사용하는 IDE에서 리포지토리를 복제합니다. 다음 문서에서 자세한 내용을 참조하세요.

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

Markdown 형식을 사용하여 페이지를 작성합니다. 위키에 추가하려는 각 페이지 및 하위 페이지에 대한 Markdown 파일을 로컬 분기에 추가합니다.

페이지 추가

위키 트리의 루트에 페이지를 추가하려면 Git 리포지토리의 루트에 Markdown 파일을 추가합니다.

  1. 추가하려는 각 페이지에 대해 페이지 내용이 포함된 Markdown 파일을 만든 다음 리포지토리의 루트 폴더 아래에 추가합니다.

    CanaryBuilds 팀 프로젝트의 경우 다음 폴더에 있습니다.

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. 위키 트리의 루트에 페이지를 추가하려면 Git 리포지토리의 루트에 있는 각 페이지에 대한 Markdown 파일을 추가합니다.

    로컬 분기 wiki Git 리포지토리

  3. 루트에 추가하려는 모든 페이지를 추가한 후 루트의 .order 파일을 업데이트합니다. 루트에 정의된 각 Markdown 파일에 대해 하나의 항목이 있어야 합니다. 각 항목은 파일 제목과 대시로 바뀐 공백과 일치해야 합니다.

    예시:

     Welcome
     Roadmap  
     How-to-contribute  
     Home  
     Reference  
    

하위 페이지 추가

  1. 부모 페이지에 대한 폴더를 만든 다음 폴더의 각 하위 페이지에 대한 Markdown 파일을 추가합니다.

    예를 들어 다음 파일을 기여 방법 폴더에 추가했습니다. 이러한 하위 페이지는 위키의 기여 방법 페이지에 표시됩니다.

    하위 페이지의 스크린샷

  2. 위키에 표시되어야 하는 하위 페이지의 순서를 사용하여 폴더에 .order 파일을 추가합니다. .order 파일을 사용하여 페이지를 시퀀스하는 방법을 이해하려면 Wiki Git 리포지토리 파일 및 파일 구조를 참조하세요.

    예를 들어 파일에는 다음과 같은 하위 페이지가 있습니다.

     Request-extensions  
     Licensing  
     Smoke-test  
     Coding-guidelines  
    

변경 내용 푸시

모든 업데이트를 완료하면 파일을 Git 리포지토리로 푸시합니다.

추가된 페이지와 하위 페이지가 위키에 즉시 표시됩니다.

위키 트리 업데이트됨

프로세스에 오류가 있는 경우 페이지가 위키에 경고 기호와 함께 표시됩니다.

.order 파일이 제대로 업데이트되지 않은 경우 경고입니다.