Medium-to-Own-Blog项目本地开发指南

项目概述

Medium-to-Own-Blog是一个帮助用户将Medium风格博客迁移到独立托管平台的开源工具。它提供了一套完整的解决方案，让用户能够轻松管理自己的博客内容，同时保持类似Medium的写作体验。

本地开发环境搭建

准备工作

在开始本地开发前，请确保你的系统已安装以下软件：

• Node.js (建议使用LTS版本)
• npm (通常随Node.js一起安装)

安装依赖

进入项目目录后，执行以下命令安装项目依赖：

npm install

这个命令会读取项目中的package.json文件，并安装所有必要的依赖包。

启动开发服务器

安装完成后，使用以下命令启动本地开发服务器：

npm start

服务器启动后，你可以在浏览器中访问http://localhost:8000/查看博客。开发服务器支持热重载功能，任何对博客内容的修改都会自动刷新页面。

文章管理指南

创建新文章

1. 创建文章目录： 在项目的content文件夹下新建一个目录，目录名称将作为文章的URL路径。例如，创建my-first-post目录，文章URL将为/my-first-post/。

2. 添加文章文件： 在新创建的目录中，添加一个index.md文件作为文章主体。

3. 配置文章元数据： 在index.md文件顶部使用YAML格式的frontmatter配置文章元数据：

   ---
   title: '文章标题'
   description: '文章简短描述，将显示在博客首页和搜索引擎结果中'
   date: '2023-01-01' # 发布日期，可留空待发布时填写
   categories:
     - 标签1
     - 标签2
   published: true # 设为false则文章不会出现在首页，但仍可通过URL访问
   ---
   

4. 编写文章内容： 在frontmatter下方编写文章正文，支持标准Markdown语法。你可以：

   • 直接使用文本编辑器编写Markdown
   • 使用Medium风格的Markdown编辑器生成内容后粘贴

编辑现有文章

要修改已存在的文章，只需编辑对应目录下的index.md文件。开发服务器会自动检测文件变化并刷新页面。

删除文章

要删除文章，只需删除对应的文章目录（如content/my-first-post）即可。

内容发布流程

完成本地修改后，使用Git将变更推送到远程仓库：

git add .
git commit -m '描述你的修改内容'
git push

推送后，集成的CI/CD服务会自动检测变更并部署更新。通常几分钟内就能看到线上博客的更新。

高级技巧

1. 多级目录结构： 你可以在content目录下创建子目录来组织文章，如content/tech/react-tutorial。

2. 自定义URL： 通过在frontmatter中添加slug字段可以覆盖默认的URL路径。

3. 草稿模式： 设置published: false可以让文章保持草稿状态，不显示在首页但仍可通过直接链接访问。

4. 图片资源管理： 可以在文章目录下创建images子目录存放相关图片，然后在Markdown中引用。

通过这套本地工作流程，你可以完全掌控自己的博客内容，享受比平台托管博客更大的灵活性和管理权限。