കോഡായി അവതരണം, അല്ലെങ്കിൽ ഞാൻ എന്തുകൊണ്ട് പവർപോയിന്റ് ഉപയോഗിക്കില്ല

എന്റെ ഐടി കരിയറിൽ സഹപ്രവർത്തകർക്കും ക്ലയന്റുകൾക്കും പൊതു സംസാരത്തിനും ഞാൻ ഡസൻ കണക്കിന് അവതരണങ്ങൾ നൽകിയിട്ടുണ്ടെന്ന് ഞാൻ കരുതുന്നു. നിരവധി വർഷങ്ങളായി, ഒരു സ്ലൈഡ് പ്രൊഡക്ഷൻ ടൂൾ എന്ന നിലയിൽ എനിക്ക് സ്വാഭാവികവും വിശ്വസനീയവുമായ തിരഞ്ഞെടുപ്പാണ് പവർപോയിന്റ്. എന്നാൽ ഈ വർഷം സ്ഥിതി ഗുണപരമായി മാറി. ഫെബ്രുവരി മുതൽ മെയ് വരെ, അഞ്ച് കോൺഫറൻസുകളിൽ സംസാരിക്കാൻ എനിക്ക് അവസരം ലഭിച്ചു, റിപ്പോർട്ടുകൾക്കായുള്ള സ്ലൈഡുകൾ ചുരുങ്ങിയ സമയത്തിനുള്ളിൽ തയ്യാറാക്കണം, എന്നാൽ ഉയർന്ന നിലവാരം. സ്ലൈഡുകളുടെ വിഷ്വൽ ഡിസൈനുമായി ബന്ധപ്പെട്ട ജോലിയുടെ ആ ഭാഗം മറ്റ് ആളുകൾക്ക് ഏൽപ്പിക്കുന്നതിനെക്കുറിച്ച് ചോദ്യം ഉയർന്നു. ഒരിക്കൽ ഞാൻ ഒരു ഡിസൈനറുമായി പ്രവർത്തിക്കാൻ ശ്രമിച്ചു, മെയിൽ വഴി .pptx ഫയലുകൾ അയച്ചു, പക്ഷേ ജോലി കുഴപ്പത്തിലായി: സ്ലൈഡിന്റെ ഏത് പതിപ്പാണ് "ഏറ്റവും പുതിയത്" എന്ന് ആർക്കും അറിയില്ല, പവർപോയിന്റിലെ വ്യത്യാസം കാരണം ലേഔട്ട് "ചലിച്ചു". ഞങ്ങളുടെ മെഷീനുകളിൽ പതിപ്പുകളും ഫോണ്ടുകളും. കൂടാതെ പുതിയ എന്തെങ്കിലും പരീക്ഷിക്കാൻ ഞാൻ തീരുമാനിച്ചു. ഞാൻ ഇത് പരീക്ഷിച്ചു, അതിനുശേഷം പവർപോയിന്റിലേക്ക് മടങ്ങുന്നതിനെക്കുറിച്ച് ഞാൻ ചിന്തിച്ചിട്ടില്ല.

നമുക്ക് എന്താണ് വേണ്ടത്

ഏകദേശം ഒന്നര വർഷം മുമ്പ്, ഞങ്ങളുടെ കമ്പനി പ്രോജക്റ്റ് ഡോക്യുമെന്റേഷൻ സൃഷ്ടിക്കാൻ വേഡ് ഉപയോഗിക്കുന്നത് നിർത്തി, സമാന പ്രശ്നങ്ങൾ നേരിട്ടു: ഒരു ചെറിയ ഡോക്യുമെന്റ് ടൈപ്പുചെയ്യാൻ Word നല്ലതാണെങ്കിലും, വോളിയം വർദ്ധിക്കുന്നതിനനുസരിച്ച്, സഹകരണത്തിലും ഉയർന്ന നിലവാരം നേടുന്നതിലും ബുദ്ധിമുട്ടുകൾ ഉണ്ടാകുന്നു. ഏകീകൃത ഡിസൈൻ. ഞങ്ങളുടെ തിരഞ്ഞെടുപ്പ് വീണു AsciiDoctor, ഈ തിരഞ്ഞെടുപ്പിൽ ഞങ്ങൾ ഒരിക്കലും സന്തോഷിക്കുന്നത് അവസാനിപ്പിക്കില്ല, പക്ഷേ ഇത് ഒരു പ്രത്യേക ലേഖനത്തിനുള്ള വിഷയമാണ്. ഏതാണ്ട് അതേ സമയം, "എല്ലാം കോഡായി" എന്ന DevOps തത്ത്വങ്ങളിലൊന്നിന്റെ ഫലപ്രാപ്തി ഞങ്ങൾ മനസ്സിലാക്കി, അതിനാൽ അവതരണ സ്ലൈഡുകൾ സൃഷ്ടിക്കുന്നതിനുള്ള പുതിയ സാങ്കേതികവിദ്യയുടെ ആവശ്യകതകൾ വളരെ വ്യക്തമാണ്:

