Jump to content

Rozšíření:3D

From mediawiki.org
This page is a translated version of the page Extension:3D and the translation is 100% complete.
Příručka k rozšířením MediaWiki
3D
Stav rozšíření: beta
Implementace Média
Popis Poskytuje podporu pro soubory typu 3D.
Autoři
Nejnovější verze 0.0.1
Zásady kompatibility Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki >= 1.43
Licence GNU General Public License 2.0 nebo novější
Stáhnout
Nápověda Help:Extension:3D/cs
  • $wgMax3d2pngMemory
  • $wg3dProcessEnviron
  • $wgAjaxPatentPreview
Čtvrtletní stahování 100 (Ranked 52nd)
Vagrant role three_d
Problémy Otevřené úkoly · Nahlásit chybu

Rozšíření 3D umožňuje uživateli wiki možnost načítat a prohlížet 3D modely. Dokumentaci pro použití naleznete na stránce Nápověda:Rozšíření:3D .

Aktuálně podporuje souborový formát STL, který je v oblasti 3D tisku běžný.

Instalace

Povolení načítání 3D souborů

Řekne MediaWiki, že smí načítat STL soubory. Přidejte do svého LocalSettings.php následující:

$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';

Instalace Rozšíření:3D

  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného 3D ve vaší složce extensions/.
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( '3D' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Instalace 3d2png

3d2png je vykreslování miniatur pro 3D soubory. Vykreslí miniatury png přesně tak, jako toto rozšíření zobrazí objekty, pomocí stejných knihoven JS spuštěných v Node.js namísto prohlížeče.

Chcete-li nainstalovat, naklonovat a aktivovat úložiště 3d2png:

git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install

V Linuxu si také budete muset nainstalovat virtuální framebuffer, abyste na 3d2png mohli bezhlavě zachytit 3D objekt.

apt-get install xvfb

Po úspěšné instalaci 3d2png budeme muset Extension:3D sdělit, jak volat tuto službu generátoru náhledů. Přidejte toto k vašemu LocalSettings.php a nezapomeňte aktualizovat cesty, aby odpovídaly vaší konfiguraci:

$wg3dProcessor = [
    '/usr/bin/xvfb-run',
    '-a',
    '-s',
    '-ac -screen 0 1280x1024x24',
    '/path-to-your-repository/3d2png.js'
];

Instalace Extension:MultimediaViewer

MultimediaViewer není tvrdá závislost 3D rozšíření, ale budete si ho muset nainstalovat, pokud chcete s 3D modely pracovat (přesouvat, posouvat, přibližovat). Po instalaci MultimediaViewer budete muset přiřadit typ souboru STL ke správné příponě prohlížeče přidáním tohoto do svého souboru LocalSettings.php:

$wgMediaViewerExtensions['stl'] = 'mmv.3d';

Konfigurace

Patentová smlouva

Special:Upload

Chcete-li přidat možnosti výběru patentové smlouvy do Special:Upload, upravte stránku MediaWiki:3d-patents vaší wiki. Každý řádek na této stránce se změní na <volba>, kde vše za posledním znakem | je text a vše před je šablona, která bude přidána do nahrávaného obsahu. Podívejte se na příklad commons:MediaWiki:3d-patents.

Ujistěte se, že jste vytvořili šablony, které budou přidány do obsahu. tj. Template:3dpatent

Special:UploadWizard

Special:UploadWizard také podporuje patentovou dohodu, i když o něco méně flexibilně. Při nahrávání souboru STL třetí strany se zobrazí dialogové okno pro potvrzení, že vaše nahrání neporušuje žádné patenty. Když nahrajete jeden z vašich vlastních, požádá vás také o potvrzení, že zobrazené 3D objekty jsou vaším vlastním dílem. Šablona přidaná k nahrávanému obsahu bude mít hodnotu {{3dpatent}} nebo {{3dpatent|ownwork}}.

Chcete-li změnit formulaci těchto zpráv, lze tyto stránky změnit: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Chcete-li změnit, které typy souborů vyžadují patentovou dohodu, která šablona se přidá k nahrávanému obsahu nebo kam odkazují adresy URL, změňte LocalSettings.php. Níže jsou výchozí nastavení:

$wgUploadWizardConfig['patents'] = [
	'extensions' => [ 'stl' ],
	'template' => '3dpatent',
	'url' => [
		'legalcode' => '//wikimediafoundation.org/wiki/Wikimedia_3D_file_patent_license',
		'warranty' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'license' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'weapons' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing#Weapons',
	],
];

Extension:CommonsMetadata

A konečně, Rozšíření:CommonsMetadata poskytuje způsob, jak sledovat 3D nahrávání bez uvedené patentové licence, i když to není vůbec konfigurovatelné. Zkontroluje pouze nahrání s typem mime application/sla (v současnosti jediné podporované rozšířením: 3D), které postrádá šablonu 3dpatent. Odpovídající soubory bez této šablony ve svém obsahu budou automaticky přidány k Category:Files_with_no_machine-readable_patent.

Pokud používáte jinou šablonu než 3dpatent, nebude to pro vás užitečné, protože ji nelze aktuálně konfigurovat.