Giter VIP home page Giter VIP logo

unicef-adt-rw's Introduction

UNICEF ADT Rwanda

Introduction

This repository is purposed to track the changes towards the development of the Accessible Digital Textbook (ADT) in its initial prototype, beta protototype and final versions. The master branch is the main branch for this repository.

ADT Features

The ADT constitutes the following features:

  • Image descriptions
  • Rwanda Sign Language videos
  • Glossary
  • Navigation and structural hierachy
  • Interactive questions
    • Drag-and-drop
    • Fill in the blanks
    • True or false
    • Single choice
  • Audio synchronisation with text
  • Simplified text

Folder Organisation

Folder Purpose
01_Initial_Prototype Contains the initial prototype of the ADT. The prototype constitutes the first 2 units of the original PDF book.
02_Beta_Prototype Contains the beta prototype EPUB package version of the ADT with feedback incorporated. It constitutes the first 2 units of the original PDF book. Feedback from the initial prototype are incorporated.
03_Full_version Contains the final version of the ADT. It constritutes all the 10 units of the original PDF books with additional feedback from testing incorporated.
04_Templates Has the EPUB templates used in developing the final version of the ADT
05_Scripts_and_configs Contains scripts for fragment identifier generation within the span tags in the EPUB. Thisis to effect faster implementation of the media overlay in the ADT

unicef-adt-rw's People

Contributors

brianagina avatar charliekaks avatar dobbz avatar fabricekwizera avatar pankajsemwal avatar

Watchers

 avatar  avatar  avatar  avatar

unicef-adt-rw's Issues

Video placement may only work in Readium 2 Desktop (Thorium)

See attached for how the video looks in iBook on a Mac. I shared the file here https://drive.google.com/drive/u/0/folders/1Ehh2avchZM6DIJL7HkuSvWOM7izoBKUa with Aferdita. She suggested that the cause may be a bug in Readium that actually hides videos by default. So, we may be taking advantage of a bug to make it work in Readium Desktop.

She said this will probably impact Android, so we should fix it.
Screen Shot 2021-02-24 at 12 21 33 PM

@brianagina could you take a look and decide who should fix this?

Create framework for popups

Create and test the JS for popups for video, audio, images, and text.
The popup window should draw focus to itself

Typo on page 25

On page 25 Column B the wording should be "She has got rulers"

Compress Images in ADT

Hi Brian,

Quickly looking into the ADT, the image files are 50 mb total. We should look into compressing them. They are very large width.

Font resizing in the question header ad text

Resizing the question header in red and the question text before the tables to match with the initial font size in previous pages. For example the question header "Do this in groups" should be of the same font size as page 15 of the EPUB. And the question text "Which is the odd one out?" should be of the same font size as the caption's text font size. This is applicable to the drag and drop question as well.

Each glossary word should pop up only single and the relevant glossary video when clicked, not multiple videos

@mhand7 I think we raised this new issue but wasn't logged in GitHub issue tracker. Issue #78 was a bug we noticed based on expectation logged on this new issue.

Current:
For example, if we have 3 glossary words in a page, 3 videos will pop up irrespective of which glossary word in the page was clicked. The red X buttons becomes gray/white and is positioned the middle in subsequent videos apart from the top first video in cases where more than glossary word is on a single page. In pages with multiple (> 3) glossary words, the videos have to be scrolled through.
image
image

Expectation:
To have only one video frame popped at a time, despite the number of glossary words in a page. Clicking on the glossary word should only pop up ONLY one video for the relevant glossary word. We should stick with the red X button at the top right of the pop up video frame.
image

Make the radio button single choice question accessible

On page 20, the first of an interactive exercise exists where the user must answer A, B, C for colored objects. From a content adaptation perspective, a game like this may not be accessible for someone who has low vision or color blindness.Include descriptive image descriptions to assist the user

Centering content in pages to make good use of the whitespace

Current behaviour:
Some pages have a lot of whitespace at the top of the page or/and above the sign videos. Example page 8(2)
image

Expected behaviour:
Center content in pages with a lot of whitespace at the top of the page or/and above the sign videos. Example of good vertically aligned items with good use of space is on page 15(2) and 16(1)
image

Center content in the following pages/xhtml files:
1, 4(2), 5(2), 7,(2), 8(2), 9(2),
10(2), 13(1), 13(2),16(2),18(1), 19(2),
20(1), 22(2), 24(1), 24(2), 27(1), 27(2),
30(1), 30(2), 33(1), 33(2),
44(1), 44(2), 45(2),
56(1), 58(1), 59(2),

Feedback text

Have a Try again and Congratulations text feedback as well to complement the sound feedback when right/wrong.

Investigate gestures for drag and drop. Drag and drop is causing next page swipe in eKitabu Android 4.2.3

Hi Muhannad,

We are testing the ADT on our latest candidate release for Android. The drag and drop exercises are causing the page to turn. I suspect the same swipe gesture is being used.

