ការបង្ហាញជាកូដ ឬហេតុអ្វីបានជាខ្ញុំលែងប្រើ Powerpoint

ខ្ញុំគិតថាខ្ញុំបានផ្តល់បទបង្ហាញរាប់សិបបទដល់សហសេវិក អតិថិជន និងការនិយាយជាសាធារណៈនៅក្នុងអាជីព IT របស់ខ្ញុំ។ អស់រយៈពេលជាច្រើនឆ្នាំ Powerpoint គឺជាជម្រើសធម្មជាតិ និងគួរឱ្យទុកចិត្តសម្រាប់ខ្ញុំជាឧបករណ៍ផលិតស្លាយ។ ប៉ុន្តែនៅឆ្នាំនេះ ស្ថានភាពបានផ្លាស់ប្តូរគុណភាព។ ចាប់ពីខែកុម្ភៈដល់ខែឧសភា ខ្ញុំមានឱកាសនិយាយនៅក្នុងសន្និសីទចំនួនប្រាំ ហើយស្លាយសម្រាប់របាយការណ៍ត្រូវរៀបចំក្នុងរយៈពេលដ៏ខ្លី ប៉ុន្តែប្រកបដោយគុណភាពខ្ពស់។ សំណួរបានកើតឡើងអំពីការផ្ទេរផ្នែកនោះនៃការងារទាក់ទងនឹងការរចនារូបភាពនៃស្លាយទៅមនុស្សផ្សេងទៀត។ ធ្លាប់បានព្យាយាមធ្វើការជាមួយអ្នករចនាដោយផ្ញើឯកសារ .pptx តាមសំបុត្រ ប៉ុន្តែការងារបានប្រែទៅជាភាពវឹកវរ៖ គ្មាននរណាម្នាក់ដឹងថាកំណែស្លាយណាមួយជា "ថ្មីបំផុត" ហើយប្លង់ "ផ្លាស់ទី" ដោយសារតែភាពខុសគ្នានៅក្នុង Powerpoint កំណែ និងពុម្ពអក្សរនៅលើម៉ាស៊ីនរបស់យើង។ ហើយខ្ញុំបានសម្រេចចិត្តសាកល្បងអ្វីថ្មី។ ខ្ញុំបានសាកល្បងវា ហើយតាំងពីពេលនោះមក ខ្ញុំមិនបានគិតអំពីការត្រលប់ទៅ Powerpoint វិញទេ។

តើយើងចង់បានអ្វី

ប្រហែលមួយឆ្នាំកន្លះកន្លងទៅនេះ ក្រុមហ៊ុនរបស់យើងបានឈប់ប្រើប្រាស់ Word ដើម្បីបង្កើតឯកសារគម្រោង ដោយបានជួបប្រទះបញ្ហាដូចគ្នា៖ ទោះបីជា Word ល្អសម្រាប់ការវាយបញ្ចូលឯកសារតូចមួយ នៅពេលដែលបរិមាណកើនឡើងក៏ដោយ ការលំបាកកើតឡើងជាមួយនឹងការសហការ និងការទទួលបានគុណភាពខ្ពស់ និង ការរចនាបង្រួបបង្រួម។ ជម្រើសរបស់យើងបានធ្លាក់ចុះ វេជ្ជបណ្ឌិត Asciiហើយយើងមិនដែលឈប់រីករាយនឹងជម្រើសនេះឡើយ ប៉ុន្តែនេះគឺជាប្រធានបទសម្រាប់អត្ថបទដាច់ដោយឡែកមួយ។ ក្នុងពេលជាមួយគ្នានេះ យើងបានសិក្សាពីប្រសិទ្ធភាពនៃគោលការណ៍ DevOps មួយនៃ "អ្វីគ្រប់យ៉ាងជាកូដ" ដូច្នេះជម្រើសនៃតម្រូវការសម្រាប់បច្ចេកវិទ្យាថ្មីសម្រាប់ការបង្កើតស្លាយបទបង្ហាញគឺជាក់ស្តែងណាស់៖

1. បទបង្ហាញត្រូវតែជាឯកសារអត្ថបទធម្មតាជាភាសាសម្គាល់។
2. ស្លាយរបស់យើងនិយាយអំពីគម្រោងអភិវឌ្ឍន៍ ដូច្នេះការសម្គាល់គួរតែធ្វើឱ្យវាងាយស្រួលក្នុងការបញ្ចូល ដោយមិនប្រើប្រព័ន្ធខាងក្រៅ
   • បំណែកកូដជាមួយនឹងការបន្លិចវាក្យសម្ព័ន្ធ,
   • ដ្យាក្រាមសាមញ្ញក្នុងទម្រង់នៃរាងធរណីមាត្រដែលភ្ជាប់ដោយព្រួញ,
   • ដ្យាក្រាម UML គំនូសតាងលំហូរ និងច្រើនទៀត។
