diff --git a/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/search.sv.html b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/search.sv.html new file mode 100644 index 000000000..27af5a723 --- /dev/null +++ b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/search.sv.html @@ -0,0 +1,254 @@ +{# + Copyright (C) 2021 CERN. + Copyright (C) 2024 KTH Royal Institute of Technology. + + Invenio App RDM is free software; you can redistribute it and/or modify it + under the terms of the MIT License; see LICENSE file for more details. +#} +{%- set title = _("Search guide") %} +{%- extends config.BASE_TEMPLATE %} + +{%- block page_body %} +
+

Sökguide

+

+ Denna guide förklarar hur man skriver avancerade sökfrågor med hjälp av lättförståeliga exempel. +

+

Enkel sökning (en eller flera termer)

+

+ Exempel: + open science +

+

+ Resultaten kommer att matcha poster som innehåller termerna open + eller science i något fält. Observera att grundord används, så exempelvis kommer science även att matcha + sciences. Sökresultaten rankas enligt en algoritm som tar hänsyn till dina söktermer. +

+

+ Du kan kräva att båda termerna är med med hjälp av antingen + + eller AND operatorn: +

+

+ Exempel: + +open +science + eller + open AND science +

+

+ Du kan kräva att en eller flera termer inte är med med hjälp av antingen + - eller NOT operatorn: +

+

+ Exempel: + -open +science + eller + NOT open AND science +

+

Frassökning

+

+ Exempel: + "open science" +

+

+ Resultaten kommer att matcha poster som innehåller frasen + open science i något fält. +

+

Fältsökning

+

+ Exempel: + metadata.title:open +

+

+ Resultaten kommer att matcha poster som innehåller termen open i + fältet metadata.title. Om du vill söka efter flera termer + i titeln måste du gruppera termerna med parentes: +

+

+ Exempel: + metadata.title:(open science) +

+

+ Se InvenioRDM-dokumentationen för en fullständig lista över fält du kan söka i. +

+

Kombinerad enkel-, fras- eller fältsökning

+

+ Exempel: + +metadata.title:"open science" -metadata.title:policy + eller t.ex. + metadata.title:(-open +science) +

+

+ Du kan kombinera enkel-, fras- och fältsökning för att konstruera avancerade sökfrågor. +

+

Intervallsökning

+

+ Exempel: + metadata.publication_date:[2017 TO 2018] + (notera att du måste skriva TO med versaler). +

+

+ Resultaten kommer att matcha alla poster med ett publiceringsdatum mellan 2017-01-01 och + 2018-01-01 (båda datumen inkluderade). +

+

Observera att partiella datum utökas till fullständiga datum, t.ex.:

+ +

+ Använd hakparenteser ([]) för inkluderande intervall och + måsvingar ({}) för exkluderande intervall, t.ex.: +

+ +

Exempel på andra intervall:

+ +

Rankning/Sortering

+

+ Som standard sorteras alla sökningar enligt en intern rankningsalgoritm som poängsätter varje matchning mot din sökfråga. Både i användargränssnittet och REST API är det möjligt att sortera resultaten efter: +

+ +

Reguljära uttryck

+

+ Reguljära uttryck är ett kraftfullt mönsterigenkänningsspråk som tillåter att + söka efter specifika mönster i ett fält. Till exempel, om vi vill hitta + alla poster med DOI-prefixet 10.5281 kan vi använda en sökning med reguljärt uttryck: +

+

+ Exempel: + metadata.subjects.identifier:/03yrm5c2[1,6]/ +

+

+ Var försiktig, det reguljära uttrycket måste matcha hela fältvärdet. + Se + reguljära uttryckets syntax + för ytterligare detaljer. +

+

Fält med saknade värden

+

+ Det är möjligt att söka efter poster som antingen saknar ett värde eller har + ett värde i ett specifikt fält med hjälp av _exists_ och + not _exists_ fältnamn. +

+

+ Exempel: + not _exists_:metadata.additional_titles + (alla poster utan metadata.additional_titles) +

+

+ Exempel: + _exists_:metadata.creators + (alla poster med metadata.creators) +

+

Avancerade koncept

+

Boosting

+

+ Du kan använda boost-operatorn ^ när en term är mer relevant + än en annan. Till exempel kan du söka efter alla poster med frasen + open science i antingen titel eller + beskrivning fält, men ranka poster med frasen i + titel fältet högre: +

+

+ Exempel: + metadata.title:"open science"^5 metadata.description:"open science" +

+

Fuzzy-sök

+

+ Du kan söka efter termer som är liknande men inte exakt samma som din sökterm + med hjälp av fuzzy-operatorn ~. +

+

+ Exempel: + oepn~ +

+

+ Resultaten kommer att matcha poster med termer liknande oepn vilket + till exempel även skulle matcha open. +

+

Närhets-sökningar

+

+ En frasesökning som "open science" förväntar som standard att alla termer + är i exakt samma ordning, och skulle därmed till exempel inte matcha en post + som innehåller frasen "open access and science". En närhets-sökning + tillåter att termerna inte är i exakt ordning och kan inkludera andra termer + emellan. Grad av flexibilitet specificeras av ett heltal därefter: +

+

+ Exempel: + "open science"~5 +

+

Wildcard-tecken

+

+ Du kan använda wildcard-tecken i söktermer för att ersätta ett enda tecken (med + ? operatorn) eller noll eller fler tecken (med + * operatorn). +

+

+ Exempel: + ope? scien* +

+

+ Wildcard-sökningar kan vara långsamma och bör normalt undvikas om möjligt. +

+
+{%- endblock page_body%} diff --git a/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/statistics.sv.html b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/statistics.sv.html new file mode 100644 index 000000000..0ec44ac98 --- /dev/null +++ b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/statistics.sv.html @@ -0,0 +1,196 @@ +{# + Copyright (C) 2021-2023 CERN. + Copyright (C) 2024 KTH Royal Institute of Technology. + + Invenio App RDM är fri programvara; du kan återdistribuera och/eller modifiera den + enligt villkoren i MIT-licensen; se LICENSE-filen för mer information. +#} +{%- set title = _("FAQ statistics") %} +{%- extends config.BASE_TEMPLATE %} + +{%- block page_body %} +
+
+
+

Statistik

+

+
+
+

+

Vad spårar ni?

+

+

Vi spårar två typer av händelser:

+
    +
  1. Besök på en post-sida.
  2. +
  3. Nedladdningar av en fil.
  4. +
+

För båda typer av händelser spårar vi:

+
    +
  1. + Besökare: + Ett anonymiserat besökar-ID. +
  2. +
  3. + Besökartyp: + Om förfrågan gjordes av a) människa, b) maskin eller c) robot. +
  4. +
  5. + Land: + Ursprungsland för förfrågan (baserat på IP-adress). +
  6. +
  7. + Referens: + Domän från vilken besökaren kom. +
  8. +
