Table Of ContentWriting 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
