Ina tsammanin na ba da dama na gabatarwa ga abokan aiki, abokan ciniki, da magana da jama'a a cikin aikina na IT. Shekaru da yawa, Powerpoint ya kasance zaɓi na halitta kuma abin dogaro a gare ni azaman kayan aikin samarwa. Amma a bana yanayin ya canza sosai. Daga Fabrairu zuwa Mayu, na sami damar yin magana a tarurruka biyar, kuma za a shirya zane-zane don rahotanni a cikin ɗan gajeren lokaci, amma tare da inganci. Tambayar ta taso game da ba da wannan ɓangaren aikin game da zane na gani na nunin faifai ga wasu mutane. Na taɓa ƙoƙarin yin aiki tare da mai zane, aika fayilolin .pptx ta mail, amma aikin ya zama hargitsi: babu wanda ya san wane nau'in nunin faifai shine "sabuwar", kuma shimfidar wuri tana "motsi" saboda bambanci a cikin Powerpoint. iri da kuma fonts akan injin mu. Kuma na yanke shawarar gwada wani sabon abu. Na gwada shi, kuma tun lokacin ban yi tunanin komawa Powerpoint ba.
Me muke so
Kimanin shekara guda da rabi da suka wuce, kamfaninmu ya dakatar da amfani da Word don ƙirƙirar takardun aikin, tun da yake fuskantar matsaloli iri ɗaya: ko da yake Kalma yana da kyau don buga ƙaramin takarda, yayin da girma ya girma, matsaloli sun taso tare da haɗin gwiwa da samun high quality- ƙira ɗaya. Zabinmu ya fadi , kuma ba mu daina yin farin ciki da wannan zaɓin ba, amma wannan batu ne na wani labarin dabam. Kusan lokaci guda, mun koyi tasirin ɗayan ka'idodin DevOps na "komai azaman lamba", don haka zaɓin buƙatun sabuwar fasaha don ƙirƙirar nunin faifai ya kasance a bayyane:
- Gabatarwa dole ne ya zama fayil ɗin rubutu a sarari a cikin yaren ƙira.
- Zane-zanenmu game da ayyukan ci gaba ne, don haka alamar ya kamata a sauƙaƙe sakawa, ba tare da yin amfani da tsarin waje ba
- ɓangarorin code tare da nuna alamar syntax,
- zane-zane masu sauƙi a cikin nau'i na siffofi na geometric da aka haɗa ta kiban,
- Zane-zane na UML, sigogi masu gudana da ƙari.
- Dole ne a adana daftarin gabatarwa a cikin tsarin sarrafa sigar.
- Tabbatarwa da haɗuwa da ƙãre nunin faifai ya kamata a yi a cikin tsarin CI.
A yau, akwai zaɓuɓɓukan asali guda biyu don ƙirƙirar nunin faifai a cikin yarukan ƙira: fakiti don LaTeX ko ɗaya daga cikin tsarin don ƙirƙirar nunin faifai ta amfani da HTML/CSS (, , da sauran su).
Kodayake raina yana cikin LaTeX, hankalina ya yanke shawarar cewa zaɓin mafita wanda ba ni kaɗai nake amfani da shi ba ya kamata ya kasance a gefen hanyar da aka saba da da'irar mutane. Ba kowa ya san LaTeX ba, kuma idan ayyukan ku na yau da kullun ba su da alaƙa da rubuta labaran kimiyya, to da alama ba za ku sami lokaci don nutsar da kanku cikin babbar duniyar wannan tsarin ba.
Duk da haka, ƙwarewar HTML/CSS ba daidai ba ce fasaha ce ta yaɗuwa: Ni, alal misali, na yi nisa da cikakkiyar ƙwarewa a ciki. Abin farin ciki, sanannen AsciiDoctor ya zo don ceto: mai canzawa yana ba ku damar ƙirƙirar nunin faifai na RevealJS ta amfani da alamar AsciiDoctor. Kuma yana da sauƙin koyo da samun dama ga kowa da kowa!
Yadda ake code slides
Don fahimtar ainihin ma'anar rikodin nunin faifai akan AsciiDoctor, hanya mafi sauƙi ita ce ba da takamaiman misalai. Waɗannan duka suna daga ainihin nunin faifai da na yi don gabatar da tarona a wannan shekara.
Zamewa mai take da jeri a cikin abubuwan buɗe ɗaya bayan ɗaya:
== Зачем нам Streams API?
[%step]
* Real-time stream processing
* Stream-like API (map / reduce)
* Под капотом:
** Автоматический offset commit
** Ребалансировка
** Внутреннее состояние обработчиков
** Легкое масштабированиеsakamakon
Takaitaccen labari da lambar tushe tare da nuna alama:
== Kafka Streams API: общая структура KStreams-приложения
[source,java]
----
StreamsConfig config = ...;
//Здесь устанавливаем всякие опции
Topology topology = new StreamsBuilder()
//Здесь строим топологию
....build();
----sakamakon
A cikin shirye-shiryen magana, lambobin demos suna jujjuya maimaitawa da haɓakawa, don haka ikon yin kwafin da sauri da liƙa "lambar raye-raye" kai tsaye a cikin faifai yana da matukar amfani, tabbatar da cewa demo ya kasance har zuwa kwanan wata ba tare da damuwa game da nuna alamar syntax ba.
Take, hoto da rubutu (tsari akan faifai ana yin shi a cikin sel ):
== Kafka Streams in Action
[.custom-style]
[cols="30a,70a"]
|===
|image::KSIA.jpg[]
|
* **William Bejeck**, +
“Kafka Streams in Action”, November 2018
* Примеры кода для Kafka 1.0
|===sakamakon
Wani lokaci ba a buƙatar take, kuma don kwatanta batun ku kawai kuna buƙatar cikakken hoton allo:
[%notitle]
== Жить в легаси нелегко
image::swampman.jpg[canvas, size=cover]sakamakon
Sau da yawa ra'ayi yana buƙatar goyan bayan zane mai sauƙi, a cikin nau'i na "squares da aka haɗa da kiban." An yi sa'a, AsciiDoctor an haɗa shi da tsarin - harshen da ke ba ka damar siffanta zane-zane bisa ga bayanin maƙasudi da haɗin kai tsakanin su. Graphviz yana ɗaukar tsarin koyo, amma bisa misalan da aka bayar, yana da sauƙin yi! Ga yadda yake kama:
== Пишем “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;}
}
-----sakamakon
A cikin yanayin lokacin da ya wajaba don gyara taken a kan adadi, canza shugabanci na kibiya, da dai sauransu, ana iya yin wannan kai tsaye a cikin lambar gabatarwa, maimakon sake sake hoton wani wuri kuma sake shigar da shi a cikin zane. Wannan yana ƙara saurin aiki akan nunin faifai.
Misali mafi rikitarwa:
== Невоспроизводимая сборка
[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;}
}
-----sakamakon
Af, yana da dacewa don gwaji tare da Graphviz da cire hotuna akan shafin .
A ƙarshe, idan kuna buƙatar saka taswira mai gudana, zanen aji ko wasu madaidaitan zane a cikin faifan, to, wani tsarin da aka haɗa tare da AsciiDoctor na iya zuwa don ceto, . Abokin aiki na Nikolai Potashnikov ya rubuta game da fa'idar iyawar PlantUML .
Juya aikin gabatarwa cikin lambar da aka adana akan tsarin sarrafa sigar yana ba da damar tsara aikin haɗin gwiwa akan gabatarwar, da farko, don raba ayyukan ƙirƙirar abun ciki da ƙira. Zane na nunin faifai (fonts, bangon bango, indents) a cikin RevealJS an bayyana ta ta amfani da CSS. Ƙwarewa na da CSS ya fi dacewa da ita - amma ba abin tsoro ba ne idan akwai mutanen da ke aiki tare da CSS da yawa da sauri fiye da ni. A sakamakon haka, ya bayyana cewa tare da ƙaddamarwa da sauri don gabatarwa, za mu iya aiki a kan fayiloli daban-daban a lokaci guda ta hanyar Git da haɓaka saurin haɗin gwiwar da ba zai yiwu ba lokacin aika fayilolin .pptx ta hanyar wasiku.
Gina shafin HTML tare da nunin faifai
Tushen rubutu a sarari suna da kyau, amma ta yaya kuke haɗa su cikin gabatarwar kanta?
AsciiDoctor wani aiki ne da aka rubuta a cikin Ruby, kuma akwai hanyoyi da yawa don gudanar da shi. Da farko, zaku iya shigar da yaren Ruby kuma ku gudanar da asciidoctor kai tsaye, wanda tabbas shine mafi kusanci ga masu haɓaka Ruby.
Idan ba kwa son yin rikici tare da shigar Ruby, zaku iya amfani da hoton docker , wanda idan an ƙaddamar da shi, zaku iya haɗa babban fayil ɗin tare da tushen aikin ta hanyar VOLUME kuma ku sami sakamakon a wani wuri da aka bayar.
Zaɓin da na zaɓa na iya zama kamar ba zato ba tsammani, amma shine mafi dacewa a gare ni a matsayin mai haɓaka Java. Baya buƙatar shigarwa na Ruby ko docker, amma yana ba ku damar ƙirƙirar nunin faifai ta amfani da rubutun Maven.
Ma'anar ita ce aikin - Yin aiwatar da Java na yaren Ruby yana da kyau sosai ta yadda zai baka damar gudanar da kusan duk wani abu da aka kirkira don Ruby a cikin injin Java, kuma gudanar da AsciiDoctor yana daya daga cikin mafi yawan amfani da JRuby.
kasancewa yana ba ku damar tattara takaddun AsciiDoctor waɗanda ke cikin aikin Java (wanda muke amfani da shi sosai). A lokaci guda, AsciiDoctor da JRuby suna saukewa ta atomatik ta Maven, kuma AsciiDoctor yana gudana a cikin yanayin JRuby: babu buƙatar shigar da wani abu akan injin! ( Banda kunshin graphviz, wanda ake buƙata idan kuna son amfani da zane-zane na GraphViz ko PlantUML.) Kawai sanya fayilolin .adoc ɗinku a cikin babban fayil. src/main/asciidoc/. Anan tattara nunin faifai tare da zane-zane.
Maida nunin faifai zuwa PDF
Ko da yake HTML version na nunin faifai isasshe isa da kansa, har yanzu ya zama dole a sami PDF version na nunin faifai. Da fari dai, yana faruwa cewa a wasu tarurrukan da ba su ba mai magana damar haɗa kwamfutar tafi-da-gidanka ba, suna buƙatar nunin faifai “daidai cikin tsarin pptx ko pdf,” ba tare da tsammanin cewa suma suna cikin HTML ba. Abu na biyu, yana da kyau ka aika masu shirya sigar nunin faifan bidiyo ɗinku da ba a gyara su ba kamar yadda aka nuna su a rahoton, a cikin tsarin PDF don buga fayil ɗin a cikin kayan taron.
Abin farin ciki, mai amfani na Node.js yana gudanar da wannan aikin. , gina a kan tushe - tsarin sarrafa kansa don sarrafa burauzar Chrome. Kuna iya canza gabatarwar RevealJS zuwa PDF tare da umarnin
node decktape.js -s 3200x1800 --slides 1-500
reveal "file:///index.html?fragments=true" slides.pdf Dabaru guda biyu lokacin ƙaddamar da decktape, waɗanda dole ne mu fito da su ta hanyar gwaji da kuskure:
-
ƙuduri ta hanyar siga
-sdole ne a kayyade tare da gefe mai ninki biyu, in ba haka ba za a iya samun matsaloli tare da sakamakon juyawa -
a cikin URL na sigar HTML na gabatarwa kuna buƙatar wuce siga
?fragments=true, wanda zai ƙirƙiri wani shafi na PDF daban don kowane matsakaicin yanayin faifan ku (misali, shafuka biyar don maki biyar idan an nuna su ɗaya bayan ɗaya). Wannan zai ba ka damar amfani da irin wannan PDF da kansa a matsayin gabatarwa yayin rahoto.
Haɗawa ta atomatik da bugawa akan yanar gizo
Yana da dacewa lokacin da aka haɗa nunin faifai ta atomatik lokacin da aka yi canje-canje ga tsarin sarrafa sigar, har ma ya fi dacewa lokacin da aka haɗa nunin faifai ta atomatik akan Intanet don amfanin jama'a. Za a iya yin sauƙin yin “wasa” nunin faifai daga Intanet a gaban masu sauraro daga kowace na'ura da aka haɗa da Intanet da na'urar daukar hoto.
Tun da muke amfani da GitHub a cikin aikinmu, zaɓin yanayi na tsarin CI shine , kuma don ɗaukar shirye-shiryen gabatarwa - . Manufar da ke bayan github.io ita ce duk wani abun ciki na tsaye da aka buga zuwa reshe gh-pages na aikin ku akan GitHub, yana samuwa a <ваше имя>.gihub.io/<ваш проект>.
Cikakken fayil ɗin sanyi na TravisCI, gami da haɗa nau'in HTML na shafin ta amfani da Maven, juyawa zuwa PDF ta amfani da decktape, da loda sakamakon zuwa zaren. gh-pages don bugawa akan github.io, yayi kama .
Don gina irin wannan aikin a gefen TravisCI, kuna buƙatar saita masu canjin yanayi
GH_REF- darajar kamar github.com/inponomarev/csa-hbGH_TOKEN- Alamar samun damar GitHub. Kuna iya samun ta daga GitHub a cikin saitunan bayanan martabarku, Saitunan Masu haɓakawa -> Alamomin shiga na sirri. Idan kun ɗora gabatarwa zuwa ma'ajiyar jama'a, to don wannan alamar ya isa ya ƙayyade matakin samun damar kawai "Samar da wuraren ajiyar jama'a".GH_USER_EMAIL/GH_USER_NAME- suna / imel ɗin imel a madadin wanda za a aiwatar da turawa zuwa reshegh-pages.
Don haka, kowane ƙaddamar da lambar gabatarwa akan GitHub yana haifar da nunin nunin faifai ana sake gina su ta atomatik cikin tsarin HTML da PDF kuma a sake loda su zuwa github.io. (Hakika, yakamata ku loda wa github.io waɗancan gabatarwar waɗanda a ƙarshe kuke son bayyanawa jama'a.)
Misalai na ayyuka
A ƙarshe, a nan akwai hanyoyin haɗin kai zuwa wasu misalan misalai na ayyukan gabatarwa tare da rubutun Maven na musamman da tsarin CI don Travis-CI, waɗanda za a iya cloned da amfani da su yayin ƙirƙirar ayyukan gabatar da ku:
-
(magana na don JPoint 2019)
-
(rahoto na na Heisenbug 2019)
Barka da Powerpoint! Ba na tsammanin zan taɓa buƙatar ku don gabatarwar fasaha :)
source: www.habr.com