wikiotics.org
1.0.0
Wikiotics เป็นเว็บไซต์สำหรับการเรียนรู้ภาษาต่างประเทศ
โครงการ Wikiotics ก่อตั้งขึ้นในปี 2551 โดยมีเป้าหมายในการสร้างวิกิที่ได้รับใบอนุญาตอย่างอิสระซึ่งผู้คนสามารถร่วมมือกับวัสดุสำหรับผู้เรียนภาษา เป็นส่วนหนึ่งของสิ่งนี้เราได้สร้างเครื่องยนต์วิกิที่เรียกว่า Ductus ซึ่งเป็นกรอบสำหรับการสร้างหน้าวิกิแบบโต้ตอบจากเนื้อหาที่มีโครงสร้างแก้ไขได้จากเว็บเบราว์เซอร์ ในปี 2011 Wikiotics เข้าร่วมกองกำลังกับโครงการ Wikibabel ซึ่งเป็นโครงการที่มีวิสัยทัศน์ที่คล้ายกันและผู้พัฒนาได้มีส่วนร่วมอย่างมีนัยสำคัญกับ Wikiotics ไม่กี่ปีต่อมาเราหมดความสนใจในการรักษา Ductus และกลายเป็นกิจกรรมอื่น ๆ
ณ เดือนกรกฎาคม 2563 Wikiotics ได้รับการเปลี่ยนไปเป็นไซต์คงที่ ในขณะที่มันเป็นวิกิ แต่ wikiotics.org ได้รับการสนับสนุนจากผู้ใช้ที่เข้าสู่ระบบ 62 คนรวมถึงผู้ใช้ที่ไม่ระบุชื่อที่ระบุโดยที่อยู่ IP ของพวกเขาเท่านั้น มีการบริจาคทั้งหมด 4064 ครั้งซึ่งแต่ละครั้งมีการกระทำที่สอดคล้องกันในที่เก็บนี้ (คำขอดึง #4) ที่เก็บนี้ได้รับการออกแบบมาเพื่อทำหน้าที่เป็นที่เก็บถาวรของงานของชุมชน การพัฒนาเนื้อหาใหม่ก็เป็นไปได้เช่นกัน
เนื้อหาเป็นเรื่องยุ่ง ๆ อย่างที่คาดไว้จากที่เก็บที่สามารถแก้ไขได้โดยทุกคนในโลกโดยไม่มีการกลั่นกรอง ยิ่งไปกว่านั้นวิธีเดียวที่แท้จริงในการดูร่างการทำงานของบทเรียนคือการบันทึกไว้ในวิกิ
ก้าวแรกไปข้างหน้าคือการทำความสะอาดเนื้อหา ควรลบบทเรียนและหน้าเว็บที่ไม่เป็นประโยชน์ (พวกเขาจะยังคงอยู่ในประวัติศาสตร์ GIT หากเราต้องการอ้างอิงพวกเขา) บทเรียนใด ๆ ที่อยู่ระหว่างดำเนินการที่ยังไม่เป็นประโยชน์สามารถทำเครื่องหมายด้วย draft = true และซ่อนตัวจากการสร้างเว็บไซต์หลัก เมื่อมีการรวมเนื้อหาเดียวกันหลายชุดแล้วนามแฝงควรถูกทิ้งไว้ในสถานที่เก่า ๆ ตามหลักการที่เราปฏิบัติตามหลักการที่ URIs เย็นไม่เปลี่ยนแปลง
ใครก็ตามที่มีส่วนร่วมในวิกิและมีบัญชีใน GitHub สามารถเรียกร้องการมีส่วนร่วมของพวกเขาโดยส่งคำขอดึงที่เพิ่มรายการที่เหมาะสมไปยังไฟล์ .mailmap ในที่เก็บนี้ รายการนี้ควรทำแผนที่ [email protected] ไปยังที่อยู่อีเมลที่เกี่ยวข้องกับบัญชี GitHub ของบุคคล (หรืออีกทางเลือกหนึ่งที่อยู่ [email protected] )
การอ้างสิทธิ์ในวิธีนี้จะหมายความว่าโปรไฟล์ของผู้ใช้เชื่อมโยงกันในประวัติ GitHub ของหน้าใด ๆ ที่บุคคลมีส่วนร่วม (ตัวอย่างที่นี่) น่าเสียดายที่ในขณะนี้ดูเหมือนว่ากราฟการมีส่วนร่วม ไม่ได้ พิจารณาไฟล์. .mailmap สิ่งนี้ไม่สอดคล้องกับรายงานเกี่ยวกับสแต็กล้น แต่น่าจะเกี่ยวข้องกับการสนทนานี้เกี่ยวกับอินสแตนซ์วาทกรรมของ GitHub ที่น่าสนใจแอพ Fasthub-Libre จะแสดงกราฟการมีส่วนร่วมอย่างถูกต้องอย่างครบถ้วน
Wikiotics ตอนนี้เป็นเว็บไซต์คงที่ที่สร้างขึ้นด้วย Hugo ขั้นตอนต่อไปนี้อนุญาตให้แก้ไขได้ในพื้นที่:
ติดตั้ง Hugo
บน Ubuntu นี่เป็นเรื่องง่ายเหมือน
$ sudo snap install hugo --channel=extended
ตอนนี้ไม่จำเป็นต้องใช้เวอร์ชัน "ขยาย" แต่เราอาจทดสอบคุณสมบัติของมันในอนาคต
โคลนที่เก็บนี้:
$ git clone https://github.com/wikiotics/wikiotics.org.git
เริ่มเซิร์ฟเวอร์ Hugo Development และชี้เว็บเบราว์เซอร์ไปยัง URL ที่ให้ไว้:
$ cd wikiotics.org
$ hugo server
[...]
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
เนื้อหาอยู่ใน content/ ไดเรกทอรี เมื่อบันทึกไฟล์เนื้อหาใด ๆ เว็บเบราว์เซอร์ควรรีเฟรชโดยอัตโนมัติด้วยเนื้อหาที่อัปเดต
แต่ละบทเรียนจะแสดงโดย Toml Front Matter ทั้งหมดซึ่งมีอยู่ระหว่างบรรทัดที่พูด +++ เมื่อแก้ไขบทเรียนหนึ่งเคล็ดลับคือการตั้ง grid = true ชั่วคราวในเรื่องด้านหน้าซึ่งจะแสดงองค์ประกอบของบทเรียนเป็นสเปรดชีต สิ่งนี้มีประโยชน์ในการรับมุมมองระดับโลกของบทเรียน บทเรียนที่ draft = true จะแสดงเป็นกริด (นั่นคือถ้าเปิดใช้งานแบบร่าง)
แต่ละบทเรียนสามารถใส่คำอธิบายประกอบด้วยภาษาที่สอนและถ้ามีภาษาที่ใช้ก็จะถือว่าผู้เรียนรู้โดยการตั้งค่า target-languages และ/หรือ source-languages ในเรื่องส่วนหน้าของบทเรียนตามคำจำกัดความมาตรฐานของคำเหล่านี้ เบื้องหลังคำอธิบายประกอบเหล่านี้เป็นอินสแตนซ์ของ Hugo taxonomies
รูปแบบการตั้งชื่อวิกิ (สำหรับ URL/เส้นทาง) อยู่ภายใต้การสนทนาใน #12 นอกจากนี้เรายังวางแผนที่จะจัดทำเอกสาร (#9) และปรับปรุง (#10) โครงสร้างข้อมูล TOML สำหรับบทเรียน
ลำดับความสำคัญสูงสุดในขณะนี้คือการปรับปรุงการนำเสนอของที่เก็บถาวรไซต์
การเพิ่มสื่อบทเรียนใหม่ในปัจจุบันจะเกี่ยวข้องกับการประสานงานการเปลี่ยนแปลงกับที่เก็บข้อมูล Wikiotics Media มีสองทางเลือกภายใต้การพิจารณา: GIT ที่เก็บไฟล์ขนาดใหญ่และ IPFS (รายละเอียดใน #15)
เนื้อหาทั้งหมด (เช่นทุกอย่างใน content/ ไดเรกทอรีซ้ำ) ได้รับใบอนุญาตภายใต้ใบอนุญาต Creative Commons แหล่งอ้างอิง 3.0 สื่อบทเรียนบางส่วน (อ้างอิง แต่ไม่รวมอยู่ในที่เก็บนี้) มีให้ภายใต้ใบอนุญาตครีเอทีฟคอมมอนส์ที่แตกต่างกัน (แต่ฟรี) ทุกอย่างอื่น (เช่นรหัสทั้งหมด) มีอยู่ภายใต้ GNU ทั่วไปใบอนุญาตสาธารณะ GNU เวอร์ชัน 3 หรือรุ่นใหม่ ๆ ห้องสมุดบางแห่งใน {assets,static}/ductus/ มีให้บริการภายใต้ใบอนุญาตที่อนุญาตเพิ่มเติม
เราชอบที่จะทำให้สิ่งต่าง ๆ เรียบง่ายหลังจากปีของการมีเทคโนโลยีที่ค่อนข้างซับซ้อน (แม้กระทั่งก่อนหน้านี้เราจัดการเพื่อหลีกเลี่ยงการพัฒนาส่วนหน้าส่วนเกินที่มากเกินไป) การรักษาสิ่งต่าง ๆ ให้ง่าย ๆ ช่วยเพิ่มปัจจัยบัสและลดเวลาที่ใช้ในการบำรุงรักษาไซต์ ไม่ควรมีชิ้นส่วนที่เคลื่อนไหวหรือไม่กี่ชิ้นและไม่มีเซิร์ฟเวอร์ที่จะรักษา
เราสร้างเทคโนโลยีชิ้นต่อไปนี้เพื่อช่วยให้บรรลุเป้าหมายของเรา:
