Cara Pilih Modul Drupal 7 untuk Melihat PDF

Baru-baru ini, pelanggan meminta saya untuk menambah ciri baru ke laman Drupal syarikat: memaparkan fail PDF dalam penyemak imbas. Semasa saya melihat pilihan di drupal.org, saya menyedari bahawa ini adalah peluang yang sempurna untuk mendokumenkan proses membuat keputusan saya ketika saya memilih modul baru. Saya selalu mengatakan untuk memilih modul secara bijak, tetapi sekarang anda dapat melihat bagaimana saya fikir ini berfungsi dalam kehidupan sebenar.

Tentukan Apa yang Anda Mahu

Langkah pertama ialah menentukan apa yang anda mahukan. Dalam kes saya, saya mahu:

• Keupayaan untuk melihat fail PDF dalam pelayar web, serupa dengan contoh ini. Pelanggan akan memuat naik PDF surat berita syarikat, dan pelawat dapat membaca dengan mudah.
• Laman web ini adalah Drupal 7, jadi modul itu perlu dipadankan dengan versi utama. (Drupal 7 telah keluar untuk sementara waktu sekarang, jadi jika pemaju modul tidak keluar dengan versi Drupal 7 lagi, mereka mungkin tidak akan.)
• Walaupun pelanggan tidak menyatakan ini, saya juga ingin mengelakkan daripada bergantung kepada perkhidmatan pihak ketiga. Untuk video, saya dengan senang hati menyiarkan kandungan itu ke YouTube atau Vimeo dan kemudian membenamkannya di laman Drupal, tetapi untuk PDF, saya tidak fikir kemungkinan pendedahan tambahan akan melebihi potensi kerumitan, kerosakan, dan perbelanjaan. Walau bagaimanapun, saya terbuka kepada perkhidmatan pihak ketiga sekiranya ia satu-satunya pilihan.
• Walaupun ingin menghindari perkhidmatan pihak ketiga, saya tahu pilihan saya mungkin memerlukan Javascript pihak ketiga perpustakaan . Walaupun ini akan menambahkan langkah tambahan pada peningkatan masa depan, saya biasanya merasa lebih baik untuk menjalankan salinan perpustakaan saya sendiri dan bukannya bergantung kepada perkhidmatan pihak ketiga.

• Saya mahu mengekalkan modul sebagai ringan dan khusus yang mungkin. Saya tidak mahu terlibat dengan cara pengendalian atau mengatur fail media yang baru. Saya mahu sesuatu yang lebih seperti Colorbox, yang membesarkan imej untuk tontonan yang lebih baik, tetapi tetap sepenuhnya bebas daripada cara anda memilih untuk menguruskan fail imej. Saya mempunyai firasat bahawa perpustakaan ini akan menjadi pdf.js, tetapi saya terbuka kepada kemungkinan lain.
• Seperti biasa, saya mahu mengikut garis panduan umum untuk memilih modul Drupal. Pada asasnya, memilih modul yang telah digunakan oleh beberapa ribu orang (jika boleh) untuk sementara waktu, dengan sedikit kebergantungan, yang sepertinya dikekalkan oleh pemaju aktif yang merancang untuk terus menyokong projek itu pada masa depan dan tidak ' Tidak memerlukan yuran pelesenan.

Cari Drupal.org

Dengan matlamat ini, langkah seterusnya adalah carian mudah di Drupal.org. Masa untuk melompat ke dalam Lubang Bola Modul Kebaikan.

Halaman "Perbandingan" untuk Modul PDF

Perhentian pertama saya adalah (atau sepatutnya), halaman ini: Perbandingan modul pemapar PDF. Drupal.org mempunyai tradisi laman dokumentasi yang menggariskan kebaikan dan keburukan pelbagai modul dalam ruang yang sama. Terdapat senarai pusat halaman perbandingan, tetapi mereka juga ditaburkan di seluruh laman web ini.

Halaman perbandingan PDF termasuk empat modul penonton PDF. Saya akan melindungi mereka di sini, dan juga pasangan lain yang saya dapati dari mencari. Saya akan mulakan dengan calon yang saya memutuskan untuk melangkau.

Sekarang mari kita bincangkan spesifik mengapa modul ini (atau kebanyakannya tidak) berfungsi untuk projek ini.

Pemapar Fail

Pemapar Fail menggunakan Arkib Internet BookReader, yang menarik minat saya kerana saya seorang peminat Internet Archive. Setiap kali saya pergi ke sana, saya rasa geli takut dan membanjir di gunung-gunung buku yang saya dapat memetik dari eter.

Bahawa dikatakan, laman demonstrasi kelihatan sedikit hodoh kepada saya. Saya mungkin hidup dengannya, tetapi saya meragui pelanggan saya, bilapdf.js kelihatan lebih bergaya.

