Dokumentationen för denna modul kan skapas på Modul:translit/ar/dok /test
-- Denna modul används för att transkribera arabiska till svenska.
--
-- För att transkribera persiska/farsi, urdu eller andra språk som
-- använder det arabiska alfabetet kan ett liknande system användas.
-- Det hanteras dock av särskilda moduler. Se:
--
--
--
--
-- Systemet för transkribering följer det som anges i
-- "Svenska skrivregler" (2017), fjärde upplagan, red. Ola Karlsson
-- Den ger inte en uttömmande beskrivning av hur samtliga tecken ska
-- hanteras. Av nödvändighet (och i brist på bättre källor) har jag
-- valt att hantera resten av dem på ett visst sätt.
--
-- Notera att det finns otaliga system för att transkribera arabiska,
-- som alla ger olika utfall.
--
--
-- Några generella anmärkningar om det arabiska skriftspråket och denna modul:
--
-- Det skrivs från höger till vänster. Förutsatt att det är korrekt inmatat
-- kommer denna modul hantera det.
--
-- Arabiska gör ingen skillnad på stor och liten bokstav. Däremot kan tecken
-- se olika ut om de förekommer initialt, medialt, finalt, eller isolerat.
-- Datorer (mer specifikt, UTF-8) kan lagra detta som fyra stycken olika tecken.
-- Det finns även ett sätt att lagra tecknen som ej tar ställning till vilken
-- position de har. Alltså finns det upp till fem olika sätt att lagra varje
-- "bokstav" på i Unicode.
--
-- Arabiska har korta och långa vokaler. Normalt skrivs de korta vokalerna ej ut
-- i vanlig text. För pedagogiska syften (som till exempel i en ordbok) kan de
-- markeras med hjälp av diakritiska tecken som kallas "harakat". För att få en
-- korrekt återgivning bör modulen anropas med texten tillsammans med dessa
-- korta vokaler.
--
-- Denna modul beaktar inte reglerna för solbokstäver (shamsiya). När den bestämda
-- artikeln ("al") förekommer före ett ord som börjar på en solbokstav ska den
-- bestämda artikelns konsonant istället uttals som den första konsonanten av
-- huvudordet. Exempelvis ska uttrycket الشرق الأوسط ("Mellanöstern") egentligen
-- inte uttalas med "al-sh" i början, utan "ash-sh". Denna modul transkriberar dock
-- detta som "al-sh".
--
--
-- Denna modul används av följande mall:
-- {{tr}}
--
-- Modulen är författad av (och underhålls av) ]
local export = {}
latinska = {}
-- först de "vanliga" bokstäverna
latinska="ā"; latinska="ā"; latinska="ā"
latinska="b"; latinska="b"; latinska="b"; latinska="b"; latinska="b"
latinska="t"; latinska="t"; latinska="t"; latinska="t"; latinska="t"
latinska="th"; latinska="th"; latinska="th"; latinska="th"; latinska="th"
latinska="j"; latinska="j"; latinska="j"; latinska="j"; latinska="j"
latinska="ḥ"; latinska="ḥ"; latinska="ḥ"; latinska="ḥ"; latinska="ḥ"
latinska="kh"; latinska="kh"; latinska="kh"; latinska="kh"; latinska="kh"
latinska="d"; latinska="d"; latinska="d"
latinska="dh"; latinska="dh"; latinska="dh"
latinska="r"; latinska="r"; latinska="r"
latinska="z"; latinska="z"; latinska="z"
latinska="s"; latinska="s"; latinska="s"; latinska="s"; latinska="s"
latinska="sh"; latinska="sh"; latinska="sh"; latinska="sh"; latinska="sh"
latinska="ṣ"; latinska="ṣ"; latinska="ṣ"; latinska="ṣ"; latinska="ṣ"
latinska="ḍ"; latinska="ḍ"; latinska="ḍ"; latinska="ḍ"; latinska="ḍ"
latinska="ṭ"; latinska="ṭ"; latinska="ṭ"; latinska="ṭ"; latinska="ṭ"
latinska="ẓ"; latinska="ẓ"; latinska="ẓ"; latinska="ẓ"; latinska="ẓ"
latinska="ʿ"; latinska="ʿ"; latinska="ʿ"; latinska="ʿ"; latinska="ʿ"
latinska="gh"; latinska="gh"; latinska="gh"; latinska="gh"; latinska="gh"
latinska="f"; latinska="f"; latinska="f"; latinska="f"; latinska="f"
latinska="q"; latinska="q"; latinska="q"; latinska="q"; latinska="q"
latinska="k"; latinska="k"; latinska="k"; latinska="k"; latinska="k"
latinska="l"; latinska="l"; latinska="l"; latinska="l"; latinska="l"
latinska="m"; latinska="m"; latinska="m"; latinska="m"; latinska="m"
latinska="n"; latinska="n"; latinska="n"; latinska="n"; latinska="n"
latinska="h"; latinska="h"; latinska="h"; latinska="h"; latinska="h"
latinska="ū"; latinska="ū"; latinska="ū"
latinska="ī"; latinska="ī"; latinska="ī"; latinska="ī"; latinska="ī"
-- sen de korta vokalerna
latinska="a" -- fathah
latinska="u" -- dammah
latinska="i" -- kasrah
latinska="" -- sukun
-- sen specialfallet "alif maddah"
latinska="ā"; latinska="ā"; latinska="ā"
-- sen specialfallet "ta marbuta"
latinska=""; latinska=""; latinska=""
-- sen specialfallet "alif maqsurah"
latinska="ā"; latinska="ā"; latinska="ā"
-- fyra specialfall av diakritisk "hamza"
latinska="ā"
latinska="ū"
latinska="ī"
latinska="ā"
-- specialfallet isolerat "hamza"
latinska=""
-- specialfallet isolerat "shadda"
latinska=""
-- specialfallet "alif khanjariyah"
latinska="ā"
-- kasusmarkörer
latinska="un"
latinska="an"
latinska="in"
-- Fem köfunktioner
function enqueue(q, val)
q.last = q.last + 1
q.data = val
end
function dequeue(q)
local rval
if (q.first > q.last) then
rval = -1
else
rval = q.data
q.data = nil
q.first = q.first + 1
end
return rval
end
function peekonce(q)
local rval
if (q.first > q.last) then
rval = -1
else
rval = q.data
end
return rval
end
function peektwice(q)
local rval
if (q.first+1 > q.last) then
rval = -1
else
rval = q.data
end
return rval
end
function peeklast(q)
local rval
if (q.first > q.last) then
rval = -1
else
rval = q.data
end
return rval
end
-- Själva transkriberingsfunktionen för arabiska
function transkribera_ar(text)
-- Två köer: en för arabiska bokstäver och en för latinska bokstäver
indata = {}
indata.first = 0
indata.last = -1
indata.data = {}
utdata = {}
utdata.first = 0
utdata.last = -1
utdata.data = {}
-- en separat kö att returnera på slutet
local returndata = {}
for c in string.gmatch(text, ".*") do
enqueue(indata, c)
end
repeat
local x = dequeue(indata)
local y = peekonce(indata)
local z = peektwice(indata)
local u = peeklast(utdata)
if (latinska == nil) then -- icke-arabiskt tecken
enqueue(utdata, x)
-- först, de långa vokalerna i fullt vokaliserad text
elseif(string.match(x,"َ") and string.match(y,"ا")) then
enqueue(utdata, "ā")
dequeue(indata)
elseif(string.match(x,"َ") and string.match(y,"ٰ")) then
enqueue(utdata, "ā")
dequeue(indata)
elseif(string.match(x,"ا") and string.match(y,"َ")) then
enqueue(utdata, "ā")
dequeue(indata)
elseif(string.match(x,"َ") and string.match(y,"ى")) then
enqueue(utdata, "ā")
dequeue(indata)
elseif(string.match(x,"أ") and string.match(y,"َ")) then
enqueue(utdata, "ā")
dequeue(indata)
elseif(string.match(x,"إ") and string.match(y,"ِ")) then
enqueue(utdata, "ī")
dequeue(indata)
elseif(string.match(x,"ِ") and string.match(y,"ى")) then
enqueue(utdata, "ī") -- eventuellt vore "y" eller "iy" lämpligare
dequeue(indata)
elseif(string.match(x,"ُ") and string.match(y,"و")) then
enqueue(utdata, "ū") -- eventuellt vore "uw" lämpligare
dequeue(indata)
elseif(string.match(x,"و") and string.match(y,"ُ")) then
enqueue(utdata, "ū")
dequeue(indata)
elseif(string.match(x,"ِ") and string.match(y,"ي")) then
enqueue(utdata, "ī") -- eventuellt vore "iy" lämpligare
dequeue(indata)
-- sen, diftongerna
elseif(string.match(x,"َ") and string.match(y,"ي")) then
enqueue(utdata, "ay") -- eventuellt vore "ai" eller "ay" lämpligare
dequeue(indata)
elseif(string.match(x,"َ") and string.match(y,"و")) then
enqueue(utdata, "aw") -- eventuellt vore "au" lämpligare
dequeue(indata)
-- sen, dubbleringen "shadda" när den används efter andra diakriter
elseif((string.match(y,"ّ") and string.match(x,"َ")) or
(string.match(y,"ّ") and string.match(x,"ِ")) or
(string.match(y,"ّ") and string.match(x,"ُ"))) then
enqueue(utdata,u)
enqueue(utdata,latinska)
dequeue(indata)
-- sen, dubbleringen "shadda" när den används före andra diakriter
elseif((string.match(x,"ّ") and string.match(y,"َ")) or
(string.match(x,"ّ") and string.match(y,"ِ")) or
(string.match(x,"ّ") and string.match(y,"ُ"))) then
enqueue(utdata,u)
-- sen, dubbleringen "shadda" när den används utan andra diakriter
elseif(string.match(x,"ّ")) then
enqueue(utdata,u)
-- sen...
-- sist, övriga tecken enligt tabellen ovan
else
enqueue(utdata, latinska)
end
until (indata.first > indata.last)
repeat
local x = dequeue(utdata)
table.insert(returndata,x)
until (utdata.first > utdata.last)
return returndata
end
function export.transkribera( argument )
local text = argument.args
outputdata = transkribera_ar(text)
outputtext = table.concat(outputdata,"")
return outputtext
end
return export