CollectiveAccess - konfigurointi
CollectiveAccess on erittäin konfiguroitava. Erilaisia .conf -päätteisiä tiedostoja on yli 30 varsinaisen asennusprofiilin säätöjen lisäksi. Onneksi suurimpaan osaa konffaustiedostoja ei tarvitse koskea. Seuraavassa on esitetty mitä me olemme päätyneet muokaamaan.
Pikahaku
Pikahaun tuloksien näyttötapaa säädetään tiedostossa providence/app/conf/search.conf. Tiedostossa voi määritellä esimerkiksi, että taiteilijan nimi näkee teosnimen yhteydessä.
Seuraavassa yllä näkyvän muotoilun määrittely search.conf -tiedostossa:
ca_objects_artwork_quicksearch_result_display_template =
<unit relativeTo='ca_entities' restrictToRelationshipTypes='artist'>
<l>^ca_entities.preferred_labels.surname, ^ca_entities.preferred_labels.forename</l> :
</unit>
<l>^ca_objects.preferred_labels.name</l>
[^ca_objects.type_id]
Ensimmäinen termi ennen yhtäsuuruusmerkkiä sisältää tiedon siitä, mihin primäärityyppiin (kohteet, toimijat jne.) muotoilua käytetään. Termin alussa oleva ca_objects tarkoittaa, että muotoillaan vain kohteita ja _artwork_ taas rajaa kohteiden tyypiksi taideteokset ja sen alatyypit. Attribuutti relativeTo määrittää taas määrittää mistä primäärityypistä etsitään lisätietoja ja restrictToRelationshipTypes kertoo linkin tyypin. Tagi <l> luo linkin ko. tietueeseen ja .preferred_labels.surname taas kertoo, että näytetään tämän metatietokentän arvo.
lisätietoja:
- https://docs.collectiveaccess.org/wiki/Search.conf#Changing_the_layout_of_quicksearch_results
- https://docs.collectiveaccess.org/wiki/Display_Templates
Selaus (fasetit)
Selausnäkymä on myös monipuolisesti säädettävissä. Fasetteja voi tehdä metatietokenttien, listojen ja linkitysten pohjalta. On esimerkiksi hyödyllistä selata aineistoja varastosijainnin ja kunnon mukaan.
Luodaan seuraavaksi selailumahdollisuus kohteen kuntoluokituksen mukaan (browse.conf).
ca_objects = {
facets = {
....
kunto_facet = {
type = attribute,
element_code = condition,
group_mode = none,
order_by_label_fields = [name_plural],
label_singular = _("kuntoluokitus"),
label_plural = _("kuntoluokitus")
},
....
Lisätietoja: https://docs.collectiveaccess.org/wiki/Browse.conf
PDF export
CA pystyy luomaan PDF tiedostoja erilaisista näkymistä. Oletusrenderoija (domPDF) on kuitenkin aika kehno ja kannattaakin vaihtaa heti parempaan (wkhtmltopdf). Käytössä olevan PDF-renderoijan voi tarkistaa valitsemalla Administrator ->Configuration Check.
Ubuntun (16.04) omissa repoissa oleva wkhtmltopdf ei tue headless -käyttöä, joten tarvitaan uudempi versio. Alla olevilla rimpsuilla haetaan uudempi wkhtmltopdf -ohjelmisto ja asennetaan se.
wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox_0.12.5-1.xenial_amd64.deb
apt install -f ./wkhtmltox_0.12.5-1.xenial_amd64.deb
wkhtmltopdf on asennettuna meidän dockeroinnissa.