ไดเรกทอรี GitHub wiki


87

วิกิที่ติดตั้งด้วย repo GitHub รองรับไดเร็กทอรีหรือไม่ วิกิของเราเต็มไปด้วยหน้าเว็บและเรากำลังมองหาวิธีจัดระเบียบให้ดีขึ้น

เราพยายามดึง repo สร้างไดเรกทอรีในพื้นที่และย้ายสิ่งต่างๆไปรอบ ๆ แต่เมื่อยืนยันกลับวิกิไม่ได้รับการเปลี่ยนแปลง

คำตอบ:


60

ฉันมีปัญหาเดียวกันและลองใช้รูปแบบต่างๆของสิ่งที่คุณลอง ไม่มีอะไรติด. ถามฝ่ายสนับสนุน GitHub เกี่ยวกับเรื่องนี้และได้รับคำตอบว่า "ไม่ แต่เราจะแจ้งให้นักพัฒนาทราบว่ามีผู้สนใจฟีเจอร์นี้"

ดังนั้นคำตอบสั้น ๆ คือ "ไม่" และคำตอบยาว ๆ คือ "ไม่ แต่อาจจะในอนาคต"


8
คำตอบสั้น ๆ ในปัจจุบันคือ "ใช่" :)
มาร์โก

2
@ มาร์โกหลังจากสามปี? GitHub ให้ความสำคัญกับคำขอของผู้ใช้อย่างจริงจัง! : |
trejder

9
ใช่ยังไม่อีกห้าปีต่อมา
Lincoln Bergeson

1
หกปี. แต่ได้ยินคนร้องครวญครางเกี่ยวกับ #Microsoft ได้ #GitHub กลับมาในออฟฟิศ วันนี้ฉันผิดหวังมากเกินไปและฉันคิดว่าฉันสามารถหัวเราะพวกเขาต่อหน้าได้แล้ว
DevOvercome

เราทำได้ทางนี้docs.gitlab.com/ee/user/project/wiki
Amrita Deb

30

จริงๆแล้วดูเหมือนว่า github จะเพิ่มการรองรับไดเรกทอรีเมื่อเร็ว ๆ นี้

ฉันสามารถทำสิ่งต่อไปนี้ได้:

  • ย้ายไฟล์ markdown ที่มีอยู่ไปยังไดเร็กทอรีใหม่
  • สร้างไฟล์ markdown ใหม่ในไดเร็กทอรีที่มีอยู่ (สร้างในขั้นตอนเดิม)
  • สร้างไฟล์ markdown ใหม่ในไดเร็กทอรีใหม่

ในทุกกรณีหน้าที่มีอยู่ยังคงอยู่ที่นั่นและมีการเพิ่มหน้าใหม่

ข้อ จำกัด ประการหนึ่งที่ยังคงอยู่คือชื่อไฟล์ของคุณต้องไม่ซ้ำกัน หากคุณมีไฟล์ที่มีชื่อเดียวกันมากกว่าหนึ่งไฟล์จะมีเพียงไฟล์เดียวเท่านั้นที่จะปรากฏใน wiki (ฉันไม่แน่ใจว่า .. )


9
โดยพื้นฐานแล้วเป็นเพียงการจัดระเบียบหน้าเว็บของคุณ แต่ไม่ได้ให้อะไรเพิ่มเติม
Rene Pot

26

วิกิ GitHub (aka Gollum ) ใช้ไดเร็กทอรี แต่ไม่ใช่ในแบบที่คุณคาดหวัง

เอกสารในGollum wikiสามารถใช้งานได้ แต่นี่คือสิ่งที่ฉันพบส่วนใหญ่ผ่านการทดสอบ

  • ไฟล์ทั้งหมดจะปรากฏในรูทของ wiki ไม่ว่าจะอยู่ที่ใดใน repo ก็ตาม
  • _Header, _Footerและ_Sidebarไฟล์ต่อไดเรกทอรี แต่ได้รับมรดกหากไม่มีผู้ใดอยู่ในโฟลเดอร์เด็ก
  • ลิงก์ไฟล์อาจสัมพันธ์กับไฟล์ต้นฉบับ (เก็บไฟล์ของคุณไว้กับเนื้อหาของคุณ)

