Thư mục wiki GitHub

Liệu wiki cài đặt với kho GitHub có hỗ trợ các thư mục không? Wiki của chúng tôi có rất nhiều trang và chúng tôi đang tìm cách sắp xếp chúng tốt hơn.

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

Tôi đã gặp cùng một vấn đề chính xác và đã thử các biến thể của những gì bạn đã thử. Không có gì bị kẹt. Đã hỏi bộ phận hỗ trợ của GitHub 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 là "Không", và câu trả lời dài là "Không, nhưng có thể trong tương lai."

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

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

• Di chuyển tệp đánh dấu hiện có sang một thư mục mới.
• Tạo tệp đánh dấu mới trong thư mục hiện có (đã tạo ở bước trước).
• Tạo một 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 có vẫn ở đó và các trang mới đã được thêm vào.

Một hạn chế vẫn còn là tên tệp của bạn phải là duy nhất. Nếu bạn có nhiều 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 là ..).

GitHub wiki (hay còn gọi là Gollum ) không sử dụng các thư mục nhưng không theo cách bạn có thể 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 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 trong kho.
• _Header, _FooterVà _Sidebarfile là mỗi thư mục, nhưng thừa hưởng nếu không có hiện diện trong một thư mục con.
• Các liên kết tệp có thể liên quan đến tệp nguồn (giữ các tệp với nội dung của bạn).

Vì vậy, nếu bạn muốn có các thư mục cho không gian tên thì bạn đã không gặp may. Cân nhắc sử dụng {namespace}-{page}lược đồ cho không gian tên.

Đây không phải là giải pháp lý tưởng nhưng cách giải quyết sẽ là tạo một thanh bên tùy chỉnh, nơi bạn tạo mục lục với các liên kết đến các trang của mình. Tôi thấy điều này dù sao cũng 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 dưới nhiều phân cấp.

Trên thực tế, vẫn còn một hạn chế. Có, bạn có thể thêm 1 cấp độ (như vậy, 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 thư mục con cho tổ chức, nhưng đó là một việc không nên làm.

thở dài

Tôi phải nói: Tôi kinh hoàng với thứ Gollum này. Tôi ngạc nhiên khi Github thậm chí còn nhặt được nó.