Pangur docsExhibition blocks
This reference describes every kind of block an exhibition section can hold, with its fields, its limits and the moment at which its content is fixed for the public page.
A block is one typed piece of content in a section of an exhibition. This page lists the fourteen kinds in the order the canvas offers them, with the fields each one takes and its limits. Pangur's server checks every block against these rules however it is made, whether in the web workspace, in the iPhone and iPad app, by Generate or by an assistant, and refuses a block with a field it does not know.
Editing blocks
Text, heading and quotation blocks are edited in place on the canvas and save themselves. The other kinds open an inspector beside the canvas, or over it in a narrower window.
A selected block has a toolbar with Move up, Move down, Convert to… and Remove. Convert to… turns text, heading and quotation blocks into one another and is not offered for other kinds. Remove asks you to confirm, and removing a block cannot be undone.
When a block's content is fixed
The public page shows a snapshot made when you publish and never reads your library. Different blocks take their content from the library at different moments:
| Block | Content is taken |
|---|---|
| Document panel | When you attach the document. Update from document takes a new copy. |
| Table, chart, and map from a dataset | When you save the block after running its query. |
| Sources | When you publish. |
| Images, gallery, audio, video | The files are copied into Pangur's publishing store when you publish. |
| Everything else | Typed into the block; published as it stands. |
In every case a change reaches the public page only after you publish again.
Text, headings and quotations
| Block | Fields and limits |
|---|---|
| Text | Markdown text, required. |
| Heading | The heading text, required, and its level: Section heading or Sub-heading. |
| Quote | The quotation, an attribution, and optionally the library item it comes from. |
Images and media
Images, galleries, audio and video use files stored on items in your library. In the inspector, Find the work it belongs to chooses the item, and then you choose one of its files; if the item has no suitable file the inspector tells you. In an organisation project, choosing a file needs the editor or owner role. A block can only use files that you have added to Publish, or in an organisation project that the project has added, and Pangur refuses a file that is not one of yours.
| Block | Fields and limits |
|---|---|
| Image | One image, with Alt text (what the image shows, for screen readers), a caption and a credit. Open full size on click lets visitors open the full image in a new tab. Choose a different image replaces it. |
| Gallery | Several images, each with alt text and a caption, added with Add an image, laid out as Grid or Strip. |
| Audio | A recording, with a title and caption. Use the transcript copies the item's transcript into the block; Pull the transcript again refreshes it and Remove the transcript takes it out. If the recording has no transcript, the inspector says "No transcript yet. Transcribe it in the library first." Play from (m:ss) and Stop at (m:ss) play a clip, in minutes and seconds such as 12:03. |
| Video | A video, with an optional poster image, title, caption, WebVTT captions file and transcript, and an optional clip. With a timed transcript, the public page shows captions and the transcript. Parts of the transcript that describe what is on screen are marked "On screen" and left out of the captions. |
A published image can be at most 25 MB, and an audio or video file at most 500 MB. Media files count towards your plan's storage, and the media published from one account can take up at most 2,048 MB in all (the other limits are in Plans, limits and usage). Media blocks also depend on a media store on the server, and on a deployment without one, adding media fails with "Media publishing is not set up on this server."
Document panel
A Document panel shows one of your research outputs or drafts on the page. Choose it with Choose a document… and Attach. The panel keeps a copy of the document's text taken at that moment, so after revising the document you choose Update from document to take a new copy.
Manuscript leaf
A Manuscript leaf shows one page of a digitised manuscript or book from a IIIF manifest, with deep zoom on the public page.
| Field | Meaning |
|---|---|
| IIIF manifest URL (https) | The manifest's address. It must start with https:. |
| Leaf (canvas number, from 0) | Which canvas in the manifest to show; the first is 0. |
| Label | The leaf's name, such as "f. 12r". |
| Caption | Text below the leaf. |
| Credit | Usually the repository and shelfmark. |
| Region | Optionally, the part of the leaf to show first, as x, y, width and height. |
On the canvas the leaf is a still image, and the deep zoom appears only on the published page. There, visitors pan by dragging or with the arrow keys, zoom with + and −, and return to the whole leaf with Fit. To find a manifest for a work in your library, see Link a digitised facsimile.
Chronology
A Chronology is a list of dated events, with an optional title. It takes 1 to 40 events, typed one a line as a date and the event. A date can be up to 40 characters and is kept exactly as written, so "c. 1540" or "Michaelmas 1612" are both valid. The event's label and its detail can each be up to 400 characters, and an event can name the library item and page it comes from.
Map
A Map shows places as points, with an optional title, and can join points into routes. You can type the places or take them from a dataset.
A typed map takes up to 30 places, one a line as name, latitude and longitude. A map from a dataset takes up to 500 places; you choose the Latitude column, the Longitude column, The column that names each place, and optionally a date column, and rows without coordinates are skipped and counted.
Latitude must be between −90 and 90 and longitude between −180 and 180. Each point can carry a date, a detail and the library item it refers to. A route is a list of at least two of the map's points, and a map can have up to 30 routes. Where Pangur supplies coordinates they come from Wikidata, and you can correct them in the block.
Tables and charts from a dataset
A dataset here is a spreadsheet or table file stored on a work in your library, which Pangur has read into rows. Table from a dataset, Chart and a map from a dataset all take their rows the same way:
- Use Find the work the dataset belongs to to choose the work.
- Choose the Sheet.
- Write a Query (one SELECT; the sheet is the table data), which is an SQL
SELECTstatement over the sheet. - Choose Run the query, then save the block.
Pangur copies the rows into the block when you save it, recording the dataset's name and the date. To refresh them, open the block, run the query again and save. If the dataset is still being read, the inspector asks you to try again in a minute.
| Block | Fields and limits |
|---|---|
| Table from a dataset | A title, a caption, 1 to 30 columns and up to 500 rows; each cell up to 400 characters. The table looks the same on the canvas and on the public page. |
| Chart | A bar, line or scatter chart, with one column for the horizontal axis and one to four columns for the vertical axis (exactly one for a scatter chart), from 1 to 500 rows. Both axes must name columns of the rows. |
Sources
A Sources block is a formatted list of works from your library, with an optional title. Citation style is one of Chicago (notes and bibliography), which is the default, MHRA, Chicago (author–date), Harvard (Cite Them Right), MLA and APA, and Item keys (comma separated, from this library) names the works.
Pangur takes the works' bibliographic data from the library when you publish, and the visitor's browser formats them in the chosen style. A work whose project has since been removed is left out, and if the list cannot be formatted at all the page says so in its place.
Settings that only Generate sets
An exhibition's colour scheme and type, a block's width (text width, wide or full width) and custom styling are set by Generate and by composing from Ask, and the web workspace has no controls for them. Custom styling is limited to safe rules scoped to the exhibition, and Pangur drops colour schemes with too little contrast.
Make an exhibition
An exhibition is a public web page built from your research. This page explains how its draft, sections, blocks and published snapshot relate, and then walks through building and publishing a first one.
Publish, protect and take down an exhibition
Publishing makes an exhibition's draft its public page. This page covers publishing for anyone or behind a password, changing the address or your handle, taking a page down, deleting it, and the limits that apply.