Bookends On Tap User Guide


Note: Bookends On Tap has been superseded by Bookends for iOS and is no longer being developed. This documentation is here for users who bought Bookends On Tap and have not bought Bookends for iOS.

A few terms…

Bookends On Tap creates a library on your iOS device that contains references (or reference metadata, meaning details about the works such as the author, place of publication, etc.) and, optionally, attachments such as pdfs.

References can be entered added to your library in three ways:
  • Manually.
  • Internet search and import.
  • Sync with Bookends on the Mac.

Each reference has a Type that identifies the kind of publication. The default Types are:
  • Artwork
  • Audiovisual material
  • Book
  • Book Chapter
  • Conference proceedings
  • Dissertation
  • Edited book
  • Editorial
  • In press
  • Journal article
  • Letter
  • Map
  • Newspaper article
  • Patent
  • Personal communication
  • Review
  • Internet
  • Unused (through Unused20)

Many of the fields in the Unused range will have other labels, depending on the Type, such as Edition, Translator, ISSN/ISBN, DOI, PMID, and others appropriate for particular Types.

The Types correspond to those in Bookends, and can be changed in Bookends On Tap only by syncing with Bookends. The factory default Type is Journal Article, but you can change this in Settings.

You can organize your references into
groups that you name and can quickly recall. Static groups contain references that you explicitly add. Smart groups contain references that meet criteria you specify (such as a word in the title, a keyword, a specific author, a date of publication, or all of the above), and the contents can change dynamically as references are added, deleted, or edited.

Each group must have a unique name.

Display of References


References are viewed in two ways: in a list or in abstract view. Note that for the iPad, if the orientation is horizontal you must tap the Library button at the top left to see the reference list. You can add additional fields to view in the abstract view in Settings.

List


all-group



A summary of the metadata for each reference is listed. A (tappable) small paper clip appears on the right if the reference has one or more attachments. If you sync your library with Bookends, labels (applied in Bookends) will appear as a vertical bar of color to the left of the reference.

Tap the Manage button to delete (no limit) or email (limited to 20 at a time) multiple selected references at once.

To see the abstract view, tap on the reference. To bypass the abstract display and see the attachment on the right, tap on the paper clip (if available).

Tap in the search field to find specific references in the list. You can limit searches to Title, Abstract, Author, or All (All means Bookends On Tap will search all of these fields). Searches are case-insensitive. If your library is very large, searches can take seconds, which makes the live search unwieldy. To disable live search, start the search text with a space. The search will not being until you tap the Search button. For example, search for

“ einstein”

(without the quote marks).

Author searches distinguish between first names and surname by the presence or absence of a comma: “E Jones” or “Jones, E”. Note that if you search for the initial of the first name, all authors with first names beginning with that letter will be found.

Abstract


iPhone/iPod touch

4

iPad

1



At the bottom of the abstract you may see tappable links to the reference on-line (e.g. a PMID or DOI).



Quick view/edit pane, with notecards and pdf thumbnails (iPad only)


This pane lets you quickly access ratings, thumbnails of attached pdfs, and notes (notecards, shown in a note stream).

ipad-abstract-notes-320


Note
: Slide the “gripper” separator control to the left or right to enlarge or diminish the quick view pane, respectively.

Tap on the rating bullets/stars to add/edit the rating.

Notecards are shown in yellow, and sync with Bookends notecards. To delete or reorder a notecard in the note stream, double tap on it with two fingers.

Tap on the pdf thumbnail to show the enlarged (normal) view of the pdf.

If you tap on the attachment icon (the paper clip), you will be able to annotate the pdf, show the table of contents, and search for text in the pdf. Here is an example of the options you have when annotating: highlight, strikethrough, underline, add text, comment, draw):

ipad-annotations-500


attachment annotatons


Annotations made in Bookends On Tap will be shown in Bookends if “Use WebKit to display pdfs” is checked (in Bookends).


Library Toolbar


Regardless of which device you are using, there will be a toolbar that lets you work with the reference.

toolbar-buttons-description

Tap the Abstract icon to see this abstract view.

If the reference has a link to the article on the Web, tap this icon to open the browser view and access the Internet content (tap the Abstract icon to return to that view in Bookends On Tap). If you have access privileges, navigate to the pdf of the article (if available) and the paper clip icon (Download PDF) will become enabled. Note: neither the pdf nor the reference metadata will be imported to your library unless you tap the Import icon. Tap the Import icon to import the reference (and pdf, if you downloaded it) into your personal library. You can import to a specific group by tapping and
holding the Import button. A list of static groups will appear, and you can choose the one to which the new reference will be added.

