{"id":13296682,"url":"https://github.com/global-asp/global-asp","last_synced_at":"2025-04-11T21:53:03.752Z","repository":{"id":32956801,"uuid":"36559494","full_name":"global-asp/global-asp","owner":"global-asp","description":"Global ASP - African Storybook Project for the World","archived":false,"fork":false,"pushed_at":"2025-04-09T23:48:28.000Z","size":5635,"stargazers_count":14,"open_issues_count":1,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-11T21:52:53.858Z","etag":null,"topics":["africa","creative-commons","multilingual","storybooks","storytelling","translation"],"latest_commit_sha":null,"homepage":"https://globalstorybooks.net/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/global-asp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-05-30T13:38:55.000Z","updated_at":"2025-04-09T23:48:34.000Z","dependencies_parsed_at":"2024-10-13T22:40:31.797Z","dependency_job_id":"7a462ed9-7cf9-4206-9558-5625efa6c34c","html_url":"https://github.com/global-asp/global-asp","commit_stats":{"total_commits":2742,"total_committers":4,"mean_commits":685.5,"dds":0.3574033552151714,"last_synced_commit":"feeff417725be06149b7b7eb33f2f02200732709"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/global-asp%2Fglobal-asp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/global-asp%2Fglobal-asp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/global-asp%2Fglobal-asp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/global-asp%2Fglobal-asp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/global-asp","download_url":"https://codeload.github.com/global-asp/global-asp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248487733,"owners_count":21112188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["africa","creative-commons","multilingual","storybooks","storytelling","translation"],"created_at":"2024-07-29T17:20:54.406Z","updated_at":"2025-04-11T21:53:03.718Z","avatar_url":"https://github.com/global-asp.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Global ASP - African Storybook Project Stories for the World\n\n## Overview\n\nThe goal of this project is to translate the freely-licensed materials created by the [African Storybook Project](http://africanstorybook.org) into all of the world's languages so that children and language learners everywhere can enjoy these wonderful African stories and create new ones in the same spirit.\n\nAll languages are welcome, although translations into African languages should usually be directed to the African Storybook Project main site rather than here. We are particularly interested in translations into languages that have very few resources for early childhood learning. For example, if you are involved in indigenous language revitalization, minority language education, or heritage language learning, we would love it if you could join the project.\n\n## PDFs\n\nAll of the audio, images, and PDFs associated with this project can be downloaded from the links found [here](https://storybookscanada.ca/downloads/).\n\n## Structure\n\nEach top level folder represents a language, identified by its [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) or [ISO 639-3](http://en.wikipedia.org/wiki/ISO_639-3) code, with a preference for the ISO 639-1 \"Alpha-2 code\", if it exists. For major languages, this code is usually two characters long (e.g., `es`, `zh`, `ar`), although some languages may have three characters (e.g., `yue`).\n\nWithin each folder, files are grouped by _story number_ (a four-digit index number that unambiguously identifies the story within the collection). The _basename_ for each story consists of the _story number_ followed by an underscore (`_`), and then the translated name of the story in lower case with any spaces replaced by dashes (`-`).\n\nAll of the source files in the repository are stored in Markdown format, and consist of the _basename_ plus the Markdown extension `.md`. Alternate, binary and other formats generated from the source files are named with the _basename_ followed by the appropriate format extenstion.\n\nFor example, the Norwegian story _En veldig høy mann_ is story `#0001`, so the base filename is `0001_en-veldig-høy-mann`. The file containing the story source is `0001_en-veldig-høy-mann.md`, and other formats included in the download package include `0001_en-veldig-høy-mann.txt`, `0001_en-veldig-høy-mann.pdf`, `0001_en-veldig-høy-mann.epub` etc.\n\nA list of \"core\" translateable stories by index number can be found [here](https://github.com/global-asp/global-asp/tree/master/INDEX.md). The list includes links back to the original versions of each story on the African Storybook Project.\n\nDue to an absence of an unambiguous id for each story on the ASP site, stories have been assigned an index number randomly and/or in the order that they are translated. If you are translating a new story for the project just add it to the end of the list and assign it a new index number in sequential order.\n\n\n## File formats\n\nThe availability of stories in multiple formats is beneficial for others who might wish to use, adapt, or translate them into other languages. At a minimum, we aim to provide stories in the following formats:\n\nFile format | Extension | Notes\n------------|-----------|------\n__Markdown__ | .md | The source format: all translations are stored in this format, from which the other formats are automatically generated\nEPUB | .epub | An electronic book format version of the story, suitable for use with e-readers\nHTML | .html | An HTML file containing the text of the story, with images linked to an included `img` folder (see JPG format above)\nHTML slideshow | _slides.html | A standalone html slideshow in [DZSlides](http://paulrouget.com/dzslides/) format\nJPG | .jpg | Extracted images for each story in a separate `img` folder; these are refered to by the HTML and slideshow files, and are used to compile other formats such as PDF and Epub\nPDF | .pdf | A PDF version of the story compiled from the Markdown source text and image bank\nText | .txt | A plain text file containing the full text of the story as well as author and license information; the content of this file is very similar to the .md source, but may be easier to read/open/edit on some systems or for users not used to working with Markdown\n\nThe following multimedia formats are now available as part of the [gasp-audio](https://github.com/global-asp/gasp-audio) project:\n\nFile format | Extension | Notes\n------------|-----------|------\nOgg Vorbis | .ogg | An Ogg Vorbis audio file of the story being read aloud\nMP3 | .mp3 | An MP3 audio file of the story being read aloud\n\nAudio files are automatically cut into individual sections and turned into [audio slideshows](https://global-asp.github.io/audio/). Please see the [gasp-audio](https://github.com/global-asp/gasp-audio) project for details.\n\n## Source format\n\nThe source files in this repository are stored in [Markdown format](https://help.github.com/articles/markdown-basics/). You can download pre-formatted (untranslated) Markdown files from the [ASP Source](https://github.com/global-asp/asp-source) project that have been extracted from the original ASP pdfs and automatically converted, for all of the core stories in the master index.\n\nThere are a few conventions that are used in addition to basic Markdown formatting to allow the files to be easily converted to other formats.\n\n### Story title\n\nThe title of the story is indicated at the top (first line) of the Markdown file, generally following a hash character and a space (`# `). The title should be on a single line (no linebreaks). If there is a sub-title or other information about the story that should be on the front page (aside from the author name -- see the [Metadata section](#metadata) below), it can be included on the following lines (__not__ preceded by `#`).\n\n### Page breaks\n\nPage breaks within the story are indicated by two `##` characters on a separate line, followed by the text of the following page.\n\n### Sections\n\nFor the purposes of this project, stories are conceived of as individual pages consisting of a single image and accompanying text, with surrounding front and back covers and associated metadata. Almost all of the ASP stories conform to this format, and it has been followed here as well, which makes generation of other formats much easier.\n\nSections are defined as the content found between page break markers (`##`), or between a page break marker and the beginning/end of the file.\n\nThe first section is roughly equivalent to the cover page and should only contain the title of the story and (in rare cases) a sub-title or other explanatory text that should go underneath the title on the cover. Metadata such as the author name and language of the story will be automatically included when storybooks are generated and should __not__ be in the first section.\n\nThe last section is equivalent to the final page or back cover of the storybook, and contains relevant [metadata](#metadata) about the story. See the [Metadata section](#metadata) below for details about what to include here.\n\n### Images\n\nImages from the [ASP Image Bank](https://github.com/global-asp/asp-imagebank) are automatically included in the generated binary formats and are __not__ indicated in the markup. There is no need to create image links or link to image urls or filenames within the Markdown source.\n\n### Metadata\n\nStory metadata is included in the [last section](#sections) of the Markdown source file.\n\nThe metadata section should include the following information:\n* License\n* Writer\n* Illustrator\n* Translator\n* Language\n\nThese should each be on a separate line, and each item of metadata should not be more than a single line. There is some flexibility with the wording, but ideally the names should be as consistent as possible. Any additional fields or information will be removed from the generated storybooks.\n\nA typical metadata section should look something like this:\n\n    * License: [CC-BY]\n    * Text: Clare Verbeek\n    * Illustration: Mlungisi Dlamini\n    * Translation: dohliam\n    * Language: zh\n\nNotes:\n* The License information is included between square brackets (`[]`) and should be one of either `[CC-BY]` or `[CC-BY-NC]` in accordance with the original story license\n* The Translator field should indicate your name rather than the name of the person who translated the original ASP story (if the original is a translated or versioned story)\n* The Language field should exclusively use the appropriate language code for the language you are translating __into__\n\n## Download\n\n**NOTE**: These are now out of date. For more current downloads (PDF and audio in a variety of formats), see [this link](https://storybookscanada.ca/downloads/). A build toolchain for compiling your own binary formats from the raw Markdown files will be added here soon. See also [Nairobi CSS](https://github.com/global-asp/nairobi-css) for a quick way to use the Markdown files in this repository directly in a custom built online site.\n\n***\n\nPre-compiled binary releases containing Markdown source files along with alternate formats (specifically __PDF__, __ODT__, __epub__, __HTML__, __HTML slideshow__, __jpg__, and __plain text__) are available on the [releases page](https://github.com/global-asp/global-asp/releases).\n\nSee the download lists (files named `README.md`) in the individual language folders for download links for specific languages.\n\n## Contributing\n\nAll contributions are welcome! (This includes reporting issues.)\n\nIf you are interested in translating any of the stories, [__start here!__](https://globalstorybooks.net/translator/) This link will take you to the [Global Storybooks Translator app](https://globalstorybooks.net/translator/), which makes translating stories quick and easy. The app starts with the shortest and simplest stories first, and lets you gradually work up to translating more complicated stories as you progress -- though you can skip forwards or backwards and translate any story you like at any time.\n\nYou are also more than welcome to submit a pull request directly to this repo with your translation / correction. You should use the .md files in this repo (which are also included in the [binary releases](#download)), and follow the [existing format](#source-format). This is the only format accepted for pull requests to this Github repository.\n\nSee the [Source format section](#source-format) above for information about getting pre-translated Markdown files for all the ASP stories.\n\nIf you're already comfortable with Github and version control, here are some other ideas for ways to get involved:\n\n- Start a new language subfolder for a language we don't have yet\n- Proofread / correct errors in existing stories\n- Create a [new translation of a story](https://global-asp.github.io/translator/)\n- Record audio/video for stories that don't have any (we are actively looking at ways to manage audio and video formats, but for now the best place to put them is probably YouTube or a similar site)\n- Create a new adaptation/remix of a story in the project (these can be linked to in the wiki)\n\nYou can also send .md or plain text files to globalafricanstorybook@gmail.com with your translation or correction and they will be included in the project with attribution.\n\n## License\n\nThis project is released under the same license as the African Storybook Project. In other words, except where otherwise noted, all content is licensed under the [Creative Commons Attribution 4.0 Licence](https://creativecommons.org/licenses/by/4.0/).\n\nAll of the ASP and Global-ASP stories are [Creative Commons-licensed](http://creativecommons.org/). By contributing a translation to the project you agree to release your work under a Creative Commons license (either [CC-BY](https://creativecommons.org/licenses/by/4.0/) or [CC-BY-NC](https://creativecommons.org/licenses/by-nc/4.0/)) in accordance with the license of the original story.\n\nMany thanks to the original authors and illustrators, our translators, and the many people who have volunteered to check and proofread the translations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglobal-asp%2Fglobal-asp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglobal-asp%2Fglobal-asp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglobal-asp%2Fglobal-asp/lists"}