From fedf4cee1e5e2a7c4036908b8064b60d27b0b207 Mon Sep 17 00:00:00 2001
From: radishzzz <shuyinsen@gmail.com>
Date: Sat, 22 Mar 2025 22:54:23 +0000
Subject: [PATCH] chore: update comments for consistency, improve code
 readability and structure

---
 README.md                                     |  2 +-
 README.zh.md                                  |  2 +-
 src/components/Button.astro                   |  8 ++---
 src/components/Comments/Waline.astro          | 10 +++---
 src/components/Comments/index.astro           |  1 +
 src/components/Footer.astro                   |  2 +-
 src/components/Header.astro                   |  2 +-
 src/components/PostList.astro                 |  1 +
 .../Widgets/{BackHome.astro => GoBack.astro}  |  2 ++
 src/config.ts                                 |  2 +-
 src/content/config.ts                         |  4 +--
 src/content/posts/Markdown Style Guide-en.md  | 36 ++++++-------------
 .../{example => examples}/容忍与自由-en.md    |  0
 .../{example => examples}/容忍与自由-es.md    |  0
 .../{example => examples}/容忍与自由-ja.md    |  0
 .../{example => examples}/容忍与自由-ru.md    |  0
 .../{example => examples}/容忍与自由-zh-tw.md |  0
 .../{example => examples}/容忍与自由-zh.md    |  0
 .../posts/{example => examples}/故乡-en.md    |  0
 .../posts/{example => examples}/故乡-es.md    |  0
 .../posts/{example => examples}/故乡-ja.md    |  0
 .../posts/{example => examples}/故乡-ru.md    |  0
 .../posts/{example => examples}/故乡-zh-tw.md |  0
 .../posts/{example => examples}/故乡-zh.md    |  0
 .../posts/{example => examples}/羅生門-en.md  |  0
 .../posts/{example => examples}/羅生門-es.md  |  0
 .../posts/{example => examples}/羅生門-ja.md  |  0
 .../posts/{example => examples}/羅生門-ru.md  |  0
 .../{example => examples}/羅生門-zh-tw.md     |  0
 .../posts/{example => examples}/羅生門-zh.md  |  0
 src/i18n/config.ts                            |  2 +-
 src/pages/404.astro                           |  2 +-
 src/pages/[...about].astro                    |  4 +--
 src/pages/[...index].astro                    |  1 +
 src/pages/[...posts_slug].astro               |  6 ++--
 src/pages/[...tags].astro                     |  4 +--
 src/pages/[...tags_tag].astro                 |  6 ++--
 src/styles/global.css                         |  9 ++---
 38 files changed, 46 insertions(+), 60 deletions(-)
 rename src/components/Widgets/{BackHome.astro => GoBack.astro} (80%)
 rename src/content/posts/{example => examples}/容忍与自由-en.md (100%)
 rename src/content/posts/{example => examples}/容忍与自由-es.md (100%)
 rename src/content/posts/{example => examples}/容忍与自由-ja.md (100%)
 rename src/content/posts/{example => examples}/容忍与自由-ru.md (100%)
 rename src/content/posts/{example => examples}/容忍与自由-zh-tw.md (100%)
 rename src/content/posts/{example => examples}/容忍与自由-zh.md (100%)
 rename src/content/posts/{example => examples}/故乡-en.md (100%)
 rename src/content/posts/{example => examples}/故乡-es.md (100%)
 rename src/content/posts/{example => examples}/故乡-ja.md (100%)
 rename src/content/posts/{example => examples}/故乡-ru.md (100%)
 rename src/content/posts/{example => examples}/故乡-zh-tw.md (100%)
 rename src/content/posts/{example => examples}/故乡-zh.md (100%)
 rename src/content/posts/{example => examples}/羅生門-en.md (100%)
 rename src/content/posts/{example => examples}/羅生門-es.md (100%)
 rename src/content/posts/{example => examples}/羅生門-ja.md (100%)
 rename src/content/posts/{example => examples}/羅生門-ru.md (100%)
 rename src/content/posts/{example => examples}/羅生門-zh-tw.md (100%)
 rename src/content/posts/{example => examples}/羅生門-zh.md (100%)