1. അവതരണം ഒരു മാർക്ക്അപ്പ് ഭാഷയിൽ ഒരു പ്ലെയിൻ ടെക്സ്റ്റ് ഫയൽ ആയിരിക്കണം.
2. ഞങ്ങളുടെ സ്ലൈഡുകൾ വികസന പദ്ധതികളെ കുറിച്ചുള്ളതാണ്, അതിനാൽ ബാഹ്യ സംവിധാനങ്ങൾ അവലംബിക്കാതെ മാർക്ക്അപ്പ് എളുപ്പത്തിൽ ചേർക്കണം
   • വാക്യഘടന ഹൈലൈറ്റിംഗ് ഉള്ള കോഡ് ശകലങ്ങൾ,
   • അമ്പുകളാൽ ബന്ധിപ്പിച്ച ജ്യാമിതീയ രൂപങ്ങളുടെ രൂപത്തിൽ ലളിതമായ ഡയഗ്രമുകൾ,
   • UML ഡയഗ്രമുകളും ഫ്ലോചാർട്ടുകളും മറ്റും.
3. അവതരണ ഡ്രാഫ്റ്റ് ഒരു പതിപ്പ് നിയന്ത്രണ സംവിധാനത്തിൽ സൂക്ഷിക്കണം.
4. പൂർത്തിയായ സ്ലൈഡുകളുടെ മൂല്യനിർണ്ണയവും അസംബ്ലിയും ഒരു CI സിസ്റ്റത്തിൽ ചെയ്യണം.

ഇന്ന്, മാർക്ക്അപ്പ് ഭാഷകളിൽ സ്ലൈഡുകൾ സൃഷ്ടിക്കുന്നതിന് രണ്ട് അടിസ്ഥാന ഓപ്ഷനുകൾ ഉണ്ട്: പാക്കേജ് ബീമർ LaTeX-ന് അല്ലെങ്കിൽ HTML/CSS ഉപയോഗിച്ച് സ്ലൈഡുകൾ സൃഷ്ടിക്കുന്നതിനുള്ള ചട്ടക്കൂടുകളിൽ ഒന്ന് (വെളിപ്പെടുത്തൽ ജെ.എസ്, അഭിപ്രായം, deck.js കൂടാതെ മറ്റു പലതും).

എന്റെ ആത്മാവ് LaTeX-ൽ കിടക്കുന്നുണ്ടെങ്കിലും, ഞാൻ മാത്രം ഉപയോഗിക്കാത്ത ഒരു പരിഹാരത്തിന്റെ തിരഞ്ഞെടുപ്പ് വിശാലമായ ആളുകൾക്ക് പരിചിതമായ ഒരു പരിഹാരത്തിന്റെ വശത്തായിരിക്കണമെന്ന് എന്റെ മനസ്സ് നിർദ്ദേശിച്ചു. എല്ലാവർക്കും LaTeX അറിയില്ല, നിങ്ങളുടെ ദൈനംദിന പരിശീലനം ശാസ്ത്രീയ ലേഖനങ്ങൾ എഴുതുന്നതുമായി ബന്ധപ്പെട്ടതല്ലെങ്കിൽ, ഈ സിസ്റ്റത്തിന്റെ വലിയ, സങ്കീർണ്ണമായ ലോകത്ത് മുഴുകാൻ നിങ്ങൾക്ക് സമയമുണ്ടാകില്ല.

എന്നിരുന്നാലും, HTML/CSS-ന്റെ വൈദഗ്ധ്യം കൃത്യമായി വ്യാപകമായ ഒരു വൈദഗ്ധ്യമല്ല: ഉദാഹരണത്തിന്, ഞാൻ അതിൽ പൂർണ്ണമായി പ്രാവീണ്യം നേടിയിട്ടില്ല. ഭാഗ്യവശാൽ, ഇതിനകം പരിചിതമായ AsciiDoctor രക്ഷാപ്രവർത്തനത്തിലേക്ക് വരുന്നു: ഒരു കൺവെർട്ടർ asciidoctor-വെളിപ്പെടുത്തുന്നു AsciiDoctor മാർക്ക്അപ്പ് ഉപയോഗിച്ച് RevealJS സ്ലൈഡുകൾ സൃഷ്ടിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്നു. കൂടാതെ ഇത് പഠിക്കാൻ എളുപ്പവും എല്ലാവർക്കും ആക്സസ് ചെയ്യാവുന്നതുമാണ്!

