Neidio i'r prif gynnwys

:::note Statws fersiwn Mae cod ffynhonnell cyfredol y loader lletyol sydd wedi'i gadw yn ystorfa yn nodi mai v16 ydyw. Nid yw'r ymddygiad a nodir isod fel ymddygiad ffynhonnell gyfredol yn honiad am fersiwn y loader sydd wedi'i defnyddio; gwiriwch y fersiwn sydd wedi'i defnyddio cyn dibynnu arno. Mae'r SDK npm 0.1.4 cyhoeddedig yn defnyddio dolenni mount sy'n cyfrif cyfeiriadau: tynnwch bob dolen â'r un opsiynau i sbarduno'r teardown terfynol. :::

Addasu’r Widget Lletyol

Addaswch y rhyngwyneb parod a lwythir gan https://chattybox.ai/widget.js. Am enghreifftiau gosod fframweithiau a llwyfannau canonaidd, gweler Canllawiau Gosod.

Cyn Addasu​

Crëwch y prosiect, mynegeiwch ei gynnwys, a gwiriwch atebion cynrychioliadol yn Profi'r sgwrsfot cyn treulio amser ar gyflwyniad. Gweler Dechrau Arni am y dilyniant cyflawn.

Ffurfweddu’r Widget Lletyol​

  1. Ewch i’ch Dangosfwrdd a dewiswch eich prosiect.
  2. Agorwch Addasu → Golwg i olygu golwg, brandio ac iaith y widget.
  3. Gwiriwch y statws cadw perthnasol. Cywirwch wallau dilysu neu ceisiwch gadw eto os bydd cadw'n methu cyn profi'r widget sydd wedi'i osod.

Mae cod gosod ac allweddi cyhoeddus o dan Gosod. Pan fyddwch yn barod i osod:

  1. Agorwch Gosod → Allweddi a pharthau i wirio neu greu allwedd porwr gyhoeddus ac edrych ar ei gosodiadau tarddiad.
  2. Agorwch Gosod → Gosod ar wefan, dewiswch allwedd addas a chopïwch y pyt a gynhyrchir. Mae allwedd heb gyfyngiadau yn gweithio o bob tarddiad; gall allwedd a baratowyd ar gyfer gwefan fod eisoes wedi'i chyfyngu i darddiad y wefan honno. Gwiriwch yr allwedd a ddewiswyd cyn defnyddio staging neu localhost.
  3. Gallwch alluogi cyfyngiad tarddiad union fel amddiffyniad ychwanegol. Nid yw'n dilysu ymwelwyr; mae allwedd y porwr yn gyhoeddus ac nid oes rhaid i'r ymwelydd fewngofnodi.
  4. Dilynwch Ganllawiau Gosod ar gyfer eich platfform.
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="https://adorable-woodpecker-629.convex.site/chat"
async
></script>
awgrym

Caiff newidiadau a gedwir yn y dangosfwrdd eu nôl ar gychwyn nesaf y widget heb ddisodli’r pyt. Nid yw tudalennau sydd eisoes ar agor yn diweddaru'n fyw: ail-lwythwch i gael y gosodiadau a gadwyd.


Addasu Gweledol​

Mae golygydd y dangosfwrdd yn addasu lliwiau, lleoliad, eicon a thestun a gefnogir heb olygu cod. Gwiriwch y canlyniad yn y widget lletyol, oherwydd nid yw'r rhagolwg a'r loader yn union yr un peth.

Rheolyddion y Dangosfwrdd​

  1. Lliw acen - Dewiswch brif liw eich brand. Mae hyn yn effeithio ar y botwm agor, prif uchafbwyntiau a negeseuon defnyddwyr.

  2. Safle'r teclyn - Dewiswch ble mae’r widget yn ymddangos ar y sgrin.

  3. Teitl y pennawd - Gosodwch y teitl sy’n ymddangos ar frig y ffenestr sgwrsio.

  4. Neges groeso - Addaswch y neges gyntaf y mae ymwelwyr yn ei gweld pan fyddant yn agor y sgwrs.

  5. Dangos brand ChattyBox - Mae brandio'n ofynnol ar y cynllun Free. Gall cynlluniau Starter ac uwch guddio'r troedyn “Wedi’i bweru gan ChattyBox”.

