brief: | i18n.site naha lêgerîna tev-nivîsê ya bê server piştgirî dike.

Ev gotar pêkanîna teknolojiya lêgerîna tev-nivîsê ya paqij-paqij, di nav de pêveka berevajîkirî ya ku ji hêla IndexedDB ve hatî çêkirin, lêgerîna pêşgir, xweşbînkirina dabeşkirina peyvan û piştgiriya pirzimanî vedihewîne.

Li gorî çareseriyên heyî, lêgerîna tev-nivîsê ya paşîn a i18n.site bi mezinahî piçûk û bilez e, ji bo malperên piçûk û navîn ên wekî belge û blogan guncan e, û offline heye.

Lêgerîna Tev-Nivîsê Ya Berevajîkirî Ya Paqij

Dor

Piştî çend & pêşkeftinê markdown i18n.site

Ev gotar dê pêkanîna teknîkî ya i18n.site -paqij-lêgerîna tev-nivîsê parve bike i18n.site ku bandora lêgerînê biceribîne.

Koda çavkaniya : kernel / înteraktîf bigere

Awirek Li Ser Çareseriyên Lêgerîna Tev-Nivîsarê Yên Bê Server

Ji bo malperên piçûk û navîn ên safî yên statîk ên wekî belge / blogên kesane, avakirina paşnavek lêgerîna tev-nivîsê ya bixwe-çêkirî pir giran e, û lêgerîna tev-nivîsê ya bê karûbar bijareya gelemperî ye.

Çareseriyên lêgerîna tev-nivîsa serverê di du kategoriyên berfireh de cih digirin:

Pêşîn, bi heman algolia.com pêşkêşkerên karûbarê lêgerînê yên sêyemîn ji bo lêgerîna tev-nivîsê hêmanên pêşîn peyda dikin.

Karûbarên bi vî rengî li ser bingeha qebareya lêgerînê drav hewce dike, û bi gelemperî ji ber pirsgirêkên wekî lihevhatina malperê ji bikarhêneran re li axa Chinaînê nayê peyda kirin.

Ew nekare offline were bikar anîn, nikare li ser intranetê were bikar anîn, û xwedan sînorên mezin e. Ev gotar zêde nîqaş nake.

Ya duyemîn lêgerîna tev-nivîsê ya pêşîn-paqij e.

Heya nuha, lêgerînên lunrjs -end-paqij ên ElasticLunr.js ên tev-nivîsê hene lunrjs

lunrjs Du awayên avakirina indexan hene, û her du jî pirsgirêkên xwe hene.

Pelên indexê yên pêş-avakirî
Ji ber ku index peyvên ji hemî belgeyan vedihewîne, ew bi mezinahî mezin e. Dema ku belgeyek tê zêdekirin an guheztin, pêdivî ye ku pelek navnîşek nû were barkirin. Ew ê dema bendewariya bikarhêner zêde bike û pir firehiya bandê dixwe.
Belgeyên barkirin û li ser firînê navnîşan ava bikin
Avakirina îndeksek ji hêla jimartinê ve karekî zexm e. Her gava ku hûn bigihîjin wê ji nû ve avakirina pêvekê dê bibe sedema derengmayînên eşkere û ezmûna xirab a bikarhêner.

Ji bilî lunrjs , hin çareseriyên lêgerîna tev-nivîsê yên din jî hene, wek :

fusejs wekheviya di navbera rêzikên lêgerînê de hesab bikin.

Performansa vê çareseriyê pir kêm e û nikare ji bo lêgerîna tev-nivîsê were bikar anîn (binêre Fuse.js Pirsa dirêj ji 10 çirkeyan zêdetir digire, meriv wê çawa xweşbîn bike? ).

TinySearch ji bo lêgerînê Parzûna Bloom bikar bînin, ji bo lêgerîna pêşgiran nayê bikar anîn (mînak, goo , lêgerîn good , google ), û nikare bandorek temamkirina otomatîkî ya wekhev bi dest bixe.

Ji ber kêmasiyên çareseriyên heyî, i18n.site çareseriyek nû ya pêş-end-paqij a lêgerîna tev-nivîsê ya nû pêşxist, ku xwedan taybetmendiyên jêrîn e :

Piştgiriya lêgerîna pirzimanî dike û bi mezinahiyê piçûk e Mezinahiya kernelê piştî pakkirina gzip 6.9KB e (ji bo berhevdanê, mezinahiya lunrjs 25KB ye).
Indeksek berevajîkirî li ser bingeha indexedb ava bikin, ku kêmtir bîra digire û bilez e.
Dema ku belge têne zêdekirin/guherandin, tenê belgeyên zêdekirî an guheztin ji nû ve têne navnîş kirin, ku hêjmara hesaban kêm dike.
Piştgiriya lêgerîna pêşgiran dike, ku dikare encamên lêgerînê di demek rast de nîşan bide dema ku bikarhêner dinivîse.
Offline Heye

Li jêr, i18n.site hûrguliyên pêkanîna teknîkî dê bi hûrgulî bêne destnîşan kirin.

Dabeşkirina Peyva Pirzimanî

Parçekirina peyvan dabeşkirina peyva xwemalî ya gerokê Intl.Segmenter bikar tîne, û hemî gerokên sereke piştgirî didin vê navberê.

Koda dabeşkirina peyva coffeescript wiha ye

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()

li:

