Tinderbox Forum

Reference import - 'translator' RIS field

As noted in this thread

[Starting new thread to avoid topic drift]

If you want more data out of Bookends references, then make sure the translator data (RIS field?) is in the Bookends-generated RIS.

$ReferenceRIS holds all the RIS data Tinderbox receives. If the needed RIS code is not there, you first need to amend the Bookends RIS export format (see the Format Manager, ask any questions on that in the Bookends support forum). Note that Tinderbox cannot use what’s not in the RIS it receives.

Otherwise, if the code & data value is there in $ReferenceRIS, make an attribute (e.g. $ReferenceTranslator or $Translator), add that to the ‘Reference’ prototype Displayed Attributes and then write some action code to parse the translator name value from $ReferenceRIS to your user attribute.

But,

1 Like

@Bernard-0 has posted a nice AppleScript-based solution—easier than the method here. But i’ll leave this in case it helps Bookends users or those trying RIS export from some other reference manager.

RIS field codes aren’t listed in the Bookends docs (just checked) but helpfully they are on Wikipedia here.

It would appear that RIS doesn’t have a nominated field for the translator (i.e. the person who translated the original work). But in Bookends’s Format Manager, Bookends’ ‘Translator’ field is code ‘u3’

This is Bookends’ RIS export format templates for a Journal:

`TY  - JOUR`
$AU  - $a 
$T1  - $t 
$KW  - $k 
$PY  - $d 
$JA  - $j 
$SP  - $p- 
$VL  - $v 
$IS  - $i
$SN  - $u6 
$AB  - $b 
$N1  - $n 
$UR  - $z 
$U1  - $u1
`ER  - `¬

Note the $ symbols and back-ticks are Bookends format specific code.
RIS has undefined fields U1 through U5 noting that UI is already in use. By adding a line $U2 - $u3, Bookends drags should include Translator data (if that reference has such information). Thus, note the new ocde in the last but one line:

`TY  - JOUR`
$AU  - $a 
$T1  - $t 
$KW  - $k 
$PY  - $d 
$JA  - $j 
$SP  - $p- 
$VL  - $v 
$IS  - $i
$SN  - $u6 
$AB  - $b 
$N1  - $n 
$UR  - $z 
$U1  - $u1
$U2  - $u3
`ER  - `¬

Field order doesn’t matter, but the RIS first line must start with TY and the last line with ER. Also, there must be exactly two spaces between a lines opening code and the hyphen, i.e. U2+[two spaces]+hyphen+[space]+etc.

If you undertake this customisation in Bookends, there are four ‘types’ within the format (Journal, Book, etc.) so you should edit all four.

Once data is in Tinderbox, parse the $ReferenceRIS attribute date in the reference’s note for the ‘U2’ field data.

1 Like

In exploring the above, I think I found some Bookends code where the RIS template had only one space between codes and the hyphen (I’ve reported it), but watch out for that if editing your own Bookends formats.

Having reported this, Jon (Bookends’s wonderful developer) reminds me my UI line is likely a user (me) edit that’s been forgotten. No doubt for some Tinderbox user forum help request long forgotten. The as installed Bookends RIS export is correct in terms of format.

Aside, who’d have guessed that two spaces are needed before the hyphen. It actually takes some googling to find a decent description of the format (the Wikipedia page to which I linked doesn’t go that deep). also, if rolling your own, the format must use Windows-OS-style carriage-return+line-feed line endings to be valid RIS.

FWIW, I use BibTeX format. Plain text and better supported (as in offered by publishers) than RIS; at least in my area of work , Web Science (i.e. mainly CompSci+SocSci).