Mae gan y golygydd hefyd reolyddion Cefndir y teclyn a Lliw testun, yn ogystal ag eicon robot diofyn, emoji, URL delwedd neu ddelwedd wedi'i llwytho i fyny. Rhaid i eiconau wedi'u llwytho i fyny fod yn 512 KiB neu lai a defnyddio MIME delwedd a dderbynnir (PNG, JPEG, WebP, SVG, GIF neu ICO). Dim ond ar gyfer eiconau o'r math url neu upload y mae'r rheolydd maint iconSize ar gael yn y golygydd. Mae loader v16 y ffynhonnell gyfredol yn defnyddio iconSize i newid maint y botwm agor a'r eicon. Gwiriwch y loader sydd wedi'i ddefnyddio cyn dibynnu ar yr ymddygiad hwn.

nodyn

Cadarnhewch statws cadw perthnasol ac yna ail-lwythwch y dudalen sydd wedi'i gosod i wirio'r newidiadau. Enwau statws y rhyngwyneb yw Statws cadw golwg, Statws cadw iaith a Statws cadw brandio. Os bydd cadw'n methu, dewiswch Ceisio cadw eto. Mock yw rhagolwg y dangosfwrdd, nid y widget lletyol ei hun. Mewn prosiectau sydd wedi'u cloi i config, rheolir golwg ac iaith gan config-as-code; gall prosiectau sydd â'r hawl barhau i gadw gosodiad brandio ar wahân.

Rhagosodiadau ffurfweddu​

Dyma'r gwerthoedd diofyn a ddychwelir gan gais cyfluniad widget cyhoeddus llwyddiannus pan nad oes gwerth personol:

MaesRhagosodiad
enabledtrue, oni bai fod y prosiect wedi'i analluogi
themeColor#3b82f6
chatBgColor#0f172a
textColor#f8fafc
positionbottom-right; cefnogir y pedwar cornel
iconType, iconSizedefault, medium; mae ffynhonnell gyfredol v16 yn defnyddio'r maint ar gyfer y botwm agor a'r eicon. Dim ond pan fo gwerth iconType yn url neu upload y mae'r rheolydd maint ar gael
iconEmoji, iconUrlemoji swigen siarad, null
headerTitleChat with us (gwerth diofyn yr API)
welcomeMessageHi! 👋 How can I help you today? (gwerth diofyn yr API)
showBrandingtrue; gorfodir brandio ymlaen ar brosiectau Free
localeMode, defaultLocale, allowLocaleOverrideauto, en, true (gwerthoedd diofyn)

Os bydd y cais ffurfweddu'n methu neu os yw'r ymateb yn annilys, mae loader ffynhonnell gyfredol v16 yn gwneud y widget yn anhygyrch ac nid yw'n dangos UI wrth gefn. Os bydd y ffurfweddiad yn llwyddo ond y cais cyfieithiadau'n methu, gall y widget ymddangos o hyd gyda labeli Saesneg mewnol. Mae ymateb llwyddiannus ag enabled: false hefyd yn atal y widget rhag rendro; mae'r API sgwrs yn gwrthod ceisiadau widget sydd wedi'u hanalluogi gyda HTTP 403, gan gynnwys ceisiadau SDK. Gwiriwch fersiwn y loader sydd wedi'i ddefnyddio cyn dibynnu ar yr ymddygiad ffynhonnell cyfredol hwn.

Mae loader lletyol ffynhonnell gyfredol v16 yn gofyn am ffurfweddiad gydag Authorization: Bearer ac yn ailgeisio unwaith gyda'r allwedd mewn paramedr ymholiad dim ond ar ôl HTTP 400. Mae hefyd yn gwneud ailgeisiadau ar wahân ar gyfer ceisiadau cychwyn y ffurfweddiad a'r cyfieithiadau. Mae hyn yn wahanol i ailgeisiadau negeseuon sgwrs isod. Mae SDK cyhoeddedig 0.1.4 yn defnyddio'r un fallback config yn unig pan fydd y dudalen yn datgelu window.ChattyboxSDK. Mae rhannu mount yr SDK yn berthnasol i opsiynau unfath yn unig; gwrthodir allwedd, endpoint, URL sgript, locale neu osodiad debug gwahanol nes bod pob dolen gyfatebol wedi'i thynnu. Gwiriwch fersiwn y loader a ddefnyddir cyn dibynnu ar ymddygiad y ffynhonnell gyfredol.

