DevNotes_Processes_PublicationsWebPageInstructions

How to update the publications website

The publications website, is linked to a github markdown page. The markdown is automatically updated through a process connecting a Zotero database to the saspubs repository.

How to add publications to the list

An automated process is used to edit publications.md and then push to github. Any edits to the markdown page not done by the automated process will be overwritten. The safest way to edit the page is to update the Zotero database.

1. Gain access to the Zotero database: Zotero is a free cloud-based database system for cataloging bibliographies. Create a Zotero account if you do not have one, and then request access to the Sasview group. @ajj, @butlerpd, @smk78, and @krzywon are the administrators of the group.
2. Download and configure the Zotero client: Download the client (available for all platforms), and install it. The free version only offers a limited amount of storage space and the default settings will automatically download PDF and image files to the database. To prevent the database from filling up, under Edit > Preferences, on the general tab of file handling, de-select all automatic file attachment settings.
3. Start using Zotero: Zotero has published a quick start guide. To add a publication to the list, the easiest way is to add an item by an ID, which can include a DOI, ISBN, or PubMed ID.
4. Sit back and wait: Once an item has been added to Zotero, the automated process will do the rest.

Zotero Usage and Notes

• Download the client (available for all platforms) and install it.
• Optionally, install the browser connector.
• Login to your account through the client by going to Edit > Preferences > Sync.
• Configure your client (and connector) to disable all automatic file downloads to prevent filling up the database. Under Edit > Preferences, on the general tab of file handling, de-select all automatic file attachment settings.
• Click the green Sync button on the main screen to download all publications to the client - this might take a few minutes.
• Start adding publications - The easiest method is to add an item by an ID.

Automatic Updates

Automatic updates are handled via a shell script that is run on the DANSE server. The shell script runs a series of python scripts that check for changes to the Zotero database.

1. Script repository: All python and shell scripts used in the automated process can be found at https://github.com/SasView/saspubs, administered by @ajj and @krzywon.
2. Shell script: The shell script assumes the location of a github key file is passed as the only argument. If the key file is not valid, the script halts and an error is thrown. If the key file is valid, the latest versions of both the saspubs and sasview.github.io repositories are pulled in, then the instrument_zotero_feed.py script is run. Instrument_zotero_feed checks for any changes to the Zotero database, formats and sorts the bibliography, creates a json file of all publications, and finally using the json file, generates the publications.md file. This file is copied to the local sasview.github.io and any changes are pushed to github.
3. Server setup: The DANSE server stores the saspubs and sasview.github.io repositories in parallel paths. A github key file is stored on the server and is used to pull and push directly from github. A cron job that executes the shell script runs every five minutes.

Please contact @krzywon with any questions.