Treść książki
Przejdź do opcji czytnikaPrzejdź do nawigacjiPrzejdź do informacjiPrzejdź do stopki
WiększośćkonstrukcjiAsciiDocjesttaksamoczytelnaidostępnajakwinnych,lek-
kichformatachznacznikowych,takichjakMarkdown,którestałysiępopularnena
internetowychforachdyskusyjnych.Akiedypotrzebujeszczegośbardziejwyrafi-
nowanego,możeszdołączyćzłożonerównaniaprzyużyciuformatówMathMLlub
LaTeX,sformatowanelistingikodówźródłowychzponumerowanymiidołączo-
nymiobjaśnieniamiwakapitachtekstu,różnegorodzajuspecjalneblokiinietylko.
AsciiDoczostałwprowadzonywrazzimplementacjąPythonaw2002roku.Obecną
oficjalnąimplementacją(inajważniejsząwzakresietegojęzyka)jestAsciidoctor,
wydanyw2013roku.Jegokod,napisanywRubymożnarównieżuruchomićwJVM
przezAsciidoctorJ(zwykorzystaniemwtyczekdoMavena,czyGradle’a)lubtrans-
ponowaćdoJavaScriptu-wszystkotodziaładobrzewśrodowiskachbazującychna
ciągłejintegracji.Gdynabaziepowiązanejdokumentacji(nawetzróżnychrepozy-
toriów)musiszzbudowaćcałąwitrynę,narzędziatakiejakAntorasprawiają,żejest
toszokującołatwe.Społecznośćjestprzyjaznaiwspierająca,aobserwowaniejejroz-
wojuipostępówwciąguostatniegorokubyłoinspirujące.Ajeślimatodlaciebie
znaczenie,toprocesformalnejstandaryzacjispecyfikacjiAsciiDocjestwtoku.
Lubiętworzyćbogatą,atrakcyjnądokumentacjędoprojektów,któreudostępniam.
AsciiDocznaczniemitoułatwiłoiwprowadziłotakszybkiecyklepracy,żeszlifowa-
nieidoskonaleniedokumentacjistałosięzabawą.Mamnadzieję,żewtwoimprzy-
padkubędzietaksamo.I,zataczająckoło,jeślizdecydujeszsiępostawićwszystko
naAsciiDoc,przekonaszsię,żeistniejenawetDocletonazwieAsciidoclet,który
pozwalapisaćJavadoczapomocąAsciiDoc!
6
Java.97rzeczy,którepowinieneświedzieć
