Partkeepr: Partkeeper Wiki

Dibuat pada 12 Apr 2019  ·  26Komentar  ·  Sumber: partkeepr/PartKeepr

Tidak terkait langsung dengan basis kode - tetapi wiki Partkeepr tidak lagi tersedia di
https://wiki.partkeeper.org/
Saya tidak tahu apakah ini telah diarsipkan di mana saja tetapi ini merupakan sumber yang sangat berguna dan ingin melihatnya dipulihkan, jika memungkinkan.

meta

Komentar yang paling membantu

Sepertinya wiki sudah kembali online.

Semua 26 komentar

Untuk saat ini satu-satunya hal yang saya berhasil membuat "berfungsi" adalah dengan menggunakan halaman cache googles. Anda cukup mencari halaman wiki yang relevan, google menunjukkan hasilnya dan alih-alih mengklik tautan itu sendiri, klik panah bawah kecil di sebelahnya dan kemudian klik cache. Gayanya tidak akan diubah tetapi kontennya ada di sana. Atau gunakan archive.org: http://web.archive.org/web/20180310044536/http://wiki.partkeepr . org:80/wiki/Main_Page

Saya berharap bahwa suatu saat wiki kembali, meskipun hanya sebagai html kosong di folder di github (atau di tab wiki di sini).

Sepertinya wiki sudah kembali online.

Berita bagus! Penutupan.

Ngomong-ngomong, adakah yang tahu di mana wiki di-host? Apakah ini masih dalam tanggung jawab @Drachenkaetzchen? Dalam edisi lain masalah Partkeepr agak macet saat ini dijelaskan. Ini mungkin cara yang baik untuk membantu @Drachenkaetzchen dan mengambil tanggung jawab untuk itu di pundak orang lain. Kemudian, cadangan Wiki/SQL diperlukan.

@Gasman2014 Secara keseluruhan saya akan memilih untuk membuka kembali sampai masalah ini diselesaikan dalam jangka panjang.

Saya dengan @christianlupus , saya akan mengatakan Host di bagian wiki githubs sebagai gantinya, yang seharusnya mengurangi beban server dan bahu @Drachenkaetzchen .

Mengingat keinginan solusi jangka panjang dan saran dari @C44Supra dan @christianlupus untuk mencoba mendukung Felicia @Drachenkaetzchen dengan mengarsipkan data ini dan menghostingnya secara mandiri melalui github, saya membuka kembali ini. Informasi di wiki sangat membantu untuk mengatasi masalah instalasi - khususnya dalam situasi khusus yang tidak dijelaskan dalam panduan pengaturan utama. Informasi ini harus tersedia di samping basis kode untuk kegunaan maksimum. Saya sangat senang melihat wiki telah dipulihkan tetapi mungkin tanpa terlalu banyak pekerjaan dapat digabungkan dengan bagian wiki github yang juga berisi beberapa informasi bermanfaat tetapi tambahan dan berbeda.

Jika seseorang dapat memberikan cara untuk memindahkan wiki yang dihosting secara otomatis ke GitHub, silakan beri tahu saya, tetapi hanya jika Anda benar-benar menguji mekanisme tersebut. Google sederhana menghasilkan banyak hasil untuk mekanisme seperti itu, dan saya tidak punya waktu atau energi untuk memeriksanya.

Jika Anda memerlukan semacam akses API untuk wiki saat ini atau dump DB, beri tahu saya.

Saya akan bersedia untuk mencoba mempersiapkan ini. Saya akan mencoba bermigrasi ke wiki di akun pribadi saya. Sejauh yang saya lihat, saya hanya dapat memigrasikan versi terbaru dari wiki dan beberapa penyesuaian manual diperlukan.

Saya mencoba memigrasikan file wiki ke github. Hasilnya terlihat di repo ini . Masih ada beberapa modifikasi kecil yang diperlukan (seperti menghapus kesalahan ketik, mengganti nama halaman, mengatur file, dll).

