Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    SFX

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. SFX
    3. Product Documentation
    4. Version 4.0
    5. SFX Advanced User's Guide
    6. CitationLinker

    CitationLinker

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Pointing to the CitationLinker
    2. Changing the Look of the Existing CitationLinker
    3. Incorporating the CitationLinker in Existing Web Pages
    • 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

    Point your users to the following for the default version of CitationLinker:
    http://server_name:port/instance_name/cgi/core/citation-linker.cgi
    This links your users to the article form that further links them to the journal and book forms.

    Changing the Look of the Existing CitationLinker

    You can change buttons, the .gif files, and the .tmpl files that make up the CitationLinker.
    Elements in the CitationLinker are governed by the style.css file (also used with the SFX menu .tmpl files) located in:
    /exlibris/sfx_ver/sfx4_1/<instance_name>/templates/css/public
    To change the look of the CitationLinker:
    1. Edit the .tmpl files on the SFX server as required.
    Do not change the FORM and INPUT TYPE tags.

    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
    1. 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
    1. 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

    You can incorporate the CitationLinker in existing Web pages.
    To incorporate the CitationLinker in existing Web pages:
    1. Copy the template files (Article.tmpl, Book.tmpl, Journal.tmpl, head.tmpl, and tail.tmpl) to your local Web server.
    2. 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.
    Do not edit the existing FORM and INPUT TYPE tags except as described below.

    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.

    In the examples, the library’s Web server is http://library.university.edu and the library’s SFX server is http://sfx.university.edu:9003/sfx_local.
    1. 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>

      to:

      <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.

    1. 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');">

    1. 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">

    1. 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">&nbsp;&nbsp;<strong>Article</strong>&nbsp;&nbsp;</td>

    <td>&nbsp;&nbsp;&nbsp;</td>

    <td class="GroupTitle">&nbsp;&nbsp;<a class="ABC" href="?rft.genre=journal">Journal</a>&nbsp;&nbsp;</td>

    <td>&nbsp;&nbsp;&nbsp;</td>

    <td class="GroupTitle">&nbsp;&nbsp;<a class="ABC" href="?rft.genre=book">Book</a>&nbsp;&nbsp;</td>

    </tr>

    should be changed to:

    <tr>

    <td class="Block">&nbsp;&nbsp;<strong>Article</strong>&nbsp;&nbsp;</td>

    <td>&nbsp;&nbsp;&nbsp;</td>

    <td class="GroupTitle">&nbsp;&nbsp;<a class="ABC" href="Journal.html">Journal</a>&nbsp;&nbsp;</td>

    <td>&nbsp;&nbsp;&nbsp;</td>

    <td class="GroupTitle">&nbsp;&nbsp;<a class="ABC" href="Book.html">Book</a>&nbsp;&nbsp;</td>

    </tr>

    1. 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="">

    View article in the Exlibris Knowledge Center
    1. Back to top
      • A-Z eJournal List and eBook Search
      • SFX Targets and Target Parsers
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Content Type
      Documentation
      Language
      English
      Product
      SFX
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved