fix: add frontmatter titles, fix hero image and sidebar links for starlight

knowledgecode · knowledgecode · commit 5e00b13baff4 · 2026-04-29T17:53:26.000+09:00
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -19,7 +19,7 @@ export default defineConfig({
       title: 'date-and-time',
       description: 'The simplest, most intuitive date and time library',
       logo: {
-        src: './public/logo.png',
+        src: './docs/assets/logo.png',
         alt: 'date-and-time',
       },
       social: [
@@ -30,51 +30,51 @@ export default defineConfig({
         {
           label: 'Getting Started',
           items: [
-            { label: 'Introduction', slug: 'guide/index' },
-            { label: 'Installation', slug: 'guide/installation' },
-            { label: 'Quick Start', slug: 'guide/quick-start' },
+            { label: 'Introduction', link: '/guide/' },
+            { label: 'Installation', link: '/guide/installation' },
+            { label: 'Quick Start', link: '/guide/quick-start' },
           ],
         },
         {
           label: 'API Reference',
           collapsed: true,
           items: [
-            { label: 'Overview', slug: 'api/index' },
+            { label: 'Overview', link: '/api/' },
             {
               label: 'Core Functions',
               items: [
-                { label: 'format()', slug: 'api/format' },
-                { label: 'parse()', slug: 'api/parse' },
-                { label: 'compile()', slug: 'api/compile' },
-                { label: 'preparse()', slug: 'api/preparse' },
-                { label: 'isValid()', slug: 'api/isValid' },
-                { label: 'transform()', slug: 'api/transform' },
-                { label: 'addYears()', slug: 'api/addYears' },
-                { label: 'addMonths()', slug: 'api/addMonths' },
-                { label: 'addDays()', slug: 'api/addDays' },
-                { label: 'addHours()', slug: 'api/addHours' },
-                { label: 'addMinutes()', slug: 'api/addMinutes' },
-                { label: 'addSeconds()', slug: 'api/addSeconds' },
-                { label: 'addMilliseconds()', slug: 'api/addMilliseconds' },
-                { label: 'subtract()', slug: 'api/subtract' },
+                { label: 'format()', link: '/api/format' },
+                { label: 'parse()', link: '/api/parse' },
+                { label: 'compile()', link: '/api/compile' },
+                { label: 'preparse()', link: '/api/preparse' },
+                { label: 'isValid()', link: '/api/isvalid' },
+                { label: 'transform()', link: '/api/transform' },
+                { label: 'addYears()', link: '/api/addyears' },
+                { label: 'addMonths()', link: '/api/addmonths' },
+                { label: 'addDays()', link: '/api/adddays' },
+                { label: 'addHours()', link: '/api/addhours' },
+                { label: 'addMinutes()', link: '/api/addminutes' },
+                { label: 'addSeconds()', link: '/api/addseconds' },
+                { label: 'addMilliseconds()', link: '/api/addmilliseconds' },
+                { label: 'subtract()', link: '/api/subtract' },
               ],
             },
             {
               label: 'Utility Functions',
               items: [
-                { label: 'isLeapYear()', slug: 'api/utils/isLeapYear' },
-                { label: 'isSameDay()', slug: 'api/utils/isSameDay' },
-                { label: 'getDaysInMonth()', slug: 'api/utils/getDaysInMonth' },
-                { label: 'getISOWeekYear()', slug: 'api/utils/getISOWeekYear' },
-                { label: 'getISOWeek()', slug: 'api/utils/getISOWeek' },
+                { label: 'isLeapYear()', link: '/api/utils/isleapyear' },
+                { label: 'isSameDay()', link: '/api/utils/issameday' },
+                { label: 'getDaysInMonth()', link: '/api/utils/getdaysinmonth' },
+                { label: 'getISOWeekYear()', link: '/api/utils/getisoweekyear' },
+                { label: 'getISOWeek()', link: '/api/utils/getisoweek' },
               ],
             },
           ],
         },
-        { label: 'Locales', slug: 'locales' },
-        { label: 'Timezones', slug: 'timezones' },
-        { label: 'Plugins', slug: 'plugins' },
-        { label: 'Migration Guide', slug: 'migration' },
+        { label: 'Locales', link: '/locales' },
+        { label: 'Timezones', link: '/timezones' },
+        { label: 'Plugins', link: '/plugins' },
+        { label: 'Migration Guide', link: '/migration' },
       ],
     }),
   ],
diff --git a/docs/api/addDays.md b/docs/api/addDays.md
@@ -1,3 +1,7 @@
+---
+title: addDays()
+---
+
 # addDays()
 
 Adds or subtracts days from a Date object. Handles month boundaries, leap years, and daylight saving time transitions properly.
diff --git a/docs/api/addHours.md b/docs/api/addHours.md
@@ -1,3 +1,7 @@
+---
+title: addHours()
+---
+
 # addHours()
 
 Adds or subtracts hours from a Date object.
diff --git a/docs/api/addMilliseconds.md b/docs/api/addMilliseconds.md
@@ -1,3 +1,7 @@
+---
+title: addMilliseconds()
+---
+
 # addMilliseconds()
 
 Adds or subtracts milliseconds from a Date object.
diff --git a/docs/api/addMinutes.md b/docs/api/addMinutes.md
@@ -1,3 +1,7 @@
+---
+title: addMinutes()
+---
+
 # addMinutes()
 
 Adds or subtracts minutes from a Date object.
diff --git a/docs/api/addMonths.md b/docs/api/addMonths.md
@@ -1,3 +1,7 @@
+---
+title: addMonths()
+---
+
 # addMonths()
 
 Adds or subtracts months from a Date object. Handles month boundaries, leap years, and varying month lengths appropriately.
diff --git a/docs/api/addSeconds.md b/docs/api/addSeconds.md
@@ -1,3 +1,7 @@
+---
+title: addSeconds()
+---
+
 # addSeconds()
 
 Adds or subtracts seconds from a Date object.
diff --git a/docs/api/addYears.md b/docs/api/addYears.md
@@ -1,3 +1,7 @@
+---
+title: addYears()
+---
+
 # addYears()
 
 Adds or subtracts years from a Date object. Handles leap years and edge cases appropriately.
diff --git a/docs/api/compile.md b/docs/api/compile.md
@@ -1,3 +1,7 @@
+---
+title: compile()
+---
+
 # compile()
 
 Precompiles a format string into a reusable compiled object for improved performance when the same format pattern is used repeatedly.
diff --git a/docs/api/format.md b/docs/api/format.md
@@ -1,3 +1,7 @@
+---
+title: format()
+---
+
 # format()
 
 Formats a Date object according to the specified format string.
diff --git a/docs/api/index.md b/docs/api/index.md
@@ -1,3 +1,7 @@
+---
+title: API Reference
+---
+
 # API Reference
 
 Welcome to the comprehensive API reference for date-and-time v4.x. This section provides detailed documentation for all available functions, types, and options.
diff --git a/docs/api/isValid.md b/docs/api/isValid.md
@@ -1,3 +1,7 @@
+---
+title: isValid()
+---
+
 # isValid()
 
 Validates whether a date string conforms to the specified format pattern and represents a valid date.
diff --git a/docs/api/parse.md b/docs/api/parse.md
@@ -1,3 +1,7 @@
+---
+title: parse()
+---
+
 # parse()
 
 Parses a formatted date string into a Date object according to the specified format pattern.
diff --git a/docs/api/preparse.md b/docs/api/preparse.md
@@ -1,3 +1,7 @@
+---
+title: preparse()
+---
+
 # preparse()
 
 Pre-parses date strings and returns intermediate parsing results. This function is useful when you need to examine parsing details before creating a final Date object.
diff --git a/docs/api/subtract.md b/docs/api/subtract.md
@@ -1,3 +1,7 @@
+---
+title: subtract()
+---
+
 # subtract()
 
 Calculates the difference between two Date objects and returns a rich Duration object with multiple time units and formatting options.
diff --git a/docs/api/transform.md b/docs/api/transform.md
@@ -1,3 +1,7 @@
+---
+title: transform()
+---
+
 # transform()
 
 Transforms date strings from one format to another. This is a convenience function that combines parse() and format() operations.
diff --git a/docs/api/utils/getDaysInMonth.md b/docs/api/utils/getDaysInMonth.md
@@ -1,3 +1,7 @@
+---
+title: getDaysInMonth()
+---
+
 # getDaysInMonth()
 
 Returns the number of days in a given month of a specific year. Correctly handles leap years when calculating February.
diff --git a/docs/api/utils/getISOWeek.md b/docs/api/utils/getISOWeek.md
@@ -1,3 +1,7 @@
+---
+title: getISOWeek()
+---
+
 # getISOWeek()
 
 Returns the ISO 8601 week number (1–53) for a given date. ISO weeks start on Monday, and week 1 is the week containing the first Thursday of the year.
diff --git a/docs/api/utils/getISOWeekYear.md b/docs/api/utils/getISOWeekYear.md
@@ -1,3 +1,7 @@
+---
+title: getISOWeekYear()
+---
+
 # getISOWeekYear()
 
 Returns the ISO 8601 week year for a given date. The ISO week year may differ from the calendar year near the start and end of the year, because ISO weeks always start on Monday and the first week of the year is the one containing the first Thursday of the year.
diff --git a/docs/api/utils/isLeapYear.md b/docs/api/utils/isLeapYear.md
@@ -1,3 +1,7 @@
+---
+title: isLeapYear()
+---
+
 # isLeapYear()
 
 Determines if a given year is a leap year according to the Gregorian calendar rules.
diff --git a/docs/api/utils/isSameDay.md b/docs/api/utils/isSameDay.md
@@ -1,3 +1,7 @@
+---
+title: isSameDay()
+---
+
 # isSameDay()
 
 Checks if two Date objects represent the same calendar day, regardless of time.
diff --git a/docs/assets/logo.png b/docs/assets/logo.png
diff --git a/docs/guide/index.md b/docs/guide/index.md
@@ -1,3 +1,7 @@
+---
+title: Introduction
+---
+
 # Introduction
 
 **date-and-time** is the simplest, most intuitive date and time library for JavaScript and TypeScript. Built from the ground up with modern development practices, it provides a comprehensive set of tools for date manipulation, formatting, parsing, and timezone handling.
diff --git a/docs/guide/quick-start.md b/docs/guide/quick-start.md
@@ -1,3 +1,7 @@
+---
+title: Quick Start
+---
+
 # Quick Start
 
 This guide will get you up and running with date-and-time in just a few minutes.
diff --git a/docs/index.mdx b/docs/index.mdx
@@ -6,8 +6,7 @@ hero:
   title: date-and-time
   tagline: The simplest, most intuitive date and time library. Modern TypeScript library for date manipulation with full ES Modules support.
   image:
-    src: /date-and-time/logo.png
-    alt: date-and-time
+    html: '<img src="/date-and-time/logo.png" alt="date-and-time" style="max-height:16rem;width:auto;" />'
   actions:
     - text: Get Started
       link: /date-and-time/guide/
diff --git a/docs/locales.md b/docs/locales.md
@@ -1,3 +1,7 @@
+---
+title: Supported Locales
+---
+
 # Supported Locales
 
 - ar (Arabic)
diff --git a/docs/migration.md b/docs/migration.md
@@ -1,3 +1,7 @@
+---
+title: Migration Guide
+---
+
 # Migration Guide
 
 Version `4.x` has been completely rewritten in TypeScript and some features from `3.x` are no longer compatible. This section explains the changes to each feature and the migration methods.
diff --git a/docs/plugins.md b/docs/plugins.md
@@ -1,3 +1,7 @@
+---
+title: Plugins
+---
+
 # Plugins
 
 `date-and-time` adopts a plugin system. Special tokens used relatively infrequently are provided as plugins outside the main library. By adding plugins as needed, you can use those tokens in `Formatter` and `Parser`. Here, `Formatter` refers to the output engine used by the `format` function, and `Parser` refers to the parsing engine used by the `parse`, `preparse`, and `isValid` functions. These engines are extended by adding plugins as arguments to these functions.
diff --git a/docs/timezones.md b/docs/timezones.md
@@ -1,3 +1,7 @@
+---
+title: Supported Timezones
+---
+
 # Supported Timezones
 
 ## Import Methods
