2012-06-18 3 views
61

GitHub 저장소와 함께 설치되는 위키는 디렉토리를 지원합니까? 우리의 위키는 페이지가 어지럽게 흩어져 있으며 더 잘 정리할 수있는 방법을 찾고 있습니다.GitHub 위키 디렉토리

우리는 repo를 가져 와서 로컬 디렉토리를 생성하고 주위를 움직이려고했지만 다시 커밋되었을 때 위키는 변경 사항을 선택하지 않았습니다.

답변

45

나는 똑같은 문제를 겪고 있었고 시도한 것의 변종을 시도했다. 붙어 다니지 않는 것. GitHub에 대한 지원을 요청하고 본질적으로 "아니요,하지만 우리는 사람들이이 기능에 관심이 있다는 것을 개발자들에게 알리게 될 것입니다."라는 대답을 받았습니다.

따라서 짧은 대답은 "아니요"이고 긴 대답은 "아니요, 나중에는 어쩌면"입니다.

+6

정말 싫어합니다. 난 단지 i18n에 다른 디렉토리를 사용하고 싶다. 하지만 ... –

+4

현재 짧은 대답은 "예"입니다. :) – Marco

+2

@ Marco 3 년 후? GitHub은 사용자의 요청을 진지하게 받아들입니다. : | – trejder

25

실제로 github에 최근에 디렉토리에 대한 지원이 추가 된 것처럼 보입니다.

    는 새로운 디렉토리에 기존의 인하 파일을 이동
  • :

    나는 다음을 수행 할 수 있었다.
  • 기존 디렉토리에 새 markdown 파일을 만듭니다 (이전 단계에서 생성).
  • 새 디렉토리에 새 markdown 파일을 만듭니다.

모든 경우에 기존 페이지가 그대로 유지되고 새 페이지가 추가되었습니다.

남아있는 하나의 제약 조건은 파일 이름이 고유해야한다는 것입니다. 동일한 이름을 가진 파일이 두 개 이상인 경우 하나만 wiki에 표시됩니다 (어떤 파일인지는 확실치 않습니다).

+6

기본적으로 페이지 구성을 위해 사용되지만 더 이상 알려주지 않습니다. –

20

github wiki (일명 Gollum)는 디렉토리를 사용하지만 예상대로 사용할 수 없습니다.

Gollum wiki에있는 문서는 일부 작업을 사용할 수 있지만 테스트를 통해 대부분 알아 냈습니다.

  • 모든 파일은 저장소에 저장되는 위치에 관계없이 wiki의 루트에 나타납니다.
  • _Header, _Footer_Sidebar 파일은 디렉토리 단위이지만, 하위 폴더에 이 없으면 상속됩니다.
  • 파일 링크는 소스 파일과 관련 될 수 있습니다 (파일을 콘텐츠와 함께 보관하십시오).

그래서 네임 스페이스에 대한 디렉토리를 원하실 경우 운이 없네요. 네임 스페이스 지정에 NS-Page 체계를 사용해보십시오.

+4

하위 페이지가 부족하면 Gollum 및 GitHub 위키가 확장되어 절름발이 인 "wiki"가됩니다. –

0

실제로는 여전히 한계가 있습니다. 네, 당신은 1 레벨 (그래서, 1 하위 폴더)를 추가 할 수 있습니다. 하지만 그게 다야! 필자는 모든 문서 레이아웃을 리팩토링하여 조직을위한 여러 수준의 하위 폴더를 만들었지 만 그럴 필요가 없었습니다.

한숨

내가 말을해야 :이 골룸 것은 경악하고있다. 나는 Github도 그것을 데리러 놀랍군요.

+0

이것이 맞는 것 같지 않습니다. 나는 git 추천 wiki 사이트 중 하나 인 https://github.com/showcases/projects-with-great-wikis를보고 있었다. 나는 자식 복제품을 만들었고 적어도 하위 디렉토리가 최소한 세 가지 수준이되어야한다고 확신했다. 예를 들어 technical-documentation/1-trackers/ruby-tracker를 살펴보십시오. –

+0

괜찮 았어, 나는 그것을 직접 테스트했고 골룸에는 링크 텍스트조차도 같은 이름의 하위 디렉토리에 문제가있는 것처럼 보입니다. 이것은 일종의 wierd입니다. 실제 페이지 이름에 충돌이 있었는지는 이해하지만 mediaWiki 구문 [[Link Text | WikiPage]]을 사용하면 링크 텍스트와 실제 디렉토리 이름 사이에 혼란스러워 보입니다. –

+0

이 엄청나게 추악하고 중복 된 형식이 작동하는 것 같습니다 PageName] (PageName) –

9

이상적인 솔루션은 아니지만 해결 방법은 페이지 링크가있는 목차를 만드는 사용자 정의 사이드 바를 만드는 것입니다. 나는 당신이 여러 계층 구조 아래에 단일 페이지에 대한 링크를 가질 수 있기 때문에 어쨌든 이것은 폴더보다 낫다고 본다.

+0

그것이 내가 취한 접근법이지만 페이지의 거대한 엉망진창 인 "페이지"부분을 남겨 둡니다 (프로젝트에서 60 이상). –

+0

페이지 부분이 붕괴되어 다행히 사이드 바를 어지럽히 지 않습니다. – pd12

관련 문제