add theme

themes/butterfly/scripts/helpers/aside_archives.js

@@ -0,0 +1,126 @@
+'use strict'
+
+hexo.extend.helper.register('aside_archives', function (options = {}) {
+  const { config, page, site, url_for, _p } = this
+  const { archive_dir: archiveDir, timezone, language } = config
+
+  // Destructure and set default options with object destructuring
+  const {
+    type = 'monthly',
+    format = type === 'monthly' ? 'MMMM YYYY' : 'YYYY',
+    show_count: showCount = true,
+    order = -1,
+    limit,
+    transform
+  } = options
+
+  // Optimize locale handling
+  const lang = toMomentLocale(page.lang || page.language || language)
+
+  // Memoize comparison function to improve performance
+  const compareFunc =
+    type === 'monthly'
+      ? (yearA, monthA, yearB, monthB) => yearA === yearB && monthA === monthB
+      : (yearA, yearB) => yearA === yearB
+
+  // Early return if no posts
+  if (!site.posts.length) return ''
+
+  // Use reduce for more efficient data processing
+  const data = site.posts.sort('date', order).reduce((acc, post) => {
+    let date = post.date.clone()
+    if (timezone) date = date.tz(timezone)
+
+    const year = date.year()
+    const month = date.month() + 1
+
+    if (lang) date = date.locale(lang)
+
+    // Find or create archive entry
+    const lastEntry = acc[acc.length - 1]
+
+    if (type === 'yearly') {
+      const existingYearIndex = acc.findIndex(entry => entry.year === year)
+      if (existingYearIndex !== -1) {
+        acc[existingYearIndex].count++
+      } else {
+        // 否則創建新條目
+        acc.push({
+          name: date.format(format),
+          year,
+          month,
+          count: 1
+        })
+      }
+    } else {
+      if (!lastEntry || !compareFunc(lastEntry.year, lastEntry.month, year, month)) {
+        acc.push({
+          name: date.format(format),
+          year,
+          month,
+          count: 1
+        })
+      } else {
+        lastEntry.count++
+      }
+    }
+
+    return acc
+  }, [])
+
+  // Create link generator function
+  const createArchiveLink = item => {
+    let url = `${archiveDir}/${item.year}/`
+    if (type === 'monthly') {
+      url += item.month < 10 ? `0${item.month}/` : `${item.month}/`
+    }
+    return url_for(url)
+  }
+
+  // Limit results efficiently
+  const limitedData = limit > 0 ? data.slice(0, Math.min(data.length, limit)) : data
+
+  // Use template literal for better readability
+  const archiveHeader = `
+    <div class="item-headline">
+      <i class="fas fa-archive"></i>
+      <span>${_p('aside.card_archives')}</span>
+      ${
+        data.length > limitedData.length
+          ? `<a class="card-more-btn" href="${url_for(archiveDir)}/"
+            title="${_p('aside.more_button')}">
+            <i class="fas fa-angle-right"></i>
+          </a>`
+          : ''
+      }
+    </div>
+  `
+
+  // Use map for generating list items, join for performance
+  const archiveList = `
+    <ul class="card-archive-list">
+      ${limitedData
+        .map(
+          item => `
+        <li class="card-archive-list-item">
+          <a class="card-archive-list-link" href="${createArchiveLink(item)}">
+            <span class="card-archive-list-date">
+              ${transform ? transform(item.name) : item.name}
+            </span>
+            ${showCount ? `<span class="card-archive-list-count">${item.count}</span>` : ''}
+          </a>
+        </li>
+      `
+        )
+        .join('')}
+    </ul>
+  `
+
+  return archiveHeader + archiveList
+})
+
+// Improved locale conversion function
+const toMomentLocale = lang => {
+  if (!lang || ['en', 'default'].includes(lang)) return 'en'
+  return lang.toLowerCase().replace('_', '-')
+}

themes/butterfly/scripts/helpers/aside_categories.js

@@ -0,0 +1,81 @@
+'use strict'
+
+hexo.extend.helper.register('aside_categories', function (categories, options = {}) {
+  if (!categories || !Object.prototype.hasOwnProperty.call(categories, 'length')) {
+    options = categories || {}
+    categories = this.site.categories
+  }
+
+  if (!categories || !categories.length) return ''
+
+  const { config } = this
+  const showCount = Object.prototype.hasOwnProperty.call(options, 'show_count') ? options.show_count : true
+  const depth = options.depth ? parseInt(options.depth, 10) : 0
+  const orderby = options.orderby || 'name'
+  const order = options.order || 1
+  const categoryDir = this.url_for(config.category_dir)
+  const limit = options.limit === 0 ? categories.length : (options.limit || categories.length)
+  const isExpand = options.expand !== 'none'
+  const expandClass = isExpand && options.expand === true ? 'expand' : ''
+  const buttonLabel = this._p('aside.more_button')
+
+  const prepareQuery = parent => {
+    const query = parent ? { parent } : { parent: { $exists: false } }
+    return categories.find(query).sort(orderby, order).filter(cat => cat.length)
+  }
+
+  const hierarchicalList = (remaining, level = 0, parent) => {
+    let result = ''
+    if (remaining > 0) {
+      prepareQuery(parent).forEach(cat => {
+        if (remaining > 0) {
+          remaining -= 1
+          let child = ''
+          if (!depth || level + 1 < depth) {
+            const childList = hierarchicalList(remaining, level + 1, cat._id)
+            child = childList.result
+            remaining = childList.remaining
+          }
+
+          const parentClass = isExpand && !parent && child ? 'parent' : ''
+          result += `<li class="card-category-list-item ${parentClass}">`
+          result += `<a class="card-category-list-link" href="${this.url_for(cat.path)}">`
+          result += `<span class="card-category-list-name">${cat.name}</span>`
+
+          if (showCount) {
+            result += `<span class="card-category-list-count">${cat.length}</span>`
+          }
+
+          if (isExpand && !parent && child) {
+            result += `<i class="fas fa-caret-left ${expandClass}"></i>`
+          }
+
+          result += '</a>'
+
+          if (child) {
+            result += `<ul class="card-category-list child">${child}</ul>`
+          }
+
+          result += '</li>'
+        }
+      })
+    }
+    return { result, remaining }
+  }
+
+  const list = hierarchicalList(limit)
+
+  const moreButton = categories.length > limit
+    ? `<a class="card-more-btn" href="${categoryDir}/" title="${buttonLabel}">
+      <i class="fas fa-angle-right"></i></a>`
+    : ''
+
+  return `<div class="item-headline">
+            <i class="fas fa-folder-open"></i>
+            <span>${this._p('aside.card_categories')}</span>
+            ${moreButton}
+          </div>
+          <ul class="card-category-list${isExpand && list.result ? ' expandBtn' : ''}" id="aside-cat-list">
+            ${list.result}
+          </ul>`
+})

themes/butterfly/scripts/helpers/getArchiveLength.js

@@ -0,0 +1,45 @@
+hexo.extend.helper.register('getArchiveLength', function () {
+  const archiveGenerator = hexo.config.archive_generator
+  const posts = this.site.posts
+
+  const { yearly, monthly, daily } = archiveGenerator
+  const { year, month, day } = this.page
+
+  // Archives Page
+  if (!year) return posts.length
+
+  // Function to generate a unique key based on the granularity
+  const getKey = (post, type) => {
+    const date = post.date.clone()
+    const y = date.year()
+    const m = date.month() + 1
+    const d = date.date()
+    if (type === 'year') return `${y}`
+    if (type === 'month') return `${y}-${m}`
+    if (type === 'day') return `${y}-${m}-${d}`
+  }
+
+  // Create a map to count posts per period
+  const mapData = this.fragment_cache('createArchiveObj', () => {
+    const map = new Map()
+    posts.forEach(post => {
+      const keyYear = getKey(post, 'year')
+      const keyMonth = getKey(post, 'month')
+      const keyDay = getKey(post, 'day')
+
+      if (yearly) map.set(keyYear, (map.get(keyYear) || 0) + 1)
+      if (monthly) map.set(keyMonth, (map.get(keyMonth) || 0) + 1)
+      if (daily) map.set(keyDay, (map.get(keyDay) || 0) + 1)
+    })
+    return map
+  })
+
+  // Determine the appropriate key to fetch based on current page context
+  let key
+  if (yearly && year) key = `${year}`
+  if (monthly && month) key = `${year}-${month}`
+  if (daily && day) key = `${year}-${month}-${day}`
+
+  // Return the count for the current period or default to the total posts
+  return mapData.get(key) || posts.length
+})