Tap Attachments to see the contents of attached files (typically pdfs). The image is disabled if the reference has no attachments. The pdf will open in full screen.
Organize Groups lets you add or remove the reference from you static groups (including Trash). You cannot remove a reference from the group All (except by moving it to the Trash).

Tap the Share button to send the reference to one of several destinations.

reference share option

Tap Mail to send the reference to yourself or others. Note that the emailed text can be formatted for readability (formatted display) or tagged for importing into reference management applications like Bookends or EndNote (modified RIS)—configure this in Bookends On Tap Settings. If you have downloaded the pdf, you’ll have the option of sending that as well.
You can send a tweet containing the title of the paper, prefixed with the text you entered in the Bookends On Tap Settings under Other (see section on Settings below).

social section twitter and facebook


The Share button will also appear above a pdf you’re reading in Bookends On Tap.

attachment-oprn-in

With it you can export pdfs to other apps for reading or markup, then import them back into Bookends On Tap. When you tap on the Share icon on the right above the pdf you will be given the opportunity to email the pdf, open it in another app that handles pdfs, or print it.


If you send the pdf back to Bookends, you will be asked if you want to attach the named pdf and be offered the best matching reference. Usually, that will be a reference with a pdf of the same name. However, the pdf may have been renamed by the annotation software, or it could be a pdf that had never been in a Bookends On Tap library. You will be offered these choices:

find-reference-to-attach-320


If Bookends On Tap has identified the correct reference, click OK to replace the older pdf with the newer one. If the annotation app changed the name of the pdf, you can rename it to the original and Bookends On Tap will replace the old with the new. You can also attach the pdf to another reference or a new reference. Here is a short walkthrough using iAnnotate as an
example.

You can import RIS files (containing reference information) exported from any other app (e.g. Safari, Mail, etc.). Here’s an example of an RIS file being exported from Safari:

ris-export-from-safari


and imported into Bookends On Tap:

ris-import



Tap the edit icon to allow manual editing of the reference’s contents. This is covered in the section Adding References and Groups Manually.


Adding References and Groups Manually


This is the top portion home screen (items will change when groups are added)

library-view

To add items on the iOS device, use the + button. You can also add items by syncing with Bookends (see below).

The + Button


Tap this button to manually add references or groups to your Bookends On Tap library.

on the plus button

Reference


new reference


You can assign a rating of 1-5 stars, set the reference Type, and add information to the fields that constitute a reference. Note that name fields (e.g. Authors) ask you to enter each name one at a time. To ensure that the names sort correctly, they must be entered surname first, separated with a comma:

Hutchinson, RJ
Edgars, Susan Wright
Simons, MM, Jr.

If you sync with Bookends, you may find that institutional names end in a comma:

The American Council on Diet, Health, and Fitness,

This ensures that Bookends will not try to parse the name when it creates a bibliography.

You can manage attachments, typically pdfs, here. Tap on the name of an attachment and you’ll see an option to Rename or Delete it from your library.

attachment rename


Static Group


You will be prompted for the name of a static group. Adding and removing references from static groups is discussed below.

You can edit the name of the static group by pressing the name for 1 second.


Smart Group

new smart group


Once you have entered a name for the new smart group, you must enter the criteria that Bookends On Tap will use to search for members of the group. Fill in the search options (field name, conditional operator, and the text). The conditional operators are

contains
does not contain
is
is not
starts with
ends with

Here is an example entry:

new smart group example


You can edit the name of the smart group and change search criteria by pressing the name for 1 second.

Removing references from the library


You can delete references from the list in two ways:

Swipe to the left and press the Delete button.

delete reference


Tap Manage, select the references you want to delete, and tap Delete.

delete a few references


Note that when you delete a reference it is not actually removed from the library, it is placed in the Trash. You can tap on the Trash icon at any time and rescue or permanently delete any references it contains.


Using Static Groups


There are two built-in static groups that you cannot alter: All and Trash.

Tap on All to see a list of all references in your library.

Tap on Trash to see any references you deleted. You can remove the reference from the Trash or permanently remove it from your library.

Any static groups that you have created (or imported from Bookends) will appear in this list.


Using Smart Groups


There are three built-in smart groups: Authors, Attachments, and Last Modified.

Tap on Authors to see a sorted list of each author found in the library. Tap on a name to see a list of all references authored by that person.

Tap Attachments to see a list of all references that have one or more attachments.

Any smart groups that you have created (or imported from Bookends) will appear in this list.
Note: The smart groups created in Bookends On Tap are not recognized by such in Bookends and vice versa. As a result, when smart groups are imported from Bookends they become static groups in Bookends On Tap. However, the group members may change when next synced with Bookends if the members have changed in Bookends. A small picture of the Bookends icon will be displayed next to smart groups imported from Bookends, as shown in this example:



