Skip to content

新增一个工具 ​

工具站的页面是「数据驱动」的:在 pc-web/src/data/tools/<栏目>.js 里加一条定义,构建时自动生成独立页面、导航、sitemap 与结构化数据。一般不需要手写 HTML。

1. 写工具组件 ​

在 pc-web/src/tools/ 下新建一个 Vue 组件,约定:

  • 所有计算都在组件内完成,不发起网络请求;
  • 大计算量(如批量图片处理)用 async + 进度条,避免卡死主线程;
  • 输入输出尽量用同一个 textarea / canvas,不引入第三方编辑器;
  • 组件 props 保持为空,配置项用组件内部状态。
vue
<script setup>
import { ref, computed } from 'vue'

const input = ref('')
const output = computed(() => input.value.toUpperCase())
</script>

<template>
  <div class="tool">
    <textarea v-model="input" placeholder="输入内容" />
    <pre>{{ output }}</pre>
  </div>
</template>

2. 在数据里登记工具 ​

pc-web/src/data/tools/text.js:

js
export default [
  {
    slug: 'word-counter',          // URL: /text/word-counter/
    cat: 'text',
    name: '字数统计',
    icon: 'Aa',
    desc: '统计中文字数、英文单词、标点与行数',
    keywords: '字数统计,在线字数,作文格子',
    seoTitle: '在线字数统计 - 中文/英文/标点分开计数',
    seoDesc: '粘贴文本即可统计字数、单词数、标点数与行数,全部在浏览器本地完成。',
    steps: ['把文本粘贴到输入框', '结果实时更新', '可一键复制统计结果'],
    faq: [
      { q: '会上传内容吗?', a: '不会,统计在本地完成。' },
    ],
    related: ['text-format', 'text-dedupe'],
    component: () => import('../../tools/WordCounter.vue'),
  },
]

字段说明:

字段必填作用
slug是URL 与文件名,小写连字符
cat是所属栏目,决定一级路径
subcat否测算栏目的子栏目,路径变成 /assess/<subcat>/<slug>/
name / icon / desc是卡片与页面标题区
seoTitle / seoDesc / keywords是<title>、description、keywords
steps / faq是静态正文:使用步骤与常见问题,给搜索引擎看
related否相关工具内链
component是动态 import,按需打包

3. 生成页面并验收 ​

bash
cd pc-web
npm run gen
npm run dev

检查三件事:

  1. /text/新工具/ 能打开,交互正常;
  2. 页面 <title>、description、canonical 正确;
  3. 栏目页里出现了新工具卡片。

4. 手机版是否需要改 ​

如果组件在 375px 宽度下就能正常用,手机版会直接复用,无需改动;否则:

  • 在 mobile-web/src/tools/ 写一个移动优先版本(大按钮、单列、底部操作栏);
  • 在 mobile-web/src/data/ 的映射里把该 slug 指向新组件;
  • 用手机模拟器确认弹层、滚动、输入法不会遮挡按钮。

具体机制见 双端复用机制。

5. 发布 ​

bash
./deploy.sh pc mobile

新页面会自动进入 sitemap,百度 / Google 的收录取决于外链与时间,可以主动提交 https://emphant.com/sitemap.xml。

文档随仓库一起更新,站点内容全部在浏览器本地运行。