Table of Contents
Crea un file di configurazione config.xml
<edition>
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, si veda anche le convenzioni sui numeri di versione).
Esempio da bibliobar:
<?xml version="1.0"?> <!DOCTYPE edition SYSTEM "http://libx.org/xml/libxconfig.dtd"> <edition id="bic" version="1.2.2.1">
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)
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 barra, vedi fig.26)
- long (obbligatorio, nome esteso dell'estensione, verrà visualizzato nell'elenco delle estensione di firefox, fig.1)
- edition (obbligatorio, informazioni sull'edizione, viene mostrata nella finestra informazioni su, fig.2)
- description (obbligatorio, la descrizione visualizzata nell'elenco delle estensioni di firefox, fig.1)
- localhomepage (opzionale, home dell'estensione)
- adabtedby (opzionale, chi ha adattato l'estensione, visualizzati nella finestra informazioni su, fig.2)
- infoUpdate (opzionale, solo LibXITA indica l'indirizzo da visualizzare nel caso l'estensione sia aggiornata)
- updateurl (opzionale, solo LibXITA indica l'indirizzo in cui è cariato il file update.rdf)
Esempio dalla bibliobar:
<name short="Biblio-bar" long="LibX Biblioteca di Ateneo" edition="Edizione della Biblioteca Bicocca" description="Barra degli strumenti per la Biblioteca di Ateneo" adaptedby="Bonaria Biancu, Salvatore Vassallo" localhomepage="http://www.biblio.unimib.it/libx.html" />
fig.1: LIBX - elenco estensioni il nome attributo long dell'elemento <name> e la descrizione nell'attributo description
fig.2: LIBX - crediti
I link <links>
L'elemento <links> contiene tutti i link utili che si vogliono mostrare come menù a tendina del primo pulsante (vedi fig.3). 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: <links />
fig.3: LIBX - link utili
Nel caso di bilbio-bar:
<links> <url label="Biblioteca di Ateneo" href="http://www.biblio.unimib.it/"/> <url label="Orario, accesso, recapiti" href="http://www.biblio.unimib.it/go/Home/Home/Orario-accesso-recapiti"/> <url label="Servizi agli utenti" href="http://www.biblio.unimib.it/go/Home/Home/Servizi-agli-utenti"/> <url label="E-book" href="http://sfx.cilea.it:9003/sfxbic3/e_collection_bicocca/e-books-bicocca-A.html"/> </links>
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>
I campi di ricerca
Ogni catalogo può (in realtà deve, per migliorare la compatibilità con Internet Explorer) 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
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:
<aleph name="Catalogo Bicocca" sid="ALEPH:libx" url="http://opac.biblio.unimib.it" localbase="bin01" title="WTI" author="WAU" keyword="WRD" issn="ISSN" isbn="ISBN" callno="SYS" findfunc="find-b" scanfunc="scan" advfindfunc="find-d" scanindexlist="" urlregexp="opac\.biblio\.vt\.edu" options="t;a;Y;i;c"> <xisbn opacid="melvyl3" /> </aleph>
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.
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 name="Addison" url="http://addison.vt.edu" options="Y;t;jt;a;d;i;c" urlregexp="addison.vt.edu" sid="libxvt" searchscope="1" />
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:
<horizon name="University of Chicago Library" url="http://libcat.uchicago.edu" options="Y;t;jt;a;d;i;c" urlregexp="libcat.uchicago.edu" sid="libxuchicago" isbn="ISBN" issn="ISSN" author=".AO" keyword=".GK" subject=".SU" title=".TO" journaltitle=".JK" />
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 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
<aleph name="Catalogo Bicocca" sid="ALEPH:libx" url="http://opac.biblio.unimib.it" localbase="bin01" title="WTI" author="WAU" keyword="WRD" issn="ISSN" isbn="ISBN" callno="SYS" findfunc="find-b" scanfunc="scan" advfindfunc="find-d" scanindexlist="" urlregexp="opac\.biblio\.vt\.edu" options="t;a;Y;i;c"> <xisbn opacid="melvyl3" /> </aleph>
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
<sirsi name="MSU Libraries Catalog" url="http://isbn.lib.montana.edu" options="Y;t;a;i" searchscope="BOZEMAN" sort="-PBYR"/>
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
<voyager name="PrairieCat" url="http://i-share.carli.illinois.edu/uis/" options=”Y;t;a;d;i;c” sid="libxuis" advancedsearchforissn="true" />
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&)
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
<sfx name="Citation Linker" url="http://sfx.hul.harvard.edu/sfx_local" options="jt;i;pmid;doi"/>
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</font>
<sersol name="Electronic Journals List" url="http://wq5rp2ll8a.search.serialssolutions.com" options=”jt;i”/>
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:
<centralsearch name=”Central Search” url=”http://pathfinder.utb.edu:2048/login?url=http://gs3ef3fd7n.cs.serialssolutions.com” options=”t;a;Y;d;is;i” ssLibHash=”GS3EF3FD7N” searchby=”Category” catids=”11731;11732;11733;11734;11735;11736;11737;11738;11739;11740;11741;11742;11743;11744;11745;” />
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 <bookmarklet>.
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
<bookmarklet name="OpenWorldCat" url="http://www.worldcat.org/search?qt=worldcat_org&q=%searchterms&submit=Search" options="searchterms"/>
Nel caso di Bibliobar, ad esempio si è scelto di dichiarare la ricerca in AZ come bookmarklet:
<bookmarklet name="Riviste Elettroniche" sid="sfxit.com:libx" url="http://sfx.cilea.it:9003/sfxbic3/azlist/bicocca?current_view=detail&service=&perform=locate&type=&letter_group=&pattern=%jt&textSearchType=contains&jumpToPage=1&show_link=1&issn=%i&vendor=&category=&subcategory=" options="jt;i"/>
=== 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> 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:
<resolver type="sfx" url="http://sfx.cilea.it:9003/sfxbic3" sid="sfxit.com:libx" name="Cerca la citazione" image="chrome://libx/skin/sfx.gif" version="1.0"/>
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> <ezproxy url="http://ezproxy.lib.vt.edu:8080/login?url=%S" name="EZProxy" urlcheckpassword="Af81Ixt3sT" disableifcheckfails=”true”/> </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> <wam url="garfield.ulv.edu" name="WAM Proxy"/> </proxy>
Le opzioni <options>
L'elemento <options> contiene un qualunque numero di <option> questi vanno dichiarati con la sintassi:
<options> <option key="nomeopzione" value="valoreopzione"/> </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, blu) dei link generati dalla funzione di autolink. Va dichiarato come un normale CSS |
| autolinkstylefound | setta lo stile (es sottolineato, blu) del bordo dei link e delle immagini, nel caso la risorsa sia disponibile in catalogo. Va dichiarato come un normale CSS [solo LibXITA] |
| regexajax | Le regular expression usate per verificare se una risorsa è disponibile nei cataloghi o meno, vanno dichiarate come un array. Prestare particolarmente attenzione a scegliere regexp univoche e controllare se necessario inserirne diverse a seconda della lingua. |
| disablescholar | settato su true disabilità il "magic button" |
| scholarmissurl | non documentato |
| sendorigdatawithopenurl | non documentato |
| suppressscholardisplay | non documentato |
Esempio tratto dalla biblio-bar:
<options> <option key="rewritescholarpage" value="true"/> <option key="supportcoins" value="true"/> <option key="autolink" value="true"/> <option key="icon" value="chrome://libx/skin/smalllogo.ico"/> <option key="logo" value="chrome://libx/skin/largelogo.gif"/> </options>
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 bibliobar e LibXITA si è scelta una via diversa provvedendo alla creazione di un'estensione multilingua 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> <searchoption value="issn" label="ISSN"/> <searchoption value="a" label="Autore"/> </searchoptions>
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 <file> che vanno dichiarati usando gli attributi name (nome del file) e directory (la directory dove iserire il file).
Esempi tratti dalla biblio-bar:
<additionalfiles> <file name="config.xml" directory="chrome/libx/content/libx"/ <file name="defaultprefs.xml" directory="chrome/libx/content/libx"/> <file name="smalllogo.ico" directory="chrome/libx/skin/libx"/> <file name="largelogo.gif" directory="chrome/libx/skin/libx"/> <file name="sfx.gif" directory="chrome/libx/skin/libx"/> </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 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).
Esempio config.xml
Tratto da Bibliobar:
<?xml version="1.0"?>
<!DOCTYPE edition SYSTEM "http://libx.org/xml/libxconfig.dtd">
<edition id="bic" version="1.2.2.1">
<name short="Biblio-bar" long="LibX Biblioteca di Ateneo" edition="Edizione della Biblioteca Bicocca" description="Barra degli strumenti per la Biblioteca di Ateneo" adaptedby="Bonaria Biancu, Salvatore Vassallo" localhomepage="http://lib.harvard.edu/tools/libx.html" infoUpdate="http://www.chela.it/libxita/change.html"/>
<links>
<url label="Biblioteca di Ateneo" href="http://www.biblio.unimib.it/"/>
<url label="Orario, accesso, recapiti" href="http://www.biblio.unimib.it/go/Home/Home/Orario-accesso-recapiti"/>
<url label="Servizi agli utenti" href="http://www.biblio.unimib.it/go/Home/Home/Servizi-agli-utenti"/>
<url label="E-book" href="http://sfx.cilea.it:9003/sfxbic3/e_collection_bicocca/e-books-bicocca-A.html"/>
</links>
<catalogs>
<aleph name="Catalogo Bicocca" sid="ALEPH:libx" url="http://opac.biblio.unimib.it" localbase="bin01" title="WTI" author="WAU" keyword="WRD" issn="ISSN" isbn="ISBN" callno="SYS" findfunc="find-b" scanfunc="scan" advfindfunc="find-d" scanindexlist="" urlregexp="opac\.biblio\.vt\.edu" options="t;a;Y;i;c">
<xisbn opacid="melvyl3" />
</aleph>
<bookmarklet name="Riviste Elettroniche" sid="sfxit.com:libx" url="http://sfx.cilea.it:9003/sfxbic3/azlist/bicocca?current_view=detail&service=&perform=locate&type=&letter_group=&pattern=%jt&textSearchType=contains&jumpToPage=1&show_link=1&issn=%i&vendor=&category=&subcategory=" options="jt;i"/>
<bookmarklet name="LINX" url="http://scout-unimib.cilea.it/links/SPT--QuickSearch.php?ss=%Y" options="Y"/>
</catalogs>
<openurl>
<resolver type="sfx" url="http://sfx.cilea.it:9003/sfxbic3" sid="sfxit.com:libx" name="Cerca la citazione" version="1.0" image="chrome://libx/skin/sfx.gif" dontshowintoolbar="false" />
</openurl>
<options>
<option key="rewritescholarpage" value="true"/>
<option key="supportcoins" value="true"/>
<option key="autolink" value="true"/>
<option key="autolinkstylefound" value="2px solid red" />
<option key="icon" value="chrome://libx/skin/smalllogo.ico"/>
<option key="logo" value="chrome://libx/skin/largelogo.gif"/>
</options>
<searchoptions/>
<additionalfiles>
<file name="config.xml" directory="chrome/libx/content/libx"/>
<file name="defaultprefs.xml" directory="chrome/libx/content/libx"/>
<file name="sfx.gif" directory="chrome/libx/skin/libx"/>
<file name="smalllogo.ico" directory="chrome/libx/skin/libx"/>
<file name="largelogo.gif" directory="chrome/libx/skin/libx"/>
</additionalfiles>
</edition>
Attachments
- Schermata-link.png (16.0 kB) - added by shaitan on 03/13/08 10:44:53.
- Schermata-Componentiaggiuntivi.png (26.1 kB) - added by shaitan on 03/13/08 10:45:11.
- Schermata-LibXPreferences-5.png (39.5 kB) - added by shaitan on 03/13/08 10:45:42.