Sayangnya, ekspor otomatis ke XML (cara standar untuk mengekspor dari mediawiki) memiliki beberapa kelemahan. Dengan cara ini, riwayat halaman hilang dan tidak ada file media yang diekspor. Saya mengunduhnya secara manual tetapi metadata (seperti judul dan teks alternatif) tidak di-porting. Juga, wiki github sedikit lebih terbatas daripada Mediawiki yang menyebabkan misalnya daftar subhalaman tidak mungkin sejauh yang saya tahu.

@Drachenkaetzchen Saya akan meminta Anda untuk memverifikasi bahwa wiki dapat digunakan dengan cara ini. Kemudian, Anda cukup menginstal halaman dari repo saya di halaman Partkeepr jika ini baik untuk Anda. Hubungi saya jika ada pertanyaan, saya akan sangat senang dan bangga membantu.
PS: Saya menambahkan Anda sebagai kolaborator ke repo sehingga Anda dapat bermain-main dengannya.

Semua orang lain dipersilakan untuk melihat melalui wiki mencari kesalahan yang saya lewatkan.

@Drachenkaetzchen Saya akan meminta Anda untuk memverifikasi bahwa wiki dapat digunakan dengan cara ini.

Saya bingung, apa sebenarnya yang harus saya verifikasi?

Saya mem-porting wiki ke github. Silakan periksa apakah pekerjaan ini dapat diterima oleh standar kualitas Anda dan saya tidak mengacaukan sepenuhnya.

Saya pikir Anda harus bertanya kepada pengguna ;) Saya jarang menggunakan wiki.

Saya sarankan untuk meminta umpan balik di milis

Saya meninggalkan pesan di milis . Referensi silang di sini hanya untuk penyelesaian.

Saya menyarankan agar kita menggunakan Halaman github daripada wiki github. Kami akan memiliki lebih banyak opsi mengenai organisasi file di sana dan tidak ada perbedaan besar antara kedua solusi tersebut. Apakah ada opsi yang wiki github mungkin lebih cocok?

@Drachenkaetzchen Saya tidak mendapatkan banyak perhatian dan tanggapan dari pengguna lain mengenai migrasi wiki. Apakah Anda memiliki jadwal atau bagaimana kita melanjutkan di sini? Saya akan menyiapkan migrasi dalam hal membuat tautan berfungsi dan nama file berguna. Karena ini adalah pekerjaan manual, saya lebih suka untuk tidak melakukannya, jika tidak digunakan nanti.

Saya benar-benar tidak bisa memberikan umpan balik. Saya hanya dapat melakukan hal-hal admin tulang telanjang untuk proyek tersebut.

Oke, kalau begitu saya minta @dromer untuk memberikan pendapatnya.

Hai semuanya, saya belum melihat diskusi tentang memigrasikan wiki ke github.

Saya pikir masuk akal untuk memusatkan semua info yang kita miliki ke dalam satu sumber daya. Tetapi juga info yang kami migrasikan harus relevan dan dipangkas dari hal-hal lama.

Pengalaman saya dengan wiki dan halaman github hampir tidak ada jadi saya tidak bisa berkomentar di sana.

[edit: ah halaman akan seperti situs jekyll atau sesuatu. ada preferensi untuk autoformatter?]

ah halaman akan menjadi seperti situs jekyll atau sesuatu.

Yap, kurang lebih begitu. wiki btw juga. Perbedaannya adalah bahwa halaman dimaksudkan untuk digunakan untuk sebuah situs sedangkan wiki untuk kumpulan kasar dari potongan informasi yang kurang lebih pendek yang tidak diurutkan/diatur. Ini membuat saya (selama pengujian pertama migrasi saya) menyebabkan beberapa masalah karena nama file secara otomatis ditebak oleh server yang mendasarinya, misalnya sensitivitas huruf menyebabkan masalah.

Apakah yang Anda maksud: kalimat

ada preferensi untuk autoformatter?

Apakah yang Anda maksud: gaya/tata letak

Maaf maksud saya generator situs. Saya percaya halaman github dapat menggunakan yang lain selain jekyll?

Saya tidak yakin jekyll akan menjadi cara termudah/terbaik untuk mengatur wiki, apa keuntungannya dibandingkan wiki github?