+

+

+ Vad är en + visning + ? +

+

+

En användare (människa eller maskin) som besöker en post, exklusive dubbelklick och robotar.

+

+

+ Vad är en + unik visning + ? +

+

+

+ En + unik visning + definieras som ett eller flera besök av en användare inom ett tidsfönster på 1 timme. Detta innebär att om samma + post besöks flera gånger av samma användare inom samma tidsfönster räknas det som en unik visning. +

+

+

+ Vad är en + nedladdning + ? +

+

+

En användare (människa eller maskin) som laddar ner en fil från en post, exklusive dubbelklick och robotar. Om en + post har flera filer och du laddar ner alla filer, räknas varje fil som en nedladdning.

+

+

+ Vad är en + unik nedladdning + ? +

+

+

+ En + unik nedladdning + definieras som en eller flera nedladdningar från filer i en post av en användare inom ett tidsfönster på 1 timme. + Detta innebär att om en eller flera filer från samma post laddas ner flera gånger av samma användare inom samma + tidsfönster räknas det som en unik nedladdning. +

+

+

+ Vad är + nedladdad datavolym + ? +

+

+

Den totala datavolym som har laddats ner för alla filer i en post av en användare (människa eller maskin), + exklusive dubbelklick och robotar. Om en användare avbryter en nedladdning mitt i, räknar vi ändå hela filstorleken + som fullt nedladdad.

+

Hur hanterar ni versioner?

+

+

Som standard visar vi de sammanlagda räkningarna av visningar, nedladdningar och datavolymer för alla versioner av + en post. Du kan även expandera användningsstatistikrutan på en postsida för att se räkningarna för den specifika + versionen.