3. សេចក្តីព្រាងបទបង្ហាញត្រូវតែរក្សាទុកនៅក្នុងប្រព័ន្ធត្រួតពិនិត្យកំណែ។
4. សុពលភាព និងការផ្គុំស្លាយដែលបានបញ្ចប់គួរតែធ្វើឡើងនៅក្នុងប្រព័ន្ធ CI ។

សព្វ​ថ្ងៃ​នេះ មាន​ជម្រើស​មូលដ្ឋាន​ពីរ​សម្រាប់​ការ​បង្កើត​ស្លាយ​ជា​ភាសា​សម្គាល់៖ កញ្ចប់ ធ្នឹម សម្រាប់ LaTeX ឬក្របខ័ណ្ឌមួយសម្រាប់បង្កើតស្លាយដោយប្រើ HTML/CSS (អ៊ីហ្សីអេស, សំគាល់, deck.js និងអ្នកផ្សេងទៀតជាច្រើន) ។

ទោះបីជាព្រលឹងរបស់ខ្ញុំស្ថិតនៅក្នុង LaTeX ក៏ដោយ ក៏ចិត្តរបស់ខ្ញុំបានកំណត់ថាជម្រើសនៃដំណោះស្រាយដែលខ្ញុំនឹងមិនប្រើតែម្នាក់គត់គួរតែស្ថិតនៅផ្នែកម្ខាងនៃដំណោះស្រាយដែលស្គាល់ចំពោះមជ្ឈដ្ឋានទូទៅ។ មិនមែនគ្រប់គ្នាសុទ្ធតែស្គាល់ LaTeX ទេ ហើយប្រសិនបើការអនុវត្តប្រចាំថ្ងៃរបស់អ្នកមិនទាក់ទងនឹងការសរសេរអត្ថបទវិទ្យាសាស្ត្រទេ នោះអ្នកទំនងជាមិនមានពេលវេលាដើម្បីជ្រមុជខ្លួនអ្នកនៅក្នុងពិភពដ៏ស្មុគស្មាញនៃប្រព័ន្ធនេះទេ។

ទោះជាយ៉ាងណាក៏ដោយ ភាពស្ទាត់ជំនាញនៃ HTML/CSS មិនមែនជាជំនាញដ៏ទូលំទូលាយនោះទេ៖ ជាឧទាហរណ៍ ខ្ញុំនៅឆ្ងាយពីជំនាញទាំងស្រុង។ ជាសំណាងល្អ AsciiDoctor ដែលធ្លាប់ស្គាល់រួចហើយមកជួយសង្គ្រោះ៖ ឧបករណ៍បំប្លែង asciidoctor-revealjs អនុញ្ញាតឱ្យអ្នកបង្កើតស្លាយ RevealJS ដោយប្រើសញ្ញាសម្គាល់ AsciiDoctor ។ ហើយវាងាយស្រួលរៀន និងអាចចូលប្រើបានសម្រាប់មនុស្សគ្រប់គ្នា!

របៀបសរសេរកូដស្លាយ

ដើម្បីយល់ពីខ្លឹមសារនៃស្លាយសរសេរកូដនៅលើ 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 ត្រូវបានរួមបញ្ចូលជាមួយប្រព័ន្ធ Graphviz — ភាសាដែលអនុញ្ញាតឱ្យអ្នកពិពណ៌នាអំពីដ្យាក្រាមក្រាហ្វដោយផ្អែកលើការពិពណ៌នាអំពីចំនុចកំពូល និងការតភ្ជាប់រវាងពួកវា។ Graphviz ប្រើខ្សែកោងការរៀនសូត្រ ប៉ុន្តែផ្អែកលើឧទាហរណ៍ដែលបានផ្តល់ វាងាយស្រួលណាស់ក្នុងការធ្វើ! នេះជាអ្វីដែលវាមើលទៅ៖

== Пишем “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;}
}
-----

លទ្ធផល

ដោយវិធីនេះ វាជាការងាយស្រួលក្នុងការពិសោធន៍ជាមួយ Graphviz និងបំបាត់កំហុសនៅលើទំព័រ ក្រាហ្វិចតាមអ៊ីនធឺណិត.

