Repolode
bas3line

bas3line/ascii

面向 React、Next.js、Astro 和原生 HTML 的动态 ASCII 艺术组件库,内置 240 个作品。

Star
939
Fork
54
未关闭 Issue
5
最近提交
3天前

这是什么?

ascii.rest 是一个 TypeScript 库,用于在网页上绘制动态 ASCII 艺术。内置 240 个现成作品,涵盖文字特效、图表、加载动画、3D 图形、物理模拟、场景,以及编程语言、Linux 发行版和公司的标志。

作品可以以多种方式使用:作为 React 或 Astro 组件,作为无需构建步骤的 `<ascii-art>` HTML 标签,或通过 `mount()` 在原生 TypeScript 中调用。kit API 可以基于命名的外观、运动和控件组合出新作品。同样的作品还能导出为动画 SVG 用于 GitHub README,或在终端中播放,包括作为启动画面。

该库还提供通过 URL 参数生成动态文字横幅的功能,并可在浏览器中把上传的图片转换为 ASCII 动画。

核心功能

  • 01提供场景、图表、加载动画、3D 图形、物理模拟和标志等 240 个现成作品。
  • 02支持 React 和 Astro 组件,也可直接使用 `<ascii-art>` HTML 标签。
  • 03可导出动画 SVG,嵌入 GitHub README。
  • 04支持在终端中播放,并提供仅依赖 Node 内置模块的启动画面 API。
  • 05图片转 ASCII 在浏览器中完成。

适用场景

  • 在极简风格的个人主页或文档站点中加入动态 ASCII 元素。
  • 在命令行工具启动时显示加载动画或 ASCII 横幅。
  • 在 GitHub README 顶部放置动态 Logo 或横幅。
  • 使用 kit API 为项目生成定制的 ASCII 艺术作品。

快速上手

  1. 1

    从 npm 安装该包

    npm install ascii.rest
  2. 2

    无需安装,直接在终端中运行

    npx ascii.rest rust
  3. 3

    在 React 组件中使用作品

使用前须知

  • 终端中大多数彩色作品需要 24 位色支持,否则需使用 mono 选项改为单色显示。
  • 部分功能(如图片转 ASCII 工具)依赖 ascii.rest 网站。

标签

常见问题

ascii 是什么?
面向 React、Next.js、Astro 和原生 HTML 的动态 ASCII 艺术组件库,内置 240 个作品。 ascii.rest 是一个 TypeScript 库,用于在网页上绘制动态 ASCII 艺术。内置 240 个现成作品,涵盖文字特效、图表、加载动画、3D 图形、物理模拟、场景,以及编程语言、Linux 发行版和公司的标志。
ascii 可以免费使用吗?用的什么许可证?
ascii 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ascii 还在维护吗?
活跃维护中。ascii 最近一次提交是在 2026年10月17日。
ascii 适合用来做什么?
在极简风格的个人主页或文档站点中加入动态 ASCII 元素。 在命令行工具启动时显示加载动画或 ASCII 横幅。 在 GitHub README 顶部放置动态 Logo 或横幅。 使用 kit API 为项目生成定制的 ASCII 艺术作品。
ascii 怎么安装和运行?
从 npm 安装该包: npm install ascii.rest 无需安装,直接在终端中运行: npx ascii.rest rust 在 React 组件中使用作品
在哪里获取 ascii?
源代码和安装说明在 GitHub 上:https://github.com/bas3line/ascii

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目