Dewisiadau Uwch​

Gosodiadau’r Dangosfwrdd yn erbyn Priodoleddau Sgript​

Dylid rheoli’r rhan fwyaf o ymddygiad y widget o’r dangosfwrdd fel nad oes angen ailgyhoeddi eich gwefan ar gyfer newidiadau syml.

Defnyddiwch y dangosfwrdd ar gyfer lliwiau, safle, eicon, teitl pennyn, neges groeso, ieithoedd diofyn, rheoli allweddi cyhoeddus, sgrapio a dadansoddeg.

Mae cyfyngiad tarddiad allwedd gyhoeddus yn ddewisol, yn amddiffyniad ychwanegol ac nid yn ddilysiad. Os caiff ei alluogi, cadwch yr union darddiadau'n gyson â'r parthau lle mae'r widget wedi'i osod.

Defnyddiwch briodoleddau sgript ar gyfer gwerthoedd sydd eu hangen ar y widget wrth lwytho’r dudalen:

  • Mae data-api-key yn nodi allwedd gyhoeddus y widget.
  • Mae data-api-url yn dweud wrth y widget ble i anfon ceisiadau. Wrth gynhyrchu, URL sefydlog https://...convex.site/chat o’ch dangosfwrdd yw hwn.
  • Mae data-locale yn gofyn am iaith UI benodol os yw'r prosiect yn caniatáu diystyru sgript. Mae loader ffynhonnell gyfredol v16 hefyd yn arsylwi newidiadau dilynol i'r briodoledd.
  • Mae data-color a data-position yn diystyru'r lliw acen a'r safle sydd wedi'u cadw ar ôl i'r ffurfweddiad lwytho'n llwyddiannus. Defnyddiwch werthoedd y dangosfwrdd lle bo modd; gall y priodoleddau hyn guddio newidiadau diweddarach yn y dangosfwrdd.
  • Mae data-debug="true" yn galluogi diagnosteg yn y consol; mae wedi'i ddiffodd yn ddiofyn.

Ar gyfer pob neges newydd, mae'r loader lletyol yn y ffynhonnell gyfredol yn ceisio anfon tarddiad a llwybr HTTP(S) dilys y dudalen gyfredol ar gyfer dadansoddeg Sbardunau poblogaidd. Nid yw'n gwirio a yw'r dudalen yn gyhoeddus. Hepgorir cyd-destun annilys neu rhy hir; mae ailgeisiadau'n cadw cyd-destun y cais gwreiddiol. Tynnir y llinyn ymholiad, y darn ac unrhyw gymwysterau, ond gall llwybrau gynnwys dynodwyr sensitif. Peidiwch â llwytho'r widget ar lwybrau sensitif dim ond am fod y llinyn ymholiad yn cael ei dynnu.

Mae'r loader hefyd yn gallu anfon gwallau cychwyn, ffurfweddu, cyfieithu a sgwrs at /widget-error drwy beacon neu fetch. Gall yr adroddiad gynnwys manylion gwall cyfyngedig, locale, fersiwn a tharddiad/llwybr y dudalen; nid oes angen modd debug. Mae widget y ffynhonnell gyfredol hefyd yn parchu prefers-reduced-motion, yn darparu maes mewnbwn neges wedi'i labelu a chyhoeddiadau byw, ac yn dangos dyfyniadau drwy ddatgeliad Ffynonellau sy'n hygyrch drwy fysellfwrdd.