സ്ലൈഡുകൾ എങ്ങനെ കോഡ് ചെയ്യാം

AsciiDoctor-ൽ സ്ലൈഡുകൾ കോഡുചെയ്യുന്നതിന്റെ സാരാംശം മനസിലാക്കാൻ, നിർദ്ദിഷ്ട ഉദാഹരണങ്ങൾ നൽകുക എന്നതാണ് ഏറ്റവും എളുപ്പമുള്ള മാർഗം. ഇവയെല്ലാം ഈ വർഷത്തെ എന്റെ കോൺഫറൻസ് അവതരണങ്ങൾക്കായി ഞാൻ ഉണ്ടാക്കിയ യഥാർത്ഥ സ്ലൈഡുകളിൽ നിന്നുള്ളതാണ്.

ഒന്നിനുപുറകെ ഒന്നായി തുറക്കുന്ന ഇനങ്ങളിലെ ശീർഷകവും ലിസ്റ്റും ഉള്ള ഒരു സ്ലൈഡ്:

== Зачем нам Streams API?

[%step]
* Real-time stream processing
* Stream-like API (map / reduce)
* Под капотом:
** Автоматический offset commit
** Ребалансировка
** Внутреннее состояние обработчиков
** Легкое масштабирование

ഫലം

വാക്യഘടന ഹൈലൈറ്റ് ചെയ്യുന്ന തലക്കെട്ടും സോഴ്‌സ് കോഡ് സ്‌നിപ്പറ്റും:

== Kafka Streams API: общая структура KStreams-приложения

[source,java]
----
StreamsConfig config = ...;
//Здесь устанавливаем всякие опции

Topology topology = new StreamsBuilder()
//Здесь строим топологию
....build();
----

ഫലം

ഒരു സംഭാഷണത്തിനുള്ള തയ്യാറെടുപ്പിൽ, കോഡ് ഡെമോകൾ ആവർത്തിച്ചുള്ള പുനരവലോകനങ്ങൾക്കും മെച്ചപ്പെടുത്തലുകൾക്കും വിധേയമാകുന്നു, അതിനാൽ "റോ കോഡ്" നേരിട്ട് ഒരു സ്ലൈഡിലേക്ക് പകർത്തി ഒട്ടിക്കാനുള്ള കഴിവ് വിലമതിക്കാനാവാത്തതാണ്, വാക്യഘടന ഹൈലൈറ്റിംഗിനെക്കുറിച്ച് ആകുലപ്പെടാതെ ഡെമോ കാലികമാണെന്ന് ഉറപ്പാക്കുന്നു.

ശീർഷകവും ചിത്രീകരണവും വാചകവും (സ്ലൈഡിലെ ലേഔട്ട് സെല്ലുകളിലാണ് ചെയ്യുന്നത് AsciiDoctor പട്ടികകൾ):

== Kafka Streams in Action

[.custom-style]
[cols="30a,70a"]
|===
|image::KSIA.jpg[]
|
* **William Bejeck**, +
“Kafka Streams in Action”, November 2018
* Примеры кода для Kafka 1.0
|===

ഫലം

ചിലപ്പോൾ ഒരു ശീർഷകം ആവശ്യമില്ല, നിങ്ങളുടെ പോയിന്റ് ചിത്രീകരിക്കുന്നതിന് നിങ്ങൾക്ക് ഒരു പൂർണ്ണ സ്‌ക്രീൻ ചിത്രം ആവശ്യമാണ്:

[%notitle]
== Жить в легаси нелегко

image::swampman.jpg[canvas, size=cover]

ഫലം

