XWiki-siirrosta

RDA-sovellusohje-sivusto RDA-kuvailu MARC 21 -formaatilla siirretään XWiki-palveluun tammi-helmikuussa 2024, koska nykyisen HY Wikin alustan Confluence-tuki loppuu. RDA-sivuston lisäksi migroidaan myös ruotsinkielinen Marc 21 -sivusto ja neljä muuta pienempää työtilaa, joihin on linkityksiä RDA-sivustolta, eli yhteensä 6 työtilaa:

Kuvailuohjeita käytetään kaikissa Suomen kirjastoissa, joten ohjesivujen pitää olla koko ajan käytössä. Tuotantoon menon takaraja näille ohjesivuille on helmikuun 2024 puolivälissä, jolloin HY Wikin tuki Confluence-ympäristössä lakkaa. Confluence-wiki jää yliopiston sisäverkkoon, mutta sitä enää voi käyttää julkisissa sivustoissa.

Kokoukset

Migraatioon liittyen on pidetty kokouksia eri kokoonpanoilla - kokousten muistiinpanot

Seuraava kokous:  XWiki-korjausten tilannepalaveri 6.2.2024 (XWiki-sivujen testaajat)

Migraation aikataulu ja vaiheet

Normaalin aikataulun mukaisesti sivusto migroidaan XWikiin ja adminilla on päivä aikaa katsoa asetukset kuntoon ennen kuin se julkaistaan. Mutta RDA-sovellusohjeen tapauksessa vanha Confluence-sivu pidetään pitempään julkisesti näkyvissä, jotta ohjeiden ylläpitäjät ehtivät rauhassa tehdä kaikki tarvittavat korjaukset suljettuun XWikiin.

29.1.2024 nykyiset Wikisivut lukkoon

  • Nykyiset ohjeet edelleen kuvailijoiden käytössä, mutta niihin ei enää voi tehdä päivityksiä
  • käytännössä pe 26.1. viimeinen päivä muokata nykyisiä ohjeita
  • Wikiin banneri, joka kertoo työn alla olevasta siirrosta

30.1.2024 migraatio XWikiin

  • Uusille sivuille pääsee tekemään korjauksia
    • myös ohjeiden päivitys, mutta päivitykset eivät näy kuvailijoille ennen kuin ohjeet julkistetaan
  • Banneri kertoo edelleen wikissä, että siirto on työn alla

14.2.2024 uusien osoitteiden julkistus

  • Kuvailijat alkavat käyttää XWikiin siirrettyjä ohjesivuja
  • Banneri emeritasivuilla päivitetään kertomaan uusi osoite XWikissä
  • Voidaan aikaistaa, jos saadaan korjaukset tehtyä jo aiemmin

15.2.2024 nykyiset HY Wikisivut eivät enää ole julkisia

  • Vanhoilta sivuilta saadaan jonkinlainen uudelleenohjaus, mutta ei tarkkaa vielä tietoa miten


(plus) Viestintäsuunnitelma

Tehdään viikolla 4 - ks. alasivu

-tiedote 1 lähetetty 26.1.2024 

XWiki-testaus joulukuu 2023 - tammikuu 2024

Testauksesta

Havaintoja ja kysymyksiä


Kirjaa alle taulukkoon havaintoja ja kysymyksiä

Ks. myös Tatjan testihuomiot kesä 2023

Pidemmät dokumentaatiot omilla sivuillaan (lisää tarvittaessa uusi sivu tämän sivun alasivuksi)


testihavainto/kysymysratkaisu/vastaushuomioitavaakorjaukset tehty nykyisiin ohjeisiin

Muuttuvatko sivujen osoitteet XWikissä vai säilyvätkö entiset?

Ohjeiden sijainti muuttuu uuteen osoitteeseen, myös sivujen sisäiset linkit muuttuvat, mutta ulkoiset linkit toimivat 

Ohjeisiin tulevat linkit muuttuvat


Tarvitaan paljon tiedotusta ohjeiden käyttäjille, että korjaavat linkit omissa ohjeissaan 


Uudelleenohjaus emerita-sivuilta on käytössä vain 15.2. asti

  • mahdollisesti etusivulle tulevat linkit voidaan uudelleen ohjata myöhemminkin, mutta ei onnistu alasivuilta

Sivujen sisäiset linkitykset eivät toimi, eivätkä myöskään saman ohjeen sivujen väliset linkit