diff --git a/README.md b/README.md
index c4bbc9c..5617657 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-<img alt="Cover Image" src="https://placehold.co/1920x1080?text=Comming+Soon"/>
+<img alt="Cover Image" src="https://placehold.co/1920x1080?text=Work+In+Progress"/>
 
 <div align="center">
   <picture>
diff --git a/README.zh.md b/README.zh.md
index b34e01b..78658b7 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -1,4 +1,4 @@
-<img alt="Cover Image" src="https://placehold.co/1920x1080?text=Comming+Soon"/>
+<img alt="Cover Image" src="https://placehold.co/1920x1080?text=Work+In+Progress"/>
 
 <div align="center">
   <a title="en" href="README.md">
diff --git a/src/components/Button.astro b/src/components/Button.astro
index e9534a6..70e4129 100644
--- a/src/components/Button.astro
+++ b/src/components/Button.astro
@@ -16,10 +16,8 @@ const isTag = isTagPage(currentPath)
 
 // Check if there are other languages to switch
 const showLanguageSwitcher = moreLocales.length > 0
-
 // Check if only the supported language switch list is used
 const useSupportedLangs = isPost || (isTag && supportedLangs.length > 0)
-
 // Choose a language switch list according to the page type
 const nextUrl = useSupportedLangs
   ? getNextSupportedLangPath(currentPath, supportedLangs) // Switch between supported languages
@@ -33,7 +31,7 @@ const nextUrl = useSupportedLangs
   'lg:(fixed w-14rem top-auto bottom-47 right-[max(5.625rem,calc(50vw-34.375rem))])',
 ]}
 >
-  <!-- Language switcher -->
+  <!-- Language Switcher -->
   {showLanguageSwitcher && (
     <a
       href={nextUrl}
@@ -52,7 +50,7 @@ const nextUrl = useSupportedLangs
     </a>
   )}
 
-  <!-- Theme toggle -->
+  <!-- Theme Toggle -->
   <button
     aria-label="Switch light/dark theme"
     class="button-theme-toggle aspect-square w-4.2 c-secondary active:scale-90 hover:c-primary"
@@ -68,7 +66,7 @@ const nextUrl = useSupportedLangs
   </button>
 </div>
 
