Bibliobar

Costruire LIBX

Page history last edited by SalvatoreVassallo 2 yrs ago

Interfaccia grafica per creare la propria versione di Libx
Compilare l'estensione
File necessari
Costruire il file config.xml
Costruire il file defaultprefs.xml
Patch Proposte
Appendice I: libxconfig.dtd
Appendice II: config.xml della biblio-bar
Appendice III: defaultprefs.xml tratto da biblio-bar

Per costruire una propria versione di Libx è possibile creare i file di configurazione manualmente e poi compilare l'estensione o è possibile utilizzare l'interfaccia grafica elaborata dal progetto Libx.

Il vantaggio di compilarsi l'estensione da sé è quello di poter modificare il codice e il comportamento della barra (si vedano ad esempio le patch proposte ).

Ovviamente si potrebbero anche modificare i file a estensione finita (decomprimento l'estensione e rimpacchettandola una volta modificata), ma è sicuramente poco comodo in quanto le modifiche dovrebbero essere riapplicate a ogni estensione diversa e a ogni versione (anche di test) si intenda fare.

Interfaccia grafica per creare la propria versione di Libx

L'interfaccia grafica è disponibile all'indirizzo http://libx.org:8080/editionbuilder/src/zul/

Per lavorare con l'interfaccia grafica per la configurazione di LIBX è consigliabile registrarsi per poter modificare l'estensione (o terminare la configurazione) in futuro. Ciò è possibile da "my edition".

Inserendo una propria mail e una password, premendo su "Log on" si entrerà nel sistema se l'utente è già esistente, altrimenti ci verrà chiesto se vogliamo registrarci

Se invece l'utente è esistente ci verrà presentato l'elenco delle estensioni create con la possibilità di:

cambiare il proprietario o aggiungere persone che possono operare sull'estensione
cancellare il permesso di modificare l'estensione a un utente
segnalare che l'estensione è creata dalla biblioteca/ente (utile per scopi statistici di LIBX)
rendere pubblica l'estension
modificarla

Ogni fase è ben documentata e illustrata dai tooltip disseminati (i punti interrogativi).

Qualora si necessitasse di un supporto italiano oltre a quello fornito in inglese si può far riferimento alla guida per la creazione del file xml tentendo conto che:

la scheda 'Description' è l'equivalente dell'elemento name
la scheda 'Shortcut' è l'equivalente dell'elemento links
la scheda 'Catalogs & Databases' è l'equivalente dell'elemento catalogs
la scheda 'OpenUrl Resolvers' è l'equivalente dell'elemento openurl
la scheda 'Proxy Access' è l'equivalente dell'elemento proxy
la scheda 'Options' è l'equivalente dell'elemento options e di searchoptions
la scheda 'File Management' è l'equivalente dell'elemento additionalfiles

Top

Compilare l'estensione

Oltre alla creazione di una versione di LIBX tramite l'editor grafico, è possibile creare una propria versione in due modi:

spedire i file necessari (config.xml e immagini) e i file opzionali all'indirizzo, salvatore.vassallo@chela.it, specificando se si necessita di una versione basata su libx originale o con incluse le patch proposte
compilarsi manualmente la propria estensione:

In quest'ultimo caso bisogna operare con il CVS (ovvero la versione attuale, in via di sviluppo) di libx.

In un sistema *nix è sufficiente installare un client CVS, perl, e la libreria libxml. Perl di solito è già installato in quasi tutte le distribuzioni gnu/linux, per cui, ad esempio, su Ubuntu dovrebbe bastare

sudo apt-get install cvs libxml-perl

E poi scaricare tutti i file sorgente:

cvs -d :pserver:guest@mozdev.org:/cvs login

cvs -z3 -d :pserver:guest@mozdev.org:/cvs co libx

La password richiesta è guest.

Una volta scaricati i file basta spostarsi nella directory libx/src/editions, creare una nuova directory con un nome a piacere e copiare all'interno i file necessari per creare l'estensione. A questo punto per compilare l'estensione è sufficiente digitare da riga di comando:

./xcreateextension.pl nomecartella

L'estensione verrà creata all'interno di nomecartella (dove si erano inseriti i file necessari).

In alternativa ai file scaricati da CVS è possibile utilizzare quelli che includono le patch proposte.

Su un sistema windows è possibile usare wincvs per gestire e ottenere i file da cvs, activeperl per installare perl (attenzione sarà comunque necessario installare la libreria per il parser xml e bisognerà utilizzare cygwin per emulare il comportamento di una shell *nix, avendo comunque problemi).

Top

File necessari

Per costruire una propria versione di LIBX gli unici file strettamente necessario sono il config.xml (leggi le istruzioni per costruirlo, vedi la DTD, vedi l'esempio tratto da biblio-bar) e due immagini (una con dimensioni non limitata, inclusa nell'about, e una di dimensioni 16x16 che sarà usata come simbolo di collegamento con la biblioteca ovunque sia necessario, ad esempio in amazon, barnes and noble etc.).

File aggiuntivi possono essere il file di configurazione del menù contestuale, defaultprefs.xml (leggi le istruzioni per costruirlo, vedi l'esempio tratto dalla biblio-bar) e un'immagine ulteriore da utilizzare nei casi in cui interviene il link resolver (se non viene fornita questa immagine ulteriore LIBX userà l'icona 16x16 generale).

Top

Costruire il file config.xml

L'elemento radice <edition> ha due attributi (id, version) obbligatori, l'id è un codice alfanumerico a scelta, il numero di versione si riferisce alla barra (non a LIBX) anche se per convenzione nel caso di biblio-bar si è scelto di usare lo stesso di LIBX.

<?xml version="1.0"?> <!DOCTYPE edition SYSTEM "http://libx.org/xml/libxconfig.dtd"> <edition id="bic" version="1.1.4">

L'elemento <edition> contiene gli elementi:

name (obbligatorio, contiene l'intestazione)
links (obbligatorio, contiene l'elenco dei link mostrati nel primo pulsante della barra)
catalogs (obbligatorio, contiene l'elenco dei cataloghi e le regole su come interrogarli)
openurl (obbligatorio, contiene informazioni sul link resolver)
proxy (obbligatorio, contiene informazioni sul proxy)
options (obbligatorio, contiene informazioni sulle icone e sulle opzioni abilitate)
searchoptions (opzionale, contiene opzioni di ricerca aggiuntive)
additionalfiles (opzionale, contiene l'elenco dei file da aggiungere all'estensione)

Top

Intestazione <name>

L'elemento vuoto <name> contiene informazioni sull'estensione espresse tramite gli attributi:

short (obbligatorio, forma abbreviata del nome dell'estensione viene mostrata come pulsante nella batta, vedi fig.26)
long (obbligatorio, nome esteso dell'estensione, verrà visualizzato nell'elenco delle estensione di firefox, fig.27)
edition (obbligatorio, informazioni sull'edizione, viene mostrata nella finestra informazioni su, fig.28)
description (obbligatorio, la descrizione visualizzata nell'elenco delle estensioni di firefox, fig.27)
adabtedby (opzionale, chi ha adattato l'estensione, visualizzati nella finestra informazioni su, fig.28)

fig. 26: LIBX - link inseriti nell'elemento <links>

fig. 27: LIBX - elenco estensioni il nome attributo long dell'elemento <name> e la descrizione nell'attributo description

fig. 28: LIBX - crediti

I link <links>

L'elemento <links> contiene tutti i link utile che si vogliono mostrare come menù a tendina del primo pulsante (vedi fig. 26). Ogni link è racchiuso in un elemento <url> che avrà due attributi obbligatori: label (l'etichetta mostrata a video) e href (l'indirizzo del link in questione).

Qualora non s'intenda inserire nessun link bisogna comunque inserire l'elemento links (obbligatorio) vuoto:

Nel caso di bilbio-bar:

<links>

</links>

Top

I cataloghi <catalogs>

L'elemento <catalogs> è un elemento centrale e di estrema importanza, in questo elemento infatti possono essere inseriti (in qualunque ordine e in qualunque numero) i cataloghi che la barra LIBX potrà interrogare. In particolare sono supportati: Millennium, Dynix Horizon/IPAC, Ex Libris's Aleph, Sirsi, Voyager, Web2 system, SFX, Serials Solutions, Central Search's Metasearch, open url resolver, Google Scholar e inoltre ricerche generiche da personalizzare. Questi cataloghi si concretizzano negli elementi (elencati secondo lo stesso ordine precedente): <millenium> <horizon> <aleph> <sirsi> <voyager> <web2> <sfx> <sersol> <centralsearch> <scholar> <bookmarklet>

Top

I campi di ricerca

Ogni catalogo può (in realtà deve, per migliorare la compatibilità con Internet Explrer) avere diversi campi di ricerca (personalizzabili). Questi sono espressi sottoforma di codice, nello specifico:

'i' per ISBN/ISSN (in alcuni casi indica solo ISBN laddove siano divisi)
'is' ISSN
'd' per i Soggetti
't' per il Titolo
'Y' per la ricerca per Keyword
'a' per l'Autore
'c' per il Call Number
'at' per il Titolo dell'articolo
'jt' per il Titolo della rivista
'doi' per il DOI
'pmid' per il PubMed Identifier

Top

XISBN <xisbn>

In tutti gli OPAC è possibile abilitare il supporto XISBN ciò può essere fatto semplicemente inserendo l'elemento <xisbn> (che è un elemento figlio del singolo catalogo). Ad esempio:

</horizon>

L'elemento <xisbn> supporta quattro attributi opzionali:

cues (settato su 'true' abilita la ricerca attraverso xISBN anche quando si fa clic su un cue. In questo caso non viene cercato il singolo ISBN a cui il cue è collegato, ma tutti gli ISBN, manifestazioni della stessa opera)
res_id, opacid, siteparm: parametri per indicare il tipo di opac usato e i vari parametri, per le istruzioni su come settare i diversi attributi cfr http://xisbn.worldcat.org/liblook/howtolink.htm e http://xisbn.worldcat.org/liblook/howtolinkbyopactype.htm

Top

Millenium <millenium>

Per dichiarare un catalogo millenium gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default si usa Y;t;a;d;i;c).

Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
urlregexp (l'url del catalogo segmentato come una regular expression, vedi esempio, attualmente è usato solo dall'edizione di libx prodotta dalla Virginia Tech University per usi interni)
searchscope (millenium supporta ricerca con “scope” moltipli, ad esempio “tutte le biblioteche” “biblioteche di giurisprudenza” etc. 1 equivale a tutte le biblioteche)
sort (da utilizzare per ottenre ordinamenti dei risultati diversi da quelli di default)
keywordcode (il codice per la ricerca per keyword, alcune installazione di millenium invece del codice di default utilizzano, ad esempio, “X”)
advancedcode (il codice per la ricerca avanzata, alcune installazione di millenium invece del codice di default utilizzano, ad esempio, “W”)
journaltitlecode (millenium supporta le ricerche per titolo di rivista: con l'attributo journaltitlecode si può indicare l'opportuno codice)
searchform

Esempio tratto dalla Virginia Tech University:

<millenium> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

Horizon <horizon>

Per dichiarare un catalogo horizon gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default si usa Y;t;a;d;i;c).

Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
urlregexp (l'url del catalogo segmentato come una regular expression, vedi esempio, attualmente è usato solo dall'edizione di libx prodotta dalla Virginia Tech University per usi interni)
issn, isbn, callno, author, title, journaltitle, keyword, subject (tutti questi attributi non obbligatori possono essere specificati nel caso in cui il codice di ricerca non sia quello di default)

Esempio tratto dalla University of Chicago Library:

L'elemento <horizon> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

Aleph <aleph>

A differenza degli altri cataloghi, nel caso di Aleph, è necessario specificare i codici di ricerca per quasi tutti i campi, nel dettaglio gli attributi obbligatori sono:

name (il nome che verrà visualizzato nella barra e nel menù contestuale)
url (l'indirizzo del catalogo)
bisogna specificare poi specificare i codici degli attributi localbase, title, author, isbn, issn, callno, keyword, findfunc, advfindfunc, scanfunc
options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default Y;t;a;d;i;c)
sono invece opzionale i codici da inserire per la ricerca per subject e journaltitle

Inoltre è possibile (opzionalmente) specificare:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
urlregexp (l'url del catalogo segmentato come una regular expression, vedi esempio, attualmente è usato solo dall'edizione della Virginia Tech University per usi interni)
scanindexlist (indica quali campi aleph deve cercare come “scorrimento” di default t; c)

Esempio tratto dalla biblio-bar

L'elemento <aleph> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

Sirsi <sirsi>

Per dichiarare un catalogo Sirsi gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default si usa Y;t;a;d;i;c). Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
urlregexp (l'url del catalogo segmentato come una regular expression, vedi esempio, attualmente è usato solo dall'edizione di libx prodotta dalla Virginia Tech University per usi interni)
searchscope (millenium supporta ricerca con “scope” moltipli (ad esempio “tutte le biblioteche” “biblioteche di giurisprudenza” etc. 1 equivale a tutte le biblioteche)
sort (da utilizzare per ottenere ordinamenti dei risultati diversi da quelli preimpostati, di default è impostato come “-PBYR”):
- -PBYR = ordinamento cronologico discendente
- PBYR = ordinamento cronologico ascendente
- relevance = utilizza un algoritmo per ordinare per rilevanza
- AU = ordinamento per autore
- SU = ordinamento per soggetto
- TI = ordinamento per titolo
path (path di installazione di Sirsi1 di default /uhtbin/cgisirsi/x/0/0/5/)

Esempio tratto dalla Montana State University Bozeman

L'elemento <sirsi> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

Voyager <voyager>

Per dichiarare un catalogo Voyager gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default si usa Y;t;a;d;i;c). Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
keyword (il codice per la ricerca per keyword, se non indicato si assume il valore di default “FT”)
count (numero di risultati restituiti, se non indicato si assume il valore di default 25)
urlregexp (l'url del catalogo segmentato come una regular expression, vedi esempio, attualmente è usato solo dall'edizione di libx prodotta dalla Virginia Tech University per usi interni)
relevanceranking (se settato su true, valore di default, utilizza l'ordinamento per rilevanza)
advancedsearchforissn (attiva la ricerca avanzata per codice ISSN, valori possibili TRUE/FALSE)

Esempio tratto dalla University of Illinois

L'elemento <voyager> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

Web2 System <web2>

Per dichiarare un catalogo web2 system gli attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default si usa Y;t;a;d;i;c), server (il server a cui connettersi), setting_key (la chiave di autenticazione). Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)
searchscope (millenium supporta ricerca con “scope” moltipli (ad esempio “tutte le biblioteche” “biblioteche di giurisprudenza” etc. 1 equivale a tutte le biblioteche)
path (path di installazione di default /web2/tramp2.exe/do_keyword_search/log_in?guest=guest&)

L'elemento <web2> può inoltre includere l'elemento xisbn (vedi le indicazioni su questo elemento).

Top

SFX <sfx>

Per permettere la ricerca su SFX gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default jt;i). Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)

N.B. è anche possibile impostare una ricerca su SFX come generico bookmarklet (si veda esempio). Ciò permette di controllare diverse opzioni e di usare, ad esempio la lista A-Z in alternativa al Citation Linker come strumento di ricerca.

Esempio tratto dalla Harvard University Library

Top

SerSol <sersol>

Per permettere la ricerca su SerSol gli unici attributi obbligatori sono name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (l'indirizzo del catalogo) e options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, di default jt;i). Se non si aggiunge altre si useranno le impostazione di default altrimenti si possono aggiungere gli attributi opzionali:

sid (un codice riconosciuto dal proprio OPAC, può essere utilizzato per riconoscere le richieste inviate tramite libx, utile per statistiche etc)

Esempio tratto dalla Portland State Library

Top

CentralSearch <centralsearch>

Per permettere una ricerca con CentralSearch sono necessari:

name (il nome che verrà visualizzato nella barra e nel menù contestuale)
url (l'indirizzo del catalogo)

options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice, le opzioni sembrano essere: d,a,t,is,i,Y)
searchby (come effettuare la ricerca: le opzioni sono category e database, se non si inserisce l'attributo il valore di default è "database")
sslibhash (un codice alfanumerico identificativo)

Opzionalmente possono essere specificati gli attributi:

se searchby è impostato come Category

catids (le categorie da interrogare)
catgroupids (i gruppi di categorie da interrogare)

se searchby è impostato come Database

dbilist (lista dei database da interrogare)

Esempio tratto dalla University of Texas at Brownsville

Top

Google Scholar <scholar>

Google Scholar è già presente nella barra, sia come magic button (si attiva trascinandoci sopra un testo selezionato), sia attraverso il menù contestuale (se si lasciano le impostazioni predefinite).

In aggiunta è possibile dichiarare google scholar all'interno dei cataloghi per aggiungerlo alla lista; per farlo basta indicare gli attributi obbligatori name (il nome che verrà visualizzato nella barra e nel menù contestuale), url (in questo caso http://scholar.google.com/) e options (Y). Google Scholar potrebbe essere definito anche come catalogo generico <bookmarklet>.

Top

Catologhi generici e altri strumenti di ricerca <bookmarklet>

Nella sezione <catalogs> è possibile dichiarare cataloghi generici (ad esempio Open Worldcat), motori di ricerca (google, yahoo) o qualunque strumento di ricerca interno a un sito (la funzione cerca di un blog, amazon etc.) con il tag <bookmarklet>.

Bookmarklet ha tre attributi, tutti obbligatori:

name (il nome che verrà visualizzato nella barra e nel menù contestuale)
url (l'indirizzo del catalogo)
options (i campi di ricerca selezionabili dalla barra di ricerca, sotto forma di codice; è possibile aggiungere campi di ricerca diversi da quelli codificati (nella sezione collegata), ad esempio io potrei usare il codice 'pippo' che però dovrà essere definito nella sezione <searchoptions>.

Bisogna fare particolare attenzione nell'indizare l'url, al suo interno infatti dovranno essere presenti tutte le possibili opzioni (nella forma %codiceopzione) poiché i dati vengono inviati attraverso il metodo GET.

Per chiarire questo punto un esempio tratto dalla University of Chigago

Nel caso di Biblio-bar, ad esempio si è scelto di dichiarare la ricerca in AZ come bookmarklet:

Top

OpenUrl Resolver <openurl>

L'elemento openurl contiene un qualunque numero di link resolver ciascuno dichiarato all'interno dell'elemento <resolver>.

Qualora la barra sia volta solo ai cataloghi e non abbia link resolver bisogn comunque dichiarare l'elemento vuoto <openurl />.

L'elemento <resolver><raw> deve essere dichiarato attraverso i seguenti attributi:

type (il tipo di openurl a scelta fra sersol, sfx, webbridge, generic. Se non viene dichiarata si userà l'opzione di default 'generic')
url (l'indirizzo a cui inviare le query) – obbligatorio
name (il nome da mostrare a video) - obbligatorio
sid (un codice riconosciuto può essere utilizzato per l'autenticazione o per riconoscere le richieste inviate tramite libx, utile per statistiche etc) – obbligatorio (è obbligatorio secondo la DTD, ma l'estensione sembra funzionare anche se non viene dichiarato)
xrefsid – opzionale
pmidsid – opzionale
version – opzionale (se non viene indicato si assume il valore 0.1, settata su 1.0 abilita, se presente, il supporto a OpenUrl 1.0)
autolinkissn – (scelte possibili true, false. Di default 'false'. Se attivato fa sì che le ricerche issn siano inoltrate all'openurl resolver, altrimenti vengono inoltrate al catalogo primario)
image (permette di indicare un'immagine, che dovrà essere indicata anche nella sezione <additionalfiles>, da utilizzare in presenza di COinS o qualunque link rimandi all'openurl. Nel caso in cui non si indichi un'immagine viene utilizzata quella di default 16x16 che va allegata tra i file necessari)

Esempio tratto dalla biblio-bar:

</openurl>

Top

Proxy <proxy>

Elemento <proxy> include due sottoelementi <ezproxy> e <wam> da utilizzare a seconda del proxy in uso.

Qualora non si disponesse di proxy (o se ne usasse uno differente dai due citati) va comunque dichiarato l'elemento vuoto <proxy />.

L'elemento <ezproxy> va dichiarato con gli attributi:

name (nome del proxy, verrà visualizzato nel menù contestuale)
url (indirizzo a cui inviare le richieste di autenticazione etc.)
urlcheckpassword (opzionale: se attivato l'url checking sul sito di Ezproxy si può indicare la password necessaria all'interno di questo attributo
disableifcheckfails (opzionale, se non lo si setta di default è “false”: disabilita il proxy se il controllo sull'URL fallisce)

Esempio tratto dalla Virginia Tech University

<proxy>

</proxy>

L'elemento <wam> invece ha solo due attributi entrambi obbligatori:

name (nome del proxy, verrà visualizzato nel menù contestuale)
url (indirizzo a cui inviare le richieste di autenticazione etc.)

Esempio tratto dalla Univerity La Verne:

<proxy>

</proxy>

Top

Le opzioni <options>

L'elemento <options> contiene un qualunque numero di <option> questi vanno dichiarati con la sintassi:

</options>

La tabelle seguente raccoglie tutti i possibili 'key' e i 'value

Key	Value
sersolisbnfix	false o true, SerSol attualmente non supporta openurl che si riferiscano a libri e che contengano un codice isbn, se questa opzione è settata su true libx, in questi casi, include un link che rimanda al catalogo cercando per codice isbn
icon	il percorso dell'icona 16x16 generalmente sarà chrome://libx/skin/nomeicona ad esempio chrome://libx/skin/smalllogo.ico
logo	il percorso del logo chrome://libx/skin/nomelogo es: chrome://libx/skin/largelogo.png
rewritescholarpage	se settata su true riscrive gli openurl in google scholar reindirizzandoli al proprio link resolver
supportcoins	settato su true attiva il supporto a coins
autolink	settato su true attiva la funzione di autolink (isbn, issn, pubmedid, doi sono convertiti in link verso il catalogo e il proprio openurl). L'opzione è in ogni caso attivabile e disattivabile dall'utente.
autolinkstyle	setta lo stile (es sottolineato, blue) dei link generati dalla funzione di autolink. Non sono documentati i possibili valori.
disablescholar	settato su true disabilità il 2magic button"
scholarmissurl	non documentato
sendorigdatawithopenurl	non documentato
suppressscholardisplay	non documentato

Esempio tratto dalla biblio-bar:

</options>

Top

Opzioni di ricerca <searchoptions>

In questa sezione vanno indicate tutte le etichette da applicare ai codici di ricerca. In teoria in questa sezione si potrebbe sovrascrivere le etichette dei codice predefiniti, ad esempio dichiarando 'a' come 'Autore' anziché 'Author'. Nel caso di biblio-bar si è scelta una via diversa provvedendo alla creazione di un'estensione multilingua (vedi la patch proposta) e in questa sezione ci si è limitati a dichiarare i codici di ricerca non predefiniti (generalmente quelli inclusi nei vari boorkmarklet).

L'elemento <searchoptions> contiene un qualunque numero di <searchoption>. Questi vanno dichiarati attraverso gli attributi value (il codice) e label (l'etichetta da mostrare a video), entrambi obbligatori.

Esempi:

</searchoptions>

Top

File da includere <additionalfiles>

In questa sezione vanno dichiarati tutti i file da inserire nell'estensioni (immagini, file di configurazione etc) e dove andarli ad inserire.

L'elemento <additionalfiles> contiene un qualunque numero di elementi che vanno dichiarati usando gli attributi name (nome del file) e directory (la directory dove iserire il file).

Esempi tratti dalla biblio-bar:

</additionalfiles>

I file di configurazione devono essere inclusi in chrome/libx/content/libx mentre le icone in chrome/libx/skin/libx. Nell'esempio sono stati forniti i quattro file necessari e, in aggiunta l'icona sfx (che sarà stata inclusa negli attributi al momento di dichiarare l'openurl (cfr. attributo image dell'elemento resolver).

Top

Costruire il file defaultprefs.xml

Allo stato attuale non esiste una DTD per defaultprefs.xml.

Se si prova a compilare l'estensione senza inserirne uno, ne verrà creato uno con opzioni di default.

Sostanzialmente il file defualtprefs.xml si compone di 6 sezioni:

isbn: se e dove effettuare la riscerca isbn e se prevedere l'opzione xisbn (qualora questa sia inclusa nel catalogo dichiarato). Es (nota che name è proprio il nome dato al catalogo, openurl, bookmarklet etc. dichiarato con attributo name):
<isbn>

<catalog name="Catalogo Bicocca" type="i"/>

<catalog name="Catalogo Bicocca" type="xisbn"/>

</isbn>
issn: se e dove effettuare la riscerca issn
<issn>

<catalog name="Catalogo Bicocca" type="i"/>

<catalog name="Riviste Elettroniche" type="i"/>

</issn>

Qui, ad esempio, è stata modificata l'opzione di default che prevedeva che le ricerche issn fossero fatte con il catalogo primario e con l'openurl dichiarato. In questo caso si è sostituito all'openurl (sarebbe stato “Cerca la citazione” ovvero ) un bookmarklet dichiarato (nel caso specifico la lista AZ).
doi: dove e se effettuare la ricerca per doi
<doi>

<openurl name="Cerca la citazione" type="doi"/>

</doi>
pmid: dove e se effetuare la ricerca per PubMedID

<pmid>

<openurl name="Cerca la citazione" type="pmid"/>

</pmid>
general: tutte le altre ricerche avviabili dal menù contestuale. Normalmente si tratta di Keyword, Titolo e Autore nel catalogo primario e la ricerca in google scholar, ma se ne possono aggiungere altre o cambiare, ad esempio nella bibliobar:
<general>

    <catalog name="Catalogo Bicocca" type="Y"/>

    <catalog name="Catalogo Bicocca" type="t"/>

    <catalog name="Catalogo Bicocca" type="a"/>

    <catalog name="Riviste Elettroniche" type="jt"/>

    <catalog name="LINX" type="Y"/>

    <scholar/>

</general>

Si è aggiunta la possibilità di lanciare ricerche nella lista AZ come titolo della rivista e in LINX come parola chiave.
proxy: l'ultima sezione è dedicata al proxy. Qui non si danno indicazioni sulla configurazione (questo aspetto è trattato dall'elemento <proxy> di config.xml). Semplicemente, in questo caso, se presente sarà mostrato nel menù contestuale.

Top

Patch Proposte

Nel corso dell'adattamente di libx alla biblioteca di ateneo dell'università Bicocca si è ritenuto necessario cambiare alcuni file sorgente per modificare il comportamento della barra o aumentarne le funzionalità.

Qualora si intenda compilare manualmente l'estensione è possibile utilizzare queste patch invece dei file scaricati da libx.mozdev.org.

Top

Traduzione

Nel caso di LIBX i termini che appaiono a video sono 'hardcoded', ciò significa che il testo è incluso nel codice (e non è inserito come entità come spesso si fa per le estensioni).

Una possibile via per localizzare l'estensione era quella di tradurre brutalmente i termini lasciandoli inseriti nel codice. Ciò però avrebbe comportato l'avere l'estensione tradotta anche nel caso di un ipotetico utente con il browser inglese. Si è scelto quindi di portare fuori dal codice i termini e in seguito tradurli in modo di avere come risultato un'estensione multilingua (al momento inglese/italiano). Inoltre, con questa patch, è stato leggermente modificato l'aspetto della barra per permettere una visualizzazione migliore dei campi di ricerca.

Scarica i file.

Top

CUE aggiuntivi

IBS (Internetbookshop.it)

E' stato aggiunto il supporto a ibs tra i vari siti in cui LIBX inserisce un collegamento all'opac relativo alla pubblicazione visualizzata.

Il codice da inserire in libxdfu.js è:

// -----------------------------------------------------------------------------

// Link internetbookshop.it pages to catalog via ISBN

new DoForURL(/\.internetbookshop\.it.*(\d{12}[\d|X])/i, function (doc, match) {

var isbn = isISBN(match[1]); // grab captured isbn in matched URL

var origTitle = libxEnv.xpath.findSingle(doc, "//td[@class='lbarrasup']");

if (!origTitle) {

return;

}

// make link and insert after title

var link = makeLink(doc, libxEnv.getProperty("isbnsearch.label", [libraryCatalog.name, isbn]), libraryCatalog.linkByISBN(isbn));

origTitle.appendChild(link);

origTitle.insertBefore(doc.createTextNode(" "), link);

});

Top

anobii.com

Supporto a anobii.com

// -----------------------------------------------------------------------------

// Link anobili.com pages to catalog via ISBN

new DoForURL(/\.anobii\.com\//, function (doc, match) {

// extract ISBN from text <strong>ISBN-10:</strong>

var isbnLabel = libxEnv.xpath.findSingle(doc, "//strong[contains(text(), 'ISBN')]");

var isbn = isISBN(isbnLabel.nextSibling.textContent);

var origTitle = libxEnv.xpath.findSingle(doc, "//li[@class='title']");

if (!origTitle) {

return;

}

// make link and insert after title

var link = makeLink(doc,

libxEnv.getProperty("isbnsearch.label", [libraryCatalog.name, isbn]),

libraryCatalog.linkByISBN(isbn));

origTitle.appendChild(link);

origTitle.parentNode.insertBefore(doc.createTextNode(" "), link);

});

Top

google books

Il 'cue' per google books è stato cambiato rispetto all'originale

new DoForURL(/google\.[a-z]+\/books/, function (doc) {

var isbnLinks = libxEnv.xpath.findNodes(doc, "//a[@class='f1' and contains(@href,'editions:ISBN')]");

for (var i = 0; i < isbnLinks.length; i++) {

var isbnLink = isbnLinks[i];

var href = isbnLink.getAttribute('href');

var isbn, isbnMatch = href.match(/editions:ISBN(\d{9,12}[\d|X])/i);

if (isbnMatch != null && (isbn = isISBN(isbnMatch[1])) != null) {

var cue = makeLink(doc, libxEnv.getProperty("isbnsearch.label", [libraryCatalog.name, isbn]), libraryCatalog.linkByISBN(isbn));

isbnLink.parentNode.insertBefore(cue, isbnLink.nextSibling);

isbnLink.parentNode.insertBefore(doc.createTextNode(" "), cue);

}

});

Top

Modifiche al comportamento del parser del DOI e del PubMed_ID

Il parser del DOI e del PubMed può incontrare problemi se alla fine del doi (o del pubmed) è presente un carattere speciale.

Questo viene incluso dall'autolink, cercando, in questomodo un DOI errato.

Alcuni esempi:

http://www.pubmedcentral.nih.gov/tocrender.fcgi?iid=131064 (l'autolink punta al DOI 10.1038/sj.emboj.7601103. anziché 10.1038/sj.emboj.7601103)

http://www.anthrosource.net/doi/abs/10.1525/ae.1986.13.1.02a00030 (l'autolink punta al DOI 110.1525/ae.1986.13.1.02a00030) anziché 10.1525/ae.1986.13.1.02a00030 senza parentesi)

http://www.journals.cambridge.org/action/displayIssue?jid=ANM&volumeId=1&issueId=03 (l'autolink punta al DOI 10.1017/S1751731107661849, anziché 10.1017/S1751731107661849 senza virgola)

Questi problemi sono stati da me risolti con una funzione di esclusione dell'ultimo carattere se corrisponde a uno dei caratteri elencati in una variabile.

Inoltre ho invertito l'ordine dei parser (prima DOI e pubmed_ID dopo ISBN e ISSN) per evitare che il DOI 10.1007/0-387-30742-7_20 venga letto come ISBN 0387307427

Top

Appendice I: libxconfig.dtd

<!ELEMENT name EMPTY>

<!ATTLIST name

short CDATA #REQUIRED

long CDATA #REQUIRED

edition CDATA #REQUIRED

description CDATA #REQUIRED

adaptedby CDATA #IMPLIED

<!ELEMENT links (url*) >

<!ELEMENT url EMPTY>

<!ATTLIST url

label CDATA #REQUIRED

href CDATA #IMPLIED

<!ELEMENT openurlresolver EMPTY>

<!ATTLIST openurlresolver

name CDATA #REQUIRED

resolvernum CDATA #REQUIRED

options CDATA #REQUIRED

<!ELEMENT scholar EMPTY>

<!ATTLIST scholar

name CDATA #REQUIRED

url CDATA #REQUIRED

options CDATA #REQUIRED

<!ELEMENT centralsearch EMPTY>

<!ATTLIST centralsearch

name CDATA #REQUIRED

url CDATA #REQUIRED

options CDATA #REQUIRED

searchby (Database|Category) 'Database'

sslibhash CDATA #REQUIRED

dbidlist CDATA #IMPLIED

catids CDATA #IMPLIED

catgroupids CDATA #IMPLIED

<!ELEMENT bookmarklet (xisbn)?>

<!ATTLIST bookmarklet

name CDATA #REQUIRED

url CDATA #REQUIRED

options CDATA #REQUIRED

<!ELEMENT millenium (xisbn)?>

<!ATTLIST millenium

name CDATA #REQUIRED

url CDATA #REQUIRED

sid CDATA #IMPLIED

urlregexp CDATA #IMPLIED

options CDATA #REQUIRED

searchscope CDATA #IMPLIED

sort CDATA #IMPLIED

keywordcode CDATA #IMPLIED

advancedcode CDATA #IMPLIED

journaltitlecode CDATA #IMPLIED

searchform CDATA #IMPLIED

<!ELEMENT aleph (xisbn)?>

<!ATTLIST aleph

name CDATA #REQUIRED

url CDATA #REQUIRED

sid CDATA #IMPLIED

options CDATA #REQUIRED

localbase CDATA #REQUIRED

title CDATA #REQUIRED

author CDATA #REQUIRED

isbn CDATA #REQUIRED

issn CDATA #REQUIRED

callno CDATA #REQUIRED

keyword CDATA #REQUIRED

findfunc CDATA #REQUIRED

advfindfunc CDATA #REQUIRED

scanfunc CDATA #REQUIRED

scanindexlist CDATA #IMPLIED

subject CDATA #IMPLIED

journaltitle CDATA #IMPLIED

<!ELEMENT sfx EMPTY>

<!ATTLIST sfx

name CDATA #REQUIRED

url CDATA #REQUIRED

sid CDATA #IMPLIED

options CDATA #REQUIRED

<!ELEMENT sersol EMPTY>

<!ATTLIST sersol

name CDATA #REQUIRED

url CDATA #REQUIRED

sid CDATA #IMPLIED

options CDATA #REQUIRED

<!ELEMENT sirsi (xisbn)?>

<!ATTLIST sirsi

name CDATA #REQUIRED

url CDATA #REQUIRED

searchscope CDATA #IMPLIED

sort CDATA #IMPLIED

options CDATA #REQUIRED

path CDATA #IMPLIED

<!ELEMENT web2 (xisbn)?>

<!ATTLIST web2

name CDATA #REQUIRED

url CDATA #REQUIRED

options CDATA #REQUIRED

servers CDATA #REQUIRED

setting_key CDATA #REQUIRED

searchscope CDATA #IMPLIED

sort CDATA #IMPLIED

path CDATA #IMPLIED

<!ELEMENT voyager (xisbn)?>

<!ATTLIST voyager

name CDATA #REQUIRED

url CDATA #REQUIRED

keyword CDATA #IMPLIED

count CDATA #IMPLIED

options CDATA #REQUIRED

advancedsearchforissn CDATA #IMPLIED

relevanceranking (true|false) 'true'

<!ELEMENT horizon (xisbn)?>

<!ATTLIST horizon

name CDATA #REQUIRED

url CDATA #REQUIRED

options CDATA #REQUIRED

issn CDATA #IMPLIED

isbn CDATA #IMPLIED

callno CDATA #IMPLIED

author CDATA #IMPLIED

title CDATA #IMPLIED

journaltitle CDATA #IMPLIED

keyword CDATA #IMPLIED

subject CDATA #IMPLIED

profile CDATA #IMPLIED

<!--

See http://xisbn.worldcat.org/liblook/howtolink.htm and

opacid and siteparam is for

http://xisbn.worldcat.org/liblook/howtolinkbyopactype.htm

-->

<!ELEMENT xisbn EMPTY>

<!ATTLIST xisbn

cues (true|false) 'false'

res_id CDATA #IMPLIED

opacid CDATA #IMPLIED

siteparam CDATA #IMPLIED

<!ELEMENT openurl (resolver)* >

<!ELEMENT resolver EMPTY>

<!ATTLIST resolver

type (sersol|sfx|webbridge|generic) 'generic'

url CDATA #REQUIRED

name CDATA #REQUIRED

sid CDATA #REQUIRED

xrefsid CDATA #IMPLIED

pmidsid CDATA #IMPLIED

version (1.0|0.1) '0.1'

autolinkissn (true|false) 'false'

image CDATA #IMPLIED

<!ELEMENT proxy (ezproxy|wam)* >

<!ELEMENT ezproxy EMPTY>

<!ATTLIST ezproxy

url CDATA #REQUIRED

name CDATA #REQUIRED

urlcheckpassword CDATA #IMPLIED

disableifcheckfails (true|false) 'false'

<!ELEMENT wam EMPTY>

<!ATTLIST wam

url CDATA #REQUIRED

name CDATA #REQUIRED

<!ELEMENT options (option)*>

<!ELEMENT option EMPTY>

<!ATTLIST option

key

(sersolisbnfix

|icon|logo

|rewritescholarpage

|supportcoins

|scholarmissurl

|sendorigdatawithopenurl

|disablescholar

|suppressscholardisplay

|autolink

|autolinkstyle

)

#REQUIRED

value CDATA #REQUIRED

<!ELEMENT searchoptions (searchoption)*>

<!ELEMENT searchoption EMPTY>

<!ATTLIST searchoption

value CDATA #REQUIRED

label CDATA #REQUIRED

<!ELEMENT additionalfiles (file)*>

<!ELEMENT file EMPTY>

<!ATTLIST file

name CDATA #REQUIRED

directory CDATA #REQUIRED

substitutevars (true|false) 'false'

Top

Appendice II: config.xml della biblio-bar

<?xml version="1.0"?>

<!DOCTYPE edition SYSTEM "http://libx.org/xml/libxconfig.dtd">

<links>

</links>

</aleph>

</catalogs>

</openurl>

</searchoptions>

</options>

</additionalfiles>

</edition>

Top

Appendice III: defaultprefs.xml tratto da biblio-bar

<?xml version="1.0"?>

<isbn>

</isbn>

<issn>

</issn>

<doi>

</doi>

<pmid>

</pmid>

</general>

<proxy>

</proxy>

</contextmenu>

</preferences>

Top

Comments (0)

You don't have permission to comment on this page.

Anonymous Create an account or Log in

Bibliobar

Costruire LIBX

Interfaccia grafica per creare la propria versione di Libx

Compilare l'estensione

File necessari

Costruire il file config.xml

Intestazione <name>

I link <links>

I cataloghi <catalogs>

I campi di ricerca

XISBN <xisbn>

Millenium <millenium>

Horizon <horizon>

Aleph <aleph>

Sirsi <sirsi>

Voyager <voyager>

Web2 System <web2>

SFX <sfx>

SerSol <sersol>

CentralSearch <centralsearch>

Google Scholar <scholar>

Catologhi generici e altri strumenti di ricerca <bookmarklet>

OpenUrl Resolver <openurl>

Proxy <proxy>

Le opzioni <options>

Opzioni di ricerca <searchoptions>

File da includere <additionalfiles>

Costruire il file defaultprefs.xml

Patch Proposte

Traduzione

CUE aggiuntivi

IBS (Internetbookshop.it)

anobii.com

google books

Modifiche al comportamento del parser del DOI e del PubMed_ID

Appendice I: libxconfig.dtd

Appendice II: config.xml della biblio-bar

Appendice III: defaultprefs.xml tratto da biblio-bar

Costruire LIBX

Page Tools

Insert links

Comments (0)

Join this workspace

Navigator

SideBar

Recent Activity