Mae sgwrs yn defnyddio ymatebion JSON cyflawn, nid ffrydio tocynnau. Mae loader lletyol ffynhonnell gyfredol v16 yn creu allwedd idempotency ar gyfer pob neges ac yn gwneud hyd at 10 ymgais trosglwyddo awtomatig ar gyfer gwallau rhwydwaith, corff ymateb llwyddiannus yr amharwyd ar ei ddarllen, HTTP 429, HTTP 5xx, ac HTTP 409 sydd â phennawd Retry-After y gellir ei ddarllen. Ni chaiff ymgais arall ei hamserlennu os byddai'r oedi'n mynd dros y gyllideb 30 eiliad; nid timeout galed ar gais sydd eisoes ar waith yw hon. Gall CORS y porwr guddio Retry-After. Defnyddir yr un allwedd idempotency ar ailgeisiadau fel y gall y gweinydd ailchwarae'r ymateb a gadwyd yn hytrach na phrosesu'r neges eto. Nid yw'r ailgais sgwrs awtomatig hwn ar gael i sendMessage() headless yr SDK; mae ailgeisiadau GET cychwyn y loader a'r fallback config-400 yn SDK 0.1.4 yn ymddygiadau ar wahân a chyfyngedig. Cedwir cyflwr y sgwrs yng nghof yr enghraifft honno o'r widget ac fe'i collir wrth ail-lwytho neu ailgychwyn, er y gall negeseuon sydd wedi'u storio ar y gweinydd aros. Caiff ffynonellau eu dad-ddyblygu a dangosir hyd at dair eitem; efallai na fydd gan atebion wrth gefn ffynonellau. Gwiriwch fersiwn y loader a ddefnyddir cyn dibynnu ar ymddygiad ffynhonnell gyfredol.

Os nad yw’r widget yn ymddangos ar ôl ei osod, gweler Datrys Problemau.

Am enghreifftiau penodol i blatfform, dechreuwch gyda Docusaurus, MkDocs, VitePress, WordPress, neu GitBook.

Cuddio’r Widget ar Dudalenau Penodol​

I guddio'r widget yn weledol, defnyddiwch y CSS canlynol ar y tudalennau a ddewiswyd yn unig (bydd ei gymhwyso'n fyd-eang yn cuddio'r widget ym mhobman):

.chattybox-widget {
display: none;
}

Nid yw cuddio drwy CSS yn atal cychwyn, ceisiadau API na riportio gwallau, ac nid yw'n reolaeth caniatâd na phreifatrwydd. Nid yw'r loader yn penderfynu ar ganiatâd: peidiwch â mewnosod y sgript nes bod y caniatâd gofynnol wedi'i roi, ac ataliwch ei hailfewnosod ar ôl tynnu caniatâd yn ôl neu ar lwybrau sydd wedi'u heithrio. Nid yw tynnu tag y sgript yn unig yn atal widget sydd eisoes wedi'i lwytho. Ar gyfer trawsnewidiadau llwybr ochr-cleient neu dynnu caniatâd yn ôl, mae window.ChattyBox.destroy() ar widget.js v16 yn ffynhonnell gyfredol y loader lletyol. Tynnwch bob dolen mount SDK 0.1.4 sydd â'r un opsiynau i sbarduno'r teardown terfynol. Gwiriwch fod y loader a ddefnyddir yn cefnogi teardown. Mae teardown yn tynnu UI/arddulliau'r widget ac yn canslo gwaith sydd ar y gweill, ond ni all ddadwneud cais y mae'r gweinydd eisoes wedi'i brosesu.

Rheolyddion y Porwr​

Yn loader ffynhonnell gyfredol v16, mae window.ChattyBox ar gael yn ystod y cychwyn gyda status: 'loading' a destroy(). Mae galw destroy() bryd hynny'n canslo'r cychwyn. Dim ond ar ôl cychwyn llwyddiannus y mae open(), close(), toggle() a sendMessage(text) ar gael; gwiriwch window.ChattyBox?.status === 'ready' cyn eu galw. Nid yw llwytho'r sgript yn golygu bod y ffurfweddiad a'r cyfieithiadau'n barod. Mae destroy() yn tynnu elfennau ac arddulliau'r widget ei hun, yn canslo ei waith ac yn clirio'r global, ond ni all ddadwneud cais a broseswyd eisoes gan y gweinydd. Mae close() yn cau'r panel sgwrs yn unig; mae'r botwm agor yn aros. Mae sendMessage(text) yn dychwelyd addewid ar gyfer gweithred UI, nid addewid am yr ateb; anwybyddir anfon tra bo neges arall yn yr arfaeth. Mae'r global hwn yn wahanol i adeiladwyr SDK ar window.ChattyboxSDK. Gwiriwch fersiwn y loader a ddefnyddir cyn dibynnu ar yr ymddygiad hwn.

