다른 페이지를 추가하려면 새 페이지를 선택합니다. 또는 하위 페이지를 추가하려면 기존 페이지의 상황에 맞는 메뉴를 열고 하위 페이지 추가를 선택합니다.
235자 이하의 고유한 제목을 지정합니다. 페이지 제목은 대/소문자를 구분합니다. 다른 타이틀 제한 사항은 Wiki Git 리포지토리 파일 및 파일 구조, 파일 명명 규칙을 참조 하세요.
또한 바로 가기 키를 사용하여 n을 눌러 새 페이지를 추가하거나 c 키를 눌러 하위 페이지를 추가할 수 있습니다. 바로 가기 키의 전체 목록은 바로 가기 키를 참조 하여 위키 페이지를 관리합니다.
위키 페이지를 추가하려면 명령을 입력합니다 az devops wiki page create .
az devops wiki page create --path
--wiki
[--comment]
[--content]
[--encoding {ascii, utf-16be, utf-16le, utf-8}]
[--file-path]
[--project]
[--subscription]
매개 변수
--path: 필수입니다. 위키 페이지의 경로입니다.
--wiki: 필수입니다. 위키의 이름 또는 ID입니다.
--comment: 선택 사항입니다. 파일 추가 작업의 커밋 메시지 주석을 추가합니다. 기본값: Azure DevOps CLI를 사용하여 새 페이지를 추가했습니다.
--content: 선택 사항입니다. 위키 페이지의 내용입니다. 지정된 경우 --file-path 무시됩니다.
--encoding: 선택 사항입니다. 파일 인코딩 매개 변수와 함께 --file-path 사용됩니다.
허용되는 값: ascii, utf-16be, utf-16leutf-8
--file-path: 선택 사항입니다. 파일에 콘텐츠가 지정된 경우 파일 입력의 경로입니다.
--project -p: 기본값으로 구성되지 않았거나 git 구성을 통해 선택되지 않은 경우 필요합니다. 프로젝트의 이름 또는 ID입니다. az devops 구성을 사용하여 기본 프로젝트를 구성할 -d project=NAME_OR_ID수 있습니다.
참고 항목
Azure DevOps Server 2020의 경우 다음 명령을 사용하여 기본 서버 인스턴스, 컬렉션 및 프로젝트를 설정할 수 있습니다. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
예제
인라인 콘텐츠가 있는 'myprojectwiki'라는 위키에 경로가 'my page'인 새 페이지를 만듭니다.
az devops wiki page update --path 'my page' --wiki myprojectwiki --content "Hello World"
파일의 콘텐츠를 사용하여 위키에서 '내 페이지' 경로로 페이지의 콘텐츠를 업데이트합니다.
az devops wiki page update --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8
Azure DevOps CLI 명령은 Azure DevOps Server 온-프레미스에서 지원되지 않습니다.
Wiki 페이지 제목 명명 제한
각 Wiki 페이지는 Wiki Git 리포지토리 내의 파일에 해당합니다. Wiki 페이지 제목에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형
제한 사항
파일 이름
정규화된 페이지 경로는 235자를 초과할 수 없습니다.
고유성
페이지 제목은 대/소문자를 구분하며 Wiki 계층 내에서 고유해야 합니다.
특수 문자
- 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 / \ #포함하면 안됩니다. - 마침표 .로 시작하거나 끝내서는 안됩니다.
파일 크기
최대 18MB를 초과하지 않아야 합니다.
첨부 파일 크기
최대 19MB를 초과할 수 없습니다.
Wiki 페이지 제목의 특수 문자
이러한 특수 문자 : < > * ? | -중 하나 이상을 포함하는 페이지 제목을 지정할 수 있습니다. 예를 들어 Markdown 파일의 이름을 "FAQ?" 또는 "설정 가이드"로 지정할 수 있습니다. 문자에는 다음과 같은 URI로 인코딩된 문자열이 있습니다.
기존 위키 페이지를 편집하려면 페이지를 열고 편집을 선택하거나 상황에 맞는 메뉴를 열고 편집을 선택합니다. 바로 가기 키 e 를 사용하여 현재 페이지를 빠르게 편집할 수도 있습니다.
코드 위키의 경우 markdown 도구 모음을 사용하여 콘텐츠를 만들면 나란히 편집기에서 페이지를 편집할 수 있습니다. 이 환경은 프로젝트 Wiki의 프로세스와 동일합니다. Repos에서 편집 옵션을 사용하여 리포지토리 허브에서 위키 페이지를 편집할 수도 있습니다.
코드 위키에 분기 정책이 있는 경우 Repos에서 편집을 선택하여 분기를 만들고 편집을 계속합니다. 리포지토리에서 편집 옵션은 코드 위키에 특히 사용할 수 있습니다.
페이지를 삭제하려면 트리 또는 페이지 내의 상황에 맞는 메뉴를 열고 삭제를 선택합니다. 열리는 대화 상자에서 삭제를 확인합니다.
참고 항목
페이지를 삭제하면 계층 구조의 모든 메타데이터와 모든 하위 페이지(있는 경우)도 삭제됩니다.
위키 페이지 편집
위키 페이지를 편집하려면 명령을 입력합니다 az devops wiki page update .
az devops wiki page update --path
--version
--wiki
[--comment]
[--content]
[--file-path]
[--project]
[--subscription]
매개 변수
--path: 필수입니다. 위키 페이지의 경로입니다.
--version -v: 필수입니다. 편집할 파일의 버전(ETag)입니다.
--wiki: 필수입니다. 위키의 ID 이름입니다.
--comment: 선택 사항입니다. 삭제 작업의 커밋 메시지 주석을 추가합니다.
--file-path: 선택 사항입니다. 파일에 콘텐츠가 지정된 경우 파일 입력의 경로입니다.
--project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
--subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.
참고 항목
Azure DevOps Server 2020의 경우 다음 명령을 사용하여 기본 서버 인스턴스, 컬렉션 및 프로젝트를 설정할 수 있습니다. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
예제
인라인 콘텐츠로 'myprojectwiki'라는 위키의 경로 'my page'로 페이지의 콘텐츠를 업데이트합니다.
az devops wiki page update --path 'my page' --wiki myprojectwiki --content "Hello World" --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b
위키에서 '내 페이지' 경로로 페이지의 콘텐츠를 파일의 콘텐츠로 업데이트합니다.
az devops wiki page update --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8 --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b
위키 페이지 삭제
위키 페이지를 삭제하려면 명령을 입력합니다 az devops wiki page delete .
az devops wiki page delete --path
--wiki
[--comment]
[--project]
[--subscription]
[--yes]
매개 변수
--path: 필수입니다. 위키 페이지의 경로입니다.
--wiki: 필수입니다. 위키의 이름 또는 ID입니다.
--comment: 선택 사항입니다. 삭제 작업의 커밋 메시지 주석을 추가합니다.
--project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다. az devops configure -d project=NAME_OR_ID 사용하여 기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다.
--subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.
--yes -y: 선택 사항입니다. 확인을 묻는 메시지를 표시하지 않습니다.
Azure DevOps CLI 명령은 Azure DevOps Server 온-프레미스에서 지원되지 않습니다.
예시
'myprojectwiki'라는 위키에서 'my wiki' 경로가 있는 위키 페이지를 삭제합니다.
az devops wiki page delete --path 'my wiki' --wiki 'myprojectwiki'
Azure DevOps CLI 명령은 Azure DevOps Server 온-프레미스에서 지원되지 않습니다.
위키 페이지 순서 다시 지정
위키 트리 보기 내에서 페이지를 순서를 다시 지정하여 페이지가 원하는 순서와 계층 구조로 표시되도록 할 수 있습니다. 트리 보기에서 페이지 제목을 끌어서 놓아 다음 작업을 수행할 수 있습니다.
페이지의 부모-자식 관계를 변경합니다.
계층 내에서 페이지의 순서를 변경합니다.
참고 항목
계층 구조에서 페이지를 이동하면 다른 페이지에서 페이지로 연결되는 링크가 끊어질 수 있습니다. 이동한 후에는 항상 수동으로 링크를 수정할 수 있습니다. 계층 내에서 페이지 순서를 다시 지정해도 페이지 링크에는 영향을 주지 않습니다.
바로 가기 키를 사용하여 페이지 순서를 변경할 수도 있습니다. 페이지를 선택하고 Ctrl +위쪽 화살표 또는 CTRL + 아래쪽 화살표를 눌러 페이지 주문을 변경합니다.
페이지의 부모-자식 관계를 변경하려면 해당 상황에 맞는 메뉴를 열고 이동을 선택합니다. 페이지 이동 대화 상자가 열립니다. 현재 페이지를 이동할 수 있는 부모 페이지를 선택합니다.