Page MenuHomePhabricator

Select links within an article
Closed, ResolvedPublic

Description

User story

As a KaiOS user, I want to select links within an article

Acceptance criteria

  • Distinction between wikilinks and regular article text
  • Be able to select link to see a page preview
  • Be able to select link to go to article
  • Be able to select reference link
  • Be able to see information on the reference on a separate page/pop up

Proposed designs

Mocks
Article title pageSecond page of articleThird page of articleLink that crosses line barrierLink previewReference in lineReference in line, second in group
09 - Article header.png (640×480 px, 244 KB)
10 - Article continued.png (640×480 px, 82 KB)
10c - Article continued - scroll.png (640×480 px, 93 KB)
10b - Article continued - focus on split line link.png (640×480 px, 82 KB)
10d - Link preview.png (640×480 px, 82 KB)
10d2 - Reference preview.png (640×480 px, 77 KB)
10d2 - Reference preview - after tapping next.png (640×480 px, 86 KB)
https://zpl.io/25oJjKJhttps://zpl.io/V05Lko9https://zpl.io/agOQq3Qhttps://zpl.io/awgJBlMhttps://zpl.io/bo6P6QEhttps://zpl.io/2E9r6Yxhttps://zpl.io/aMnrQYr
Screen type: dialogScreen type: dialogScreen type: dialog
Interaction details
ScreenD-pad centerD-pad up/downD-pad left/rightLSKRSK
Article headerSelects focused linkUp- N/A, Down - Moves to next page in articleCycles through header options (and links if there is no lead image)Returns to search resultsOpens menu
Article bodySelects focused linkMoves up and down through pages in articleCycles through linksReturns to search resultsOpens menu
Link preview Opens linkn/an/aDismisses dialogn/a

Related Objects

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

Push back to dev to handle references

@cmadeo @AMuigai any thoughts about how to display references and what the softkey actions should be? I found the following types of references so far: book, journal, news, web. Some have the "free' or "paywalled" attribute.

@SBisson would it be possible to open them up in a half screen like the link previews? We do have some icons we can use from web...but might be okay to just include the full citation text and allow users to select any blue links from within?

@cmadeo most references have external links, I'm not sure what we should do with them (that applies to general article links as well but external links are very uncommon there).

We can show them in the bottom drawer like page previews. Is it OK to clip the content when it's bigger than the available space?

I've found the following links don't work, we can hide them or make them work, somehow

  1. Links to files (File:Es-Espana.ogg)
  2. Help links (in the Help or Wikipedia namespace)
  3. Edit link below an image

@SBisson Oh, I'm sorry, I was confused since we were still missing a way to preview references seen inline. I mocked this up today:

Design notes:

  • Height of white overlay should grow to accommodate the height of the citation text, for citations where there are multiple citations that can be cycled through (eg. [1][2]) the box should be set to fit the largest amount of text for all references in this group (eg. the box should now grow and shrink as it is cycled)
  • Grouped citations (eg. [1][2]) open up a single panel, but tapping 'next' leads to the next citation in the group. This next button should cycle (eg go from citation 1 to 2 to 1)
  • Notes should be treated in the same way as citations but the header should be NOTE[number] rather than REFERENCE
  • Using the left and right hardware buttons will cycle through any links that are in the citation or note and should cycle
  • Tapping 'Select' should select the focused link in the citation or note
  • If there are no links do not show 'Select'
  • Tapping 'close' brings the user back to the article view (eg. dismisses the overlay) with focus placed on the correct citation

Regarding the links within references, are we able to pop the browser for non-Wiki-links?

Links to files (File:Es-Espana.ogg)

Can we either show these in the web browser or strip the links?

Help links (in the Help or Wikipedia namespace)

Can we show these in the web browser?

Edit link below an image

Can we strip this link?

@cmadeo Thanks for all the info above. I'll go through it in details, try to implement and let you know how it goes. One thing that strikes me is the treatment of grouped references. They are in fact not grouped in the document but appearing next to each other. We can easily select one or the other when we cycle the article links. We could try to group them and cycle them in the popup but that would be more work. Is it OK if we treat them individually?

@SBisson oh! Of course, I forgot that we grouped them on iOS due to tap targets, which isn't a problem for us on KaiOS! By all means, treat them separately!

@SBisson Let's make the page preview take up 80% of the screen. At the moment, the text in the previews is too little to give a reader enough context.