package Ġcom . j il les v ang ur p . kotlin 4 example . docs Ċ Ċ import Ġcom . j il les v ang ur p . kotlin 4 example . Doc Gen Test Ċ import Ġcom . j il les v ang ur p . kotlin 4 example . Source Repository Ċ Ċ val Ġk 4 E Repo Ġ= ĠSource Repository (" https :// github . com / j il les v ang ur p / kotlin 4 example ") Ċ Ċ // ĠYou Ġcan Ġstill Ġuse Ġcomment Ġmarkers Ġto Ġgrab Ġlarger Ġsections Ġof Ġcode Ċ // Ġor Ġto Ġgrab Ġcode Ġfrom Ġe . g . Ġthe Ġmain Ġsource Ġtree . Ċ // ĠREADME CODE START Ċ val Ġreadme Ġby Ġk 4 E Repo . md Ġ{ ĊĠĠĠ Ġ// Ġfor Ġlarger Ġbits Ġof Ġtext , Ġit 's Ġnice Ġto Ġload Ġthem Ġfrom Ġa Ġmarkdown Ġfile ĊĠĠĠ Ġinclude Md File (" intro . md ") ĊĊĠĠĠ Ġsection (" Example ") Ġ{ ĊĠĠĠĠĠĠĠ Ġblock ( run Block Ġ= Ġfalse ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ// Ġdocumentation Ġin ception ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ// Ġthis Ġis Ġtechnically Ġa Ġblock Ġwithin Ġa Ġblock , Ġjust Ġso ĠI Ġcan Ġshow Ġyou ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ// Ġhow Ġyou Ġwould Ġuse Ġit . ĊĠĠĠĠĠĠĠĠĠĠĠ Ġblock Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠĠĠĠĠ Ġprintln (" Hello ĠWorld ") ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġ// Ġof Ġcourse Ġyou Ġcan Ġinline Ġa ĠKotlin Ġmultiline Ġstring Ġwith Ġsome Ġmarkdown ĊĠĠĠĠĠĠĠ Ġ// Ġnote Ġthe Ġuse Ġof Ġtemp lating Ġhere Ġand Ġthe Ġhelper Ġfunction Ġto Ġgenerate ĊĠĠĠĠĠĠĠ Ġ// Ġa Ġlink ĊĠĠĠĠĠĠĠ Ġ+ """ ĊĠĠĠĠĠĠĠĠĠĠĠ ĠHere 's Ġthe Ġsame Ġblock Ġas Ġabove Ġrunning Ġas Ġpart Ġof Ġthis ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġ${ md Link To Self (" readme . kt ")} Ġfile . ĊĠĠĠĠĠĠĠ Ġ""" ĊĊĠĠĠĠĠĠĠ Ġblock Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġprintln (" Hello ĠWorld ") ĊĠĠĠĠĠĠĠ Ġ} ĊĊĠĠĠĠĠĠĠ Ġ+ """ ĊĠĠĠĠĠĠĠĠĠĠĠ ĠAs Ġyou Ġcan Ġsee , Ġwe Ġindeed Ġshow Ġa Ġpretty Ġprinted Ġblock , Ġran Ġit , Ġand ĊĠĠĠĠĠĠĠĠĠĠĠ Ġgrab bed Ġthe Ġoutput Ġas Ġwell . ĠOb serv ant Ġreaders Ġwill Ġalso Ġnote Ġthat ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġthe Ġnested Ġblock Ġabove Ġdid Ġnot Ġrun . ĠThe Ġreason Ġfor Ġthis Ġis Ġthat ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġthe Ġouter Ġ` block ` Ġcall Ġfor Ġthat Ġhas Ġa Ġ` run Block ` Ġparameter Ġthat ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġyou Ġcan Ġuse Ġto Ġprevent Ġthis . ĠIf Ġyou Ġlook Ġat Ġthe Ġsource Ġcode ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġfor Ġthe Ġreadme , Ġyou Ġwill Ġsee Ġwe Ġused Ġ` block ( run Block Ġ= Ġfalse )` ĊĠĠĠĠĠĠĠĠĠĠĠĠĊĠĠĠĠĠĠĠĠĠĠĠ ĠYou Ġcan Ġalso Ġreturn Ġa Ġvalue Ġfrom Ġthe Ġblock Ġand Ġcapture Ġthat : ĊĠĠĠĠĠĠĠ Ġ""" ĊĊĠĠĠĠĠĠĠ Ġblock Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġfun Ġa Function That Returns An Int () Ġ= Ġ 1 Ġ+ Ġ 1 ĊĊĠĠĠĠĠĠĠĠĠĠĠ Ġ// Ġcall Ġthe Ġfunction Ġto Ġmake Ġthe Ġblock Ġreturn Ġsomething ĊĠĠĠĠĠĠĠĠĠĠĠ Ġa Function That Returns An Int () ĊĠĠĠĠĠĠĠ Ġ} ĊĊĠĠĠĠĠĠĠ Ġ+ """ ĊĠĠĠĠĠĠĠĠĠĠĠ ĠNote Ġhow Ġthat Ġcaptured Ġthe Ġreturn Ġvalue Ġand Ġprinted Ġthat ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġwithout Ġus Ġusing Ġ` print ` Ġor Ġ` println `. ĊĠĠĠĠĠĠĠ Ġ""" ĊĊĠĠĠ Ġ} ĊĊĠĠĠ Ġsection (" This ĠREADME Ġis Ġgenerated ") Ġ{ ĊĠĠĠĠĠĠĠ Ġ+ """ ĊĠĠĠĠĠĠĠĠĠĠĠ ĠThis ĠREADME . md Ġis Ġactually Ġcreated Ġfrom Ġkotlin Ġcode Ġthat ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġruns Ġas Ġpart Ġof Ġthe Ġtest Ġsuite . ĠYou Ġcan Ġlook Ġat Ġthe Ġkotlin ĠĊĠĠĠĠĠĠĠĠĠĠĠ Ġsource Ġcode Ġthat Ġgenerates Ġthis Ġmarkdown Ġ${ md Link To Self (" here ") }. ĊĠĠĠĠĠĠĠ Ġ""" . trim Indent () ĊĊĠĠĠĠĠĠĠ Ġ// Ġlittle Ġstring Ġconcat enation Ġhack Ġso Ġit Ġwill Ġread ĠĊĠĠĠĠĠĠĠ Ġ// Ġuntil Ġthe Ġend Ġmarker Ġinstead Ġof Ġstopping Ġhere ĠĠĠĠĠĠĠĠĊĠĠĠĠĠĠĠ Ġsnippet From SourceFile ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ" com / j il les v ang ur p / kotlin 4 example / docs / readme . kt ", ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ" README " Ġ+ Ġ" CODE " ĊĠĠĠĠĠĠĠ Ġ) ĊĊĠĠĠĠĠĠĠ Ġ""" ĊĠĠĠĠĠĠĠĠĠĠĠ ĠAnd Ġthe Ġcode Ġthat Ġactually Ġwrites Ġthe Ġfile Ġis Ġa Ġtest : ĊĠĠĠĠĠĠĠ Ġ""" . trim Indent () ĊĠĠĠĠĠĠĠ Ġsnippet Block From Class ( Doc Gen Test :: class , Ġ" README WRITE ") ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġinclude Md File (" out ro . md ") Ċ } Ċ // ĠREADME CODE END ĊĊĊ