ជាចុងក្រោយ ប្រសិនបើអ្នកត្រូវការបញ្ចូលគំនូសតាងលំហូរ ដ្យាក្រាមថ្នាក់ ឬដ្យាក្រាមស្តង់ដារផ្សេងទៀតទៅក្នុងស្លាយ នោះប្រព័ន្ធមួយផ្សេងទៀតដែលរួមបញ្ចូលជាមួយ AsciiDoctor អាចមកជួយសង្គ្រោះបាន។ PlantUML. សហសេវិករបស់ខ្ញុំ Nikolai Potashnikov បានសរសេរអំពីសមត្ថភាពទូលំទូលាយរបស់ PlantUML ប្រកាសដាច់ដោយឡែក.

ការបង្វែរគម្រោងបទបង្ហាញទៅជាកូដដែលរក្សាទុកនៅលើប្រព័ន្ធត្រួតពិនិត្យកំណែ ធ្វើឱ្យវាអាចរៀបចំការងាររួមគ្នាលើបទបង្ហាញ ជាដំបូងដើម្បីបំបែកកិច្ចការនៃការបង្កើតខ្លឹមសារ និងការរចនា។ ការរចនានៃស្លាយ (ពុម្ពអក្សរ ផ្ទៃខាងក្រោយ ចូលបន្ទាត់) នៅក្នុង RevealJS ត្រូវបានពិពណ៌នាដោយប្រើ CSS ។ ជំនាញផ្ទាល់ខ្លួនរបស់ខ្ញុំជាមួយ CSS ត្រូវបានបញ្ជូនល្អបំផុតដោយ gif នេះ។ - ប៉ុន្តែវាមិនគួរឱ្យខ្លាចទេនៅពេលដែលមានមនុស្សដែលធ្វើការជាមួយ CSS ច្រើនយ៉ាងស្វាហាប់ និងលឿនជាងខ្ញុំ។ ជាលទ្ធផល វាបង្ហាញថា ជាមួយនឹងថ្ងៃផុតកំណត់នៃការធ្វើបទបង្ហាញកាន់តែខិតជិតមកដល់ យើងអាចធ្វើការលើឯកសារផ្សេងៗគ្នាក្នុងពេលដំណាលគ្នាតាមរយៈ Git និងអភិវឌ្ឍល្បឿននៃការសហការដែលមិនអាចទៅរួចនៅពេលផ្ញើឯកសារ .pptx តាមសំបុត្រ។

បង្កើតទំព័រ HTML ជាមួយស្លាយ

ប្រភពអត្ថបទធម្មតាគឺអស្ចារ្យណាស់ ប៉ុន្តែតើអ្នកចងក្រងវាទៅជាបទបង្ហាញដោយរបៀបណា?

AsciiDoctor គឺជាគម្រោងដែលសរសេរនៅក្នុង Ruby ហើយមានវិធីជាច្រើនដើម្បីដំណើរការវា។ ដំបូងអ្នកអាចដំឡើងភាសា Ruby ហើយដំណើរការ asciidoctor ដោយផ្ទាល់ ដែលប្រហែលជារឿងដែលជិតស្និទ្ធបំផុតសម្រាប់អ្នកអភិវឌ្ឍន៍ Ruby ។

ប្រសិនបើអ្នកមិនចង់រញ៉េរញ៉ៃជាមួយការដំឡើង Ruby អ្នកអាចប្រើរូបភាព docker asciidoctor/docker-asciidoctorដែលក្នុងនោះ នៅពេលបើកដំណើរការ អ្នកអាចភ្ជាប់ថតជាមួយប្រភពគម្រោងតាមរយៈ VOLUME និងទទួលបានលទ្ធផលនៅក្នុងទីតាំងដែលបានផ្តល់ឱ្យ។

ជម្រើស​ដែល​ខ្ញុំ​បាន​ជ្រើសរើស​អាច​មើល​ទៅ​ហាក់​ដូច​ជា​មិន​នឹក​ស្មាន​ដល់ ប៉ុន្តែ​វា​ជា​ការ​ងាយស្រួល​បំផុត​សម្រាប់​ខ្ញុំ​ក្នុង​នាម​ជា​អ្នក​បង្កើត Java។ វាមិនតម្រូវឱ្យមានការដំឡើង Ruby ឬ docker ទេ ប៉ុន្តែអនុញ្ញាតឱ្យអ្នកបង្កើតស្លាយដោយប្រើស្គ្រីប Maven ។

