Visual Paradigm 很高兴宣布对Visual Paradigm OpenDocs：用户现在可以通过与Visual Paradigm VPasCode.
这一新功能将文档编写与图表绘制整合到一个 streamlined 工作流中。用户不再需要在单独的应用程序中创建图表、将其导出为图像，然后手动将其插入文档；现在，他们可以使用“图表即代码”创建图表，将其插入 OpenDocs，并在需要更改时随时重新打开进行编辑。
其结果是为软件团队、技术文档撰写人员、架构师、业务分析师、产品经理以及任何需要以可视化方式解释复杂概念的人士提供了一个更灵活的知识管理工具。
打开 Visual Paradigm OpenDocs并立即开始使用可编辑图表创建文档。
Visual Paradigm OpenDocs 有哪些新功能？
OpenDocs 现在允许用户通过 VPasCode 集成将图表插入页面。图表将添加在文本光标所在位置，插入后仍可再次编辑。
这意味着图表不再局限于在写作完成后添加的静态图像。它们可以成为文档中活跃且可编辑的部分，支持解释、协作、规划、分析和知识共享。
无论您是在编写软件需求规格说明书、创建内部项目维基、记录系统架构、发布流程指南，还是构建产品知识库，现在都可以在同一文档中结合文字内容与可视化模型。
为何此项增强至关重要
当文档将清晰的解释与图表相结合时，其效用往往更高。文字描述提供背景和细节，而图表则帮助读者一目了然地理解关系、序列、依赖关系、结构和流程。
然而，在文档中创建和维护图表可能并不方便。常见的工作流程是使用一个工具创建图表，将结果导出为 PNG 或 SVG 文件，将图像上传到文档，并在图表每次更改时重复此过程。这会产生不必要的工作，并可能导致视觉内容过时、文件重复，或混淆哪个版本是最新的。
OpenDocs 与 VPasCode 的集成通过将图表创建更贴近文档工作流程，减少了这种摩擦。用户可以在需要的地方创建图表，将其插入页面，并在稍后返回图表编辑器进行修订。
将可视化解释保持在相关内容附近
当图表出现在其所支持的解释旁边时，效果最佳。借助新的 OpenDocs 功能，用户可以在流程描述下方放置流程图，在 API 解释旁边添加序列图，或在技术规范中包含系统架构图。
这使得文档更易阅读，并帮助用户在不切换多个应用程序的情况下理解文字信息与视觉信息之间的关系。
减少手动导出和上传工作
VPasCode 基于文本图表语言创建图表，并在浏览器中以可视化方式呈现。借助 OpenDocs 集成，用户可以直接将结果插入页面，而无需手动下载图像并上传到文档。
减少这些重复步骤可以帮助团队节省时间，并保持更清晰的文档流程，特别是在开发或项目规划期间图表频繁更新时。
使插入后的图表可编辑
需求会变化，系统会演进，业务流程会修订。今天准确描述项目的图表，明天可能就需要更新。
由于通过 VPasCode 插入的图表保持可编辑状态，用户可以从 OpenDocs 重新打开图表编辑器，修改图表代码，保存更改，并刷新文档中的图表。这使得随着想法和项目的发展，更容易完善视觉内容。
支持多种图表风格
不同的项目需要不同类型的可视化沟通。软件架构师可能需要 C4 模型或部署图；业务分析师可能需要流程图或用户旅程图；项目经理可能需要甘特图或路线图；技术文档撰写人员可能需要思维导图、序列图或实体关系图。
VPasCode 支持广泛的图表格式和可视化技术，包括 PlantUML、Mermaid、Graphviz、D2、Markmap 和 ECharts。它还支持结构化数据和其他基于代码的格式，可用于创建可视化表示。
Visual Paradigm VPasCode 是什么？
Visual Paradigm VPasCode是一个在线“图表即代码”平台，允许用户通过编写基于文本的描述来创建图表。它将代码编辑器与实时可视化预览相结合，让用户在编写或修改代码时即可看到图表效果。
用户无需手动绘制每个形状和连接线，而是使用支持的语法来描述图表的结构。VPasCode 随后将结果渲染为可视化图表。
这种方法对开发人员、软件架构师、技术团队以及其他希望以快速且可重复方式创建图表的用户特别有用。它也适用于偏好以文本形式审查和细化图表的团队。
VPasCode 包含不同图表类型和格式的示例，帮助新用户更快上手。用户还可以使用 AI 生成图表代码，基于自然语言描述生成图表代码。
支持的图表与可视化格式
通过 VPasCode，OpenDocs 用户可以创建并插入多种不同类型的图表和可视化内容。支持的格式包括：
- PlantUML:类图、序列图、用例图、活动图、组件图、部署图、状态图、ER 图、ArchiMate 图、C4 模型、思维导图、甘特图等。
- Mermaid:流程图、类图、序列图、实体关系图、状态图、思维导图、C4 图、甘特图、时间线、用户旅程图、Git 图、看板图等。
- Graphviz:图、网络图、层次图、组织架构图以及关系可视化。
- D2:用于架构、系统、工作流和关系的现代声明式图表。
- Markmap：基于 Markdown 风格内容生成的交互式思维导图。
- ECharts:数据驱动的图表和可视化。
- 数据与模式格式:JSON、YAML、XML、CSV、TOML、DBML 和 SQL。
这一系列支持的技术使 OpenDocs 成为更强大的文档平台，适用于需要同时创建传统业务图表和技术图表的团队。
AI 辅助图表创建
用户无需在开始之前记住所有图表语法。VPasCode 包含 AI 辅助图表生成功能，可将自然语言请求转换为图表代码。
例如，用户可以提出以下请求：
创建一个序列图，展示客户通过 Web 应用程序、认证服务和数据库登录的过程。
VPasCode 可利用该请求生成图表代码，用户可对其进行审查、调整并插入到 OpenDocs 中。随后，用户可以手动优化代码，或要求 AI 根据新需求修改图表。
在以下情况下，AI 辅助功能非常有用：
- 您清楚想要表达的内容，但不知道所需的语法。
- 您希望快速创建初始图表。
- 您需要添加或删除步骤、组件、关系或分支。
- 您希望简化复杂的图表。
- 您需要帮助修正图表代码中的错误。
- 您希望为国际团队翻译图表标签。
AI 生成的图表仍可编辑，这意味着用户可将生成结果作为起点，并根据项目需求进行调整。
如何将可编辑图表插入到 OpenDocs 页面
请按照以下步骤创建并将图表插入到文档页面：
- 打开Visual Paradigm OpenDocs.
- 创建新页面或打开现有页面。
- 点击编辑位于页面右上角。
- 将文本光标放置在您希望图表出现的位置。
- 点击+按钮以打开创建工件窗口。
- 选择VPasCode从左侧菜单中。
- 点击VPasCode以打开右侧的图表编辑器。
- 在左侧编辑器中编写或粘贴图表代码。
- 查看实时预览并进行任何必要的更改。
- 点击保存在 VPasCode 编辑器的右上角。
- 点击关闭以返回 OpenDocs 页面。
- 图表将插入到文本光标所在的位置。
图表插入后，用户可以像处理其他文档内容一样，在其周围继续编写。
如何重新编辑图表
插入到 OpenDocs 中的图表可在需要更新时随时编辑。
- 打开包含该图表的 OpenDocs 页面。
- 点击图表右上角的铅笔图标。
- 在 VPasCode 编辑器中进行更改。
- 使用实时预览查看结果。
- 点击保存.
- 点击关闭以返回 OpenDocs。
更新后的图表将在文档中刷新，使用户能够保留其视觉内容，而无需删除原始图表或从头开始。
实际应用场景
软件架构文档
软件架构师可以使用 PlantUML、Mermaid、D2 或 C4 语法来描述系统组件、服务、数据存储和外部依赖。生成的架构图可以直接放入系统设计文档或架构决策记录中。
随着架构的变化，图表可以在 VPasCode 中编辑，并在 OpenDocs 中更新。这有助于技术文档与正在讨论的设计保持一致。
API 与集成文档
序列图有助于展示客户端、服务、数据库和第三方系统之间的交互方式。团队可以在 API 描述、认证详情、请求流程和错误处理规则旁边附上序列图。
例如，技术撰稿人可以在同一个 OpenDocs 页面中，通过文字说明、API 示例以及 Mermaid 或 PlantUML 序列图来记录在线支付流程。
数据库与数据模型文档
数据库团队可以使用实体关系图来解释表、字段、键和关系。可视化数据模型可以让开发人员、分析师、测试人员及其他利益相关者更容易理解数据库文档。
当添加新表或新关系时，可以通过相同的 VPasCode 工作流编辑并重新插入该图表。
业务流程与工作流指南
业务分析师和运营团队可以使用流程图、活动图、用户旅程图和工作流程图来解释工作如何在组织内流转。
将这些可视化内容嵌入操作指南或标准作业程序中，可以帮助读者理解职责、决策点、替代路径和审批步骤。
产品需求与功能规划
产品经理可以在产品需求文档中包含用户旅程、流程流、状态图、思维导图和功能关系图。这些可视化资产有助于产品、设计、工程和质量保证团队建立对功能的共同理解。
项目维基与知识库
知识管理工具在汇聚人们理解与执行工作所需信息时最具价值。向 OpenDocs 知识库添加可编辑图表，可以使项目维基、入职材料、内部指南和系统手册更加完整。
团队无需将图表保存在单独的文件夹或互不关联的设计工具中，而是可以将它们与相关的说明、决策、程序和参考资料放在一起。
思维导图与概念组织
Markmap 和其他思维导图格式可以帮助团队组织需求、研究主题、项目结构、会议成果和知识层级。这些地图可以插入到 OpenDocs 页面中，在展示更详细信息之前提供视觉概览。
对不同用户类型的益处
- 开发人员：使用熟悉的基于文本的格式创建图表，并将技术说明与系统可视化内容保持邻近。
- 软件架构师：构建架构、UML、C4、部署和组件图，这些图表可随系统演进进行修订。
- 技术撰稿人：在一个文档工作区中整合流程、规范、示例和可编辑图表。
- 业务分析师：使用清晰的可视化模型解释业务流程、需求、决策和用户旅程。
- 产品经理：在产品文档中添加工作流、路线图、功能关系和用户流程。
- 项目团队：创建既能传达细节又能呈现全局的共享文档。
- 教育工作者和培训师：使用图表使技术或流程内容更易于理解。
从静态文档到动态文档
有效的文档应反映项目、产品、流程或系统的当前状态。当视觉内容仅以静态图像形式存储时，更新工作容易被推迟。久而久之，该图像可能不再反映实际情况。
OpenDocs 与 VPasCode 的集成支持一种更具可维护性的方法。图表可通过可读代码创建，通过视觉预览进行审核，插入相关文档，并在底层信息变更时再次编辑。
这为动态文档奠定了实用基础。图表始终作为有用的工作资产，而非一次性截图。
更紧密连接的 Visual Paradigm 生态系统
Visual Paradigm 连接不同的产品与功能，帮助用户更高效地从构思过渡到模型、图表、文档和共享知识。
VPasCode 提供“图表即代码”的体验，OpenDocs 提供文档与知识管理体验。两者协同工作，帮助团队创建视觉内容，并将其直接置于所需的应用场景中。
这种连接可以减少工具切换，简化文档工作流程，并帮助团队在整个项目生命周期中更有效地利用图表。
开始使用 OpenDocs 和 VPasCode
通过此项增强，Visual Paradigm OpenDocs 成为创建结构化、可视化及协作式文档的更灵活环境。用户可使用 PlantUML、Mermaid、Graphviz、D2、Markmap、ECharts 及其他支持格式创建图表，将其插入页面，并在需求变更时再次编辑。
如果您正在寻找在线图表生成器、图表即代码平台、技术文档工具或具备集成可视化建模能力的知识管理工具，这一新工作流提供了一种便捷方式，将图表与文档整合在一起。
启动 Visual Paradigm OpenDocs并开始利用 VPasCode 驱动的可编辑图表，创建更丰富、更有用的文档。
常见问题
新的 OpenDocs 增强功能是什么？
OpenDocs 现在允许用户通过其与 Visual Paradigm VPasCode 的集成，创建可编辑图表并将其插入文档页面。
我可以在将图表插入 OpenDocs 后进行编辑吗？
可以。点击插入图表上的铅笔图标，在 VPasCode 编辑器中重新打开它。修改图表代码后，点击“保存并关闭”，即可在 OpenDocs 页面中刷新图表。
支持哪些图表格式？
VPasCode 支持包括 PlantUML、Mermaid、Graphviz、D2、Markmap、ECharts、JSON、YAML、XML、CSV、TOML、DBML 和 SQL 在内的多种格式与技术。支持的图表类型包括流程图、序列图、类图、状态图、ER 图、C4 图、思维导图、架构图、甘特图等。
使用该功能是否需要了解图表代码？
不需要。您可以从 VPasCode 编辑器或示例库中加载示例。您还可以使用“使用 AI 创建”功能，用自然语言描述您想要的图表，让 AI 生成初始图表脚本。
我可以在哪里访问 OpenDocs？
您可以通过以下地址访问 Visual Paradigm OpenDocs：https://ai-toolbox.visual-paradigm.com/app/opendocs/.
我可以在哪里了解更多关于 VPasCode 的信息？
请访问：VPasCode 功能页面以了解更多关于图表即代码平台、支持的格式、实时渲染、AI 辅助及相关功能。