‏JSON-LD چیه و چطور به سایت شخصی‌ت اضافه‌ش کنی

نویسنده مقاله رو با یه تعریف ساده شروع می‌کنه: JSON-LD (مخفف JSON Linked Data) یه قالب برای افزودن داده‌ی ساختارمند به صفحه‌های وبه. به گفته‌ی اون این کار به کراولرها کمک می‌کنه ساختار معناییِ سایتت رو بفهمن، باعث می‌شه واجد شرایط لینک‌پرسیوهای غنی‌تر بشی و حتی شاید رتبه‌ی جست‌وجوت رو بهتر کنه. خودش می‌گه بعد از حدود ۱۰۰ ساعت کار روی سایت شخصی‌ش، JSON-LD رو به تک‌تک صفحه‌ها اضافه کرده.

روش کار ساده‌ست: یه عنصر اسکریپت با نوع application/ld+json یه جایی تو بخش هد (head) صفحه می‌ذاری و شیء JSON‌ت رو داخلش می‌ریزی. نکته‌ای که نویسنده توضیح می‌ده اینه که چون این عنصر اون نوع MIME رو داره، موتور جاوااسکریپت مرورگر اجراش نمی‌کنه؛ در عوض کراولرهای تخصصی مثل Googlebot دنبال همین عنصرها می‌گردن و محتواش رو پارس می‌کنن.

خودِ شیء JSON-LD ساختار پایه‌ش این شکلیه:

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "WebSite", "url": "https://example.com/", "name": "Your Name" }
  ]
}

نویسنده هر تکه رو باز می‌کنه: ویژگی @context روی تنظیم می‌شه، چون تو JSON-LD همین زمینه‌ست که ساختار داده رو تعیین می‌کنه و کراولرها روی Schema.org استاندارد شدن که مشخص می‌کنه چه جفت‌کلید-مقدارهایی معتبرن. بعد داخل آرایه‌ی @graph می‌تونی صفحه و موجودیت‌هات رو با @typeهای مختلف توصیف کنی.

برای یه سایت شخصی، به گفته‌ی نویسنده می‌تونی از نوع Person استفاده کنی و فیلدهایی مثل نام، عنوان شغلی، زبان‌هایی که بلدی (knowsLanguage)، موضوعاتی که واردشونی (knowsAbout)، ملیت و محل زندگی رو پر کنی. یه نکته‌ی مفید هم استفاده از sameAs ه: با لینک دادن به صفحه‌های ویکی‌دیتا و ویکی‌پدیای مثلاً مدرسه یا دانشگاهت، به کراولر کمک می‌کنی موجودیت‌ها رو دقیق‌تر تشخیص بده و ابهام‌زدایی کنه.

نکات کلیدی:

• JSON-LD داده‌ی ساختارمند به صفحه اضافه می‌کنه تا کراولرها ساختار معناییش رو بفهمن.
• با یه عنصر اسکریپت با نوع application/ld+json تو بخش هد اضافه می‌شه و مرورگر اجراش نمی‌کنه.
• @context روی Schema.org ساختار داده رو تعیین می‌کنه و @graph موجودیت‌ها رو توصیف می‌کنه.
• برای سایت شخصی، نوع Person و فیلد sameAs (لینک به ویکی‌پدیا/ویکی‌دیتا) به ابهام‌زدایی کمک می‌کنن.