Kontentga o'tish

Yangi maqolani qanday qo'shsak bo'ladi?

  •  hayot
  • Yangilangan: soat 03:40

    Bu erda saytimizda mavzusida yangi postlar(maqolalar) chop qilish bo’yicha ba’zi qoidalar/tavsiyalar, maslahatlar mavjud.

    Mundarija

    Mundarijani ochish

    Frontmatter

    Frontmatter - bu blog posti (maqolasi) haqidagi muhim ma’lumotlarni saqlash uchun asosiy joy. Frontmatter maqolaning yuqori qismida joylashgan va YAML formatida yozilgan. Frontmatter va undan foydalanish haqida astro documentation dan koʻproq oʻqishingiz mumkin.

    Bu erda har bir post uchun frontmatter xususiyatlari ro’yxati.

    PropertyDescription - VazifasiIzoh
    titleMaqolaning sarlavhasi. (h1)Kiritish shart*
    descriptionPostning tavsifi. Postdan parcha va postning sayt tavsifida foydalaniladi.Kiritish shart*
    pubDatetimeISO 8601 formatida nashr etilgan sana vaqti.Kiritish shart*
    modDatetimeISO 8601 formatida o’zgartirilgan sana vaqti. (faqat blog posti o’zgartirilganda ushbu xususiyatni qo’shing)Kiritish ixtiyory
    authorPostning muallifidefault = SITE.author
    slugPost uchun slug. Bu maydon ixtiyoriy, lekin boʻsh qator boʻla olmaydi. (slug: ""❌)default = slugified file name
    featuredUshbu post bosh sahifaning tanlangan qismida ko’rsatilsinmi yoki yo’qmidefault = false
    draftUshbu postni “nashr qilinmagan” deb belgilang.default = false
    tagsUshbu post uchun tegishli kalit so’zlar. Massiv yaml formatida yozilgan.default = others
    ogImagePostning OG tasviri. Ijtimoiy tarmoqlarni almashish va SEO uchun foydali.default = SITE.ogImage or generated OG image
    canonicalURLKanonik URL (absolute), agar maqola boshqa manbada mavjud bo’lsa.default = Astro.site + Astro.url.pathname

    Tip! ISO 8601 datetime formati uchun na’muna 2024-02-19T15:40:00Z . Batafsil: https://en.wikipedia.org/wiki/ISO_8601

    Faqat title, description va pubDatetime maydonlari ko’rsatilishi shart. Qolgan barchasi ixtiyoriy yoki default qiymatlari mavjud!

    Sarlavha va tavsif (ko’chirma) qidiruv tizimini optimallashtirish (SEO) uchun muhim va shuning uchun ularni blog postlariga qo’shish shart.

    slug urlning takrorlanmas identifikatoridir. Shunday qilib, slug takrorlanmas va boshqa postlardan farqli bo’lishi kerak. slug bo’sh joyini - yoki _ bilan ajratish kerak, lekin - tavsiya etiladi. Slug blog post fayl nomidan foydalanib avtomatik tarzda yasaladi. Biroq, siz o’zingizning slug ingizni blog postingizda belgilashingiz mumkin.

    Masalan, maqola fayl nomi yangi-maqola-qoshish.md bo’lsa va siz frontmatterda slugni ko’rsatmasangiz, sayt fayl nomidan foydalanib slugni yasaydi. Bu quyidagicha bo’ladi: adding-new-post. Lekin siz formatterda slugni ko’rsatsangi shu qiymat olinadi. Ko’proq o’qish uchun link: Astro Docs.

    Agar blog postda tags qoldirilmasa (boshqacha qilib aytganda, teg ko’rsatilmagan bo’lsa), umumiy tegi ushbu post uchun teg sifatida ishlatiladi.

    Frontmatterga namuna

    Quyida maqola uchun namunaviy formatter 👇

    # src/content/blog/yangi-maqola-qoshish.md
    ---
    title: Yangi maqolani qanday qo'shsak bo'ladi!
    author: Hayot
    pubDatetime: 2024-02-19T03:40:00Z
    modDatetime: 2024-02-19T04:40:00Z
    slug: yangi-maqola-qoshish
    featured: true
    draft: false
    tags:
      - docs
    ogImage: ""
    description: Saytga yangi maqola chop qilish uchun qo'llanmacha, xatoliklar bo'lsa Githubda pull request oching!
    canonicalURL: https://example.uz/bu-yerda-ushbu-maqola-allaqachon-chop-qilingan
    ---
    

    Mundarija qo’shish

    Odatda maqolaga mundarija qo’shilmaydi. Mundarija ni h2 formatida (markdownda ## bilan) yozing va uni postda ko’rsatilishini xohlagan joyga qo’ying. Misol uchun, agar siz mundarijani xatboshi ostiga qo’ymoqchi bo’lsangiz (odatdagidek), buni quyidagi tarzda qilishingiz mumkin.

    ---
    # frontmatter
    ---
    
    Bu erda saytimizda mavzusida yangi postlar(maqolalar) chop qilish bo'yicha ba'zi qoidalar/tavsiyalar, maslahatlar mavjud.
    
    ## Mundarija
    
    <!-- postning qolgan qismi -->
    

    Sarlavhalar

    Sarlavhalar haqida bir narsani e’tiborga olish kerak. Saytning blog postlarida postning asosiy sarlavhasi sifatida sarlavha (old mavzudagi sarlavha) ishlatiladi. Shuning uchun postdagi sarlavhaning qolgan qismi h2 ~ h6 dan foydalanishi kerak.

    Ushbu qoida majburiy emas, lekin vizual, mavjudlik va SEO maqsadlarida tavsiya etiladi.

    Blog kontenti uchun rasmlarni saqlash

    Note! Agar “style optimized images” dan foydalanish kerak bo’lasa MDX dan foydalaning.

    src/assets/ papkasi ichiga (tavsiya)

    Siz rasmlarni src/assets/ papkasiga yuklashingiz mumkin. Ushbu rasmlar Astro tomonidan avtomatik ravishda optimallashtiriladi: Image Service API.

    Rasmlardan markdownda foydalanish uchun namuna (@assets/).

    namuna.jpg rasmi quyidagi joyda joylashgan /src/assets/images/namuna.jpg.

    ![bu-yerda-rasm-korsatiladi](@assets/images/namuna.jpg)
    
    <!-- YOKI -->
    
    ![bu-yerda-rasm-korsatiladi](../../assets/images/namuna.jpg)
    
    <!-- img tegidan yoki Image componentidan bu yerda ishlamaydi ❌ -->
    <img src="@assets/images/namuna.jpg" alt="nimadir">
    <!-- ^^ Bu XATO -->
    

    Rasmlarni yuklashdan oldin siqish(compress) qilish tavsiya qilinadi. Bu saytning umumiy tezligiga ta’sir qiladi.

    OG Image

    Agar postda OG tasviri ko’rsatilmagan bo’lsa, standart OG tasviri joylashtiriladi. Garchi shart bo’lmasa-da, postga tegishli OG tasviri old masalada ko’rsatilishi kerak. OG tasviri uchun tavsiya etilgan oʻlcham 1200 X 640 px.

    Hozircha shu, xato va kamchiliklar bo'lsa Githubda pull request oching!