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 파일 |
|---|---|
|
|
기본 계층은 사전순이지만 .order 파일에서 이 계층을 변경할 수 있습니다. 위키 페이지를 다시 정렬하는 방법에 대한 자세한 내용은 위키 페이지 추가 및 편집, 위키 페이지 다시 정렬을 참조 하세요.
사전순 정렬에 되돌리기 .order 파일을 삭제합니다.
.order 파일이 없으면 페이지가 사전순으로 정렬됩니다. 사전순 정렬을 되돌리기 다음 단계를 수행합니다.
- Wiki의 복제 URL을 복사하고 브라우저에서 엽니다. 이렇게 하면 위키를 백업하는 Git 리포지토리(파일 허브)가 열립니다.
- .order 파일로 이동하여 삭제합니다. 예를 들어 아티클의 끌어서 놓기 작업에서 삭제 후 파일이 자동으로 만들어집니다(다시).