Rozšíření:Vlastnosti stránky/Starší verze

**Příručka k rozšířením MediaWiki**
PageProperties; Stav rozšíření: stabilní
Zavádění	Háček, Speciální stránka
Popis	Umožňuje uživatelům snadno upravovat zobrazovaný název, jazyk a obsahový model stránky. Přiřazovat sémantické vlastnosti ke stránkám bez nutnosti ruční anotace (za předpokladu, že je nainstalována Semantic MediaWiki). A nastavovat SEO metadata pro celou wiki nebo pro konkrétní stránky.
Autoři	thomas-topway-it (thomas-topway-itdiskuse)
Nejnovější verze	1.2.5c (2023-03-27)
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	>= 1.35.0
	Parametry $wgPagePropertiesDisplayAlwaysUnprefixedTitles; $wgPagePropertiesAddTrackingCategory; $wgPagePropertiesDisableNavigationLink; $wgPagePropertiesDisableVersionCheck; $wgPagePropertiesDisableSidebarLink;
	Přidaná práva pageproperties-caneditpageproperties;
	Použité háčky (hooks) ArticleUndelete; BeforeInitialize; BeforePageDisplay; LinkerMakeExternalLink; LoadExtensionSchemaUpdates; MultiContentSave; OutputPageParserOutput; PageDeleteComplete; ParserAfterTidy; SidebarBeforeOutput; SkinTemplateNavigation::Universal;
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření ; Git [?]: Procházení úložiště (Phabricator · GitHub); Kontrola kódu Gerrit; Zobrazení historie Git; Stáhněte si zdrojový soubor tarball;
	Přeložte rozšíření PageProperties/Legacy, používá-li lokalizaci z translatewiki.net

This page is a translated version of the page Extension:PageProperties/Legacy and the translation is 100% complete.

PageProperties umožňuje uživatelům snadno upravovat zobrazovaný název, jazyk a obsahový model stránky. Přiřazovat sémantické vlastnosti ke stránkám bez nutnosti ručního anotování (za předpokladu, že je nainstalována Semantic MediaWiki). A nastavovat metadata SEO^[1] pro celou wiki nebo pro konkrétní stránky.

Rozšíření přidává do horní nabídky článků wiki akci, pomocí které mohou autorizovaní uživatelé nastavit všechny relevantní vlastnosti stránky.

Od verze 1.2.4 nabízí PageProperties kompletní grafické uživatelské rozhraní pro vytváření sémantických vlastností, sémantických kategorií a sémantických formulářů, kompletně založené na OOUI^[2] a slotech!

Rozšíření přidává do navigace stránky záložku "Upravit sémantiku", do postranního panelu sekci "Vlastnosti stránky" a do akce nabídky stránky přidává odkaz "Více > Vlastnosti". Viditelnost každého z nich lze spravovat pomocí parametrů níže

Karta stránky Upravit sémantiku:

Sekce postranního panelu:

Vlastnosti odkazu v akcích nabídky stránky:

Instalace

Stáhněte a umístěte soubor(y) do adresáře s názvem PageProperties ve vaší složce extensions/.
Přidejte následující kód na konec vašeho LocalSettings.php

wfLoadExtension( 'PageProperties' );

Volitelně spusťte composer update --no-dev ve složce rozšíření, tím se nainstalují požadované knihovny pro anotaci JSON-LD^[3] na stránce (další informace naleznete v části níže)
Dokončeno – Přejděte na Special:Version na své wiki a ověřte, že je rozšíření úspěšně nainstalováno.

Vlastnosti stránky

Hlavní tabulka

Na hlavní kartě můžete upravit zobrazovaný název stránky, jazyk a model obsahu. Zobrazovaný titulek lze ponechat prázdný, aby byl titulek zcela skryt, aniž byste museli řešit css triky.

Klíčové vlastnosti

Nastavený jazyk je na stránce Informace o stránce správně zobrazen
Zobrazovaný název je přidán do tabulky page_props , aby jej mohly autonomně zpracovávat další rozšíření, jako například Zobrazovaný název
Volitelné kategorie sledování "Stránky s vlastnostmi stránky"
Podpora pro model obsahu HTML a vylepšená podpora pro model obsahu prostý text (v tomto případě bude písmo obsahu stránky nastaveno na monospace a bílé mezery/nové řádky budou zachovány, pokud není nutné vyplnit řádkové rámečky)
Vlastnosti jsou zaznamenány ve vyhrazeném slotu na související stránce a lze je zobrazit na kartě "vlastnosti" v nabídce stránky. (Pozor: aktuálně se obsahový model slotu zobrazuje správně pouze na MediaWiki 1.38 a vyšších, v ostatních verzích se použije obsahový model hlavního slotu)

