Isomo rigufi · Kinyarwanda

Uko wakosora iyerekanwa ry'urubuga rwawe igihe usangiza umurongo

Ha umufasha umutwe, ibisobanuro n'ishusho watanzwe, hanyuma ugenzure agakarita ihuza rusange nyaryo ritanga.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Ba nyir'imbuga bafite amahuza basangiza yerekana ishusho y'ibanze ibuze cyangwa iyobya. Umufasha wo kwandika kode ashobora kongeramo metadata y'urupapuro; wowe usuzuma agakarita kasangijwe koko.

Mbere yo gutangira

Urupapuro rwawe rusange rwa HTTPS rw'umwitozo n'ishusho y'agakarita ko gusangiza watanzwe. Umufasha ashobora guhindura no gutangaza dosiye zarwo. Imbuga nkoranyambaga ntizishobora kuvana amakuru ku rupapuro rw'ibanga rwa localhost, kandi amashusho yazo y'ibanze abitswe by'agateganyo ashobora gukenera kuvugururwa.

Igihe kigereranyijwe: 15–27 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Imbuga zibika ibisubizo muri cache kandi zikihitiramo ibyo zerekana. Igenzura ry'amakuru asobanura urupapuro kuri mudasobwa yawe ntirishobora kwemeza iyerekanwa nyaryo rya LinkedIn, Slack cyangwa WhatsApp.

Ibyo uziga

  • Huza umutwe, ibisobanuro n'ishusho bigamijwe.
  • Genzura ko ishusho ishobora kuvanwa ku karubanda.
  • Suzuma agakarita nyako ka porogaramu isangiza n'imbibi zako.

Dosiye z'imyitozo

Intambwe 1

Hitamo agakarita ushaka gusangiza

Agakarita gakorwa gakomotse ku rupapuro rushobora kuboneka ku karubanda.

Fungura urupapuro watanzwe. Umutwe ni “Practical notes for building a website”, kandi rufite share-card.jpg. Hitamo niba uwo mutwe, ibisobanuro bigufi n’ishusho bisobanura neza ibyo umushyitsi azafungura.

Ha umufasha aderesi nyayo ya HTTPS y’urupapuro rusange umusabe guhuza izi ndangagaciro zo gusangiza. https://YOUR-SITE.example/ yabikiwe urugero ni icyitegererezo; serivisi yo gusangiza ntishobora gufata ishusho iri kuri mudasobwa yawe gusa.

Urugero rufatika

Ibisobanuro watanzwe ni “Small examples, working files and clear checks for your next website feature.” Hamwe n’umutwe, bisezeranya inyandiko zifatika zo gukora urubuga, si urupapuro rwa mbere rudafitanye isano.

Koresha urupapuro n'ishusho yo gusangiza watanzwe. Ongeramo umutwe, ibisobanuro na URL yuzuye rusange y'ishusho bigenewe inyandiko igamijwe, ugumane ibirimo bigaragara bihuje. Mfasha kugenzura urupapuro n'ishusho byatangajwe utinjiye muri konti, hanyuma dusuzume agakarita nyako ko gusangiza. Kora kode ya metadata. Ntuvuge ko porogaramu yavuguruye ushingiye gusa ku ishusho yo kuri mudasobwa cyangwa ubusabe bwo kuvugurura ububiko bwayo bw'agateganyo.

Open Graph: amakuru y'ibanze asobanura urupapuro

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tuma umurongo usangijwe usobanura aho ujya

Iyerekanwa rikeneye amakuru asobanura urupapuro n'ifoto urubuga rushobora kuzana koko.

Iyerekanwa ry'umurongo usangijwe akenshi rikorwa n'urubuga ruzana URL yawe rukanasoma amakuru ayisobanura. Si ifoto ya ekara gusa y'ibyo mushakisha winjiyemo ibona.

Iri somo ritanga head yuzuye y'urupapuro n'ifoto nshya yo gusangiza abandi. Uzasimbuza aderesi shingiro ya HTTPS yabikiwe urugero uyisimbuze iy'urubuga rwawe rwo kwitoza, usohore urupapuro kandi usuzume ibyo icyifuzo kitoherejweho ibyangombwa byo kwemeza uburenganzira cyakira.

Urugero rusobanuye

