En av oppgavene mine i jobben min er å utvikle og vedlikeholde tekniske presentasjoner. Tidligere har jeg lagret disse presentasjonene på Google Drive i Apples Keynote-format. Keynote lagrer, i likhet med mange kontorpakkeapplikasjoner, filene sine som store, fete binære klatter. Når flere endrer en presentasjon og prøver å oppdatere den, får du problemer. Mennesker klipper hverandres forandringer stille.
Denne irritasjonen er ikke unik for Keynote. PowerPoint og andre formater lider av det samme problemet. Selv om PowerPoint teoretisk har en XML-basert fil, er den pakket inn i en zip, så det er ingen praktisk måte å slå sammen endringer på filnivå.
Et annet problem med Keynote er at mens det er lysbildemestere, må ting som blir limt inn i et lysbilde være nøye formatert. WYSIWIG er flott og forferdelig på samme tid. Ting som limes inn i et lysbilde må formateres med kjærlighet. Dette betyr vanligvis at mens mesteren er konsistent, varierer innholdet ofte i format: avstand er litt av, skriftvalg går utenfor merkevare, og farger blir vilt.
I en ideell verden vil du lagre presentasjoner på GitHub akkurat som kode og skrive presentasjoner i et forenklet format som Markdown uten å kjenne stilen. Brukergrensesnittet / merkevaren eller galgen kunne gjøre alle de "pene greiene" foran i CSS mens du vokser filosofisk i den punktlige prosaen din.
Det er nøyaktig hva lysbildefremvisningsverktøyet med åpen kildekode, i nettleseren Remark.js lar deg gjøre.
Bemerkelsesverdige tekniske presentasjoner
Med Remark.js har du en HTML-fil og hvor mange CSS-filer som helst, men presentasjonen din er separat i en smak av Markdown. Du kan lagre alt på GitHub. Det er til og med en presentatormodus som lar deg se notatene dine mens publikum ser på de strålende bildene dine.
Som navnet antyder, er Remark.js et JavaScript-bibliotek. Som ethvert JavaScript-bibliotek er det som 50 alternative implementeringer. Den mest imponerende for meg visuelt er Reveal.js.
Mens Remark.js lar deg skrive helt i Markdown med sprinkler av HTML eller utvidelser, får Reveal.js deg til å lære HTML. Jeg har sagt at jeg kjenner HTML på CV-en siden 90-tallet, men det er akkurat som jeg vet hvordan jeg bruker en pensel: Jeg lager stygge ting med begge deler. Derfor foretrekker jeg å bruke Remark.js.
Her er Markdown og lysbildeteksten for en faktisk lysbilde fra en av presentasjonene mine:
—-
klasse: venstre, øverst
# Fusion Concepts: Collection
* Inneholder dokumenter
* Assosiert med faktiske indekserte data og skjemaer
* Assosiert med en navngitt konfigurasjon i Zookeeper
* Logisk indeks som kan spres på flere servere
* Rutestrategi som definerer hvordan dokumenter tildeles til plasseringsstrategi for shards replika som definerer hvor mange kopier som skal beholdes av hvert dokument i samlingene
* En samling som den eksisterer på en forekomst av Solr kalles en "Core"
???
Skript: Kort sagt er en samling en logisk indeks som er knyttet til mye konfigurasjon og prosessadministrasjon i klyngen, inkludert hvordan den er konfigurert, replikert og rutet.
—-
Slik ser det ut på telefonen min (som jeg kan Chromecast forresten):
Andrew C. OliverHer er presentatormodus! Jeg kan sette lysbildene mine opp, slik at jeg kan lese skjermen min som en teleprompter (det gjør jeg faktisk ikke fordi det kjeder meg):
Andrew C. OliverNår du kloner en presentasjon, synkroniseres nettleservinduene selv om du går inn i presentatormodus på en. Publikum ser utsikten i det første skjermbildet. Du ser utsikten i den andre.
De dårlige greiene
Remark.js er langt fra perfekt. Det er flott for tekniske folk som holder tekniske presentasjoner, men jeg utsetter ikke salgsteamet for det. Hvis du har en GitHub-konto, er du sannsynligvis mer komfortabel med Markdown enn PowerPoint eller Keynotes ustabile WYSIWYG-editor. Hvis du leser e-posten din villig i Outlook, vil du sannsynligvis ikke like den.
For å bruke dette trenger du en lokal webserver som Python SimpleHTTPServer. Jeg anbefaler også å gå med Chrome. Firefox ble ut av synkronisering hvis jeg klikket meg rundt. Presentatørvisningen er nyttig, men det er ingen miniatyrvisning for folk som går mye frem og tilbake mellom lysbildene.
Hvis du organiserer presentasjonene dine som separate filer, må du gjenskape og gå inn i presentasjonsmodus for hver enkelt. Bilder og tittelbilder kan kreve CSS-justering for å få rett. Enhver kode du ikke unnslipper med `` backtics, vil bli ødelagt (spesielt regex). Du må også tilpasse CSS for å skrive ut til PDF-linjen riktig.
Når du har fått tak i det og får CSS gjort, er den sammenlignende innsatsen for å lage en "presentasjon" i Remark.J's / Markdown lavere enn for PowerPoint eller Keynote. Å administrere versjoner i GitHub er monumentalt bedre, og det å vite at jeg kan presentere fra telefonen eller nettbrettet gjør meg glad. Neste gang du legger på en konferanse og innser at alt materialet ditt er tilbake til tidligere versjoner, kan du tenke på Remark.js.