poikkeus: järjestelmän generoimat linkit, kuten sisällysluettelotsisäiset linkit korjattava migraation jälkeen

Ulkoisten linkkien kohdalla näkyy "avaa uudessa ikkunassa" symboli, mutta sivu avautuukin samassa selainikkunassa

    • → XWikissä symboli tarkoittaa: linkki vie XWikin ulkopuolelle (tick) 
    • Tekstin lomassa olevat linkit eivät erotu kovin selvästi

10.1.2024 Sovittiin, että ei korjata linkkien asetuksia. Käyttäjät voivat avata linkit uuteen ikkunaan eri tavoilla.

Jatkossa XWikissä uutta linkkiä luodessa saa määritellä linkin avautumistavan helposti

Sovellusohjeen haku-ruudut ja muut Confluencen makroilla tehdyt toiminnot eivät toimi XWikissä


korjattava migraation jälkeen
Saisiko kaikki navigaatiopalkin (ala)sivut näkyviin keralla ilman more-klikkauksia?Tämä korjattu niin, että 50 alasivua näkyvissä, mutta seuraavat alasivut on klikattava näkyviin "xx more pages"

Saisiko nostettua sivujen määrän 100 alasivuun?

Tämän pystyy kiertämään pagetree-hakemistoissa sivun asetuksissa


Voiko vasemman navigaatiopalkin lukita? Eli jos oikean puoleista sisältötekstiä vierittää, niin vasen navigointipalkki pysyisi kuitenkin samassa kohdassa?

Saisiko vasemman reunan navigaatiopaneelin kelluvaksi? Tämä ei onnistu


Saisiko navigaatiopalkin leveyden säädettäväksi?Tämä on layout-asetus sivustokohtaisesti, käyttäjä ei voi säätää

Onko eriväristen fonttien käyttö mahdollista?
  • Onnistuu
  • 18.1. XWikiin lisätty edit-toimintoja
    • fontin värin valinta
    • taustavärin valinta
    • erikoismerkkien lisäys
    • tekstin asettelu (vasen, keskitys, oikea, tasaus)



Emojit/symbolit eivät ole siirtyneet, esimerkiksi:  info (i) (info)  - varoitus (!)  (warning) -  virhe (x) (error) 

  • johonkin taas on tullut näitä, vaikka ei pitäisi: ‡a Päänimeke/lyhyt nimekeemoticon_unhappyET) 
  • emoijit ovat pieniä, samankorkuisia kuin teksti eli erottuvat heikosti


Huomattu, että Confluencen jotkin emoijit toimivat myös kirjoittamalla näppäimistöltä. Mutta tulevat näkyviin vasta kun sivun tallentaa. 

  • :) :( :P :D ;) (y) (n)

  • (i) (/) (x)

  • (!) (+) (-) (?)

  • (on) (off)

  • (*y) (*r) (*g) (*b)




Taulukkomuotoilu ei siirry, vaan uuteen tulee vain "plain" taulukko

 

Taulukoiden muotoilut eivät siirry, mutta XWikissä on omat taulukkotyökalut, jotka avautuvat hiiren oikealla painikkeella

Taulukoita korjattava / muotoiltava uudelleen XWikissä

Taulukkotyökalut eivät yhtä helppokäyttöisiä kuin Wikissä, parannuksia toivotaan


Sivujen ankkurilinkit eivät toimi/sisällysluettelot puutteellisia. koska osa otsikkotiedoista puuttuu → ks alasivu Havaintoja - ankkurinkit joissa muuta muotoilua rikkoutuvat? 

    • Mihin otsikoinnit kadonneet esim. Musiikin RDA-sovellusohje kenttä 700 - osa otsikoista on muuttunut tavalliseksi tekstiksi
    • Vaikka otsikko ei näy sisällysluettelossa, sen tilalla on kuitenkin "pallukka" ja jos klikkaa "näkymätöntä otsikkoa" pääsee ohjeessa oikeaan kohtaan
    • Tekstin rivitys ei toimi, joissakin kohdissa on tuonut esim. otsikon alapuolella olevan RDA-kohdan osaksi otsikkoa: 338 Tallennetyyppi (T)RDA 3.3 YDINELEMENTTI
    • sisällysluetteloa merkitseviä ? pallukoita myös sellaisissa kohdissa, joissa niitä ei ohjeessa kuulu olla, esimerkiksi 250-kentässä: 


