GitHub 위키 디렉토리


85

GitHub 저장소와 함께 설치되는 위키가 디렉토리를 지원합니까? 우리의 위키는 페이지로 어수선하며, 페이지를 더 잘 구성 할 수있는 방법을 찾고 있습니다.

리포지토리를 가져오고, 로컬 디렉토리를 만들고, 물건을 옮기려고했지만 다시 커밋했을 때 위키가 변경 사항을 인식하지 못했습니다.

답변:


60

나는 똑같은 문제가 있었고 당신이 시도한 변형을 시도했습니다. 아무것도 붙어 있지 않습니다. 이에 대해 GitHub 지원을 요청했고 본질적으로 "아니요.하지만 개발자에게이 기능에 관심이 있다는 사실을 개발자에게 알려 드리겠습니다."라는 답변을 받았습니다.

그래서 짧은 대답은 "아니요"이고 긴 대답은 "아니요,하지만 앞으로는"입니다.


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

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

9
네, 여전히 아니오, 5 년 후
Lincoln Bergeson

1
육년. Btw는 사람들이 #Microsoft에 대해 신음하는 것을 들었습니다. #GitHub가 사무실로 돌아 왔습니다. 오늘은 실망이 너무 많아서 이제는 얼굴을보고 웃을 수있을 것 같아요.
DevOvercome

우리는이 방법으로 할 수 docs.gitlab.com/ee/user/project/wiki
암리타 뎁

30

실제로 github가 최근에 디렉토리 지원을 추가 한 것 같습니다.

다음을 수행 할 수있었습니다.

  • 기존 마크 다운 파일을 새 디렉토리로 이동합니다.
  • 기존 디렉토리에 새 마크 다운 파일을 만듭니다 (이전 단계에서 생성됨).
  • 새 디렉토리에 새 마크 다운 파일을 만듭니다.

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

남은 한 가지 제약은 파일 이름이 고유해야한다는 것입니다. 같은 이름의 파일이 두 개 이상있는 경우 그 중 하나만 위키에 표시됩니다 (어떤 파일이 .. ..).


9
기본적으로 페이지를 구성하기위한 것이지만 더 이상 제공하지 않습니다.
Rene Pot

26

GitHub 위키 (일명 Gollum )는 디렉토리를 사용하지만 예상대로는 사용하지 않습니다.

Gollum 위키 의 문서는 약간의 작업을 사용할 수 있지만 이것은 주로 테스트를 통해 알아 낸 것입니다.

  • 모든 파일은 저장소의 위치에 관계없이 위키의 루트에 나타납니다.
  • _Header, _Footer_Sidebar 파일 당 디렉토리하지만 자식 폴더에 없음 존재가있는 경우 상속.
  • 파일 링크는 소스 파일과 관련 될 수 있습니다 (파일을 콘텐츠와 함께 유지).

따라서 네임 스페이스를위한 디렉토리를 원하면 운이 좋지 않습니다. {namespace}-{page}네임 스페이스에 스키마 사용을 고려하십시오 .


7
하위 페이지가 없기 때문에 Gollum과 GitHub 위키는 확장하여 불구가 된 "위키"가되었습니다.

14

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


이것이 내가 취한 접근 방식이지만, 엄청난 양의 페이지 (내 프로젝트에서 60 개 이상) 인 "페이지"부분이 남습니다.
Jason Short

Pages 부분이 축소되어 고맙게도 사이드 바를 어지럽히 지 않습니다
pd12

1

사실 여전히 한계가 있습니다. 예, 1 단계 (하위 폴더 1 개)를 추가 할 수 있습니다. 하지만 그게 다야! 전체 문서 레이아웃을 리팩터링하여 조직을위한 여러 수준의 하위 폴더를 만들었지 만 그것은 진행되지 않았습니다.

한숨

나는 말해야한다 : 나는이 골룸에 놀랐다. 나는 Github가 그것을 집어 들었다는 것에 놀랐습니다.


2
나는 이것이 옳다고 생각하지 않는다. git 권장 위키 사이트 중 하나 인 github.com/showcases/projects-with-great-wikis를보고있었습니다 . 나는 git 클론을 만들었고 적어도 세 가지 수준의 하위 디렉토리가 있는지 확인했습니다. 예를 들어 technical-documentation / 1-trackers / ruby-tracker를 살펴보십시오.
Ed Ost 2014 년

좋아, 직접 테스트했는데 gollum이 링크 텍스트와 동일한 이름을 가진 하위 디렉토리에 문제가있는 것 같습니다. 이것은 일종의 이상합니다. 실제 페이지 이름에 충돌이 있으면 이해할 수 있지만 mediaWiki 구문 [[Link Text | WikiPage]]을 사용할 때 실제로 링크 텍스트와 실제 디렉토리 이름이 혼동되는 것 같습니다.
Ed Ost 2014 년

이 믿을 수 없을 정도로 못생긴 중복 형식은 작품 [페이지 이름] (페이지 이름)에 보인다
에드 오스트

1
gollum-lib는 페이지 이름에 슬래시를 사용할 수 있도록 허용하며, 이는 예상대로 작동합니다. 안타깝게도 GitHub 나 "공식"Sinatra 기반 Gollum 프런트 엔드는 이러한 기능을 현명하게 지원하지 않습니다.
gerwitz 2014 년

1
Ed Ost의 댓글에있는 github 쇼케이스는 더 이상 존재하지 않습니다. 대안 FWIW의 quora.com/...
simesy
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.