Table Of Content

Writing and transliterating Swahili in Arabic script with Andika! Kevin Donnelly 2014-17 (Thisversioncompiled1December2017) Andika!isdedicatedtothememoryofSheikhYahyaAliOmar(1924–2008) ئَ تٖكٖ تٖهُ بَ اتَكمَ ،فَ يكِ َٔا ئٖ زٖمْ kevindonnelly.org.uk/swahili Andika!isfreesoftwareundertheGPLv3orlater. Alltrademarksbelongtotheirrespectiveowners. Contents 1 Introduction 2 2 Examplesof Andika!output 3 2.1 ConvertingRomantoArabicscript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 ReplicatingproseinArabicscript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3 Replicatingmanuscriptpoetry:Bajunifishingsongs . . . . . . . . . . . . . . . . . . . . . 5 2.4 Replicatingmanuscriptpoetry:UtenziwaMkunumbi . . . . . . . . . . . . . . . . . . . . 6 2.5 Replicatingmanuscriptpoetry:Kiswahili . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2.6 Replicatingmanuscriptpoetry:Mamamusimlaumu . . . . . . . . . . . . . . . . . . . . . 9 2.7 Replicatingmanuscriptpoetry:UtenziwaRasi’lGhuli . . . . . . . . . . . . . . . . . . . . 10 2.8 Replicatingmanuscriptpoetry:QasidayaBurda . . . . . . . . . . . . . . . . . . . . . . . 10 3 Gettingstarted 12 3.1 Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.2 IntroducingUbuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.3 TypingSwahiliinArabicscript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.4 ConvertingandannotatingSwahiliinArabicscript . . . . . . . . . . . . . . . . . . . . . . 13 3.5 Nextsteps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 4 Fonts 14 4.1 MissingglyphsinArabicfonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.2 DefaultfontsinAndika! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.3 AddingmissingglyphstoArabicfonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.4 ScheherazadeandAmiri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5 AkeyboardlayoutforSwahiliinArabicscript 18 5.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.2 Governingprinciplesforthelayout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.3 Changingthelayout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 6 WritingcontemporarySwahiliinArabicscript 20 i CONTENTS ii 6.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.2 Generalprinciples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.3 Representationofconsonants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.4 Representationofvowels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.5 Vowelsequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.5.1 Stressed+unstressedvowelsequences . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.5.2 Unstressed+stressedvowelsequences . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.5.3 Unstressedvowelsequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.5.4 Longervowelsequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.6 Comparingconventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.6.1 Sakanionlongvowels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.6.2 Markingshortvowels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.6.3 Sakanionconsonants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.6.4 Distinctionbetweensyllabicityandprenasalisation . . . . . . . . . . . . . . . . . . 26 7 Convertingfromonescripttotheother 27 7.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 7.2 Cut-and-pasteconverters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 7.2.1 ArabictoRoman . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 7.2.2 RomantoArabic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 7.2.3 Convertawebpage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 7.3 Command-lineconverter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 7.3.1 Point-and-clickinterface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 7.3.2 Command-lineinput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 7.3.3 Layoutoftheinputdocument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 7.3.4 Convertingpdfs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 7.4 Generalnotesonusage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 7.4.1 Adjustingtheimport’sstanzanumbering . . . . . . . . . . . . . . . . . . . . . . . 31 7.4.2 Warningwhenusingtheconverttools . . . . . . . . . . . . . . . . . . . . . . . . . 32 7.5 Howtheconversionworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 7.5.1 ArabictoRoman . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 7.5.2 RomantoArabic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 8 Typesettingpoetry 35 CONTENTS iii 8.1 Creatingtheinputdocument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 8.1.1 Checkingtheinputfile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 8.2 Importingthecontentsintoadatabasetable . . . . . . . . . . . . . . . . . . . . . . . . . 35 8.2.1 Theimportprocesshangs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 8.2.2 Savingaparticularimport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 8.2.3 Addingstanzastoapoemimport . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 8.3 Splittinglinesintowords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 8.3.1 Re-runningword-splitting:backups . . . . . . . . . . . . . . . . . . . . . . . . . . 38 8.3.2 Renumberingstanzasduringword-splitting . . . . . . . . . . . . . . . . . . . . . . 39 8.4 Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 8.4.1 edclosefield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 8.4.2 edstanfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 8.4.3 emendfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 8.4.4 variant field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 8.4.5 notefield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 8.4.6 englishfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 8.4.7 noshowfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 8.5 Addingandeditingtheannotations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 8.5.1 Specifyingfontsintheannotations . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 8.5.2 Insertingcitationsintheannotations . . . . . . . . . . . . . . . . . . . . . . . . . . 42 8.5.3 Addingannotationsinbatches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.6 Outputtopdf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.7 Output:globaldisplayoptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 8.7.1 Stanzastobeprinted. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 8.7.2 Fontsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 8.7.3 Changingthelocationofannotations . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.7.4 Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.7.5 Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 8.7.6 Omittingtiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 8.7.7 Displayingtheclosetranscription . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 8.8 Output:localdisplayoptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 8.8.1 Suppressingalineoftranscription . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 8.8.2 Swappingintheclosetranscription . . . . . . . . . . . . . . . . . . . . . . . . . . 51 CONTENTS iv 8.8.3 Makingentriesinthenoshowfield . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 9 Typsettingmultipleversionsofthesamepoem 54 9.1 Setupamanuscriptinformationtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 9.2 Setuparunningordertable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 9.3 Addmanuscriptdatatotherunningordertable . . . . . . . . . . . . . . . . . . . . . . . . 54 10 Computer-aidedanalysisofpoemtexts 56 10.1 Additionalannotationfields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 10.1.1 root field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 A InstallingAndika! 58 A/1 HowmuchofthisdoIneedtodo? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 A/2 UbuntuLinux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 A/3 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 A/4 RunningUbuntuasavirtualmachine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 A/5 ChangethedesktoptoKDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 A/6 DownloadAndika! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 A/6.1 Option1:snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 A/6.2 Option2:easyupdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 A/6.3 Movetheandikadirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 A/7 Installfonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 A/8 Setupanewlanguageandkeyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 A/8.1 ActivatethenewkeyboardinKDE . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 A/8.2 ActivatethenewkeyboardinUnity . . . . . . . . . . . . . . . . . . . . . . . . . . 63 A/8.3 InteractionwiththeunlockscreeninKDE . . . . . . . . . . . . . . . . . . . . . . . 64 A/9 LibreOffice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 A/9.1 Configuretheword-processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 A/9.2 Installatemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 A/10PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 A/10.1InstallPHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 A/10.2ConfigurePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 A/11PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 A/11.1InstallPostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 CONTENTS v A/11.2Setupadatabaseuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 A/11.3SetAndika!touseyourdatabaseuser . . . . . . . . . . . . . . . . . . . . . . . . . 67 A/11.4Createtheandikadatabase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 A/11.5Connecttotheandikadatabase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 A/12Databaseinterfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 A/12.1phpPgAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 A/12.2SQLWorkbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 A/13LaTeX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 A/14JabRef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 A/15YAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 A/16AccesstheAndika!websitelocally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 B Editingfonts 74 B/1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 B/2 InstallFontForge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 B/2.1 Useapre-compiledpackage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 B/2.2 Compilefromthesourcecode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 B/3 Makeaworkingcopyofthefont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 B/4 Renamethefont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 B/5 Addtheglyphfortheisolatedformofpeh . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 B/6 Addtheglyphsfortheconnectedformsofpeh . . . . . . . . . . . . . . . . . . . . . . . . 78 B/6.1 Createthefinalform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 B/6.2 Createtheinitialandmedialforms . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 B/6.3 Addthelookups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 B/7 Generatetheadaptedfont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 B/8 Nextsteps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 C ChangingtheAndika!keyboardlayout 80 C/1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 ِ ِ D Annotatedpoem,لِ حاوَ سْ ك(Kiswahili),12pt,footnotes 82 E Thekeyboardlayoutfile(layout/tz) 94 ِ ِ F Annotatedpoem,لِ حاوَ سْ ك(Kiswahili),10pt,endnotes 97 List of Figures 2.1 PartoftheSwahiliWikipediapageonutamaduni(culture) . . . . . . . . . . . . . . . . . 3 2.2 ThepageinFigure2.1automaticallytransliteratedintoArabicscript . . . . . . . . . . . 4 2.3 BajunifishingsongsaswrittenoutbySheikhYahyaAliOmar. . . . . . . . . . . . . . . . 6 2.4 Stanzas3–5ofUtenziwaMkunumbi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.5 ThefirststanzaofMamamusimlaumu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.6 Stanza2280ofUtenziwaRasi'lGhuli. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2.7 ThefirsttwostanzasofQasidayaBurda . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.1 Stanza6fromMuhammadKijuma’smanuscriptofUtenziwaMwanaKupona . . . . . . . 14 5.1 KeyboardlayoutforwritingSwahiliinArabicscript . . . . . . . . . . . . . . . . . . . . . 18 5.2 Accessingtheglyphsonthekeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 7.1 Vipandeseparatedbyaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 7.2 Vipandeseparatedbyastar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 8.1 Defaultoutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 8.2 Outputwithlargerfontsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.3 Option:firstcolour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 8.4 Option:nocolour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 8.5 Option:alignright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 8.6 Option:noenglish. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 8.7 Option:nostandard+noenglish+alignright . . . . . . . . . . . . . . . . . . . . . . . . . . 47 8.8 Option:noarabic+alignleft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 8.9 Option:close-lr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 8.10 Option:close-rl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 8.11 Option:close-rl+nostandard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 8.12 Makinganentryinthenoshowfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 8.13 Suppressingthetranscriptionforaword . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 8.14 Omittingaword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 vi LISTOFFIGURES vii 8.15 Markingthewordsofthefirstlineinthestanza . . . . . . . . . . . . . . . . . . . . . . . 51 8.16 Suppressingaline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 8.17 Suppressingalinebutretainingatranslation . . . . . . . . . . . . . . . . . . . . . . . . . 51 8.18 Swappingintheclosetranscription. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 A.1 SettinguptheSwahilikeyboardforKDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 List of Tables 4.2 Glyphscommonlymissinginfonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 5.1 Typingexamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 6.1 Representationofconsonants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.2 Representationofsinglevowels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.3 Vowel-carriers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 1 Chapter 1 Introduction For centuries, Swahili was written in Arabic script, and hundreds of manuscripts in collections around the world testify to its long tradition of written literature. Over the last century, however, Swahili in Romanscripthasbecomethenorm. Andika! (meaning Write! in Swahili) has two aims. The first is to make Swahili in Arabic script as easy to use as Swahili in Roman script – it is equally easy to read and write the the language in either script.Thetools,basedontheworkofMarehemuMu’allimSheikhYahyaAliOmar(OmarandFrankl, 1997) provide a consistent, standardised transliteration of Swahili in Arabic script, and a one-to-one mappingofthistoSwahiliinRomanscript.Documentscanbetypedineitherscript,andautomatically transliteratedtotheother. • NewwritinginSwahilicanbecomposedinArabicscriptandpublishedeasilyviaword-processors, webpages,orpdfscreatedbytypesettingsystemssuchasLaTeX. • The ability to convert Arabic script at any time into Roman script means that there is very little overheadinvolvedinchoosingtowriteSwahiliinArabicscript.Materialcanbeproducedsimul- taneouslyinbothscriptswiththeminimumofeffort(althoughtheconvertedtextwillneedminor editingtocoversuchthingsascapitalletters,whichdonotexistinArabicscript). • Existing Swahili content in Roman script can be converted to Arabic script, making it possible to reuse content already published in Roman script. This means that large amounts of material in Arabicscriptcanbebemadeavailableveryquickly. • TheRoman-to-Arabicconversioncanbeadjustedtoconvertnumerals,toaddorremovemarkers suchassakani(sukun),andsoon. The second aim of Andika! is to allow the creation of digital versions of existing Swahili manuscripts writteninArabicscript. • PerishableSwahilimanuscriptsinArabicscriptcanbedirectlytranscribedandmadeavailablein digital format, which is more versatile than a photocopy or scan of the manuscript. At present, most Swahili literature from earlier periods has only been published in Roman transliteration, eventhoughthemanuscriptswerewritteninArabicscript. • A direct transcription can be augmented with a fully-vocalised Arabic transcription, a close pho- netic transliteration (a variety of different ones can be easily created), a transliteration in the standardRomanorthography,andsoon.Thetoolsallowmuchofthesetobegeneratedautomat- ically,reducingtheeffortthiswouldotherwiseinvolve. • Acriticalapparatus(Englishtranslation,notesonwords,variantreadings,emendations,etc)can easilybeaddedtothedigitalversion,withhigh-qualitytypesetoutputinavarietyofformats. • Apartfromallowingeasiertypesettinganddissemination,havingmanuscriptsindigitalformwill make it possible for the first time to use computers to look at word frequency, stylistic variation, etc,withinthetexts,tobuildcorporaforclassicalSwahili,andsoon. Andika! is licensed under version 3 of the Free Software Foundation’s General Public License.1 This meansthat,apartfromcostingnothingtouse,itcanbeadaptedandextendedasrequiredbytheuser, subjecttothesamelicensebeingusedforanynewversionthuscreated. 1http://www.gnu.org/licenses/gpl.html 2