Rozszerzenie:3D

Podręcznik rozszerzeń MediaWiki

3D Status wydania: beta
Realizacja	Media
Opis	Zapewnia obsługę formatów plików 3D.
Autor(zy)	Gilles Dubuc Matthias Mullie Mark Holmquist
Ostatnia wersja	0.0.1
Polityka zgodności	Snapshots releases along with MediaWiki. Master nie jest kompatybilny wstecznie.
MediaWiki	>= 1.43
Licencja	Licencja GNU General Public License 2.0 lub nowsza
Pobieranie	Pobierz rozszerzenie Git [?]: Pobierz Git master przeglądaj repozytorium (GitHub) historia wprowadzeń repository contributors (GitHub) ocena kodu
Pomoc	Help:Extension:3D/pl
Parametry $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Użyte haki BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	99 (Ranked 57th)
Rola Vagrant	three_d
Problemy	Otwarte zadania · Zgłoś błąd

Rozszerzenie 3D daje użytkownikowi wiki możliwość wgrywania i przeglądania modeli 3D. Zobacz dokumentację Pomoc:Rozszerzenie:3D , aby uzyskać więcej informacji dotyczących użytkowania.

Obecnie obsługuje format pliku STL, który jest powszechnie używany w branży druku 3D.

Instalacja

Umożliwienie przesyłania plików 3D

Powiedz MediaWiki, że może obsługiwać przesyłanie STL. Dodaj poniższe do pliku LocalSettings.php:

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

Instalacja Rozszerzenia:3D

• Pobierz i umieść plik(i) w katalogu o nazwie 3D w folderze extensions/.
• Dodaj poniższy kod na dole twojego pliku LocalSettings.php :

  wfLoadExtension( '3D' );
  

•  Zrobione – Przejdź do Special:Version na twojej wiki, aby sprawdzić czy rozszerzenie zostało pomyślnie zainstalowane.

Instalacja 3d2png

3d2png to renderer miniatur dla plików 3D. Będzie on renderował miniatury png dokładnie tak, jak to rozszerzenie będzie wyświetlać obiekty, używając tych samych bibliotek JS działających w Node.js zamiast w przeglądarce.

Aby zainstalować, sklonuj i aktywuj repozytorium 3d2png:

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

W systemie Linux konieczne będzie również zainstalowanie wirtualnego bufora ramki, aby 3d2png mógł bezgłowo przechwytywać obiekt 3D.

apt-get install xvfb

Po pomyślnym zainstalowaniu 3d2png, będziemy musieli powiedzieć Rozszerzeniu:3D, jak wywołać tę usługę generatora miniatur. Dodaj to do swojego LocalSettings.php i upewnij się, że zaktualizowałeś ścieżki, aby pasowały do twojej konfiguracji:

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

Instalacja rozszerzenia:MultimediaViewer

MultimediaViewer nie jest zależny od rozszerzenia 3D, ale należy go zainstalować, aby móc korzystać z modeli 3D (przesuwać, powiększać). Po instalacji MultimediaViewer należy powiązać typ pliku STL z odpowiednim rozszerzeniem przeglądarki, dodając je do pliku LocalSettings.php:

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

Konfiguracja

Umowa patentowa

Specjał: Przesyłanie

Aby dodać opcje wyboru umowy patentowej do Specjał:Przesyłanie, edytuj stronę MediaWiki:3d-patents swojej wiki. Każda linia na tej stronie zostanie przekształcona w <option>, gdzie wszystko po ostatnim znaku | jest tekstem, a wszystko przed jest szablonem, który zostanie dodany do przesyłanej zawartości. Przykładem może być commons:MediaWiki:3d-patents.

Make sure to create the template(s) that will be added to the content. i.e. Template:3dpatent

Special:UploadWizard

Special:UploadWizard also supports patent agreement, though slightly less flexible. When uploading a third party STL file, a dialog will be displayed to confirm your upload does not infringe any patents. When uploading one of your own, it'll also ask to confirm the 3d objects depicted are your own work. The template added to the upload content will be {{3dpatent}} or {{3dpatent|ownwork}} respectively.

To change the phrasing of these messages, these pages can be altered: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

To change which file types require patent agreement, which template is added to the upload content or where the urls point to, change LocalSettings.php. Below are the default settings:

$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

Lastly, Extension:CommonsMetadata provides a way to track 3D uploads without said patent license, though it is not configurable at all. It will just check for uploads with a application/sla MIME type (currently the only ones supported by Extension:3D) that lack the 3dpatent template. Pasujące pliki bez tego szablonu w ich zawartości zostaną automatycznie dodane do Category:Files_with_no_machine-readable_patent.

Jeśli używasz innego szablonu niż 3dpatent, nie będzie to dla ciebie przydatne, ponieważ nie jest to obecnie konfigurowalne.