Umutwe w'ingirakamaro uvuga ibyo urupapuro rutanga. «My site» bivuga urubuga rwanjye bitanga ibisobanuro bike cyane kurusha «Practical notes for building a website», inyandiko z'ingirakamaro zo kubaka urubuga, bikurikirwa n'ibisobanuro bigufi.

Open Graph: amakuru y'ibanze asobanura urupapuro

Extra implementation exercise

Kuki agafoto gato gashobora gukora kuri mudasobwa yawe ariko kakananirwa muri Slack?

Erekana igisubizo gisobanuye

Urubuga ntirushobora kugera kuri localhost cyangwa session yawe wemejwemo. Rukeneye kandi URL y'ifoto igerwaho na HTML ifite amakuru asobanura urupapuro akwiye kuri aderesi yasangijwe nyine.

  • Hamenyekana ko urubuga rukeneye kugerwaho ku rusobe rwa rusange.
  • URL yasangijwe n'ifoto bigenzurwa ukwabyo.

Intambwe 2

Genzura ishusho yatangajwe

Suzuma inzira y'ishusho agakarita kerekezaho koko.

Tangaza impinduka y'umwitozo umaze kwitegura, hanyuma ufungure URL nyayo y'ishusho yo gusangiza utinjiye muri konti. Saba umufasha kwemeza ko ari ishusho ugamije aho kuba dosiye ibuze cyangwa urupapuro rwo kwinjira.

Guhindura ishusho igaragara ku rupapuro ntibihita bihindura agaciro gatandukanye k'ishusho ikoreshwa mu gusangiza. Emeza kandi ikiranga ishusho cyatanzwe.

Urugero rufatika

Niba URL y’ishusho ifungura urupapuro rwa mbere rwa HTML aho kuba share-card.jpg, seriveri ishobora gusubiza 200. URL ikora nk’urupapuro ariko ntitanga ishusho y’agakarita.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Shyira iyerekanwa muri HTML ya mbere

Koresha URL zuzuye za canonical n'ifoto zikomeza gukora iyo zisabwe hanze.

Suzuma head yatanzwe. og:title, og:description, og:type, og:url na og:image bisobanura uru rupapuro nyine. Inzira y'ifoto iruzuye kuko crawler ya kure ikeneye aho ijya hatarimo urujijo.

Simbuza YOUR-SITE.example ahantu hose. Ifoto ni dosiye nyayo irimo mu myitozo. Ntushingire kuri JavaScript ya mushakisha kugira ngo ishyiremo amakuru y'ingenzi nyuma yo gufunguka; imikorere ya crawler iratandukanye.

Ikarita itambitse yatanzwe ifite pigiseli 1672 × 941. Imbuga zishobora kuyikata cyangwa guhindura ingano zitandukanye, bityo shyira utuntu tw'ingenzi kure y'inkombe kandi usuzume igisubizo nyacyo. Ni dosiye yo gutangiriraho, si isezerano ko buri rubuga ruzerekana igice kimwe cyayo. Emeza ko share-card.jpg iri mu bubiko bwa public bwasohowe.

Mbere yo kugerageza urubuga urwo ari rwo rwose, fungura URL ya og:image yawe yasohowe nyine utarinjiye muri konti kandi ugenzure igisubizo cyagenze neza cya image/jpeg gifite ifoto nyayo igaragara. Dosiye ibuze, inkomoko y'urugero yasigaye cyangwa HTML isubizwa mu mwanya w'ifoto ntibitsinda iri genzura.

Urugero rusobanuye

Ifoto iri mu nyandiko igaragara ishobora kugira inzira ikwiye ibara aderesi yayo ihereye kuri URL y'urupapuro, ariko ibyo ntibikosora og:image yangiritse ifite aderesi yuzuye. Suzuma aho zombi zijya aho kwibwira ko ari hamwe.

<meta property="og:image"
  content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">

Extra implementation exercise

Wahinduye ifoto igaragara ku rupapuro ariko usiga og:image yerekeza kuri dosiye ibuze. Ni iyihe foto crawler izagerageza?

Erekana igisubizo gisobanuye

Ubusanzwe izagerageza ifoto yavuzwe mu makuru asobanura urupapuro, ikiri yangiritse. Kosora URL ya og:image kandi ugenzure igisubizo cyayo nyacyo.

  • Hasomwa aho amakuru asobanura urupapuro yerekeza.
  • Amakuru y'iyerekanwa ntakekwa uhereye ku nyandiko y'urupapuro yamaze gutunganywa.

