Chart Category:Stable extensions/zh
	Category:Tag extensions/zh
描述	Renders charts
作者	TODO
MediaWiki	>= 1.45
	否
	GNU通用公眾授權條款3.0或更新版本
下載	下載 Git [?]: 浏览存储库 (Phabricator · GitHub) Gerrit代码 Git提交日誌 下載原始碼(tarball壓縮) Category:Extensions in Wikimedia version control/zh README
$wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
LinksUpdateComplete Category:LinksUpdateComplete extensions/zh PageSaveComplete Category:PageSaveComplete extensions/zh ParserFirstCallInit Category:ParserFirstCallInit extensions/zh
前往translatewiki.net翻譯Chart
問題	开启的任务 ·

Chart擴展功能提供基本的互動式資料視覺化功能，以取代Graph 擴展功能的部分（但非全部）功能。 此擴展功能目前正在為維基媒體的進行開發。 有關開發過程的更多詳細資訊，請參閱擴展功能：Extension:Chart/專案 。

此擴展功能支援以下圖表類型：

• 折線圖
• 面積圖
• 柱狀圖
• 圓餅圖

安裝

圖表擴展功能需要安裝 JsonConfig 擴展功能，以及下載 Chart Renderer JavaScript（實際上是 TypeScript）函式庫。

請參閱倉庫中的 README.md 檔案以獲取完整的設定說明。

對於維基媒體生產環境的使用，請參閱 wikitech:Kubernetes/Deployments 以獲取服務部署的一般說明。

如何使用

要呈現圖表，您必須定義一個圖表定義以與您想要呈現的資料來源關聯。 圖表定義結構為相對簡單的 JSON 檔案；語法詳細資訊請參閱擴展功能：Extension:Chart/Specification 。

此範例中的所有圖表都可以從同一個資料來源呈現： Data:Chart Example Data.tab，一個虛構的資料集。 這些頁面的範例內容可以在 sample 目錄中找到。

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "subtitle": {
        "en": "Example Subtitle"
    },"xAxis": {
        "title": {
        	"en": "Example X Axis Title"
        },
        "format": "none"
    },
    "yAxis": {
        "title": {
            "en": "Example Y Axis Title"
        },
        "format": "none"
    },
    "mediawikiCategories": [
        {
            "name": "Example category",
            "sort": "Its sortkey"
        }
    ],
    "transform": {
        "module": "Optional lua module for data transforms",
        "function": "transform_func",
        "args": {
            "arg_name": "arg_value"
        }
    }
}

一旦定義了圖表，您就可以使用 #chart 解析器函式輕鬆呈現它。 在這種情況下，圖表資料在 Data:Chart Example Data.tab 中定義，圖表本身在 Data:Example.Line.chart 中定義：

{{#chart:Example.Line.chart}}

請注意，圖表可以是通用的，並可以與不同的資料來源重複使用，如下所示：

{{#chart:Population through years.chart
|data=Population of USA.tab
}}

{{#chart:Population through years.chart
|data=Population of UK.tab
}}

{{#chart:Population through years.chart
|data=Population of Poland.tab
}}

目前圖表的功能有限。 希望在測試、討論和評估之後，能夠找到既不損害可訪問性、設備特定呈現或安全性的自訂解決方案。

圖表類型

對於所有圖表，資料預期以列的形式排列，第一代表x-axis，後續代表y-axis上的系列或曲线。

{{image frame
|content={{#chart:Example.Line.chart}} [[commons:Data:Chart Example Data.tab|'''Raw data''']]
|width = 340
|caption = This is an example of a line chart.
}}

{{#chart:Example.Bar.chart}} <center>[[commons:Data:Chart Example Data.tab|'''Raw data''']]</center>

尋找現有圖表

可以在文章中使用的圖表存放在維基共享資源上，可以使用 MediaWiki 分類進行追蹤。

此查詢可以用作代理來尋找其他人製作的圖表並貢獻翻譯。

在任何特定上使用圖表的頁面集合可以在MediaWiki:chart-render-category 和 MediaWiki:Chart-error-category定義的分類中找到（在此上為Category:Pages using the Chart extension 和 Category:Pages using the Chart extension with rendering errors ）。 請確保將您的 wiki 分類連接到d:Q131382738和d:Q131406605，以便於跨搜尋。

技術文檔

考慮到: 的問題，關於新擴展功能的所有決定都經過仔細考慮，希望建立對其替代品的信任和信心。

到目前為止，技術決定記錄於程式碼倉庫的 /doc/adr 資料夾中。

Failing .chart pages are automatically stored in commons:Category:Pages using the Chart extension with rendering errors. Wiki pages with faulty .charts are automatically stored in using the Chart extension with rendering errors in different language versions.

Errors with client side chart rendering will be logged to logstash. (Only for developers.)

• The script graphDataImport can be used in the web browser to extract data from existing graph wikitext and similar, and convert it to a .tab page, a .chart definition page and new wikitext.
• Generative AI can be prompted to extract data from existing graph wikicode and tables, and convert it to .tab and .chart pages and generate new wikicode, according to given specifications. It can also provide translation of titles, and be utilized to extend and update the .tab page with new data.
• The gadget TabularImportExport can convert Excel and .csv files to and from the .tab pages. You can activate it via your Commons preferences.
• The JSON "edit as table" user interface (part of the Jsonconfig extension) is available from the .tab edit page.
• Some bots can periodically import statistics from the web, or from existing Wikipedia graphs, to .tab or .chart pages, upon request. Such bots include DPLA bot and SLiuBot.
• GraphBot ports English Wikipedia graphs to charts.

• Extension:Chart/Project/FAQ - Frequently asked questions
• Transforms

此用于一个或多个维基媒体项目。 这可能意味着足够稳定、运作足够良好，可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php中查找此的名称以查看哪些网站安装了该。 特定wiki上的已安装的的完整列表位于Special:Version页面。