The Grinnell College Digital Library Application Developer's Blog
Call it The GCDLADB if you like.
Mounting //STORAGE for IMI Ingest in Digital.Grinnell 2 min read Jul 22, 2019 | Updated: Nov 12, 2020 08:30
Claiming another small victory today! Why? Well, the Digital.Grinnell instance of IMI (Islandora Multi-Importer) module is customized so that choosing “*local” as an object ingest source invokes a hook function I created in our DG7 module. That hook enables IMI to “find” named files/content (things like PDFs, images, etc.) in the Grinnell College //STORAGE server. //STORAGE can be mounted as a CIFS (Common Internet File System) and used to drive ingest if the right package/drivers are made available to Islandora. That can be a little tricky in ISLE, but it’s manageable. ...
Dockerized Omeka-S: Starting Over 6 min read Jul 25, 2019 | Updated: Sep 3, 2019 15:14
Attention! The Docksal portion of this discussion DID NOT WORK PROPERLY so I’ve hidden it from public view. Don’t use this project with Docksal (fin commands) until further notice! I’ve created a new fork of dodeeric/omeka-s-docker at DigitalGrinnell/omeka-s-docker, and it introduces a new docker-compose.yml file for spinning Omeka-S up locally, but WITHOUT Docksal (due to problems with the integration originally documented here). System requirements for local development of this project currently include: Docker (Community Edition) Git Local Development and Testing If your workstation is able to run the aforementioned required components then the following steps can be used to launch and develop a local instance. ...
Deleting Config Items in Drupal 8 1 min read Jul 30, 2019 | Updated: Jul 31, 2019 22:53
None of this is my creation, but it’s too valuable to forget! So kudos to Goran Nikolovski and his blog post. The problem I ran into involved the Drupal update.php script, and an orphaned bit of configuration data. When I tried running update.php the first of 13 pending database updates kept throwing an exception telling me of a missing plugin, and that effectively killed the other 12 updates. 😦 Well, I really didn’t care that it was missing (and Drupal should not either) because the update was there to delete it, but since the update kept failing, we had ourselves an impossible loop. ...
Resetting Docker 1 min read Jul 27, 2019 | Updated: Jul 31, 2019 13:59
This command snippet needs a blog post of its own! I typically use the following command stream to clean up any Docker cruft before I begin anew. Note: Uncomment the third line ONLY if you want to delete images and download new ones. If you do, be patient, it could take several minutes depending on connection speed. Workstation Commands docker stop $(docker ps -q) docker rm -v $(docker ps -qa) # docker image rm $(docker image ls -q) docker system prune –force And that’s a wrap. ...
PDF Ingest in Digital.Grinnell 2 min read Jul 24, 2019
A set of 21 PDF objects were ingested into Digital.Grinnell’s Faculty Scholarship collection using IMI on 22-July-2019; unfortunately none of these PDFs contained OCR (optical character recognition) or “text recognition” data, so none of them generated a valid FULL_TEXT datastream. FULL_TEXT datastreams are required to make PDF, and similar text content, searchable and discoverable in Digital.Grinnell. In order to confirm that the lack of OCR was in fact the problem, I ran a little test on https://digital.grinnell.edu/islandora/object/grinnell:26702, one of the 21 objects. ...
Replace OSX Terminal with iTerm2 for SSH 1 min read Jul 22, 2019
My memory isn’t what it used to be, but I have this blog. 😄 So when I realized that my primary work machine, an iMac, had not been configured with iTerm2 as its default terminal for ssh, I went looking for the solution…again. Found it here! The trick is to open iTerm2 and follow these two simple steps… Q: How do I set iTerm2 as the handler for ssh:// links? A: Two steps: Create a new profile called “ssh”. In the General tab, select the Command: button and enter $$ as the command. ...
Missing Oral History Transcripts in DG - Fixed 2 min read Jul 19, 2019
I recently constructed a new, local/development instance of ISLE (see my previous post) largely in order to debug a mystery in Digital.Grinnell’s display of oral histories. My Trello card for the issue reads: Our newest AOH entries, and some older objects, will not display a transcript after upgrade to the latest version of the OH module. OHScribe is needed to aid in re-processing transcripts for these objects, and some XDebug work will also be required. Engaging XDebug and PHPStorm allowed me to peek inside the relatively complex oral histories (OH) module where I found that some of our OH objects were missing key Solr field elements, like or_transcripts and or_speaker. ...
Debugging PHP in ISLE: a Kludge 2 min read Jul 19, 2019
In an earlier post I chronicle the exhaustive steps taken to create a “debuggable” local/development instance of Digital.Grinnell that behaves exactly like the real thing, except with a much smaller, portable FEDORA repository under it. I’m claiming success on that front, but there is one glaring kludge in the process that I have yet to work out. The Kludge So, my debugging of an ISLE stack involves the coordinated configuration and engagement of XDebug inside the Apache container, and PHPStorm, along with persistence of the stack’s PHP codebase… and therein lies the rub. ...
Compiling SCSS (SASS) for This Blog 2 min read Jul 19, 2019
While working on another post I finally made the decision to improve the appearance of this blog a bit, and unfortunately I’d forgotten exactly how to do that. Even more unfortunate, I never blogged about the process so I had to “discover” the details all over again. 😢 This post is intended to remedy that. SASS The theme used here, m10c, employs .scss, or SASS (Syntactically Awesome Style Sheets) files. Subsequently, a SASS compiler is required to process them and produce suitable . ...
Debugging ISLE-ld (Local Development) in PHPStorm 4 min read Jul 12, 2019
Debugging ISLE on a Mac This guidance applies to debugging PHP code in a local ISLE-ld, that’s http://isle.localdomain, instance using PHPStorm. Modify ISLE’s docker-compose.override.yml Before engaging PHPStorm we need to make one change to our ISLE-ld configuration by running a docker cp command, making a change to our docker-compose.override.yml file, and restarting the stack. Here are the commands and procedure. Workstation Commands cd ~/Projects/ISLE mkdir -p persistent/html docker cp isle-apache-ld:/var/www/html/. ./persistent/html The above commands will make a new ./persistent/html directory on the host, if one does not already exist, and the docker cp command will copy the current contents of the Apache container’s /var/www/html directory to the host. ...