Wiki 페이지 추가 및 편집
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
위키 Git 리포지토리가 팀 프로젝트에 프로비전된 후 페이지에 제목과 콘텐츠를 추가할 수 있습니다. 페이지를 편집하고 콘텐츠를 미리 볼 수 있는 병렬 편집 및 미리 보기 환경이 있습니다.
Markdown 형식을 사용하여 페이지를 작성하는 동안 서식 창을 사용하여 서식 있는 텍스트 서식을 지정하고 이미지, 첨부 파일 및 링크를 삽입할 수도 있습니다.
페이지를 편집할 때 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를 선택합니다.
팀 프로젝트를 전환해야 하는 경우 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 지침 사용을 참조 하세요.
코드 위키의 경우 markdown 도구 모음을 사용하여 콘텐츠를 만들면 나란히 편집기에서 페이지를 편집할 수 있습니다. 이 환경은 프로젝트 Wiki의 프로세스와 동일합니다. Repos에서 편집 옵션을 사용하여 리포지토리 허브에서 위키 페이지를 편집할 수도 있습니다.
리포지토리에서 편집을 선택하여 분기를 만들고 편집을 계속합니다. 리포지토리에서 편집 단추는 분기 정책을 사용하도록 설정된 코드 위키에만 사용할 수 있습니다. 단추가 표시되지 않으면 위키가 코드 위키가 아니거나 분기 정책이 활성화되지 않았기 때문일 수 있습니다. 분기 정책에 대한 자세한 내용은 분기 정책 및 설정을 참조 하세요.
페이지를 삭제하려면 트리 또는 페이지 내의 상황에 맞는 메뉴를 열고 삭제를 선택합니다. 열리는 대화 상자에서 삭제를 확인합니다.
참고 항목
위키 페이지를 삭제하면 모든 메타데이터와 해당 계층 내의 하위 페이지도 삭제됩니다.
위키 페이지 순서 다시 지정
위키 트리 보기 내에서 페이지를 순서를 다시 지정하여 페이지가 원하는 순서와 계층 구조로 표시되도록 할 수 있습니다. 트리 보기에서 페이지 제목을 끌어서 놓아 다음 작업을 수행할 수 있습니다.
- 페이지의 부모-자식 관계를 변경합니다.
- 계층 내에서 페이지의 순서를 변경합니다.
참고 항목
계층 구조에서 페이지를 이동하면 다른 페이지의 링크가 끊어질 수 있습니다. 페이지를 이동한 후 이러한 링크를 수동으로 수정할 수 있습니다. 계층 내에서 페이지 순서를 다시 지정해도 페이지 링크에는 영향을 주지 않습니다.
페이지를 이동한 후 끊어진 링크를 수동으로 수정
계층 구조에서 페이지를 이동한 후 끊어진 링크를 수동으로 수정하려면 다음 단계를 수행합니다.
- 끊어진 링크를 식별합니다.
- 원래 이동한 페이지에 연결된 페이지로 이동합니다.
- 오류 또는 누락된 콘텐츠로 나타날 수 있는 끊어진 링크를 찾습니다.
- 링크 페이지 편집: 편집 모드에서 끊어진 링크가 있는 페이지를 엽니다.
- 링크를 업데이트합니다.
- 콘텐츠에서 끊어진 링크를 찾습니다.
- 이동된 페이지의 새 위치를 가리키도록 링크를 업데이트합니다. 일반적으로 링크의 URL 또는 경로 변경이 포함됩니다.
- 변경 내용 저장: 페이지에 변경 내용을 저장하여 업데이트된 링크를 적용합니다.
- 수정 사항 확인: 업데이트된 링크로 이동하여 이동한 페이지를 올바르게 가리키도록 합니다.
예시
페이지를 /docs/old-path/page.md /docs/new-path/page.md이동한 경우 다음 단계를 수행합니다.
- 콘텐츠에서 끊어진 링크를 찾습니다(예:
Link to Page.). - 새 경로
Link to Page에 대한 링크를 편집합니다. - 변경 내용을 저장하고 이제 링크가 새 위치를 올바르게 가리키는지 확인합니다.
바로 가기 키를 사용하여 페이지 순서 다시 지정
바로 가기 키를 사용하여 페이지 순서를 변경할 수도 있습니다. 페이지를 선택하고 Ctrl +위쪽 화살표 또는 CTRL + 아래쪽 화살표를 눌러 페이지 주문을 변경합니다. 페이지의 부모-자식 관계를 변경하려면 해당 상황에 맞는 메뉴를 열고 이동을 선택합니다. 페이지 이동 대화 상자가 열립니다. 현재 페이지를 이동할 수 있는 부모 페이지를 선택합니다.
바로 가기 키의 전체 목록은 바로 가기 키를 참조 하여 위키 페이지를 관리합니다.
페이지를 위키 홈페이지로 만들기
기본적으로 위키를 만들 때 추가하는 첫 번째 페이지는 위키 홈페이지로 설정됩니다. 다른 페이지가 트리의 맨 위로 끌어서 놓아 더 관련성이 높아지면 위키 홈페이지를 변경할 수 있습니다.