/\p{P}/ birêkûpêkek birêkûpêk e ku nîşaneyên xalbendiyê li hev dike: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } . .</p><ul><li> split('.')ji ber kuFirefoxdabeşkirina peyva gerok.` perçe nake.

Avahiya Indeks

5 tabloyên hilanîna tiştan di IndexedDB de hatin afirandin :

word peyv : id -
doc : id - url - Hejmara guhertoya belgeyê
docWord : belgeya id - peyva id
prefix Rêzeya pêşgira - id :
rindex : id - id :

Di rêza belgeya url û guhertoya jimare ver de derbas bibin, û bigerin ka belge di tabloya doc de heye yan na. Heke ew tune be, pêdekek berevajî biafirînin. Di heman demê de, ji bo wan belgeyên ku di nav wan de derbas nebûne navnîşa berevajîkirî derxînin.

Bi vî rengî, îndekskirina zêdebûyî dikare were bidestxistin û hêjeya hesabkirinê kêm dibe.

Di danûstendina pêşîn de, bara pêşkeftina barkirinê ya pêvekê dikare were xuyang kirin da ku gava yekem car tê barkirin dereng nemîne Binêre "Bara Pêşketinê ya Bi Anîmasyon, Li ser Bingehek Yekane progress + Pure css Pêkanîna" English / Chinese .

IndexedDB Nivîsandina Hevdemî Ya Bilind

Proje li idb bingeha vegirtina asynchronous ya IndexedDB

IndexedDB xwendin û nivîsandin asynkron in. Dema ku navnîşek çêbikin, belge dê hevdem werin barkirin da ku indexê çêbikin.

Ji bo ku hûn ji windabûna daneya qismî ya ku ji hêla nivîsandina pêşbaziyê ve çêdibe dûr nekevin, hûn dikarin koda coffeescript a jêrîn binihêrin û ing cache di navbera xwendin û nivîsandinê de zêde bikin da ku nivîsên pêşbaziyê bişopînin.

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()

Precision Û Recall

Lêgerîn dê pêşî peyvên sereke yên ku ji hêla bikarhêner ve hatî navnîş kirin parçe bike.

Bihesibînin ku piştî dabeşkirina peyvan N peyv hene Dema ku encaman vedigerin, dê pêşî encamên ku hemî peyvên sereke hene werin vegerandin, û paşê encamên ku tê de N-1 , N-2 ,..., 1 peyvên sereke hene.

Encamên lêgerînê yên ku pêşî têne xuyang kirin rastbûna pirsê piştrast dikin, û encamên ku paşê têne barkirin (bişkojka barkirina bêtir bikirtînin) rêjeya bibîrxistinê piştrast dikin.

Li Ser Daxwazê Barkirin

Ji bo baştirkirina leza bersivê, lêgerîn jeneratorê yield bikar tîne da ku barkirina li ser daxwazê bicîh bîne, û limit gava ku encamek tê pirsîn vedigere.

Bala xwe bidinê ku her gava ku hûn dîsa piştî yield digerin, hûn hewce ne ku vekirina danûstendinek pirsê ya IndexedDB ji nû ve vekin.

Pêşgir Lêgerîna Rast-Dem

Ji bo ku dema ku bikarhêner dinivîse encamên lêgerînê nîşan bide, wek nimûne, dema ku wor tête navnîş kirin, peyvên ku bi pêşgira wor wekî words û work têne xuyang kirin.

Kernela lêgerînê dê tabloya prefix ji bo peyva paşîn piştî dabeşkirina peyvan bikar bîne da ku hemî peyvên pêvekirî bi xwe re bibîne, û li rêzê bigere.

Fonksiyona dijî-hejandinê debounce jî di danûstendina pêş-endê de tê bikar anîn (wekî jêrîn tête bicîh kirin) da ku frekansa lêgerînên ketina bikarhêner kêm bike û mîqdara hesabkirinê kêm bike.

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

Offline Heye

Tabloya îndeksê nivîsa orîjînal nagire, tenê peyvan hilîne, ku mîqdara hilanînê kêm dike.

Girîngkirina encamên lêgerînê ji nû ve barkirina nivîsa orîjînal hewce dike, û berhevkirina service worker dikare ji daxwazên torê yên dubare dûr bixe.

Di heman demê de, ji ber ku service worker hemî gotaran vedişêre, gava ku bikarhêner lêgerînek pêk tîne, tevahiya malper, tevî lêgerînê, offline heye.

Optimîzasyona Belgeyên MarkDown Nîşan Bidin

i18n.site 's çareseriya lêgerîna paşîn a paqij ji bo MarkDown belgeyan xweşbîn e.

Dema ku encamên lêgerînê têne xuyang kirin, navê beşê dê were xuyang kirin û gava ku were klîk kirin dê beş were rêve kirin.

Bihevrekirin

Lêgerîna tev-nivîsê ya berevajîkirî ku bi tenê li pêşiya pêşîn hatî bicîh kirin, serverek hewce nake. Ew ji bo malperên piçûk û navîn ên wekî belge û blogên kesane pir maqûl e.

i18n.site Lêgerîna paşîn a paqij-xwe-pêşkeftî ya çavkaniya vekirî, bi pîvana piçûk û bersivek bilez, kêmasiyên lêgerîna tev-nivîsê ya paşîn a heyî çareser dike û ezmûnek bikarhênerek çêtir peyda dike.