发表更新9 分钟读完 (大约1391个字)0次访问

Hello World

十分钟入门Github Page

hexo Start

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 确认并安装npm
npm -v
# 如果不存在，则安装npm
# https://nodejs.org/en/download/


#
# 安装project dependencies到项目目录/node_modules下
#
cd  wumin199.github.io/
npm install # 安装packages.json中的所有依赖， install all the dependencies in your project



#
# 举例：安装npm包
#

cd  wumin199.github.io/
# Set-ExecutionPolicy Bypass -Scope Process -Force # 有些Windows电脑powershell没有权限，则需要执行这句

# 一：全局安装 hexo-cli
npm install -g hexo-cli  # -g 表示将 hexo-cli安装在全局目录
hexo -v

# 二：安装到执行终端的目录
npm install hexo-cli
npx hexo -v  # 执行项目下的npm模块的话，需要加npx

说明：

  1. 在windows下按照nodejs，如果不是安卓在C盘下，执行 npm -v的时候会报错：

    1
    2
    3
    4
    5
    6
    7
    8
    PS C:\Users\wumin> npm -v
    npm : 无法加载文件 D:\installed\nodejs\npm.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.co
    m/fwlink/?LinkID=135170 中的 about_Execution_Policies。
    所在位置 行:1 字符: 1
    + npm -v
    + ~~~
        + CategoryInfo          : SecurityError: (:) []，PSSecurityException
        + FullyQualifiedErrorId : UnauthorizedAccess

    解决方法是在powershell中执行： Set-ExecutionPolicy Bypass -Scope Process -Force

    不过后续也会有其他问题，比如 npm install 会安装到其他目录中，而不是项目文件夹下

  2. Windows下可以通过程序与管理，卸载Nodejs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

#
# npm install到项目文件夹而不是全局的话
# 执行如下代码需要加 npx
# 如 npx hexo clean
#

# 
#
hexo clean
hexo g  # 重新generate
hexo s  # 启动server
# windows下如果启动不起来，则：
# 1. 用Edge浏览器
# 2. 防火墙中允许npm: 控制面板 -> “系统和安全” > “Windows 防火墙” -> “允许应用通过 Windows 防火墙” -> “更改设置” -> “允许其他应用...” -> “添加” -> "C:\Program Files\nodejs\node.exe" -> 确保“公用”和“专用”两个复选框都被选中 -> “确定” -> 再用Edge浏览器打开

# 
# 新建post
hexo new "my_new_pose"

# add and push
git add .
git commit -am ""
git push

有时候需要切换端口

1
2
3
hexo server -p 5612
# 或者
hexo s -p 5612

有时候打不开网页，可以尝试如下方法：

  • 切换到Edge浏览器或者Firefox浏览器
  • https://localhost:5612/ -> http://localhost:5612/

Page说明

  1. 图片是放到 wm-blog-image 这个repo的main分支下

选择Hexo

  • 选择Jeklly或者Hexo -> Hexo胜出

    • jeklly在docker中安装老是出问题
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Node.js® is an open-source, cross-platform JavaScript runtime environment.
# npm全称Node Package Manager，是node的包管理工具，是用JavaScript写出来的工具 ，被内置进了node中，是随同NodeJS一起安装的包管理和分发工具，它可以很方便的让前端开发者下载/安装/上传以及管理已经安装的包

###############################################
# docker中install Node.js v18.x:
###############################################

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs
node -v
npm -v

# uninstall nodejs
apt-get purge nodejs && rm -r /etc/apt/sources.list.d/nodesource.list

###############################################
# install Hexo
###############################################
npm install -g hexo-cli
echo 'PATH="$PATH:/usr/lib/node_modules/hexo-cli/node_modules/.bin"' >> ~/.profile
source ~/.profile
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# [首次执行]cd到blog的root目录下，初始化文件夹
# 只需要第一次执行即可
mkdir website
cd website
hexo init [folder]  # hexo init .

# [不推荐，有bug]安装thems: icarus
# 这个方法运行起来有问题，原因是node版本过高
# https://zhuanlan.zhihu.com/p/410382603
cd website/themes
mkdir icarus
cd icarus
git clone https://github.com/ppoffice/hexo-theme-icarus.git --depth 1

# [推荐][首次执行]安装themes: icarus
# 安装完以后，hexo-theme-icarus和hexo-renderer-inferno被安装到 node_modules/下
cd website # root of this repo
npm install -S hexo-theme-icarus hexo-renderer-inferno
npm install --save hexo-blog-encrypt  # 用于文章加密
updatedb
npm list

# [首次执行]修改配置
_config.yml -> theme: icarus

# 生成新post
# 删除的话，直接删除source/xx.md 后重新 generate
hexo new "post title"
hexo new page --path about/me "About me"  # source/about/me.md

# 生成静态文件
# hexo clean
hexo g

# 启动本地server
hexo server  # http://localhost:4000/

# [首次执行] git处理
cd website
git init 
git add .
git commit -am "update"
git remote add origin git@github.com:wumin199/wumin199.github.io.git
git branch -M main
git push -u origin main

# [首次执行] 配置 github workflows
# 添加.github/workflows/pages.yml  -> see: https://hexo.io/zh-cn/docs/github-pages.html
# pages.yml 在本docker中可以用下方的
# 当部署作业完成后，产生的页面会放在储存库中的 gh-pages 分支

# 在储存库中前往 Settings > Pages > Source，并将 branch 改为 gh-pages

# 之后在master下进行push
git add .
git commit -am ""
hexo g
hexo s # 本地测试好以后
git push  # master下，此时gh-pages也会被push到remote

自动部署： .github/workflows/pages.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
name: Pages

on:
  push:
    branches:
      - main # default branch

jobs:
  pages:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v2
      - name: Use Node.js 18.x
        uses: actions/setup-node@v2
        with:
          node-version: "18"
      - name: Cache NPM dependencies
        uses: actions/cache@v2
        with:
          path: node_modules
          key: ${{ runner.OS }}-npm-cache
          restore-keys: |
            ${{ runner.OS }}-npm-cache
      - name: Install Dependencies
        run: npm install
      - name: Build
        run: npm run build
      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public

参考资料

Hello World

https://wumin199.github.io/post/20230307124929.html

作者

wumin199

发布于

2023-03-07

更新于

2025-02-13

许可协议

评论

×