(tato záložka se zobrazí, když je parametr $wgPagePropertiesShowSlotsNavigation nastaven na true nebo má uživatel právo pageproperties-canmanagesemanticproperties)

Karta SEO

Na kartě SEO^[1] můžete snadno přidat meta tagy nebo meta vlastnosti na konkrétní stránky nebo celou wiki.

Pokud je nainstalováno rozšíření Extension:wikiSEO, PageProperties poskytne combobox s parametry povolenými rozšířením a budou interně zpracovány samotným rozšířením WikiSEO, aniž by bylo nutné je ručně anotovat na stránce.

Všimněte si, že zaškrtávací políčko "použít na celou wiki" se zobrazí pouze v případě, že vlastnosti souvisí s hlavní stránkou wiki.

K dispozici je combobox, pokud je nainstalováno rozšíření wikiSEO

Úprava sémantiky

(tato funkce je k dispozici pouze s nainstalovanou verzí Semantic MediaWiki)
Na kartě "Edit semantic" (upravit sémantiku) můžete interaktivně přiřazovat sémantické tvary a jednotlivé sémantické vlastnosti wiki stránkám bez použití parserových funkcí a bez ručního anotace na stránce.

Nastavené vlastnosti budou viditelné v SMW FactBox a budou správně zpracovány funkcí askqueries.

Zde jsou dva "vstupní body" pro přidání/odebrání formulářů na stránku/ze stránky a pro přidání/odebrání jednotlivých vlastností (nesouvisejících s konkrétním formulářem) na stránku/ze stránky. Každá vlastnost je přidružena k vstupnímu widgetu OOUI a může povolit více polí.

Toto je formulář po přidání na stránku. Formulář se skládá z vlastností definovaných na speciální stránce "Manage properties" (správa vlastností) (viz níže) a následně seskupených do formuláře definovaného na téže stránce. Formuláře lze také použít k vytváření nových článků, jako v Extension:PageForms (více na stránce $1).

Příslušné sekce pro vytváření vlastností, kategorií a dokonce i formulářů jsou přístupné přímo na kartě "Edit semantic" (upravit sémantiku) pomocí následující ikony (s výjimkou karty "Semantic import" (sémantický import), která je přístupná pouze ze speciální stránky "Manage properties" (spravovat vlastnosti)).

Klíčové vlastnosti

Na libovolnou wiki stránku lze interaktivně přidat více formulářů a jednotlivých vlastností
Každý formulář může mít své vlastní výchozí kategorie, vzorec pro název stránky (pouze pro nové stránky) a model obsahu. Pokud se od sebe liší, má uživatel k dispozici rádiový vstup pro výběr požadovaných hodnot.
K dispozici je velká sada nativních vstupů OOUI, které lze do formuláře přidat pomocí jednoduchého rozhraní.
Vlastnosti a formuláře lze bez problémů upravovat/vytvářet, aniž by bylo nutné opustit rozhraní
Podporuje nahrávání více souborů

Správa vlastností

Na speciální stránce "Spravovat vlastnosti" můžete vytvářet/upravovat sémantické vlastnosti, sémantické kategorie, sémantické formuláře a dokonce provádět sémantický import na základě souborů CSV.

Karta Vlastnosti

Zde můžete definovat vlastnost. Podporované možnosti:

typ vlastnosti (libovolný z uvedených zde)
importovaná slovní zásoba (viz zde)
více polí
preferovaný vstup
všechny možnosti související s uvedenými vlastnostmi zde

Je podporována široká škála nativních vstupů Mediawiki a OOUI, například:

Tato ukázková stránka vám umožňuje vytvářet webové aplikace pomocí OOUI v JS nebo PHP. Zkuste to!

Když smažete/přejmenujete vlastnost, budou ovlivněny i všechny stránky obsahující danou vlastnost a vlastnost bude buď smazána, nebo přejmenována na všech relevantních stránkách, proto vezměte v úvahu následující tip!

Karta Kategorie

Zde můžete definovat kategorii. Podporované možnosti:

Každá kategorie může být přiřazena k libovolnému imported vocabulary uloženému na wiki.

Karta Formuláře

Zde můžete definovat formulář. Podporované možnosti:

vzorec pro název stránky nebo vstup pro widget titulku
zobrazit/skrýt volný textový vstup
výchozí kategorie
výchozí model obsahu

