2012-06-18 55 views
61

wiki có cài đặt bằng thư mục hỗ trợ repo GitHub không? Wiki của chúng tôi lộn xộn với các trang, và chúng tôi đang tìm kiếm một cách để tổ chức chúng tốt hơn.Thư mục wiki GitHub

Chúng tôi đã thử kéo repo, tạo các thư mục cục bộ và di chuyển mọi thứ xung quanh, nhưng khi được cam kết trở lại, wiki đã không nhận các thay đổi.

Trả lời

45

Tôi đã gặp sự cố tương tự và thử các biến thể của những gì bạn đã thử. Không có gì bị mắc kẹt. Hỏi GitHub hỗ trợ về nó và nhận được câu trả lời về cơ bản là "Không, nhưng chúng tôi sẽ cho các nhà phát triển biết rằng mọi người quan tâm đến tính năng này".

Vì vậy, câu trả lời ngắn gọn là "Không" và câu trả lời dài là "Không, nhưng có thể trong tương lai".

+6

thật sự rất tệ. Tôi chỉ muốn sử dụng các thư mục khác nhau cho i18n. Nhưng ... –

+4

Câu trả lời ngắn hiện tại là "Có". :) – Marco

+2

@Marco Sau ba năm? GitHub thực sự coi trọng yêu cầu của người dùng! : | – trejder

25

Thực ra, có vẻ như gần đây, github đã thêm hỗ trợ cho các thư mục.

tôi đã có thể làm như sau:

  • Di chuyển một tập tin markdown hiện vào một thư mục mới.
  • Tạo tệp đánh dấu mới trong thư mục hiện có (được tạo ở bước trước).
  • Tạo tệp đánh dấu mới trong một thư mục mới.

Trong mọi trường hợp, các trang hiện tại vẫn còn ở đó và các trang mới được thêm vào.

Hạn chế duy nhất còn lại là tên tệp của bạn phải là duy nhất. Nếu bạn có nhiều hơn một tệp có cùng tên, chỉ một tệp trong số đó sẽ hiển thị trong wiki (tôi không chắc chắn nó ..).

+6

Vì vậy, về cơ bản, nó chỉ để tổ chức các trang của bạn, nhưng không cung cấp cho bạn thêm bất cứ điều gì. –

20

wiki github (aka Gollum) không sử dụng thư mục nhưng không theo cách bạn mong đợi.

Tài liệu trên Gollum wiki có thể sử dụng một số công việc nhưng đây là những gì tôi đã tìm ra chủ yếu thông qua thử nghiệm.

  • Tất cả các tệp xuất hiện trong thư mục gốc của wiki bất kể chúng được đặt ở đâu.
  • _Header, _Footer_Sidebar tệp là mỗi thư mục, nhưng được kế thừa nếu có không có mặt trong thư mục con.
  • Liên kết tệp có thể liên quan đến tệp nguồn (giữ các tệp của bạn với nội dung của bạn).

Vì vậy, nếu bạn muốn thư mục để đặt tên cho tên, bạn không may mắn. Cân nhắc sử dụng sơ đồ NS-Page để đặt tên không gian.

+4

việc thiếu các trang phụ làm cho Gollum và GitHub wiki bằng cách mở rộng một "wiki" bị tê liệt. –

0

Thực ra, vẫn còn một giới hạn. Có, bạn có thể thêm 1 cấp độ (do đó, 1 thư mục con). Nhưng kia là nó! Tôi đã cấu trúc lại toàn bộ bố cục tài liệu của mình, tạo nhiều cấp độ của các thư mục con cho tổ chức, nhưng đó là một sự không đi.

phào nhẹ

tôi phải nói: Tôi kinh hoàng bởi điều Gollum này. Tôi ngạc nhiên khi Github thậm chí còn nhặt nó lên.

+0

Tôi không nghĩ rằng điều này là chính xác. Tôi đã xem một trong các trang wiki được đề xuất git, https://github.com/showcases/projects-with-great-wikis. Tôi đã làm một bản sao git và chắc chắn rằng họ có ít nhất ba cấp độ của các thư mục con. Hãy xem kỹ thuật tài liệu/1-trackers/ruby-tracker ví dụ. –

+0

ok, tôi đã thử nghiệm nó bản thân mình và nó dường như gollum có một vấn đề với thư mục con có cùng tên ngay cả văn bản liên kết. Đây là loại khủng khiếp. Tôi sẽ hiểu nếu có một va chạm trong tên trang thực tế, nhưng khi sử dụng cú pháp mediaWiki [[Link Text | WikiPage]] nó thực sự dường như bị lẫn lộn giữa Link Text và tên thư mục thực tế. –

+0

Định dạng cực kỳ xấu xí và dư thừa này dường như hoạt động [PageName] (PageName) –

9

Đây không phải là giải pháp lý tưởng, nhưng cách giải quyết khác là tạo thanh bên tùy chỉnh nơi bạn tạo một mục lục có liên kết đến các trang của bạn. Tuy nhiên, tôi thấy điều này tốt hơn các thư mục vì nó cho phép bạn có một liên kết đến một trang duy nhất trong nhiều cấu trúc phân cấp.

+0

Đó là cách tiếp cận tôi đã thực hiện, nhưng nó để lại một phần "Trang" là một mớ hỗn độn lớn của các trang (hơn 60 trong dự án của tôi). –

+0

Phần Trang được thu gọn để không làm lộn xộn thanh bên một cách may mắn – pd12

Các vấn đề liên quan