mirror of
https://gitee.com/antv/g6.git
synced 2024-11-30 18:58:34 +08:00
1099252812
* feat: update api-doc config * feat: add doc input * feat: update docs
654 lines
19 KiB
TypeScript
654 lines
19 KiB
TypeScript
import { Extractor, ExtractorConfig } from '@microsoft/api-extractor';
|
||
import { defineConfig } from 'dumi';
|
||
import fs from 'fs';
|
||
import path from 'path';
|
||
import { homepage, repository, version } from './package.json';
|
||
|
||
const getExtraLib = () => {
|
||
try {
|
||
const extractorConfig = ExtractorConfig.loadFileAndPrepare(path.resolve('./api-extractor.json'));
|
||
const extractorResult = Extractor.invoke(extractorConfig, {
|
||
localBuild: true,
|
||
showVerboseMessages: true,
|
||
});
|
||
if (extractorResult.succeeded) {
|
||
const typeFilePath = extractorResult.extractorConfig.untrimmedFilePath;
|
||
if (typeFilePath) {
|
||
return `declare module '${name}'{
|
||
${fs.readFileSync(typeFilePath, `utf8`)}
|
||
}`;
|
||
}
|
||
}
|
||
} catch (e) {
|
||
// eslint-disable-next-line no-console
|
||
console.warn(`api-extractor warn: ${e.message}`);
|
||
}
|
||
return '';
|
||
};
|
||
|
||
export default defineConfig({
|
||
locales: [
|
||
{ id: 'zh', name: '中文' },
|
||
{ id: 'en', name: 'English' },
|
||
],
|
||
title: 'G6', // 网站header标题
|
||
favicons: ['https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*7svFR6wkPMoAAAAAAAAAAAAADmJ7AQ/original'], // 网站 favicon
|
||
metas: [
|
||
// 自定义 meta 标签
|
||
{ name: 'keywords', content: 'G6' },
|
||
{
|
||
name: 'description',
|
||
content: 'A collection of charts made with the Grammar of Graphics',
|
||
},
|
||
],
|
||
themeConfig: {
|
||
title: 'G6',
|
||
description: 'A collection of charts made with the Grammar of Graphics',
|
||
defaultLanguage: 'zh', // 默认语言
|
||
isAntVSite: false, // 是否是 AntV 的大官网
|
||
siteUrl: homepage, // 官网地址
|
||
githubUrl: repository.url, // GitHub 地址
|
||
showSearch: true, // 是否显示搜索框
|
||
showGithubCorner: true, // 是否显示头部的 GitHub icon
|
||
showGithubStars: true, // 是否显示 GitHub star 数量
|
||
showAntVProductsCard: true, // 是否显示 AntV 产品汇总的卡片
|
||
showLanguageSwitcher: true, // 是否显示官网语言切换
|
||
showWxQrcode: true, // 是否显示头部菜单的微信公众号
|
||
showChartResize: true, // 是否在 demo 页展示图表视图切换
|
||
showAPIDoc: true, // 是否在 demo 页展示API文档
|
||
themeSwitcher: 'g2',
|
||
versions: {
|
||
// 历史版本以及切换下拉菜单
|
||
[version]: 'https://g6-next.antv.antgroup.com',
|
||
'4.x': 'https://g6.antv.antgroup.com',
|
||
'3.2.x': 'https://g6-v3-2.antv.vision',
|
||
},
|
||
docsearchOptions: {
|
||
// 头部搜索框配置
|
||
apiKey: '9d1cd586972bb492b7b41b13a949ef30',
|
||
indexName: 'antv_g6',
|
||
},
|
||
navs: [
|
||
{
|
||
slug: 'docs/manual/introduction',
|
||
title: {
|
||
zh: '教程',
|
||
en: 'Manual',
|
||
},
|
||
},
|
||
{
|
||
slug: 'examples',
|
||
title: {
|
||
zh: '示例',
|
||
en: 'Examples',
|
||
},
|
||
},
|
||
{
|
||
slug: 'docs/apis',
|
||
title: {
|
||
zh: 'API',
|
||
en: 'API',
|
||
},
|
||
},
|
||
{
|
||
title: {
|
||
zh: '其他资源',
|
||
en: 'Online Tools',
|
||
},
|
||
dropdownItems: [
|
||
// {
|
||
// url: '/design/overview',
|
||
// name: {
|
||
// zh: '设计体系',
|
||
// en: 'Design System',
|
||
// },
|
||
// },
|
||
{
|
||
url: 'https://www.yuque.com/antv/g6-blog',
|
||
name: {
|
||
zh: '文章博客',
|
||
en: 'Blog',
|
||
},
|
||
},
|
||
{
|
||
url: 'https://g6.antv.antgroup.com',
|
||
name: {
|
||
zh: '极速站点',
|
||
en: 'Fast Site',
|
||
},
|
||
},
|
||
{
|
||
name: {
|
||
zh: '在线工具',
|
||
en: 'Graphinsight',
|
||
},
|
||
url: 'https://graphinsight.antgroup.com/#/workspace',
|
||
},
|
||
],
|
||
},
|
||
],
|
||
ecosystems: [
|
||
// 头部的菜单中的「周边生态」
|
||
],
|
||
docs: [
|
||
// ===========Design===================
|
||
// {
|
||
// slug: 'design/global',
|
||
// title: {
|
||
// zh: '全局规范',
|
||
// en: 'Global',
|
||
// },
|
||
// order: 3,
|
||
// },
|
||
// {
|
||
// slug: 'design/component',
|
||
// title: {
|
||
// zh: '组件设计',
|
||
// en: 'Component Design',
|
||
// },
|
||
// order: 4,
|
||
// },
|
||
{
|
||
slug: 'manual/FAQ',
|
||
title: {
|
||
zh: 'FAQ',
|
||
en: 'FAQ',
|
||
},
|
||
order: 2,
|
||
},
|
||
{
|
||
slug: 'manual/tutorial',
|
||
title: {
|
||
zh: '入门教程',
|
||
en: 'Tutorial',
|
||
},
|
||
order: 3,
|
||
},
|
||
// ===========Concepts===================
|
||
// {
|
||
// slug: 'manual/middle',
|
||
// title: {
|
||
// zh: '核心概念',
|
||
// en: 'Middle',
|
||
// },
|
||
// order: 4,
|
||
// },
|
||
|
||
// {
|
||
// slug: 'manual/middle/elements',
|
||
// title: {
|
||
// zh: '图元素:节点/边/Combo',
|
||
// en: 'Graph Elements',
|
||
// },
|
||
// order: 2,
|
||
// },
|
||
|
||
// {
|
||
// slug: 'manual/middle/elements/shape',
|
||
// title: {
|
||
// zh: '图形 Shape(选读)',
|
||
// en: 'Shape',
|
||
// },
|
||
// order: 1,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/nodes',
|
||
// title: {
|
||
// zh: '节点',
|
||
// en: 'Node',
|
||
// },
|
||
// order: 2,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/edges',
|
||
// title: {
|
||
// zh: '边',
|
||
// en: 'Edge',
|
||
// },
|
||
// order: 3,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/combos',
|
||
// title: {
|
||
// zh: 'Combo',
|
||
// en: 'Combo',
|
||
// },
|
||
// order: 4,
|
||
// },
|
||
|
||
// {
|
||
// slug: 'manual/middle/elements/nodes/built-in',
|
||
// title: {
|
||
// zh: '内置节点类型',
|
||
// en: 'Built-in Nodes',
|
||
// },
|
||
// order: 1,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/edges/built-in',
|
||
// title: {
|
||
// zh: '内置边类型',
|
||
// en: 'Built-in Edges',
|
||
// },
|
||
// order: 1,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/combos/built-in',
|
||
// title: {
|
||
// zh: '内置 Combo',
|
||
// en: 'Built-in Combos',
|
||
// },
|
||
// order: 1,
|
||
// },
|
||
|
||
// {
|
||
// slug: 'manual/middle/elements/advanced-style',
|
||
// title: {
|
||
// zh: '高级样式',
|
||
// en: 'Advanced Style',
|
||
// },
|
||
// order: 5,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/elements/methods',
|
||
// title: {
|
||
// zh: '高级操作',
|
||
// en: 'Advanced operation',
|
||
// },
|
||
// order: 6,
|
||
// },
|
||
|
||
// {
|
||
// slug: 'manual/middle/layout',
|
||
// title: {
|
||
// zh: '图布局',
|
||
// en: 'Graph Layouts',
|
||
// },
|
||
// order: 3,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/states',
|
||
// title: {
|
||
// zh: '交互与事件',
|
||
// en: 'Behavior & Event',
|
||
// },
|
||
// order: 4,
|
||
// },
|
||
// {
|
||
// slug: 'manual/middle/plugins',
|
||
// title: {
|
||
// zh: '分析组件',
|
||
// en: 'Component',
|
||
// },
|
||
// order: 6,
|
||
// },
|
||
// // ==============================
|
||
// {
|
||
// slug: 'manual/advanced',
|
||
// title: {
|
||
// zh: '拓展阅读',
|
||
// en: 'Further Reading',
|
||
// },
|
||
// order: 5,
|
||
// },
|
||
// ==========API====================
|
||
{
|
||
slug: 'apis/modules',
|
||
title: {
|
||
zh: '模块',
|
||
en: 'modules',
|
||
},
|
||
order: 2,
|
||
},
|
||
{
|
||
slug: 'apis/interfaces/graph',
|
||
title: {
|
||
zh: 'Graph',
|
||
en: 'graph',
|
||
},
|
||
order: 3,
|
||
},
|
||
{
|
||
slug: 'apis/interfaces/item',
|
||
title: {
|
||
zh: '元素',
|
||
en: 'item',
|
||
},
|
||
order: 4,
|
||
},
|
||
{
|
||
slug: 'apis/interfaces/layout',
|
||
title: {
|
||
zh: '布局',
|
||
en: 'layout',
|
||
},
|
||
order: 5,
|
||
},
|
||
{
|
||
slug: 'apis/interfaces/behaviors',
|
||
title: {
|
||
zh: '交互',
|
||
en: 'behaviors',
|
||
},
|
||
order: 6,
|
||
},
|
||
|
||
{
|
||
slug: 'apis/interfaces/plugins',
|
||
title: {
|
||
zh: '插件',
|
||
en: 'plugins',
|
||
},
|
||
order: 7,
|
||
},
|
||
{
|
||
slug: 'apis/classes',
|
||
title: {
|
||
zh: '类',
|
||
en: 'classes',
|
||
},
|
||
order: 8,
|
||
},
|
||
// {
|
||
// slug: 'apis/interfaces',
|
||
// title: {
|
||
// zh: 'interfaces',
|
||
// en: 'interfaces',
|
||
// },
|
||
// order: 2,
|
||
// },
|
||
],
|
||
tutorials: [
|
||
{
|
||
slug: 'manual/about',
|
||
title: {
|
||
zh: '关于',
|
||
en: 'About',
|
||
},
|
||
order: 1,
|
||
},
|
||
],
|
||
examples: [
|
||
// {
|
||
// slug: 'case',
|
||
// icon: 'gallery',
|
||
// title: {
|
||
// zh: '场景案例',
|
||
// en: 'Case',
|
||
// },
|
||
// },
|
||
{
|
||
slug: 'feature',
|
||
icon: 'gallery',
|
||
title: {
|
||
zh: '🎉 5.0 新能力',
|
||
en: '🎉 5.0 Features',
|
||
},
|
||
},
|
||
{
|
||
slug: 'net',
|
||
icon: 'net',
|
||
title: {
|
||
zh: '图布局',
|
||
en: 'Graph Layout',
|
||
},
|
||
},
|
||
{
|
||
slug: 'item',
|
||
icon: 'shape',
|
||
title: {
|
||
zh: '元素',
|
||
en: 'Item',
|
||
},
|
||
},
|
||
{
|
||
slug: 'interaction',
|
||
icon: 'interaction',
|
||
title: {
|
||
zh: '交互',
|
||
en: 'Interaction',
|
||
},
|
||
},
|
||
{
|
||
slug: 'scatter',
|
||
icon: 'scatter',
|
||
title: {
|
||
zh: '动画',
|
||
en: 'Animation',
|
||
},
|
||
},
|
||
{
|
||
slug: 'tool',
|
||
icon: 'tool',
|
||
title: {
|
||
zh: '组件',
|
||
en: 'Component',
|
||
},
|
||
},
|
||
{
|
||
slug: 'algorithm',
|
||
icon: 'gallery',
|
||
title: {
|
||
zh: '算法',
|
||
en: 'Algorithm',
|
||
},
|
||
},
|
||
{
|
||
slug: 'performance',
|
||
icon: 'net',
|
||
title: {
|
||
zh: '性能测试',
|
||
en: 'Performance',
|
||
},
|
||
},
|
||
],
|
||
mdPlayground: {
|
||
// 第一个分块的大小
|
||
splitPaneMainSize: '62%',
|
||
},
|
||
playground: {
|
||
extraLib: getExtraLib(),
|
||
},
|
||
announcement: {
|
||
zh: '',
|
||
en: '',
|
||
},
|
||
/** 首页技术栈介绍 */
|
||
detail: {
|
||
title: {
|
||
zh: 'G6 图可视化引擎',
|
||
en: 'G6 Graph Visualization Engine',
|
||
},
|
||
description: {
|
||
zh: 'G6 是一个简单、易用、完备的图可视化引擎,它在高定制能力的基础上,提供了一系列设计优雅、便于使用的图可视化解决方案。能帮助开发者搭建属于自己的图可视化、图分析、或图编辑器应用。',
|
||
en: 'G6 is graph visualization engine with simplicity and convenience. Based on the ability of customize, it provides a set of elegant graph visualization solutions, and helps developers to build up applications for graph visualization, graph analysis, and graph editor.',
|
||
},
|
||
image: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*j5AqSpmNPdYAAAAAAAAAAABkARQnAQ',
|
||
buttons: [
|
||
{
|
||
text: {
|
||
zh: '图表示例',
|
||
en: 'Examples',
|
||
},
|
||
link: `/examples`,
|
||
},
|
||
{
|
||
text: {
|
||
zh: '开始使用',
|
||
en: 'Getting Started',
|
||
},
|
||
link: `/manual/introduction`,
|
||
type: 'primary',
|
||
},
|
||
],
|
||
},
|
||
/** 新闻公告,优先选择配置的,如果没有配置则使用远程的! */
|
||
news: [
|
||
{
|
||
type: {
|
||
zh: '推荐',
|
||
en: 'News',
|
||
},
|
||
title: {
|
||
zh: '图可视分析与搭建平台 GraphInsight 开源',
|
||
en: 'GraphInsight is opened source!',
|
||
},
|
||
date: '2022.11.22',
|
||
link: 'https://www.yuque.com/antv/blog/nyl5bkhdkicgm7v8',
|
||
},
|
||
{
|
||
type: {
|
||
zh: '推荐',
|
||
en: 'News',
|
||
},
|
||
title: {
|
||
zh: 'G6 5.0 插件机制与引擎性能蓄势待发',
|
||
en: 'G6 5.0: extension mechanism and better performance',
|
||
},
|
||
date: '2022.11.22',
|
||
link: 'https://www.yuque.com/antv/blog/fm6setn8p9m9lmh5',
|
||
},
|
||
],
|
||
/** 首页特性介绍 */
|
||
features: [
|
||
{
|
||
icon: 'https://gw.alipayobjects.com/zos/basement_prod/0e03c123-031b-48ed-9050-4ee18c903e94.svg',
|
||
title: {
|
||
zh: '专注关系,完备基建',
|
||
en: 'Dedicated & Complete',
|
||
},
|
||
description: {
|
||
zh: 'G6 是一个专注于关系数据的、完备的图可视化引擎',
|
||
en: 'G6 is a complete graph visualization engine, which focuses on relational data',
|
||
},
|
||
},
|
||
{
|
||
icon: 'https://gw.alipayobjects.com/zos/basement_prod/42d17359-8607-4227-af93-7509eabb3163.svg',
|
||
title: {
|
||
zh: '领域深钻,顶尖方案',
|
||
en: 'Top Solution',
|
||
},
|
||
description: {
|
||
zh: '扎根实际具体业务场景、结合业界领先成果,沉淀顶尖解决方案',
|
||
en: 'According to practical bussiness scenarios, we found out the top solutions',
|
||
},
|
||
},
|
||
{
|
||
icon: 'https://gw.alipayobjects.com/zos/basement_prod/acd8d1f3-d256-42b7-8340-27e5d5fde92c.svg',
|
||
title: {
|
||
zh: '简单易用,扩展灵活',
|
||
en: 'Simple & Extendable',
|
||
},
|
||
description: {
|
||
zh: 'Vivid, 精心设计的简单、灵活、高可拓展的接口,满足你的无限创意',
|
||
en: 'Well-designed simple, flexible, and extendable intefaces will satisfy your infinite originality',
|
||
},
|
||
},
|
||
],
|
||
/** 首页案例 */
|
||
cases: [
|
||
{
|
||
logo: 'https://camo.githubusercontent.com/53886f0e306c9f01c96dee2edca3992830b7cbb769118029a7e5d677deb7e67e/68747470733a2f2f67772e616c697061796f626a656374732e636f6d2f7a6f732f616e7466696e63646e2f306234487a4f63454a592f4772617068696e2e737667',
|
||
title: {
|
||
zh: 'Graphin 图可视分析组件',
|
||
en: 'Graphin: Graph Insight',
|
||
},
|
||
description: {
|
||
zh: 'Graphin 是一款基于 G6 封装的 React 分析组件库,专注在关系可视分析领域,简单高效,开箱即用。',
|
||
en: "Graphin stands for Graph Insight. It's a toolkit based on G6 and React, that focuses on relational visual analysis.It's simple, efficient, out of the box.",
|
||
},
|
||
link: `https://graphin.antv.vision`,
|
||
image: 'https://gw.alipayobjects.com/mdn/rms_00edcb/afts/img/A*LKq7Q5wPA0AAAAAAAAAAAAAAARQnAQ',
|
||
},
|
||
{
|
||
logo: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*ch6rTrCxb6YAAAAAAAAAAABkARQnAQ',
|
||
title: {
|
||
zh: '基于 G6 的动态决策树',
|
||
en: 'Interactive Decision Graph Powered by G6',
|
||
},
|
||
description: {
|
||
zh: '基于 G6 实现的动态决策树,辅助用户寻找合适的可视化方式。它展示了 G6 强大的自定义节点和动画的能力。',
|
||
en: 'It is an interactive graph for users to find out an appropriate visualization method for their requirements. The demo shows the powerful custom node and animation ability of G6.',
|
||
},
|
||
link: `/examples/case/graphDemos/#decisionBubbles`,
|
||
image: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*10b6R5fkyJ4AAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
logo: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*95GYRI0zPx8AAAAAAAAAAABkARQnAQ',
|
||
title: {
|
||
zh: '基于 G6 的图分析应用',
|
||
en: 'Graph Analysis App Powered by G6',
|
||
},
|
||
description: {
|
||
zh: '社交网络分析是图可视化中一个重要的应用场景。随着社交网络越来越流行,人与人、人与组织之间的关系变得越来越复杂,使用传统的分析手段,已经很难满足我们的分析需求。在这种情况下,图分析及图可视化显得愈发重要。',
|
||
en: 'Social network is an important scenario in graph visualization. The relationships become complicate with the development of social network. Graph visualization and analysis do well on these complex cases.',
|
||
},
|
||
link: `/manual/cases/relations`,
|
||
image: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*RYFQSZYewokAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
logo: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*IEQFS5VtXX8AAAAAAAAAAABkARQnAQ',
|
||
title: {
|
||
zh: '基于 G6 的关系时序分析应用',
|
||
en: 'Dynamic Relationships Analysis Powered by G6',
|
||
},
|
||
description: {
|
||
zh: '基于 G6 的关系时序分析应用,解决应急过程中流程、影响面、应急预案等一系列应急决策辅助信息和手段,快速止血以减少和避免故障升级。',
|
||
en: 'This is an application for dynamic relationships analysis based on G6, which helps people deal with the flow, influence, and find out solutions to avoid losses and faults.',
|
||
},
|
||
link: `/manual/cases/sequenceTime`,
|
||
image: 'https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*m41kSpg17ZkAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
],
|
||
/** 首页合作公司 */
|
||
companies: [
|
||
{
|
||
name: '阿里云',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*V_xMRIvw2iwAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '支付宝',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*lYDrRZvcvD4AAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '天猫',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*BQrxRK6oemMAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '淘宝网',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*1l8-TqUr7UcAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '网上银行',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*ZAKFQJ5Bz4MAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '京东',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*yh-HRr3hCpgAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: 'yunos',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*_js7SaNosUwAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
{
|
||
name: '菜鸟',
|
||
img: 'https://gw.alipayobjects.com/mdn/rms_2274c3/afts/img/A*TgV-RZDODJIAAAAAAAAAAABkARQnAQ',
|
||
},
|
||
],
|
||
// internalSite: {
|
||
// url: 'https://g6.antv.antgroup.com',
|
||
// name: {
|
||
// zh: '极速站点',
|
||
// en: 'Fast Site',
|
||
// },
|
||
// },
|
||
},
|
||
mfsu: false,
|
||
alias: {
|
||
'@': __dirname,
|
||
},
|
||
links: [],
|
||
scripts: [],
|
||
jsMinifier: 'terser',
|
||
});
|