Nykyisessä RDA-sovellusohjeessa ankkurin muotoilu on usein otsikkotyyli ja siksi käy näin. Korjattavissa nykyiseen ohjeeseen siten, että siirretään kentän ankkuri eri riville ja valitaan sen muotoiluksi "kappale".

Pia: 19.12.2023: Pyydetty jos Sovellusohjeen 1XX-kenttien sivu voisi päivittää XWikiin kun ankkurilinkit ja otsikot ovat nyt eri riveillä. Kokeilu jo otsikot ja sisällysluettelo toimisi näin paremmin 

Migraatio voidaan tehdä vain kokonaiselle työtilalle, joten Minna kopioi tuon Pian muokkaaman sivun 20.12. siirrettävään Kirjastoaineistojen kuvailusäännöt –sivulle. Kopioitu sivu on viimeisenä nimellä Testi XWikiä varten 20.12. 

20.12. testisivu siirtynyt ok

korjattava nykyiseen ohjeeseen ennen migraatiota
  • Kumean RDA-sovellusohje ja kaikki muut Kumean ohjeet
  • Musiikin RDA-sovellusohje

  • Elokuvien painos

      • ===

    Elokuvien painostietoa merkitsevät ilmaisut kuten Director’s cut, limited edition merkitään myös kenttään 250.

Tässä oli ylimääräisiä muotoiluja RDA-sovellusohjeen tekstissä, jotka näkyivät vain koodissa. Poistettiin ylimääräiset muotoilut koodista.


 

Sivujen järjestysnumerointi navigaattorissa on aakkosellinen eikä aakkosnumeerinen, eli numeroinnissa pitää käyttää alkunollia, jotta sivut menevät oikeaan järjestykseen (01, 02, 03 eikä 1, 2, 3)



korjataan tämä jo nykyiseen ohjeeseen
  • Musiikin RDA-sovellusohje
  • Toimijakuvailuohje
  • Sisällökuvailuopas
  • MARC 21 pä svenska

Sivuilla olevat kommentit eivät siirry




Melkein kaikkien sanojen alla punainen sisksak-viiva. Miten "check spelling" -toiminnon saisi pois päältä? 

Tämä on selaimen ominaisuus

  • Selaimen asetuksista etsimällä tämän saa pois, toiminnon pikavalinta ei vain toimi Xwikissä
  • ohje Jarkon s-postissa 15.1.


Blogeissa on kahdella tapaa julkaisija: created by (nimi oikein) tai posted by (kasitunnussähköpostilla). Jälkimmäinen muoto on siirtyneissä postauksissa ja vain yksi blogipostaus on vasemalla alasvetovalikossa.

 

Tuo created by olikin julkaisemattomassa postauksessa eli nämä pitää muistaa erikseen ruksata julkaistuiksi.

Milloin saadaan muut siirrettävät ohjeet testialueelle, nyt vain RDA-sovellusohje?

siirretty 20.12.2023


(plus) Näistä siirrettävistä työtiloista ei ole testiversiota 

XWikissä:



  • Ei tietoa, miten siirtyvät

  • Ovat vanhentuneita ohjeita, joten mahdolliset vaihtoehdot:

    1. siirretään sellaisenaan (ei korjata mitään nykyisiin ohjeisiin etukäteen) ja lisätään uusille sivuille tieto tästä
    2. jätetään nämä työtiloiksi HY Wikiin, eli eivät olisi julkisia jatkossa?
      • siirto työryhmä-aluelle mahdollista, pyyntö efecte-tiketillä
    3. nämä voisi myös kopioida johonkin ohjeeseen ennen migraatiota, ja katsoa miten siirtyvät ja poistaa tarvittaessa näkyvistä sieltä
      • jos kokeillaan tätä, työtilat voi siirtää myös myöhemmin työtila-alueelle (ed. vaihtoehto)
  • 19.1. sovittiin, että siirretään sivut sellaisenaan (ei korjata mitään nykyisiin ohjeisiin etukäteen)
    • jos eivät näytä käytetttäviltä siirron jälkeen, poistetaan siirretyt sivut XWikistä ja  jätetään työtilaksi HY Wikiin - pyyntö siirtämisestä työtilaksi efecte-tiketillä Helpdeskiin
  • 6.2. sivut siirtyneet ok, ja ovat julkaisukelpoiset pienellä editoinilla

