主题
新增一个工具
工具站的页面是「数据驱动」的:在 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检查三件事:
/text/新工具/能打开,交互正常;- 页面
<title>、description、canonical 正确; - 栏目页里出现了新工具卡片。
4. 手机版是否需要改
如果组件在 375px 宽度下就能正常用,手机版会直接复用,无需改动;否则:
- 在
mobile-web/src/tools/写一个移动优先版本(大按钮、单列、底部操作栏); - 在
mobile-web/src/data/的映射里把该 slug 指向新组件; - 用手机模拟器确认弹层、滚动、输入法不会遮挡按钮。
具体机制见 双端复用机制。
5. 发布
bash
./deploy.sh pc mobile新页面会自动进入 sitemap,百度 / Google 的收录取决于外链与时间,可以主动提交 https://emphant.com/sitemap.xml。