Zde (ve stejném okně) můžete formuláři přiřadit pole. Pole lze přeskupovat a pomocí tlačítek umístěných vedle každého z nich se dostanete do příslušného okna vlastností a do okna polí.

Zde můžete definovat vlastnost/pole přiřazené formuláři. Podporované možnosti:

požadované a výchozí hodnoty
vlastní popisek (lze přepsat popisek vlastnosti lokalizovanou zprávou)
vlastní text nápovědy (pokud existuje, lze popis vlastnosti přepsat lokalizovanou zprávou)
preferovaný vstup (může přepsat stejný atribut související vlastnosti)
hodnoty možností pro vstupy s výběrem z více možností načtené z deklarace vlastnosti, pevně zakódovaných hodnot, wikilistu nebo dotazu ask (viz zde)
mapping-formula - u vstupů s více možnostmi výběru můžete upravit způsob jejich zobrazení ve formuláři, aniž byste museli měnit skutečnou hodnotu vlastnosti, podobně jako u šablony mapování v rozšíření PageForms.
více hodnot (může přepsat stejný atribut související vlastnosti)
pouze při vytvoření (zda se má vstup použít pouze k vytvoření vzorce názvu stránky formuláře)

Vytvořené formuláře budou uvedeny ve vyhrazené sekci v postranním panelu takto:

Karta Import

Na kartě "Import" můžete importovat soubory CSV do vaší wiki a namapovat jejich pole na sémantické vlastnosti definované nebo definované ve wiki. Také lze postupně importovat velkou sadu seznamů CSV a dokonce si před skutečným importem zobrazit náhled prostřednictvím rozhraní. Pro každou položku CSV bude vytvořena stránka s rozsáhlou sadou možností pro definování cílového názvu stránky, obsahu stránky, oddělovače hodnot, definovaných kategorií a dalších!

Zde můžete nahrát/přetáhnout soubor CVS k importu.

Zde si můžete zkontrolovat konzistenci dat a nastavit/odebrat záhlaví.

Zde můžete namapovat pole CSV na sémantické vlastnosti zaznamenané ve wiki a dokonce i vytvářet nové vlastnosti za chodu.

Zde si můžete prohlédnout náhled importu, abyste se vyhnuli chybám nebo je minimalizovali: Ve výchozím nastavení se pro každou položku CSV vytvoří jedna wiki stránka.

Funkce parseru

Funkce #pagepropertiesform

Funkci parseru #pagepropertiesform lze použít k zobrazení více formulářů na libovolné stránce wiki, přičemž každý z nich je složen z více formulářů (zpracovaných jako sekce formuláře). Jednoduše vytvořte formulář pomocí rozhraní, jak je znázorněno výše, a poté použijte následující wikitext k vykreslení složeného formuláře na stránce.

{{#pagepropertiesform: Form a
|Form b
|Form c
}}

kde "Form a", "Form b" a "Form ců jsou názvy různých forem. Po umístění formulářů na vámi zvolený článek odesláním formuláře buď vytvoříte nový článek na základě názvu stránky z formuláře nebo názvu zadaného uživatelem do samotného formuláře, nebo spustí chybu v případě, že článek se stejným názvem již existuje. Naproti tomu pro úpravu sémantických vlastností aktuálního článku stačí použít záložku Upravit sémantiku. Nakonec lze pomocí této funkce parseru vložit libovolný počet formulářů do libovolného článku na požadovanou pozici.

Funkce #pagepropertiesformbutton

Funkce parseru #pagepropertiesformbutton může být použita k zobrazení tlačítka odkazu směřujícího na nový formulář vykreslený na speciální stránce. Nový formulář, jak je uvedeno výše, může být následně složen z více formulářů.

{{#pagepropertiesformbutton: text
|Form a
|Form b
|Form c
|button-type=
|class=
}}

kde "text" je text tlačítka, "Form a", "Form b" a "Form c" jsou formuláře, které se mají zobrazit na speciální stránce, "button-type" je volitelný parametr, který určuje, zda se tlačítko formuláře zobrazí jako tlačítko nebo jako text (použijte hodnoty "button" a "text"), a class je volitelný parametr pro přidání jedné nebo více tříd k odkazu na tlačítko.

Funkce #pageproperties

Funkci parseru #pageproperties lze snadno použít k zobrazení sémantických vlastností přidružených ke stránce pomocí šablon, a to jak pro danou sadu vlastností, tak pro každou hodnotu dané vlastnosti (užitečné, když vlastnost obsahuje více hodnot, například obrázky, které mají být nějakým způsobem vykresleny).

