Wikiotics是學習外語的網站。
Wikiootics項目成立於2008年,目的是創建一個自由許可的Wiki,人們可以為語言學習者合作。為此,我們構建了一個名為Douts的Wiki引擎,該引擎為從結構化內容構建交互式Wiki頁面提供了一個框架,可以從Web瀏覽器中進行編輯。 2011年,Wikiotics與Wikibabel Project聯合起來,Wikibabel Project具有類似的願景,其開發商繼續為艾基生物做出了巨大的貢獻。幾年後,我們對維護導管失去了興趣,並開始忙於其他活動。
截至2020年7月,Wikiotics已轉移到靜態場地。雖然是Wiki,但Wikiotics.org收到了62個登錄用戶的貢獻,以及僅通過其IP地址識別的匿名用戶。總共有4064個此類貢獻,每個捐款在此存儲庫中都有相應的提交(拉請求#4)。該存儲庫旨在作為社區工作的工作檔案。考慮到足夠的興趣,也可以開發新內容。
內容有點混亂,正如世界上任何人都可以編輯的存儲庫所期望的那樣,沒有節制。最重要的是,看課程的唯一真正方法是將其保存到Wiki。
向前的第一步是清理內容。應該刪除無用的課程和頁面。 (如果我們想引用它們,它們將保留在GIT歷史上。)任何尚未有用的課程都可以標記為draft = true
,從而在主要網站構建中隱藏了。當合併相同內容的多個副本時,應在任何舊位置留下一個別名,因為我們長期以來遵循了酷烏里斯不會改變的原則。
任何為Wiki做出貢獻並在GitHub上有帳戶的人都可以通過提交拉動請求來要求其捐款,該請求將適當的條目添加到本存儲庫中的.mailmap
文件中。本條目應將[email protected]
映射到與該人的GitHub帳戶相關的電子郵件地址(或者,或者,或者是地址[email protected]
)。
以這種方式索取貢獻將意味著用戶的配置文件在該人貢獻的任何頁面的GitHub歷史記錄中鏈接(例如,此處)。不幸的是,目前,貢獻圖似乎沒有考慮.mailmap
文件。這與有關堆棧溢出的報告不一致,但可能與有關GitHub的話語實例的討論有關。有趣的是,Fasthub-libre應用程序完整地顯示了正確的貢獻圖。
Wikiotics現在是由Hugo建造的靜態網站。以下步驟允許一個人在本地進行編輯:
安裝雨果。
在Ubuntu上,這很簡單
$ sudo snap install hugo --channel=extended
目前,“擴展”版本不是必需的,但是我們將來可能會嘗試其功能。
克隆這個存儲庫:
$ git clone https://github.com/wikiotics/wikiotics.org.git
啟動Hugo開發服務器,然後將Web瀏覽器指向提供的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/
目錄中。保存任何內容文件後,Web瀏覽器應使用更新的內容自動刷新。
每個課程完全由TOML Front Matter表示,該課程包含在+++
行之間。在編輯課程時,一個提示是在其前提中暫時設置grid = true
,這將顯示課程的元素作為電子表格。這對於獲得全球課程可能很有用。 draft = true
的課程也將顯示為網格(即,如果啟用了草稿)。
每個課程都可以用它教授的語言註釋,如果適用,則按照這些術語的標准定義,在課程的前提中設置target-languages
和/或source-languages
來知道學習者知道的語言。在幕後,這些註釋是雨果分類法的實例。
Wiki命名方案(對於URL/路線)正在#12中討論。我們還計劃記錄(#9)並改進(#10)課程的TOML數據結構。
目前的最高優先級是改善現場存檔的呈現。
添加新的課程媒體目前將涉及與Wikiotics Media存儲庫協調更改。有兩種替代方案正在考慮:git大文件存儲和IPF(#15中的詳細信息)。
所有內容(即content/
目錄中的所有內容,遞歸)均在Creative Commons歸因於共享3.0許可下許可。某些課程媒體(該存儲庫中未包含但未包含)可在不同(但免費)的創意共享許可下獲得。其他所有內容(例如,所有代碼)可在GNU通用公共許可證版本3或任何以後的版本下獲得。 {assets,static}/ductus/
的某些庫可在更寬鬆的許可下獲得。
在擁有相當複雜的技術堆棧之後,我們喜歡使事情變得簡單。 (甚至在以前,我們設法避免了許多現代前端開發的過多。)保持簡單的事物有助於最大化公共汽車因素,並最大程度地減少維護網站所花費的時間。應該沒有或幾乎沒有活動部件,理想情況下沒有服務器可以維護。
我們基於以下技術來幫助實現我們的目標: