Zotero Robust Links

<!DOCTYPE html>  <html lang="en" itemscope itemtype="http://schema.org/WebPage" itemid="https://robustlinks.mementoweb.org/api-docs/"> <head> <meta charset="utf-8" /> <meta property="og:type" content="website"> <meta property="og:title" content="Zotero Robust Links"> <meta property="og:image" content="https://mementoweb.org/static/css/images/robustlinks.png"> <meta property="og:url" content="https://robustlinks.mementoweb.org/api-docs/"> <meta property="og:site_name" content="Robust Links"> <meta property="og:locale" content="en_US"> <meta property="og:description" content="Information About the Robust Links Zotero Extension."> <meta name="twitter:card" content="summary"/> <meta name="twitter:site" content="@Mementoweb"> <meta name="twitter:image:src" content="https://mementoweb.org/static/css/images/robustlinks.png"> <meta name="twitter:card" content="summary"> <meta name="twitter:creator" content="@Mementoweb"> <meta name="twitter:title" content="Zotero Robust Links"> <meta name="twitter:description" content="Information About the Robust Links Zotero Extension.">  <link rel="stylesheet" type="text/css" href="https://doi.org/10.25776/z58z-r575" />  <script type="text/javascript" src="https://doi.org/10.25776/h1fa-7a28"></script> <title>Zotero Robust Links</title> <link rel="icon" type="image/png" href="https://mementoweb.org/static/css/images/robustlinks_20x20.png"> <style type="text/css"> body { height: 100%; min-height: 100%; margin: 0; } .container { background: #ffffff; width: 980px; margin: 0 auto; } .table { BORDER-RIGHT: #999999 1px solid; BORDER-TOP: #999999 1px solid; BORDER-LEFT: #999999 1px solid; BORDER-BOTTOM: #999999 1px solid; border-spacing: 2px; } .th10 { width: 10%; background-color: #ffffff; text-align: left; } .th20 { width: 20%; background-color: #ffffff; text-align: left; } .th80 { width: 80%; background-color: #ffffff; text-align: right; } .th50 { width: 50%; background-color: #ffffff; color: #666666; text-align: center; } .th40 { width: 40%; background-color: #ffffff; text-align: right; } .t50_1 { width: 50%; background-color: #ffffff; text-align: center; } .t50_2 { width: 50%; background-color: #eeeeee; text-align: left; } .t100_1 { width: 100%; background-color: #eeeeee; text-align: left; } .t100_2 { width: 100%; background-color: #ffffff; text-align: left; } .t100_3 { width: 100%; background-color: #ffffff; text-align: center; } .t100_4 { width: 100%; background-color: #eeeeee; text-align: center; } .t100_5 { width: 100%; background-color: #ffffff; text-align: right; } .style3 { font-family: Arial, Helvetica, sans-serif; color: #000000; } .style4 { font-family: Arial, Helvetica, sans-serif; color: #000099; } .img.center { display: block; margin-left: auto; margin-right: auto; } .error_message { font-weight: bold; color: #ff0000; } .centerlist { text-align: center; } .centerlist > ol { display: inline-block; text-align: left; } pre { font-size: 8pt !important; } /* Style the tab */ .tab { overflow: hidden; border: 1px solid #ccc; background-color: #f1f1f1; } /* Style the buttons that are used to open the tab content */ .tab button { background-color: inherit; float: left; border: none; outline: none; cursor: pointer; padding: 10px; transition: 0.3s; font-size: 10pt; } /* Change background color of buttons on hover */ .tab button:hover { background-color: #ddd; } /* Create an active/current tablink class */ .tab button.active { background-color: #ccc; } .tab button { color: rgb(82, 82, 82); vertical-align: center; } /* Style the tab content */ .tabcontent { display: none; padding: 6px 12px; border: 1px solid #ccc; border-top: none; } </style> </head> <body> <div class="container"> <div id="menu_top"> <iframe id="menu_top_frame" src="https://robustlinks.mementoweb.org/menu/menu_top_rl.html" style="border: 0; width: 980px; height: 102px"></iframe> </div> <div class="t100_1"> <div class="style3"> <h1>Zotero Robust Links</h1> Last updated: March 3, 2021 </div> </div> <br> <div class="t100_3">  <img src="https://robustlinks.mementoweb.org/zotero/images/zotero-robust-links-logo.png" style="height: 400px;"> </div> <div class="t100_2"> <div class="style3"> Links to web resources frequently break, and linked content can change at unpredictable rates. We refer to both phenomena combined as <a href="https://doi.org/10.1371/journal.pone.0115253">Reference Rot</a>. <a href="https://journal.code4lib.org/articles/15509">Robust Links</a> help combat reference rot and allow readers to revisit content on the web as it existed when it was linked. <strong>Zotero Robust Links</strong> is a Zotero extension that allows users to create their own Robust Links from within Zotero. Upon ingestion of a web resource, it automatically creates an archival copy (a memento) of the resource in a publicly available web archive and generates the Robust Link HTML code for robust linking to it for your publication. The extension also allows users to manually <em>robustify</em> a resource and choose an individual web archive for the process. <ul> <li><a href="https://github.com/lanl/Zotero-Robust-Links-Extension/releases/download/v2.0.0-20220320145937/robustlinks.xpi" title="In Firefox, download file with right-click 'Save Link As...'.">Download Extension</a> (In Firefox, download file with right-click 'Save Link As...') — Zotero version 5.X, 6.X</li> <li><a href="https://github.com/lanl/Zotero-Robust-Links-Extension/releases/download/v2.0.0-20220320145937/RobustLink.js">Download the Robust Links Export Translator</a> (optional) — Zotero version 5.X, 6.X</li>  </ul> </div> </div> <div class="t100_2"> <div class="style3"> <h2>Table of Contents</h2> <ol> <li><a href="#installing_extension">Installing the Zotero Robust Links Extension</a></li> <li><a href="#installing_translator">Installing the Optional Robust Links Export Translator</a></li> <li><a href="#automatically_creating_robust_links">Automatically Creating Robust Links as Items Are Added</a></li> <li><a href="#manually_creating_robust_links">Manually Creating Robust Links For Items</a></li> <li><a href="#configuring_zotero_robust_links">Configuring Zotero Robust Links</a></li> <li><a href="#exporting_robust_links">Exporting a Robust Link for an Item with the Optional Export Translator</a></li> </ol> </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="installing_extension">1. Installing the Zotero Robust Links Extension</h2> </div> </div> <div class="t100_3"> <img src="https://robustlinks.mementoweb.org/zotero/images/install-addon-from-file-windows.png" style="width:800px;"> </div> <div class="t100_2"> <div class="style3"> Zotero Robust Links is a standard Zotero extension installed via Zotero's <em>Add-on Manager</em>: <ol> <li><a title="In Firefox, download file with right-click 'Save Link As...'." href="https://github.com/lanl/Zotero-Robust-Links-Extension/releases/download/v2.0.0-20220320145937/robustlinks.xpi">Download</a> (In Firefox, download file with right-click 'Save Link As...') the extension XPI file to a place on your hard drive</li> <li><strong><em>WARNING: If you are setting up Zotero for the first time on a new computer, fully sync your library first before proceeding.</em></strong><li> <li>Within Zotero:</li> <ol> <li>Open the <em>Tools</em> menu</li> <li>Click <em>Add-ons</em></li> <li>In the Add-ons Manager window, click the <em>Tools for all add-ons</em> button and select <em>Install Add-on from File...</em> (see picture above)</li> <li>Navigate to where you saved the XPI file, click the file name once, and then click <em>Open</em></li> <li>In the resulting dialog that states <em>Install add-ons only from authors whom you trust</em>, click <em>Install Now</em></li> </ol> <li>Restart Zotero</li> </ol> </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="installing_translator">2. Installing the Optional Robust Links Export Translator</h2> </div> </div>  <div class="t100_2"> <div class="style3"> The Robust Links Export Translator is an optional component that allows you to export a Zotero item as a Robust Link. It is installed by copying its file to a specific folder: <ol> <li><a href="RobustLink.js">Download</a> the RobustLink.js file to a place on your hard drive</li> <li>Open your file manager</li> <ul> <li>On <em>Microsoft Windows</em> use Windows Explorer</li> <li>On <em>macOS</em> use Finder</li> </ul> <li>Navigate to your Zotero Data Directory</li> <ul> <li>On <em>Microsoft Windows</em> the default data directory is <code>C:\Users\%USERNAME%\Zotero</code> where <code>%USERNAME%</code> is your username</li> <li>On <em>macOS</em> it is <code>/Users/$USER/Zotero</code> where <code>$USER</code> is your username</li> <li>If you have configured a custom data directory, or your data directory does not exist at these locations, you can find it yourself: </li> <ol> <li>Open Zotero</li> <li>Go to Zotero Preferences</li> <ul> <li>On <em>Microsoft Windows</em> open the <em>Edit</em> menu and choose <em>Preferences</em></li> <li>On <em>macOS</em> open the <em>Zotero</em> menu and choose <em>Preferences</em></li> </ul> <li>Choose <em>Advanced</em></li> <li>Choose the <em>Files and Folders</em> tab</li> <li>Record the value shown under <em>Data Directory Location</em> or click <em>Show Data Directory</em></li> </ol> </ul> <li>Open a second file manager at the location where you downloaded RobustLinks.js</li> <li>Copy RobustLinks.js from the download location into folder <em>translators</em> in the Zotero Directory</li> <li>If Zotero is running, Restart Zotero</li> </ol> </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="manually_creating_robust_links">3. Automatically Creating Robust Links as Items Are Added</h2> </div> </div> <div class="t100_3"> <img src="https://robustlinks.mementoweb.org/zotero/images/robustlinks-on-add.png" style="width: 50%;"> </div> <br> <div class="t100_2"> <div class="style3"> As you add a new items to the Zotero library, as shown above, for example, Zotero Robust Links will automatically create a memento for them in the default web archive, create the Robust Links HTML, and generate a message in the lower right corner of Zotero stating <em>Success! Note contains Robust Link.</em> The item in the Zotero library now has a new note named <em>Robust Link</em> that contains the HTML and instructions for including a Robust Link of this reference in your HTML pages, as shown in the picture below. </div> </div> <div class="t100_3"> <a href="https://robustlinks.mementoweb.org/zotero/images/robust-link-note.png"><img src="https://robustlinks.mementoweb.org/zotero/images/robust-link-note.png" style="width:800px;"></a> <p> <em style="text-align: center;">Click image above to view larger version</em> </p> </div> <div class="t100_2"> <div class="style3"> For this to work, the item <strong>must</strong> contain a valid value in its <em>URL</em> or <em>DOI</em> field. If the item does not contain a value for either of these, then Zotero Robust Links has nothing to work with and will not proceed further. Also, this extension can only create mementos from the content that the web archives can access. If something is behind a paywall, the web archive can only preserve the information found on a public-facing page. </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="manually_creating_robust_links">4. Manually Creating Robust Links For Items</h2> </div> </div> <div class="t100_3"> <img src="https://robustlinks.mementoweb.org/zotero/images/robustify-resource-windows.png" style="width:800px;"> </div> <div class="t100_2"> <div class="style3"> You can create Robust Links of any resource by right-clicking the item and choosing <em>Robustify This Resource</em> and then selecting a web archive, as shown in the above picture. Archiving the resource is the first step in creating a Robust Link. You have the following options for web archives: <ol> <li><em>Default Web Archive</em> - ask the extension to use the default web archive configured under Robust Links Preferences (see next section) </li> <li><em>Any Web Archive</em> - ask the extension to randomly choose an archive</li> <li><em>Internet Archive</em> - ask the extension to create a memento at the Internet Archive, colloquially known as the Wayback Machine</li> <li><em>Archive.Today</em> - ask the extension to create a memento at Archive.Today, also known as archive.is or archive.md</li> </ol> The result is a new note for the item as described above.<br> For this to work, the item <strong>must</strong> contain a valid value in its <em>URL</em> or <em>DOI</em> field. If the item does not contain a value for either of these, then Zotero Robust Links has nothing to work with and will not proceed further. </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="configuring_zotero_robust_links">5. Configuring Zotero Robust Links</h2> </div> </div> <div class="t100_3"> <img src="https://robustlinks.mementoweb.org/zotero/images/robust-links-preferences.png" style="width:200px;"> </div> <div class="t100_2"> <div class="style3"> To access the preferences for Zotero Robust Links, choose <em>Tools</em> and then <em>Robust Links Preferences...</em>. Zotero Robust Links supports three different configuration options, as shown above: <ul> <li><em>Archive-on add</em> — Choose <em>Yes</em> if you want to create Robust Links automatically for items imported via Zotero's browser extension or via Zotero's <em>Add item(s) by identifier</em> button</li> <li><em>Archive to use by default</em> — Choose the archive to use when automatically importing a new item or when choosing <em>Default Web Archive</em> in the manually right-click menu detailed in the previous section</li> <li><em>Always assume original resource</em> — instructs Zotero Robust Links to ignore whether or not the URL in the URL field of an item comes from a web archive and always create a new memento from the URL — <strong>do not modify this setting unless you fully understand its implications</strong></li> </ul> </ul> </div> </div> <div class="t100_2"> <div class="style3"> <h2 id="exporting_robust_links">6. Exporting a Robust Link for an Item with the Export Translator</h2> </div> </div> <div class="t100_3"> <img src="https://robustlinks.mementoweb.org/zotero/images/export-robust-link.png" style="width:200px;"> </div> <div class="t100_2"> <div class="style3"> The Robust Link Export Translator enables the export of the Robust Link for an item to an HTML file. The exported HTML can then easily be included in a webpage, article, blog post etc. <ol> <li>Right click on the item you want to export</li> <li>Choose <em>Export Item...</em></li> <li>In the resulting dialog, next to <em>Format</em> choose <em>Robust Link</em> from the drop-down list</li> <li>Click OK</li> <li>In the resulting dialog, name the HTML file and save it to the desired directory</li> </ol> </div> </div> <br><br> <div id="menu_bottom" style="background: #eee; height: 60px; bottom: 0; position: relative; width: 980px; margin: 0;"> <iframe src="https://robustlinks.mementoweb.org/menu/menu_bottom_cc.html" style="border: 0; width: 980px; height: 55px"></iframe> </div>聽 </div> </body> </html>

CINXE.COM

Zotero Robust Links