From f5526f86225684f346ecfff264cde919a650fdb3 Mon Sep 17 00:00:00 2001
From: radishzzz <shuyinsen@gmail.com>
Date: Fri, 14 Mar 2025 14:23:35 +0000
Subject: [PATCH] refactor: rename functions

---
 src/components/Comments/Waline.astro | 10 +++-------
 src/components/MainHeader.astro      |  5 ++---
 src/components/MobileHeader.astro    |  5 ++---
 src/components/Navbar.astro          |  5 ++---
 src/components/PostTime.astro        |  3 +--
 src/i18n/path.ts                     |  7 ++++++-
 src/i18n/route.ts                    | 20 ++++++++++----------
 src/layouts/Layout.astro             |  4 ++--
 src/pages/[lang]/about.astro         |  4 ++--
 src/pages/[lang]/atom.xml.ts         |  4 ++--
 src/pages/[lang]/index.astro         |  4 ++--
 src/pages/[lang]/posts/[slug].astro  |  4 ++--
 src/pages/[lang]/rss.xml.ts          |  4 ++--
 src/pages/[lang]/tags/[tag].astro    |  4 ++--
 src/pages/[lang]/tags/index.astro    |  4 ++--
 src/pages/posts/[slug].astro         |  4 ++--
 src/pages/tags/[tag].astro           |  4 ++--
 17 files changed, 46 insertions(+), 49 deletions(-)

diff --git a/src/components/Comments/Waline.astro b/src/components/Comments/Waline.astro
index 564aa8f..8314bd7 100644
--- a/src/components/Comments/Waline.astro
+++ b/src/components/Comments/Waline.astro
@@ -17,9 +17,6 @@ const {
   imageUploader = false,
 } = themeConfig.comment?.waline ?? {}
 
