Open main menu

PanDocElectron/Wiki2Reveal

Wiki2Reveal Start Page to select the wikiversity source article
Reveal Presentation generated with Wiki2Reveal with stylus comment in the browser
Audacity for Recording of Audio Comments for Reveal

Wiki2Reveal[1] is one cross-compilation pair of PanDocElectron as HTML5-WebApp for on-the-fly generation of webbased presentation from a given article in Wikiversity. Wiki2Reveal convert a Wikiversity page

  • from the INPUT format in a MediaWiki
  • to the OUTPUT format RevealJS.

Demo Wiki2Reveal - Convert a Wikiversity article into a webbased presentation.

Source Article Wiki2Reveal Presentation
Demo Article as Example Wiki2Reveal with Math and Embedded Video
Mathematical Topology Demo Lecture Wiki2Reveal with german Audio Comments - Normen, Metrik, Topologie

The transcoding of the input format runs totally in the web-browser on the client side. The implementation was designed for the use in Wikiversity as learning resource, but it can also applied on Wikipedia pages but the sections contain mostly to much text to displayed on single slide.

  • (Start Wiki2Reveal) can select article name as link parameter of Wiki2Reveal,
  • (Fetch Article) download the Wiki sources e.g. from Wikiversity by wtf_wikipedia,
  • (RevealJS/DZSlides) convert the wiki sources to RevealJS or DZSlides syntax for the slides,
  • (Audio - Firefox) Use embedded audio files in OGG-format as slide content (see Wiki2Reveal Demo with Audio Slide Show and
  • (On the fly Slide Generation) display the converted slides in the browser on the fly.

The objective of this HTML5-WebApp is, that e.g. lectures can use Wikiversity articles directly as slides in a course as presentations.

Current StatusEdit

Demo Links for Wiki2RevealEdit

WorkflowEdit

To convert a MediaWiki source document e.g. in Wikiversity into a Reveal Presentation it is necessary to perform the following 3 steps.

  • the first step is the cross-origine call to retrieve the wiki source text of an article in the MediaWiki.
  • the second step is to transcode the wiki syntax to HTML body of the RevealJS presentation and
  • render the RevealJS presentation if the Wiki source text was fetched successfully from the MediaWiki server.
  • Multiple recordings of audio comments can be uploaded with [c:Commons:Commonist|Commonist]]. It has to be checked if multiple uploads of 15 audio files and more lead to blocking mechanism for account for further uploads with the software [c:Commons:Commonist|Commonist]] or if that is a problem with [c:Commons:Commonist|Commonist]] itself! Currently it is recommended in this phase of a proof of concept for Wiki2Reveal to upload audio comment in smaller bundles of 5 files and wait some time until you upload the next 5 audio comments in OGG format.

Try Wiki2RevealEdit

Wiki2Reveal-Online-Demo

  • (1 - Article Select) Select an article name, that was designed as presentation (i.e. small section, with text that fit on single slide - see Wikiversity:Topologie. Topologie
  • (Language Select) Select a Language (e.g. German in the user interface) for which you want to download the article as Reveak presentation.
  • (2 - Domain Select)Select a Wiki domain from which you want to download the presentation (mostly Wikiversity or Wikipedia)
  • (3 - Start Online Demo of Wiki2Reveal)Start Wiki2Reveal-Online-Demo and adjust the default settings for your article.
  • (4 - On-the-Fly-Download and Convert to Presentation) Press download presentation in Wiki2Reveal-Online-Demo.
  • (5 - Fullscreen Presentation) Press (F) for Fullscreen presentation.
  • (6 - Comment on Slide) Press (C) to comment slide with stylus on tablet or with mouse on PC. Comment on slide are only available during browser session
  • (7 - Blackboard for each slide) Press (B) for blackboard to have seperate empty blackboard for each slide for further comments that you want write down durch the lecture or seminar with stylus on tablet.
  • (Optional: Link Copy of Presentation) AfterRemember the wiki2reveal.html link the browser. You can copy this link and any time you click on the link you will get the current presentation generated on-the-fly from the article in the MediaWiki.
  https://niebert.github.io/Wiki2Reveal/wiki2reveal.html?domain=wikiversity&title=Normen%2C+Metriken%2C+Topologie&author=Wikiversity+Authors&language=de&audioslide=yes
Those links can be inserted at bottom of Wikiversity articles that were designed as PanDoc-Presentations. The wiki2reveal.html is just an HTML file with Javascript libraries. If this concept reaches the level of Proof-of-Concept and assessed as useful the HTML5 App can be placed on web server of your choice or even integrated in the Wiki server infrastructure as service. You can start the HTML files from your computer locally with e.g. by
  file:///localpath/wiki2reveal.html?domain=wikiversity&title=Normen%2C+Metriken%2C+Topologie&author=Wikiversity+Authors&language=de

Audio SlidesEdit

 
Wiki2Reveal User Interface

Wiki2Reveal is able to fetch the OGG-Audio comment from Wiki Commons and play the recorded audio comment as comment for the slides. The audio comments are embedded as regular OGG files at the end of the sections of each block. Start Wiki2Reveal with the parameter

&audioslids=yes.

With the Wiki2Reveal Starter you can interactively select the Wikiversity Page for Wiki2Reveal and further more you can select the settings for Audio Comments. When start the Wiki2Real Presentation with the user interface of Wiki2Real a link is created that you can also copy into the source Wikiversity page, so that users can start the presentation from the Wikiversity page as well.

Core LibraryEdit

Wiki2Reveal is a based on work of Spencer Kelly, who created wtf_wikipedia. Without his work Wiki2Reveal as support for learning resources in Wikiversity would not exist and implemented as a proof of concept. Currently some work is to do to create robust parsing and especially implementing the export format from an Abstract Syntax Tree (AST) into Office products like LibreOffice, PDF and presentations. Reveal is just one example of output formats that can be used. Furthermore the current application of the Book Creator in a Wikipedia and Wikiversity is very demanding on the server side. HTML5 application run in a browser and could take over the performance of conversion. The underlying structure of wtf_wikipedia could be a key component for such a HTML5 based software design, because it has incorporated the following underlying steps, i.e. in nutshell:

  • (fetch) fetching a one or number of articles with a call of the MediaWiki API.
  • (parse) creates an Abstract Syntax Tree (AST) from the wiki markdown source.
  • (output) take the AST as input and generate a specific output format like office documents, PDF, HTML or e-Book formats from the AST.

Learning TaskEdit

  • Explore the concept of an Abstract Syntax Tree in the library Uglify and AST created by parsing a HTML page!
  • What are the challenges parsing a Wiki markdown source and/or HTML in comparison to a programming language like C++.

FeaturesEdit

  • Wiki2Reveal is an AppLSAC, i.e. runs totally in your browser and does not need a software installed on your computer.
  • Download the HTML-files in the GitHub repository https://www.github.com/niebert/Wiki2Reveal and unzip on you harddrive. Explore the code in /docs before. Start the file docs/index.html in your browser.

See alsoEdit

ReferencesEdit

  1. Wiki2Reveal Online-Demo (2018) - GitHub-Repository - (accessed 2018/04/06) https://niebert.github.io/Wiki2Reveal