പലപ്പോഴും ഒരു ആശയത്തെ "അമ്പടയാളങ്ങളാൽ ബന്ധിപ്പിച്ചിരിക്കുന്ന ചതുരങ്ങൾ" എന്ന രൂപത്തിൽ ലളിതമായ ഒരു ഡയഗ്രം പിന്തുണയ്ക്കേണ്ടതുണ്ട്. ഭാഗ്യവശാൽ, AsciiDoctor സിസ്റ്റവുമായി സംയോജിപ്പിച്ചിരിക്കുന്നു ഗ്രാഫ്വിസ് — ഗ്രാഫ് ഡയഗ്രമുകൾ വിവരിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്ന ഒരു ഭാഷ. ഗ്രാഫ്വിസ് ഒരു പഠന വക്രം എടുക്കുന്നു, എന്നാൽ നൽകിയിരിക്കുന്ന ഉദാഹരണങ്ങളെ അടിസ്ഥാനമാക്കി, ഇത് ചെയ്യാൻ വളരെ എളുപ്പമാണ്! ഇത് ഇതുപോലെ കാണപ്പെടുന്നു:

== Пишем “Bet Totalling App”

Какова сумма выплат по сделанным ставкам, если сыграет исход?

[graphviz, "counting-topology.png"]
-----
digraph G {
graph [ dpi = 150 ];
rankdir="LR";
node [fontsize=18; shape="circle"; fixedsize="true"; width="1.1"];
Store [shape="cylinder"; label="Local Store"; fixedsize="true"; width="1.5"]
Source -> MapVal -> Sum -> Sink
Sum -> Store [dir=both; label=" n "]
{rank = same; Store; Sum;}
}
-----

ഫലം

ചിത്രത്തിലെ അടിക്കുറിപ്പ് എഡിറ്റ് ചെയ്യേണ്ടതും അമ്പടയാളത്തിന്റെ ദിശ മാറ്റുന്നതും മറ്റും ആവശ്യമായി വരുമ്പോൾ, ചിത്രം എവിടെയെങ്കിലും വീണ്ടും വരച്ച് സ്ലൈഡിലേക്ക് വീണ്ടും ചേർക്കുന്നതിനുപകരം ഇത് അവതരണ കോഡിൽ നേരിട്ട് ചെയ്യാവുന്നതാണ്. ഇത് സ്ലൈഡുകളിൽ പ്രവർത്തിക്കുന്നതിന്റെ വേഗത ഗണ്യമായി വർദ്ധിപ്പിക്കുന്നു.

കൂടുതൽ സങ്കീർണ്ണമായ ഒരു ഉദാഹരണം:

== Невоспроизводимая сборка
[graphviz, "unstable-update.png"]
-----
digraph G {
  rankdir="LR";
  graph [ dpi = 150 ];
  u -> r0;
  u[shape=plaintext; label="linter updaten+ 13 warnings"]
  r0[shape=point, width = 0]
  r1 -> r0[ arrowhead = none, label="master branch" ];
  r0-> r2 [];   b1 -> b4;  r1->b1
  r1[label="150nwarnings"]
  b1[label="± 0nwarnings"]
  b4[label="± 0nwarnings"]
  b4->r2
  r2[label="163nwarnings", color="red", xlabel=<<font color="red">merge blocked</font>>]
  {rank = same; u; r0; b4;}
}
-----

ഫലം

വഴിയിൽ, പേജിലെ ഗ്രാഫ്വിസ്, ഡീബഗ് ഇമേജുകൾ എന്നിവ ഉപയോഗിച്ച് പരീക്ഷിക്കുന്നത് സൗകര്യപ്രദമാണ് ഗ്രാഫ്വിസ് ഓൺലൈൻ.

അവസാനമായി, നിങ്ങൾക്ക് ഒരു ഫ്ലോചാർട്ട്, ക്ലാസ് ഡയഗ്രം അല്ലെങ്കിൽ മറ്റ് സ്റ്റാൻഡേർഡ് ഡയഗ്രം എന്നിവ ഒരു സ്ലൈഡിലേക്ക് ചേർക്കണമെങ്കിൽ, AsciiDoctor-മായി സംയോജിപ്പിച്ചിരിക്കുന്ന മറ്റൊരു സിസ്റ്റം രക്ഷാപ്രവർത്തനത്തിലേക്ക് വരാം, പ്ലാന്റ്‌യുഎംഎൽ. എന്റെ സഹപ്രവർത്തകൻ നിക്കോളായ് പൊട്ടാഷ്നിക്കോവ് PlantUML-ന്റെ വിപുലമായ കഴിവുകളെക്കുറിച്ച് എഴുതി. പ്രത്യേക പോസ്റ്റ്.

