Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
이 문서에서는 코드로 게시된 프로비전된 위키 및 위키의 파일 및 폴더 구조에 대해 설명합니다. 두 가지 유형의 wiki 모두 파일이 Git 리포지토리에 저장됩니다. 파일에는 Markdown 페이지, 코드, 이미지, 첨부 파일 또는 기타 아티팩트가 포함될 수 있습니다. 파일의 프레젠테이션 시퀀스를 설정하기 위해 Git은 각 리포지토리 폴더에 특수 파일(.order)을 추가합니다.
프로젝트를 만들 때 Wiki는 기본적으로 만들어지지 않습니다. 위키를 프로비전하거나, 추가 정보 만들기를 만들거나, 프로젝트 코드를 위키로 게시할 수 있습니다.
Azure DevOps 사용자 인터페이스를 사용하여 Wiki를 만듭니다. 그런 다음 Git 리포지토리 URL 경로에서 wiki를 편집할 수 있습니다.
리포지토리 파일 및 폴더 구조
위키의 Git 리포지토리에는 두 가지 명명 규칙이 있습니다.
- 위키 리포지토리 이름은
<ProjectName>.wiki<ProjectName>프로젝트의 이름입니다. - wiki 리포지토리의 루트 분기 이름은
wikiMain입니다.
Wiki 리포지토리를 wikiMain 브랜치에 대한 정책을 정의하여 다른 Git 리포지토리와 동일한 방식으로 관리합니다. 정책을 정의하지 않고 로컬 wikiMain 분기를 변경하고 원격 분기에 직접 푸시할 수도 있습니다.
Wiki 리포지토리는 다음 파일 및 폴더로 구성됩니다.
- 루트 수준에 있는 각 Markdown 페이지에 대한 파일
- 루트 수준 및 각 하위 폴더 내에 있는 .order 라는 파일
- 하위 페이지가 있는 각 Wiki 페이지의 하위 폴더
- wiki에 사용된 모든 첨부 파일을 저장할 .attachments 라는 폴더
파일 명명 규칙
각 위키 페이지의 파일 이름은 위키 페이지 제목에 해당합니다. 파일 이름에서 하이픈(-)은 페이지 제목의 공백을 나타냅니다. 예를 들어 페이지 제목 "기여 방법"은 파일 이름 How-to-contribute.md 해당합니다. 위키 페이지의 URL 경로에는 파일 이름이 포함됩니다. 예: https://github.com/ExampleWiki/How-To/How-to-contribute.md. 이 방법을 사용하면 시간이 지남에 따라 위키가 변경됨에 따라 페이지에 대한 책갈피 링크가 그대로 유지됩니다.
각 위키 페이지는 wiki Git 리포지토리의 파일에 해당합니다. 페이지 파일 이름 및 파일 크기에는 다음과 같은 제한 사항이 적용됩니다.
파일 이름: 페이지 파일의 이름을 선택할 때 파일의 정규화된 경로는 235자 이하여야 합니다. 페이지의 전체 경로는 리포지토리 URL, 페이지 파일의 폴더 경로 및 페이지 파일 이름으로 구성됩니다. 예:
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.고유성: 페이지 파일 이름은 wiki 리포지토리 계층 구조의 폴더 위치 내에서 고유해야 합니다. 이름은 대/소문자를 구분합니다.
특수 문자: 페이지 파일 이름에는 다음 특수 문자에 대한 제한이 있습니다.
- 유니코드 컨트롤 문자 또는 서로게이트 문자 없음
- 인쇄할 수 있는 문자 없음: 슬래시
/, 역슬래시\, 해시# - 이름의 시작 또는 끝에 마침표
.기호가 없습니다.
파일 크기: 최대 페이지 파일 크기는 18MB입니다.
첨부 파일 크기: 페이지 파일에 대한 첨부 파일의 최대 크기는 19MB입니다.
허용되는 특수 문자
콜론 : 및 하이픈 -과 같은 여러 특수 문자가 페이지 파일 이름에 허용됩니다. 예를 들어 Markdown 파일의 이름을 FAQ:0525 또는 Setup-Guide로 지정할 수 있습니다.
중요합니다
페이지 구문 및 브라우저 탐색에서 오류를 방지하려면 페이지 파일 이름에 공백 문자( )를 사용하지 마세요. 페이지 제목에 따라 페이지 파일의 이름을 지정하는 경우 페이지 제목에 있는 공백을 파일 이름에 하이픈(-)으로 바꿉니다.
다음 표에서는 위키 페이지 파일 이름에 허용되는 특수 문자와 해당 URI로 인코딩된 문자열을 나열합니다.
| 캐릭터 | 기호 | URI 문자열 |
|---|---|---|
| 콜론 | : |
%3A |
| 왼쪽 꺾쇠 괄호 | < |
%3C |
| 오른쪽 각괄호 | > |
%3E |
| 별표 (와일드카드) | * |
%2A |
| 물음표 | ? |
%3F |
| 파이프 | | |
%7C |
| 하이픈 (이음표) (대시 (빗금)) | - |
%2D |
| 큰따옴표 | " |
22% |
예를 들어 파일 이름 FAQ:0525 는 로 인코딩됩니다 FAQ%3A0525.
페이지 시퀀스 및 .order 파일
.order 파일은 위키 페이지 시퀀스를 정의합니다. Git은 각 폴더에서 이 파일을 찾아 해당 위치에 파일을 표시할 시퀀스를 식별합니다. 기본 페이지 시퀀스는 파일 이름별 사전순(A~Z)입니다.
중요합니다
부모 폴더에 하위 폴더만 포함되고 자체 파일이 없는 경우 하위 폴더에 markdown 파일이 포함되어 있더라도 위키는 부모 폴더를 빈 폴더로 표시합니다. 하위 폴더 내에서 markdown 파일을 표시하려면 항상 하나 이상의 파일(예: .order 파일 또는 콘텐츠가 있는 다른 파일)을 부모 폴더에 배치합니다.
|- parent-folder
|-- sub-folder1
| |-- file1.md
| |-- file2.md
|-- sub-folder2
| |-- file3.md
| |-- file4.md
|-- .order
사용자 지정 페이지 시퀀스 정의
폴더에 .order 파일이 없는 경우 Git은 기본 사전순 시퀀스를 사용합니다.
루트 수준을 포함하여 폴더의 .order 파일을 업데이트하여 모든 폴더에 대한 사용자 지정 시퀀스를 정의할 수 있습니다.
다음 시각적 개체는 TOC(Wiki 목차) 및 TOC를 만드는 해당 .order 파일의 예를 보여 줍니다.
웹 브라우저에 Wiki TOC 표시
.order 파일은 TOC 페이지 시퀀스를 정의합니다.
.order 파일은 순서를 사전순에서 "마케팅"과 "Fabrikam 파이버" 순으로 변경합니다.
위키 페이지를 다시 정렬하는 방법에 대한 자세한 내용은 위키 페이지 추가, 편집 및 다시 정렬을 참조하세요.
알파벳순 복원
폴더에 사용자 지정 시퀀스가 있는 경우 다음 단계에 따라 정렬 메서드를 사전순으로 되돌릴 수 있습니다.
Wiki의 복제 URL을 복사하고 브라우저에서 엽니다. 위키에 대한 Git 리포지토리가 열립니다.
파일을 되돌리고 삭제하려는 .order 파일로 이동합니다. 파일이 삭제되면 Git은 해당 위치에 대한 새 .order 파일을 자동으로 만듭니다. 새 파일은 기본 시퀀스를 사용합니다.