Derek-Jones / ESEUR-book

Issue handling for Evidence-based Software Engineering: based on the publicly available data
http://www.knosof.co.uk/ESEUR/
279 stars 18 forks source link

Phone readable publishing format. #16

Closed SoftwareApe closed 4 years ago

SoftwareApe commented 4 years ago

Thank you for providing this book.

I'm not sure how you're publishing the book, but given the fact that many people always have their phone on hand PDF is not ideal. Instead some ebook format which allows reflowing the text would be helpful.

Derek-Jones commented 4 years ago

The amount of special case formatting in the raw text (various scripts were written to process the intermediate output before being passed to LuaLatex) means it would be a lot of work to switch to another output format.

I am thinking of producing a plots only ebook is various formats, perhaps with optional R code. Would that be interesting?

SoftwareApe commented 4 years ago

Thanks for replying. I'm not sure what a plots only ebook would mean, since what I find hard is reading hundreds of pages scrolling left to right for the text. I do understand if it's difficult to have multiple output formats.

woile commented 4 years ago

Same as SoftwareApe, it's a pitty, but I'll try reading from the PDF. I'm also not sure what a plot only ebook is.

Thanks again for the work! Highly appreciated!

Derek-Jones commented 4 years ago

A plots only ebook would just contain the plots that appear in the outside margin.

My assumption is that people would be interested in finding data associated with an issue they have. Being able to look at the plots, or search via meaningful captions (some work needed for this) would be useful (he said grasping for straws...)?

woile commented 4 years ago

hahaha no worries! I think a pdf would actually be useful for that. The kindle ui and refresh rates are quite slow, so I wouldn't use it to search.

Derek-Jones commented 4 years ago

Would a pdf with shorter lines help?

It would probably be relatively easy to generate a more narrow width device friendly pdf.

woile commented 4 years ago

I think so, it would be great.

Derek-Jones commented 4 years ago

Just generated a reduced text width pdf. Easy to do. But will take some time to double check for serious layout problems.

I cannot find any suggested guides for generating pdfs for mobile devices.

How many characters per line might be best?

Derek-Jones commented 4 years ago

Checkout the experimental mobile friendly pdf.

Some of the formatting is off, but is it easier to read?

bbigras commented 4 years ago

I came here from #17. Would an epub format be possible? It could be great with ebook readers like the kindle.

Derek-Jones commented 4 years ago

Generating an epub formatted file would be a lot of work.

Reflowable pdfs are one answer, and there are readers such as xodo and Librera that claim to do it automatically (have not tried).

I'm reading about embedding tags in the pdf to give reflow hints, but I have not seen any packages to help out.

Pointers welcome.

Have you checked out the experimental mobile pdf version?

woile commented 4 years ago

Hey Derek I was able to test it, and I didn't find it useful. I think what would help is a smaller page. With the mobile pdf I found myself scrolling all around the same page.

Derek-Jones commented 4 years ago

Wolle,

I have uploaded a new version. The paper width now matches the text+plot width, so margins are minimal, but text width is the same.

The text is readable on my old Android phone (screen 1920x1080 px, width 69.8 mm or 2.75 in).

With text+plots you are either going to have to scroll horizontally or vertically.

The table layout could be better, but that is a generic problem to both pdf layouts.

bbigras commented 4 years ago

Have you checked out the experimental mobile pdf version?

I'm going to give it a try. Maybe the kindle will read the pdf just fine or maybe I could try to convert it with calibre. Thanks!

bbigras commented 4 years ago

Screenshot_20201114-202550

This is how it looks on Kindle for Android.

Derek-Jones commented 4 years ago

Hey, that looks good to me, but then I am looking at it on a large screen.

Is it readable when looking at the device?

Do the color plots look ok?

bbigras commented 4 years ago

Is it readable when looking at the device?

It's a bit tiny but I can zoom and scroll. So I'm guessing it's the best we can get. Also, I didn't realize there were some plots in the margin.

The plots look fine: image

Derek-Jones commented 4 years ago

What is the width of your screen?

Mine is 1920x1080 px, width 69.8 mm or 2.75 in, and the text looks (but not sure I would want to read it for very long).

bbigras commented 4 years ago

It's a Pixel 2: "5-inch (130 mm) 16:9 1080p (1920 × 1080) AMOLED display panel with a pixel density of 441 pp"

It might be readable without zooming but it's a bit tiny. It looks like this:

image

while a normal book looks like:

image

Derek-Jones commented 4 years ago

I had assumed that people would not have the text and plots on the screen at the same time. Otherwise the amount of text per line would be a word or two.