Tato funkce parseru by mohla v příští verzi podléhat změnám vývoje!

Příklad 1

{{#pageproperties: {{FULLPAGENAME}} 
|?First name
|?Email
|values-separator=,<nowiki> </nowiki> 
|separator=<br>
}}

Příklad 2

{{#pageproperties: {{FULLPAGENAME}} 
|?Organization name
|?Email
|template=Organization
|template?Logo=Organization logo
}}

Zde funkce parseru načte hodnotu sémantické vlastnosti Organization name, Email, zobrazí hodnotu Logo pomocí šablony "Organization logo" a zobrazí tyto parametry pomocí šablony "Organization" (hodnota vlastnosti Logo je přeložena pomocí požadované šablony).

JSON-LD

JSON-LD^[3] je "metoda kódování propojených dat pomocí JSON" (zdroj: w:JSON-LD). PageProperties automaticky zahrnuje ontologii spojenou se stránkou, pokud existuje, v následujícím tvaru:

{
  "@context": {
    "name": "http://xmlns.com/foaf/0.1/name",
    "homepage": {
      "@id": "http://xmlns.com/foaf/0.1/workplaceHomepage",
      "@type": "@id"
    },
    "Person": "http://xmlns.com/foaf/0.1/Person"
  },
  "@id": "https://me.example.com",
  "@type": "Person",
  "name": "John Smith",
  "homepage": "https://www.example.com/"
}

Tato funkce je k dispozici, když je PageProperties použit ve spojení se Semantic MediaWiki, a je obzvláště užitečná pro účely optimalizace pro vyhledávače, když wiki obsahuje stránky popisující položky schema.org, jako například Osoba, Kniha, Organizace a další.

Konfigurace

Rozšíření funguje nejlépe, když se používá ve spojení s Semantic MediaWiki, WikiSEO a Display Title. Žádný z nich však není nutný, při použití bez Semantic MediaWiki bude sémantický tab vynechán, při použití bez WikiSEO je nutné meta tagy zadat bez rozbalovací nabídky a při použití bez Display Title je možné, že alternativní název stránky nelze použít pro prolinkování.

Globální parametry

proměnná	popis	výchozí
`$wgPagePropertiesDisableJsonLD`	Zakázat vytváření JsonLD ze sémantických vlastností, které mají být přidány do zdrojového kódu stránky	`false`
`$wgPagePropertiesShowSlotsNavigation`	Zobrazit záložky automatů na navigačním panelu	podmíněné (n)
`$wgPagePropertiesAddTrackingCategory`	Přidat Kategorii sledování "Stránky s PageProperties" na stránkách obsahujících vlastnosti	`false`
`$wgPagePropertiesDisableSidebarLink`	Skrýt odkaz na speciální stránku PageProperties na postranním panelu	`false`
`$wgPagePropertiesDisableNavigationLink`	Skrýt odkaz na speciální stránku PageProperties na navigačním panelu	`false`
`$wgPagePropertiesOpenExternalLinksInNewTab`	Vložit atribut `target="_blank"` do všech externích odkazů, takže se otevřou na nové kartě	`false`
`$wgPagePropertiesDisplayAlwaysUnprefixedTitles`	Zobrazit názvy bez předpon pro všechny jmenné prostory, i ty, které nejsou explicitně nastaveny prostřednictvím rozšíření	`false`
`$wgPagePropertiesCreateJobsWarningLimit`	Počet vytvořených pracovních míst bez vydání oznámení	`0`
`$wgPagePropertiesDisableVersionCheck`	Zakázat kontrolu verze rozšíření	`false`

(n) true, pokud má uživatel právo pageproperties-canmanagesemanticproperties, jinak false

(pokud jsou proměnné $wgPagePropertiesDisableSidebarLink i $wgPagePropertiesDisableNavigationLink nastaveny na true, speciální stránka PageProperties nebude z rozhraní přístupná)

Práva a výsady

Rozšíření vytváří následující uživatelská práva. Mohou být buď zahrnuty ručně do LocalSettings.php, nebo spravovány prostřednictvím rozhraní (speciální stránka Special:UserRights). Sysops a byrokraté mají ve výchozím nastavení přiřazenou kompletní sadu oprávnění.

Práva

proměnná	popis
`pageproperties-caneditpageproperties`	Může upravovat vlastnosti stránky
`pageproperties-caneditsemanticproperties`	Lze upravovat sémantické vlastnosti
`pageproperties-canmanagesemanticproperties`	Může spravovat sémantické vlastnosti
`pageproperties-cancomposeforms`	Umí vytvářet formuláře
`pageproperties-canaddsingleproperties`	Lze přidat jednotlivé vlastnosti

