Update hOCR docs

[joecorall]

What does this Pull Request do?

The hOCR derivative docs conflict with expectations implied in the islandora_hocr module. Namely - the hOCR derivative XML needs to be a standalone media entity tagged with the hOCR media use term created by DGI's islandora_hocr module, not an additional file field added to an existing media entity like these docs specify.

• Other Relevant Links: https://islandora.slack.com/archives/CM5PPAV28/p1715263771488779

What's new?

How should this be tested?

Documentation Status

• Does this change existing behaviour that's currently documented?
• Does this change require new pages or sections of documentation?
• Who does this need to be documented for?
• Associated documentation pull request(s): ___ or documentation issue ___

Additional Notes:

Interested parties

Tag (@ mention) interested parties or, if unsure, @Islandora/committers

[alxp]

This is not necessary if you set a variable in your docker-compose.yml:

In build/docker-compose/docker-compose.drupal.yml in the environment section, add

SOLR_HOCR_PLUGIN_PATH: ${SOLR_HOCR_PLUGIN_PATH}

Then when make solr-cores runs, the necessary config settings for hOCR will be generated by islandora_hocr.

see it in this branch:
https://github.com/Islandora-Devops/isle-dc/blob/solr-hocr/build/docker-compose/docker-compose.drupal.yml

[joecorall]

I don't see SOLR_HOCR_PLUGIN_PATH defined anywhere in the Solr OCR Highlighting plugins' install docs. IIUC if the plugin is placed in a common solr lib directory it will automatically get loaded.

That being said, I have not tested a solr instance without this setting - I added it per their install instructions. I'll see if this is maybe not needed with the plugin getting loaded.

[alxp]

It's read by islandora_hocr, if it sees that environment variable, it will add all of the configs needed to load the ocr highlighting library when you download the Solr configs from Drupal.

[joecorall]

Thanks @alxp - I updated the docs to reflect this. Once Islandora-Devops/isle-buildkit#345 merges I think we can merge this PR

[nigelgbanks]

-Looks good, just gonna test locally- whoops wrong window.

[alxp]

Looks good, thanks for doing this.