-// Get current path
-const currentPath = Astro.url.pathname
-
 // Get the language code of Waline
 function getWalineLang(currentPath: string, defaultLocale: string): string {
   // Extract language code from path
@@ -32,7 +29,7 @@ function getWalineLang(currentPath: string, defaultLocale: string): string {
 }
 
 // Get Waline language and generate configuration
-const walineLang = getWalineLang(currentPath, defaultLocale)
+const walineLang = getWalineLang(Astro.url.pathname, defaultLocale)
 const walineConfigJson = JSON.stringify({
   serverURL,
   lang: walineLang,
@@ -49,8 +46,7 @@ const walineConfigJson = JSON.stringify({
 >
 </div>
 
-<!-- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
-<!-- Not use is:inline or define:vars -->
+<!-- Not use is:inline or define:vars >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
 <script>
 import { init } from '@waline/client'
 import '@waline/client/style'
@@ -76,7 +72,7 @@ initWaline()
 document.addEventListener('astro:after-swap', initWaline)
 </script>
 
-<!-- Custom css styles >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
+<!-- Custom css styles >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
 <style is:global>
 #waline .wl-login-info {
   --at-apply: 'mt-0 mr-3'
diff --git a/src/components/MainHeader.astro b/src/components/MainHeader.astro
index 1816352..9298a7b 100644
--- a/src/components/MainHeader.astro
+++ b/src/components/MainHeader.astro
@@ -1,11 +1,10 @@
 ---
 import themeConfig from '@/config'
-import { getPagePath } from '@/i18n/path'
+import { getPageInfo } from '@/i18n/path'
 
 const { title, subtitle } = themeConfig.site
 const { titleSpace } = themeConfig.global
-const currentPath = Astro.url.pathname
-const { getLocalizedPath } = getPagePath(currentPath)
+const { getLocalizedPath } = getPageInfo(Astro.url.pathname)
 
 const marginBottom = {
     1: 'mb-0.625',
diff --git a/src/components/MobileHeader.astro b/src/components/MobileHeader.astro
index 71f6ad1..c15ea82 100644
--- a/src/components/MobileHeader.astro
+++ b/src/components/MobileHeader.astro
@@ -1,11 +1,10 @@
 ---
 import themeConfig from '@/config'
-import { getPagePath } from '@/i18n/path'
+import { getPageInfo } from '@/i18n/path'
 
 const { title, subtitle } = themeConfig.site
 const { titleSpace } = themeConfig.global
-const currentPath = Astro.url.pathname
-const { getLocalizedPath } = getPagePath(currentPath)
+const { getLocalizedPath } = getPageInfo(Astro.url.pathname)
 
 const marginBottom = {
     1: 'mb-1.625',
diff --git a/src/components/Navbar.astro b/src/components/Navbar.astro
index ed8da17..10b52f9 100644
--- a/src/components/Navbar.astro
+++ b/src/components/Navbar.astro
@@ -1,10 +1,9 @@
 ---
-import { getPagePath } from '@/i18n/path'
+import { getPageInfo } from '@/i18n/path'
 import { ui } from '@/i18n/ui'
 
-const currentPath = Astro.url.pathname
 const { currentLang, isHome, isPost, isTag, isAbout, getLocalizedPath }
-  = getPagePath(currentPath)
+  = getPageInfo(Astro.url.pathname)
 const currentUI = ui[currentLang as keyof typeof ui]
 
 const isPostActive = isHome || isPost
diff --git a/src/components/PostTime.astro b/src/components/PostTime.astro
index 077ec7f..3198d0b 100644
--- a/src/components/PostTime.astro
+++ b/src/components/PostTime.astro
@@ -10,8 +10,7 @@ interface Props {
 
 const { date, updatedDate, minutes } = Astro.props
 const format = themeConfig.global.dateFormat
-const currentPath = Astro.url.pathname
-const isPost = isPostPage(currentPath)
+const isPost = isPostPage(Astro.url.pathname)
 const timeSpacingClass = isPost ? 'ml-1.75' : 'ml-1.5'
 
 function formatDate(date: Date, format: 'YYYY-MM-DD' | 'MM-DD-YYYY' | 'DD-MM-YYYY' | 'MONTH DAY YYYY' | 'DAY MONTH YYYY') {
diff --git a/src/i18n/path.ts b/src/i18n/path.ts
index e42b77d..696f266 100644
--- a/src/i18n/path.ts
+++ b/src/i18n/path.ts
@@ -1,9 +1,11 @@
 import { defaultLocale, moreLocales } from '@/i18n/config'
 
+// Removes leading and trailing slashes from a path
 export function cleanPath(path: string) {
   return path.replace(/^\/|\/$/g, '')
 }
 
+// Gets the language code from the current path
 export function getLangFromPath(path: string) {
   const secondaryLang = moreLocales.find(
     lang =>
@@ -12,6 +14,7 @@ export function getLangFromPath(path: string) {
   return secondaryLang || defaultLocale
 }
 
+// Generates a localized path based on current language
 export function getLocalizedPath(path: string, currentLang?: string) {
   const clean = cleanPath(path)
   const lang = currentLang || getLangFromPath(path)
@@ -23,6 +26,7 @@ export function getLocalizedPath(path: string, currentLang?: string) {
   return lang === defaultLocale ? `/${clean}/` : `/${lang}/${clean}/`
 }
 
+// Checks if the current path is the home/post/tag/about page
 export function isHomePage(path: string) {
   const clean = cleanPath(path)
   return clean === '' || moreLocales.includes(clean)
@@ -40,7 +44,8 @@ export function isAboutPage(path: string) {
   return clean.startsWith('about') || moreLocales.some(lang => clean.startsWith(`${lang}/about`))
 }
 
-export function getPagePath(path: string) {
+// Returns page context including language and page type information
+export function getPageInfo(path: string) {
   const currentLang = getLangFromPath(path)
 
   return {
diff --git a/src/i18n/route.ts b/src/i18n/route.ts
index 89fbe13..300b6be 100644
--- a/src/i18n/route.ts
+++ b/src/i18n/route.ts
@@ -1,16 +1,16 @@
 import type { CollectionEntry } from 'astro:content'
 import { allLocales, defaultLocale, moreLocales } from '@/i18n/config'
 
-// 生成默认语言标签页面的路径配置
-export function generateTagPaths(tags: string[]) {
+// 生成默认语言标签页面的路由配置
+export function getTagRoutes(tags: string[]) {
   return tags.map(tag => ({
     params: { tag },
     props: { tag },
   }))
 }
 
-// 生成默认语言文章页面的路径配置
-export function generatePostPaths(posts: CollectionEntry<'posts'>[]) {
+// 生成默认语言文章页面的路由配置
+export function getPostRoutes(posts: CollectionEntry<'posts'>[]) {
   // 创建slug到语言的映射
   const slugToLangs: Record<string, string[]> = {}
 
@@ -45,15 +45,15 @@ export function generatePostPaths(posts: CollectionEntry<'posts'>[]) {
   }))
 }
 
-// 生成更多语言静态路径
-export function generateMultiLangPaths() {
+// 生成更多语言静态路由
+export function getMultiLangRoutes() {
   return moreLocales.map(lang => ({
     params: { lang },
   }))
 }
 
-// 生成更多语言标签页面的路径配置
-export function generateMultiLangTagPaths(tags: string[]) {
+// 生成更多语言标签页面的路由配置
+export function getMultiLangTagRoutes(tags: string[]) {
   return moreLocales.flatMap(lang => (
     tags.map(tag => ({
       params: { lang, tag },
@@ -62,8 +62,8 @@ export function generateMultiLangTagPaths(tags: string[]) {
   ))
 }
 
-// 生成更多语言文章页面的路径配置
-export function generateMultiLangPostPaths(posts: CollectionEntry<'posts'>[]) {
+// 生成更多语言文章页面的路由配置
+export function getMultiLangPostRoutes(posts: CollectionEntry<'posts'>[]) {
   // 创建slug到语言的映射
   const slugToLangs: Record<string, string[]> = {}
 
diff --git a/src/layouts/Layout.astro b/src/layouts/Layout.astro
index d32384e..c865bca 100644
--- a/src/layouts/Layout.astro
+++ b/src/layouts/Layout.astro
@@ -9,7 +9,7 @@ import LanguageSwitcher from '@/components/Widgets/LanguageSwitcher.astro'
 // import Scrollbar from '@/components/Scrollbar.astro'
 import ThemeToggle from '@/components/Widgets/ThemeToggle.astro'
 import themeConfig from '@/config'
-import { getPagePath } from '@/i18n/path'
+import { getPageInfo } from '@/i18n/path'
 import Head from '@/layouts/Head.astro'
 
 import '@/styles/font.css'
@@ -24,7 +24,7 @@ interface Props {
 }
 
 const { postTitle, postDescription, postSlug, supportedLangs = [] } = Astro.props
-const { isHome, isPost } = getPagePath(Astro.url.pathname)
+const { isHome, isPost } = getPageInfo(Astro.url.pathname)
 const { light: { background: lightMode }, dark: { background: darkMode } } = themeConfig.color
 const fontStyle = themeConfig.global.fontStyle === 'serif' ? 'font-serif' : 'font-sans'
 const footerMarginClass = isPost && themeConfig.comment?.waline?.serverURL
diff --git a/src/pages/[lang]/about.astro b/src/pages/[lang]/about.astro
index 9b32ec7..8659753 100644
--- a/src/pages/[lang]/about.astro
+++ b/src/pages/[lang]/about.astro
@@ -1,9 +1,9 @@
 ---
-import { generateMultiLangPaths } from '@/i18n/route'
+import { getMultiLangRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 
 export function getStaticPaths() {
-  return generateMultiLangPaths()
+  return getMultiLangRoutes()
 }
 ---
 
diff --git a/src/pages/[lang]/atom.xml.ts b/src/pages/[lang]/atom.xml.ts
index 81064f2..9acc10b 100644
--- a/src/pages/[lang]/atom.xml.ts
+++ b/src/pages/[lang]/atom.xml.ts
@@ -1,6 +1,6 @@
 import type { APIContext } from 'astro'
 import themeConfig from '@/config'
-import { generateMultiLangPaths } from '@/i18n/route'
+import { getMultiLangRoutes } from '@/i18n/route'
 import { generateRSS } from '@/utils/rss'
 
 const { moreLocales } = themeConfig.global
@@ -10,7 +10,7 @@ type SupportedLanguage = typeof moreLocales[number]
 
 // Generate static paths for all supported languages
 export function getStaticPaths() {
-  return generateMultiLangPaths()
+  return getMultiLangRoutes()
 }
 
 export async function GET({ params }: APIContext) {
diff --git a/src/pages/[lang]/index.astro b/src/pages/[lang]/index.astro
index 3d1a8e5..5b05c91 100644
--- a/src/pages/[lang]/index.astro
+++ b/src/pages/[lang]/index.astro
@@ -1,11 +1,11 @@
 ---
 import PostList from '@/components/PostList.astro'
-import { generateMultiLangPaths } from '@/i18n/route'
+import { getMultiLangRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { getPinnedPosts, getPostsByYear } from '@/utils/content'
 
 export function getStaticPaths() {
-  return generateMultiLangPaths()
+  return getMultiLangRoutes()
 }
 
 const { lang } = Astro.params
diff --git a/src/pages/[lang]/posts/[slug].astro b/src/pages/[lang]/posts/[slug].astro
index 2e975a3..5aeb047 100644
--- a/src/pages/[lang]/posts/[slug].astro
+++ b/src/pages/[lang]/posts/[slug].astro
@@ -1,7 +1,7 @@
 ---
 import Comments from '@/components/Comments/index.astro'
 import PostTime from '@/components/PostTime.astro'
-import { generateMultiLangPostPaths } from '@/i18n/route'
+import { getMultiLangPostRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { checkSlugDuplication } from '@/utils/content'
 import { generateDescription } from '@/utils/description'
@@ -15,7 +15,7 @@ export async function getStaticPaths() {
     throw new Error(`Slug conflicts found:\n${duplicates.join('\n')}`)
   }
 
-  return generateMultiLangPostPaths(posts)
+  return getMultiLangPostRoutes(posts)
 }
 
 const { lang } = Astro.params
diff --git a/src/pages/[lang]/rss.xml.ts b/src/pages/[lang]/rss.xml.ts
index 81064f2..9acc10b 100644
--- a/src/pages/[lang]/rss.xml.ts
+++ b/src/pages/[lang]/rss.xml.ts
@@ -1,6 +1,6 @@
 import type { APIContext } from 'astro'
 import themeConfig from '@/config'
-import { generateMultiLangPaths } from '@/i18n/route'
+import { getMultiLangRoutes } from '@/i18n/route'
 import { generateRSS } from '@/utils/rss'
 
 const { moreLocales } = themeConfig.global
@@ -10,7 +10,7 @@ type SupportedLanguage = typeof moreLocales[number]
 
 // Generate static paths for all supported languages
 export function getStaticPaths() {
-  return generateMultiLangPaths()
+  return getMultiLangRoutes()
 }
 
 export async function GET({ params }: APIContext) {
diff --git a/src/pages/[lang]/tags/[tag].astro b/src/pages/[lang]/tags/[tag].astro
index 91faebd..7f6c066 100644
--- a/src/pages/[lang]/tags/[tag].astro
+++ b/src/pages/[lang]/tags/[tag].astro
@@ -1,12 +1,12 @@
 ---
 import PostList from '@/components/PostList.astro'
-import { generateMultiLangTagPaths } from '@/i18n/route'
+import { getMultiLangTagRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { getAllTags, getPostsByTag } from '@/utils/content'
 
 export async function getStaticPaths() {
   const tags = await getAllTags()
-  return generateMultiLangTagPaths(tags)
+  return getMultiLangTagRoutes(tags)
 }
 
 const { lang } = Astro.params
diff --git a/src/pages/[lang]/tags/index.astro b/src/pages/[lang]/tags/index.astro
index 86dbb60..ef9e752 100644
--- a/src/pages/[lang]/tags/index.astro
+++ b/src/pages/[lang]/tags/index.astro
@@ -1,10 +1,10 @@
 ---
-import { generateMultiLangPaths } from '@/i18n/route'
+import { getMultiLangRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { getAllTags } from '@/utils/content'
 
 export function getStaticPaths() {
-  return generateMultiLangPaths()
+  return getMultiLangRoutes()
 }
 
 const { lang } = Astro.params
diff --git a/src/pages/posts/[slug].astro b/src/pages/posts/[slug].astro
index 324dede..e1ca80f 100644
--- a/src/pages/posts/[slug].astro
+++ b/src/pages/posts/[slug].astro
@@ -1,7 +1,7 @@
 ---
 import Comments from '@/components/Comments/index.astro'
 import PostTime from '@/components/PostTime.astro'
-import { generatePostPaths } from '@/i18n/route'
+import { getPostRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { checkSlugDuplication } from '@/utils/content'
 import { generateDescription } from '@/utils/description'
@@ -15,7 +15,7 @@ export async function getStaticPaths() {
     throw new Error(`Slug conflicts found:\n${duplicates.join('\n')}`)
   }
 
-  return generatePostPaths(posts)
+  return getPostRoutes(posts)
 }
 
 const { post, supportedLangs = [] } = Astro.props
diff --git a/src/pages/tags/[tag].astro b/src/pages/tags/[tag].astro
index fa34d43..f1f49d9 100644
--- a/src/pages/tags/[tag].astro
+++ b/src/pages/tags/[tag].astro
@@ -1,12 +1,12 @@
 ---
 import PostList from '@/components/PostList.astro'
-import { generateTagPaths } from '@/i18n/route'
+import { getTagRoutes } from '@/i18n/route'
 import Layout from '@/layouts/Layout.astro'
 import { getAllTags, getPostsByTag } from '@/utils/content'
 
 export async function getStaticPaths() {
   const tags = await getAllTags()
-  return generateTagPaths(tags)
+  return getTagRoutes(tags)
 }
 
 const { tag } = Astro.props