Helitaanka nuxurka iyo sheegidda ilaha
Maqaallo dadweyne u furan, tixraacyo cad iyo xiriir joogto ah oo dib kuugu celinaya asalka.
Akhri oo sahami
Bogagga maqaalladu waxay leeyihiin qoraal la akhrisan karo iyo tixraacyo, iyagoo aan qoraallada dadweynaha u furan uga baahnayn JavaScript ama akoon. Ka hel ururinta dhammaystiran kaydka maqaallada, URL-yada asalka rasmiga ah khariidadda bogga, 50-ka qoraal ee ugu dambeeya quudinta RSS, iyo tusmo qoraal ah llms.txt.
API maqaal oo akhris keliya ah
Dhoofinta maqaallada dadweynaha u furan uma baahna furaha API. U dir codsi GET cinwaanka /api/public/articles/ARTICLE-SLUG si aad u hesho JSON, ama ku dar ?format=markdown si aad u hesho Markdown. Qaababkani waxay ka yimaadaan isla maqaalka kaydsan ee bogga akhriska, iyagoo ilaalinaya cinwaannada qaybaha, liisaska, xiriirrada, aqoonsiyada sawirrada iyo shaacinta tifaftirka.
Tijaabi tusaalaha JSON, noociisa Markdown, iyo maqaalka asalka ah.
JSON-ku wuxuu ka kooban yahay url (bogga akhriska ee asalka rasmiga ah), cinwaan, sharraxaad, qoraa, daabace, luqad, mawduuc, publishedAt, modifiedAt, body.format, body.text, iyo links ee maqaalka. Xiriirradu waa tixraacyo laga helay qoraalka; joogitaankoodu ma aha sheegasho ah in bog kasta oo la xiriiriyey taageero hadal kasta. Dhammaan taariikhuhu waxay adeegsadaan ISO 8601.
Tax maqaallada oo la soco wixii cusub
Codso /api/public/articles?limit=24 si aad u hesho xogta qeexidda oo keliya. Xadka caadiga ahi waa 6; kan ugu badani waa 24. Adeegso page=2 si aad u hesho bogga xiga. topic oo ikhtiyaari ahi wuxuu aqbalaa slug mawduuc, author-na wuxuu aqbalaa aqoonsi qoraa oo tiro togan ah. Jawaabtu waxay ka kooban tahay docs, hasNextPage, totalPages, iyo nextAfter.
Si aad bogagga ugu sii gudubto habka sii-wadidda, gudbi nextAfter.at ee laguu soo celiyey adigoo u adeegsanaya afterAt, iyo nextAfter.id adigoo u adeegsanaya afterId, labadabana u samee koodhaynta URL. Hay isla shaandheeyeyaasha iyo xadka. Sii wad inta hasNextPage ay run tahay. Xogta qeexidda ee liisku ma furayso qaybaha buuxa ee maqaallada xaddidan.
Xuduudaha gelitaanka iyo cusaybka
Barta qoraalka buuxa waxaa loo heli karaa oo keliya maqaallada dadweynaha ee la daabacay, waqtigooda daabacaadduna gaaray. Maqaallo aan la aqoon, qabyo-qoraallo, qoraallo jadwalaysan iyo qaybaha buuxa ee loogu talagalay akoon ama xubin waxay soo celiyaan 404. Qaabab ama halbeegyo liis oo aan sax ahayn waxay soo celiyaan 400. Bartu waxay aqbashaa GET iyo HEAD; hababka wax-qorista lama taageero. Soo geliddu ma furayso dhoofin.
Dhoofinta waxaa la abuuraa marka la codsado, waxayna adeegsataa Cache-Control: no-store si qoraalka la saxay iyo isbeddellada gelitaanka mar kale loo hubiyo. Madaxa HTTP-ga ee Link wuxuu aqoonsadaa bogga HTML ee asalka rasmiga ah. Fadlan codsiyada midba mar samee, iska ilaali soo-dejinno tiro badan oo soo noqnoqda, kuna celi codsiyada fashilka ku-meelgaarka ah ee server-ka ka dib hakad.
Sheegidda ilaha, tixraacyada iyo dib-u-adeegsiga
Marka aad tixraacayso maqaal, adeegso URL-kiisa asalka rasmiga ah, cinwaankiisa, qoraaga lagu sheegay iyo taariikhda daabacaadda; qor taariikhda wax-ka-beddelka marka ay muhiim u tahay tixraacaaga. Ilaali kala duwanaanshaha u dhexeeya qayb Qur’aan ah, tarjumaad, il xiriir leh iyo sharraxaadda madasha lafteeda. Magacyada kooxaha tifaftirku waxay tilmaamaan kooxo, mana ka dhigna aqoon culimo oo qof gaar ahi leeyahay.
Milicsiyada shakhsiyeed iyo hagayaasha wax ku oolka ahi ma beddelaan waxbarid diineed oo qof u qalma bixiyo. Qoraalka tafsiirka iyo caqiidada wuxuu raacaa shuruudaha dib-u-eegista ee mabaadi’dayada tifaftirka. Sixitaannada iyo xiriirrada muhiimka ahi waa inay la socdaan maqaalka, xitaa qaybaha laga soo xigto.
Helitaanka dadweynuhu ma beddelo xuquuqda daabacaadda, mana bixinayo ruqsad dib loogu daabaco maqaallo dhammaystiran ama looga saaro aqoonsiyada. Wadaag xiriirro oo adeegso xigashooyin sharci ah oo ilahooda la sheegayo sida ku cad shuruudaheenna. Codsiyada sixitaan ama oggolaansho waxaa lagu samayn karaa Caawimo.