ഒരു പതിപ്പ് നിയന്ത്രണ സംവിധാനത്തിൽ സംഭരിച്ചിരിക്കുന്ന കോഡായി അവതരണ പ്രോജക്റ്റ് മാറ്റുന്നത് അവതരണത്തിൽ സംയുക്ത പ്രവർത്തനങ്ങൾ സംഘടിപ്പിക്കുന്നത് സാധ്യമാക്കുന്നു, ഒന്നാമതായി, ഉള്ളടക്കവും രൂപകൽപ്പനയും സൃഷ്ടിക്കുന്നതിനുള്ള ചുമതലകൾ വേർതിരിക്കുന്നതിന്. RevealJS-ലെ സ്ലൈഡുകളുടെ (ഫോണ്ടുകൾ, പശ്ചാത്തലങ്ങൾ, ഇൻഡന്റുകൾ) രൂപകൽപ്പന CSS ഉപയോഗിച്ച് വിവരിച്ചിരിക്കുന്നു. സി‌എസ്‌എസിലുള്ള എന്റെ വ്യക്തിഗത വൈദഗ്ദ്ധ്യം ഏറ്റവും നന്നായി അറിയിക്കുന്നു ഈ gif - എന്നാൽ എന്നെക്കാൾ വളരെ സമർത്ഥമായും വേഗത്തിലും CSS-ൽ പ്രവർത്തിക്കുന്ന ആളുകൾ ഉള്ളപ്പോൾ അത് ഭയാനകമല്ല. തൽഫലമായി, ഒരു അവതരണത്തിനുള്ള അതിവേഗം അടുക്കുന്ന സമയപരിധിയിൽ, ഞങ്ങൾക്ക് Git വഴി ഒരേസമയം വ്യത്യസ്ത ഫയലുകളിൽ പ്രവർത്തിക്കാനും മെയിൽ വഴി .pptx ഫയലുകൾ അയയ്‌ക്കുമ്പോൾ അസാധ്യമായ സഹകരണ വേഗത വികസിപ്പിക്കാനും കഴിയുമെന്ന് ഇത് മാറുന്നു.

സ്ലൈഡുകൾ ഉപയോഗിച്ച് ഒരു HTML പേജ് നിർമ്മിക്കുന്നു

പ്ലെയിൻ ടെക്‌സ്‌റ്റ് സ്രോതസ്സുകൾ മികച്ചതാണ്, എന്നാൽ അവ എങ്ങനെ അവതരണത്തിലേക്ക് കംപൈൽ ചെയ്യാം?

റൂബിയിൽ എഴുതിയ ഒരു പ്രോജക്റ്റാണ് AsciiDoctor, അത് പ്രവർത്തിപ്പിക്കുന്നതിന് നിരവധി മാർഗങ്ങളുണ്ട്. ആദ്യം, നിങ്ങൾക്ക് റൂബി ഭാഷ ഇൻസ്റ്റാൾ ചെയ്യാനും Asciidoctor നേരിട്ട് പ്രവർത്തിപ്പിക്കാനും കഴിയും, ഇത് റൂബി ഡെവലപ്പർമാർക്ക് ഏറ്റവും അടുത്തുള്ള കാര്യമാണ്.

റൂബി ഇൻസ്റ്റാൾ ചെയ്യുന്നതിൽ നിങ്ങൾക്ക് കുഴപ്പമുണ്ടാക്കാൻ താൽപ്പര്യമില്ലെങ്കിൽ, നിങ്ങൾക്ക് ഡോക്കർ ഇമേജ് ഉപയോഗിക്കാം ആസ്കിഡോക്ടർ/ഡോക്കർ-അസിഡോക്ടർ, ലോഞ്ച് ചെയ്യുമ്പോൾ, നിങ്ങൾക്ക് VOLUME വഴി പ്രോജക്റ്റ് ഉറവിടങ്ങളുമായി ഫോൾഡർ കണക്റ്റുചെയ്യാനും തന്നിരിക്കുന്ന സ്ഥലത്ത് ഫലം നേടാനും കഴിയും.

ഞാൻ തിരഞ്ഞെടുത്ത ഓപ്ഷൻ അൽപ്പം അപ്രതീക്ഷിതമായി തോന്നിയേക്കാം, പക്ഷേ ഒരു ജാവ ഡെവലപ്പർ എന്ന നിലയിൽ ഇത് എനിക്ക് ഏറ്റവും സൗകര്യപ്രദമാണ്. ഇതിന് റൂബി അല്ലെങ്കിൽ ഡോക്കറിന്റെ ഇൻസ്റ്റാളേഷൻ ആവശ്യമില്ല, പക്ഷേ ഒരു മാവൻ സ്ക്രിപ്റ്റ് ഉപയോഗിച്ച് സ്ലൈഡുകൾ സൃഷ്ടിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്നു.

