2.5.2 “DPR:” permalinks

Someone brought it to my attention that the chrome:// links weren’t working in webpages. I think it’s a security measure to stop remote websites from accessing extension files – at any rate, I can’t figure out how to make them work outside of the DPR sandbox. But, never fear, there’s another way that actually makes permalinks look friendlier anyway. Here’s the format:

dpr:type[?params]

Here’s the help file entry:

Permalinks:

A permalink is a special URL that, when entered in the Firefox address bar or clicked from a hyperlink (provided the DPR is installed), goes directly to the place it refers to, showing the results of a search, if specified. The structure for DPR permalinks is currently: dpr:type[?params], where “type” is either one of “index” (for tipitaka sections), “search” (for tipitaka searches) or “dict” (for dictionary lookups), each of which has associated parameters which should be added after the “?”, or else any htm file in the chrome://digitalpalireader/content/ directory, in which case there will be no parameters (or “?”). The parameters refer to everything in the page’s url string after the “?”.

The “♦” button signifies a permalink, and is found in several places:

  • in the index for a given book,
  • in the main window toolbox,
  • to the left of each paragraph.
  • in the top-left corner of the search and dict windows.

Clicking on a “♦” button causes the link to be copied to the clipboard for further use. The “♦” button at the beginning or each paragraph adds the paragraph number to the link. Some example permalinks are:

An index permalink:

DN 1 Index
(dpr:index?loc=d.0.m)

A section permalink:

DN 1, paragraph 4, with “bhagavaa” and “bhikkhave” highlighted
(dpr:index?loc=d.0.0.0.0.0.0.m&para=4&query=bhagavaa+bhikkhave)

A search query permalink:

Search DN for “bhagavaa” and “bhikkhave”
(dpr:search?type=0&query=bhagavaa+bhikkhave&MAT=m&set=d&book=1&part=1&rx=false)

A dictionary lookup permalink:

Lookup words starting with “bhaga” in PED
(dpr:dict?type=PED&query=bhaga&opts=xv,xd,xm,xs,xa,xk,xy,mm,ma,mt,sw,hd)

A permalink to this help file:

Help
(dpr:help)

All of the hyperlinks above should work as expected if you have DPR version 2.5.2 or later installed.

This entry was posted in Uncategorized. Bookmark the permalink.

Leave a Reply