Sample library.info file

From OLPC
Revision as of 17:37, 13 July 2007 by Lauren (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Here is an example library.info configuration file:

[Library]
name = Dictionary
library_version = 1
host_version = 1
service_name = ???
icon = library-dictionary.svg
exec = ???
class = ???
mime_types = ???
locale = en_US
subject = books & reference
category = reference

[Library] - The library.info file must begin with [Library], and only that, on the first line of the file.

name - This is the name is displayed in the library navigation sidebar referring to the collection. The library.info file must have this line.

library_version - The version is a single positive integer that refers to the version of the collection. Larger numbers are considered "newer". The library.info file must have this line.

host_version - The host version is a single positive integer that refers to the version of Sugar which the collection is compatible with. For now, this is 1.

service_name - SJ: Don't think this is relevant here. Is it?

icon - This is the name of the icon that represents the collection in the library navigation sidebar. It should have the same name as the icon stored in the library directory.

class - SJ: Is there a library class? Does it matter?

mime_types - SJ: Also not relevant, unless we want to keep track of what file formats each collection contains.

locale - This is the ISO code for the primary language of the collection, in lowercase, followed by an underscore, and then its localization information (also represented in ISO code). In this case, US-localized English is represented as en_US. UK-localized English, for example, would be represented as en_UK.

For a list of ISO language codes, see http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

For a list of ISO country codes, see http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

subject - This refers to the subject classification in the OLPC Library. The current options are: books & reference, math & science, images & maps, music & video, activities, web links, and uniwiki.

category (optional) - This refers to the category classification within a subject. Please refer to the OLPC Library for current category classifications.