[github] GitHub 위키 디렉토리

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

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



답변

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

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


답변

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

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

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

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

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


답변

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

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

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

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


답변

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


답변

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

한숨

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


답변