Last Modified shows the last 25 references that have been added or edited. This includes references added or changed because of a sync with Bookends.

Sorting Group Contents


You can sort the contents of a group by clicking on the Group name, then Edit. At the top of the screen is the field the groups are sorted by (in the example, Date Added).

sorting group contents


You can change the sorted field by tapping on it:

sort by fields



The direction of the sort (ascending or descending) is shown next to the name of the field, and you can change from one to the other by tapping.

Online Search


You can search for references in PubMed, Google Scholar, JSTOR, Web of Science (requires ip authentication), arXiv, and the Library of Congress. All searches provide a simple search option

online search



and a Recent Searches option




PubMed Advanced Searches



Tap on Advanced Search to construct a boolean (and, or, not) search and restrict the results by date of publication, publication type, the availability of full text, etc.

advanced-search


The maximum number of results returned for each search is configurable in Settings (10, 20, 40 or 60). If there are more hits than that, you’ll see a message at the bottom of the found references like this



This is an example of a reference found on PubMed with an iPad

ipad-pubmed-searcg-results


The full reference view is displayed on the right. If you find a reference that you have already imported into your own library, it will be displayed in yellow.
Bookends On Tap will display a badge that tells you if the article on PubMed is linked to the full text (HTML or a pdf), and if the full text is available for viewing at no cost (Free Full Text). Note that this information is supplied by PubMed and in some cases is incorrect.

full text indicator


arXiv Searches

Use the fast typing bar to create advanced search queries that include boolean operators (AND, OR, NOT), specific arXiv searchable fields tags (ti, au, abs, co, etc.), and/or limit your searches by subject by choosing any from the list of available subjects by tapping on “cat:all”.

arxiv subjects

Use parentheses ‘( )’ to group boolean expressions and quote marks to search for an exact phrase.

Here is an example of advanced search for an article with the words atom and physics in the Title, and authored by Friedman:

arxiv advanced search


Note: it’s not necessary to add ‘AND’ between tags, the previous example returns the same result as: ti:atom physics AND au:Friedman

Sync References and Attachments With Bookends On The Mac



You can wirelessly sync the contents of your iOS Bookends On Tap libraries with a Bookends library on the Mac. The sync is bidirectional, meaning that changes made in either library will be communicated to the other, the dates of modification being used to determine the sending and receipt of references and attachments.

Bookends uses Bonjour technology to detect Bookends On Tap running on devices on the same local network.

Below are steps that you take to sync Bookends with Bookends On Tap.

1. In Bookends Preferences, iOS tab, “Look for Bookends On Tap/PubMed On Tap on iOS devices” should be checked.

2. Launch Bookends and open a library.

3. Launch Bookends On Tap on your remote device. You must be connected to the same local network as Bookends. If you are not there can be no communication between the two.

4. In the Bookends On Tap home screen on your iOS device you will see an option to Sync (in the section headed Bookends On Tap — you may have to scroll down to see it).

bot-sync-menu-location

5. When you tap on Sync for the first time you will be asked to add a (Bookends) library.

Screen Shot 2013-10-18 at 11.25.42 AM


When you tap Add Library, look at your Mac and you should see that Bookends is displaying the name of the iOS device at the bottom of the Groups pane (My iPad in this example).


If you do not see the Devices list in your Bookends library window at this point, it means that your iOS device and Mac are not on the same subnetwork. Please see the troubleshooting section for help.

6. A passcode screen will appear on the iOS device screen:

bot sync passcode



7. In Bookends, select the device in the Devices list (My iPad in the example) and a dialog will ask you to enter the passcode showing on your iOS device.



8. When you click Link, Bookends On Tap display will update:

bot sync connected library


Note: you can change the Bookends library you are connected to at any time by tapping the Change Library button. If you want Bookends to “forget” that the library was linked to a particular Bookends On Tap library, in Bookends go to File -> Synced iOS Device Info, select the device from the subsequent dialog, and delete it with the - button.

In Bookends you will see the confirm dialog, something like this:

syncdialog


Sync all references or just selected groups

If you have a very large Bookends library, you may want to limit the number of references transferred to the iOS device to just those you want to take with you. You can choose to select static and/or smart groups.



