• 简体中文
  • 快速开始

    本节会帮助你为 Rspress 添加 Graphviz 支持。

    安装

    # npm
    npm i rspress-plugin-viz @viz-js/viz -D
    
    # pnpm
    pnpm add -D rspress-plugin-viz @viz-js/viz
    
    # yarn
    yarn add -D rspress-plugin-viz @viz-js/viz

    配置

    在 Rspress 配置中注册插件。

    // rspress.config.ts
    import { defineConfig } from '@rspress/core';
    import viz from 'rspress-plugin-viz';
    
    export default defineConfig({
      plugins: [viz()],
    });

    使用

    在 Markdown 中使用 viz 语言代码块。

    ```viz
    digraph G {
      rankdir=LR
      a -> b [label="a to b"];
      b -> c [label="another label"];
    }
    ```

    渲染效果如下:

    Loading graph...

    使用说明:

    • 可选缩放:在语言名之后添加缩放系数,例如 {0.75}
    ```viz {0.75}
    digraph G {
      a -> b;
    }
    ```

    渲染效果如下:

    Loading graph...

    高级配置

    viz 支持以下选项:

    interface PluginVizOptions {
      /**
       * 自定义外层 div 的 CSS class。
       */
      className?: string;
    
      /**
       * className 的兼容别名。
       */
      class?: string;
    
      /**
       * 默认 SVG 缩放比例。
       * @default 1
       */
      scale?: number;
    }

    致谢