[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RFC libquran: Data packaging
- To: "Development Discussions" <developer at arabeyes dot org>
- Subject: RFC libquran: Data packaging
- From: "Mohammad DAMT" <mdamt at gnome dot org>
- Date: Thu, 26 Jul 2007 18:03:09 +0300
Data are packaged into a directory which contains subdirectories and
several files describing the data. A package can contain the original
Quran text, or a translation or an audio set at minimum and can have
more than one translation or one audio set (but there shall be no more
than one the Quran text).
The original Quran text shall be provided only by the Arabeyes to make
it easier to control the content. The package name for the Quran text
is 'arabeyes.org', and it is the package which will be read by
libquran when it is asked to retrieve the original Quran text.
However, vendors or packagers can distribute their packages containing
translations or tafsirs or audio and there shall be no conflicts
between them.
The location of the package is arbitrary (the default known by the
libquran in Linux is /usr/share/libquran/data/) and the client can ask
the library to open the package from any place in the system as long
as it is local.
Data have a structure like this:
package-name/
text/
files/
text.db
license.txt
translations/
<id>/
files/
text.db
name.txt
language.txt
license.txt
additional-info.txt
audio/
<id>/
files/
s001001.spx
s001002.spx
....
name.txt
recitor.txt
language.txt
license.txt
mime-type.txt
additional-info.txt
- text: Holds the original text of Al Quran
license.txt: license of the text file
- translations: Holds the translations or the tafsirs
<id>: An string id distinguishing the translations/tafsirs (e.g. yusuf_ali)
name.txt: contains the name of the translation/tafsir (e.g. Yusuf Ali)
language.txt: contains the language code of the translations/tafsirs
in iso 639 format
license.txt: license of the text file
additional-info.txt: contains other info for the
translations/tafsirs (e.g. copyright info, etc)
- audio: Holds the audio
<id>: An id distinguishing the audio set (e.g. holy_quran_recitation)
name.txt: contains the name of audio data (e.g. Holy Quran Recitation)
recitor.txt: contains the recitor(s)
language.txt: contains the language code of the recitation in iso 639 format
license.txt: license of the text file
mime-type.txt: The mime-type of the audio set (e.g. "audio/mpeg")
additional-info.txt: contains other info for the
translations/tafsirs (e.g. copyright info, etc)