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 %} +
+ Denna guide förklarar hur man skriver avancerade sökfrågor med hjälp av lättförståeliga exempel. +
+
+ 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
+
+ Exempel:
+ "open science"
+
+ Resultaten kommer att matcha poster som innehåller frasen
+ open science
i något fält.
+
+ 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. +
+
+ 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. +
+
+ 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.:
+
[2017 TO 2018}
är ekvivalent med
+ [2017-01-01 TO 2017-12-31]
på grund av datumutökning och exklusivt övre gräns.
+ Exempel på andra intervall:
+metadata.publication_date:{* TO 2017-01-01}
: Alla dagar fram till 2017.
+ metadata.publication_date:[2017-01-01 TO *]
: Alla dagar från 2017.
+ + 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 ä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. +
+
+ 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)
+
+ 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"
+
+ 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
.
+
+ 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
+
+ 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. +
+Vad spårar ni?
+ +Vi spårar två typer av händelser:
+För båda typer av händelser spårar vi:
++ 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:
++ 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.
+Vad är DOI-versionering?
+ +DOI-versionering tillåter dig att:
+Hur fungerar DOI-versionering?
+ ++ När du publicerar en uppladdning för första gången registrerar vi två DOI:er: +
+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: +
++ 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. +
+