Themâu golau a thywyll a reolir gan y wefan (ffynhonnell gyfredol)​

Mae llif gwaith config-as-code y ffynhonnell gyfredol yn cefnogi paletau dewisol widget.theme.light a widget.theme.dark. Gall pob un gynnwys primaryColor, backgroundColor a textColor fel lliwiau hecs chwe digid; etifeddir lliwiau sydd heb eu pennu o'r widget.theme sylfaenol. Mae ffurfweddiadau un thema presennol yn parhau i weithio fel o'r blaen. Mae hyn yn gofyn am CLI/backend y ffynhonnell gyfredol a loader lletyol v16; nid yw CLI/config cyhoeddedig 0.3.1 yn derbyn y meysydd newydd hyn. Nid yw hyn yn honiad am fersiwn y loader a ddefnyddir.

Gosodwch data-theme="light" neu data-theme="dark" ar sgript y loader cyn iddo redeg i ddewis y palet cychwynnol. Yna cysylltwch dogl eich gwefan ag API y porwr:

window.ChattyBox?.setTheme('light');
window.ChattyBox?.setTheme('dark');
window.ChattyBox?.setTheme(null); // Restore the configured base appearance.

Mae'r widget yn diweddaru ei arddulliau presennol heb ailosod negeseuon, ffynonellau, testun drafft na chais sydd ar y gweill. Ni all dewis thema analluogi'r widget na thynnu brandio. Y wefan sy'n gyfrifol am gadw'r dewis ac ymddygiad thema'r OS; dim ond dewis y palet a ffurfweddwyd y mae'r widget yn ei wneud.

Integreiddiadau Personol​

Angen gosodiad mwy pwrpasol na’r widget lletyol? Adeiladwch eich rhyngwyneb eich hun gyda’r SDK JavaScript, neu cysylltwch â support@chattybox.ai am help pensaernïol.

Cymorth Amlieithog​

Mae widget ffynhonnell gyfredol v16 yn datrys locale UI yn ôl modd Fixed neu Auto y prosiect. Mae'n gwylio newidiadau i <html lang> a data-locale ar sgript y loader, ac yn diweddaru'r labeli yn eu lle heb ailosod y sgwrs, y drafft na'r ailgais sydd ar y gweill. Nid yw llywio ar ei ben ei hun yn dewis iaith; diweddarwch un o'r priodoleddau hynny pan fo angen. Rhaid ailgychwyn y widget i gymhwyso newidiadau i osodiadau'r dangosfwrdd. Mae hyn yn disgrifio'r ffynhonnell gyfredol, nid o reidrwydd y loader sydd wedi'i ddefnyddio.

Ieithoedd a Gefnogir yn Swyddogol​

Mae gan y widget gatalogau cyfieithu ar gyfer 14 iaith. Mae pob catalog cyfredol yn defnyddio cynllun o'r chwith i'r dde. Nid yw'r catalogau UI yn cyfieithu testun a ysgrifennwyd gan y prosiect nac atebion a gynhyrchir gan AI.

IaithCod
Saesnegen
Ffrangegfr
Almaenegde
Sbaeneges
Eidalegit
Iseldiregnl
Portiwgalegpt
Pwylegpl
Swedegsv
Indonesegid
Estoneget
Ffinnegfi
Cymraegcy
Tsiecegcs

