0001-01-01

jianghu-en-yuan-lu - 發布工作流程#

🚀 自動化發布系統#

發布腳本使用#

我們已經配置了完整的自動化發布腳本 publish-chapter.sh，可以：

  • 自動生成Hugo front matter
  • 智能創建目錄結構
  • 自動計算字數
  • 生成章節導航鏈接
  • 更新進度追蹤
  • 驗證Hugo構建

基本發布命令#

# 基本發布命令
./scripts/publish-chapter.sh \
  -t "章節標題" \
  -n "jianghu-en-yuan-lu" \
  -f 章節文件.md \
  -c 章節號 \
  -g "武俠"

# 實際示例
./scripts/publish-chapter.sh \
  -t "第三章 武當初遇" \
  -n "jianghu-en-yuan-lu" \
  -f chapter-03.md \
  -c 3 \
  -g "武俠"

發布草稿版本#

# 發布草稿（不會在公開網站顯示）
./scripts/publish-chapter.sh \
  -t "第四章 草稿" \
  -n "jianghu-en-yuan-lu" \
  -f chapter-04-draft.md \
  -c 4 \
  -g "武俠" \
  --draft

📋 發布前檢查清單#

內容質量檢查#

  • 章節完整性: 章節有完整的開頭、發展、結尾
  • 字數要求: 章節字數在1500-3000字之間
  • 情節連貫: 與前後章節情節連貫
  • 角色一致性: 角色性格和行為一致
  • 對話自然: 對話符合角色身份和語氣

格式檢查#

  • 標題格式: 章節標題格式正確
  • 段落結構: 段落清晰，適當分段
  • 標點符號: 標點符號使用規範
  • 特殊字符: 特殊字符顯示正常
  • 文件編碼: UTF-8編碼

BMad質量檢查#

  • Character Psychologist檢查: 角色心理發展合理
  • World Builder檢查: 世界觀設定一致
  • Plot Architect檢查: 情節節奏合適
  • Dialog Specialist檢查: 對話質量良好
  • Editor檢查: 整體文字質量

技術檢查#

  • 文件存在: 章節文件存在且可讀
  • 文件權限: 文件權限允許讀取
  • 目錄結構: 目標目錄結構正確
  • Hugo配置: Hugo配置文件正確

🔄 發布流程#

標準發布流程#

  1. 創作完成

    # 確保章節文件在正確位置
ls content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/

  2. 質量檢查

    # 使用BMad代理檢查質量
/BMad:agents:editor
*task final-polish

  3. 字數統計

    # 確認字數
wc -w content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-03.md

  4. 執行發布

    # 執行發布腳本
./scripts/publish-chapter.sh \
  -t "第三章 武當初遇" \
  -n "jianghu-en-yuan-lu" \
  -f content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-03.md \
  -c 3 \
  -g "武俠"

  5. 驗證發布

    # 本地預覽
hugo server -D

# 檢查章節是否正確顯示
curl http://localhost:1313/novels/wuxia/jianghu/chapter-03-wu-dang-chu-yu/

  6. 更新進度

    # 更新進度追蹤
*task update-writing-progress

草稿發布流程#

  1. 創作草稿

    # 創建草稿文件
touch content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-04-draft.md

  2. 發布草稿

    # 發布為草稿
./scripts/publish-chapter.sh \
  -t "第四章 草稿" \
  -n "jianghu-en-yuan-lu" \
  -f content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-04-draft.md \
  -c 4 \
  -g "武俠" \
  --draft

  3. 編輯完善

    # 直接編輯已發布的草稿
vim content/novels/wuxia/jianghu/chapter-04-cao-gao.md

  4. 正式發布

    # 修改front matter中的draft: false
# 或重新發布（去掉--draft參數）

📊 發布後維護#

進度更新#

  • 項目概覽: 更新 project-overview.md
  • 進度追蹤: 更新 progress-tracker.md
  • 統計數據: 更新字數和章節統計
  • 里程碑更新: 標記達成的里程碑

社交媒體分享#

  • 微博分享: 分享新章節發布消息
  • 論壇推廣: 在相關論壇推廣
  • 讀者通知: 通知常讀者更新
  • 統計分析: 分析閱讀數據

反饋收集#

  • 評論監控: 監控讀者評論
  • 問題記錄: 記錄讀者發現的問題
  • 建議收集: 收集改進建議
  • 下次改進: 在下次寫作中改進

🔧 自定義設置#

章節模板#

可以自定義章節模板：

