Extension:Graph

From mediawiki.org
This page is a translated version of the page Extension:Graph and the translation is 96% complete.
MediaWiki manüel uzantıları
OOjs UI icon advanced-invert.svg
Graph
Sürüm durumu: kararlı
Uygulama Etiket , ContentHandler
Açıklama Veriye dayalı grafikler
Yazar(lar)
  • Yuri Astrakhan (Yurik mesaj),
  • Dan Andreescu,
  • Frédéric Bolduc
MediaWiki >= 1.39.0
Lisans MIT Lisansı
İndir
  • $wgGraphDefaultVegaVer
  • $wgGraphAllowedDomains
Translatewiki.net adresinde mevcutsa, Graph uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

Graph uzantısı, ‎<graph> bir etiketin çubuk grafikler, pasta grafikler, zaman çizelgeleri ve histogramlar (demo) gibi veri görselleştirmelerini Vega tabanlı grafik.

Genel bilgi

Graph uzantısı, güçlü Vega tabanlı grafiklerin viki sayfalarına eklenmesini sağlar. Grafikler etkileşimli olabilir.

Grafik eklemenin en kolay yolu, {{Graph:Chart}} gibi hazır bir şablon kullanmaktır. Bu şablonlar tüm Vega karmaşıklıklarını gizler. Deneyimli kullanıcılar, grafikler geliştirmek için Graph Deneme Tahtası kullanabilir. Graph deneme tahtası, JSON'a ek olarak viki şablonu sözdizimine izin verir. The extension integrates with VisualEditor, providing a simple tool/wizard which generates basic graphs, by entering values directly to the editor.

Yararlı bağlantılar

Kurulum

  • JsonConfig uzantısı gereklidir
  • Dosyaları indirin ve extensions/ klasörünüzdeki Graph adlı dizine yerleştirin.
  • "LocalSettings.php " dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Graph' );
    
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.


Vagrant installation:

  • Vagrant kullanıyorsanız, vagrant roles enable graph --provision ile yükleyin

Ek yapılandırma ayarları

en.wiki gibi bir üretim ortamını çoğaltmak istiyorsanız, aşağıdaki adımları tamamlamanız gerekir:

Roller (yalnızca Vagrant kullanmaya karar verdiyseniz)

  • graphs rolünü etkinleştir
  • Scribunto rolünü etkinleştir
  • imagemap rolünü etkinleştir

Şablonlar ve Lua Modülleri

Grafik örnekleri

Birçok örnek ve kullanım püf noktası için Demo sayfasına bakın.

Kullanıcı tanımlı geri döndürme

İstemci tarafında oluşturmayı kullanırken, noscript kullanıcılara statik bir geri dönüş resimi sağlamak için Wikimedia Commons kullanmak mümkündür. Bu, sunucu tarafında işleme sağlamak için yeni bir hizmet devreye girene kadar geçici bir çözümdür.

Kullanıcı önce statik grafiği Wikimedia Commons'a yüklemelidir.

Yedek resimlerin iki değişkeni fallback ve fallbackWidth.

fallback, bir Wikimedia Commons dosya adı ile ilgilidir.

fallbackWidth, piksel cinsinden yedek resim genişliğidir.

Bu değişkenler aşağıdaki şekilde grafikten geçirilir:

<graph fallback="Graph test seddon.png" fallbackWidth=450>

Module:Graph gibi Lua modülleri kullanıldığında, bu değişkenler etiket işlevi aracılığıyla sağlanabilir. Template:Graph:Chart uyarlanmış olsaydı, şöyle görünürdü:

