Pengekod, inilah alat persembahan JavaScript yang anda sukai

Salah satu tugas saya adalah mengembangkan dan mengekalkan persembahan teknikal. Dahulu saya menyimpan persembahan ini di Google Drive dalam format Keynote Apple. Keynote, seperti banyak aplikasi suite pejabat, menyimpan failnya sebagai gumpalan binari lemak besar. Apabila beberapa orang mengubahsuai persembahan dan cuba memperbaruinya, anda menghadapi masalah. Orang-orang diam-diam mengagumi perubahan satu sama lain.

Gangguan ini tidak unik untuk Keynote. PowerPoint dan format lain mengalami masalah yang sama. Walaupun PowerPoint secara teorinya mempunyai fail berasaskan XML, file itu dibungkus dalam Zip, jadi tidak ada cara praktikal untuk menggabungkan perubahan pada tingkat file.

Masalah lain dengan Keynote adalah bahawa walaupun terdapat slaid master, perkara yang disisipkan ke slaid harus diformat dengan teliti. WYSIWIG hebat dan mengerikan pada masa yang sama. Perkara yang ditampal ke dalam slaid mesti diformat dengan penuh cinta. Ini biasanya bermaksud bahawa walaupun master konsisten, kandungannya sering berbeza dalam format: jarak sedikit, pilihan fon tidak berjenama, dan warna menjadi liar.

Dalam dunia yang ideal, anda akan menyimpan persembahan di GitHub sama seperti kod dan menulis persembahan dalam format yang dipermudah seperti Markdown tanpa perlu mengetahui gayanya. Orang UI / jenama atau lelaki boleh melakukan semua "barang cantik" di hadapan CSS semasa anda berfalsafah dalam prosa buletis anda.

Itulah sumber terbuka, alat tayangan slaid dalam penyemak imbas Remark.js membolehkan anda melakukannya. 

Pembentangan teknikal yang boleh diperhatikan

Dengan Remark.js, anda mempunyai satu fail HTML dan seberapa banyak fail CSS, tetapi persembahan anda terpisah dengan rasa Markdown. Anda boleh menyimpan semuanya di GitHub. Bahkan terdapat mod penyampai untuk membolehkan anda melihat nota anda semasa penonton melihat visual anda yang cemerlang.

Seperti namanya, Remark.js adalah perpustakaan JavaScript. Seperti mana-mana perpustakaan JavaScript terdapat seperti 50 pelaksanaan alternatif. Yang paling menarik perhatian saya secara visual ialah Reveal.js.

Walaupun Remark.js membolehkan anda menulis sepenuhnya di Markdown dengan taburan HTML atau pelanjutan, Reveal.js membuat anda benar-benar belajar HTML. Saya telah mengatakan bahawa saya tahu HTML pada resume saya sejak tahun 90-an, tetapi seperti saya tahu bagaimana menggunakan kuas cat: Saya membuat perkara-perkara buruk dengan kedua-duanya. Itulah sebabnya saya lebih suka menggunakan Remark.js.

Inilah teks Markdown dan slaid untuk slaid sebenar dari salah satu persembahan saya:

—-

class: left, top

# Fusion Concepts: Collection

* Contains documents

* Associated with actual indexed data and schema

* Associated with a named configuration in Zookeeper

* Logical index that can be spread across multiple servers

* Routing strategy that defines how documents get assigned to shards replica placement strategy that defines how many copies to keep of each document in the collections

* A collection as it exists on an instance of Solr is called a “Core”

???

Script: In short a collection is a logical index that is tied to a whole lot of configuration and process management in the cluster, including how it is configured, replicated, and routed.

—-

Inilah rupa telefon saya (yang boleh saya buat Chromecast):

Andrew C. Oliver

Inilah mod penyampai! Saya boleh mengatur slaid saya, jadi saya dapat membaca skrin saya seperti teleprompter (saya sebenarnya tidak kerana itu akan membuat saya bosan):

Andrew C. Oliver

Apabila anda mengklon persembahan, tetingkap penyemak imbas diselaraskan walaupun anda memasuki mod penyampai pada satu. Penonton anda melihat paparan pada tangkapan skrin pertama. Anda melihat paparan pada detik.

Perkara buruk

Catatan.js jauh dari sempurna. Sangat bagus bagi orang teknikal yang melakukan persembahan teknikal, tetapi saya tidak akan memaksa pasukan penjualan untuk itu. Sekiranya anda mempunyai akaun GitHub, anda mungkin lebih selesa dengan Markdown daripada PowerPoint atau editor WYSIWYG yang berubah-ubah Keynote. Sekiranya anda membaca e-mel anda dengan senang hati di Outlook, anda mungkin tidak akan menyukainya.

Untuk menggunakan ini, anda memerlukan pelayan web tempatan seperti Python SimpleHTTPServer. Saya juga mengesyorkan menggunakan Chrome. Firefox tidak segerak sekiranya saya mengklik. Paparan Penyampai berguna, tetapi tidak ada paparan lakaran kecil untuk orang yang berulang-alik antara slaid.

Sekiranya anda mengatur pembentangan anda sebagai fail yang berasingan, anda harus memanggil semula dan memasukkan semula mod persembahan untuk setiap satu. Slaid gambar dan tajuk mungkin memerlukan tweak CSS menjadi betul. Mana-mana kod yang tidak anda larikan dengan backtics `` akan terpecah (terutamanya regex). Anda juga perlu mengubah CSS agar cetakan ke PDF berbaris tepat.

Setelah anda mengetahui dan menyelesaikan CSS anda, usaha perbandingan untuk membuat persembahan "satu lagi" di Remark.J / Markdown lebih rendah daripada PowerPoint atau Keynote. Menguruskan versi di GitHub secara monumen lebih baik, dan mengetahui bahawa saya dapat menyampaikan dari telefon atau tablet saya membuat saya gembira. Kali berikutnya anda mengadakan persidangan dan menyedari bahan anda semua dikembalikan ke versi sebelumnya, mungkin memikirkan Remark.js.