Rozszerzenie:3D
3D Status wydania: beta |
|
---|---|
Realizacja | Media |
Opis | Zapewnia obsługę formatów plików 3D. |
Autor(zy) | |
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 | |
Pomoc | Help:Extension:3D/pl |
|
|
Quarterly downloads | 101 (Ranked 53rd) |
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 folderzeextensions/
. - 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.
To rozszerzenie jest wykorzystywane przez jeden lub więcej projektów Wikimedia. Oznacza to prawdopodobnie, że to rozszerzenie jest stabilne i działa wystarczająco dobrze, aby wykorzystywać je na stronach o dużym natężeniu ruchu. Odnajdź nazwę tego rozszerzenia w plikach konfiguracyjnych Wikimedia CommonSettings.php oraz InitialiseSettings.php, aby zobaczyć gdzie są zainstalowane. Pełną listę rozszerzeń zainstalowanych na określonej wiki można znaleźć na stronie Special:Version na danej wiki. |
To rozszerzenie jest dołączone do następujących farm/hostów wiki lub pakietów: To nie jest pełna lista. Niektóre farmy/hosty wiki lub pakiety mogą zawierać to rozszerzenie nawet jeśli nie są one tutaj wymienione. Zawsze sprawdzaj swoje farmy/hosty wiki, aby to potwierdzić. |