Juga, pada pandangan kedua di halaman projek, saya melihat pengumuman berani besar di bahagian atas:Modul ini telah dipindahkan ke modul PDF secara rasmi. Cukup adil. Dengan kurang daripada 400 pemasangan, penggabungan dengan modul PDF yang lebih popular (yang akan kami tutup dalam sekejap), kelihatan seperti langkah yang baik. Jangan muat turun modul yang telah digabungkan / dipindahkan / terbengkalai.

Format Penerima Google Viewer

Format Pemapar Google Viewer adalah seperti apa: cara untuk menggunakan Google Docs untuk membenamkan paparan fail di halaman web anda. Walaupun saya suka fleksibiliti Google Docs, salah satu matlamat saya adalah untuk tetap bebas daripada sebarang perkhidmatan pihak ketiga.

Juga, modul ini mempunyai kurang daripada 100 pemasangan.

Penonton Dokumen Ajax

Walaupun "AJAX" adalah istilah umum Javascript, Penampil Dokumen Ajax ternyata bergantung pada perkhidmatan pihak ketiga tertentu. Hanya kira-kira 100 pemasangan. Bergerak …

Scald PDF

Scald PDF hanya mempunyai 40 pemasangan, tetapi saya perlu melihat, kerana ia jelas merupakan sebahagian daripada projek yang lebih besar yang dipanggil (ya) Scald. Seperti yang dijelaskan dalam halaman projek Scald: " Scald adalah cara inovatif untuk mengendalikanAtom Media di Drupal. "

Kalimah itu menimbulkan dua bendera merah besar: "mengambil inovatif" dan perkataan "Media" dipasangkan dengan "Atom". "Atom" jelas merupakan perkataan yang dipungkiri untuk "benda", yang menjadikannya bendera merah semuanya dengan sendirinya. Drupal mempunyai kegemaran untuk kata-kata kotak kosong ini: nod , entiti , ciri … Lebih umum perkataan, lebih banyak menyapu perubahan mungkin.

Ketika saya turun ke bawah, syak wasangka saya telah disahkan. Saya membaca tuntutan gembira tentang bagaimana Scald pada dasarnya akan mencipta semula bagaimana saya mengendalikan Media di laman web saya.

Sekarang, hakikatnya pengendalian Media Drupal boleh menggunakan beberapa pengaturcaraan semula. Scald bukan satu-satunya projek bercita-cita tinggi dalam ruang ini.Bagaimanapun, dengan kurang daripada 1000 pemasangan setakat ini, saya tidak mahu masuk ke tingkat bawah.

Pasti, pada masa ini tahun depan, Scald mungkin Pandangan seterusnya. Itu akan menjadi batu. Tetapi ia juga mungkin ditinggalkan, dengan jejak (kecil) tapak yang rosak ditinggalkan untuk menangis.

Buat masa ini, saya mahu melekat dengan penyelesaian yang kurang bercita-cita tinggi dan berbahaya. Hanya paparkan PDF, sila. Itulah yang saya minta.

Shadowbox

Shadowbox mengejutkan saya: ia mendakwa sebagai penyelesaian tunggal untuk memaparkan semua jenis media, dari PDF ke imej ke video. Ini tidak menyapu sebagai Scald, kerana ia hanya memberi tumpuan memaparkan media tanpa memperkenalkan konsep baru seperti "Atom Media". Tetapi saya sudah seperti Colorbox, seperti yang saya nyatakan. Saya tidak mahu memikirkan semula keputusan itu.

Walau bagaimanapun, saya perhatikan (dengan mengeluh dalam) yang berakhir16,000 memasang, Shadowbox boleh menjadi alternatif yang lebih berkuasa di ruang yang sama. Saya telah untuk melihat.

Modul Shadowbox Drupal pada dasarnya adalah jambatan ke perpustakaan Javascript, Shadowbox.js, jadi saya menyemak laman web perpustakaan. Di sana, saya dapati dua sebab untuk bergerak:

• Perpustakaan memerlukan yuran lesen untuk kegunaan komersil. Yurannya cukup masuk akal, tetapi saya cuba mengelakkan perisian sumber terbuka yang tidak bebas.
• Mencari teliti dari FAQ mendedahkan bahawa, bertentangan dengan perihalan pada halaman modul Drupal, PDF adalah tidak 100% disokong oleh perpustakaan Shadowbox. Oops. Perkara baik saya diperiksa.

The Two Contenders: "PDF" and "PDF Reader"

Setelah menghapuskan selebihnya, saya kini datang ke dua pesaing yang jelas: PDF dan PDF Reader

Kedua-dua projek mempunyai persamaan utama:

• Kedua-duanya mempunyai hampir 3,000 pemasangan, jauh lebih banyak daripada alternatif (kecuali Shadowbox).
• Kedua-duanya menggunakan perpustakaan Javascript luaran yang sama,pdf.js.

