Note: left-right links navigation is handled in T234625: Select links within an article
and the yellow scroll marker is T234627: Article progress indicator

I have implemented a first version of the pagination.

I'm not too happy with where pages are split by the browser but I will like @cmadeo, @AMuigai, and @Jpita to play with it on some articles before I make any more changes.

first page

@Jpita The white gap between the main content and the softkey bar is there because the browser doesn't have the device top bar (with clock, battery, etc). I could use some tricks to use all available space but it would make the height available for the article different between browser and device. You can set your browser mobile mode to 290px, which is the actual height available on the device.

Page break up is currently based on asking the browser to lay the content in columns and scrolling left/right between columns to simulate pages. There are directives to ask the browser not to break some elements in the middle (like the buttons section) but these are not very well supported on Firefox 37 or 48, which are the actual runtimes for KaiOS 1.0 and 2.5 respectively. We may have to try to parse the page and manually break the content into pages. It's a lot more work but we would have full control.

Something for @cmadeo to think about: how should this page flow when the article title is long and spans two or more lines?

@cmadeo what should this page look like when the article title or description is long and spans two or more lines?

@SBisson sorry for the delay, I've had to wrap up some work for iOS.

Could we allow the title and the title description to overflow? One thing that is important is keeping the quick actions (sections, quick facts and audio) as a discrete unit with their labels.

https://zpl.io/beOrvNB	https://zpl.io/Vk73n88	https://zpl.io/2GRgOxm

Follow up needed on

• When looking at the section title page, the UP key goes to the first page of the previous section. The last page of the previous section would be more intuitive.
• Relationship between Article, Pager, and useScroll is confusing. Could use some refactor.
• When landing on a section title page, there is a flash of the previous title and image and it gets immediately replaced by the new content. Timing should be improved.

On the device, I noticed that if I click down quickly after landing on a new section I can skip it entirely and go to the next section. From there, if I click up to go to the previous section, I can click slowly and see all the pages of the section that was skipped.

@AMuigai is it ok that the articles go back to the beginning when we reach the end (and continue scrolling down after that)?

No, work is yet to be started on T236301: Article footer and read more

In T234436#5753989, @AMuigai wrote:

No, work is yet to be started on the article footer

The same questions apply with regards to the article footer. Is it at the end of the last section? Is it its own section with an entry in the TOC? What happens when you click down from the footer, do you go back to the beginning of the article?

In T234436#5754180, @SBisson wrote:

The same questions apply with regards to the article footer. Is it at the end of the last section? Is it its own section with an entry in the TOC? What happens when you click down from the footer, do you go back to the beginning of the article?

The article footer should be a part of the 'About this article' section and should not be represented as an individual section in the TOC.
When you click down from the footer I'd propose that nothing happens as it is the end of the article.

In T234436#5754470, @cmadeo wrote:

The article footer should be a part of the 'About this article' section and should not be represented as an individual section in the TOC.

"About this article" is not a real article section. It is made up in the apps. My understanding now is that we DO want to create a special footer section available in the TOC.

Ah, sorry. I think I had just the legal footer in mind! Yes, we'll want all
of the added footer elements to be in one special section at the end of the
TOC