CitationLinker
- For information on the deep link that enables you to link to the SFX CitationLinker form and prepopulate the form with metadata, refer to the EL Commons Web site http://www.exlibrisgroup.org.
- For general information on the CitationLinker, refer to the SFX General User’s Guide.
Pointing to the CitationLinker
Changing the Look of the Existing CitationLinker
- Edit the .tmpl files on the SFX server as required.
The .tmpl files are available at:
/exlibris/sfx_ver/sfx4_1/<instance_name>/templates/citation
The .tmpl files include:
- Article.tmpl
- Book.tmpl
- head.tmpl
- Journal.tmpl
- tail.tmpl
- Create backups of the existing .gif files in:
/exlibris/sfx_ver/sfx4_1/<instance_name>/templates/img/citation
- mv ico_go.gif ico_go-bak.gif
- mv sfx.gif sfx-bak.gif
- mv title.gif title-bak.gif
- FTP any different .gif files that you want to use to:
/exlibris/sfx_ver/sfx4_1/cs_3/templates/img/citation
You need to use the names ico_go.gif, sfx.gif, and title.gif for your files.
Incorporating the CitationLinker in Existing Web Pages
- Copy the template files (Article.tmpl, Book.tmpl, Journal.tmpl, head.tmpl, and tail.tmpl) to your local Web server.
- Place the contents of head.tmpl and tail.tmpl on the top and bottom, respectively, of each of the other pages and change the extensions from .tmpl to .html. You may delete head.tmpl and tail.tmpl. Make changes to the HTML as required.
In each of the HTML files, you need to enter the hard-coded address of your SFX server, and possibly your library Web server, in the forms as described in the following steps.
- Edit the Javascript references.
This Javascript causes a smaller window, containing the SFX menu, to open after the user submits the form.
Change the following:
<script type="text/javascript" language="JavaScript" src="/<TMPL_VAR INSTANCE>/js/common/main.js"></script> <script type="text/javascript" language="JavaScript" src="/<TMPL_VAR INSTANCE>/js/common/date.js"></script> <script type="text/javascript" language="JavaScript" src="/<TMPL_VAR INSTANCE>/js/citation/main.js"></script> |
<script type="text/javascript" language="JavaScript" src="http://sfx.university.edu:9003/sfx_local/js/common/main.js"></script> <script type="text/javascript" language="JavaScript" src="http://sfx.university.edu:9003/sfx_local/js/common/date.js"></script> <script type="text/javascript" language="JavaScript" src="http://sfx.university.edu:9003/sfx_local/js/citation/main.js"></script> |
Change the image references to reference your images. The images included in the files as delivered provide the top header .gif file and the GO! submit button.
- Edit the form tag.
For each of the HTML files, the following tag should be changed to include the reference to the SFX citation-linker.cgi script.
Change the following:
<form name=OpenURL target="SFXmenu" onSubmit="OpenWindow('','SFXmenu');"> |
to:
<form name=OpenURL target="SFXmenu" action="http://server_address:port/instance-name/cgi/core/citation-linker.cgi" onSubmit="OpenWindow('','SFXmenu');"> |
For example:
<form name=OpenURL target="SFXmenu" action="http://sfx.university.edu:9003/sfx_local/cgi/core/citation-linker.cgi" onSubmit="OpenWindow('','SFXmenu');"> |
- Edit the form INPUT tag.
The following tag:
<input type=hidden name="__base_url" value="/<TMPL_VAR INSTANCE><TMPL_VAR __INST_URL_PART>"> |
should be changed to:
<input type=hidden name="__base_url" value="http://server_address:port/instance-name"> |
For example:
<input type=hidden name="__base_url" value="http://sfx.university.edu:9003/sfx_local"> |
- Edit all .html files (Article.html, Book.html, and Journal.html) to change the references to the location of the files on your server, or use relative links. Each .html file has links to the other two .html files.
For example, the Article.html file:
<tr> <td class="Block"> <strong>Article</strong> </td> <td> </td> <td class="GroupTitle"> <a class="ABC" href="?rft.genre=journal">Journal</a> </td> <td> </td> <td class="GroupTitle"> <a class="ABC" href="?rft.genre=book">Book</a> </td> </tr> |
should be changed to:
<tr> <td class="Block"> <strong>Article</strong> </td> <td> </td> <td class="GroupTitle"> <a class="ABC" href="Journal.html">Journal</a> </td> <td> </td> <td class="GroupTitle"> <a class="ABC" href="Book.html">Book</a> </td> </tr> |
- Clean up the input tags.
Each file (Article.html, Book.html, and Journal.html), as delivered, contains form INPUT tags that contain OpenURL 1.0 elements. You should remove these elements from the INPUT tags so that your form looks good when hosted on your own server. You can find these elements by looking for <TMPL_VAR ESCAPE='HTML' NAME= when contained within an INPUT tag.
Change the following:
<input type=text name="rft.atitle" size="33" value="<TMPL_VAR ESCAPE='HTML' NAME='rft.atitle'>"> |
to:
<input type=text name="rft.atitle" size="33" value=""> |