Skip to content

Category: Updates

Last Week’s Post…

Last week was the last week of my cold or whatever it was, it reduced my productivity over the last few weeks, particularly last week – I didn’t even go to the gym. I saw a therapist on Thursday who really helped though, my tendons were all over the place. I have another appointment this Thursday which I am very much looking forward to. Furthermore, I got new reading glasses last week (from the 20’s worked on by jewellery makers in America) for reading which have made reading a whole new thing, it’s so much clearer than I am used to. Previously, for the last few months, I had one reading and one driving contact in at the same time and they were supposed to balance out but it was far from perfect.

I made it down to the Wednesday presentation though, which I’m very happy about, it’s really very nice and energising to see the team.

Friday was the 48th anniversary of Doug’s Demo and Vint and Wendy confirmed the date for the next Future of Text: 11 September 2017.   :-)

Author was supposed to ship last week but we still have Save issues and I will now have to pause the project, it’s not only costing too much, it’s taking too much time and stress away from my PhD, particularly the Literature Review, a process I really do not like, since I don’t want to print the papers out since I am working to improve the process itself and the papers are optimised for paper, by the way they are laid out in PDF. I put together a proposal for an application (macOS initially, then iOS soon) to help with the process of actually finding the annotations added during the literature review process: http://wordpress.liquid.info/liquid-reader-for-literature-review/

I got up at 4:30 this morning, happy to be back to the routine, let’s see what this week brings and how much literature review I can get done. :-)

Leave a Comment

Liquid | Reader for Literature Review

The Problem & Solution

The main issue Liquid | Reader addresses is a researcher cannot annotated (through highlighting or writing) a PDF document and then easily access the annotations later, when they are needed for the document/thesis writing. Liquid | Reader solves this in two ways:

•  Allows the user to pinch to see only the annotated text in the document.
•  Opens up all highlight-annotated text to the macOS Spotlight search.

Minimal Viable Version 1.0 Product

Annotating Text

•  Select text to highlight and unless there is an action performed on it within 1 second (such as copy, de-select or Liquid | Flow), the selection turns into an annotation automatically, going yellow. (This duration can be changed in Preferences). (Selecting text should work the same logic as Liquid | Author: double click for single word, triple click for sentence etc.)
•  To Undo the annotation simply select the text again and the reverse happens.

Finding Annotated Text In-Document

•  Pinch in and out to zoom the document, same as in the Apple Preview application, but if you pinch beyond the size of the document fitting the screen: you pinch to collapse the document to only see annotated text. It is similar to the result of pinch in Author (including visual style), except here there are no Headings, only annotations. (In Author, when we implement annotations, the pinch command will show Headings as well as the users annotations). (If there is no annotation, nothing happens on pinch)
•  Pinch back to return to normal view or
•  Click on text to jump to that section
•  Cmd-F to search the document. All keywords found in annotations is shown above a line, all non-annotated text shown below a line. All results shown as sentences, as in Liquid | Author (I need to know if this is do-able or very hard)

Searching for Annotated Text In Finder

On MacOS the annotated text (only) will be made available for Spotlight searching. Not the text of the document in general.

The documents need to support macOS tags, applied in Finder.

Visual Style of Collapsed/Annotation View

Use code and visual design from Author for this project for the annotation view (show PDF as-is, but use #fdde7e as the yellow for highlighting). The visual style of the text should be the same as default Author style (Read mode) and should have the same option in Preferences to change. The display of the collapsed view showing only annotated text should have “quotes” around it and if the user added text it should be after the selected text, after – such as this. As you can see above, there is an empty line between each entry, just as we have in Author when showing results of keyword search. :

____________________________________

“This is selected text in the document”

“This is selected text in the document. This quote is quite a bit longer though with more words so we can see what that looks like. Another sentence is here”

“This is also a bit of selected text but is has no writing from the user after it”
____________________________________
iCloud

We need to have a Liquid | Reader iCloud directory in order to synch with the future iOS version and between different macOS devices. Considering our problems with iCloud for Author, will this be a big issue?

Other Interactions

•  ESC to go in and out of full screen
•  Pinch and two fingers to resize the document, same as in the Preview application, until the document fits the screen, then a further pinch shows the Annotations, as described above
Future Versions (must be architecturally possible)

 

Please give me costing estimates for each feature:

Opening Document

•  Ask user to select the name of the document (which will be in the document) on Saving, in order to have the the right reference to the document for citations for later. On doing this, show a list of hits on academic searches for the heading and when the user clicks then flip to the reverse of the document, as in Author, where all the citation information information is filled in, for them to verify and maybe add a Comment.

Annotating Text

•  To add notes to the annotation, the user should simply start typing after selecting the text and a dialog appears, centre of screen, with your typed text, as fast as the system can produce it. Whatever character was typed first will be copied in to the dialog as well, so the experience is seamless. Same visual design box as the Notes dialog in Author.

Visual Style of Text Annotations, Non-Collapsed View

Text annotations can only be applied to highlighted text so it will only show in relation to highlights. We will need an icon a text box to display the text annotation in the normal view, most likely. Most likely we will add a symbol, such as ª^ after the selection.

Visual Style of Collapsed/Annotation View with Text Annotations

Use code and visual design from Author for this project for the annotation view (show PDF as-is, but use #fdde7e as the yellow for highlighting). The visual style of the text should be the same as default Author style (Read mode) and should have the same option in Preferences to change. The display of the collapsed view showing only annotated text should have “quotes” around it and if the user added text it should be after the selected text, after – such as:
____________________________________

“This is selected text in the document” – And this is the comment the user wrote.

“This is selected text in the document. This quote is quite a bit longer though with more words so we can see what that looks like. Another sentence is here” – And this is the comment the user wrote.

“This is also a bit of selected text but is has no writing from the user after it”
____________________________________

As you can see above, there is an empty line between each entry, just as we have in Author when showing results of keyword search.

Finding Annotated Text

• Cmd-f in Annotation view searches the annotations only. Cmd-f in regular view searches document and shows results in the same was as Author

Copying Text

Copying text and going into another application will include all the date for Citation, as done for Author from Liquid | Flow now. This means that the document must know what it is, so on opening the user might have to be asked to: “Select the title of this document” so that the system can look up the citation information from Mendely or other service.

Liquid | Flow Integration

•  Select text and use Liquid | Flow must work. Other PDF readers do not support Services so other applications cannot support Liquid | Flow.

•  Spacebar on selected text for text to speech.
Notes

Use Liquid | Author code and style as the basis for the project, copying as much basic functionality along as is feasible, at your discretion, you need to decide what makes most sense.
Questions

Do we need to have a new document format for this? If so, call it .lireader though I would greatly prefer to keep it as .pdf for compatibility with other apps.

If we keep it as PDF where do we save our extra data, the annotations?

How do you plan to expose the annotated text to Spotlight, but not the main body text?

Leave a Comment

This Week

This week saw the 10th anniversary celebrations of web science which a lot of incredible people attended.

https://www.icloud.com/sharedalbum/#B0255Z2WMp1eeT from the SONY RX100 V gone through Snapped on the iPad.

Thursday was a wonderful morning hosted by http://www.historyandpolicy.org which I blogged about.

Currently I am at the TimberYard in Soho while Emily is getting her nails done and we have YouTube citations working on Author, though there are some issues needing polishing. Check this: https://www.youtube.com/watch?v=ZUNkvSxRfRk

Leave a Comment