Share to Pangur from other apps

The share sheet sends what you are looking at in another app into one of your Pangur projects. In Photos, Files, Safari, Mail or any app with a Share button, tap Share and choose Pangur. A sheet opens over the other app, shows what Pangur has made of the content, and saves it to the project and collection you choose. You need Pangur for iPhone and iPad installed and signed in on the same device.

What you can shareCopy Anchor Link

The share sheet takes up to 50 items at once. It accepts web pages and links (from Safari, for example); PDFs, EPUBs, Word, OpenDocument, RTF, Markdown, HTML and plain-text documents; spreadsheets and data files in CSV, TSV, JSON and XML; photographs and other images; and audio and video recordings.

Sharing a document or recordingCopy Anchor Link

1. In the other app, tap Share, then Pangur. The sheet tells you it is reading what you shared.
2. For each file, Pangur looks for the work it belongs to, using an identifier such as a DOI or ISBN found in the file. When it finds one it shows the work's details and asks you to check that it is the right one.
3. If the details are wrong, or none were found, choose Add its details. You can type a DOI, ISBN, arXiv ID, link or title and choose Look up, or edit the details by hand. Every file needs a title before it can be saved.
4. Choose the project and, if you like, a collection; choosing Library means no collection.
5. Tap Save.

Saving carries on after you close the sheet, and the sheet says so. When it has finished it reports that it saved to the project, and if some files could not be added it names them.

Sharing a web pageCopy Anchor Link

When you share a page from Safari, Pangur reads the page in Safari to find the work it describes and to decide what to keep as the work's reading copy, then shows the details for you to check. A line below the details says what will be kept:

If the work is already in the project, the sheet tells you so. Pangur fetches a file of up to 20 MB through the page itself, with whatever access you have in Safari; for a larger file it passes the address to Pangur's server to fetch instead.

Sharing photographsCopy Anchor Link

When everything you share is photographs, the sheet is headed Photographs and asks what to make of them. Make a PDF, the default, builds one PDF with a page for each photograph in the order shared. The app reads the first photographs for an ISBN or a title to find the reference the PDF belongs to, so check the reference it suggests, or choose another, before saving. Add to a manuscript instead files the photographs on a manuscript in your catalogue, as images of its folios.

Adding photographs to a manuscriptCopy Anchor Link

1. Choose Add to a manuscript, then Choose a manuscript. Search by repository or shelfmark, or choose New manuscript.
2. Choose which copy the photographs join: an existing copy of the manuscript, or A new copy.
3. Choose the placement: Add at the end, Insert before a folio, or Fill existing folios starting from a folio you choose.
4. Check the folios. Each photograph starts a new folio unless you turn off Starts a new folio, which makes it another photograph of the folio above. You can give each folio a Folio label. Removing a photograph here leaves it in Photos.
5. Tap Save.

A manuscript needs a repository and a shelfmark before photographs can be filed under it, and the collection choice does not apply to photographs added to a manuscript. Copies, folios and capture inside the app itself are explained in Photograph a manuscript.

Sharing while offlineCopy Anchor Link

If the device is offline when you share, the sheet says "You're offline" and keeps what you shared on the device. The Pangur app sends it the next time it is open and online. Photographs added to a manuscript are the exception: they cannot be kept for later and need a connection at the moment you share them.

How the share sheet signs inCopy Anchor Link

The share sheet does not sign in by itself. The Pangur app gives it a limited credential of its own, a share key, which can read your projects, look up works and add items, but cannot move, relabel or delete anything. A share key lasts 60 days and is removed when you sign out of the app.

If you have not signed in to the app, the sheet asks you to open Pangur on this device, sign in, and then share again. If the share key has expired, it asks you to open Pangur once to renew the sign-in. If the app is too old for the sheet, it tells you to update the app.