다음을 통해 공유


Wiki 파일 및 파일 구조

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

프로젝트 위키 및 코드 위키의 파일 및 파일 구조에 대해 알아봅니다. 다음 지침에서는 코드 위키를 지정할 수 있지만 두 가지 유형의 wiki에 모두 적용됩니다.

팀 프로젝트를 만들 때 위키는 기본적으로 만들어지지 않습니다. 자세한 내용은 위키 만들기, 추가 정보 만들기 또는 프로비전된 위키와 게시된 코드를 위키로 참조하세요.

각 코드 Wiki는 백 엔드의 Git 리포지토리에 의해 구동됩니다. 이 리포지토리는 Markdown 페이지, 이미지, 첨부 파일 및 페이지 및 하위 페이지 시퀀스를 저장합니다. Azure DevOps 사용자 인터페이스를 통해 위키를 만든 다음 Git 리포지토리 URL 경로를 통해 위키를 편집할 수 있습니다. 코드 위키 게시에 대한 자세한 내용은 Wiki에 Git 리포지토리 게시를 참조하세요.

Wiki 파일 및 폴더 구조

팀 프로젝트 wiki Git 리포지토리에는 다음 레이블이 할당됩니다.

  • 팀 프로젝트에 대한 Wiki 리포지토리: ProjectName.wiki
  • 주 분기: wikiMain

wikiMain 분기에서 분기 정책을 정의하여 다른 Git 리포지토리를 관리하는 것과 동일한 방식으로 wiki 리포지토리를 관리합니다. 그러나 정책을 정의하지 않고 로컬 wikiMain 분기를 변경하고 원격 분기에 직접 푸시할 수 있습니다.

위키 리포지토리에는 다음과 같은 파일과 폴더가 있습니다.

  • 루트 수준에서 입력한 각 Markdown 페이지의 파일
  • 루트 및 각 폴더 아래에 레이블이 지정된 .order 파일
  • 하위 페이지가 있는 각 페이지의 폴더
  • .attachments 폴더, 위키의 모든 첨부 파일 저장

파일 명명 규칙

각 파일에는 페이지 제목에 공백 대신 하이픈을 사용해야 합니다. 예를 들어 페이지 제목을 기여 하는 방법은 파일 이름에 How-to-contribute.md 해당합니다. 페이지 이름이 URL에 추가되어 시간이 지남에 따라 Wiki가 변경되더라도 공유한 링크가 그대로 유지되도록 합니다.

각 Wiki 페이지는 Wiki Git 리포지토리 내의 파일에 해당합니다. Wiki 페이지 제목에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.

제한 유형 제한 사항
파일 이름 정규화된 페이지 경로는 235자를 초과할 수 없습니다.
고유성 페이지 제목은 대/소문자를 구분하며 Wiki 계층 내에서 고유해야 합니다.
특수 문자 - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다.
- 다음 인쇄 가능한 문자를 / \ #포함하면 안됩니다.
- 마침표 .로 시작하거나 끝내서는 안됩니다.
파일 크기 최대 18MB를 초과하지 않아야 합니다.
첨부 파일 크기 최대 19MB를 초과할 수 없습니다.

Wiki 페이지 제목의 특수 문자

이러한 특수 문자 : < > * ? | -중 하나 이상을 포함하는 페이지 제목을 지정할 수 있습니다. 예를 들어 Markdown 파일의 이름을 "FAQ?" 또는 "설정 가이드"로 지정할 수 있습니다. 문자에는 다음과 같은 URI로 인코딩된 문자열이 있습니다.

캐릭터 인코딩된 문자열
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" 22%

.order 파일

.order 파일은 위키 내의 페이지 시퀀스를 정의합니다. 다음 시각적 개체는 위키 TOC의 예를 보여 하며 해당 .order 파일입니다.

Wiki TOC .order 파일
wiki TOC 예제의 스크린샷. Wiki 예제 주문 파일의 스크린샷.

기본 계층은 사전순이지만 .order 파일에서 이 계층을 변경할 수 있습니다. 위키 페이지를 다시 정렬하는 방법에 대한 자세한 내용은 위키 페이지 추가 및 편집, 위키 페이지 다시 정렬을 참조 하세요.

사전순 정렬에 되돌리기 .order 파일을 삭제합니다.

.order 파일이 없으면 페이지가 사전순으로 정렬됩니다. 사전순 정렬을 되돌리기 다음 단계를 수행합니다.

  1. Wiki의 복제 URL을 복사하고 브라우저에서 엽니다. 이렇게 하면 위키를 백업하는 Git 리포지토리(파일 허브)가 열립니다.
  2. .order 파일로 이동하여 삭제합니다. 예를 들어 아티클의 끌어서 놓기 작업에서 삭제 후 파일이 자동으로 만들어집니다(다시).