-<!-- Theme toggle >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
+<!-- Theme Toggle Script >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
 <script is:inline define:vars={{ lightMode, darkMode }}>
 // Update theme
 function updateTheme() {
diff --git a/src/components/Comments/Waline.astro b/src/components/Comments/Waline.astro
index 936eb98..bb5dc5c 100644
--- a/src/components/Comments/Waline.astro
+++ b/src/components/Comments/Waline.astro
@@ -2,13 +2,11 @@
 import { defaultLocale, themeConfig } from '@/config'
 import { walineLocaleMap } from '@/i18n/config'
 
-// Theme color configuration
 const {
   light: { primary: lightPrimary, secondary: lightSecondary, background: lightBackground },
   dark: { primary: darkPrimary, secondary: darkSecondary, background: darkBackground },
 } = themeConfig.color
 
-// Waline configuration
 const {
   serverURL = '',
   emoji = [],
@@ -27,7 +25,7 @@ function getWalineLang(currentPath: string, defaultLocale: string): string {
   return walineLocaleMap[lang as keyof typeof walineLocaleMap]
 }
 
-// Get Waline language and generate configuration
+// Get Waline language and generate configuration json
 const walineLang = getWalineLang(Astro.url.pathname, defaultLocale)
 const walineConfigJson = JSON.stringify({
   serverURL,
@@ -71,7 +69,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'
@@ -177,8 +175,8 @@ document.addEventListener('astro:after-swap', initWaline)
 }
 </style>
 
-<!-- Official css variables >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
-<!-- Docs: https://waline.js.org/reference/client/style.html -->
+<!-- Official CSS Variables >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
+<!-- https://waline.js.org/reference/client/style.html -->
 <style
   define:vars={{
   lightPrimary,
diff --git a/src/components/Comments/index.astro b/src/components/Comments/index.astro
index 89321f8..7357df6 100644
--- a/src/components/Comments/index.astro
+++ b/src/components/Comments/index.astro
@@ -23,6 +23,7 @@ const enableComments = themeConfig.comment?.enabled ?? false
 const walineURL = themeConfig.comment?.waline?.serverURL || ''
 const showWaline = enableComments && walineURL.trim() !== ''
 ---
+
 <!-- {showDisqus && <Disqus />} -->
 <!-- {showGiscus && <Giscus />} -->
 <!-- {showTwikoo && <Twikoo />} -->
diff --git a/src/components/Footer.astro b/src/components/Footer.astro
index c4c44ef..5fe4dae 100644
--- a/src/components/Footer.astro
+++ b/src/components/Footer.astro
@@ -10,7 +10,7 @@ const year = Number(startYear) === currentYear
   ? startYear
   : `${startYear}-${currentYear}`
 
-// i18n rss path
+// i18n RSS Path
 const currentLang = getLangFromPath(Astro.url.pathname)
 const links = socialLinks.map((link) => {
   if (link.name === 'RSS') {
diff --git a/src/components/Header.astro b/src/components/Header.astro
index 715c54b..a31db23 100644
--- a/src/components/Header.astro
+++ b/src/components/Header.astro
@@ -41,7 +41,7 @@ const SubtitleTag = isPost ? 'div' : 'h2'
       'font-bold font-title',
     ]}
   >
-    <!-- Fix text cropping issues during view transition on ios by adding a div tag -->
+    <!-- Fix text cropping issues during view transition on iOS by adding a div tag -->
     <div
       class="box-content inline-block pr-1"
       transition:name={`site-title-${currentLang}`}
diff --git a/src/components/PostList.astro b/src/components/PostList.astro
index ab13e09..e9c769c 100644
--- a/src/components/PostList.astro
+++ b/src/components/PostList.astro
@@ -26,6 +26,7 @@ function getPostPath(post: Post) {
   return lang && lang !== defaultLocale ? `/${lang}/posts/${postPath}/` : `/posts/${postPath}/`
 }
 ---
+
 <ul>
   {posts.map(post => (
     <li
diff --git a/src/components/Widgets/BackHome.astro b/src/components/Widgets/GoBack.astro
similarity index 80%
rename from src/components/Widgets/BackHome.astro
rename to src/components/Widgets/GoBack.astro
index 0cf0215..2d4b3a0 100644
--- a/src/components/Widgets/BackHome.astro
+++ b/src/components/Widgets/GoBack.astro
@@ -14,6 +14,7 @@
   </svg>
 </button>
 
+<!-- Go Back Script >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -->
 <script>
 function setupBackButton() {
   document.getElementById('back-button')?.addEventListener('click', () => {
@@ -21,6 +22,7 @@ function setupBackButton() {
       window.history.back()
     }
     else {
+      // Click site title link to trigger view transition when no history
       const titleLink = document.getElementById('site-title-link') as HTMLAnchorElement
       if (titleLink) {
         titleLink.click()
diff --git a/src/config.ts b/src/config.ts
index 367b3cc..c78a6a7 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -16,7 +16,7 @@ export const themeConfig: ThemeConfig = {
     // site url
     url: 'https://retypeset.radishzz.cc',
     // favicon url
-    // recommended formats: SVG, PNG and ICO
+    // recommended formats: svg, png or ico
     favicon: '/icon/favicon.svg', // or https://example.com/favicon.svg
   },
   // SITE INFORMATION >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> END
diff --git a/src/content/config.ts b/src/content/config.ts
index 26b13f2..9509f33 100644
--- a/src/content/config.ts
+++ b/src/content/config.ts
@@ -1,7 +1,7 @@
 import { allLocales } from '@/config'
 import { defineCollection, z } from 'astro:content'
 
-// Posts collection
+// Posts Collection
 const postsCollection = defineCollection({
   schema: z.object({
     // required
@@ -23,7 +23,7 @@ const postsCollection = defineCollection({
   }),
 })
 
-// About page
+// About Page
 const aboutCollection = defineCollection({
   schema: z.object({
     lang: z.enum(['', ...allLocales]).optional().default(''),
diff --git a/src/content/posts/Markdown Style Guide-en.md b/src/content/posts/Markdown Style Guide-en.md
index 72828c2..7d290d5 100644
--- a/src/content/posts/Markdown Style Guide-en.md	
+++ b/src/content/posts/Markdown Style Guide-en.md	
@@ -118,32 +118,16 @@ we can use 3 backticks ``` in new line and write snippet and close with 3 backti
 ### Output
 
 ```html
----
-// Your component script here!
-import Banner from '../components/Banner.astro';
-import ReactPokemonComponent from '../components/ReactPokemonComponent.jsx';
-const myFavoritePokemon = [/* ... */];
-const { title } = Astro.props;
----
-<!-- HTML comments supported! -->
-{/* JS comment syntax is also valid! */}
-
-<Banner />
-<h1>Hello, world!</h1>
-
-<!-- Use props and other variables from the component script: -->
-<p>{title}</p>
-
-<!-- Include other UI framework components with a `client:` directive to hydrate: -->
-<ReactPokemonComponent client:visible />
-
-<!-- Mix HTML with JavaScript expressions, similar to JSX: -->
-<ul>
-  {myFavoritePokemon.map((data) => <li>{data.name}</li>)}
-</ul>
-
-<!-- Use a template directive to build class names from multiple strings or even objects! -->
-<p class:list={["add", "dynamic", {classNames: true}]} />
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Example HTML5 Document</title>
+  </head>
+  <body>
+    <p>Test</p>
+  </body>
+</html>
 ```
 
 ## List Types
diff --git a/src/content/posts/example/容忍与自由-en.md b/src/content/posts/examples/容忍与自由-en.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-en.md
rename to src/content/posts/examples/容忍与自由-en.md
diff --git a/src/content/posts/example/容忍与自由-es.md b/src/content/posts/examples/容忍与自由-es.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-es.md
rename to src/content/posts/examples/容忍与自由-es.md
diff --git a/src/content/posts/example/容忍与自由-ja.md b/src/content/posts/examples/容忍与自由-ja.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-ja.md
rename to src/content/posts/examples/容忍与自由-ja.md
diff --git a/src/content/posts/example/容忍与自由-ru.md b/src/content/posts/examples/容忍与自由-ru.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-ru.md
rename to src/content/posts/examples/容忍与自由-ru.md
diff --git a/src/content/posts/example/容忍与自由-zh-tw.md b/src/content/posts/examples/容忍与自由-zh-tw.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-zh-tw.md
rename to src/content/posts/examples/容忍与自由-zh-tw.md
diff --git a/src/content/posts/example/容忍与自由-zh.md b/src/content/posts/examples/容忍与自由-zh.md
similarity index 100%
rename from src/content/posts/example/容忍与自由-zh.md
rename to src/content/posts/examples/容忍与自由-zh.md
diff --git a/src/content/posts/example/故乡-en.md b/src/content/posts/examples/故乡-en.md
similarity index 100%
rename from src/content/posts/example/故乡-en.md
rename to src/content/posts/examples/故乡-en.md
diff --git a/src/content/posts/example/故乡-es.md b/src/content/posts/examples/故乡-es.md
similarity index 100%
rename from src/content/posts/example/故乡-es.md
rename to src/content/posts/examples/故乡-es.md
diff --git a/src/content/posts/example/故乡-ja.md b/src/content/posts/examples/故乡-ja.md
similarity index 100%
rename from src/content/posts/example/故乡-ja.md
rename to src/content/posts/examples/故乡-ja.md
diff --git a/src/content/posts/example/故乡-ru.md b/src/content/posts/examples/故乡-ru.md
similarity index 100%
rename from src/content/posts/example/故乡-ru.md
rename to src/content/posts/examples/故乡-ru.md
diff --git a/src/content/posts/example/故乡-zh-tw.md b/src/content/posts/examples/故乡-zh-tw.md
similarity index 100%
rename from src/content/posts/example/故乡-zh-tw.md
rename to src/content/posts/examples/故乡-zh-tw.md
diff --git a/src/content/posts/example/故乡-zh.md b/src/content/posts/examples/故乡-zh.md
similarity index 100%
rename from src/content/posts/example/故乡-zh.md
rename to src/content/posts/examples/故乡-zh.md
diff --git a/src/content/posts/example/羅生門-en.md b/src/content/posts/examples/羅生門-en.md
similarity index 100%
rename from src/content/posts/example/羅生門-en.md
rename to src/content/posts/examples/羅生門-en.md
diff --git a/src/content/posts/example/羅生門-es.md b/src/content/posts/examples/羅生門-es.md
similarity index 100%
rename from src/content/posts/example/羅生門-es.md
rename to src/content/posts/examples/羅生門-es.md
diff --git a/src/content/posts/example/羅生門-ja.md b/src/content/posts/examples/羅生門-ja.md
similarity index 100%
rename from src/content/posts/example/羅生門-ja.md
rename to src/content/posts/examples/羅生門-ja.md
diff --git a/src/content/posts/example/羅生門-ru.md b/src/content/posts/examples/羅生門-ru.md
similarity index 100%
rename from src/content/posts/example/羅生門-ru.md
rename to src/content/posts/examples/羅生門-ru.md
diff --git a/src/content/posts/example/羅生門-zh-tw.md b/src/content/posts/examples/羅生門-zh-tw.md
similarity index 100%
rename from src/content/posts/example/羅生門-zh-tw.md
rename to src/content/posts/examples/羅生門-zh-tw.md
diff --git a/src/content/posts/example/羅生門-zh.md b/src/content/posts/examples/羅生門-zh.md
similarity index 100%
rename from src/content/posts/example/羅生門-zh.md
rename to src/content/posts/examples/羅生門-zh.md
diff --git a/src/i18n/config.ts b/src/i18n/config.ts
index 7983766..eed7232 100644
--- a/src/i18n/config.ts
+++ b/src/i18n/config.ts
@@ -9,7 +9,7 @@ export const langMap: Record<string, string[]> = {
 }
 
 // Waline Language Map
-// docs: https://waline.js.org/guide/i18n.html
+// https://waline.js.org/guide/i18n.html
 export const walineLocaleMap: Record<string, string> = {
   'zh': 'zh-CN',
   'zh-tw': 'zh-TW',
diff --git a/src/pages/404.astro b/src/pages/404.astro
index 51f47ae..68f48f0 100644
--- a/src/pages/404.astro
+++ b/src/pages/404.astro
@@ -3,7 +3,7 @@ import Layout from '@/layouts/Layout.astro'
 ---
 
 <Layout>
-  <!-- Decorative line -->
+  <!-- Decorative Line -->
   <div class="uno-decorative-line"></div>
   <!-- 404  -->
   <h1 class="mt-10 text-8 font-title">404</h1>
diff --git a/src/pages/[...about].astro b/src/pages/[...about].astro
index cd030af..e7e212e 100644
--- a/src/pages/[...about].astro
+++ b/src/pages/[...about].astro
@@ -38,9 +38,9 @@ const { Content } = aboutEntry ? await aboutEntry.render() : { Content: null }
 ---
 
 <Layout>
-  <!-- Decorative line -->
+  <!-- Decorative Line -->
   <div class="uno-decorative-line"></div>
-  <!-- About page content -->
+  <!-- About Page Content -->
   <div class="heti">
     {Content && <Content />}
   </div>
diff --git a/src/pages/[...index].astro b/src/pages/[...index].astro
index 30ba8dc..98359ff 100644
--- a/src/pages/[...index].astro
+++ b/src/pages/[...index].astro
@@ -42,6 +42,7 @@ const postsByYear = await getPostsByYear(lang)
       <PostList posts={pinnedPosts} lang={lang} />
     </section>
   )}
+
   <!-- Regular Posts -->
   {[...postsByYear.entries()].map(([_year, posts]) => (
     <section class="mb-7.5">
diff --git a/src/pages/[...posts_slug].astro b/src/pages/[...posts_slug].astro
index d39ab64..579ac3a 100644
--- a/src/pages/[...posts_slug].astro
+++ b/src/pages/[...posts_slug].astro
@@ -2,7 +2,7 @@
 import type { CollectionEntry } from 'astro:content'
 import Comments from '@/components/Comments/index.astro'
 import PostDate from '@/components/PostDate.astro'
-import BackHome from '@/components/Widgets/BackHome.astro'
+import GoBack from '@/components/Widgets/GoBack.astro'
 import { allLocales, defaultLocale, moreLocales } from '@/config'
 import { getTagPath } from '@/i18n/path'
 import Layout from '@/layouts/Layout.astro'
@@ -107,8 +107,8 @@ const { Content, remarkPluginFrontmatter } = await post.render()
 >
   <article class="heti mb-12.6">
     <div class="relative">
-      <!-- Desktop back home button -->
-      <BackHome />
+      <!-- Go Back Button On Desktop -->
+      <GoBack />
       <!-- Title -->
       <h1 class="post-title">
         <span
diff --git a/src/pages/[...tags].astro b/src/pages/[...tags].astro
index 216330e..7b0a6fa 100644
--- a/src/pages/[...tags].astro
+++ b/src/pages/[...tags].astro
@@ -34,9 +34,9 @@ const allTags = await getAllTags(lang)
 ---
 
 <Layout>
-  <!-- Decorative line -->
+  <!-- Decorative Line -->
   <div class="uno-decorative-line"></div>
-  <!-- Tags list -->
+  <!-- Tags List -->
   <div class="uno-tags-wrapper">
     {allTags.map(tag => (
       <a
diff --git a/src/pages/[...tags_tag].astro b/src/pages/[...tags_tag].astro
index 5c54b73..046fd55 100644
--- a/src/pages/[...tags_tag].astro
+++ b/src/pages/[...tags_tag].astro
@@ -53,9 +53,9 @@ const supportedLangs = tagSupportedLangs.filter(Boolean) as string[]
 ---
 
 <Layout supportedLangs={supportedLangs}>
-  <!-- Decorative line -->
+  <!-- Decorative Line -->
   <div class="uno-decorative-line"></div>
-  <!-- Tags list -->
+  <!-- Tags List -->
   <div class="uno-tags-wrapper">
     {allTags.map(tagName => (
       <a
@@ -71,7 +71,7 @@ const supportedLangs = tagSupportedLangs.filter(Boolean) as string[]
     ))}
   </div>
 
-  <!-- Posts list -->
+  <!-- Posts List -->
   <div class="mt-10.5">
     <PostList posts={posts} lang={lang} />
   </div>
diff --git a/src/styles/global.css b/src/styles/global.css
index db58f0c..94441ea 100644
--- a/src/styles/global.css
+++ b/src/styles/global.css
@@ -26,7 +26,7 @@ html.dark .astro-code span {
   background-color: var(--shiki-dark-bg) !important;
 }
 
-/* Horizontal reveal animation during theme switching */
+/* View Transition with Theme Toggle >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> */
 ::view-transition-new(theme-transition) {
   animation: reveal 1s cubic-bezier(0.4, 0, 0.2, 1);
   clip-path: inset(0 0 0 0);
@@ -64,7 +64,8 @@ html[data-theme-transition] [data-disable-transition-on-theme] {
   }
 }
 
-/* Snell Roundhand static font */
+/* Import Custom Fonts >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> */
+/* Snell Roundhand Static Font */
 @font-face {
   font-family: "Snell-Bold";
   src: url("/font/Snell-Bold.woff2") format("woff2");
@@ -79,7 +80,7 @@ html[data-theme-transition] [data-disable-transition-on-theme] {
   unicode-range: U+0030-0039,U+0041-005A,U+0061-007A,U+00C1,U+00C9,U+00CD,U+00D3,U+00DA,U+00DC,U+00D1,U+00E1,U+00E9,U+00ED,U+00F3,U+00FA,U+00FC,U+00F1,U+0410-044F,U+0401,U+0451,U+0021-002F,U+003A-0040,U+00A9;
 }
 
-/* STIXTwoText variable font */
+/* STIXTwoText Variable Font */
 @font-face {
   font-family: "STIX";
   src: url("/font/STIX.woff2") format("woff2-variations");
@@ -96,7 +97,7 @@ html[data-theme-transition] [data-disable-transition-on-theme] {
   unicode-range: U+0030-0039,U+0041-005A,U+0061-007A,U+00C1,U+00C9,U+00CD,U+00D3,U+00DA,U+00DC,U+00D1,U+00E1,U+00E9,U+00ED,U+00F3,U+00FA,U+00FC,U+00F1,U+0410-044F,U+0401,U+0451,U+0021-002F,U+003A-0040,U+00A9;
 }
 
-/* Minimal subset of EarlySummerSerif variable font for ui */
+/* Minimal Subset of EarlySummerSerif Variable Font */
 @font-face {
   font-family: "EarlySummer-Subset";
   src: url("/font/EarlySummer-Subset.woff2") format("woff2-variations");