ចំណុចសំខាន់គឺគម្រោង ជូរូប៊ី - ការអនុវត្ត Java នៃភាសា Ruby គឺល្អណាស់ដែលវាអនុញ្ញាតឱ្យអ្នកដំណើរការស្ទើរតែទាំងអស់ដែលបានបង្កើតសម្រាប់ Ruby នៅក្នុងម៉ាស៊ីន Java ហើយការដំណើរការ AsciiDoctor គឺជាការប្រើប្រាស់ទូទៅបំផុតមួយនៃ JRuby ។

ភាពអាចរកបាន asciidoctor-maven-plugin អនុញ្ញាតឱ្យអ្នកប្រមូលឯកសារ AsciiDoctor ដែលជាផ្នែកមួយនៃគម្រោង Java (ដែលយើងប្រើយ៉ាងសកម្ម)។ ក្នុងពេលជាមួយគ្នានេះ AsciiDoctor និង JRuby ត្រូវបានទាញយកដោយស្វ័យប្រវត្តិដោយ Maven ហើយ AsciiDoctor ដំណើរការក្នុងបរិស្ថាន JRuby៖ មិនចាំបាច់ដំឡើងអ្វីនៅលើម៉ាស៊ីនទេ! (មិនរាប់បញ្ចូលកញ្ចប់ graphvizដែលត្រូវការប្រសិនបើអ្នកចង់ប្រើក្រាហ្វិក GraphViz ឬ PlantUML។) គ្រាន់តែដាក់ឯកសារ .adoc របស់អ្នកក្នុងថតឯកសារ។ src/main/asciidoc/។ នៅទីនេះ ឧទាហរណ៍នៃ pomnik មួយ។ប្រមូលស្លាយជាមួយដ្យាក្រាម។

បំលែងស្លាយទៅជា PDF

ទោះបីជាកំណែ HTML នៃស្លាយមានលក្ខណៈគ្រប់គ្រាន់ដោយខ្លួនឯងក៏ដោយ ក៏វានៅតែចាំបាច់ដើម្បីឱ្យមានកំណែ PDF នៃស្លាយ។ ទីមួយ វាកើតឡើងថានៅក្នុងសន្និសិទមួយចំនួនដែលមិនផ្តល់ឱកាសឱ្យវាគ្មិនដើម្បីភ្ជាប់កុំព្យូទ័រយួរដៃផ្ទាល់ខ្លួនរបស់គាត់ ពួកគេទាមទារស្លាយ "យ៉ាងតឹងរឹងជាទម្រង់ pptx ឬ pdf" ដោយមិននឹកស្មានថាពួកគេមាននៅក្នុង HTML ផងដែរ។ ទីពីរ វាជាទម្រង់ដ៏ល្អក្នុងការផ្ញើអ្នករៀបចំនូវកំណែដែលមិនបានកែសម្រួលនៃស្លាយរបស់អ្នក ដូចដែលពួកគេត្រូវបានបង្ហាញនៅរបាយការណ៍ជាទម្រង់ PDF សម្រាប់ការបោះពុម្ពឯកសារនៅក្នុងឯកសារសន្និសីទ។

ជាសំណាងល្អ ឧបករណ៍ប្រើប្រាស់ Node.js ដោះស្រាយកិច្ចការនេះ។ ផ្ទាំងក្រណាត់, សាងសង់នៅលើមូលដ្ឋាន អាយ៉ង - ប្រព័ន្ធស្វ័យប្រវត្តិកម្មសម្រាប់គ្រប់គ្រងកម្មវិធីរុករក Chrome ។ អ្នកអាចបម្លែងបទបង្ហាញ RevealJS ទៅជា PDF ដោយប្រើពាក្យបញ្ជា

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

ល្បិចពីរនៅពេលបើកដំណើរការផ្ទាំងក្រណាត់ ដែលយើងត្រូវបង្កើតតាមរយៈការសាកល្បង និងកំហុស៖

• ដំណោះស្រាយតាមរយៈប៉ារ៉ាម៉ែត្រ -s ត្រូវតែបញ្ជាក់ជាមួយនឹងរឹមពីរដង បើមិនដូច្នេះទេវាអាចមានបញ្ហាជាមួយនឹងលទ្ធផលការបម្លែង

