wikiotics.org
1.0.0
Wikiotik adalah situs web untuk belajar bahasa asing.
Proyek Wikiotik didirikan pada 2008 dengan tujuan menciptakan wiki berlisensi bebas di mana orang dapat berkolaborasi pada materi untuk pelajar bahasa. Sebagai bagian dari ini, kami membangun mesin wiki yang disebut Ductus, yang menyediakan kerangka kerja untuk membangun halaman wiki interaktif dari konten terstruktur, dapat diedit dari browser web. Pada tahun 2011, wikiotik bergabung dengan proyek Wikibabel, sebuah proyek dengan visi yang sama dan yang pengembangnya kemudian berkontribusi secara signifikan terhadap wikiotik. Beberapa tahun kemudian, kami kehilangan minat dalam mempertahankan Ductus dan menjadi sibuk dengan kegiatan lain.
Pada Juli 2020, wikiotik telah dialihkan ke situs statis. Sementara itu adalah wiki, wikiotics.org menerima kontribusi dari 62 pengguna yang masuk, serta pengguna anonim yang diidentifikasi hanya oleh alamat IP mereka. Ada total 4064 kontribusi semacam itu, yang masing -masing memiliki komit yang sesuai dalam repositori ini (Tarik Permintaan #4). Repositori ini dirancang untuk berfungsi sebagai arsip kerja karya masyarakat. Pengembangan konten baru juga dimungkinkan, diberi minat yang cukup.
Kontennya sedikit berantakan, seperti yang mungkin diharapkan dari repositori yang dapat diedit oleh siapa pun di dunia, tanpa moderasi. Selain itu, satu -satunya cara nyata untuk melihat konsep pelajaran yang berfungsi adalah dengan menyimpannya ke wiki.
Langkah pertama adalah membersihkan konten. Pelajaran dan halaman yang tidak berguna harus dihapus. (Mereka akan tetap dalam sejarah git jika kita ingin merujuk mereka.) Pelajaran apa pun yang belum berguna yang belum berguna dapat ditandai dengan draft = true dan dengan demikian disembunyikan dari situs web utama. Ketika beberapa salinan dari konten yang sama dikonsolidasikan, alias harus dibiarkan di lokasi lama mana pun, karena kami telah lama mengikuti prinsip bahwa URI keren tidak berubah.
Siapa pun yang berkontribusi pada wiki dan memiliki akun di GitHub dapat mengklaim kontribusi mereka dengan mengirimkan permintaan tarik yang menambahkan entri yang sesuai ke file .mailmap di repositori ini. Entri ini harus memetakan [email protected] ke alamat email yang terkait dengan akun github orang tersebut (atau, sebagai alternatif, alamat [email protected] ).
Mengklaim kontribusi dengan cara ini akan berarti bahwa profil pengguna ditautkan dalam riwayat gitub dari setiap halaman yang dikontribusikan (contoh di sini). Sayangnya, saat ini, tampaknya grafik kontribusi tidak mempertimbangkan file .mailmap . Ini tidak konsisten dengan laporan tentang Stack Overflow tetapi kemungkinan terkait dengan diskusi ini tentang instance wacana GitHub. Menariknya, aplikasi fasthub-libre menampilkan grafik kontribusi dengan benar, secara keseluruhan.
Wikiotik sekarang menjadi situs statis yang dibangun dengan Hugo. Langkah -langkah berikut memungkinkan seseorang untuk mengeditnya secara lokal:
Instal Hugo.
Di Ubuntu, ini sesederhana
$ sudo snap install hugo --channel=extended
Saat ini, versi "diperpanjang" tidak diperlukan, tetapi kami dapat bereksperimen dengan fitur -fiturnya di masa depan.
Klon Repositori ini:
$ git clone https://github.com/wikiotics/wikiotics.org.git
Mulai server pengembangan Hugo dan arahkan browser web ke URL yang disediakan:
$ cd wikiotics.org
$ hugo server
[...]
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
Konten ada di content/ Direktori. Setelah menyimpan file konten apa pun, browser web harus menyegarkan secara otomatis dengan konten yang diperbarui.
Setiap pelajaran diwakili seluruhnya oleh materi depan TOML, yang terkandung di antara garis -garis yang mengatakan +++ . Saat mengedit pelajaran, satu tip adalah untuk sementara mengatur grid = true dalam materi depannya, yang akan menampilkan elemen pelajaran sebagai spreadsheet. Ini bisa berguna untuk mendapatkan pandangan global dari pelajaran. Pelajaran yang draft = true juga akan ditampilkan sebagai kisi (yaitu, jika konsep diaktifkan).
Setiap pelajaran dapat dianotasi dengan bahasa yang diajarkan dan, jika berlaku, bahasa yang diasumsikan oleh pelajar dengan menetapkan target-languages dan/atau source-languages dalam materi depan pelajaran, mengikuti definisi standar dari istilah-istilah ini. Di belakang layar, anotasi ini adalah contoh taksonomi Hugo.
Skema Penamaan Wiki (untuk URL/rute) sedang dibahas di #12. Kami juga berencana untuk mendokumentasikan (#9) dan meningkatkan (#10) struktur data TOML untuk pelajaran.
Prioritas tertinggi saat ini adalah meningkatkan presentasi arsip situs.
Menambahkan media pelajaran baru saat ini akan melibatkan koordinasi perubahan dengan dengan repositori media wikiotik. Ada dua alternatif yang sedang dipertimbangkan: git penyimpanan file besar dan IPF (detail dalam #15).
Semua konten (yaitu, semua yang ada dalam content/ direktori, rekursif) dilisensikan di bawah lisensi Creative Commons Attribution-Sharealike 3.0. Beberapa media pelajaran (dirujuk tetapi tidak termasuk dalam repositori ini) tersedia di bawah lisensi Creative Commons yang berbeda (tetapi gratis). Segala sesuatu yang lain (misalnya, semua kode) tersedia di bawah Lisensi Publik Umum GNU versi 3 atau versi selanjutnya. Beberapa perpustakaan di {assets,static}/ductus/ tersedia di bawah lisensi yang lebih permisif.
Kami suka menjaga hal -hal sederhana, setelah bertahun -tahun memiliki tumpukan teknologi yang agak rumit. (Bahkan sebelumnya, kami berhasil menghindari banyak kelebihan pengembangan frontend modern.) Menjaga hal -hal sederhana membantu memaksimalkan faktor bus dan meminimalkan waktu yang dihabiskan untuk mempertahankan situs. Seharusnya tidak ada atau sedikit bagian yang bergerak, dan idealnya tidak ada server untuk dipelihara.
Kami membangun di atas potongan teknologi berikut untuk membantu memenuhi tujuan kami:
