# jianmu-blog

**Repository Path**: comyan/jianmu-blog

## Basic Information

- **Project Name**: jianmu-blog
- **Description**: 建木博客
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 15
- **Created**: 2022-02-09
- **Last Updated**: 2024-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 建木博客文章发布

### 投稿流程
![建木博客-投稿](./source/assets/blog-source/建木博客-投稿.png)

### 审核流程
![建木博客-审核](./source/assets/blog-source/建木博客-审核.png)

### 发布流程
![建木博客-发布](./source/assets/blog-source/建木博客-发布.png)

### 文件组成

- markdown
- 图像等资源

### 文件存放位置
注意：图像等静态资源目录名不能含有空格。
#### 正式文章
    - markdown存放在`/source/_posts`对应的分类目录下
    - 图像等静态资源存放在`/source/assets`对应的分类目录下，建议每篇文章新建一个目录存放各自的资源

#### 草稿
    不想立即发布文章时，可以使用草稿功能，将草稿提交到master分支。
    
    - markdown文章存放在`/source/_drafts`目录下。（如果_drafts目录不存在就手动创建，gitee无法提交空目录可能会导致在没有草稿时没有_drafts目录）
    - 图像等静态资源存放在`/source/assets`目录下，建议每篇文章新建一个目录存放各自的资源。

### markdown文章配置

文章开头需要定义一些变量，用于展示文章信息。定义在markdown的最开头，使用三个短横线开头和结尾。

```
---
title: 文章标题
date: 发布时间
categories: 文章标签
comments: 是否打开评论
image: 文章列表的展示图片:/assets/图片路径 (文章封面宽高比例为2.35:1，例如900px:383px)
excerpt: 文章摘要，显示在列表
author: 作者
---
```

### 外部文章

列表中点击链接到微信公众号等外部平台时使用，不会打开博客内容，直接打开外部文章。 外部文章草稿和普通文章草稿操作一致。

- 在`/source/_posts`目录下新建markdown
- 图像等静态资源存放在`/source/assets`对应的分类目录下
- markdown的内容

```
---
title: 文章标题
date: 发布时间
categories: 文章标签
comments: 是否打开评论
image: 文章列表的展示图片:/assets/图片路径 (文章封面宽高比例为2.35:1，例如900px:383px)
customPath: 外部文章链接
excerpt: 文章摘要，显示在列表
author: 作者
---
```

### 预览

```
# 安装依赖
yarn
或
npm install

# 启动服务
yarn server
或
npm run server

# 预览草稿
yarn server --drafts
或
npm run server -- --drafts
```

### 统计文件配置

在每次新提交文章时(草稿除外)，需要在jianmu-blog/data/articles.json文件的数组第一个(下标0的位置)加上以下配置，和新增文章一起提pr到master分支。

date正确格式：`yyyy-MM-ddTHH:mm:ss`。示例：`2022-06-20T02:00:00`，如果格式错误将无法生效。

```
{
  "author":"作者",
  "date":"文章发布时间(格林威治时间，例如:2022-06-20T01:30:00)",
  "link":"生产环境本篇文章的url",
  "platform":{},
  "read_counts":0,
  "title":"文章标题"
}
```

在文章发布后，并且在其他平台(CSDN、掘金)转载后需要将文章链接添加到jianmu-blog/data/articles.json对应的文章配置下提pr到master分支。
```
{
  "author":"作者",
  "date":"文章发布时间(格林威治时间，例如:2022-06-20T01:30:00)",
  "link":"生产环境本篇文章的url",
  "platform":{
    "csdn":"示例文章在CSDN的url",
    "juejin":"示例文章在掘金的url",
  },
  "read_counts":0,
  "title":"示例文章"
}
```