{{safesubst:#tag:graph|{{safesubst:#invoke:Graph|chartWrapper}} | fallback = {{{fallback|''}}} |  fallbackWidth= {{{fallbackWidth|''}}} }}

Daha sonra aşağıdaki şekilde bir şablonda kullanılacaktır:

{{Graph:Chart|width=400|height=100|xAxisTitle=X|yAxisTitle=Y
 |type=rect|x=1,2,3,4,5,6,7,8|y=10,12,6,14,2,10,7,9|fallback=Graph test seddon.png|fallbackWidth=450}}

fallbackWidth sağlanmadıysa ancak bir resim tanımlandıysa, uzantı genişliği sağlanan grafik genişliğinden türetecektir. Bunun nedeni, oluşturulan resim genişliğinde ve gerçek resim genişliğinde sıklıkla bir fark olmasıdır.

{{Graph:Chart|width=400|height=100|xAxisTitle=X|yAxisTitle=Y
 |type=rect|x=1,2,3,4,5,6,7,8|y=10,12,6,14,2,10,7,9|fallback=Graph test seddon.png}}

Dış veriler

HTTP(S) protokolü, grafik için veri almak için kullanılamaz. Bunun yerine, wikiraw:, wikiapi: ve diğerleri gibi özel viki protokollerinden birini kullanın.

Graph uzantısı, bu protokollerin nasıl çözüldüğünü kontrol etmek için GraphAllowedDomains ayarını kullanır: Note that because queries rely on the structure of wikibase items, they may suddenly stop working if the underlying data is edited and changes, as it may yield incomplete, empty or invalid data that can't be used to create a graph. In these cases the graph will end up empty (see phab:T168601).

$wgGraphAllowedDomains = [
    # http + https anahtarları, harici veri erişimine izin verilen tüm alanları listeler.
    # Burada listelenen herhangi bir alan adı, tüm alt alan adlarına da otomatik olarak izin verir.
    # 'wikiraw' gibi özel protokoller, hangi protokolün kullanılacağını belirlemek için onu kullanır.
    # Bu şekilde wikiraw://en.wikipedia.org/Page, https://en.wikipedia.org/w/api.php?action=query&titles=Page&... için bir api isteği olur
    'https' => [ 'wikipedia.org', 'wikimedia.org', ... ],
    'http' => [ 'wmflabs.org', ... ],
    
    # wikirawupload için izin verilen etki alanlarının listesi: protokol erişimi.
    # Yalnızca tam eşleme, alt alan adı yok.
    'wikirawupload' => [ 'upload.wikimedia.org' ],
    
    # wikirawupload ile aynı ancak Vikiveri Sparql sorguları için
    'wikidatasparql' => [ 'query.wikidata.org' ],
];

Bilinen hatalar ve sınırlamalar

  • phab:tag/graph - Graph uzantı hataları
  • ISO 8601 zaman ölçekleri uygulanamadığından zaman çizelgelerinde yalnızca Miladi takvimler kullanılabilir


Dahili

Ayrıştırırken, Graph uzantısı tüm şablon parametrelerini/ifadelerini genişletir ve kimlikler için grafik karmaları kullanarak tüm grafik tanımlarını ParserOutput içinde saklar.

Graph uzantısı, grafiklerin gitmesi gereken sayfaya HTML ekler, öznitelik olarak graph-id ile bir ‎<div>. Örnek:

<div class="mw-graph" data-graph-id="72edc224f0a10b343c1e84f63dbfc97cac9bc957">
</div>

Graph uzantısı, Vega kitaplığını içeren sayfaya bir ext.graph ResourceLoader JavaScript modülü ekler ve grafik tanımlarının JSON'unu bir JavaScript mediawiki.config adlı değişkene wgGraphSpecs koyar. İstemci bu modülü yükledikten sonra, Vega JavaScript kitaplığı her ‎<div> bir HTML tuvali ile doldurur ve statik resminin yerini alarak grafiği içine çizer.

Güvenlik Özellikleri

‎<graph>, güvenilmeyen veri kaynaklarına başvurmaya izin vermeyecek şekilde yapılandırılabilir (örneğin, Wikimedia yalnızca Wikimedia sitelerinden gelen verilere izin verir).

Lisans

Vega kitaplığı, kullanmamız için kabul edilebilir [$url BSD lisansla değiştirilmiş] altında dağıtılmaktadır.

Bu, bazı küçük (kabul edilebilir) değişikliklerle birlikte BSD lisansının bir kopyası gibi görünüyor. İdeal olarak lisansta böyle değişiklikler yapmasalar da, onu kullanmak bizim için bir sorun değil. İnsanların lisanslarında bu değişiklikleri yapmaması, lisansın açık kaynak kullanımı için güvenli olup olmadığı konusunda kafa karışıklığını (bunun gibi) önlemek için daha iyidir.

—Stephen LaPorte

Yapılandırma

wgGraphAllowedDomains

See the section on external data.

Diğer değişkenler

  • (2015-12-07) - 787d64a11 içinde wgGraphUrlBlacklist kaldırıldı.
  • (2016-01-28) - e0813f85a içinde wgGraphDataDomains kaldırıldı. Use wgGraphAllowedDomains instead.
  • (2015-09-30) - b735f63ff4b içinde wgGraphUserServiceAlways kaldırıldı.
  • (2019-07-17) - wgGraphIsTrusted has been removed in cf80f43e15.
  • (2020-06) - $wgGraphImgServiceUrl was deprecated.

Graph ad alanını etkinleştirme

Grafik tanımlarını bağımsız sayfalar olarak kendi ad alanlarında saklamak için JsonConfig yapılandırın.

// See https://www.mediawiki.org/wiki/Extension:JsonConfig
$wgJsonConfigModels['graph.jsonconfig'] = 'graph\Content';
$wgJsonConfigs['graph.jsonconfig'] = array(
	'namespace' => <PICK-A-NS-NUMBER>,
	'nsName' => 'Graph',
	'isLocal' => true,
);

Görsel Düzenleyici modülü

Graph uzantısı, 2015 yazından bu yana, Görsel Düzenleyici içinde grafik düzenlemeyi sağlayan bir modül (ext.graph.VisualEditor) ile birlikte gelir.

Bu modül, bir Google Summer of Code 2015 projesinin sonucudur. Ayrıntılar için phab:T89287 sayfasına bakın.

Ve-graph-showcase.png

Bu modül, kullanıcıların yabancı uzantı düğümlerinin aksine, Görsel Düzenleyici içindeki grafikleri görmelerine olanak tanır. Ayrıca, kullanıcılar bir grafiğin türünü, verilerini ve dolgusunu düzenlemek için bir iletişim kutusu açabilir. Kullanıcı arabirimi ayrıca, daha ileri düzey kullanıcıların kullanıcı arabirimi tarafından desteklenmeyen ayarları değiştirmek istemesi durumunda klasik vikimetin düzenleyiciye geçmek zorunda kalmadan VE içinde bir grafiğin ham JSON belirtimini düzenlemenin bir yolunu sunar.

Bu ilk adım, Görsel Düzenleyici içinde grafik düzenleme ile birçok olasılık için bir atlama taşı görevi görür ve modülün geliştirilip genişletilebileceği birçok yol vardır.

Bozuk grafiklerde sorun giderme

Grafiklerle ilgili hatalar, geliştirici konsoluna kaydedilir.

Hata: Hatalı yapıcı bağımsız değişkenleri (phab:T277906)

Düzeltmek için: filepath:Earthmap1000x500compac.jpg olarak filepath:Earthmap1000x500.jpg ile değiştirin

Örnek.

TypeError: undefined is not an object (evaluating 'datum.firstYear.value')

To fix: Make sure you have not set default as null

Example.

Ayrıca bakınız

  • Extension:GraphViz — kenarlarla birbirine bağlanmış köşe kümelerinin grafikler görüntülemek için (yani, bu uzantı gibi grafikler değil)
  • Plotly — Açık kaynak JavaScript grafik kitaplığı (3 boyutlu grafik yetenekleri ile)
  • D3 — Veriye Dayalı Belgeler