Tiedostonhallinta

Tiedostonhallinnan kautta voit muokata kaikkia näkymän tiedostoja. Sitä tarvitaan näkymien räätälöintiin ja joidenkin asetusten muuttamiseen.

Yleistä

Avaa Tiedostonhallinta klikkaamalla Hallintaliittymän päävalikon Tiedostonhallinta-linkkiä:

Ruudun vasemmassa reunassa näytetään organisaation hakemistohierarkia.

Hierarkiapuun oikealla puolella näytetään valitun hakemiston toiminnot ja tiedostolistaus:

Hakemiston toiminnot näytetään tiedostolistauksen yläpuolella. Näiden avulla voit tarkastella hakemiston muutoksia, luoda uuden hakemiston tai tiedoston, sekä lähettää tiedoston omalta koneeltasi aktiiviseen hakemistoon. Voit myös nimetä uudelleen tai poistaa tiedostonhallinnan kautta luodun hakemiston. 

Tiedostolistauksessa esitetään hakemiston tiedostot ja valittu tiedosto sinisellä taustavärillä.

Aktiivisen tiedoston toiminnot näytetään hakemistotoimintojen alapuolella. Tiedoston voi esimerkiksi avata editoriin muokattavaksi, kopioida toiseen hakemistoon tai verrata alkuperäiseen. Tiedostonhallinnan kautta luodun tiedoston voi lisäksi poistaa tai nimetä uudelleen.

Tiedostojen tarkastelu ja muokkaus

Avaa valittu tiedosto tekstieditoriin valitsemalla Muokkaa:

Mikäli tiedoston muokkaus ei ole sallittua, editori avataan luku-oikeuksilla ja tallennus on estetty. Esimerkiksi Finna-teeman tiedostojen tarkastelu on siis mahdollista.

Editorissa on Etsi ja korvaa -toiminnot, jotka toimivat näppäinoikoteillä (vie hiiri oikean yläreunan info-ikonin päälle nähdäksesi ohjeet). 

Tiedostojen kopiointi ja lataaminen omalle koneelle

Voit kopioida valitun tiedoston toiseen hakemistoon (oman organisaation näkymien sisällä) valitsemalla Kopioi ja valitsemalla tämän jälkeen kohdehakemisto:

Voit ladata tiedoston omalle koneellesi klikkaamalla "Lataa tiedosto".

 

Tiedostoista etsiminen

Etsi hakemiston tiedostoista -toiminto kohdistuu aktiivisen hakemiston ja tämän alihakemiston sisältämiin tiedostoihin. Haku on merkkikokoriippumaton (pieniä ja suuria kirjaimia ei erotella) eikä kohdistu binääritiedostoihin.

Hakuterminä voit käyttää POSIX extended regular expression (ERE) syntaksin mukaista säännöllistä lauseketta. Jos säännöllinen lauseke sisältää varattuja erikoismerkkejä ( .^$*+?()[{\| ), näiden eteen pitää lisätä '\' -merkki.

Hakutulosta klikkaamalla voit avata tiedoston editoriin riville, jossa hakutermi esiintyy.

Muokkausten tarkastelu

Versionhallinta

Tiedoston tila on jokin seuraavista: 

1. Alkuperäinen: Tiedosto on linkitetty Finnan keskitettyyn ylläpitoon.
2. Muokattu: Tiedostoa on muokattu joko näkymän asetusten tallennuksen yhteydessä tai tiedostonhallinnan kautta. Näihin sisältyvät lisäksi custom-teeman tiedostot, jotka ylikirjoittavat Finna-teeman tiedostoja. 
3. Luotu: Tiedosto on luotu näkymän asetusten tallennuksen yhteydessä tai tiedostonhallinnan kautta.

Tiedoston tila näytetään tiedostolistauksessa. Hallintaliittymän kautta muokattujen tiedostojen muutoksia voi tarkastella valitsemalla Vertaa alkuperäiseen:

Tiedostoon lisätyt kohdat näytetään vihreällä, poistetut punaisella. custom-teeman tiedostojen vertailu tehdään Finna-teeman saman nimiseen tiedostoon.

Yhteenveto hakemiston muutoksista

Hakemiston muokatut ja luodut tiedostot saat listattua valitsemalla Näytä muutokset. Listauksessa ovat mukana myös kaikki alihakemistot, joten yhteenvedon koko näkymästä saa listaamalla näkymän juurihakemiston muutokset.

Tiedostonhallinnan kautta tehtyjen muutosten ylläpito

Jotta näkymän ylläpito olisi mahdollisimman vaivatonta, muokkaukset suositellaan laittamaan seuraaviin lihavoituihin tiedostoihin:

• local/config/vufind (täällä on asetustiedostoja, joiden muokkaamiseen on toimintokohtaiset ohjeet)
• themes/custom (täällä oleviin sivupohjiin (.phtml-päätteiset tiedostot) voi myös laittaa PHP-koodia, mutta tämän kanssa on oltava varovainen sillä virheellinen PHP-koodi saattaa aiheuttaa ongelmia kaikesta muusta riippumatta)
  
  • templates/search/home (ohje)
    
    • "home-" alkuiset sivupohjat
  • templates/content/Additions/ (ohje)
    
    • kaikki hakemiston tiedostot
  • css/ (ohje)
    
    • custom.css
  • less/ (ohje)
    • custom.less
    • variables.less
  • js/ (ohje)
    
    • custom.js (finnaCustomInit()-funktioon voi lisätä JavaScript-koodia)
• PHP-ohjelmakoodin laajennukset sijoitetaan FinnaCustom-moduuliin.

Tiedoston sisällön tuominen ulkoisesta lähteestä

Voit linkittää tiedoston ulkoiseen lähteeseen ja päivittää tiedoston sisällön linkin kautta. Avaa tiedosto editoriin, syötä lähteen URL tai valitse  kohdetiedosto avautuvasta dialogista: 

Linkitetty sisältö noudetaan editoriin tarkasteltavaksi linkin lisäämisen yhteydessä ja "Päivitä" -nappia klikattaessa. Muutokset astuvat voimaan vasta tiedoston tallentamisen jälkeen. Linkin kautta noudetun sisällön voi siis hylätä sulkemalla editorin muutoksia tallentamatta.

Linkitetty tiedosto ei päivity automaattisesti ulkoisen lähteen muuttuessa, vaan ainoastaan erikseen päivitettäessä.

Voit purkaa linkityksen klikkaamalla "Poista linkitys", minkä jälkeen voit jälleen muokata tiedostoa editorissa normaaliin tapaan. Linkityksen purkaminen ei muuta tiedoston sisältöä. Tiedoston linkitys poistetaan myös automaattisesti mikäli tiedosto palautetaan alkuperäiseen versioonsa (ks. Versionhallinta yllä).

Linkitys GitHub Gistiin

Selvitä Gistin URL Githubissa (Embed valikosta kohta Share). Tämän jälkeen linkitä viereen ilmestynyt osoite hallintaliittymään.

Hallintaliittymän ylikirjoittamat tiedostot

Hallintaliittymä kirjoittaa näkymän asetusten tallennuksen yhteydessä seuraaviin tiedostoihin:

Mikäli näiden tiedostojen sisältöä on tarpeen lukea linkin kautta ulkoisesta lähteestä, ei tiedoston konfiguroimia ominaisuuksia kannata muokata hallintaliittymän kautta.