പദ്ധതി എന്നതാണ് കാര്യം ജെ റൂബി - റൂബി ഭാഷയുടെ ജാവ നടപ്പിലാക്കൽ വളരെ മികച്ചതാണ്, റൂബിക്ക് വേണ്ടി സൃഷ്‌ടിച്ച മിക്കവാറും എന്തും ഒരു ജാവ മെഷീനിൽ പ്രവർത്തിപ്പിക്കാൻ ഇത് നിങ്ങളെ അനുവദിക്കുന്നു, കൂടാതെ AsciiDoctor പ്രവർത്തിപ്പിക്കുന്നത് JRuby-യുടെ ഏറ്റവും സാധാരണമായ ഉപയോഗങ്ങളിലൊന്നാണ്.

ലഭ്യത asciidoctor-maven-plugin ഒരു Java പ്രോജക്റ്റിന്റെ ഭാഗമായ (ഞങ്ങൾ സജീവമായി ഉപയോഗിക്കുന്ന) AsciiDoctor ഡോക്യുമെന്റേഷൻ ശേഖരിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്നു. അതേ സമയം, AsciiDoctor ഉം JRuby ഉം Maven സ്വയമേവ ഡൗൺലോഡ് ചെയ്യുന്നു, കൂടാതെ AsciiDoctor JRuby പരിതസ്ഥിതിയിൽ പ്രവർത്തിക്കുന്നു: മെഷീനിൽ ഒന്നും ഇൻസ്റ്റാൾ ചെയ്യേണ്ടതില്ല! (പാക്കേജ് ഒഴികെ graphviz, നിങ്ങൾക്ക് GraphViz അല്ലെങ്കിൽ PlantUML ഗ്രാഫിക്സ് ഉപയോഗിക്കണമെങ്കിൽ ഇത് ആവശ്യമാണ്.) നിങ്ങളുടെ .adoc ഫയലുകൾ ഒരു ഫോൾഡറിൽ സ്ഥാപിക്കുക src/main/asciidoc/. ഇവിടെ ഒരു പോംനിക്കിന്റെ ഉദാഹരണംഡയഗ്രമുകളുള്ള സ്ലൈഡുകൾ ശേഖരിക്കുന്നു.

സ്ലൈഡുകൾ PDF-ലേക്ക് പരിവർത്തനം ചെയ്യുക

സ്ലൈഡുകളുടെ HTML പതിപ്പ് തികച്ചും സ്വയംപര്യാപ്തമാണെങ്കിലും, സ്ലൈഡുകളുടെ ഒരു PDF പതിപ്പ് ഉണ്ടായിരിക്കേണ്ടത് ആവശ്യമാണ്. ഒന്നാമതായി, സ്പീക്കർക്ക് സ്വന്തം ലാപ്‌ടോപ്പ് കണക്റ്റുചെയ്യാനുള്ള അവസരം നൽകാത്ത ചില കോൺഫറൻസുകളിൽ, അവർക്ക് HTML-ലും ഉണ്ടെന്ന് പ്രതീക്ഷിക്കാതെ “കർശനമായി pptx അല്ലെങ്കിൽ pdf ഫോർമാറ്റിൽ” സ്ലൈഡുകൾ ആവശ്യമാണ്. രണ്ടാമതായി, കോൺഫറൻസ് മെറ്റീരിയലുകളിൽ ഫയൽ പ്രസിദ്ധീകരിക്കുന്നതിന്, റിപ്പോർട്ടിൽ കാണിച്ചിരിക്കുന്നതുപോലെ, നിങ്ങളുടെ സ്ലൈഡിന്റെ എഡിറ്റ് ചെയ്യാത്ത പതിപ്പ് സംഘാടകർക്ക് PDF ഫോർമാറ്റിൽ അയയ്ക്കുന്നത് നല്ലതാണ്.

ഭാഗ്യവശാൽ, Node.js യൂട്ടിലിറ്റി ഈ ടാസ്ക്ക് കൈകാര്യം ചെയ്യുന്നു. ഡെക്ക് ടേപ്പ്, അടിസ്ഥാനത്തിൽ നിർമ്മിച്ചിരിക്കുന്നത് പപ്പറ്റിയർ — Chrome ബ്രൗസർ കൈകാര്യം ചെയ്യുന്നതിനുള്ള ഓട്ടോമേഷൻ സംവിധാനങ്ങൾ. കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങൾക്ക് RevealJS അവതരണം PDF-ലേക്ക് പരിവർത്തനം ചെയ്യാൻ കഴിയും

