ब्लॉग और समाचार

तारीख़वार लेखों का एक अनुभाग मुफ़्त में क्या पाता है, और इसे नियंत्रित करने वाली तीन सेटिंग्स।

तारीख़वार पृष्ठों का कोई भी अनुभाग समाचार अनुभाग की तरह व्यवहार करता है — इसे चुनने के लिए कोई अलग लेआउट नहीं है। इस साइट पर /news/ अनुभाग एक साधारण सामग्री डायरेक्टरी है; नीचे सब कुछ फ़्रंट मैटर और कॉन्फ़िग से आता है।

लेख फ़्रंट मैटर

---
title: "Section 508 audit results published"
date: 2026-06-30
author: "Digital Services"
tags: ["Accessibility", "Performance"]
description: "Findings from the annual audit, with remediation dates."
image: "img/og-news.png"
imageAlt: "Example Agency news"
---

date, author और tags शीर्षक के नीचे एक बाइलाइन के रूप में रेंडर होते हैं। हर एक वैकल्पिक है और जब तीनों अनुपस्थित हों तो बाइलाइन पूरी तरह ग़ायब हो जाती है, यही कारण है कि दस्तावेज़ीकरण पृष्ठ — इस पृष्ठ की तरह — कोई नहीं दिखाते।

lastmod एक “अद्यतन” तारीख़ जोड़ता है, लेकिन केवल तभी जब यह वास्तव में date से बाद की हो। Hugo डिफ़ॉल्ट रूप से lastmod को date के बराबर रखता है, इसलिए एक अपरिवर्तित पृष्ठ चुप रहता है।

विषय अपने टर्म पृष्ठ से लिंक होते हैं। वे लिंक कहाँ जाते हैं यह टैक्सोनॉमी तय करती है, बाइलाइन नहीं।

लिस्टिंग शैली

एक अनुभाग अपनी लिस्टिंग के रेंडर होने का तरीका अपने _index.md से चुनता है:

---
title: "News"
collection_variant: "cards"     # "" | condensed | calendar | media | cards
card_grid: "tablet:grid-col-6 desktop:grid-col-4"   # cards only
---

cards एक usa-card-group रेंडर करता है। हर पोस्ट एक कार्ड बन जाता है जो अपना पहला टैग किकर के रूप में, यदि हो तो अपनी छवि, अपना विवरण, और अपनी बाइलाइन ले जाता है — वह रूप जो USWDS की अपनी साइट किसी समाचार आइटम को कार्ड घटक के माध्यम से देती है। शीर्षक पोस्ट से लिंक होता है और फ़ुटर बटन उसी लिंक को दोहराता है, शीर्षक के साथ लेबल किया गया ताकि संदर्भ से बाहर लिंक पढ़ने वाला स्क्रीन रीडर एक जैसे “और पढ़ें” के कॉलम से न जूझे।

बाकी सब कुछ एक usa-collection है: डिफ़ॉल्ट, लंबी सूचियों के लिए condensed, तारीख़ ब्लॉक के लिए calendar, थंबनेल के लिए media। कार्ड छवियों वाले छोटे फ़ीड के लिए उपयुक्त हैं; एक सौ प्रविष्टियों पर भी कलेक्शन पठनीय बना रहता है।

पृष्ठांकन

लिस्टिंग पृष्ठ Hugo की [pagination] सेटिंग पर पृष्ठांकित होते हैं:

[pagination]
  pagerSize = 5

एक पृष्ठ से छोटे अनुभाग बिल्कुल कोई नियंत्रण रेंडर नहीं करते, और प्रविष्टियाँ अपने URL बनाए रखती हैं — पृष्ठांकन ऐसी चीज़ नहीं है जिसकी क़ीमत एक छोटा अनुभाग चुकाए। इसे बंद करने के लिए pagerSize ऊँचा सेट करें।

तीन नहीं, एक आगे बढ़ने वाला ब्लॉक

एक लेख आगे बढ़ने के ठीक एक तरीक़े के साथ समाप्त होता है: जब संबंधित-सामग्री सूचकांक मेल ढूँढता है तो संबंधित सामग्री, और जब नहीं ढूँढता तो पिछला / अगला।

