@farming-labs/nuxt-theme

中文文档
0.2.146发布于 2026/11/14MITTypeScriptES Module近 30 天下载 6016

@farming-labs/docs的 Nuxt/Vue UI 组件——布局、侧边栏、TOC、搜索和主题切换

中文使用文档
文档目录7 节
  1. 安装
  2. 配置主题
  3. 打开文件UI
  4. 主要出口
  5. 学多点
  6. 许可证
  7. 可选 AI 装入

@ 农作- labs/ nuxt- 主题

Vue 和 Nuxt 用户界面层和主题预设软件包 @farming-labs/docs。 。 。 .

它使文件外壳,页面内容,目录,面包屑,搜索,AI聊天,API 引用切换器和主题控件。 内容加载和硝基处理器 @farming-labs/nuxt。 。 。 .

安装

npm install @farming-labs/docs @farming-labs/nuxt @farming-labs/nuxt-theme @farming-labs/theme

CLI可以脚手架 完整的Nuxt整合:

npx @farming-labs/docs@latest init

配置主题

// docs.config.ts
import { defineDocs } from "@farming-labs/docs";
import { fumadocs } from "@farming-labs/nuxt-theme";

export default defineDocs({
  entry: "docs",
  contentDir: "docs",
  theme: fumadocs(),
  nav: { title: "Docs", url: "/docs" },
});

添加匹配的共享 CSS nuxt.config.ts数字 :

export default defineNuxtConfig({
  css: ["@farming-labs/theme/default/css"],
});

打开文件UI

<script setup lang="ts">
import { DocsContent, DocsLayout } from "@farming-labs/nuxt-theme";
import config from "~/docs.config";

const { data } = await useFetch("/api/docs", {
  query: { pathname: useRoute().path },
});
</script>

<template>
  <DocsLayout :tree="data.tree" :config="config">
    <DocsContent :data="data" :config="config" />
  </DocsLayout>
</template>

主要出口

  • DocsLayout, (中文(简体) ), DocsContent,以及 DocsPage
  • TableOfContents, (中文(简体) ), Breadcrumb,以及 ThemeToggle
  • SearchDialog, (中文(简体) ), FloatingAIChat,以及 ApiReferenceSwitcher
  • 主题预设工厂

预设子路径为 fumadocs, (中文(简体) ), pixel-border, (中文(简体) ), darksharp, (中文(简体) ), colorful, (中文(简体) ), greentree, (中文(简体) ), hardline, (中文(简体) ), concrete, (中文(简体) ), command-grid,以及 ledger编辑 fumadocs 预设用途 @farming-labs/theme/default/css; 其他预设使用匹配 @farming-labs/theme/<preset>/css 进入点.

学多点

许可证

麻省理工学院

可选 AI 装入

浮动的AI触发器与页面一起加载. 第一次激活时它的聊天执行负载 关闭后继续挂起 所以重开对话 面板,模式,弹出式, 完整模式和自定义触发器保留其现有的标记和配置.

版本与发布记录

@farming-labs/nuxt-theme 共发布 366 个版本,首次发布于 2026/02/22;过去 12 个月发布了 366 个版本。

版本发布日期距今
0.2.146latest2026/11/14今天
0.2.1452026/11/131 天前
0.2.1442026/11/131 天前
0.2.1432026/11/068 天前
0.2.1422026/11/068 天前
0.2.1412026/11/059 天前

其他发布通道:perf → 0.2.133-perf.1,beta → 0.2.139-beta.1。

关于 @farming-labs/nuxt-theme 的常见问题

@farming-labs/nuxt-theme 是什么?

@farming-labs/docs的 Nuxt/Vue UI 组件——布局、侧边栏、TOC、搜索和主题切换

如何安装 @farming-labs/nuxt-theme?

在项目目录运行 npm install @farming-labs/nuxt-theme,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(>=3.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@farming-labs/nuxt-theme 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@farming-labs/nuxt-theme 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@farming-labs/nuxt-theme 可以商用吗?

@farming-labs/nuxt-theme 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@farming-labs/nuxt-theme 的下载量有多少?

根据 npm 官方下载统计,@farming-labs/nuxt-theme 在 2026/10/15 – 2026/11/13 这 30 天内被下载 6,016 次,日均约 201 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@farming-labs/nuxt-theme 还在维护吗?

最新版本 0.2.146 发布于 2026/11/14(今天);至今共发布 366 个版本,其中过去 12 个月发布了 366 个;首次发布于 2026/02/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。