node decktape.js -s 3200x1800 --slides 1-500 
  reveal "file:///index.html?fragments=true" slides.pdf  

ഡെക്ക്‌ടേപ്പ് സമാരംഭിക്കുമ്പോൾ രണ്ട് തന്ത്രങ്ങൾ, ട്രയലിലൂടെയും പിശകിലൂടെയും ഞങ്ങൾ കൊണ്ടുവരേണ്ടതുണ്ട്:

• പാരാമീറ്റർ വഴി റെസലൂഷൻ -s രണ്ട് മടങ്ങ് മാർജിൻ ഉപയോഗിച്ച് വ്യക്തമാക്കണം, അല്ലാത്തപക്ഷം പരിവർത്തന ഫലങ്ങളിൽ പ്രശ്നങ്ങൾ ഉണ്ടാകാം

• അവതരണത്തിന്റെ HTML പതിപ്പിന്റെ URL-ൽ നിങ്ങൾ ഒരു പാരാമീറ്റർ നൽകേണ്ടതുണ്ട് ?fragments=true, ഇത് നിങ്ങളുടെ സ്ലൈഡിന്റെ ഓരോ ഇന്റർമീഡിയറ്റ് അവസ്ഥയ്ക്കും ഒരു പ്രത്യേക PDF പേജ് സൃഷ്ടിക്കും (ഉദാഹരണത്തിന്, അഞ്ച് ബുള്ളറ്റ് പോയിന്റുകൾക്കായി അഞ്ച് പേജുകൾ അവ ഒന്നിനുപുറകെ ഒന്നായി കാണിച്ചാൽ). ഒരു റിപ്പോർട്ടിനിടെ ഒരു അവതരണമായി അത്തരമൊരു PDF സ്വന്തമായി ഉപയോഗിക്കാൻ ഇത് നിങ്ങളെ അനുവദിക്കും.

സ്വയമേവയുള്ള അസംബ്ലിയും വെബിൽ പ്രസിദ്ധീകരിക്കലും

പതിപ്പ് നിയന്ത്രണ സംവിധാനത്തിൽ മാറ്റങ്ങൾ വരുത്തുമ്പോൾ സ്ലൈഡുകൾ സ്വയമേവ കംപൈൽ ചെയ്യുമ്പോൾ ഇത് സൗകര്യപ്രദമാണ്, കൂടാതെ സ്വയമേവ സമാഹരിച്ച സ്ലൈഡുകൾ പൊതു ഉപയോഗത്തിനായി ഇന്റർനെറ്റിൽ പോസ്റ്റുചെയ്യുമ്പോൾ കൂടുതൽ സൗകര്യപ്രദമാണ്. ഇൻറർനെറ്റിൽ നിന്നുള്ള സ്ലൈഡുകൾ ഇന്റർനെറ്റിലേക്കും പ്രൊജക്ടറിലേക്കും കണക്റ്റുചെയ്തിരിക്കുന്ന ഏത് മെഷീനിൽ നിന്നും പ്രേക്ഷകർക്ക് മുന്നിൽ എളുപ്പത്തിൽ "പ്ലേ" ചെയ്യാൻ കഴിയും.

ഞങ്ങളുടെ ജോലിയിൽ ഞങ്ങൾ GitHub ഉപയോഗിക്കുന്നതിനാൽ, ഒരു CI സിസ്റ്റത്തിന്റെ സ്വാഭാവിക തിരഞ്ഞെടുപ്പാണ് ട്രാവിസ്സിഐ, കൂടാതെ റെഡിമെയ്ഡ് അവതരണങ്ങൾ ഹോസ്റ്റുചെയ്യുന്നതിന് - github.io. github.io-യുടെ പിന്നിലെ ആശയം, ഏതെങ്കിലും സ്റ്റാറ്റിക് ഉള്ളടക്കം ഒരു ബ്രാഞ്ചിലേക്ക് പോസ്റ്റ് ചെയ്യുന്നു എന്നതാണ് gh-pages GitHub-ലെ നിങ്ങളുടെ പ്രോജക്‌റ്റ് ഇവിടെ ലഭ്യമാകും <ваше имя>.gihub.io/<ваш проект>.