+

+

Hur hanterar ni robotar?

+

+

+ Förfrågningar från robotar (även kallade crawlers, spindlar, bots) filtreras bort från användningsstatistiken. Vi + identifierar robotar baserat på en standardiserad lista från projekten + COUNTER + och + Making Data Count. +

+

+

Hur ofta uppdateras användningsstatistiken?

+

+

En gång om dagen.

+

+

Hur kan jag se de mest visade posterna?

+

+

+ Vid sökningar på {{ config.THEME_SITENAME }} kan du sortera sökresultaten efter " + mest visade + ". +

+

+

Hur spårar ni?

+

+

+ Vi följer + COUNTER Code of Practice + samt + Code of Practice for Research Data Usage Metrics + i vår spårning. Detta innebär att vår användningsstatistik kan jämföras med andra COUNTER-kompatibla arkiv. +

+
+
+

+

Vad är skillnaden mellan en maskin och en robot?

+

+

+ En + maskinförfrågan + är en automatiserad förfrågan initierad av en mänsklig användare, t.ex. ett skript som laddar ner data från {{ + config.THEME_SITENAME }} och kör en analys på datan. En + robotförfrågan + är en automatiserad förfrågan gjord av t.ex. en sökmotorcrawler. +

+

+

Hur anonymiserar ni användare?

+

+

För varje visnings-/nedladdningshändelse spårar vi ett anonymiserat besökar-ID. Detta anonymiserade besökar-ID + ändras för en användare varje 24 timmar, så en användare som ser samma post två olika dagar får två olika + anonymiserade besökar-ID. Syftet med att spåra ett anonymiserat besökar-ID är att kunna räkna unika visningar och + nedladdningar.

+

+ Av säkerhetsskäl behåller vi även en webbserverlogg som inkluderar din + IP-adress + och din webbläsares + user agent + -sträng. Denna logg raderas automatiskt efter högst ett år och är strikt separerad från användningsstatistikinsamlingen. +

+

Det anonymiserade besökar-ID genereras från en personlig identifierare, såsom:

+
    +
  1. ett användar-ID (t.ex. om du är inloggad på zenodo.org),
  2. +
  3. ett sessions-ID,
  4. +
  5. eller en IP-adress och din webbläsares user agent-sträng.
  6. +
+

+ Vi kombinerar den personliga identifieraren med ett slumpmässigt textvärde (en salt) och tillämpar en envägs + kryptografisk hash-funktion + för att kryptera datan. Salten (slumpvärdet) kastas bort och genereras om var 24:e timme. Genom att använda och + sedan kasta bort den slumpmässiga salten säkerställs att det anonymiserade besökar-ID är helt slumpmässigt. +

+

+

Kan jag välja bort att bli spårad i användningsstatistiken?

+

+

Nej, det är inte möjligt att välja bort. Spårningen för användningsstatistik är fullt anonymiserad och sker på + serversidan.

+

+

Stödjer ni användningsstatistik för en community?

+

+

Inte än, men vi kommer att lägga till aggregerad användningsstatistik för era communities.

+

+

Spårar ni mina sökningar?

+

+

Nej.

+

+

Gör ni någon manuell eller automatisk profilering av användare?

+

+

Nej.