• នៅក្នុង URL នៃកំណែ HTML នៃបទបង្ហាញ អ្នកត្រូវឆ្លងកាត់ប៉ារ៉ាម៉ែត្រមួយ។ ?fragments=trueដែលនឹងបង្កើតទំព័រ PDF ដាច់ដោយឡែកសម្រាប់ស្ថានភាពកម្រិតមធ្យមនីមួយៗនៃស្លាយរបស់អ្នក (ឧទាហរណ៍ ទំព័រប្រាំសម្រាប់ចំណុចចំនួនប្រាំ ប្រសិនបើពួកវាត្រូវបានបង្ហាញមួយបន្ទាប់ពីផ្សេងទៀត)។ វា​នឹង​អនុញ្ញាត​ឱ្យ​អ្នក​ប្រើ PDF បែប​នេះ​ដោយ​ខ្លួន​វា​ជា​បទ​បង្ហាញ​ក្នុង​អំឡុង​ពេល​របាយការណ៍​មួយ។

ការជួបប្រជុំដោយស្វ័យប្រវត្តិ និងការបោះពុម្ពផ្សាយនៅលើគេហទំព័រ

វាងាយស្រួលនៅពេលដែលស្លាយត្រូវបានចងក្រងដោយស្វ័យប្រវត្តិ នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានធ្វើឡើងចំពោះប្រព័ន្ធត្រួតពិនិត្យកំណែ ហើយកាន់តែងាយស្រួលនៅពេលដែលស្លាយដែលបានចងក្រងដោយស្វ័យប្រវត្តិត្រូវបានបង្ហោះនៅលើអ៊ីនធឺណិតសម្រាប់ការប្រើប្រាស់ជាសាធារណៈ។ ស្លាយពីអ៊ីនធឺណិតអាចត្រូវបាន "លេង" យ៉ាងងាយស្រួលនៅចំពោះមុខទស្សនិកជនពីម៉ាស៊ីនណាមួយដែលភ្ជាប់អ៊ីនធឺណិត និងម៉ាស៊ីនបញ្ចាំង។

ចាប់តាំងពីយើងប្រើ GitHub នៅក្នុងការងាររបស់យើង ជម្រើសធម្មជាតិនៃប្រព័ន្ធ CI គឺ TravisCIនិងសម្រាប់ការធ្វើជាម្ចាស់ផ្ទះបទបង្ហាញដែលត្រៀមរួចជាស្រេច - github.io. គំនិតនៅពីក្រោយ github.io គឺថាមាតិកាឋិតិវន្តណាមួយដែលបានបង្ហោះទៅសាខាមួយ។ gh-pages នៃគម្រោងរបស់អ្នកនៅលើ GitHub អាចរកបាននៅ <ваше имя>.gihub.io/<ваш проект>.

បំពេញឯកសារកំណត់រចនាសម្ព័ន្ធ TravisCI រួមទាំងការចងក្រងកំណែ HTML នៃទំព័រដោយប្រើ Maven បំប្លែងទៅជា PDF ដោយប្រើ deccktape និងបញ្ចូលលទ្ធផលទៅជាខ្សែស្រឡាយ 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 បទ​បង្ហាញ​ទាំង​នោះ​ដែល​អ្នក​ចង់​បង្ហាញ​ជា​សាធារណៈ​នៅ​ទី​បំផុត)។

ឧទាហរណ៍នៃគម្រោង

ជាចុងក្រោយ នេះគឺជាតំណភ្ជាប់ទៅកាន់ឧទាហរណ៍មួយចំនួននៃគម្រោងបទបង្ហាញជាមួយនឹងស្គ្រីប Maven ផ្ទាល់ខ្លួន និងការកំណត់រចនាសម្ព័ន្ធ CI សម្រាប់ Travis-CI ដែលអាចត្រូវបានក្លូន និងប្រើនៅពេលបង្កើតគម្រោងបទបង្ហាញផ្ទាល់ខ្លួនរបស់អ្នក៖

• https://github.com/inponomarev/kstreams-examples (ការពិភាក្សារបស់ខ្ញុំសម្រាប់ JPoint 2019)

• https://github.com/inponomarev/csa-hb (របាយការណ៍របស់ខ្ញុំសម្រាប់ Heisenbug 2019)

លាហើយ Powerpoint! ខ្ញុំ​មិន​គិត​ថា​ខ្ញុំ​នឹង​ត្រូវ​ការ​អ្នក​សម្រាប់​បទ​បង្ហាញ​ប​ច្ចេ​ក​ទេស :)

ប្រភព: www.habr.com