Rozšíření:Cargo

From mediawiki.org
This page is a translated version of the page Extension:Cargo and the translation is 100% complete.
Základní informace k tomuto rozšíření MediaWiki
Cargo
Stav rozšíření: stabilní
Zavádění Speciální stránka , API , Funkce analyzátoru
Popis Rozšíření, které umožňuje ukládání dat a dotazování na data obsažená v šablonách.
Napsal(i) Yaron Koren <yaron57@gmail.com> (Yaron Korendiskuse)
Nejnovější verze 3.5 (února 2024)
Zásady kompatibility Hlavní vývojová větev zachovává zpětnou kompatibilitu.
MediaWiki 1.37+
Změny v databázi Ano
Composer mediawiki/cargo
Tabulky cargo_tables
cargo_pages
cargo_backlinks
Licence GNU General Public License 2.0 nebo pozdější
Zdrojový kód
Příklad Stránka obsahující různá volání na #cargo_query
  • $wgCargoFileDataColumns
  • $wgCargoDrilldownLargestFontSize
  • $wgCargoDecimalMark
  • $wgCargoDefaultStringBytes
  • $wgCargoAllowedSQLFunctions
  • $wgCargoHideNamespaceName
  • $wgCargoPageDataColumns
  • $wgCargoMaxVisibleHierarchyDrilldownValues
  • $wgCargoDrilldownSmallestFontSize
  • $wgCargoIgnoreBacklinks
  • $wgCargoRecurringEventMaxInstances
  • $wgCargoDefaultMapService
  • $wgCargoStoreUseTemplateArgsFallback
  • $wgCargoLegacyNullLuaFieldsAsEmptyString
  • $wgCargoTablesPrioritizeReplacements
  • $wgCargoDigitGroupingCharacter
  • $wgCargoDefaultQueryLimit
  • $wgCargoDrilldownNumRangesForNumbers
  • $wgCargo24HourTime
  • $wgCargoMaxQueryLimit
  • $wgCargoDrilldownUseTabs
  • $wgCargoMapClusteringMinimum
  • $wgCargoDrilldownMinValuesForComboBox
  • recreatecargodata
  • deletecargodata
  • runcargoqueries
Čtvrtletní stahování 82 (Ranked 76th)
Přeložte rozšíření Cargo
Problémy Otevřené úkoly · Nahlásit chybu

Cargo 'je rozšíření MediaWiki, které poskytuje snadný způsob ukládání a dotazování na data obsažená v rámci volání šablon, například infoboxů. V konceptu je podobné rozšíření Rozšíření:Semantic MediaWiki , ale nabízí řadu výhod, včetně jednoduchosti instalace a snadného použití.

Cargo ukládá všechna svá data do databázových tabulek, které lze umístit buď do vlastní databáze MediaWiki (výchozí) nebo do samostatné databáze. Z větší části získává každá šablona svá data uložená jen v jediné tabulce DB se sloupcem pro každý vhodný parametr šablony. Existuje několik výjimek: Zpracování polí šablon, která obsahují pole nebo seznamy hodnot, a polí, která obsahují zeměpisné souřadnice, je složitější kvůli špatnému nativnímu (nezměněném stavu) zpracování těchto datových typů ve většině systémů DB. A lze nastavit několik šablon, aby všechny ukládaly svá data do jediné tabulky DB.

Přípona definuje řadu funkcí syntaktického analyzátoru. Tyto tři jsou nejdůležitější:

  • #cargo_declare - umístěné v části ‎<noinclude> šablony. Definuje schéma pro tabulku.
  • #cargo_store - ukládá jeden řádek do Cargo table. Obvykle umístěné v rámci ‎<includeonly> šablony.
  • #cargo_query - dotazuje jednu nebo více datových tabulek Cargo pomocí součástí SQL.

Další definované funkce analyzátoru jsou:

  • #cargo_attach - definuje šablonu jako přidání řádků do tabulky deklarované jinde.
  • #cargo_compound_query - zobrazí výsledky více dotazů na jednom místě.
  • #cargo_display_map - zobrazí mapu s jedním bodem.
  • #recurring_event - vytiskne data pro opakující se událost. Pro použití #cargo_store.