Saya tidak berpikir kita harus meng-host situs web partkeeper utama dulu, mari fokus pada sumber informasi terkini seperti wiki.

Ada beberapa halaman yang terfragmentasi di wiki github juga saya pikir. Ini semua harus digabungkan dengan hanya informasi yang relevan dan benar untuk keadaan proyek saat ini.

Maaf maksud saya generator situs. Saya percaya halaman github dapat menggunakan yang lain selain jekyll?

Tidak masalah. Bisa jadi, saya belum menyelesaikannya sepenuhnya.

Saya tidak yakin jekyll akan menjadi cara termudah/terbaik untuk mengatur wiki, apa keuntungannya dibandingkan wiki github?

Yah, perbedaannya kecil sejujurnya sejauh yang saya lihat. Keduanya mengambil penurunan harga (atau format apa pun yang dapat dibaca pandoc) dan memformatnya dengan cara yang baik.
Saya menemukan masalah, bahwa wiki tidak mengizinkan ruang nama dan pemetaan antara tautan dan nama file yang sesuai adalah semacam heuristik:

  • Wiki berisi dua halaman yang hanya berbeda dalam hal judulnya ( 1 , 2 ). Saya harus menghapus salah satunya secara manual untuk membuat heuristik memilih yang benar.
  • Subfolder (digunakan sebagai semacam penspasian nama) hanya dapat dibuat saat check out menggunakan git secara manual. Tautan tidak menghormati jarak nama ini sehingga Anda hanya dapat memiliki setiap nama file satu kali, membuat struktur folder menjadi kontra-praktis. Saya tidak tahu bagaimana github memilih halaman yang akan diberi nama jika dua file memiliki nama yang sama.

Satu keuntungan tambahan dari solusi Halaman github adalah Anda dapat menjalankan jekyll secara lokal untuk memeriksa tampilan dan semua tautan tanpa mempublikasikannya. Juga saya pikir Anda bisa melakukan lebih banyak gaya (tapi saya harus memeriksanya).

Saya tidak berpikir kita harus meng-host situs web partkeeper utama dulu, mari fokus pada sumber informasi terkini seperti wiki.

Tidak, saya pikir ini terletak saat ini di lokasi yang baik.
Meskipun saya mungkin ingin menunjukkan bahwa ada (?) ide menggunakan github untuk beranda utama. Jika diperlukan, seseorang dapat bermigrasi ke github (jika situasi keuangan Drachenkaetzchen memburuk sehingga dia memiliki masalah untuk membayar server).

Inti dari masalah ini adalah untuk mempertahankan wiki saat ini jika server mati.

Ada beberapa halaman yang terfragmentasi di wiki github juga saya pikir. Ini semua harus digabungkan dengan hanya informasi yang relevan dan benar untuk keadaan proyek saat ini.

Iya dan tidak. Itu harus terkait dengan versi perangkat lunak terbaru. Namun saya pikir dokumentasinya relatif rendah dalam proyek ini. Saya tahu kami kekurangan tenaga tetapi tanpa dokumentasi, pengguna memiliki lebih banyak masalah untuk melihat bagaimana fungsionalitas perangkat lunak bekerja.
Jadi saya berjanji untuk memperbarui dokumen ke versi terbaru tetapi tetap misalnya panduan migrasi dari negara bagian yang lebih lama, apalagi ini untuk versi yang sangat ketinggalan jaman dalam beberapa waktu (mungkin membagi beberapa halaman untuk membuatnya lebih mudah dibaca).

Saya berharap kami mendapatkan daya tarik di komunitas (Anda mungkin menertawakan pemikiran optimis saya) yang membantu dengan menambahkan petunjuk dan trik cara mengatur sesuatu. Selama beberapa hari terakhir ketika saya bekerja melalui isu-isu kuno, saya melihat beberapa ide bagus dari anggota komunitas, yang mungkin layak disebutkan di halaman seperti wiki.

Saya senang bagaimanapun juga.. tetapi memiliki seorang pengelola akan menjadi ide yang bagus... pengalaman saya adalah bahwa hal-hal ini menua dengan cepat