:::note Iaith UI ac atebion Yn y ffynhonnell gyfredol, mae'r loader lletyol yn anfon locale UI wedi'i ddatrys gyda cheisiadau sgwrs. Mae'r backend yn canfod iaith y cwestiwn ac yn ceisio adalw a chynhyrchu sy'n ystyriol o'r iaith honno. Mae signal iaith y cwestiwn a gydnabyddir yn cael blaenoriaeth dros locale UI ar gyfer negeseuon wrth gefn sy'n perthyn i'r cynnyrch; os yw'r canfod yn amhendant neu'n dibynnu ar heuristig Saesneg ASCII yn unig, gall locale UI ddewis eu hiaith. Nid yw hyn yn cyfieithu testun wrth gefn a ysgrifennwyd gan y prosiect nac yn newid allbwn a gynhyrchir gan AI. Mae ansawdd yr ateb a'r ieithoedd sydd ar gael yn dibynnu ar y cynnwys sydd wedi'i fynegeio a'r model a ffurfweddwyd; nid yw catalogau UI yn gwarantu ansawdd atebion. :::

Sut Mae Canfod Iaith yn Gweithio​

Mae’r widget yn defnyddio system ganfod rhaeadrol:

  1. Diystyru sgript a ganiateir - Mae data-locale a gefnogir yn ennill dim ond os nad yw allowLocaleOverride yn false, hyd yn oed yn y modd Fixed.
  2. Modd Fixed - Os nad oes diystyriad a gefnogir a ganiateir, defnyddir defaultLocale ac anwybyddir iaith y dudalen a'r porwr.
  3. Modd Auto - Ceisir <html lang>, navigator.language, pob cofnod yn navigator.languages, yr hen briodoledd userLanguage, ac yna defaultLocale, gan ddewis yr iaith gyntaf a gefnogir.
  4. Normaleiddio - Nid yw llythrennau mawr a bach yn effeithio ar baru; caiff locale rhanbarthol cydnabyddedig fel fr-CA ei ostwng i'w iaith sylfaenol a gefnogir. Hepgorir gwerthoedd heb eu cefnogi; os nad oes un gwerth a gefnogir, defnyddir Saesneg. Y rhagosodiadau yw modd Auto, Saesneg, a chaniatáu diystyriadau sgript.

Mae teitlau pennyn a negeseuon croeso personol yn cael eu dangos yn union fel y'u hysgrifennwyd, heb eu cyfieithu'n awtomatig. Yn y ffynhonnell gyfredol, defnyddir labeli lleol ar gyfer teitlau a negeseuon croeso diofyn. Os na ellir llwytho cyfieithiadau, erys y labeli Saesneg mewnol.

Diystyru Iaith â Llaw​

I osod iaith gychwynnol benodol waeth beth fo gosodiadau’r porwr, galluogwch Caniatáu i'r sgript ei wrthwneud ac ychwanegwch data-locale a gefnogir cyn i'r loader redeg. Mae'r diystyriad a ganiateir yn ennill hyd yn oed yn y modd Fixed. Yn ffynhonnell gyfredol v16, gellir hefyd newid data-locale ar ôl cychwyn i ddiweddaru'r iaith:

<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-locale="de"
data-api-url="https://adorable-woodpecker-629.convex.site/chat"
async
></script>

:::tip Achos Defnydd Mae hyn yn arbennig o ddefnyddiol os oes gan wefan amlieithog URL ei hun ar gyfer pob fersiwn iaith (e.e. /de/, /fr/). Gosodwch data-locale i gyd-fynd ag iaith pob tudalen a gwiriwch y rhyngwyneb a rendrwyd. :::

Gosodiadau Iaith y Dangosfwrdd​

Mae dangosfwrdd yr ap yn gadael i chi ffurfweddu dewisiadau iaith y widget fesul prosiect:

  • Canfod yn awtomatig - Yn defnyddio iaith y dudalen cyn iaith porwr yr ymwelydd
  • Sefydlog - Yn defnyddio iaith ddiofyn y prosiect oni bai fod data-locale a ganiateir yn ei disodli
  • Caniatáu i'r sgript ei gwrthwneud - Yn galluogi/analluogi diystyru’r briodoledd data-locale