---
title: "章節標題"
date: 2024-10-06T12:00:00+08:00
draft: false
type: "chapter"
novel: "jianghu-en-yuan-lu"
chapter_number: 3
genre: "武俠"
word_count: 2500
prev_chapter: "chapter-02-chu-ru-jiang-hu"
next_chapter: "chapter-04-hei-feng-zhui-zong"
tags: ["武俠", "AI創作", "小說", "jianghu-en-yuan-lu"]
categories: ["小說", "武俠"]
author: "AI協作創作"
weight: 3
---

# 章節標題

章節內容...

批量發布#

如果需要批量發布多個章節：

#!/bin/bash
# 批量發布腳本示例

CHAPTERS=(
  "3:第三章 武當初遇:chapter-03.md"
  "4:第四章 黑風追蹤:chapter-04.md"
  "5:第五章 古道遇險:chapter-05.md"
)

for chapter_info in "${CHAPTERS[@]}"; do
  IFS=':' read -r num title file <<< "$chapter_info"

  ./scripts/publish-chapter.sh \
    -t "$title" \
    -n "jianghu-en-yuan-lu" \
    -f "content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/$file" \
    -c "$num" \
    -g "武俠"

  echo "已發布第 $num 章: $title"
  sleep 2  # 避免操作太快
done

🚨 故障排除#

常見問題#

1. Hugo構建失敗#

# 檢查Hugo語法
hugo server --verbose --buildDrafts=false

# 常見問題：
# - YAML front matter 格式錯誤
# - 中文文件名問題
# - 特殊字符轉義問題

2. 章節不顯示#

# 檢查draft設置
grep "draft:" content/novels/wuxia/jianghu/chapter-*.md

# 檢查weight設置
grep "weight:" content/novels/wuxia/jianghu/chapter-*.md

# 檢查日期設置
grep "date:" content/novels/wuxia/jianghu/chapter-*.md

3. 導航鏈接錯誤#

# 檢查prev_chapter和next_chapter設置
grep -E "(prev_chapter|next_chapter)" content/novels/wuxia/jianghu/chapter-*.md

# 檢查文件名是否對應
ls -la content/novels/wuxia/jianghu/chapter-*.md

4. 字數統計不準確#

# 手動檢查字數
wc -w content/nriting-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-03.md

# 中文文本特殊處理
grep -o '[\u4e00-\u9fff]' content/writing-workspace/active-projects/jianghu-en-yuan-lu/chapters/chapter-03.md | wc -l

調試模式#

啟用詳細輸出進行調試：

# 設置調試模式
set -x

# 執行發布腳本
./scripts/publish-chapter.sh [參數]

# 關閉調試模式
set +x

📱 自動化提醒#

發布提醒腳本#

#!/bin/bash
# 發布提醒腳本

echo "📚 jianghu-en-yuan-lu發布提醒"
echo "========================"
echo "📝 當前章節: $(ls content/novels/wuxia/jianghu/chapter-*.md | wc -l) 章"
echo "📊 最新字數: $(cat content/writing-workspace/active-projects/jianghu-en-yuan-lu/progress-tracker.md | grep '總字數' | awk '{print $2}')"
echo "🎯 下一章: 第$(($(ls content/novels/wuxia/jianghu/chapter-*.md | wc -l) + 1))章"
echo ""
echo "📋 發布前檢查清單:"
echo "  ☐ 內容質量檢查"
echo "  ☐ 格式檢查"
echo "  ☐ Hugo構建測試"
echo "  ☐ 進度更新"

定時發布設置#

可以設置定時任務自動提醒：

# 添加到crontab
# 每週五提醒發布新章節
0 18 * * 5 /path/to/scripts/publishing-reminder.sh

# 每天檢查發布狀態
0 9 * * * /path/to/scripts/daily-status-check.sh

🎯 最佳實踐#

發布頻率建議#

  • 週期性發布: 每週1-2章，保持讀者興趣
  • 穩定更新: 固定時間發布，培養讀者習慣
  • 質量優先: 寧可慢發布，也要保證質量
  • 互動回應: 及时回應讀者評論和反饋

SEO優化#

  • 關鍵詞: 在標題和內容中合理使用關鍵詞
  • 描述: 為每個章節寫好meta描述
  • 標籤: 使用相關的標籤和分類
  • 鏈接: 確保章節間鏈接正確

讀者體驗#

  • 導航清晰: 提供清晰的章節導航
  • 加載速度: 優化圖片和內容加載速度
  • 移動友好: 確保移動設備閱讀體驗
  • 互動功能: 提供評論和分享功能

工作流程文檔最後更新: 2024-10-06 下次更新: 根據使用經驗優化流程