- Hjem
- Onewebmedia
- Norsokdoc
- TemaSearch for HTML-skjemaer
Oversikt
Alt som kreves for å legge til TemaSearch i et eksisterende søkeskjema, er noen endringer i skjemaets HTML-kode. Endringene er enkle, men de krever grunnleggende forståelse av HTML, spesielt HTML-skjemaer.
Før du begynner, trenger du
- Et TemaSearch-brukernavn og en TemaSearch-URL, som du får fra Nynodata når du abonnerer på TemaSearch-tjenesten.
- Tilgang til å endre den eksisterende HTML-siden hvor søkefeltet finnes. (Hvis du ikke ønsker å endre HTML på nettstedet ditt, kan du fortsatt teste TemaSearch, som beskrevet i FAQ.
Tekniske krav
TemaSearch har noen tekniske krav som søkemotoren din må oppfylle:
- Skjemaet må bruke GET metoden for å sende til serveren.
Hvis skjemaet ditt derimot bruker POST, kan du fortsatt være i stand til å bruke TemaSearch, da søkemotorer som bruker POST ofte også støtter GET. For å se om søkemotoren din støtter GET, endre skjemaets metode til GET, og prøv det ut. Hvis det fungerer som normalt, kan du fortsette å legge til TemaSearch på nettstedet ditt. Hvis det ikke fungerer, kontakt oss så kan vi diskutere alternative løsninger.
- Søkemotoren din kan søke etter mer enn ett ord om gangen, og kan returnere dokumenter som inneholder noen av ordene (det er ikke nødvendig at dokumentene inneholder alle ordene.) Dette uttrykkes vanligvis ved hjelp av “ELLER”, selv om søkemotoren din kan bruke noe annet syntaks. Hvis spørringssyntaksen som brukes av søkemotoren din ikke er en av de støttede syntaksene, vennligst kontakt oss.
Legge til TemaSearch til nettstedet ditt
Koden nedenfor viser et eksempel på søkeskjema
<FORM method=GET action="/search">
<INPUT type="text" name="q" size="30" value="">
<INPUT type="submit" name="submit" VALUE="Søk">
</FORM>
For å aktivere TemaSearch, legger du til et lite antall skjulte inndataverdier (eller, parametere, for kort) til skjemaet. Hver parameter har et navn og en verdi, og er skrevet som et nytt INPUT element. For eksempel, koden nedenfor legger til en parameter “pq” med verdien “boolean”.
<INPUT type="hidden" name="pq" value="boolean">
Du må legge til minst disse parameterne som vist i tabellen under. (Du kan klikke på parameternavnet for å hoppe til delen som gir detaljer om den parameteren.)
| puser | ditt TemaSearch-brukernavn. |
| pu | søkemotorens URL – dette er vanligvis det samme som den opprinnelige handlingsattributten, fullt kvalifisert om nødvendig. |
| pq | navnet på feltet som inneholder søkeuttrykket. TemaSearch endrer feltet for å inkludere nye søkeord. |
| px | listar alle feltene som ble lagt til for TemaSearch slik at de ikke videresendes til mål søkemotor. |
| pqsntx | beskriver hvordan forespørslene skrives for søkemotoren din. |
Hvis vi antar at eksempel skjemaet er vert på http://www.myhost.com/search, at vårt brukernavn er “jsmith”, og at den “standard” spørringssyntaksen brukes, så vil vi legge til disse parameterne:
| puser | jsmith |
| pu | http://www.myhost.com/search |
| px | px pu puser pq pqsntx |
| pqsntx | standard |
| pq | q |
Skriver disse parameterne som skjulte inndataverdier, ser eksempel skjemaet slik ut (nye eller endrede deler vist i fet skrift.)
<FORM method=GET action="search">
<INPUT type="hidden" name="puser" value="jsmith">
<INPUT type="hidden" name="pu" value="http://www.myhost.com/search">
<INPUT type="hidden" name="px" value="pu px pq pqsntx puser">
<INPUT type="hidden" name="pq" value="q">
<INPUT type="hidden" name="pqsntx" value="standard">
<INPUT type="text" name="q" size="30" value="">
<INPUT type="submit" name="submit" VALUE="Søk">
</FORM>
Merk:
- Rekkefølgen parameterne opptrer i skjemaet er ikke viktig; alt som kreves, er at de vises mellom <form> og </form>-taggene.
- Den pu verdien er den fullstendige URL-en til søkemålssiden. Normalt vil handlingsattributten indikere URL-en til søkesultatene, selv om dette kan måtte være fullt kvalifisert ved å legge til “http://” og så domenenavnet til serveren din, hvis det ikke allerede er til stede. I eksemplet var handlingsattributten /search, som vises fullt kvalifisert som http://www.myhost.com/search i pu-inndataverdien.
- Hvis skjemaet ditt allerede inkluderer et felt med samme navn som en av TemaSearch-feltene, se avsnittet omdøpe konfliktfylte parametre.
Nå som parameterne har blitt lagt til, er det siste steget å endre handlingsattributten til TemaSearch-URL-en du ble gitt med kontoen din. For eksempel, hvis TemaSearch-URL-en du får er http://www.tema-search.no/form, så endres forms-tags fra
<FORM method=GET action="search">
til
<FORM metode=GET action=“http://www.tema-search.no/form”>
Og det er det! Når du har lagret siden til nettstedet ditt, vil TemaSearch være aktivert på søkefeltet. Hvis du har andre søkefelt på nettstedet ditt, kan du legge til tema-søk på hver av dem ved å gjenta disse trinnene for de andre feltene. (Hvis disse feltene bruker en annen mål-URL, må de registreres med kontoen din. Se avsnittet om sikkerhet for detaljer.
Avanserte alternativer
TemaSearch tilbyr en rekke konfigurasjonsalternativer som du kan bruke for å kontrollere nøyaktig hvilke typer alternative ord som genereres
| povs | inkluderer/utlukk bokmål/nynorsk oversettelser |
| psynn | inkluderer/utlukk nære synonymer |
| pifl | inkluderer/uteslutter ekvivalente bøyninger |
| penab | slår TemaSearch på eller av. |
Som standard er alle disse valgene aktive, så den modifiserte forespørselen vil inkludere oversettelser, synonymer og bøyninger der det er hensiktsmessig. En rekke andre parametere er tilgjengelige for mer presist å konfigurere TemaSearch, se Parameteroversikt.
Ikke alle kontoer inkluderer tilgang til avanserte alternativer. Vennligst sjekk kontodetaljene dine for å sikre at du har tilgang.Administrator Konfigurasjon
En nettstedadministrator kan kontrollere oppførselen til TemaSearch ved å gi faste verdier for TemaSearch-parametre. Hver parameter konfigureres ved å legge til et skjult felt i skjemaet, på samme måte som de standardparametrene ble lagt til tidligere.
For eksempel, for kun å inkludere oversettelser, (dvs. ekskludere synonymer og bøyninger), psynn og pifl legges det til parametre i skjemaet:
<INPUT type="hidden" name="psynn" value="0">
<INPUT type="hidden" name="pinf" value="0">
Når du nå bruker søkesiden din, vil du se at TemaSearch legger til oversettelser, men ikke synonymer eller alternative bøyninger.
Bruker Konfigurasjon
Det er mulig å gi nettstedbrukere kontroll over typene resultater som produseres, slik at de kan tilpasse TemaSearch til sine egne behov. Dette oppnås ved å bruke FORM-inndatakomponenter, som avkrysningsbokser, listenheter osv. for å gi parameterverdier.
For eksempel, for å la brukeren aktivere eller deaktivere bruk av oversettelser, legger du til
<INPUT type="checkbox" name="povs" value="1" CHECKED>
(Ikke glem selvfølgelig å oppdatere px parameteren.) Når den vises i en nettleser, inkluderer skjemaet en avkrysningsboks som kontrollerer bruken av oversettelser i TemaSearch. ATtributtet CHECKED betyr at det er krysset av som standard og at oversettelser er aktive med mindre brukeren spesifikt slår dem av ved å fjerne krysset. De andre av/på-stil parameterne, som psynn, pifl og penab kan også kontrolleres på denne måten.
Parameteroversikt
Denne seksjonen gir en referanse for alle formparametrene som brukes av TemaSearch.
Obligatoriske parametre er parametre som ikke har en standardverdi. Slikke parametre må defineres, eller forespørselen vil feile med en feilmelding som indikerer den manglende parameteren.
‘paltlic’ parameter
| Oppsummering | Endrer alternativer for å overholde lisensierte funksjoner. | ||||
| Detaljer | Hvis et alternativ velges for en funksjon som ikke er lisensiert, produseres vanligvis en feilmelding. (Resultatet av feilen avhenger av pnoerr parameteren, men i det minste vil ingen alternativer bli lagt til spørsmålet. Å sette denne parameteren lar søket fortsette med de funksjoner som er lisensiert, og ignorere forespørselen om ikke-lisensierte funksjoner. I et produksjonsmiljø ville du typisk sette denne verdien til true slik at forsøk på bruk av ikke-lisensierte funksjoner ikke hindrer TemaSearch fra å bli brukt for de funksjonene som er lisensiert. I utvikling kan det å sette denne verdien til false hjelpe med å avdekke at noen funksjoner ikke fungerer fordi de er ikke-lisensierte. | ||||
| Verdier |
| ||||
| Standard | true |
‘pbase’ parameter
| Oppsummering | Legger til grunnformen av en bøyd form. | ||||
| Detaljer | Når forespørselen inkluderer et bøyd ord, legges den ikke-bøyde formen av det ordet til i forespørselen. Hvis stemming er aktivt, har denne parameteren ingen effekt. | ||||
| Verdier |
| ||||
| Standard | 0 |
‘pcharset’-parameter
| Oppsummering | Indikerer tegnsettet som forventes av søkemotoren. | ||||
| Detaljer | Dette er vanligvis det samme som tegnsettet definert av META-taggen. For eksempel <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> Dette definerer tegnsettet som “utf-8”, så pcharset bør settes til “UTF-8”. | ||||
| Verdier |
| ||||
| Standard | ISO-8859-1 |
‘penab’-parameter
| Oppsummering | Aktiverer eller deaktiverer TemaSearch. | ||||
| Verdier |
| ||||
| Standard | 1 |
‘pifl’-parameter
| Oppsummering | Inkluderer alternative bøyninger. | ||||
| Verdier |
| ||||
| Standard | 1 |
‘plangin’-parameter
| Oppsummering | Gir et hint om språket som brukeren bruker for å skrive inn søkespørsmålet. | ||||||
| Detaljer | Når søkespørsmålet kan være både bokmål og nynorsk, angis språket TemaSearch antar ved denne parameteren. Vær oppmerksom på at hvis språket i innholdet ikke er tvetydig, har ikke denne parameteren effekt. Denne parameteren er nyttig hvis brukerbasen er sterkt skjev mot ett språk eller det andre. | ||||||
| Verdier |
| ||||||
| Standard | (Tom streng) |
‘plangout’-parameter
| Oppsummering | Velger språket for nye ord som legges til søkespørsmålet. | ||||||
| Detaljer | Denne parameteren settes vanligvis hvis dokumentene som søkes er skrevet på samme språk. Å sette denne parameteren til det språket sikrer at den omskrevne forespørselen kun inneholder ord på det språket. Hvis dokumentene som søkes består av en blanding av språk, bør denne parameteren ikke settes, så alle relevante språk er inkludert. Selv om det ligner, er dette ikke det samme som å deaktivere oversettelse. For eksempel, anta at utgangsspråket er satt til bokmål. En nynorsk bruker vil fortsatt kreve oversettelse (til bokmål) mens en bokmål bruker ikke vil. Så, oversettelse brukes hvis den teksten brukeren skriver trenger oversettelse til utgangsspråket. | ||||||
| Verdier |
| ||||||
| Standard | (Tom streng) |
‘plemifl’-parameter
| Oppsummering | Legger til alle bøyninger av et ikke-bøyd ord. | ||||
| Detaljer | Hvis forespørselen inkluderer et ikke-bøyde ord, legges deretter bøyninger av det ordet til forespørselen. Bøyd former blir produsert selv om stemming er aktivpstem=1), selv om du vanligvis ikke vil aktivere denne parameteren hvis stemming er aktiv. | ||||
| Verdier |
| ||||
| Standard | 0 |
‘pmax1’-parameter
| Oppsummering | Begrenser det totale antallet ord som er inkludert i spørringen. | ||||
| Detaljer | Dette er nyttig for å holde det totale antallet ord på et rimelig nivå, spesielt når søkemotoren aksepterer opptil et spesifikt maksimalt antall ord. Ofte, hvis antall ord overstiger denne grensen, blir de ekstra ordene ignorert, noe som kan føre til at viktige ord i spørringen blir droppet. Når TemaSearch kan gi flere ord enn det er plass til, forkaster det de minst relevante ordene for å sikre at alle de originale ordene og de «beste» alternativene er inkludert i spørringen, uten å overskride totalordgrensen. | ||||
| Verdier |
| ||||
| Standard | -1 |
‘pmax2’-parameter
| Oppsummering | Begrenser antallet ord som TemaSearch legger til hvert ord i spørringen. | ||||
| Detaljer | Hvis mange alternativer er valgt, som både oversettelser og synonymer, kan noen ord ha et stort antall mulige alternativer. I noen tilfeller kan et stort antall alternativer gjøre søket mindre presist. Å sette denne verdien til et lavere tall kan bidra til å opprettholde en høy søkepresisjon. Når det er flere alternativer for et gitt ord enn det som er tillatt av denne parameteren, blir de minst relevante ordene forkastet inntil antallet alternative ord er innen denne grensen. | ||||
| Verdier |
| ||||
| Standard | 4 |
‘pnoerr’-parameter
| Oppsummering | Kontrollerer feilmeldinger. | ||||
| Detaljer | Denne parameteren er ment som et utviklingsverktøy. Når du setter opp TemaSearch eller gjør endringer i konfigurasjonen din, er det lurt å aktivere feilmeldinger ved å enten fjerne denne parameteren eller sette den til “0”. Hvis det er problemer med noen av parameterne, vises disse problemene i stedet for søkeresultatene, slik at du kan fikse dem. Når du har testet at TemaSearch fungerer som ønsket, kan du deaktivere feilmeldinger. Dette vil sikre at brukerne dine ikke blir forstyrret ved eventuelle feil under bruk av TemaSearch. | ||||
| Verdier |
| ||||
| Standard | 0 |
‘povs’-parameter
| Oppsummering | Inkluderer oversettelser (nynorsk eller bokmål). | ||||
| Verdier |
| ||||
| Standard | 1 |
‘pq’-parameter
| Oppsummering | Navnet på parameteren i originalform som inneholder søkespørsmålet. |
| Detaljer | Dette tilsvarer vanligvis et inndatafelt av typen “tekst”. |
‘pqsntx’-parameter
| Oppsummering | Angir hvordan søkemotoren forventer at spørringen skal skrives. | ||||||||||||||
| Detaljer | Dette brukes av TemaSearch for å sikre at nye ord kan legges til på en måte som er kompatibel med søkemotoren. Velg en syntaks som mest mulig nærmer seg funksjonene til søkemotoren din. De viktigste funksjonene er hvordan søkemotoren forventer at obligatoriske og alternative ord skal skrives. Hvis en syntaks inkluderer trekk som ikke er tilgjengelige med søkemotoren din, er ikke det et problem. Funksjonene indikerer at TemaSearch vil forstå at funksjonen skal brukes av en bruker med en spørring. TemaSearch endrer kun spørringen ved hjelp av boolsk OR-operatoren, i den form den er skrevet for søkemotoren din. Alle syntaksene tillater bruk av prefikser + og – for spesifikt å inkludere eller ekskludere ord. Temasearch gir ikke alternativer for disse ordene. | ||||||||||||||
| Verdier |
|
‘pstem’-parameter
| Oppsummering | Kontrollerer stemming. | ||||
| Detaljer | Et bøyd ord (for eksempel et flertalls substantiv eller et verb i fortid) genererer alternative ord som er lignende bøyd. Noen søkemotorer søker automatisk etter bøyninger av et ord, og derfor er det lite behov for å inkludere alternative ord som bøyninger, da den ikke-bøyde formen er tilstrekkelig. Bruken av stemming med søkemotorer som ikke søker etter bøyninger, det vil si motorer som utfører et eksakt treff, kan bidra til å redusere antallet søkeord for et mer fokusert resultat. | ||||
| Verdier |
| ||||
| Standard | 0 |
‘psyng’-parameter
| Oppsummering | Inkluderer generelle synonymer. Generelle synonymer er ord som er nært beslektet men ikke alltid identiske i betydning for alle betydninger av det originale ordet. Dette brukes vanligvis for å utvide søket til relaterte områder. | ||||
| Verdier |
| ||||
| Standard | 0 |
‘psynn’-parameter
| Oppsummering | Inkluderer nærsynonymer. Nærsynonymer er ord som er identiske, eller nesten identiske i betydning med det originale ordet. Disse inkluderer for det meste stavevarianter for et gitt ord. | ||||
| Verdier |
| ||||
| Standard | 1 |
‘pu’-parameter
| Oppsummering | Den fullt kvalifiserte URL-en til søkeresultatsiden. |
| Detaljer | Dette er vanligvis det samme som action-attributtet, men denne parameteren må være fullt kvalifisert, så protokoll og servernavn må inkluderes i parameteren hvis de ikke er tilstede i action. |
‘puser’-parameter
| Oppsummering | Navnet på TemaSearch-kontoen som skal brukes for å få tilgang til TemaSearch-tjenester. |
‘px’-parameter
| Oppsummering | Lister alle TemaSearch-parameter lagt til skjemaet. |
| Detaljer | FORM-elementet inneholder parametere for søkemotoren din og parametere for TemaSearch. For at TemaSearch skal kunne lokalisere nødvendig informasjon, må alle TemaSearch-parametere listes i px parameteret, atskilt med et mellomrom. For eksempel, hvis parameterne “pq” og “puser” ble lagt til, så bør “px”-parameteren defineres som “px pq puser” (merk at listen inkluderer px parameteret selv.) Hvis noen av temasearch parametrene må endres for å unngå konflikt med eksisterende parametere, bør den omdøpte parameteren vises i listen. (Se løse parameterkonflikter for detaljer. |
Løse parameternavnkonflikter
TemaSearch-parameterne har blitt valgt for å være ganske uvanlige, slik at de ikke kolliderer med eksisterende parameternavn i skjemaet ditt. Men hvis en TemaSearch-parameter har samme navn som en parameter allerede definert av skjemaet ditt, kan du gi TemaSearch-parameteren nytt navn for å unngå å ha to parametre med samme navn. Omdøpingen skjer ved å legge til et underbindestrek ‘_’ foran navnet.
For eksempel, hvis parameteren “puser” allerede ble brukt av skjemaet ditt, bør TemaSearch-parameteren omdøpes til “_puser”.
Den px parameteren lister alle TemaSearch-parametrene som er lagt til skjemaet, og inkluderer hver parameter ved å bruke navnet slik det vises i skjemaet. For eksempel, etter omdøping, puserer px parameteren definert slik
<INPUT type="hidden" name="_puser" value="jsmith">
<INPUT type="hidden" name="px" value="pu px pq pqsntx _puser">
Vanlige spørsmål
Generelt
| Q. | Jeg har ikke tilgang/ønsker ikke å endre det nåværende skjemaet på vår webserver, men jeg vil likevel gjerne prøve TemaSearch. Er dette mulig? |
| A. | Ja! Du kan fortsatt vurdere TemaSearch selv om du ikke har tillatelse eller ikke ønsker å endre søkesiden på ditt nåværende nettsted.
|
| Q. | Vil bruken av TeamSearch påvirke ytelsen til nettstedet mitt? |
| A. | Vår erfaring viser at tillegget av TemaSearch til et nettsted medfører en forsinkelse på omtrent 100 millisekunder, eller 1/10 av et sekund. I praksis, når det legges til alle de andre forsinkelsene til stede på nettet, er denne forsinkelsen praktisk talt umerkelig. DetaljerEtter integrering av TemaSearch kan den ekstra tiden som kreves for å produsere søkresultater tilskrives
For å sikre at nettverksforsinkelsen er minimal, har vi som mål å gi deg tilgang til en TemaSearch-server som er geografisk nær din egen server, noe som resulterer i raskere tilgangstid. Typisk nettverksforsinkelse er rundt 20-50 millisekunder. Tiden som kreves av TemaSearch for å behandle en forespørsel og omskrive et spørsmål er i størrelsesorden 1-10 ms. De ekstra ordene som legges til søkeforespørselen kan øke tiden som kreves av din søkemotor. Den nøyaktige økningen vil avhenge av effektiviteten til søkemotoren du bruker. De fleste "verdensklasse" søkemotorer bruker svært effektive implementeringer som resulterer i ingen merkbar økning i prosesseringstid (typisk noen titalls millisekunder). Når man legger sammen alle disse forsinkelsene, gir det en total forsinkelse på rundt 100 ms. |
| Q. | For ord som bøyes, legger TemaSearch til alternativer som også er bøyd. Hvordan produseres disse tilsvarende bøyningene? |
| A. | TemaSearch inkorporerer full morfologisk analyse og syntese for både Bokmål og Nynorsk. Det vil si at bøyningsdetaljer blir opprettholdt for hvert enkelt ord i systemet. Bøyningene produseres basert på den grammatiske kategorien som beskriver bøyningen, og sikrer at korrekt tilsvarende bøyning blir produsert, selv når det originale ordet og alternative ord er fra forskjellige språk, eller når endringer er nødvendige, slik som å doble en siste konsonant. Dette står i kontrast til enklere systemer som kopierer bøyningsendelsen fra det opprinnelige ordet til alternativet, eller bruker generaliserte regler for å gjette den riktige bøyningen. Begge disse systemene produserer vanligvis flere feil bøyninger enn tilnærmingen brukt av TemaSearch. |
Sikkerhet
| Q. | TemaSearch-parametrene inkluderer mitt kontonavn (brukernavn) som er synlig for alle som ser kilden til HTML for søkeskjemaet. Hva er det som forhindrer noen andre fra å bruke temasearch på min konto? |
| A. | Hver gang TemaSearch brukes, dirigeres nettleseren til en side med søkresultater for å vise de faktiske søkresultatene. TemaSearch vil kun dirigere til sider registrert med kontoen din. Dette forhindrer at kontoen din brukes til å vise resultater fra noen andres nettsted. I tillegg blir siden brukeren besøkte for å starte TemaSearch også kontrollert mot sider registrert på kontoen. Hvis sidene ikke samsvarer med noen registrerte sider på kontoen din, vil ikke TemaSearch aktiveres, og ingen bruk registreres mot kontoen din. |
| Q. | Til tross for disse sikkerhetstiltakene, hva skal jeg gjøre hvis jeg tror kontoen min brukes uten tillatelse? |
| A. | Kontakt oss så snart som mulig, og vi vil undersøke saken umiddelbart. Alle kontotilgangene loggføres, sammen med brukerens IP, noe som kan hjelpe med å spore uautorisert bruk. |
Feilsøking
| Q. | Hvorfor får jeg feilmeldingen “parameter ‘XX’ ikke definert”, selv om jeg har inkludert den i skjemaet? |
| A. | Dette skjer når parameteren ikke er oppført i den px parameterlisten. Sørg for at px parameteren er definert og at den inkluderer den manglende parameteren i listen over TemaSearch-parametere. |
| Q. | Hvorfor får jeg rare tegn som vises i det konverterte spørsmålet? |
| A. | Dette skyldes vanligvis en forskjell i tegnkodingene som brukes av siden på ditt nettsted og søkemotoren. Sjekk at pcharset parameteren er satt til kodingen som forventes av din søkemotor. |
| Q. | Jeg prøver å bruke avanserte alternativer, men det fungerer ikke, jeg får fortsatt alternativene aktivert som jeg ønsker å deaktivere. Hva skjer? |
| A. | Du vet at de avanserte alternativene ikke fungerer fordi du fortsatt får alle de forskjellige typer alternative ord. Du kan sjekke
|
| Q. | Jeg har gjort alle de nødvendige endringene, men TemaSearch fungerer fremdeles ikke. |
| A. | Hvis du bruker pnoerr parameteren, sett denne til 0 for å sikre at alle problemer vises i stedet for å bli stille oversett. Når du legger inn et nytt søk, bør du se en feilmelding som indikerer den sannsynlige årsaken til problemet. |