Gwelwch y gosodiadau hyn yn eich Dangosfwrdd → prosiect → Addasu → Golwg → Iaith y teclyn. Gwiriwch Statws cadw iaith a chywirwch wallau neu dewiswch Ceisio cadw eto cyn profi.

Cyfateb Iaith y Cynnwys​

I gael profiad amlieithog defnyddiol, mynegeiwch gynnwys cyhoeddus yn ieithoedd eich ymwelwyr a phrofwch y dyfyniadau; nid yw canfod nac adalw yn warantedig.

  1. Sgrapiwch bob fersiwn iaith o’ch dogfennaeth gan ddefnyddio’r ffeil sitemap.xml
  2. Mae’r scraper yn ceisio canfod iaith y dudalen; archwiliwch y cynnwys a'r dyfyniadau
  3. Mae adalw'n ceisio ffafrio iaith y cwestiwn ond gall ddisgyn yn ôl i gynnwys arall wedi'i fynegeio

Gosod yn Nangosfwrdd yr Ap: Wrth ffurfweddu sgrapio, defnyddiwch URL eich sitemap.xml (e.e. https://yourdocs.com/sitemap.xml) i ddarganfod fersiynau iaith, yna gwiriwch y tudalennau a fynegeiwyd. Nid yw mapiau safle yn osgoi terfynau cropian nac eithriadau.

Datrys Problemau​

Mae’r Widget yn Dal i Ddangos Saesneg​

  • Adnewyddiad caled fel diagnosis - Ail-lwythwch gyda Ctrl+F5 neu Cmd+Shift+R, yna gwiriwch banel rhwydwaith y porwr am geisiadau widget a chyfieithiadau. Os bydd y cais ffurfweddu'n methu, ni ddangosir UI wrth gefn; os bydd ffurfweddiad yn llwyddo ond cyfieithiadau'n methu, gall labeli Saesneg ymddangos.
  • Gwiriwch data-locale - Gwiriwch fod y briodoledd wedi’i gosod yn gywir gyda chod iaith a gefnogir
  • Gwiriwch fodd y prosiect a chaniatâd diystyru - Mae modd Fixed yn anwybyddu iaith y dudalen a'r porwr; anwybyddir data-locale os yw diystyriadau wedi'u hanalluogi neu os nad yw'r gwerth yn cael ei gefnogi
  • Gwiriwch iaith y porwr - Gwiriwch fod dewis iaith eich porwr wedi’i osod yn gywir
  • Gwiriwch HTML lang y dudalen - Sicrhewch fod gan eich tudalen <html lang="de"> (neu’r cod priodol)

Mae Ffynonellau yn yr Iaith Anghywir​

  • Ail-sgrapiwch eich cynnwys - Gwiriwch fod y fersiynau iaith a ddymunir wedi’u mynegeio
  • Defnyddiwch sitemap.xml - Gwiriwch fod URLau dymunol wedi’u mynegeio mewn gwirionedd; gall terfynau cropian ac eithriadau eu hepgor
  • Gwiriwch iaith yr ymholiad - Mae’r AI yn ceisio paru iaith yr ateb ag iaith yr ymholiad

Cyfieithiadau ar Goll​

  • Gwiriwch ieithoedd a gefnogir - Dim ond y 14 cod a restrir uchod sydd â chatalogau; gall labeli coll ddefnyddio Saesneg os llwyddodd y cais ffurfweddu.

Arferion Gorau​

  1. Gosodwch <html lang> ar eich tudalennau - Mae hyn yn helpu hygyrchedd a chanfod iaith y widget
  2. Profwch gyda data-locale wrth ddatblygu - Galluogwch ddiystyru sgript a gwiriwch fod pob iaith yn rendro’n gywir
  3. Sgrapiwch bob fersiwn iaith - Defnyddiwch sitemap.xml i ddarganfod fersiynau a gwiriwch y tudalennau a fynegeiwyd
  4. Adolygwch gwestiynau go iawn - Archwiliwch sgyrsiau am fylchau cynnwys sy'n benodol i iaith; nid yw'r dangosfwrdd yn adrodd dosbarthiad locale widget ar hyn o bryd