From 8cf3e3001f2cbd18da73fcc92ae5f4b76d3ecf21 Mon Sep 17 00:00:00 2001
From: Patsagorn Y. <49602385+ptsgrn@users.noreply.github.com>
Date: Thu, 16 Jan 2025 20:44:33 +0000
Subject: [PATCH] feat(i18n): Thai translations (#1722)
---
quartz/components/Breadcrumbs.tsx | 111 +++++++++++++++++++++++++++++++++----------------------
1 files changed, 66 insertions(+), 45 deletions(-)
diff --git a/quartz/components/Breadcrumbs.tsx b/quartz/components/Breadcrumbs.tsx
index fb2f0c6..9ccfb9a 100644
--- a/quartz/components/Breadcrumbs.tsx
+++ b/quartz/components/Breadcrumbs.tsx
@@ -1,8 +1,8 @@
-import { QuartzComponentConstructor, QuartzComponentProps } from "./types"
+import { QuartzComponent, QuartzComponentConstructor, QuartzComponentProps } from "./types"
import breadcrumbsStyle from "./styles/breadcrumbs.scss"
-import { FullSlug, SimpleSlug, resolveRelative } from "../util/path"
-import { capitalize } from "../util/lang"
+import { FullSlug, SimpleSlug, joinSegments, resolveRelative } from "../util/path"
import { QuartzPluginData } from "../plugins/vfile"
+import { classNames } from "../util/lang"
type CrumbData = {
displayName: string
@@ -19,91 +19,111 @@
*/
rootName: string
/**
- * wether to look up frontmatter title for folders (could cause performance problems with big vaults)
+ * Whether to look up frontmatter title for folders (could cause performance problems with big vaults)
*/
resolveFrontmatterTitle: boolean
/**
- * Wether to display breadcrumbs on root `index.md`
+ * Whether to display breadcrumbs on root `index.md`
*/
hideOnRoot: boolean
+ /**
+ * Whether to display the current page in the breadcrumbs.
+ */
+ showCurrentPage: boolean
}
const defaultOptions: BreadcrumbOptions = {
- spacerSymbol: ">",
+ spacerSymbol: "❯",
rootName: "Home",
- resolveFrontmatterTitle: false,
+ resolveFrontmatterTitle: true,
hideOnRoot: true,
+ showCurrentPage: true,
}
function formatCrumb(displayName: string, baseSlug: FullSlug, currentSlug: SimpleSlug): CrumbData {
- return { displayName, path: resolveRelative(baseSlug, currentSlug) }
-}
-
-// given a folderName (e.g. "features"), search for the corresponding `index.md` file
-function findCurrentFile(allFiles: QuartzPluginData[], folderName: string) {
- return allFiles.find((file) => {
- if (file.slug?.endsWith("index")) {
- const folderParts = file.filePath?.split("/")
- if (folderParts) {
- const name = folderParts[folderParts?.length - 2]
- if (name === folderName) {
- return true
- }
- }
- }
- })
+ return {
+ displayName: displayName.replaceAll("-", " "),
+ path: resolveRelative(baseSlug, currentSlug),
+ }
}
export default ((opts?: Partial<BreadcrumbOptions>) => {
// Merge options with defaults
const options: BreadcrumbOptions = { ...defaultOptions, ...opts }
- function Breadcrumbs({ fileData, allFiles, displayClass }: QuartzComponentProps) {
+ // computed index of folder name to its associated file data
+ let folderIndex: Map<string, QuartzPluginData> | undefined
+
+ const Breadcrumbs: QuartzComponent = ({
+ fileData,
+ allFiles,
+ displayClass,
+ }: QuartzComponentProps) => {
// Hide crumbs on root if enabled
if (options.hideOnRoot && fileData.slug === "index") {
return <></>
}
// Format entry for root element
- const firstEntry = formatCrumb(capitalize(options.rootName), fileData.slug!, "/" as SimpleSlug)
+ const firstEntry = formatCrumb(options.rootName, fileData.slug!, "/" as SimpleSlug)
const crumbs: CrumbData[] = [firstEntry]
- // Get parts of filePath (every folder)
- const parts = fileData.filePath?.split("/")?.splice(1)
- if (parts) {
- // full path until current part
- let current = ""
- for (let i = 0; i < parts.length - 1; i++) {
- const folderName = parts[i]
- let currentTitle = folderName
+ if (!folderIndex && options.resolveFrontmatterTitle) {
+ folderIndex = new Map()
+ // construct the index for the first time
+ for (const file of allFiles) {
+ const folderParts = file.slug?.split("/")
+ if (folderParts?.at(-1) === "index") {
+ folderIndex.set(folderParts.slice(0, -1).join("/"), file)
+ }
+ }
+ }
- // TODO: performance optimizations/memoizing
+ // Split slug into hierarchy/parts
+ const slugParts = fileData.slug?.split("/")
+ if (slugParts) {
+ // is tag breadcrumb?
+ const isTagPath = slugParts[0] === "tags"
+
+ // full path until current part
+ let currentPath = ""
+
+ for (let i = 0; i < slugParts.length - 1; i++) {
+ let curPathSegment = slugParts[i]
+
// Try to resolve frontmatter folder title
- if (options?.resolveFrontmatterTitle) {
- // try to find file for current path
- const currentFile = findCurrentFile(allFiles, folderName)
- if (currentFile) {
- currentTitle = currentFile.frontmatter!.title
+ const currentFile = folderIndex?.get(slugParts.slice(0, i + 1).join("/"))
+ if (currentFile) {
+ const title = currentFile.frontmatter!.title
+ if (title !== "index") {
+ curPathSegment = title
}
}
- // Add current path to full path
- current += folderName + "/"
+
+ // Add current slug to full path
+ currentPath = joinSegments(currentPath, slugParts[i])
+ const includeTrailingSlash = !isTagPath || i < 1
// Format and add current crumb
- const crumb = formatCrumb(capitalize(currentTitle), fileData.slug!, current as SimpleSlug)
+ const crumb = formatCrumb(
+ curPathSegment,
+ fileData.slug!,
+ (currentPath + (includeTrailingSlash ? "/" : "")) as SimpleSlug,
+ )
crumbs.push(crumb)
}
// Add current file to crumb (can directly use frontmatter title)
- if (parts.length > 0) {
+ if (options.showCurrentPage && slugParts.at(-1) !== "index") {
crumbs.push({
- displayName: capitalize(fileData.frontmatter!.title),
+ displayName: fileData.frontmatter!.title,
path: "",
})
}
}
+
return (
- <nav class={`breadcrumb-container ${displayClass ?? ""}`} aria-label="breadcrumbs">
+ <nav class={classNames(displayClass, "breadcrumb-container")} aria-label="breadcrumbs">
{crumbs.map((crumb, index) => (
<div class="breadcrumb-element">
<a href={crumb.path}>{crumb.displayName}</a>
@@ -114,5 +134,6 @@
)
}
Breadcrumbs.css = breadcrumbsStyle
+
return Breadcrumbs
}) satisfies QuartzComponentConstructor
--
Gitblit v1.10.0