Yliopiston ulkopuolisissa käyttäjätunnuksissa saattaa olla yhteensopimattomia merkkejä (piste ja useimmat erikoismerkit). Ne muuttuvat alaviivaksi _ .

Ilmoitus käyttäjille, kun migraatio tehty


  • Risto ilmoittaa migraation jälkeen käyttäjille, joiden tunnus muuttuu

Käyttöoikeudet

  • miksi työtilan käyttöoikeudet eivät periydy kaikille alasivuille?

Kuvailun asiantuntijaryhmien jäsenille tieto uusista osoitteista, ja pyyntö kokeilla toimvatko käyttöoikeudet, kuten aiemmin.



RDA-sovellusohjeen esittelyteksti etusivulla, toinen kappale

Poistetaan kaksi viimeistä lausetta:

Sivuston ohjeita ylläpitävät Kuvailevan metatiedon asiantuntijaryhmä (Kumea), Musiikin metatiedon asiantuntijaryhmä (Muusa), Sisällönkuvailun asiantuntijaryhmä (Sisku) ja Toimijakuvailupalvelu (Toiku). Aiemmin nämä ohjeet sijaitsivat useassa eri verkko-osoitteessa Kansalliskirjaston kiwi-työtilassa. Yhteinen ohjesivusto avattiin vuoden 2022 alussa ja uudistuksen tarkoituksena on ollut ohjeiden parempi löydettävyys ja eri ohjeiden harmonisointi sekä helpompi ylläpito.

Poistettu 6.2.2024


