Wiki 페이지 추가 및 편집

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

위키 Git 리포지토리가 팀 프로젝트에 프로비전된페이지에 제목과 콘텐츠를 추가할 수 있습니다. 페이지를 편집하고 콘텐츠를 미리 볼 수 있는 병렬 편집 및 미리 보기 환경이 있습니다.

Markdown 형식을 사용하여 페이지를 작성하는 동안 서식 창을 사용하여 서식 있는 텍스트 서식을 지정하고 이미지, 첨부 파일 및 링크를 삽입할 수도 있습니다.

Wiki 홈페이지

페이지를 편집할 때 Ctrl+S를 입력하여 저장합니다. 사용자 지정 수정 메시지와 함께 저장하려면 저장 옆을 선택합니다. 더 많은 바로 가기 키는 위키 페이지를 관리하는 바로 가기 키를 참조 하세요.

사용자 지정 메시지와 함께 페이지 저장

Wiki 명령줄 도구

명령 설명
az devops wiki show 위키 열기
az devops wiki page show 페이지의 콘텐츠 가져오기 또는 페이지 열기
az devops wiki page create 새 페이지 추가
az devops wiki page update 페이지 편집
az devops wiki page delete 페이지 삭제

참고 항목

Git 리포지토리에서 게시한 위키에 페이지를 추가하거나 편집하려면 위키에 Git 리포지토리 게시를 참조하세요. 이 문서에서는 팀 프로젝트에 대해 프로비전한 Wiki의 페이지를 추가하고 편집하는 방법을 설명합니다.

필수 조건

  • 프로비전된 Wiki있어야 합니다.
  • 위키 페이지를 추가하거나 업데이트하려면 기여자 팀 프로젝트의 구성원이어야 합니다.
  • 프로젝트 wiki를 편집하려면 기본 액세스 수준이 있어야 합니다.

Wiki 열기

지원되는 웹 브라우저를 사용하여 프로젝트에 커넥트 Wiki를 선택합니다.

강조 표시된 Wiki 메뉴 선택을 보여 주는 스크린샷

팀 프로젝트를 전환해야 하는 경우 Azure DevOps선택하여 모든 팀 프로젝트 및 팀을 찾아봅니다.

위키 페이지 추가

다른 페이지를 추가하려면 새 페이지를 선택합니다. 또는 하위 페이지를 추가하려면 기존 페이지의 상황에 맞는 메뉴를 열고 하위 페이지 추가를 선택합니다.

235자 이하의 고유한 제목을 지정합니다. 페이지 제목은 대/소문자를 구분합니다. 다른 타이틀 제한 사항은 Wiki Git 리포지토리 파일 및 파일 구조, 파일 명명 규칙을 참조 하세요.

첫 번째 위키 페이지의 스크린샷.

또한 바로 가기 키를 사용하여 n을 눌러 새 페이지를 추가하거나 c 키를 눌러 하위 페이지를 추가할 수 있습니다. 바로 가기 키의 전체 목록은 바로 가기 키를 참조 하여 위키 페이지를 관리합니다.

Wiki 페이지 제목 명명 제한

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

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

Wiki 페이지 제목의 특수 문자

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

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

위키 페이지 편집 및 삭제

기존 위키 페이지를 편집하려면 페이지를 열고 편집을 선택하거나 상황에 맞는 메뉴를 열고 편집을 선택합니다. 바로 가기 키 e 를 사용하여 현재 페이지를 빠르게 편집할 수도 있습니다.

코드 위키의 경우 markdown 도구 모음을 사용하여 콘텐츠를 만들면 나란히 편집기에서 페이지를 편집할 수 있습니다. 이 환경은 프로젝트 Wiki의 프로세스와 동일합니다. Repos에서 편집 옵션을 사용하여 리포지토리 허브에서 위키 페이지를 편집할 수도 있습니다.

위키 편집 페이지의 스크린샷.

코드 위키에 분기 정책이 있는 경우 Repos에서 편집을 선택하여 분기를 만들고 편집을 계속합니다. 리포지토리에서 편집 옵션은 코드 위키에 특히 사용할 수 있습니다.

페이지를 삭제하려면 트리 또는 페이지 내의 상황에 맞는 메뉴를 열고 삭제를 선택합니다. 열리는 대화 상자에서 삭제를 확인합니다.

참고 항목

페이지를 삭제하면 계층 구조의 모든 메타데이터와 모든 하위 페이지(있는 경우)도 삭제됩니다.

위키 페이지 순서 다시 지정

위키 트리 보기 내에서 페이지를 순서를 다시 지정하여 페이지가 원하는 순서와 계층 구조로 표시되도록 할 수 있습니다. 트리 보기에서 페이지 제목을 끌어서 놓아 다음 작업을 수행할 수 있습니다.

  • 페이지의 부모-자식 관계를 변경합니다.
  • 계층 내에서 페이지의 순서를 변경합니다.

참고 항목

계층 구조에서 페이지를 이동하면 다른 페이지에서 페이지로 연결되는 링크가 끊어질 수 있습니다. 이동한 후에는 항상 수동으로 링크를 수정할 수 있습니다. 계층 내에서 페이지 순서를 다시 지정해도 페이지 링크에는 영향을 주지 않습니다.

바로 가기 키를 사용하여 페이지 순서를 변경할 수도 있습니다. 페이지를 선택하고 Ctrl +위쪽 화살표 또는 CTRL + 아래쪽 화살표를 눌러 페이지 주문을 변경합니다. 페이지의 부모-자식 관계를 변경하려면 해당 상황에 맞는 메뉴를 열고 이동을 선택합니다. 페이지 이동 대화 상자가 열립니다. 현재 페이지를 이동할 수 있는 부모 페이지를 선택합니다.

계층 구조에서 위키 페이지 이동

바로 가기 키의 전체 목록은 바로 가기 키를 참조 하여 위키 페이지를 관리합니다.

페이지를 위키 홈페이지로 만들기

기본적으로 위키를 만들 때 추가하는 첫 번째 페이지는 위키 홈페이지로 설정됩니다. 다른 페이지가 트리의 맨 위로 끌어서 놓아 더 관련성이 높아지면 위키 홈페이지를 변경할 수 있습니다.

다음 단계