Astro作品集博客

astroplex — Astro 作品集模板

作者 bluephoeniiix

Astroplex 是基于 Astro Starlight 的文档主题改造项目，替换字体为 IBM Plex、调整主题配色并补充 KaTeX 数学公式支持，可用于作品集与博客类站点。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-03查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 Astro Starlight 派生并做主题优化

字体由 Roboto 替换为 IBM Plex 字体族

主题配色参考 IBM Carbon Design 的浅色/深色方案

补充了 Starlight 缺失的 KaTeX 数学公式支持

提供 Docker 与 install.sh 的安装脚本流程

采用 MIT 许可，可免费使用、修改与分发

模板详细介绍

Astroplex 是一个从 Astro Starlight 派生并做优化的主题，仓库自述定位为“An Optimized Theme From Astro Starlight”。改动集中在三处：把 Roboto 字体替换为 IBM Plex 字体族，并针对小视口做了一些调整；主题样式参考 IBM Carbon Design 的浅色/深色方案进行修改；为 Starlight 补上原本缺失的 KaTeX 数学公式支持。README 中把图表（diagram）支持列为待办，并说明还有更多功能在开发中，因此这部分能力目前并不可用。

使用方式上，仓库提供了 install-scripts 目录下的 Docker 构建与运行脚本，通过 install.sh 安装 nvm 与 pnpm 环境，再在 astroplex 目录执行 pnpm install。开发时进入 docs/ 目录运行 npm run dev，README 建议配合 VS Code 的 Remote Dev 与 Docker 插件做端口转发；也可以按说明修改 package.json 的 dev 命令来关闭 Astro 开发工具栏。部署到 GitHub Pages 时需要在页面仓库中加入 .nojekyll 文件。

仓库采用 MIT 许可，可免费使用、修改、商用和分发该版本代码，分发时需保留版权与许可声明。演示图片、字体、图标等第三方素材需单独核对许可，域名、托管等外部服务可能另行收费。

Astro作品集博客

适合你的项目吗？

适用场景

搭建带数学公式的文档或博客站点
制作个人作品集页面
在 Starlight 基础上定制字体与配色主题
用 Docker 环境进行 Astro 项目的本地开发

适合人群

需要 KaTeX 数学公式渲染的文档站点
希望基于 Starlight 二次定制主题的开发者
使用 Docker 与 VS Code 远程开发的前端开发者
准备部署到 GitHub Pages 的个人项目

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
在 install-scripts 目录执行 docker build -t your-image-name . 构建镜像
2
运行 docker run -i -t your-image-name /bin/bash 后执行 bash install.sh 安装环境
3
进入 astroplex 目录执行 pnpm install 安装依赖
4
进入 docs/ 目录执行 npm run dev 启动开发模式
5
部署到 GitHub Pages 时需在页面仓库添加 .nojekyll 文件

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

开发流程依赖 Docker 与 VS Code 远程连接插件；若不使用 VS Code，需自行修改 Docker 端口转发配置，属于额外的环境依赖。
部署到 GitHub Pages 时必须在页面仓库中添加 .nojekyll 文件，否则以划线开头的资源目录可能无法正常发布。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

You probably need Visual Studio Code for Docker Remote Connect. If not, please modify Docker's port forwarding.
README 原文

Remember to add `.nojekyll` file into your page repo.
README 原文

https://github.com/bluephoeniiix/astroplex/blob/main/LICENSE https://github.com/bluephoeniiix/astroplex/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 73 / 100
技术栈: Astro
网站类型: 作品集 · 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2024-07-15
截图检查日期: 2026-10-03

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: ec56a68fb4a49adc74ea867e06ebd2deef708eb93ec47cb697bf926798cc7da6

2026-10-03T00:47:07.434Z

来源文件 / 仓库

# Astroplex
An optimized theme from Astro Starlight

## Features

### Optimized Typography

- Replaced Roboto fonts with IBM Plex font families
- Minor viewports' adjustments

### Optimized Theme 

- Theme modifications inspired by IBM Carbon Design Light/Dark Theme

### Katex Support

- Implemented missing math formula support from Starlight

### Diagram support (to do)

- Plan to implement missing diagram support from Starlight

More functionalities are under development

## Showcases

[Visit this link](https://bluephoeniiix.github.io)

## How to use

### Installations && Dev

Inside `install-scripts` folder, enter:

```bash
docker build -t your-image-name .
```

Then:

```bash
docker run -i -t your-image-name /bin/bash
```

Then:

```bash
bash install.sh
```

Then activate nvm env:

```bash
bash
```

After this, you can check whether nvm and pnpm are installed or not.

`cd` into `astroplex` folder, type:

```bash 
pnpm install
```

#### Port Forwarding

You probably need Visual Studio Code for Docker Remote Connect. If not, please modify Docker's port forwarding.

Open Visual Studio Code, search for the Remote Dev and Docker plugin, click on the instance, and attach to Visual Studio Code.

Then `cd` into the `docs/` folder, type:

```bash
npm run dev
```

The webpage will be rendered under the dev mode.

### Disable Astro Dev Bar

In the `docs/` folder, find `packages.json`, and replace `dev` option's content with:

```bash
npm cache clean --force && astro preferences disable devToolbar && astro dev
```

## Github Pages

Remember to add `.nojekyll` file into your page repo.

反馈内容错误