Maven ഉപയോഗിച്ച് പേജിന്റെ HTML പതിപ്പ് കംപൈൽ ചെയ്യുക, ഡെക്ക്‌ടേപ്പ് ഉപയോഗിച്ച് PDF-ലേക്ക് പരിവർത്തനം ചെയ്യുക, ഫലങ്ങൾ ഒരു ത്രെഡിലേക്ക് അപ്‌ലോഡ് ചെയ്യുക എന്നിവ ഉൾപ്പെടെ TravisCI കോൺഫിഗറേഷൻ ഫയൽ പൂർത്തിയാക്കുക. gh-pages github.io-ലെ പ്രസിദ്ധീകരണത്തിനായി, ഇതുപോലെ കാണപ്പെടുന്നു അതുപോലെ.

TravisCI വശത്ത് അത്തരമൊരു പ്രോജക്റ്റ് നിർമ്മിക്കുന്നതിന്, നിങ്ങൾ പരിസ്ഥിതി വേരിയബിളുകൾ ക്രമീകരിക്കേണ്ടതുണ്ട്

• GH_REF — github.com/inponomarev/csa-hb പോലെയുള്ള മൂല്യം
• GH_TOKEN — GitHub ആക്സസ് ടോക്കൺ. നിങ്ങളുടെ പ്രൊഫൈൽ ക്രമീകരണങ്ങൾ, ഡെവലപ്പർ ക്രമീകരണങ്ങൾ -> വ്യക്തിഗത ആക്സസ് ടോക്കണുകൾ എന്നിവയിൽ GitHub-ൽ നിന്ന് നിങ്ങൾക്ക് ഇത് ലഭിക്കും. നിങ്ങൾ ഒരു പൊതു ശേഖരണത്തിലേക്ക് ഒരു അവതരണം അപ്‌ലോഡ് ചെയ്യുകയാണെങ്കിൽ, ഈ ടോക്കണിനായി "പബ്ലിക് റിപ്പോസിറ്ററികൾ ആക്‌സസ് ചെയ്യുക" എന്ന ആക്‌സസ് ലെവൽ മാത്രം വ്യക്തമാക്കിയാൽ മതിയാകും.
• GH_USER_EMAIL / GH_USER_NAME — പേര്/ഇമെയിൽ ജോഡിയുടെ പേരിൽ ത്രെഡിലേക്കുള്ള പുഷ് നടപ്പിലാക്കും gh-pages.

അങ്ങനെ, GitHub-ലെ അവതരണ കോഡിന്റെ ഓരോ കമ്മിറ്റും സ്ലൈഡുകൾ HTML, PDF ഫോർമാറ്റുകളിൽ സ്വയമേവ പുനർനിർമ്മിക്കുകയും github.io-ലേക്ക് വീണ്ടും അപ്‌ലോഡ് ചെയ്യുകയും ചെയ്യുന്നു. (തീർച്ചയായും, നിങ്ങൾ ആത്യന്തികമായി പരസ്യമാക്കാൻ ആഗ്രഹിക്കുന്ന അവതരണങ്ങൾ മാത്രമേ github.io-ലേക്ക് അപ്‌ലോഡ് ചെയ്യാവൂ.)

പദ്ധതികളുടെ ഉദാഹരണങ്ങൾ

അവസാനമായി, ഇഷ്‌ടാനുസൃതമാക്കിയ മാവൻ സ്‌ക്രിപ്‌റ്റുകളും ട്രാവിസ്-സിഐയ്‌ക്കായുള്ള CI കോൺഫിഗറേഷനും ഉള്ള അവതരണ പ്രോജക്‌റ്റുകളുടെ രണ്ട് ഉദാഹരണങ്ങളിലേക്കുള്ള ലിങ്കുകൾ ഇതാ, നിങ്ങളുടെ സ്വന്തം അവതരണ പ്രോജക്‌റ്റുകൾ സൃഷ്‌ടിക്കുമ്പോൾ ക്ലോൺ ചെയ്യാനും ഉപയോഗിക്കാനും കഴിയും:

• https://github.com/inponomarev/kstreams-examples (JPoint 2019-നുള്ള എന്റെ സംസാരം)

• https://github.com/inponomarev/csa-hb (Heisenbug 2019-നുള്ള എന്റെ റിപ്പോർട്ട്)

വിട പവർപോയിന്റ്! സാങ്കേതിക അവതരണങ്ങൾക്കായി എനിക്ക് നിങ്ങളെ ഒരിക്കലും ആവശ്യമുണ്ടെന്ന് ഞാൻ കരുതുന്നില്ല :)

അവലംബം: www.habr.com