الدليل المرجعي لامتدادات ميدياويكي

Chart حالة الإصدار مستقرCategory:Stable extensions/ar
تنفيذ	وسم Category:Tag extensions/ar
بيان	Renders charts
المؤلف/المؤلفون	TODO
سياسة التوافق	النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki	>= 1.44
تغييرات قاعدة البيانات	لا
ترخيص	رخصة جنو العمومية 3.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تصفح المستودع (Phabricator · GitHub) مراجعة الكود البرمجي على غيريت تاريخ الالتزام على غت تنزيل المصدر في صيغة تاربول Category:Extensions in Wikimedia version control/ar README
المتغيرات $wgChartCliPath $wgChartServiceUrl $wgChartProgressiveEnhancement
الروابط المستخدمة ParserFirstCallInit Category:ParserFirstCallInit extensions/ar
تنزيلات ربع سنوية	37 (Ranked 78th)
ترجم الامتداد Chart لو كان متوفرا على translatewiki.net
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يوفر امتداد Chart قدرات تصور البيانات التفاعلية الأساسية المصممة لاستبدال امتداد Graph ، وربما أيضاً امتداد EasyTimeline . هذا الامتداد قيد التطوير حاليًا لويكيميديا. انظر Extension:Chart/Project لمزيد من التفاصيل حول عملية التطوير.

This extension supports the following chart types:

• Line chart
• Area chart
• Bar chart
• Pie chart

All the charts in this example can be rendered from the same data source: Data:Chart_Example_Data.tab, a fictional dataset. Sample contents for these pages can be found in the sample directory.

To render a chart, you must define a chart definition to associate with the data source you want to render. A chart definition is a relatively simple JSON file. In the chart definition, specify the following:

• license – the license the chart is available under
• version – the chart schema version being used (currently the only version is 1)
• type – the type of chart being rendered; currently supported are: line, area, bar, pie
• source – where to obtain the data for the chart (currently, only Tabular Data sets can be used as source data)
• xAxis -> title – what to label the x-axis with
• xAxis -> format – none or auto (default, auto has compact notation like 2K for 2000 and thousands separators)
• yAxis -> title – what to label the y-axis with
• yAxis -> format – see above
• mediawikiCategories – list of MediaWiki categories to track this chart

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "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"
        }
    ]
}

Once a chart is defined, you can render it easily using the #chart parser function. In this case, the chart data is defined in Data:Chart_Example_Data.tab, and the chart itself is defined in Data:Example.Line.chart:

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

Customization of charts is currently limited. The hope is that, after testing, discussion and evaluation, solutions for customization can be found that do not compromise accessibility, device-specific rendering, or security.

Currently, charts are restricted to a single default color palette. This palette has been carefully designed with accessibility in mind. The thinking behind these color choices can be explored in T369863.

Some charts do require specific color themes, for example, to represent data relating to political parties. It remains an open question of how best to support this type of customization without compromising the ability of readers with accessibility needs (e.g., color blindness) to use them.

The chart format supports defining text like title and labels in different languages, so that the same chart can be used in wikis of different languages. See this example of a chart with support for multiple languages being displayed in a Spanish-language wiki.

Charts that can be used in articles live on Wikimedia Commons and can be tracked using MediaWiki categories.

This query can be used as a proxy to find charts that others have made and contribute translations.

The set of wiki pages that use charts on any particular wiki can be found in the category whose name is defined at MediaWiki:chart-render-category وMediaWiki:Chart-error-category (Category:Pages using the Chart extension وCategory:Pages using the Chart extension with rendering errors on this wiki). Please make sure to connect your wiki categories to d:Q131382738 and d:Q131406605 to make the interwiki search easier.

So far, the technical decisions are documented in the code repository in the doc/adr folder.

هذا الامتداد يستخدم على واحد من مشاريع ويكيميديا أو أكثر من واحد. يعني هذا الأمر أن الامتداد مستقر ويعمل/تعمل جيدا بما فيه الكفاية ليستخدم/لتستخدم في مواقع تتمتع بمستوى زيارات مرتفع مثل هذه. ابحث عن اسم هذا الامتداد في ملفات الضبط CommonSettings.php وكذلك InitialiseSettings.php كي ترى أين تنصب. توجد قائمة كاملة بالامتدادات المنصبة على موقع ويكي بعينه على صفحة Special:Version الخاصة بموقع الويكي.