vllm-project/vllm-project.github.io
GitHub: vllm-project/vllm-project.github.io
vLLM 项目官方博客的 Jekyll 源码仓库,提供博客文章编写、本地预览和自动部署的完整工作流。
Stars: 45 | Forks: 105
# vLLM 博客源码
## 本地开发
1. 运行 `gem install jekyll bundler` 来安装 `jekyll` 和 `bundler`。如果遇到任何问题,请向 ChatGPT 寻求帮助。
2. 运行 `bundle install` 来安装必要的 gems。
3. 如果遇到 gem 错误,请执行 `rm ./Gemfile.lock`。
4. 运行 `bundle exec jekyll server` 来编译并启动服务器。
要添加新的博客文章,请参考 `_posts/2023-06-20-vllm.md` 作为示例。注意事项:
- Google Doc 可以保存为 markdown 格式,这会让你的工作更轻松。
- 请注意,只有当博客文章的日期为过去的日期时,它才会显示。
- 将图片放置在 `assets/figures/yourblogname/` 目录下。
- 提交一个 pull request。
当 `main` 分支有代码推送时,博客会通过 GitHub Actions 自动构建和部署。
## LaTeX 数学公式
本博客通过 [MathJax](https://docs.mathjax.org/en/latest/index.html) 支持 LaTeX 数学公式。
可以通过在文档 frontmatter 中添加 `math: true` 来启用。它已被配置为支持标准的 LaTeX 风格数学符号,即:
```
$ inline math $
```
```
$$
math block
$$
```
## GitHub 风格的 Admonitions
本博客通过 [jekyll-gfm-admonition](https://github.com/Helveg/jekyll-gfm-admonitions) 支持 GitHub 风格的 admonitions。它支持以下语法:
```
> [!NOTE]
> Highlights information that users should take into account, even when skimming.
> And supports multi-line text.
> [!TIP]
> Optional information to help a user be more successful.
> [!IMPORTANT]
> Crucial information necessary for users to succeed.
> [!WARNING]
> Critical content demanding immediate
> user attention due to potential risks.
> [!CAUTION]
> Negative potential consequences of an action.
> Opportunity to provide more context.
```
## 主题自定义
我们使用的主题是 [Minima](https://github.com/jekyll/minima)。如果你需要对该主题进行任何自定义,请参阅[覆盖主题默认设置](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)。
标签:Jekyll, 博客, 后端开发, 文档, 特权提升, 自动化部署, 静态网站