Go back

如何使用 Hugo Paper 的 New-Post 脚本创建 SEO 优化的博客文章

Edit page

创建具有适当 SEO 优化的博客文章可能很耗时。Hugo Paper 的 new-post 脚本自动化了这个过程，帮助你在几秒钟内创建结构良好、SEO 友好的文章。

目录

为什么使用 New-Post 脚本？

传统的博客文章创建需要手动设置包含众多 SEO 字段的 frontmatter。new-post 脚本通过以下方式简化了这个过程：

前置要求

使用脚本前，确保你已安装：

# 检查 Node.js 版本 (18.0+)
node --version

# 检查 pnpm 版本 (8.0+)
pnpm --version

# 如需要，安装依赖
pnpm install

两种创建文章的方式

Hugo Paper 提供两个脚本用于不同的工作流程：

1. 交互模式（推荐）

new-post 脚本提供交互式体验，为所有字段提供提示：

# 基础用法
pnpm new-post

# 带标题
pnpm new-post "Hugo 入门指南"

# 带标题和语言
pnpm new-post "Hugo 入门指南" zh

2. 快速模式

quick-post 脚本使用合理的默认值快速创建文章：

# 快速创建中文文章
pnpm quick-post "我的文章标题"

# 快速创建英文文章
pnpm quick-post "My Article Title" en

分步指南：使用 New-Post

步骤 1：运行命令

pnpm new-post "如何搭建 Hugo 博客"

步骤 2：按照提示操作

脚本会询问：

1. Slug（URL 友好标识符）

输入 slug（按回车自动生成）: 
→ how-to-build-hugo-blog

最佳实践：

2. 描述（150-160 字符）

输入描述（SEO 建议 150-160 字符）: 
→ 学习如何使用 Hugo 静态网站生成器搭建专业博客。
  包含示例和最佳实践的分步指南。

最佳实践：

3. 关键词（逗号分隔）

输入关键词（逗号分隔，建议 3-5 个）: 
→ hugo, 静态网站生成器, 博客教程, 网站开发

最佳实践：

4. 作者

输入作者名称: 
→ 张三

5. 分类（逗号分隔）

输入分类（逗号分隔）: 
→ 教程, 网站开发

最佳实践：

6. 标签（逗号分隔）

输入标签（逗号分隔，建议 5-10 个）: 
→ hugo, jamstack, 静态网站, 博客, 教程, 新手友好

最佳实践：

7. 精选文章

这是精选文章吗？(y/n): 
→ y

精选文章会在首页显著位置显示。

8. 草稿状态

这是草稿吗？(y/n): 
→ n

设置为 y 表示未发布的文章。

步骤 3：编辑你的文章

脚本会创建文件：

content/zh/post/how-to-build-hugo-blog.md

打开它并开始写作：

---
title: "如何搭建 Hugo 博客"
slug: "how-to-build-hugo-blog"
description: "学习如何使用 Hugo 静态网站生成器搭建专业博客..."
date: 2024-11-15T10:00:00+08:00
lastmod: 2024-11-15T10:00:00+08:00
author: "张三"
keywords:
  - hugo
  - 静态网站生成器
  - 博客教程
categories:
  - 教程
tags:
  - hugo
  - jamstack
featured: true
draft: false
---

## 简介

你的内容从这里开始...

Quick-Post 快速创建

当你需要快速创建文章而不需要交互式提示时：

# 使用默认值创建文章
pnpm quick-post "快速文章标题"

默认值：

何时使用 quick-post：

多语言文章创建

创建中文文章

# 交互式中文文章
pnpm new-post "Hugo 博客搭建指南" zh

# 快速中文文章
pnpm quick-post "我的文章" zh

脚本会自动：

语言特定的最佳实践

中文文章：

英文文章：

SEO 优化技巧

1. 标题优化

好的标题：

差的标题：

最佳实践：

2. 描述优化

好的描述：

学习如何使用 Hugo 静态网站生成器搭建专业博客。
这个分步指南涵盖安装、配置和部署，包含实用示例。

差的描述：

这是一篇关于 Hugo 的文章。

最佳实践：

3. 关键词策略

关键词研究：

  1. 使用 Google 关键词规划师
  2. 检查竞争对手的关键词
  3. 使用 Google 自动完成
  4. 查看"相关搜索"

关键词放置：

4. URL 结构

好的 slug：

差的 slug：

高级用法

自定义模板

通过修改脚本创建自定义文章模板：

// scripts/new-post.ts
function generatePostContent(metadata: PostMetadata): string {
  return `## 简介

在这里写你的简介...

## 主要内容

### 第一部分

内容...

### 第二部分

内容...

## 结论

总结你的文章...

## 参考资料

- [链接 1](https://example.com)
- [链接 2](https://example.com)
`;
}

批量创建文章

使用 shell 脚本创建多篇文章：

#!/bin/bash
# create-posts.sh

posts=(
  "第一篇文章标题"
  "第二篇文章标题"
  "第三篇文章标题"
)

for post in "${posts[@]}"; do
  pnpm quick-post "$post"
done

与 CI/CD 集成

在工作流中自动化文章创建：

# .github/workflows/create-post.yml
name: 创建文章

on:
  workflow_dispatch:
    inputs:
      title:
        description: '文章标题'
        required: true

jobs:
  create:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm quick-post "${{ github.event.inputs.title }}"
      - uses: stefanzweifel/git-auto-commit-action@v4

故障排除

找不到脚本

错误: 找不到模块 'scripts/new-post.ts'

解决方案：

# 确保在主题目录中
cd hugo-theme-paper

# 安装依赖
pnpm install

权限被拒绝

错误: EACCES: 权限被拒绝

解决方案：

# 使脚本可执行（Unix/Mac）
chmod +x scripts/new-post.ts

# 或直接使用 tsx 运行
npx tsx scripts/new-post.ts

无效的日期格式

错误: 无效的日期格式

解决方案： 脚本自动使用 ISO 8601 格式。如果看到此错误，请检查系统时区设置。

最佳实践检查清单

发布前，确保：

对比：手动 vs 脚本

方面手动创建New-Post 脚本
时间5-10 分钟30 秒
SEO 字段经常忘记始终包含
一致性不一致统一
错误常见罕见
学习曲线低非常低
灵活性高高

下一步

现在你知道如何高效创建文章了：

  1. 阅读 SEO 指南 - 学习高级 SEO 优化
  2. 配置 OG 图片 - 设置动态社交媒体图片
  3. 自定义模板 - 根据需求修改脚本
  4. 创建内容 - 开始写精彩的文章！

相关资源

结论

new-post 脚本是一个强大的工具，可以节省时间并确保 SEO 最佳实践。通过自动化 frontmatter 创建，你可以专注于最重要的事情：创建优质内容。

今天就开始使用它，体验内容创作工作流程的不同！

有问题或反馈？ 在 GitHub 上提交 issue 或加入我们的讨论。

Edit page
Share this post on:
Share on Twitter Share on LinkedIn Share on Telegram
Previous Post
Hugo Paper 中的动态 OG 图片生成
Next Post
Hugo Paper 动态 OG 图片生成：提升社交媒体互动率