内容团队手里有客户问题、产品资料和参考链接,却经常花时间反复整理成同一种提纲。Python可以协助完成这类重复工作。

它负责组织资料,不负责判断事实正确与否。下面示例只处理本地文件,输出的是待审核提纲。

用Python整理内容提纲,让资料和问题对得上,正文内容要点图

先准备三列资料

建立UTF-8编码的topics.csv,表头使用topic、question、source,分别记录主题、需要回答的问题和来源说明。

topic,question,source
设备安装,需要预留多少空间,产品手册第3节
设备安装,安装前需要哪些条件,技术人员已确认资料

这里是格式示意,不是实际产品结论。来源可以是内部资料名称或已核验的公开出处,发布时还要检查是否适合公开。

按主题生成待审核提纲

将下面代码保存为脚本,与CSV放在同一工作目录,用Python 3运行。它校验必要字段,按输入顺序分组,并合并同一主题下完全相同的问题与来源组合。

import csv
from collections import OrderedDict

groups = OrderedDict()
with open("topics.csv", encoding="utf-8-sig", newline="") as f:
    reader = csv.DictReader(f)
    required = {"topic", "question", "source"}
    if not required.issubset(reader.fieldnames or []):
        raise ValueError("缺少 topic、question 或 source 列")
    for number, row in enumerate(reader, start=2):
        values = {key: " ".join((row.get(key) or "").split())
                  for key in required}
        if not all(values.values()):
            raise ValueError(f"第 {number} 行存在空字段")
        item = (values["question"], values["source"])
        bucket = groups.setdefault(values["topic"], [])
        if item not in bucket:
            bucket.append(item)

if not groups:
    raise ValueError("没有可整理的资料")

# x 模式避免覆盖已经存在的提纲文件
with open("briefs.md", "x", encoding="utf-8") as f:
    for topic, items in groups.items():
        f.write(f"# {topic}\n\n")
        f.write("读者与页面任务:待人工确认\n\n")
        for question, source in items:
            f.write(f"- 问题:{question}\n  资料:{source}\n")
        f.write("\n事实、适用条件与缺少资料:待人工核验\n\n")

脚本创建briefs.md;同名文件已经存在时会停止,避免覆盖。它不会查询网站或验证来源内容,也不会自动推断搜索量。

生成之后,内容人员还要做什么

确认读者与页面任务,判断问题是否属于同一篇文章,再核验资料、事实和适用条件。相似但不完全相同的问题,需要人工判断是否合并。

CSV中的标点和Markdown符号会保留,正式排版前应检查。敏感或不适合公开的内部说明,应从最终正文中移除。

从提纲走到完整文章

为每个问题补齐准确答案、示例和必要来源,再安排章节顺序。SEO文章写作流程可以帮助完成开头、正文和结尾。

不要只把竞争页面的标题拼成目录。企业需要提供自己能够核实的解释和使用帮助。

什么时候值得继续自动化

如果团队经常处理相同格式,可以增加负责人、资料日期与页面网址等字段,再根据真实需要扩展脚本。

先把输入和审核规则稳定下来,自动化才能减少返工。工具整理得再整齐,也不能代替内容判断。

0.019399s