Itu benar. Maksud Anda satu orang yang hanya berdedikasi untuk menjaga agar dokumentasi tetap mutakhir?

Saya akan baik-baik saja untuk membantu proyek dengan cara ini juga. Jangan salah memahami saya: Saya tidak mendesak ke posisi ini. Itu harus diputuskan secara mufakat.
Saat ini tidak banyak hal baru yang perlu didokumentasikan. Terutama memperbarui yang sudah ada. Ini mungkin berubah jika proyek mendapat daya tarik lagi dan kode baru ditulis/diubah. Kemudian pengelola dokumentasi bergantung pada dukungan pengembang dalam arti bahwa pengelola tidak mampu memahami semua detail teknis.

Saya memiliki sedikit lebih banyak energi hari ini, jadi inilah beberapa pemikiran:

  • Wiki saat ini mempersulit orang untuk berkontribusi dokumentasi karena saya harus menonaktifkan pendaftaran, mengharuskan saya untuk membuat pengguna secara manual
  • Wiki terintegrasi GitHub membuat navigasi menjadi sulit, terutama jika ada banyak halaman yang tidak ditautkan dengan benar dari halaman utama.
  • Harus mudah untuk berkontribusi dokumentasi. Lebih disukai di mana pengguna cukup mengklik tombol "Edit Halaman" untuk mengedit konten yang ada, dan tombol untuk membuat konten baru. Contoh yang saya suka dapat ditemukan di sini: http://marlinfw.org/docs/configuration/configuration.html - perubahan akan menghasilkan permintaan tarik sehingga dapat ditinjau dan ditautkan dengan benar oleh pengelola dokumentasi
  • Namun, pada contoh sebelumnya tidak ada tombol "Halaman Baru", tidak yakin bagaimana ini bisa dilakukan
  • Wiki saat ini mempersulit orang untuk berkontribusi dokumentasi karena saya harus menonaktifkan pendaftaran, mengharuskan saya untuk membuat pengguna secara manual

Itu entah bagaimana kontradiksi dengan wiki tapi saya mengerti kebutuhannya.

  • Wiki terintegrasi GitHub membuat navigasi menjadi sulit, terutama jika ada banyak halaman yang tidak ditautkan dengan benar dari halaman utama.

Itu benar sekali. Saya tidak merasa sangat estetis bagaimana wiki dibangun. Kita harus memastikan bahwa terdapat jaring tautan yang bagus di seluruh wiki untuk menyederhanakan navigasi.

  • Harus mudah untuk berkontribusi dokumentasi. Lebih disukai di mana pengguna cukup mengklik tombol "Edit Halaman" untuk mengedit konten yang ada, dan tombol untuk membuat konten baru. Contoh yang saya suka dapat ditemukan di sini: http://marlinfw.org/docs/configuration/configuration.html - perubahan akan menghasilkan permintaan tarik sehingga dapat ditinjau dan ditautkan dengan benar oleh pengelola dokumentasi
  • Namun, pada contoh sebelumnya tidak ada tombol "Halaman Baru", tidak yakin bagaimana ini bisa dilakukan

Mereka menggunakan fitur halaman github tetapi dalam pengaturan yang lebih rumit daripada yang dasar. Saya belum melewati semuanya tapi saya bisa melihat ke dalam berbagai hal...

Pengguna secara aktif mengumpulkan informasi di WIKI lokal yang dibagikan di https://readthedocs.web.cern.ch/display/PARTK
Dia telah menawarkan untuk mentransfer informasi ini ke lokasi yang berbeda, tetapi panduan dari tim proyek diminta. Utas untuk ini dapat ditemukan di Grup Google PartKeepr https://groups.google.com/g/partkeepr-users/c/ehqapXqyY0o/m/1VWkA00dDAAJ

Apakah halaman ini membantu?
0 / 5 - 0 peringkat

Masalah terkait

HolgerHeckeroth picture HolgerHeckeroth  ·  4Komentar

FinalHopee picture FinalHopee  ·  32Komentar

christianlupus picture christianlupus  ·  55Komentar

dani2bunny picture dani2bunny  ·  24Komentar

WickedAx picture WickedAx  ·  11Komentar