Writing an InfoQ Mini-Book with Asciidoctor - Devoxx France 2016
-
Upload
matt-raible -
Category
Technology
-
view
147 -
download
0
Transcript of Writing an InfoQ Mini-Book with Asciidoctor - Devoxx France 2016
WritinganInfoQMini-BookwithAsciidoctor
BroughttoyoubyMattRaibleandAsciidoctor
Writingabookishard•It’seasyenoughcomingupwithanidea,butwritingishard
•It’seasyenoughtowriteitinWord(orGoogleDocs),right?
•CopyingandpastingcodeandimagesintoGoogleDocsiseasy
•Updatingthemisnot
•Aswriters,we’reoftenlimitedbyourtools
•Asciidoctortotherescue!
2
Asciidoctor•AnopensourceimplementationofAsciiDocinRuby
•Afasttextprocessor&publishingtoolchainforconvertingAsciiDocto
HTML5,DocBook&more
•Writeinplaintext,importyourcodeandimages
•CodereviewandcopyeditusingGitandcodereviews
•PublishasHTML,PDF,EBUB,MOBIandprintedbooks
4
MyAsciidoctorExperience•Endof2015:HadagoaltowriteaJHipsterMini-BookforInfoQ
•ChoseAsciidoctorbecauseIwantedittobelikeanopensourceproject
•Usedasciidoctor-to-all-exampleasastartingpoint
•UsedJIRACloudtocreatetasks,organizesprintsandtrackprogress
•UsedBitbuckettohostthebook’ssourcecontrolinGit
•UsedIntelliJIDEAtowrite,andBrowsersynctoseechangesimmediately
6
Asciidoctor@InfoQ•InfoQrecommendedIuseWordorGoogleDocs
•AgreedtoAsciidoctor,butexpectitbemostexpensivemini-book
•Figureditout,withagreatteam
•Extractedtemplatetoinfoq-mini-book
•DanAllenandAsciidocFXwereabighelp
7
DevelopinganInfoQMini-Book• gitclonehttps://github.com/mraible/infoq-mini-
book
•Run gradlew followedby gradlewwatch
•InstallNode.jsandrun npminstall
•Run grunt
•UseIntelliJIDEA,Atom,SublimeTextorAsciidocFXtoedit
9
InfoQEditingProcess•ShareyourGitrepositorywithyoureditor
•Editorcreatespullrequestsbysection
•Addcommentsandcollaborateonchanges
•Acceptpullrequestandmerge
10
InfoQPublishingProcess•InstallKindleGenforMOBI
•CreateHTML,PDF,EPUBandMOBIbyrunning build.sh
• asciidoctor-pdf-extensions.rb customizesPDFoutput
•Recentimprovementsby@mojavelinuxallowforLuluprinting
11
InterestedinWriting?•[email protected]@infoq.com
•ReviewAuthorGuidelinesforInfoQMini-books
•Youwillretainthecopyrightforanycontentproduced
•YougrantInfoQanexclusiverighttopublishthefreeonlineversion
•InfoQwillremovemini-bookiftheauthorrequests
12