WritinganInfoQMini-BookwithAsciidoctor

BroughttoyoubyMattRaibleandAsciidoctor

Writingabookishard•It’seasyenoughcomingupwithanidea,butwritingishard

•It’seasyenoughtowriteitinWord(orGoogleDocs),right?

•CopyingandpastingcodeandimagesintoGoogleDocsiseasy

•Updatingthemisnot

•Aswriters,we’reoftenlimitedbyourtools

•Asciidoctortotherescue!

2

WhatisAsciidoctor?

Asciidoctor•AnopensourceimplementationofAsciiDocinRuby

•Afasttextprocessor&publishingtoolchainforconvertingAsciiDocto

HTML5,DocBook&more

•Writeinplaintext,importyourcodeandimages

•CodereviewandcopyeditusingGitandcodereviews

•PublishasHTML,PDF,EBUB,MOBIandprintedbooks

4

TheBestPart?

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

WritingAsciidoctor

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?•Talktous!matt@raibledesigns.comorminibooks@infoq.com

•ReviewAuthorGuidelinesforInfoQMini-books

•Youwillretainthecopyrightforanycontentproduced

•YougrantInfoQanexclusiverighttopublishthefreeonlineversion

•InfoQwillremovemini-bookiftheauthorrequests

12

StartWriting→