Bagaimana dengan perbezaan?

Pembaca PDF juga mempunyai pilihan untuk integrasi Google Docs. Dalam kes ini, saya fikir pelanggan saya mungkin seperti itu, jadi saya suka mempunyai pilihan.

Sementara itu, PDF ditandakan sebagaiMencari penyenggara bersama (s). Itu boleh menjadi tanda bahawa pemaju akan meninggalkan projek itu, tetapi sebaliknya, komitmen terbaru adalah seminggu yang lalu, jadi sekurang-kurangnya pemaju masih aktif.

Selain itu, Pembaca PDF ditandakan sebagaiDikekalkan secara aktif, tetapi komitmen terbaru adalah tahun lalu.

Tanpa pemenang yang jelas, saya memutuskan untuk menguji kedua-duanya.

Menguji Peserta

Saya menguji kedua-dua modul pada salinan tapak langsung saya. (Tidak kira betapa padat dan tidak bersesuaian modul muncul, jangan mencuba terlebih dahulu di tapak langsung. Anda boleh memecahkan keseluruhan laman web anda.)

Saya berat sebelah ke arah Pembaca PDF , kerana ia kelihatan mempunyai lebih banyak pilihan (seperti Google Docs) daripada PDF . Jadi saya memutuskan untuk mencuba PDF pertama, untuk mendapatkannya.

Fail PDF: Penyusunan Diperlukan?

Walau bagaimanapun, apabila saya memasang PDF dan bacaREADME.txt, Saya dapati masalah yang saya lihat tetapi tidak diabaikan di halaman projek. Untuk sebab-sebab tertentu, modul ini seolah-olah menghendaki anda mengkompilasipdf.js secara manual. Walaupun halaman projek mencadangkan bahawa ini tidak semestinya diperlukan,README.txt mencadangkan ia.

Sejak Pembaca PDF akan menggunakan perpustakaan yang sama tanpa memerlukan langkah ini, saya memutuskan untuk mencuba terlebih dahulu. Sekiranya ia tidak berfungsi, saya sentiasa boleh kembali PDF dan cuba menyusun secara manualpdf.js.

Pembaca PDF: Kejayaan! Lebih kurang.

Jadi, pada akhirnya, saya cuba Pembaca PDF . Modul ini menyediakan widget baru untuk memaparkanFail bidang. Anda menambah medan fail ke jenis kandungan yang anda inginkan dan tetapkan jenis widgetPembaca PDF. Kemudian, anda membuat nod jenis ini dan memuat naik PDF anda. PDF muncul dibenamkan dalam "kotak" pada halaman.

Anda boleh mencuba pilihan paparan yang berbeza dengan mengedit semula jenis kandungan dan mengubah tetapan paparan untuk medan.

Saya mendapati bahawa setiap pilihan paparan mempunyai kebaikan dan keburukan:

• TheDokumen Google pembaca berfungsi dengan baik sebagai satu benam, tetapi apabila saya mengkliknya untuk memasuki skrin penuh, saya meloloskan pada halaman Google Docs yang memohon maaf bahawa had laju saya telah melebihi. Oops. Mungkin ini lebih dipercayai jika saya menyambungkan modul ini kepada akaun Google Apps yang membayar, tetapi saya tidak peduli untuk mengetahui, kerana saya yakin pelanggan saya tidak suka paparan.
• Thepdf.js pilihan bekerja hebat … di Firefox dan Chrome. Tetapi apabila saya memecat Internet Explorer, kotak itu kosong. Rupa-rupanya, ini adalah masalah denganpdf.js sendiri, bukan Pembaca PDF modul. Saya rasa saya sepatutnya menjangkakan ini, memandangkan itupdf.js dibangunkan oleh Mozilla dan Internet Explorer … itu sendiri. Namun, saya kecewa kerana saya tidak mengesahkannyapdf.js bekerja dengan pasti di semua pelayar di tempat pertama.
• Themembenamkan pilihan adalah yang paling boleh dipercayai. Ini sebenarnya berlari Adobe Reader dalam kotak di laman web. Firefox saya masih disukai untuk dijalankanpdf.js, tetapi saya fikir ini adalah tetapan penyemak imbas. Sama ada, selagi pelawat mempunyai Firefox atau penampil PDF seperti Adobe Reader, PDF akan dipaparkan.

Oleh itu, pada akhirnya, penyelesaian saya adalah menggunakan Pembaca PDF denganBenamkan pilihan paparan. Pilihan ini akan membolehkan saya melampirkan PDF ke nod Drupal, dan dengan pasti memaparkannya di laman web Drupal.

Malangnya, kadangkala "dipercayai" tidak mencukupi. Selepas semua pencarian ini, saya perlu mempertimbangkan perkhidmatan pihak ketiga selepas semua.