brief: | i18n.site amma barbaacha barruu guutuu sarvarii malee deeggara.

Barreeffamni kun hojiirra oolmaa teeknooloojii barbaacha barreeffama guutuu fuula duraa qulqulluu, indeeksii garagalfame IndexedDBn ijaarame, barbaacha durtii, fooyya'iinsa qoqqoodinsa jechootaa fi deeggarsa afaanota hedduu dabalatee kan seensisudha.

Furmaata jiran waliin wal bira qabamee yoo ilaalamu, barbaacha barreeffama guutuu fuulduraa qulqulluun i18n.site guddinaan xiqqaa fi saffisaa, marsariitiiwwan xixiqqaa fi giddu galeessaa kanneen akka sanadootaa fi biloogiidhaaf kan mijatu yoo ta’u, sarara ala ta’ee argama.

Barbaacha Barreeffama Guutuu Garagalfame Qulqulluu Fuulduraa

Tartiiba

Torban hedduu booda, i18n.site (meeshaa ijaarsa weebsaayitii markdown hiikkaa afaanota hedduu & qulqulluu ta'e) amma barbaacha barreeffama guutuu fuulduraa qulqulluu deeggara.

Barreeffamni kun hojiirra oolmaa teeknikaa i18n.site pure front-end full-text search ni i18n.site .

Koodii madda / :

Gamaaggama Furmaata Barbaacha Barreeffama Guutuu Sarvarii Hin Qabne

Weebsaayitoota xixiqqoo fi giddu galeessaa kanneen qulqulluu ta’an kanneen akka sanadoota/biloogii dhuunfaatiif, duubbee barbaacha barreeffama guutuu ofumaan ijaarame ijaaruun garmalee ulfaataadha, barbaacha barreeffama guutuu tajaajila irraa bilisa ta’e filannoo baay’ee beekamaadha.

Furmaatni barbaacha barreeffama guutuu sarvarii hin qabne gosoota bal’aa lamatti qoodamu:

Tokkoffaa, walfakkaataa algolia.com Dhiyeessitoonni tajaajila barbaacha qaama sadaffaa barbaacha barreeffama guutuuf qaamolee fuulduraa ni kennu.

Tajaajiloonni akkanaa baay'ina barbaacha irratti hundaa'uun kaffaltii kan barbaadan yoo ta'u, yeroo baayyee fayyadamtoota Chaayinaa guddittii keessa jiraniif dhimmoota akka walsimannaa marsariitiitiin kan hin argamnedha.

Toora ala fayyadamuu hin danda'u, intranet irratti fayyadamuu hin danda'u, daangaa guddaa qaba. Barreeffamni kun waan baay’ee irratti hin mari’atu.

Inni lammaffaan barbaacha barreeffama guutuu fuulduraa qulqulluudha.

Yeroo ammaa kana, barbaacha barreeffama guutuu fuula duraa qulqulluu beekamaan lunrjs fi ElasticLunr.js ( lunrjs guddina sadarkaa lammaffaa irratti hundaa'uun) of keessatti qabata.

lunrjs Indeeksii ijaaruuf karaan lama jira, lamaan isaanii iyyuu rakkoo mataa isaanii qabu.

Faayilota indeeksii dursanii ijaaraman
Indeeksii jechoota galmee hunda irraa waan of keessaa qabuuf, guddinaan guddaadha. Yeroo galmeen dabalamu ykn fooyya'u hunda, faayilii indeksii haaraan fe'amuu qaba. Yeroo eegaa fayyadamaa ni dabala, baandii baay'ee ni fayyadama.
Sanadoota fe'uu fi indeeksii balali'aa irratti ijaaruu
Indeeksii ijaaruun hojii shallaggii cimaadha yeroo hunda indeeksii irra deebitee ijaaruun duubatti hafummaa ifa ta'ee fi muuxannoo fayyadamaa gadhee fida.

lunrjs malees, furmaata barbaacha barreeffama guutuu biroo tokko tokko jiru, kan akka :

fusejs , walfakkeenya dhangiiwwan gidduu jiru shallagi.

Gahumsi furmaata kanaa garmalee gadhee waan ta'eef barbaacha barreeffama guutuuf fayyadamuu hin danda'u (ilaali Fuse.js Gaaffiin dheeraan 10 sekondii ol fudhata, akkamitti fooyyessa? ).

TinySearch goo good google

Sababa hanqina furmaata jiruun, i18n.site furmaata barbaacha barreeffama guutuu fuulduraa qulqulluu haaraa, kan amala armaan gadii qabu hojjete :

Barbaacha 25KB hedduu kan lunrjs gzip 6.9KB , guddinaan xiqqaadha.
Indeeksii garagalfame indexedb irratti hundaa'e ijaari, kunis yaadannoo xiqqaa kan fudhatuu fi saffisaa dha.
Yeroo sanadoonni dabalaman/foyya’an, sanadoota dabalaman ykn fooyya’an qofatu irra deebi’amee indeksii ta’a, kunis hamma shallaggii hir’isa.
Barbaacha durtii kan deeggaru yoo ta'u, yeroo fayyadamaan barreessu bu'aa barbaacha yeroo qabatamaa keessatti agarsiisuu danda'a.
Toora irraa ala ni argama

Armaan gaditti ibsi raawwii teeknikaa i18n.site bal’inaan ni dhiyaata.

Qoqqoodinsa Jechootaa Afaan Hedduu

Qoodinsi jechootaa qoqqoodinsa jechootaa dhalootaa biraawzari fayyadama Intl.Segmenter , fi biraawzaroonni ijoo hundi walqunnamtii kana ni deeggaru.

Koodiin jecha qoqqoodinsa coffeescript akka armaan gadiitti argama

SEG = new Intl.Segmenter 0, granularity: "word"

seg = (txt) =>
  r = []
  for {segment} from SEG.segment(txt)
    for i from segment.split('.')
      i = i.trim()
      if i and !'| `'.includes(i) and !/\p{P}/u.test(i)
        r.push i
  r

export default seg

export segqy = (q) =>
  seg q.toLocaleLowerCase()

keessa:

/\p{P}/ ibsa idilee kan mallattoolee addaan kutuu walsimsiisu Mallattoolee walsimsiisaa addaa kanneen akka: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ~. .</p><ul><li> split('.')kan ta'eef sababni isaasFirefoxqoqqoodinsi jechoota biraawzari. ` hin qoodu .

Ijaarsa Indeeksii

Gabateewwan kuusaa wantaa 5 IndexedDB keessatti uumamaniiru :

word jechoota : id -
doc : id - Sanada url - Lakkoofsa version sanada
docWord : Array galmee id - jecha id
prefix : Array durtii - jecha id
rindex : Jecha id - Galmee id : Tarree lakkoofsota sararaa

Tarree galmee url fi lakkoofsa gosa ver keessa darbi, fi galmeen gabatee doc keessatti jiraachuu fi dhiisuu isaa barbaadi.Yoo hin jirre, indeeksii garagalfame uumi. Kanuma waliin, sanadoota hin darbamne sanaaf indeeksii garagalfame haqi.

Haala kanaan indeeksii dabalataa galma gahuun hammi shallaggii hir’achuu danda’a.

Walqunnamtii fuulduraa keessatti, barruu adeemsa fe'iinsaa indeeksii yeroo jalqabaaf fe'amu duubatti hafummaa hambisuuf agarsiifamuu danda'a "Barruu Adeemsa Sochii wajjin, Tokko progress + Hojiirra css qulqulluu irratti hundaa'e" Ingiliffa / Chaayinaa ilaali.

IndexedDB Barreeffama Walfakkaatu Ol'aanaa

Pirojektichi kan idb asynchronous encapsulation of IndexedDB

IndexedDB dubbisuu fi barreessuun walsimsiisaa dha. Yeroo indeksii uumtu, galmeewwan indeeksii uumuuf yeroo tokkotti fe'amu.

Barreeffama dorgommiitiin dhufu gartokkoon deetaa akka hin badneef, koodii coffeescript armaan gadii ilaaluu fi barreeffamoota dorgoman addaan kutuuf dubbisuu fi barreessuu gidduutti kaachota ing dabaluu dandeessa.

pusher = =>
  ing = new Map()
  (table, id, val)=>
    id_set = ing.get(id)
    if id_set
      id_set.add val
      return

    id_set = new Set([val])
    ing.set id, id_set
    pre = await table.get(id)
    li = pre?.li or []

    loop
      to_add = [...id_set]
      li.push(...to_add)
      await table.put({id,li})
      for i from to_add
        id_set.delete i
      if not id_set.size
        ing.delete id
        break
    return

rindexPush = pusher()
prefixPush = pusher()

Sirrummaa Fi Yaadannoo

Barbaacha jalqaba jechoota ijoo fayyadamaan galche ni qooda.

Jechoonni qoqqoodinsa jechootaa booda jechootni N akka jiran haa fudhannu Yeroo bu'aa deebistu, bu'aan jechoota furtuu hunda of keessaa qabu dursee ni deebi'a, sana booda bu'aan jechoota furtuu N-1 , N-2 ,..., 1 of keessaa qabu ni deebi'a.

Bu'aan barbaacha jalqaba agarsiifame sirrii ta'uu gaaffii mirkaneessa, fi bu'aan booda fe'ame (qaree dabalataa fe'i cuqaasi) saffisa yaadannoo mirkaneessa.

Fe’iinsa Gaaffii Irratti

Saffisa deebii fooyyessuuf, barbaacha fe'iinsa fedhii irratti hojiirra oolchuuf jenereetarii yield fayyadama, fi yeroo bu'aan gaafatamu limit deebi'a.

Hubadhu yeroo hunda yield booda irra deebitee barbaaddu , daldala gaaffii IndexedDB irra deebitee banuun si barbaachisa .

Durtii Barbaacha Yeroo Dhugaa

Bu'aa barbaacha yeroo fayyadamaan barreessu agarsiisuuf, fakkeenyaaf, yeroo wor galfamu, jechoonni wor dursanii kan akka words fi work ni mul'atu.

Keerliin barbaacha jechoota isa duraan durfaman hunda argachuuf jecha isa dhumaatiif gabatee prefix fayyadama.

Faankishiniin farra raafama debounce walqunnamtii fuulduraa keessattis fayyadama (akka armaan gadiitti hojiirra oola) irra deddeebiin galtee fayyadamaa barbaacha kakaasu hir'isuu fi hamma shallaggii hir'isuuf.

export default (wait, func) => {
  var timeout;
  return function(...args) {
    clearTimeout(timeout);
    timeout = setTimeout(func.bind(this, ...args), wait);
  };
}

Toora Irraa Ala Ni Argama

Gabatee indeeksii barruu jalqabaa hin kuusu, jechoota qofa, kunis hamma kuusaa hir'isa.

Bu'aa barbaacha calaqqisiisuun barruu jalqabaa irra deebi'anii fe'uu barbaada, fi service worker walsimsiisuun gaaffii networkii irra deddeebi'amee dhufu hambisuu danda'a.

Kanuma waliin, barruulee hunda service worker waan kuusuuf, fayyadamaan erga barbaacha raawwatee booda, barbaacha dabalatee marsariitiin guutuun sarara ala ni argama.

Agarsiisi Fooyya'iinsa Galmeewwan MarkDown

Furmaanni barbaacha fuulduraa qulqulluu i18n.site 's galmeewwan MarkDown kan mijatedha.

Yeroo bu'aa barbaacha agarsiisu, maqaan boqonnaa ni mul'ata, boqonnaan immoo yeroo cuqaafamu ni qajeela.

Cuunfaa

Barbaacha barruu guutuu garagalfame qulqulluu fuulduraa irratti hojiirra oole, sarvariin hin barbaachisu. Marsariitiiwwan xixiqqaa fi giddu galeessaa kanneen akka sanadootaa fi biloogii dhuunfaatiif baay’ee mijataadha.

i18n.site Barbaacha fuula duraa qulqulluu ofumaan qopheesse madda banaa, guddinaan xiqqaa fi deebii saffisaa, hanqina barbaacha barreeffama guutuu fuula duraa qulqulluu ammaa furuu fi muuxannoo fayyadamaa fooyya’aa ta’e kenna.