Extension:Cargo/nl
 Release status: stabiel |
|
|---|---|
 |
|
| Implementatie | Speciale pagina, API, Parser functie |
| Beschrijving | Een extensie die het mogelijk maakt om gegevens in sjablonen op te slaan en op te vragen. |
| Auteur(s) | Yaron Koren <yaron57@gmail.com> (Yaron Korenoverleg) |
| Laatste versie | 3.7 (september 2024) |
| Compatibiliteit beleid | Master onderhoudt achterwaartse compatibiliteit. |
| MediaWiki | 1.39+ |
| Database wijzigingen | Ja |
| Composer | mediawiki/cargo |
| Tabellen | cargo_tables cargo_pages cargo_backlinks |
| Licentie | GNU General Public Licentie 2.0 of hoger |
| Download | |
| Voorbeeld | Een pagina met verschillende aanroepen van #cargo_query |
|
|
|
|
|
|
| Downloads kwartaal | 53 (Ranked 86th) |
| Vertaal de extensie Cargo | |
| Problemen | Open taken · Rapporteer een bug |
Cargo is een uitbreiding op MediaWiki die een lichtgewicht manier biedt om de gegevens in de aanroepen naar sjablonen, zoals infoboxen, op te slaan en op te vragen. Het is qua concept vergelijkbaar met de extensie Semantic MediaWiki, maar biedt een aantal voordelen, waaronder installatiegemak en gebruiksgemak.
Cargo slaat al zijn gegevens op in databasetabellen, die in de eigen database van MediaWiki (de standaard) of een aparte database kunnen worden geplaatst. Voor het grootste deel krijgt elke opgeslagen sjabloon zijn gegevens opgeslagen in een enkele DB-tabel, met een kolom voor elke relevante sjabloonparameter. Hierop zijn enkele uitzonderingen: de verwerking van sjabloonvelden met arrays/lijsten met waarden en van velden met geografische coördinaten is complexer vanwege de slechte interne verwerking van die gegevenstypen in de meeste database-systemen. En meerdere sjablonen kunnen worden ingesteld om hun gegevens allemaal in één database-tabel op te slaan.
De extensie definieert een aantal parserfuncties; Deze drie zijn de belangrijkste:
#cargo_declare- geplaatst binnen het deel<noinclude>van een sjabloon; Het definieert het schema voor een tabel.#cargo_store- slaat één rij op in een Cargo-tabel; meestal geplaatst binnen het deel<includeonly>van een sjabloon.#cargo_query- voert query's uit op een of meer Cargo-gegevenstabellen met behulp van SQL-onderdelen.
De andere gedefinieerde parserfuncties zijn:
#cargo_attach- definieert een sjabloon als het toevoegen van rijen aan een tabel die elders is gedeclareerd.#cargo_compound_query- hiermee worden de resultaten van meerdere query's op één plaats weergegeven.#cargo_display_map- hiermee wordt een kaart weergegeven met één punt.#recurring_event- drukt de datums voor een terugkerende gebeurtenis af; voor gebruik met #cargo_store.
Cargo definieert ook verschillende interfaces voor het bekijken en inzoomen van de opgeslagen gegevens. Deze extensie voegt de volgende speciale pagina's toe:
- Special:CargoQuery
- Special:CargoTableDiagram
- Special:CargoTables
- Special:Drilldown
Cargo is getest en werkt met de MySQL- en PostgreSQL-databasesystemen. In theorie ondersteunt het ook SQLite, maar het is niet goed getest met SQLite en werkt mogelijk niet.
Deze versie van de extensie vereist MediaWiki 1.38+.
Klik door de pagina's in de navigatiebalk hierboven voor meer informatie over Cargo, hoe het werkt, hoe het te gebruiken en hoe het te installeren.
Installatie
Configuratie
Hieronder vindt u de algemene configuratie-instellingen van Cargo, samen met de standaardwaarden.
Om Cargo te configureren om een aparte database te gebruiken in plaats van de MediaWiki-database, zijn er de volgende instellingen:
| Afzonderlijke database configuratie-instellingen | ||
|---|---|---|
| Instelling | Standaard | Beschrijving |
$wgCargoDBtype
|
null
|
Databasetype |
$wgCargoDBserver
|
null
|
Hostnaam of IP-adres van de database-server. |
$wgCargoDBname
|
null
|
Naam van de database. |
$wgCargoDBuser
|
null
|
Database gebruikersnaam. |
$wgCargoDBpassword
|
null
|
Het wachtwoord voor $wgCargoDBuser.
|
$wgCargoDBprefix
|
null
|
Database tabelnaam prefix. |
$wgCargoDBRowFormat
|
null
|
Database rij-formaat. |
Voor karakterconfiguratie in verband met getallen zijn er de volgende instellingen:
| Karakter configuratie-instellingen | ||
|---|---|---|
| Instelling | Standaard | Beschrijving |
$wgCargoDecimalMark
|
.
|
Decimaalteken voor getallen. |
$wgCargoDigitGroupingCharacter
|
,
|
Duizend-scheidingsteken. |
De overige globale instellingen zijn als volgt:
| Instelling | Standaard | Beschrijving |
|---|---|---|
$wgCargoAllowedSQLFunctions
|
[]
|
Zet de toegestane SQL-functies. Zie SQL-Functies gebruiken voor standaarden. |
$wgCargoRecurringEventMaxInstances
|
100
|
Het maximale aantal instanties dat moet worden opgeslagen voor terugkerende gebeurtenissen zonder vaste einddatum. |
$wgCargoDefaultStringBytes
|
300
|
Het standaardnummer van tekens voor velden van type Page, String, Wikitext string, File, URL, Email
|
$wgCargoDefaultQueryLimit
|
100
|
Aantal resultaten die voor #cargo_query moeten worden weergegeven als er geen limiet is ingesteld
|
$wgCargoMaxQueryLimit
|
5000
|
Het maximaal toegestane aantal resultaten voor #cargo_query
|
$wgCargo24HourTime
|
false
|
Als true de 24 uur tijdnotatie gebruikt voor veldtypen van Datetime .
|
$wgCargoDefaultMapService
|
OpenLayers
|
Stel de standaard voor kaartservices in op Google Maps, indien ingesteld op googlemaps, op Leaflet als ingesteld als leaflet en op OpenLayers indien ingesteld als openlayers.
|
$wgCargoGoogleMapsKey
|
null
|
API-key voor Google Maps, voor het googlemaps weergaveformaat.
|
$wgCargoMapClusteringMinimum
|
80
|
Als het aantal weer te geven punten op de kaart groter is dan de waarde van $wgCargoMapClusteringMinimum, wordt de kaart met "clusters van locaties" weergegeven in plaats van in individuele punten, dit voor de leesbaarheid. Als het op een zeer hoog aantal wordt ingesteld, wordt geen clustering weergegeven. |
$wgCargoDrilldownUseTabs
|
true
|
Toont de tabelnamen Special:Drilldown als tabbladen boven in plaats van een verticale lijst aan de zijkant. |
$wgCargoDrilldownSmallestFontSize
|
-1
|
Als het op een positief getal wordt ingesteld, wordt de kleinste lettergrootte, in pixels, ingesteld voor een tag-cloud weergave van filterwaarden. |
$wgCargoDrilldownLargestFontSize
|
-1
|
Als het op een positief getal wordt ingesteld, wordt de grootste lettergrootte, in pixels, ingesteld voor een tag-cloud weergave van filterwaarden. |
$wgCargoDrilldownMinValuesForComboBox
|
40
|
Stelt het minimum aantal waarden voor de omzetting van het display in een combinatievak in plaats van in afzonderlijke links. |
$wgCargoDrilldownNumRangesForNumbers
|
5
|
Voor velden/filters van type Integer of Float, wordt het aantal "buckets" aangegeven waarin de waarden worden verdeeld.
|
$wgCargoMaxVisibleHierarchyDrilldownValues
|
30
|
Als deze optie wordt ingesteld op een positief geheel getal, dan geeft het het maximum aantal waarden op dat tegelijk wordt weergegeven voor een veld hierarchy (alle waarden op het hoogste niveau worden weergegeven, ongeacht deze waarde). De waarden buiten een bepaalde diepte van de hiërarchie zijn verborgen, zodat het aantal totale zichtbare waarden maximaal dit getal is.
|
$wgCargoTablesPrioritizeReplacements
|
false
|
Als true, alle tabellen met een vervanging worden bovenaan de pagina van Special:CargoTables weergegeven, in plaats van dat ze in alfabetische volgorde worden weergegeven.
|
$wgCargoPageDataColumns
|
[]
|
De set velden die in de tabel _pageData van Cargo moet worden opgeslagen. Zie opslaan paginagegevens.
|
$wgCargoFileDataColumns
|
[]
|
De set velden die in de tabel _fileData van Cargo moet worden opgeslagen. Zie opslaan bestandsgegevens.
|
$wgCargoHideNamespaceName
|
[6]
|
Matrix met namespaces die in de queryresultaten moeten worden verborgen. |
$wgCargoLegacyNullLuaFieldsAsEmptyString
|
false
|
Null results to the Lua Cargo query function should return as string rather than nil. This allows you to rollback a breaking change from early 2022. New wikis created after this time should not enable this. |
$wgCargoStoreUseTemplateArgsFallback
|
true
|
Enable the behavior that looks for template arguments that match the template's declared table to fill columns. |
Zie ook
- Handleiding:Gegevens beheren in MediaWiki – Een overzicht en een vergelijking.
- Semantic MediaWiki – Maakt het mogelijk om gegevens binnen pagina's op te slaan en op te vragen.
- WikiDB – Biedt databasefuncties die enigszins lijken op semantische eigenschappen.
- Wikibase – Maakt het mogelijk om gestructureerde gegevens weer te geven en te manipuleren als onderdeel van het Wikidata-project.
| Deze uitbreiding is beschikbaar op de volgende wiki-families en/of onderdeel van de volgende pakketten: Dit is geen gezaghebbende lijst. Sommige wikifarms/hosts en/of pakketten kunnen deze extensie bevatten, zelfs als ze hier niet worden vermeld. Controleer het altijd bij uw wiki farms/hosts of bundel. |