Could you take a look and propose

  • a change to the gesture in the EPUB
  • a change to the gesture in the Android app?

I will add you to the Alpha Track for our Android e-reader. Link here:
https://play.google.com/apps/internaltest/4697743593543312459

Aferdita is leading the development of the Android app.

Split very long tables into 2 pages, page 54

Similar to issue #59
Current behaviour:
The table is too long thus the images are not clearly visible and if the font-size will be increased as well, the texts will look bigger and out of place within the cells
image

Expected behaviour:
Split the table into two pages maintaining the text before the table and the column header. The row with the Goat text should be end of the first table. The new xhtml file to accommodate the other half of the table rows will be unit08_page54-02.xhtml.

Merge pages into single page

Current behaviour:
For pages 61, 62, 63 and 64, the clock images and text take two pages with the final image being solitarily in the second page for each page number thus leaving more space. Example on page 61(1) and 61(2)
image
image

Expected behaviour:
Merge the content across the 2 pages so that we have the 3 clocks in one page as is on the pdf. We will have an interactive set for the questions so would also make sense to have the 3 clocks in one page as indicated in the pdf
image

Merge 61(1) and 61(2) into single xhtml file
Merge 62(1) and 62(2) into single xhtml file
Merge 63(1) and 63(2) into single xhtml file
Merge 64(1) and 64(2) into single xhtml file"

Make purple texts heading level 2 with a font-size of 35px across Unit 1-10

Current behaviour:
The purple texts within the units are in smaller texts compared to the caption text/other texts within the pages. Hard to distinguish them despite the color difference due to smaller font size.

Expected behaviour:
The purple texts are sub-topics within chapters and thus should be of heading level 2. We recommend a font-size of 35px to easily distinguish them and provide hierarchical structure and enhance accessibility while using assistive devices. Therefore the code will look something like this
<h2><span id="">The</span><span id="">Purple</span><span id="">Text</span></h2>

Split very long tables into 2 pages, page 43

Current behaviour:
Page 43 table is long to have same row height that would fit all the images.
image

Expected behaviour:
Split the table in page 43 into two across 2 xhtml files. The first table will have the chair image being the last row.
image

The second table will be on a new xhtml page named unit06_page43-02.xhtml. It will the four rows at the bottom of the current page in a well spaced table to accommodate the images, should have the coulmn headers A and B as well as the initial text "Say their names" before the table.

Please position the two tables to make good use of the space within the page.

Glossary words: remove embedded span tags for glossary word implementations

Current:
Span tags are embedded within the span tags with attributes video, poster for every glossary word implementation. Below is an example of the code:

`<div class="section-title">
      <h2><span id="s0007">Greeting</span> **<span class="video-span show-video" video="../Video/people.mp4" poster="../Images/unit2-6_image.png"><span id="s0008">people</span></span>**
      </h2>
</div>`

Expected:
Should not embed the span tag within another span tag for the glossary words across all relevant xhtml files. The above code and other implementations should look as such

`<div class="section-title">
      <h2><span id="s0007">Greeting</span> **<span id="s0008" class="video-span show-video" video="../Video/people.mp4" poster="../Images/unit2-6_image.png">people</span>**
      </h2>
</div>`

Two span tags for the two words, not three. The number of span tags should match the number of words

Page 35(1) Remove scroll bars, fix video and page number positioning

Current:
Issues are noted
1 - should not use digit. Should be 'forty-seven'
2 - video position and page number position are out of place
3 - scroll bar is visible. Should not have scroll bar on the page
image

Expected:
Fix positioning of the video and page number. We can reduce the td height.

page 56 texts is overlaid on the table, fit content in the page

Current:
The table heading is too close to the table. The table also overlays on the text below that reads "Get into groups...."
image

Expected:
Create spacing between table header and the table
The text "Get into groups...." and the table should be in distinct spaces.
We can reduce the td height in the table to fit all the content in the page

Make all unit header heading level 1 with font-size of 40px across 1-10

Current behaviour:
We do not have the heading levels 1 tags surrounding the span tags for unit number and text
image.
Sample code for unit10 looks like this:

<div class="unit-into-header display-flex">
      <div class="unit-num"><span id="s2545">Unit</span> <span id="s2546">10</span></div>
      <div class="unit-name flex-grow-1"><span id="s2547">Story</span> <span id="s2548">telling</span></div>
</div>

Expected behaviour:
The unit numbers and text are the intoroduction to the topic. We recommend using heading level 1 tags to surround the span tags with a font-size of 40px (the current font-size used) to provide hierarchical structure and enhance accessibility while using assistive devices. Therefore the code will look something like this

<div class="unit-into-header display-flex">
      <div class="unit-num"><h1><span id="s2545">Unit</span> <span id="s2546">10</span></h1></div>
      <div class="unit-name flex-grow-1"><h1><span id="s2547">Story</span> <span id="s2548">telling</span></h1></div>
</div>

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.