Difference between revisions of "KiwixKolibri"

From Kiwix
Jump to navigation Jump to search
m (Adding Channel IDs for demoing)
(Fleshed out some of the Kiwix/Kolibri kollaboration ideas.)
Line 32: Line 32:
== Integration focus areas ==
== Integration focus areas ==


=== Integration on Android ===
=== Cross-linking between platforms ===
 
==== Shallow-linking ====
From Kolibri: detect that Kiwix is installed, get an index of OpenZIM bundles and their metadata, and show links to the corresponding Kiwix URLs alongside the Kolibri channel list


Using [https://developer.android.com/reference/android/content/Intent.html Intents] to cross-reference between the platforms
From Kiwix: _____


=== Deep-linking in both directions ===
==== Deep-linking ====


A more general version of cross-linking to resources between the platforms.
A more general version of cross-linking to resources between the platforms. Possibly based either on a GUID or URI approach (which will likely be implemented in some form for cross-linking within Kolibri channels anyway), or through shared metadata/tagging schemes.


From Kiwix: Say you export a zim of a Kolibri channel which has an exercise, then we can use a placeholder with a deep link back to Kolibri.
From Kiwix: Say you export a zim of a Kolibri channel which has an exercise, then we can use a placeholder with a deep link back to Kolibri.
Line 44: Line 47:
From Kolibri: Instead of trying to fit in a Wikipedia zim, we can find a mechanism to add links as related contents. Like "Want to learn more about atomic fusion, read about it on Wikipedia".
From Kolibri: Instead of trying to fit in a Wikipedia zim, we can find a mechanism to add links as related contents. Like "Want to learn more about atomic fusion, read about it on Wikipedia".


=== Exporting Kolibri channels to Zim ===
=== Importing/Exporting content ===


Static contents like videos in Khan Academy or Sikana.tv can be exported as zim, given we use the meta data (topic trees) for navigation + some template parameters like title, logo and colors.
==== Exporting Kolibri channels to Zim ====


=== Exporting Zim to a Kolibri channel ===
Static contents like videos in Khan Academy or Sikana.tv can be exported as a static zim, given we use the meta data (topic trees) for navigation + some template parameters like title, logo and colors.


Exporting to the [http://contentworkshop.learningequality.org/ Kolibri Content Curation server]: Build a ricecooker script that creates a topic tree and iframes the static HTML files and assets from a Zim source? May not be very useful for all of Wikipedia, but can be useful for smaller Zim projects.
==== Importing from a Zim into a Kolibri channel ====
 
Importing a Zim into a channel in the [http://contentworkshop.learningequality.org/ Kolibri Content Curation server]: Build a "sushi chef" script (using the ricecooker) to create a topic tree by traversing the content within the Zim. Depending on the format of the content in the zim, this might be a topic tree with videos, or in the Kolibri "HTML5 app" format, a set of pages that will be iframed. May not be very useful for something like all of Wikipedia, but can be useful for smaller Zim projects (or ones with a lot of rich media files).


* '''Benefit''': Someone can start creating '''exercises''' and '''re-organizing''' for a specific educational purpose
* '''Benefit''': Someone can start creating '''exercises''' and '''re-organizing''' for a specific educational purpose
Line 58: Line 63:


Aligning standards of exporting meta data to OPDS, such that Kiwix Zim resources and Kolibri Channels can be searched and browsed through the same interfaces. Collaborate with Tim Moody on this.
Aligning standards of exporting meta data to OPDS, such that Kiwix Zim resources and Kolibri Channels can be searched and browsed through the same interfaces. Collaborate with Tim Moody on this.
=== Integration on Android ===
Using [https://developer.android.com/reference/android/content/Intent.html Intents] to cross-reference between the platforms


== Stickers & Swag ==
== Stickers & Swag ==


# Kolibri <3 Kiwix
# Kolibri <3 Kiwix (Lovebirds :) )





Revision as of 19:03, 8 July 2017

Introduction

This page is about integration between Kiwix and Kolibri [1] [2] [3]

(created for the Wikimania 2017 Hackathon)

Trying Kolibri

Online demo: http://kolibridemo.learningequality.org/

Please note that Kolibri is alpha software - we do not recommend deploying it before later this year.

Using locally:

  1. Download the latest .pex release: https://github.com/learningequality/kolibri/releases
  2. Make the file executable: chmod +x kolibri-v0.4.3.pex
  3. Run Kolibri ./kolibri-v0.4.3.pex start
  4. Navigate with your browser to http://localhost:8080

Once installed, you can add content by logging in as an administrator and using one of the many available Channel IDs... these are just a few of them, we should be able to have more

Khan Academy small test:     8b4d3e6d3d4842ba8ea658335b5dd252
Khan Academy English Math:   1ceff53605e55bef987d88e0908658c5
Khan Academy Swahili Math:   ec164fee25ee526296e68f7c10b1e169
Khan Academy with exercises: f6d2f857af2e304093648daf2d8cacec
Sikana in Chinese (ZH):      3e9ffc29aa0b59c3bda8d8c7ed179685
Sikana in French (FR):       8ef625db6e86506c9a3bac891e413fff
Sikana in English (EN):      3e464ee12f6a50a781cddf59147b48b1

In case you find an issue, feel free to ask in the community forum or file an issue on Github.

Integration focus areas

Cross-linking between platforms

Shallow-linking

From Kolibri: detect that Kiwix is installed, get an index of OpenZIM bundles and their metadata, and show links to the corresponding Kiwix URLs alongside the Kolibri channel list

From Kiwix: _____

Deep-linking

A more general version of cross-linking to resources between the platforms. Possibly based either on a GUID or URI approach (which will likely be implemented in some form for cross-linking within Kolibri channels anyway), or through shared metadata/tagging schemes.

From Kiwix: Say you export a zim of a Kolibri channel which has an exercise, then we can use a placeholder with a deep link back to Kolibri.

From Kolibri: Instead of trying to fit in a Wikipedia zim, we can find a mechanism to add links as related contents. Like "Want to learn more about atomic fusion, read about it on Wikipedia".

Importing/Exporting content

Exporting Kolibri channels to Zim

Static contents like videos in Khan Academy or Sikana.tv can be exported as a static zim, given we use the meta data (topic trees) for navigation + some template parameters like title, logo and colors.

Importing from a Zim into a Kolibri channel

Importing a Zim into a channel in the Kolibri Content Curation server: Build a "sushi chef" script (using the ricecooker) to create a topic tree by traversing the content within the Zim. Depending on the format of the content in the zim, this might be a topic tree with videos, or in the Kolibri "HTML5 app" format, a set of pages that will be iframed. May not be very useful for something like all of Wikipedia, but can be useful for smaller Zim projects (or ones with a lot of rich media files).

  • Benefit: Someone can start creating exercises and re-organizing for a specific educational purpose
  • Benefit: Other channels can include new learning materials from already existing Zim resources

Shared OPDS standard

Aligning standards of exporting meta data to OPDS, such that Kiwix Zim resources and Kolibri Channels can be searched and browsed through the same interfaces. Collaborate with Tim Moody on this.

Integration on Android

Using Intents to cross-reference between the platforms

Stickers & Swag

  1. Kolibri <3 Kiwix (Lovebirds :) )


References