[该项目](https://github.com/42tr/x)以 Rust 编写，用于将常用信息以邮件的方式发送给自己~



## 自动部署
```yml
name: Rust CI and Deploy

on:
  push:
    branches:
      - main  # 监听 main 分支的推送

jobs:
  build-and-deploy:
    environment: 
      name: 42tr
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v2

    - name: Set up Rust
      uses: actions-rs/toolchain@v1
      with:
        toolchain: stable
        override: true

    - name: Build project
      run: cargo build --release
    
    - name: copy file via ssh password
      uses: appleboy/scp-action@master
      with:
        host: ${{secrets.SERVER_HOST}}
        username: ${{ secrets.SERVER_USER }}
        password: ${{ secrets.SERVER_PASSWORD }}
        port: 22
        source: "target/release/x"
        target: "/home/x/"
      
    - name: copy file via ssh password
      uses: appleboy/scp-action@master
      with:
        host: ${{secrets.SERVER_HOST}}
        username: ${{ secrets.SERVER_USER }}
        password: ${{ secrets.SERVER_PASSWORD }}
        port: 22
        source: "Dockerfile"
        target: "/home/x/"

    - name: Deploy to CentOS server
      uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.SERVER_HOST }}
        username: ${{ secrets.SERVER_USER }}
        password: ${{ secrets.SERVER_PASSWORD }}
        port: 22
        script: |
          cd /home/x/
          mv target/release/x ./
          rm -rf target
          docker stop kex >> /dev/null 2>&1
          docker rm kex >> /dev/null 2>&1
          docker rmi x >> /dev/null 2>&1
          docker build -t x .
          docker run -d --restart unless-stopped -p 8080:8080 -e EMAIL_AUTHORIZE_CODE=${{ secrets.EMAIL_AUTHORIZE_CODE }} --name=kex x ./x
```

## 遇到的问题
- Q: ./x: error while loading shared libraries: libssl.so.3: cannot open shared object file: No such file or directory

  A: install openssl from `https://openssl-library.org/source/` download ./config make make install
  
- Q: error while carry out `./config`

  ```txt
  Can't locate IPC/Cmd.pm in @INC (you may need to install the IPC::Cmd module) (@INC contains: /home/openssl-3.4.0/util/perl /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 /home/openssl-3.4.0/external/perl/Text-Template-1.56/lib) at /home/openssl-3.4.0/util/perl/OpenSSL/config.pm line 19. BEGIN failed--compilation aborted at /home/openssl-3.4.0/util/perl/OpenSSL/config.pm line 19. Compilation failed in require at /home/openssl-3.4.0/Configure line 23. BEGIN failed--compilation aborted at /home/openssl-3.4.0/Configure line 23. 
  ```
  
  A: `yum install perl-IPC-Cmd`
  
- Q: 执行报错
  ```txt
  Configuring OpenSSL version 3.4.0 for target linux-x86_64 Using os-specific seed configuration Created configdata.pm Running configdata.pm Can't locate Getopt/Long.pm in @INC (you may need to install the Getopt::Long module) (@INC contains: /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5) at configdata.pm line 34986. BEGIN failed--compilation aborted at configdata.pm line 34986. 
  ```
  A: `yum install perl-Getopt-Long`
  
- Q: error while carry out `./make install`
  ```txt
  Can't locate Pod/Html.pm in @INC (you may need to install the Pod::Html module)
  ```
  A: `yum install perl-Pod-Html`
  
- Q: error while carry out `./make`
  ```txt
  Can't locate Data/Dumper.pm in @INC (@INC contains: Configurations . /home/openssl-3.4.0/util/../Configurations /home/openssl-3.4.0/util/perl /home/openssl-3.4.0/Configurations /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 /home/openssl-3.4.0/external/perl/Text-Template-1.56/lib /home/openssl-3.4.0/util/../external/perl/Text-Template-1.56/lib) at exporters/cmake/OpenSSLConfig.cmake.in line 5.
  ```
  A: 安装依赖
  ```shell
  yum install perl-Data-Dumper
  ln -sf /home/openssl-3.4.0/libssl.so.3 /usr/lib64/libssl.so.3
  ln -sf /home/openssl-3.4.0/libcrypto.so.3 /usr/lib64/libcrypto.so.3
  ```

  改用 docker，Dockerfile 如下
  ```Dockerfile
  FROM ubuntu
  RUN apt-get update && apt-get install -y ca-certificates
  COPY ./x /tmp/x
  WORKDIR /tmp/
  RUN chmod +x x
  ```

  旧版本的 `ubuntu` 也会有 `openssl` 问题，由于 `docker` 现在使用不方便，服务器改用 ubuntu 新版本。对依赖 `openssl` 的库，使用 `rustls-tls` 特性，可以去除对 `openssl` 的依赖。但是 `native-tls` 也会依赖 `openssl`，使用 `cargo tree` 查看项目中是否仍有 `openssl` 或 `native-tls` 相关的依赖。

Email Assistant - X

使用 html 制作简历~





制作简历的方式：word 文档、markdown、latex、html。
- word 文档

  word 文档是最常用的方式，但是需要手动调整格式，比较麻烦。

- markdown

  markdown 是一种轻量级的文本格式，可以借助工具生成 html。markdown 的语法比较简单，可以参考 [markdown 语法](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)。

- latex

  latex 是一种公式编辑工具，可以借助工具生成 html。latex 的语法比较复杂，可以参考 [latex 语法](https://zh.wikipedia.org/wiki/LaTeX)。latex 可以使用 [overleaf](https://www.overleaf.com/) 进行编辑，里面有很多模板可以使用。但是想要自己定制的话还是要熟悉 latex 语法，很不方便。

- html

  作为 web 全栈，html 自然不用多说，写好后通过网页打印成 pdf 即可。注意去掉页眉和页脚，显示背景图像。[源码参考](https://github.com/42tr/42tr.github.io/blob/42tr/src/pages/resumeZh/resumeZh.vue)
  

![image.png](/static/img/bcf1ed7af1eaf739cd7bc8b5f4dfd034.image.png)

制作简历

生成打卡图片

一直没有满意的写文章的地方，所有应用都有些无法满足要求的点，不如自己写一个。最终还是放弃了，写博客还是愿意下笔重要~





## 实现
- 前端框架

  vue3 + vite + naive-ui

- 访客计数

  使用 不蒜子

  问题：访问子页的流量未统计。

- 允许被搜索引擎爬取

  根目录设置 robots.txt

  google：判断是否被索引：搜索 site:42tr.github.io，未被索引会提示使用 google search consoloe，验证网站所有权，添加站点地图 sitemap.xml，完成后过一天再看。

- Github Actions 自动部署

  生成一个 Personal access token，加入到该仓库的 new repository secret，Name 为 ACCESS_KEY，Value 为 token，在代码目录新建 .github/workflows/pages.yml，内容如下

```yml
name: GitHub Actions Build and Deploy
on:
  push:
    branches:
      - 42tr
jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v2.3.1
        with:
          persist-credentials: false

      - name: Install and Build 🔧
        run: |
          npm install
          npm run build
      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@3.7.1
        with:
          ACCESS_TOKEN: ${{ secrets.ACCESS_KEY }}
          BRANCH: gh-pages
          FOLDER: dist
          CLEAN: true
```

## 开发中遇到的问题
- 打包发布到 github.io 的文件无法加载

  问题原因：打包后生成的文件名以下划线开头，无法返回。

  解决方案：修改 vite.config.ts
  ```typescript
  export default defineConfig({
      plugins: [vue()],
      build: {
          rollupOptions: {
              output: {
                  // 入口文件名
                  // entryFileNames: `assets/[name].js`,
                  // 块文件名：不能下划线开头，增加一个 main 前缀
                  chunkFileNames: `assets/main-[name]-[hash].js`,
                  // 资源文件名 css 图片等等
                  // assetFileNames: `assets/[name]-[hash].[ext]`,
              }
          }
      }
  })
  ```

- 解决发布缓存问题——增加唯一标识，如时间戳
  ```typescript
  const timestamp = new Date().getTime()

  export default defineConfig({
    build: {
      rollupOptions: {
        output: {
          // 入口文件名
          entryFileNames: `assets/[name].${timestamp}.js`,
          // 块文件名
          chunkFileNames: `assets/[name]-[hash].${timestamp}.js`,
          // 资源文件名 css 图片等等
          assetFileNames: `assets/[name]-[hash].${timestamp}.[ext]`,
        },
      },
    }
  })
  ```

使用 html 写博客

# Nightly
## 安装
```
rustup install nightly
rustup default nightly
```