Intambwe 3

Suzuma agakarita nyako muri porogaramu isangiza

Zirikana kuvana amakuru hanze no kuyabika by'agateganyo.

Nyuma yo gutangaza, genzura URL z’urupapuro n’ishusho utinjiye muri konti. Hanyuma ukoreshe igikoresho cya serivisi nka LinkedIn Post Inspector niba kiboneka, cyangwa usangize ihuriro ry’umwitozo mu ibanga urebe agakarita nyako. Gereranya umutwe, ibisobanuro n’uko ishusho yaciwe.

Andika serivisi n’ibyo yerekanye. Niba dosiye rusange zigezweho ariko serivisi ikigaragaza agakarita gashaje, suzuma cache yayo; gusaba kuvugurura ni intambwe, si igisubizo kigaragara.

Urugero rufatika

Igereranya ry’icyitegererezo: urupapuro rusange rutanga umutwe mushya na JPEG, ariko serivisi yasuzumwe ikerekana umutwe wa kera. Ibyo byerekeza ku gisubizo kibitswe muri cache ya serivisi imwe, si gihamya ko serivisi zose zavuguruye.

LinkedIn Post Inspector: igikoresho cyo gusuzuma umurongo · Meta Sharing Debugger: igikoresho cyo gukemura ibibazo by'iyerekanwa

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Suzuma igisubizo mbere yo gushinja cache

Genzura HTML y'umwimerere, redirects n'uko ifoto igerwaho, hanyuma ugerageze urubuga.

Fungura URL yasangijwe nyine muri mushakisha utarinjiyemo kandi usuzume kode y'umwimerere. Kurikira redirects kandi urebe status ya nyuma. Zana ifoto ukwawo: igomba gusubiza bytes z'ifoto zifite ubwoko bw'ibirimo bukwiye aho gusubiza HTML y'ubusimbura.

Nyuma y'uko ibiva kuri seriveri ari byo, koresha igikoresho cy'urubuga cyo gusuzuma aho kiboneka kandi ugerageze gusangiza umurongo bushya. Ubutumwa busanzwe bushobora kugumana iyerekanwa ryabitswe muri cache. Kuvugurura cache ya mushakisha yawe ntibisiba cache y'urubuga nkoranyambaga.

Urugero, fungura LinkedIn Post Inspector ukoresheje konti yawe kandi winjize URL ya rusange nyine. Meta Sharing Debugger ni ikindi gikoresho cyihariye cy'urubuga kandi gishobora gusaba kwinjira. Mu bikoresho by'abakora imbuga bya mushakisha, hitamo icyifuzo cy'ifoto muri Network kandi usuzume Headers → Content-Type hamwe n'iyerekanwa ry'igisubizo. Ibikoresho by'imbuga bishobora gukomeza kutaboneka cyangwa gukoresha cache.

Urupapuro/ifoto bigamijwe bigomba kugerwaho n'usura cyangwa crawler nta session yawe ya nyir'urubuga. Igikoresho cyo gukemura ibibazo ni ikindi: LinkedIn cyangwa Meta bishobora gusaba ko winjira kugira ngo ukoreshe inspector yayo. Kwinjira mu gikoresho ntibituma aho umurongo ugana h'ibanga hashobora kugerwaho na crawler. Niba udafite uburenganzira bwo gukoresha igikoresho, andika iyo mbogamizi kandi utandukanye igenzura ry'ibisubizo by'umwimerere n'iyerekanwa ry'urubuga utabonye.

Kuri WhatsApp cyangwa Slack, ushobora gusangiza URL ya rusange yo kwitoza mu kiganiro cyo kugerageza ugenzura kandi ukandika iyerekanwa cyangwa ko ritabonetse. Ntuvuge ko urubuga rwatsinze kandi wagenzuye gusa ibisubizo bya HTTP; niba konti cyangwa igikoresho bitaboneka, andika iyo mbogamizi.

Urugero rusobanuye

Icyifuzo cy'ifoto gisubiza 200 text/html gishobora kuba HTML y'ubusimbura ya porogaramu y'urupapuro rumwe. Status 200 yonyine ntiyemeza ko ifoto yatanzwe.

LinkedIn Post Inspector: igikoresho cyo gusuzuma umurongo · Meta Sharing Debugger: igikoresho cyo gukemura ibibazo by'iyerekanwa

Extra implementation exercise

