코드를 개발할 때 프로젝트와 함께 GitHub 위키를 관리하고 싶습니다. 예를 들어 :주 저장소에서 관리하는 GitHub 위키
지점
이상적으로 위키가 하위 폴더에 포함되기를 바랍니다 (예 :/위키). 그런 다음 코드를 변경하면 같은 시간에 위키를 업데이트 할 수도 있습니다 (코드 + 문서 변경). 또한 "개발"분기에서 "마스터"분기와 병합 할 때까지 모든 개발 코드 및 설명서가 자체 포함될 것입니다. 다행히도 수동 프로세스를 통해 GitHub 위키가 변경된 경우 마스터와 병합 한 후 업데이트됩니다.
나는 망할 놈의 서브 모듈의 기능에 대해 살펴 찍은 적이 있지만 나는 보통 하나의 개정에 점을 이해 것과. 어떻게 든 내 코드 개발을 따르고 싶기 때문에 분기와 병합이 정상적으로 작동합니다.
"wiki"하위 repo의 새로운 상태를 기록하기 위해 부모 repo도 커밋하는 한 "True nature of submodules"에서 설명한대로 하위 모듈에서 수정 및 업데이트 할 수 있습니다. 이 로컬 컴퓨터에있는 동안 당신이 표시하고 GitHub의 위키에서 작동하도록 골룸을 사용하려는 경우 서브 모듈을 사용하는 경우
감사합니다. 내가 찾은 다른 정보.그것은 분기/병합에 어떻게 대처합니까? 저장소의 "개발"지점에서 위키의 "개발"지점을 가지고 마스터에 쉽게 병합 할 수 있습니까? –
@MisterDai 각 Repo (상위 Repo 및 하위 모듈 repo (s))에는 하나의 Repo에서 다른 Repo까지 독립적 인 분기 세트가 있습니다. 하위 모듈의 새로운 상태를 기록하기 위해 하위 보고서에서 언제든지 분기를 변경할 수 있습니다. 단, 부모 저장소로 돌아가서 커밋해야합니다. – VonC
는 (당신은 아마해야), 당신은 문제가있는 것입니다.
Gollum은 로컬 Git 저장소 (푸시하지 않음)에 로컬 커밋을 수행하려고하지만 서브 모듈에서 .git는 실제로 Git 저장소가 아닌 로컬 저장소가있는 파일입니다. 이로 인해 골룸이 붕괴됩니다.
서브 모듈은 또한 버전이 부모 저장소에 연결되지 않는다는 문제가있다, 그들은 완전히 해제 결합되지 않습니다. 문서 변경을 할 때마다 소스 코드 저장소에 새 wiki 버전 번호 (wiki 내용이 아닌)를 넣으려는 것은 귀찮은 일입니다.
내가 사용하는이 솔루션은 주요 프로젝트 디렉토리에있는 디렉토리에 위키 저장소를 복제하고 .gitignore에 추가하는 것입니다. 프로젝트 (예 : github-wiki) 전체에서 디렉토리에 대해 일관된 이름을 사용하면 위키가 .gitignore에 있지 않고 실수로 메인 저장소에 업로드 될 가능성이 최소화됩니다. 그들은 골룸으로 문제가 발생하지 않는 한이 불필요하지만 일관성을 위해
, 그의 접근 방식은 또한 GitHub의 페이지에 적합합니다.
효과가 있습니까? BitBucket 함께 [비슷한 문제가] (http://stackoverflow.com/q/17021163/819272) 있습니다. wiki subrepo가있는 모든 솔루션은 궁극적으로 운명에 맞습니다. GitHub/BitBucket Wiki는 별도의 repo가 아니라 주 repo에서 특정 커밋을 가리키는 포인터입니다. – TemplateRex
결코 더 이상 조사 할 필요가 없으므로이 작업을 수행하지 않고 다른 것으로 이동했습니다. 한 시점에서 프로젝트를 빌드 할 때 github에 위키 변경 사항을 적용하기위한 스크립트를 사용했는데 충분히 효과적이었고 분기 및 서브 모듈 등에 대해 걱정할 필요가 없었습니다. –