Cargo také definuje různá rozhraní pro prohlížení a procházení těchto uložených dat. Jako takový přidává následující speciální stránky:

  • Special:CargoQuery
  • Special:CargoTableDiagram
  • Special:CargoTables
  • Special:Drilldown

Cargo bylo testováno a pracuje s databázovými systémy MySQL a PostgreSQL. Teoreticky také podporuje SQLite, ale nebyl dobře testován s SQLite a nemusí fungovat.

Tato verze rozšíření Cargo vyžaduje MediaWiki 1.35+.

Kliknutím na stránky na navigační liště výše se dozvíte více o Cargo, jak funguje, jak jej používat a jak jej nainstalovat.

Instalace

See Download and Installation .

Konfigurace

Níže jsou uvedena globální nastavení konfigurace Cargo spolu s jejich výchozími hodnotami.

Chcete-li nakonfigurovat Cargo tak, aby místo databáze MediaWiki používala samostatnou databázi, jsou k dispozici následující nastavení:

Samostatná nastavení konfigurace databáze
Nastavení Výchozí Popis
$wgCargoDBtype null Typ databáze.
$wgCargoDBserver null Název hostitele nebo IP adresa databázového serveru.
$wgCargoDBname null Název databáze.
$wgCargoDBuser null Uživatelské jméno databáze.
$wgCargoDBpassword null Heslo pro $wgCargoDBuser.
$wgCargoDBprefix null Předpona názvu databázové tabulky.
$wgCargoDBRowFormat null Formát řádku databáze.

Pro konfiguraci znaků související s čísly jsou k dispozici následující konfigurační nastavení:

Nastavení konfigurace znaků
Nastavení Výchozí Popis
$wgCargoDecimalMark . Desetinný znak pro čísla.
$wgCargoDigitGroupingCharacter , Oddělovač tisíců číslic.

Zbývající globální konfigurační nastavení jsou následující:

Nastavení Výchozí Popis
$wgCargoAllowedSQLFunctions [] Sets allowed SQL functions. See Using SQL Functions for defaults.
$wgCargoRecurringEventMaxInstances 100 The number of max instances to store for recurring events with no set end date.
$wgCargoDefaultStringBytes 300 The default number of characters for fields of type Page, String, Wikitext string, File, URL, Email
$wgCargoDefaultQueryLimit 100 Number of results to show for #cargo_query if no limit is set
$wgCargoMaxQueryLimit 5000 Maximální povolený počet výsledků pro

#cargo_query

$wgCargo24HourTime false If true uses 24-hour time for Datetime field types.
$wgCargoDefaultMapService OpenLayers Sets the default map service to Google Maps, if set to googlemaps, to Leaflet if set to leaflet, and to OpenLayers if set to openlayers.
$wgCargoGoogleMapsKey null API key for Google Maps, for the googlemaps display format.
$wgCargoMapClusteringMinimum 80 If the number of map points displayed is greater than the value of $wgCargoMapClusteringMinimum, the map displays the locations in "clusters" instead of individual points, for readability. If set to a very high number, does not display clustering.
$wgCargoDrilldownUseTabs true Displays Special:Drilldown table names as tabs at the top instead of a vertical list at the side.
$wgCargoDrilldownSmallestFontSize -1 If set to a positive number, sets the smallest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownLargestFontSize -1 If set to a positive number, sets the largest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownMinValuesForComboBox 40 Sets the minimum number of values before their display is converted to a combo box, instead of individual links.
$wgCargoDrilldownNumRangesForNumbers 5 For fields/filters of type Integer or Float, specifies the number of "buckets" into which values are divided.
$wgCargoMaxVisibleHierarchyDrilldownValues 30 If set to a positive integer, specifies the maximum number of values shown at a time for any hierarchy field (All the top-level values are shown irrespective of this value). The values are hidden beyond a certain depth of the hierarchy such that the count of total visible values is at most this number.
$wgCargoTablesPrioritizeReplacements false If true, all tables having a replacement appear at the top of the Special:CargoTables page, instead displaying them in alphabetical order.
$wgCargoPageDataColumns [] The set of fields to store in the _pageData Cargo table. See Storing page data.
$wgCargoFileDataColumns [] The set of fields to store in the _fileData Cargo table. See Storing file data.
$wgCargoHideNamespaceName [6] Array of namespaces to hide from query results.

Související odkazy