Icyifuzo cya og:image gisubiza 200 irimo urupapuro rwo kwinjira. Igenzura ry'ifoto ryagenze neza?

Erekana igisubizo gisobanuye

Oya. Crawler yakiriye HTML aho kwakira ifoto. Kosora kuyobora cyangwa uburenganzira kugira ngo URL y'ifoto isubize dosiye nyayo udasabye kwinjira.

  • Ubwoko bw'ibirimo n'ibisubijwe bigenzurwa hamwe na status.
  • Hasabwa kubona bytes nyazo z'ifoto utarinjiye muri konti.

Intambwe 4

Soza agakarita kagenewe inyandiko imwe

Gumana umwirondoro usangizwa uhuye n'urupapuro nyarwo.

Saba umufasha kongeramo inyandiko y’urugero watanzwe “Fix a mismatched contact link”, ifite umutwe, ibisobanuro na URL byayo byo gusangiza. Ishobora kongera gukoresha share-card.jpg; umwirondoro wayo ugomba gukomeza gusobanura iyo nyandiko aho kuvuga urupapuro rwa mbere.

Tangaza inyandiko ku rubuga rw’umwitozo, fungura urupapuro rwayo rusange nyirizina n’ishusho, wongere urebe agakarita kayo kuri serivisi. Igenzura ryose ritabonetse urishyire mu nyandiko ya nyuma.

Urugero rufatika

Umutwe w’agakarita k’inyandiko ugomba kuba “Fix a mismatched contact link”. Ibisobanuro byayo bivuga kugereranya href na id, gukosora anchor no kugenzura igisubizo. Kongera gukoresha umutwe rusange w’urupapuro rwa mbere byahisha icyo iri huriro ryihariye ryigisha.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Umukoro wawe: erekana ingingo yihariye igihe umurongo wayo usangijwe

Ha umurongo w'imbere mu rubuga umutwe, ibisobanuro n'ifoto byawo by'ukuri.

Kora urupapuro rw'ingingo rufite amakuru arusobanura yarwo n'ubutumwa busobanura umurongo usangizwa. Gumisha canonical/og:url yayo kuri iyo ngingo aho kuba ku rupapuro rw'ibanze.

Sohora gusa ku rubuga rwawe rwo kwitoza, ugerageze ibisubizo byarwo utarinjiye muri konti kandi wandike iyerekanwa nyaryo ry'urubuga rumwe niba riboneka. Niba urubuga rwanze cyangwa rwibutse igisubizo cya kera muri cache, andika icyo wabonye aho kwemeza ko byagenze neza ushingiye kuri HTML gusa.

Urugero rusobanuye

Ingingo ebyiri zitandukanye zihora zerekana urupapuro rw'ibanze mu iyerekanwa zishobora gusangizwa tekiniki, ariko ntizifasha uwakira kumva umurongo wihariye.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Extra implementation exercise

Kora iyerekanwa ryihariye ry'ingingo imwe n'inyandiko y'igerageza ry'ibisubizo n'urubuga.

Erekana igisubizo gisobanuye

Simbuza inkomoko y'urugero muri canonical, og:url na og:image. Sohora JPEG yatanzwe hamwe na HTML. Fungura URL zombi nyine utarinjiye muri konti kandi usuzume igisubizo cya Network: urupapuro rugomba kuba HTML, ifoto ikaba bytes nyazo za image/jpeg aho kuba HTML y'ubusimbura.

Ku ngingo yihariye, yihe umutwe, ibisobanuro na URL ya canonical/OG byayo aho kongera gukoresha umwirondoro w'urupapuro rw'ibanze. Ingingo yuzuye y'urugero yerekana iyo head yihariye.

Koresha LinkedIn Post Inspector cyangwa Meta Sharing Debugger aho konti yawe ifite uburenganzira, hanyuma wandike igisubizo nyacyo cy'urubuga n'igihe cy'igerageza. Iyerekanwa rya kera ryabitswe muri cache ni ikintu gitandukanye n'ibiva kuri seriveri ubu bitari byo. Kugenzura kode kuri mudasobwa yawe gusa ntibyemeza iyerekanwa nyaryo rya WhatsApp.

  • Amakuru asobanura urupapuro avuga ingingo yasangijwe nyine.
  • HTML y'umwimerere no kugera ku ifoto biragenzurwa; igisubizo cy'urubuga cyandikwa mu kuri.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo