# Build My Blog

**Repository Path**: fangchenhao2024/MyBlog

## Basic Information

- **Project Name**: Build My Blog
- **Description**: 将Markdown文件转为静态html页面后，使用github pages或者gitee pages来展现个人博客
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2024-03-03
- **Last Updated**: 2024-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyBlog 项目

使用github Pages或者gitee pages  
使用Miniserve启动本地的服务


## 文件目录介绍
+ **Blog文件夹**：存放生成好的静态页面
+ **Build文件夹**：存放js脚本文件，用于将Markdown文件转为html文件
+ **Layout文件夹**：存放基本的布局文件，在Build时，会读取其中的布局文件并将内容填充进去，最后生成html文件。
+ **Markdown_files**：存放Markdown文件
+ **tools**: 其中有Nodejs的二进制文件和miniserve


## 所需工具

### Nodejs
为了能够在本地运行js脚本，所以我们需要安装nodejs

#### 在ubuntu系统中
在ubuntu系统中可以直接通过命令安装nodejs，命令如下：
```
sudo apt install nodejs

node -v      //测试是否安装成功
```

#### 在Windows系统中
+ 进入[Nodejs官网](https://nodejs.org/en/download)
+ 下载Windows版本的安装包
+ 直接安装


### MiniServe
miniserve是一个小巧、简单的HTTP文件服务器，用Rust语言编写。它非常适合快速共享文件或目录，特别是在需要在局域网中或临时场合下快速设置文件共享时。miniserve因其易用性、高性能以及跨平台支持而受到欢迎。它可以作为Python的http.server模块或PHP的内置服务器的替代品，提供一种更高效和功能更丰富的方式来共享文件。  
可以在[miniserve](https://github.com/svenstaro/miniserve/releases)下载,在tools文件夹中已经有了一个。  
使用命令如下：
```
./minserve /path/to/your/file -o
```


## 设置Node.js环境变量
+ **Linux系统**：直接使用`tools/Nodejs/start_nodejs.sh`脚本
    ```
    source tools/Nodejs/start_nodejs.sh
    ```
    使用`source`命令（或者其简写形式`.`）来执行脚本。这会在当前的 shell 会话中读取并执行脚本中的命令，而不是创建一个子进程。这样，脚本中对环境变量的修改就会影响到当前的 shell 会话。

## 启动本地服务
+ **Ubuntu 环境**
    ```
    ./tools/MiniServe/minserve ./Blog/ -o
    ```


## 使用方法
### Ubuntu系统

使用generate.sh脚本全自动生成+推送：`source generage ${commit信息}`
也可以自己使用Build文件中的.js文件
```
node Build/clearAll.js
node Build/buildAll.js
node Build/pushAll.js
```