+
+
+
+{% endblock page_body %} diff --git a/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/versioning.sv.html b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/versioning.sv.html new file mode 100644 index 000000000..e67a53dd5 --- /dev/null +++ b/invenio_app_rdm/theme/templates/semantic-ui/invenio_app_rdm/help/versioning.sv.html @@ -0,0 +1,143 @@ +{# + Copyright (C) 2021-2023 CERN. + Copyright (C) 2024 KTH Royal Institute of Technology. + + Invenio App RDM is free software; you can redistribute it and/or modify it + under the terms of the MIT License; see LICENSE file for more details. +#} +{%- set title = _("FAQ versioning") %} +{%- extends config.BASE_TEMPLATE %} + +{%- block page_body %} +
+
+
+

DOI-versionering

+
+
+
+

Vad är DOI-versionering?

+
+

DOI-versionering tillåter dig att:

+
    +
  • redigera/uppdatera postens filer efter att de har publicerats.
  • +
  • citera en specifik version av en post.
  • +
  • citera alla versioner av en post.
  • +
+
+

Hur fungerar DOI-versionering?

+
+

+ När du publicerar en uppladdning för första gången registrerar vi två DOI:er: +

+
    +
  • + en DOI som representerar den specifika versionen av din post. +
  • +
  • + en DOI som representerar alla versioner av din post. +
  • +
+

Därefter registrerar vi en DOI för varje ny version av din uppladdning.

+

+ Detta illustreras bäst med ett exempel på ett mjukvarupaket. Om mjukvaran har + släppts i två versioner (v1.0 och v1.1), så skulle följande DOI:er ha registrerats: +

+
    +
  • v1.0 (specifik version): 10.1234/7s0da-05p39
  • +
  • v1.1 (specifik version): 10.1234/chc5z-w0r30
  • +
  • Koncept (alla versioner): 10.1234/3s67k-pd636
  • +
+

+ De första två DOI:erna för versionerna v1.0 och + v.1.1 representerar de specifika versionerna av mjukvaran. + Den sista DOI:en representerar alla versioner av den aktuella mjukvaran, dvs. + konceptet för mjukvarupaketet och alla dess versioner. Vi kallar dem därför + Versions-DOI:er och Koncept-DOI:er + (tekniskt sett är båda vanliga DOI:er). +

+

+ Du kanske märker att versions-DOI:erna inte innehåller ett ".v1"-suffix. Läs + nedan för att förstå varför. +

+
+

Vilken DOI ska jag använda i citationer?

+
+

+ Du bör normalt alltid använda DOI för den + specifika versionen av din post i citationer. Detta för att + säkerställa att andra forskare kan få tillgång till exakt det + forskningsartefakt som du använde för reproducerbarhet. Som + standard använder vi den specifika versionen för att generera citationer. +

+

+ Du kan använda Koncept-DOI:en som representerar alla versioner i citationer när det + är lämpligt att citera en utvecklande forskningsartefakt utan att vara specifik + om versionen. +

+
+

Var leder Koncept-DOI:en?

+
+

+ Koncept-DOI:en leder till landningssidan för den senaste versionen av din post. +

+
+
+
+

+ Jag vill bara ändra titeln på min uppladdning, får jag fortfarande en ny DOI? +

+
+

+ Nej, du kan fortsätta redigera metadata för din uppladdning utan att skapa en ny version + av en post. Du bör endast skapa en ny version om du vill uppdatera filerna i din post. +

+ +
+

Varför har DOI:erna inte ett versionssuffix som ".v1"?

+
+

+ Att inkludera semantisk information som versionsnummer i en DOI är dålig praxis, + eftersom denna information kan ändras över tid medan DOI:er måste förbli + beständiga och inte får ändras. +

+

+ Dessutom är DOI-versionering linjär, vilket innebär att versionsnumret kanske + inte är det verkliga versionsnumret för resursen. Ta till exempel mjukvara där + det är vanligt med punktversioner och att göra nya släpp i en icke-linjär ordning + (t.ex. först v1.0, sedan v1.1, sedan v2.0, sedan v1.2). +

+

+ Versionssuffixet är heller inte en funktion i DOI-systemet, dvs. att lägga till .v2 + till en DOI kommer inte att leda till version 2 av en resurs för någon DOI från + någon leverantör. Olika leverantörer använder också olika mönster såsom t.ex. .v2, + .2, /2. +

+

+ Viktigast av allt, versionssuffix är inte maskinläsbara. Ett upptäcktsystem som + förstår DOI:er kommer inte att veta att .v1 och .v2 av en DOI faktiskt är två + versioner av samma resurs. +

+

+ En bättre lösning på detta problem är att semantiskt länka två DOI:er i metadata + för en DOI. Detta säkerställer att upptäcktsystem har ett maskinläsbart sätt att + upptäcka att två DOI:er är versioner av samma resurs. +

+

+ Se även Coola DOI:er för + ytterligare information. +

+ +
+

Duplicerar ni alla filer för varje ny version av en post?

+
+

+ Nej, om du ändrar en README-fil på 10 kb i ett dataset på 50 GB duplicerar vi + inte hela datasetet på 50 GB. InvenioRDM, den underliggande tekniska + plattformen, hanterar fil-lagringen effektivt så att vi bara lagrar de nya + extra 10 kb. +

+
+
+
+{% endblock page_body %}