ดังนั้นหากคุณต้องการไดเร็กทอรีสำหรับเนมสเปซคุณก็โชคไม่ดี พิจารณาใช้{namespace}-{page}โครงร่างสำหรับเนมสเปซ


7
การไม่มีหน้าย่อยทำให้ Gollum และ GitHub wiki โดยการขยาย "wiki" ที่พิการ

14

ไม่ใช่ทางออกที่ดี แต่วิธีแก้ปัญหาคือสร้างแถบด้านข้างแบบกำหนดเองที่คุณสร้างสารบัญพร้อมลิงก์ไปยังเพจของคุณ ฉันพบว่าสิ่งนี้ดีกว่าโฟลเดอร์อยู่แล้วเพราะมันช่วยให้คุณมีลิงค์ไปยังหน้าเดียวภายใต้หลายลำดับชั้น


นั่นคือแนวทางที่ฉันได้ดำเนินการไป แต่ทิ้งส่วน "เพจ" ไว้ซึ่งเป็นหน้าที่ยุ่งเหยิงขนาดใหญ่ (มากกว่า 60 หน้าในโครงการของฉัน)
Jason Short

ส่วนของหน้าถูกยุบเพื่อให้ไม่เกะกะแถบด้านข้างขอบคุณ
pd12

1

จริงๆแล้วยังมีข้อ จำกัด ใช่คุณสามารถเพิ่มได้ 1 ระดับ (ดังนั้น 1 โฟลเดอร์ย่อย) แต่ก็แค่นั้น! ฉันปรับโครงสร้างเค้าโครงเอกสารทั้งหมดของฉันใหม่สร้างโฟลเดอร์ย่อยหลายระดับสำหรับองค์กร แต่นั่นไม่ใช่เรื่องง่าย

ถอนหายใจ

ฉันต้องบอกว่า: ฉันตกใจกับสิ่งนี้ของกอลลัม ฉันประหลาดใจที่ Github หยิบมันขึ้นมา


2
ฉันไม่คิดว่านี่จะถูกต้อง ผมกำลังมองหาที่หนึ่งของคอมไพล์แนะนำเว็บไซต์วิกิพีเดียgithub.com/showcases/projects-with-great-wikis ฉันทำการโคลนคอมไพล์และแน่ใจว่ามันมีไดเรกทอรีย่อยอย่างน้อยสามระดับ ดูเอกสารทางเทคนิค / 1-trackers / ruby-tracker เช่น
Ed Ost

โอเคฉันทดสอบด้วยตัวเองและดูเหมือนว่ากอลลัมมีปัญหากับไดเรกทอรีย่อยที่มีชื่อเดียวกับข้อความลิงก์ นี่เป็นเรื่องแปลก ฉันจะเข้าใจว่าชื่อเพจจริงมีความขัดแย้งกันหรือไม่ แต่เมื่อใช้ไวยากรณ์ mediaWiki [[ข้อความลิงก์ | WikiPage]] ดูเหมือนจะสับสนระหว่างข้อความลิงก์กับชื่อไดเรกทอรีจริง
Ed Ost

รูปแบบที่น่าเกลียดและซ้ำซ้อนอย่างเหลือเชื่อนี้ดูเหมือนจะใช้งานได้ [PageName] (PageName)
Ed Ost

1
gollum-lib อนุญาตให้ pagenames มีเครื่องหมายทับซึ่งทำงานอย่างที่คุณคาดหวัง น่าเสียดายที่ GitHub และส่วนหน้า Gollum ที่ใช้ Sinatra "อย่างเป็นทางการ" ไม่สนับสนุนสิ่งเหล่านี้อย่างสมเหตุสมผล
gerwitz

1
github ที่แสดงในความคิดเห็นของ Ed Ost ไม่มีอยู่แล้ว ทางเลือก fwiw quora.com/…
simesy
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.