The contents of both group types will be transferred, but they are handled a bit differently on the iOS device. Static groups fully sync and changes to members of the group on your Mac or on the device will be bilaterally synced. Static groups will sync between Bookends On tap and Bookends even if you sync All references.
Smart groups are different, because the searches used to generate them differ between Bookends and Bookends On Tap. Therefore, when syncing a smart group, Bookends will send the contents to Bookends On Tap, but there will be no corresponding transfer of references from Bookends On Tap to Bookends. Smart groups transferred from Bookends to Bookends On Tap will be updated on the device if the members change in Bookends (i.e. if references are added or removed from the smart group). Smart groups will be transferred to Bookends On Tap only if you have selected “Selected groups” and have checked one or more smart groups. The more smart groups you check, the longer the sync will take.

Attachments
Check this checkbox if you want attachments (typically pdfs) synced between devices. To prevent the transfer of very large documents that may take a lot of time, you can limit the attachment size:

Pasted Graphic 2


• If a sync is interrupted, don’t worry. It will resume at that point the next time you sync.
• Only direct attachments will be synced. This means that if you have attached a folder to a reference Bookends, its contents will not be synced between Bookends and Bookends On Tap.


9. Tap Sync to begin the process. A dialog in both Bookends On Tap and Bookends will inform you of the progress, and there is a Cancel button if you want to stop.

Note: Bookends and Bookends On tap keep track of libraries by an internal unique identifier, not the library name. Therefore, if you change the name of the library (for example, after a Rebuild or Repair), do not perform a Change Library the next time you sync with Bookends On Tap, sync as you normally would. If you do a Change Library, references in Bookends On Tap and/or Bookends will be duplicated.


Settings



settings



Reference Options

Set the default reference Type for manually-created references or imported references whose Type cannot be determined.

If “Delete moves to Trash” is off, a deleted reference will be removed from the library immediately. If it is on, the reference will be moved to the Trash, from which it can be later recovered or permanently deleted.

You can add fields that are shown in the abstract view:

Pasted Graphic 1


Tap + to add a field. Tap - to remove a field. You cannot remove the default fields Source, Title, Authors, or Abstract.

Drag the three-bar icon on the right to change the order in which the addition fields are shown.

Search Engines


Searchable sites shows a list of all the search engines Bookends On Tap supports, and you can choose which ones you want shown (for example, if you work in the humanities, there may be no need to show PubMed). You can also reorder the list shown in Bookends On Tap by tapping the Edit button and dragging the three-bar icon on the right.

bot searchable sites


In the PubMed settings, indicate if Bookends On Tap should check for full text, and how the returned list of references should be sorted (by date of addition to PubMed or date of publication).
The number of references to retrieve with each pass (10, 20, 40, or 60).

Export Options


You can enter a default address for sending email. You can also tell Bookends On Tap to arrange the text in the email in a human readable form, or modified RIS (which can be imported into other reference management apps using their RIS filters).

University Library Proxy


Bookends On Tap supports the popular EZProxy web proxy server used by many university libraries. If yours is one of them, you can enter the URL of the proxy server (you may need to contact IT support to supply this). The URL is entered like this example:

http://ezp1.harvard.edu/login?%@

Bookends on Tap will replace the %@ with the URL of the web sites you use.

Local Library


If your library is very large, you may want to disable Live Search to avoid the delay that occurs whenever you enter a letter. If you disable Live Search, the search will only be performed when you press the Return key.
When Autosync is ON, syncs to without waiting for the confirm dialog in Bookends. If you have Autosync enabled and want to change options in confirm dialog (e.g. to sync particular groups rather than all references), turn Autosync OFF. After changing the settings in the Bookends confirm dialog and syncing, you can enable it again in Bookends On Tap.
Empty LIbrary will remove all references, groups, and attachments from your library. This should be used with caution and cannot be undone.

Other


The Twitter setting lets you tell Bookends what text should be used to prefix a tweet (e.g. “Interesting article”, “Look at this”, etc.). Note that these characters count towards the 140 limit.

Troubleshooting



The iOS device does not appear in Bookends when you first sync with a Bookends library (Add Library).

If you do not see the Devices list in your Bookends library window at this point, it means that your iOS device and Mac are not on the same network. If for some reason you cannot have both running on the same subnetwork, you can create a computer-to-computer network on your Mac:

1. Click on the Airport icon at the top of the Mac screen.
2. Select "Create Network" and give it any name.
3. Connect your iOS device to this network. Go to Settings > Wi-Fi, select the network and enter the password you selected on the Mac.
4. Now try to Add Library again.

The iOS device can be connected to Bookends, but no files are transferred on Sync.

This may occur if you use a firewall on your Mac. You can circumvent this problem by adding Bookends to the list of apps allowed to make an incoming connection, or turning off the firewall, in System Preferences.

unknown