Aineistokohtaisten ohjeitten aakkosjärjestys sakkaa, äänikirjat pitäisi olla listan viimeisenä:

 Tälle ei kai oikein voi mitään, XWiki kuvittelee ä:n a:na :( 

 



Siirrettyjen sivustojen XWiki-osoitteet

Korjaukset XWiki-siirron jälkeen

XWiki-palvelu on pois käytöstä 15.1.–15.2.2024 noin klo 7–9 yliopiston Wiki-sisältöjen migraatioiden takia 

  • Linkkien tarkistukset ja korjaukset -tilanne
  • Hakuruutu-makrojen korjaus:
    •  käyttöön Page Tree -makro, täytettävät asetukset:
      • Root muodossa (esimerkki): document:rdasovellusohje.RDA-kuvailu MARC 21 -formaatilla.RDA-sovellusohje.WebHome
        • tämä muoto löytyy halutulta kohdesivulta "kolmen pisteen" takaa kohdasta Information 
      • Finder-toiminnallisuus päälle
      • Show Root päälle
      • Limit-kohtaan sopiva lukema, esim. 10
      • Show Translations ja Show Attachments pois päältä
      • käytettävyys ei silti toimi kunnolla nyt, kun haun jälkeen syntyvä halutun kappaleen korostus sivustopuusta ei toimikaan enää linkkinä (vain hiiren oikean painikkeen kautta)! Kysytty Jarkolta 31.1.
        • vastaus: tämä toimi aiemmin kuten pitikin, hän kysyy XWikin tuelta lisätietoja
    • kysytty Jarkolta myös Confluencen "livesearch"-makroa vastaavaa
      • vastaus: "erilaisia hakulaajennuksia on, mutta ei asennettuna meille, lisälaajennuksia käydään esiin nousevien kyselyiden pohjalta läpi kunhan saadaan migraatiot tehtyä"
  • muiden Confluencen makroilla tehtyjen toimintojen korjaus:
  • Sisäisten linkkien korjaukset
    • korjaustapa: poimimalla sivu sivupuusta - ohje Helpdeskin XWiki-ohjeessa
  • RDA-ohjeen ankkurilinkkien korjaus

    • Tämä virheellinen:
      {{id name="100"/}}

      == (% style="color:#000000" %)100 - Pääkirjaus - henkilönnimi (ET)(%%) ==

      Korjattuna näyttää tältä:

      == (% style="color:#000000" %){{id name="100"/}}100 - Pääkirjaus - henkilönnimi (ET)(%%) ==

Keskusteluun


Check-list (valmiit yksittäiset sivut merkattu (tick) )

RDA-sovellusohje-sivustokokonaisuus

  • RDA-kuvailu MARC 21-formaatilla (tick) 
    • Aineistokohtaiset työohjeet (tick)  (Anneli tarkistaa)
      • Painettu monografia (tick) 
      • Pelit (tick) korjattavaa jäi AV-aineistoryhmälle
      • Sarja-aineisto (tick) 
      • Verkkoaineistot (tick) 
      • Videotallenteet (tick) korjattavaa jäi AV-aineistoryhmälle
      • Äänikirjat (tick) 
    • ISBD-ohjeita (tick) 
    • Lisäohjeita (Risto tarkistaa) (tick) 
      • BookWhere (tick) 
      • Hybriditietueiden (ISBD/RDA) käsittely (tick) 
      • Käyttöoikeuksien metatieto (tick) 
      • Loppupisteohje (tick) 
      • Pyhät kirjoitukset ja liturgiset teokset (tick) 
        • Liturgiset teokset (tick) 
        • Pyhät kirjoitukset tms. (tick) 
        • Raamatun kirjojen merkitseminen (tick) 
        • Raamatun teosauktoriteetit (tick) 
      • RDA-tallennusalustoja (tick) 
      • Saavutettavuus (tick) 
      • Tarkennuksia 264-kentän vuosien merkitsemisestä (tick) 
      • Teoksen ensisijaisen nimekkeen merkitseminen (tick) 
      • Translitterointi (tick) 
      • Varastotietojen ohje (tick) 
    • Musiikin RDA-sovellusohje (tick)
      • Alasivut 01-12 (tick)
      • Hakutiedot (tick)
    • RDA-sovellusohje (tick) - Kaikilta alasivuilta linkit tarkistettu ja makrot korjattu (id:ksi)
      • Alasivut 000-9XX (tick) 
      • Ohitusindikaattorit (tick) 
      • RDA-hakutiedot (tick) 
      • Toimijanimiin liittyvät suhdeosakentät (tick) 
    • Sisällönkuvailuopas
      • Alasivut 00-13
      • Liitteet 1-X
    • Toimijakuvailuohje (alustava)
      • Alasivut 01-14
      • Asterin toimintaohje
      • Asterin toimintaperiaatteet
      • Esimerkkejä
      • Fiktiiviset ja ei-inhimilliset entiteetit
        • Eläimet
        • Fiktiiviset hahmot ja taruhahmot
        • Jumalhahmot ja enkelit
      • MARC 21 -kentät
        • Nimiö ja kiinteämittaiset kentät
        • 035
        • 040
        • 075
      • Nomenin elementit
        • Huomautus nomenista
        • Tietolähde
      • Toimijakuvailun translitterointiohje
      • Uskonnollisiin teoksiin liittyvät toimijat

Muut ohjeet

Käyttöoikeuksien tarkistaminen eri ohjeista

Risto ja Minna 

RDA-sovellusohje-sivuston oikeudet kuvassa alla eli sivuille on pääsy kaikilla, mutta kommentointioikeuksia ei ole muilla kuin ylläpitäjillä.

ISBD-sovellusohjeessa on kommentointioikeudet, ja toimii rekisteröityneillä käyttäjillä. Testasin tätä toisella XWiki-käyttäjätunnuksellani (olen tehnyt toisen tunnuksen gmail-sähköpostilla). Jos olen kirjautunut, näkyy kommentti-ruutu, mutta jos en ole kirjautunut, muiden kommentit näkyvät, mutta en voi kirjoittaa kommnetteja.

 


→ Ainakin RDA-sovellusohjeeseen on lisättävä kommentointioikeudet (tick) 

(nyt pitäisi onnistua sekä yliopiston että paikallisilla tunnuksilla)

Kehitystoiveita

  • Saisiko muutoshistorian näkyviin, mistä näkee mitä muutoksia on tehty. Aiemmin Confluencen Wikissä pysyi katsomaan aiempia versioita.
    • Sivun alalaidan History-välilehdeltä pääsee tarkastelemaan sivuhistoriaa ja vertailemaan valittuja versioita (Compare selected versions). Vertailussa ovat valittavissa Raw- ja Rendered-näkymät. Muutosten hahmottaminen ei ole yhtä selkeää kuin Confluencen Wikissä.
  • Nyt sivua pystyy muokkaamaan vain yksi henkilö kerrallaan, yhteiseditointi olisi tarpeellinen ominaisuus (tämä oli mahdollista Confluencen Wikissä)
  • Taulukoiden muokkaustyökalut?
  • Parempi hakutyökalu! Tällä hetkellä ainoa vaihtoehto on page tree search, joka on varustettu finder-toiminnolla, mutta sen toiminnallisuus on kankeaa, eikä se löydä kaikkea haluttua
  • No labels