यह एक जान-बूझकर लगाई गई सीमा है, न कि कोई छूटी हुई सुविधा। एक लेख जो हर सहोदर को सूचीबद्ध करने वाला साइड नेव, उन्हीं सहोदरों से निकाला गया पिछला/अगला जोड़ा, और उन्हीं से फिर से निकाली गई संबंधित सूची ले जाता है — वह नेविगेशन तीन गुना नहीं है, बल्कि एक ही निर्णय पाठक के सामने तीन बार रखा गया है।

यह विभाजन सामग्री का अनुसरण करता है। एक तारीख़वार फ़ीड में पढ़ने लायक कोई क्रम नहीं होता, इसलिए “इस जैसा और” उपयोगी प्रस्ताव है; एक दस्तावेज़ीकरण वृक्ष क्रमबद्ध होता है, इसलिए “अगला वाला” है। अनुभाग अपने _index.md से साइड नेविगेशन से बाहर निकलते हैं:

---
title: "News"
cascade:
  sidenav: false
---

दस्तावेज़ीकरण अनुभाग sidenav को अनसेट छोड़ते हैं और वृक्ष बनाए रखते हैं।

संबंधित सामग्री

संबंधित सामग्री को आपकी साइट के कॉन्फ़िग में कॉन्फ़िगर किए गए एक सूचकांक की ज़रूरत होती है, थीम के कॉन्फ़िग में नहीं: Hugo एक अंतर्निहित [related] डिफ़ॉल्ट के साथ आता है, और एक थीम का कॉन्फ़िग केवल इसमें जोड़ सकता है, कभी इसकी जगह नहीं ले सकता। जब तक आप नीचे दिया ब्लॉक कॉपी नहीं करते, लेख पिछला/अगला लिंक पर वापस चले जाते हैं।

[related]
  threshold = 80
  includeNewer = true

  [[related.indices]]
    name = "tags"
    weight = 100
  [[related.indices]]
    name = "date"
    weight = 10

includeNewer = true रखने लायक है। Hugo का false डिफ़ॉल्ट केवल पुराने पृष्ठों को देखता है, जिसका मतलब है कि सबसे नया लेख — आमतौर पर सबसे ज़्यादा देखा जाने वाला — कभी कुछ नहीं दिखाता।

विषय पृष्ठ

/tags/ हर विषय को एक गिनती के साथ सूचीबद्ध करता है; /tags/accessibility/ इसके अंतर्गत दर्ज पृष्ठों को सूचीबद्ध करता है, पृष्ठांकित। दोनों एक ही tags फ़्रंट मैटर से जनरेट होते हैं, और दोनों साइट द्वारा घोषित किसी भी टैक्सोनॉमी के लिए काम करते हैं, केवल टैग के लिए नहीं।

विषय सूचकांक जान-बूझकर पृष्ठांकित नहीं है: क्रमांकित पृष्ठों में बँटी शब्दावली उस टर्म को छुपा देती है जिसे पाठक खोज रहा है।

शेयर छवियाँ

साइट प्रीव्यू के लिंक एक छवि के साथ, इस क्रम में हल किए जाते हैं:

1. फ़्रंट मैटर में images — Hugo का सम्मेलन, एक सूची, पहली प्रविष्टि जीतती है
2. फ़्रंट मैटर में image
3. params.uswds.ogImage, साइट-व्यापी फ़ॉलबैक

[params.uswds]
  ogImage = "img/og-default.png"
  ogImageAlt = "Example Agency"
  twitter = "@example_agency"     # optional, adds twitter:site

पाथ पहले पेज-बंडल संसाधनों के रूप में हल होते हैं, फिर assets/, फिर static/; एक पूर्ण URL को जैसा है वैसा उपयोग किया जाता है। 1200px से चौड़ी छवियों का आकार घटाया जाता है, और उन्हें कभी अनुशंसित 1200x630 पर क्रॉप नहीं किया जाता — एक वर्गाकार सील या पोर्ट्रेट कार्ड में अपना ऊपरी आधा भाग खोने के बजाय लेटरबॉक्स होता है।

साज-सज्जा को बंद करना

[params.uswds.article]
  date = true       # byline
  prevNext = true   # the fallback when there is no related content
  related = 3       # how many related pages to list; 0 makes prev/next the
                    # onward block on every page, tagged or not

sidenav एक साइट पैरामीटर के बजाय प्रति-अनुभाग फ़्रंट मैटर है, क्योंकि एक साइट आमतौर पर एक अनुभाग में वृक्ष और दूसरे में फ़ीड चाहती है।