-
Notifications
You must be signed in to change notification settings - Fork 1
/
params.json
6 lines (6 loc) · 3.54 KB
/
params.json
1
2
3
4
5
6
{
"name": "Genera",
"tagline": "Documentation for Museum Victoria's Genera Project ",
"body": "### Introduciton\r\n\r\nWhen a bird-watcher, or “twitcher”, is out in the forest and spots a bird that they can’t identify, they’ll generally reach for their favourite field guide book. Within the pages of that field guide, they’ll find images of individual birds along with detailed descriptions of their distinguishing features, and the areas in which they are found.\r\n\r\nFor over a century, organisations and individuals have been publishing paper based field guides on a range of topics, including birds, wildflowers, and minerals. The majority of the pages of these books are devoted to the entries on each distinguishable object in the topic area. However, often a serious naturalist would need to carry more than one guide, books go out of date and they also get heavier the more content is added to them. The advent of mobile devices and associated app stores into the marketplace was a gamechanger. For something like a field guide, publishing to mobile has many advantages – including the opportunity to add many more images, plus sound files, as well as the traditional descriptive text.\r\n\r\nIn 2011, Museum Victoria (MV) released the “Field Guide to Victorian Fauna” for iOS devices. The source code for that project was released under an MIT style licence so that other organisations and individuals could produce field guides of their own. \r\n\r\nThe original code was structured so that a field guide could be produced without needing to modify the Objective C code. This was achieved by having a defined data file format, text layout controlled by HTML templates and a standardised set of requirements. By simply adding data, images and audio to the project a “standard” field guide could be produced. \r\n\r\nBy modifying the HTML templates, users of the source code could produce a customised version. However, the structure of the data file meant that without modification to the code, the system was only suitable for field guides to animals including birds and invertebrates (together known as fauna).\r\n### The Genera Project\r\nIn 2012, MV built on the concept to produce a code base that could be used for field guides on any topic or even multiple topics - the Genera System.\r\n\r\nThe Genera system was built to allow organisations or individuals to produce “field guide” style apps for any subject, and to deploy them across multiple platforms – e.g. iOS, Android – without needing to modify application code.\r\n\r\nTo achieve this, Genera modifies the previous standard data format by separating the data into the fixed properties required to control aspects of front end presentation in the app, and a section of user defined properties. HTML and CSS templates are used for the detailed presentation of information.\r\n\r\nThe ideal implementation of the Genera system allows the user to produce an app by running a compile script after putting a data file, HTML/CSS templates, and associated media assets into specific directories.\r\n\r\n### Implementations\r\nThis repository is for documentation and example files. Implementations for specific platforms are in separate repositories. \r\n\r\n#### Genera for iOS - Swift\r\nThis is the most current version of the Genera Platform for iOS -[Swift Repository](https://github.com/museumvictoria/mv-genera-ios-swift) \r\n\r\n#### Genera for Android\r\nWe are currently working on a version for Android devices.",
"note": "Don't delete this file! It's used internally to help with page regeneration."
}