在本文中，我將逐步指導(dǎo)您使用圖表即代碼工具創(chuàng)建動態(tài)和交互式可視化文檔。我們將以編程方式生成圖表，而不是靜態(tài)圖像，確保它們始終是最新的且易于維護(hù)。

---

？圖表作為代碼

圖表即代碼是一種允許您通過代碼而不是傳統(tǒng)圖形工具創(chuàng)建圖表的方法。您可以在文本文件中編寫代碼來定義圖表的結(jié)構(gòu)、組件和連接，而不是手動構(gòu)建圖表。

然后，該代碼被轉(zhuǎn)換為圖形圖像，從而更容易在軟件項(xiàng)目中集成和記錄，這對于以編程方式創(chuàng)建和更新架構(gòu)和流程圖特別有用。

---

什么是圖表？

Diagrams 是一個 ?Python 庫，它實(shí)現(xiàn)了圖表即代碼方法，使您能夠通過代碼創(chuàng)建架構(gòu)基礎(chǔ)設(shè)施圖和其他類型的圖表。借助圖表，您只需幾行代碼即可輕松定義云基礎(chǔ)設(shè)施組件（例如 AWS、Azure 和 GCP）、網(wǎng)絡(luò)元素、軟件服務(wù)等。

？圖即代碼的好處

• ？ 將圖表表示為代碼：直接從代碼創(chuàng)建和更新圖表，確保敏捷項(xiàng)目的可維護(hù)性。
• ？ 自動化文檔：從代碼生成視覺效果，使圖表與當(dāng)前架構(gòu)保持一致。
• ？ 更改控制：跟蹤圖表隨時間的修改。
• ？ 增強(qiáng)清晰度：通過清晰、共享的視覺效果提高對復(fù)雜系統(tǒng)的理解。
• ?? 可定制：用靈活且定制的視覺效果表示云基礎(chǔ)設(shè)施、工作流程或數(shù)據(jù)管道。

---

教程

？庫安裝

我目前在本教程中使用版本“0.23.4”。

!pip install diagrams=='0.23.4'

---

？圖表：節(jié)點(diǎn)

該庫允許您以編程方式創(chuàng)建架構(gòu)圖，使用節(jié)點(diǎn)來表示不同的基礎(chǔ)設(shè)施組件和服務(wù)。

---

節(jié)點(diǎn)類型

圖中的節(jié)點(diǎn)代表來自不同云服務(wù)提供商的組件以及其他架構(gòu)元素。以下是可用節(jié)點(diǎn)的主要類別：

• ?? 云提供商：AWS (Amazon Web Services)、Azure、GCP、IBM Cloud、阿里云、Oracle Cloud、DigitalOcean 等。
• ？ 本地：代表物理上位于公司場所的基礎(chǔ)設(shè)施。
• ？ Kubernetes (K8S)：容器編排系統(tǒng)，用于自動化容器化應(yīng)用程序的部署、擴(kuò)展和管理（用船輪表示，象征控制和導(dǎo)航）。
• ?? OpenStack：用于創(chuàng)建和管理公共云和私有云的開源軟件平臺。
• ？ 通用：通用節(jié)點(diǎn)，可以表示特定于提供者的節(jié)點(diǎn)未專門覆蓋的任何組件（交叉工具，表示一個類別中的不同工具）。
• ?? SaaS（軟件即服務(wù)）：表示通過互聯(lián)網(wǎng)作為服務(wù)交付的應(yīng)用程序，例如 Snowflake、聊天服務(wù)（Slack、Teams、Telegram 等）、安全性（例如 Okta） ），或社交網(wǎng)絡(luò)（為了 SaaS 概念劃掉了電話和云）。
• ？ 自定義：允許用戶使用存儲在特定文件夾中的 PNG 圖標(biāo)自定義圖表。這對于表示默認(rèn)節(jié)點(diǎn)（劃掉的自定義工具）未涵蓋的基礎(chǔ)架構(gòu)組件非常有用。

---

？編程語言

Diagrams 庫允許您使用不同的節(jié)點(diǎn)來表示各種編程語言。這些節(jié)點(diǎn)有助于在圖表中指示架構(gòu)的任何部分是否使用以特定編程語言開發(fā)的腳本或組件。

下面，我們將展示庫中所有可用的語言。如果缺少任何語言，您可以通過將相應(yīng)的徽標(biāo)上傳到特定文件夾來添加自定義節(jié)點(diǎn)。

!pip install diagrams=='0.23.4'

---

?? AWS（亞馬遜網(wǎng)絡(luò)服務(wù)）

我們可以使用 Amazon 節(jié)點(diǎn)，這些節(jié)點(diǎn)分為幾個類別，例如：

• 分析和業(yè)務(wù)：aws.analytics、aws.business
• 計算和存儲：aws.compute、aws.storage、aws.cost
• 數(shù)據(jù)庫和開發(fā)工具：aws.database、aws.devtools
• 集成和管理：aws.integration、aws.management
• 機(jī)器學(xué)習(xí)和移動：aws.ml、aws.mobile
• 網(wǎng)絡(luò)和安全：aws.network、aws.security
• 其他：aws.blockchain、aws.enduser、aws.engagement、aws.game、aws.general、aws.iot、aws.media、aws.migration、aws.quantum、aws.robotics、aws。衛(wèi)星

接下來，我們將代表這些類別之一以可視化 aws.database 中的可用節(jié)點(diǎn)。

!pip install diagrams=='0.23.4'

---

?? 使用案例

現(xiàn)在，讓我們創(chuàng)建一個簡單的藍(lán)圖，對應(yīng)于在 AWS 上導(dǎo)入數(shù)據(jù)集并訓(xùn)練機(jī)器學(xué)習(xí)模型。

# Create the diagram object
with diagrams.Diagram("Programming Languages", show=False, filename="languages"):
    # Get all the languages available in this library
    languages = [item for item in dir(diagrams.programming.language) if item[0] != '_']

    # Divide the representation in two lines
    mid_index = len(languages) // 2
    first_line = languages[:mid_index]
    second_line = languages[mid_index:]

    # Add nodes in the first row
    prev_node = None

    for language in first_line:
        current_node = eval(f"diagrams.programming.language.{language}(language)")
        if prev_node is not None:
            prev_node >> current_node
        prev_node = current_node

    # Add nodes in the second row
    prev_node = None

    for language in second_line:
        current_node = eval(f"diagrams.programming.language.{language}(language)")
        if prev_node is not None:
            prev_node >> current_node
        prev_node = current_node

Image("languages.png")

---

存儲庫

以下是全部代碼鏈接，如果覺得有用，可以給個star??并關(guān)注我，接收新文章通知。這將幫助我在技術(shù)社區(qū)中成長并創(chuàng)造更多內(nèi)容。

如果您想了解如何使用此管道實(shí)現(xiàn)文檔站點(diǎn)，您可以閱讀我在以下鏈接中發(fā)布的文章

---

？參考

1. 圖表： https://diagrams.mingrammer.com/

以上是圖表即代碼：為視覺內(nèi)容創(chuàng)建動態(tài)和交互式文檔的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！