Příklad konfigurace

$wgPagePropertiesDisableJsonLD = true;

$wgGroupPermissions['*']["pageproperties-caneditpageproperties"] = false;
$wgGroupPermissions['*']["pageproperties-caneditsemanticproperties"] = true;
$wgGroupPermissions['*']["pageproperties-canmanagesemanticproperties"] = false;
$wgGroupPermissions['*']["pageproperties-cancomposeforms"] = false;
$wgGroupPermissions['*']["pageproperties-canaddsingleproperties"] = false;

Skupiny

skupina (pageproperties-)	Může upravovat vlastnosti stránky	Lze upravovat sémantické vlastnosti	Může spravovat sémantické vlastnosti	Umí vytvářet formuláře	Lze přidat jednotlivé vlastnosti
`admin`
`editor`			N
`pagepropertieseditor`		N	N	N	N
`semanticpropertieseditor`	N

Známé problémy

Následné úpravy názvu souboru pomocí specifické implementace OO.ui.SelectFileWidget ještě neaktualizují název publikovaného souboru. Toto bude opraveno v nadcházející verzi.
Přejmenování vlastností se zatím neprojevuje v deskriptorech formulářů.
Pokud vyhrazený slot obsahuje neregistrované vlastnosti, nebudou zobrazeny na stránce Upravit sémantické speciální vlastnosti. To by se mohlo v budoucnu změnit.

Demo a testování

Rozšíření si můžete vyzkoušet na wikienterprise.org Zkuste to!

Nejnovější vylepšení

Funkce parseru pagepropertiesform a pagepropertiesformbutton (formuláře lze vložit do libovolného článku wiki)
Nativní validace vstupu (s ohledem na požadovaný atribut) pro všechny vstupy OOUI
Dynamické hodnoty možností pro widgety s výběrem odpovědí, založené na hodnotách zadaných uživatelem, wiki seznamech a dotazech
Skryté vstupy
Vzorec-hodnoty (uchovává původní hodnotu, která se použije pro následné úpravy)
Přejmenování/smazání vlastností prostřednictvím rozhraní automaticky aktualizuje všechny stránky a formuláře s danou vlastností s upozorněním na úlohy, které mají být provedeny.
Kategorie vytvořené grafickým rozhraním jsou v dotazech ask správně zpracovávány
Optimalizované načítání požadovaných dat
Další vstupní widgety, jmenovitě Rating a ButtonMultiselectWidget

Plán

Option-inputs s vyhledávacím API a nekonečným rolováním (pro dlouhé seznamy)
Upravitelný popisek vstupu (provedeno ve verzi 1.2.5c)
Podpoložky nebo podobjekty
Sekce formuláře (stačí přidat na panel formuláře možnost "je sekce formuláře", abyste zakázali ostatní hlavní parametry formuláře a dědili z nadřazeného formuláře, poté přidat "skupinu formulářů")
Prohledávatelné vlastnosti v slotech a přednačtený obsah
vyhrazené okno pro možnosti každého dostupného vstupu, jak je uvedeno zde (příklad OO.ui.TextInputWidget), konzistentní napříč Spravovat vlastnosti a polem pro úpravy formulářů
Hromadná úprava
Další vstupy, jako strom a hodnocení (uděláno ve verzi 1.2.5c: hodnocení a více přepínacích tlačítek)
Podpora Extension:Semantic Interlanguage Links

Podpora a chyby

Zveřejněte prosím chybové zprávy na diskuzní stránce rozšíření. Aktualizace budou zveřejňovány na seznamu uživatelů Semantic MediaWiki a občas i na mailing listu Wikitech MediaWiki.

Pro profesionální podporu použijte prosím tento kontaktní formulář (formulář na Rozšíření:CIForms )

Související odkazy

Poznámky pod čarou

↑ ^1.0 ^1.1 Optimalizace pro vyhledávače (SEO)
↑ Objektově orientované uživatelské rozhraní (Object Oriented User Interface OOUI)
↑ ^3.0 ^3.1 Notace objektů JavaScriptu pro propojená data (JSON-LD)

[seo-1] 1.0 ^1.1 Optimalizace pro vyhledávače (SEO)

[ooui-2] Objektově orientované uživatelské rozhraní (Object Oriented User Interface OOUI)

[jsonld-3] 3.0 ^3.1 Notace objektů JavaScriptu pro propojená data (JSON-LD)

[1]

[2]

[3]