Wiki 페이지 추가 또는 편집

GitHub에서 직접 wiki 페이지를 추가 및 편집하거나 명령줄을 사용하여 로컬로 편집할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Wiki는 조직의 GitHub Free 및 GitHub Free이(가) 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud 및 GitHub Enterprise Server의 퍼블릭 리포지토리 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 “GitHub의 플랜”를 참조하세요.

이 문서의 내용

위키 페이지 추가

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 Wiki를 클릭합니다.

    리포지토리 메뉴의 스크린샷. "Wiki" 옵션이 진한 주황색으로 표시됩니다.

  3. 페이지의 오른쪽 상단 모서리에서 새 페이지를 클릭합니다.

  4. 필요에 따라 Markdown 이외의 형식으로 작성하려면 편집 모드 드롭다운 메뉴를 사용하여 다른 형식을 선택합니다.

    ‘새 페이지 만들기’ 스크린샷 ‘편집 모드’ 드롭다운은 진한 주황색 윤곽선입니다.

  5. 텍스트 편집기를 사용하여 페이지의 콘텐츠를 추가합니다.

  6. ‘메시지 편집’ 필드에서, 추가하려는 새 파일을 설명하는 커밋 메시지를 입력하세요.

  7. Wiki에 변경 내용을 커밋하려면 페이지 저장을 클릭합니다.

Wiki 페이지 편집

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 Wiki를 클릭합니다.

    리포지토리 메뉴의 스크린샷. "Wiki" 옵션이 진한 주황색으로 표시됩니다.

  3. Wiki 사이드바를 사용하여 변경할 페이지로 이동하세요. 페이지의 오른쪽 상단 모서리에서 편집을 클릭합니다.

  4. 텍스트 편집기를 사용하여 페이지의 콘텐츠를 편집합니다.

  5. ‘메시지 편집’ 필드에서, 추가하려는 새 파일을 설명하는 커밋 메시지를 입력하세요.

  6. Wiki에 변경 내용을 커밋하려면 페이지 저장을 클릭합니다.

로컬로 Wiki 페이지 추가 또는 편집

Wiki는 Git 리포지토리의 일부이므로 로컬에서 변경하고 Git 워크플로를 사용하여 리포지토리에 푸시할 수 있습니다.

컴퓨터에 Wiki 복제

모든 Wiki는 해당 콘텐츠를 컴퓨터에 쉽게 복제할 수 있는 방법을 제공합니다. GitHub에 초기 페이지를 만든 후에는 제공된 URL을 사용하여 리포지토리를 컴퓨터에 복제할 수 있습니다.

$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.wiki.git
# Clones the wiki locally

Wiki를 복제한 후에는 새 파일 추가 및 기존 파일 편집, 변경 내용 커밋이 가능합니다. 사용자와 협력자는 Wiki에서 작업할 때 분기를 만들 수 있지만 기본 분기에 푸시된 변경 사항만 실시간으로 만들어 읽기 권한자가 사용할 수 있게 합니다.

Wiki 파일 이름 정보

파일 이름은 Wiki 페이지의 제목을 결정하며 파일 확장명은 Wiki 콘텐츠가 렌더링되는 방법을 결정합니다.

Wiki는 오픈 소스 태그 라이브러리를 사용하여 태그를 변환하고 파일 확장에서 사용할 변환기를 결정합니다. 예를 들어 파일 이름이 foo.md 또는 _foo.markdown_인 경우 Wiki는 Markdown 변환기를 사용하며, 파일 이름이 _foo.textile_인 경우에는 Textile 변환기를 사용합니다.

Wiki 페이지의 제목에 다음 문자를 사용하지 마세요. \ / : * ? " < > | 특정 운영 체제의 사용자는 문자가 포함된 파일 이름을 사용할 수 없습니다. 확장과 일치하는 태그 언어를 사용하여 콘텐츠를 작성해야 하며, 그렇지 않으면 콘텐츠가 제대로 렌더링되지 않습니다.