csLink - Linking edited letters with correspSearch.

The widget csLink provides users with the opportunity to not only explore a single letter of an online editon but also its interconnection with other letters from the same letter network.

The widget can be included in an online edition to generate a link "Explore Network of Letters". Depending on the values of the data- attributes, an overlay will pop over on hovering the link and show a maximum of two other letters from the letter network.

In addition, links are provided to a complete list of the search query on http://www.correspSearch.net. If a letter entry contains a valid URL reference, the search result will be linked to the letter in its respective online edition.

The built files are located in the dist-folder.

File structure

index.html

contains the HTML code you have to include into your website to create the link 'Explore Network of Letters', which serves as the trigger for the widget.

static/css/cslink.css

contains the standard Bootstrap style information. Style can be customized based on the standard Bootstrap classes for popovers.

static/js/cslink.js

contains the Application code. Do not change anything here.

Setup the widget

Copy static/css/app.css into your respective folder for style sheets. If you do not have such a folder, create a "css" folder in your root directory and paste the app.css into that folder.
Create a link to that style sheet in the header of your HTML file.
Copy static/js/app.js into your respective folder for JavaScript files. If you do not have such a folder, create a "js" folder in your root directory and paste the app.js into that folder.
Copy the complete <div>-Tag of the widget to the place, where you want the link to appear.
Copy the <script>-Tag and paste it below the <div> you pasted in Step 4. Change the path according to the location of the JavaScript file, you copied in Step 3.
Change the values of the data attributes in the widget's <div> according to your needs.

Setup the attributes

Do not change the id attribute for the widget to work!

Required

data-correspondent-1-id

Authority File URI for the first correspondent.

data-start-date

Starting date for search (YYYY-MM-DD). If only one date is given, data-selection-span is obsolete.

data-range

Range of days that are included in the search. Depending on the value of data-selection-when, the range is either added after, before or after and before a date, or after and before a timespan.

date-selection-when

Determines, when the range shall be added to the given date. Possible values:

before
after
before-after Required, when only a date is given, can be left blank with a timespan.

date-selection-span Determines the temporal search direction when a timespan is given. Possible values:
fromStart: Results taken from the start of a timespan
fromEnd: Results taken from the end of a timespan
random: Picks random results in a timespan
median-before: Results taken from before the median of a timespan
median-after: Results taken from after the median of a timespan
median-before-after: Results taken from before and after the median of a timespan Required, when a timespan is given, can be left blank with a single date.

date-result-max Determines the total maximum of results (for both correspondents together) to show. When an odd number is given, one more result is shown for the first correspondent. Minimum is 1.

Optional

data-correspondent-1-name

Name of the first correspondent.

Required, if Authority File URI does not link to an Authority File from GND. If left blank and Authority File URI refers to an Authority File from GND, the widget will get the correspondent's preferred-name from GND. If left blank and the Authority file URI does not link to GND, no name will be shown.

data-correspondent-2-id

Authority File URI for the second correspondent.

data-correspondent-2-name

Name of the second correspondent.

data-end-date

Ending date for search (YYYY-MM-DD).

data-exclude-edition

xml:id of the edition to be excluded from search. Multiple ids divided by comma.

Copyright

Developed by Jonas Müller-Laackman jonas.mueller-laackman@bbaw.de

for the purpose of the DFG project correspSearch - Briefeditionen vernetzen at Berlin-Brandenburg Academy of Sciences and Humanities (BBAW).

License

csLink is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

csLink is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with csLink. If not, see http://www.gnu.org/licenses/.

peterstadler/csLink