Розширення:3D

Довідка про розширення MediaWiki

3D Статус релізу: бета
Реалізація	Медіа
Опис	Забезпечує підтримку форматів 3D-файлів.
Автор(и)	Gilles Dubuc Matthias Mullie Mark Holmquist
Найновіша версія	0.0.1
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.43
Ліцензія	GNU General Public License 2.0 or later
Завантажити	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Help	Help:Extension:3D/uk
Параметри $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Використані hook'и BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	99 (Ranked 57th)
Vagrant role	three_d
Issues	Open tasks · Report a bug

Розширення 3D надає користувачеві вікі підтримку для завантаження та перегляду 3D-моделей. Перегляньте документацію про використання Довідка:Розширення:3D .

Наразі він підтримує формат файлу STL, який є поширеним у сфері 3D-друку.

Встановлення

Дозволити завантаження 3D-файлів

Скажіть MediaWiki, що він може обробляти завантаження STL. Додайте це до свого LocalSettings.php:

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

Встановлення Розширення:3D

• Завантажте і розмістіть файли в каталозі з назвою 3D у вашій extensions/ папці.
• Додайте такий код унизу вашого файлу LocalSettings.php :

  wfLoadExtension( '3D' );
  

•  Готово – Перейдіть до Special:Version вашої вікі, щоб переконатися, що розширення встановлено успішно.

Встановлення 3d2png

3d2png — це засіб візуалізації ескізів для 3D-файлів. Він відображатиме ескізи PNG так само, як це розширення відображатиме об’єкти, використовуючи ті самі бібліотеки JS, що працюють у Node.js замість браузера.

Щоб встановити, клонувати та активувати сховище 3d2png:

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

У Linux вам також потрібно буде встановити віртуальний фреймбуфер, щоб 3d2png міг безголово захопити тривимірний об’єкт.

apt-get install xvfb

Після успішного встановлення 3d2png нам потрібно буде розповісти Розширення:3D, як викликати цю службу генератора ескізів. Додайте це до свого LocalSettings.php і не забудьте оновити шляхи, щоб вони відповідали вашій конфігурації:

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

Встановлення Розширення:MultimediaViewer

MultimediaViewer не є жорсткою залежністю від розширення 3D, але вам потрібно буде його встановити, якщо ви хочете взаємодіяти (переміщати, панорамувати, масштабувати) з 3D-моделями. Після встановлення MultimediaViewer вам потрібно буде пов’язати тип файлу STL з правильним розширенням засобу перегляду, додавши це до вашого файлу LocalSettings.php:

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

Конфігурація

Патентний договір

Спеціальна:Завантаження

Щоб додати параметри вибору патентної угоди до Спеціальна:Завантаження, відредагуйте сторінку своєї вікі MediaWiki:3d-patents. Кожен рядок на цій сторінці буде перетворено на <option>, де все після останнього символу | є текстом, а все перед – шаблоном, який буде додано до вмісту завантаження. Для прикладу перегляньте commons:MediaWiki:3d-patents.

Обов’язково створіть шаблон(и), який буде додано до вмісту. тобто Template:3dpatent

Спеціальна:UploadWizard

Спеціальна:UploadWizard також підтримує патентну угоду, хоча трохи менш гнучку. Під час завантаження стороннього файлу STL відобразиться діалогове вікно, щоб підтвердити, що ваше завантаження не порушує жодних патентів. Під час завантаження одного з ваших власних об’єктів він також попросить підтвердити, що зображені тривимірні об’єкти є вашою власною роботою. Шаблон, доданий до вмісту для завантаження, становитиме {{3dpatent}} або {{3dpatent|ownwork}} відповідно.

Щоб змінити формулювання цих повідомлень, ці сторінки можна змінити: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty і MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Щоб змінити типи файлів, які потребують патентної угоди, який шаблон додається до вмісту для завантаження або куди вказують URL-адреси, змініть LocalSettings.php. Нижче наведено налаштування за замовчуванням:

$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',
	],
];

Розширення:CommonsMetadata

Нарешті, Extension:CommonsMetadata надає можливість відстежувати завантаження 3D без зазначеної патентної ліцензії, хоча його взагалі не можна налаштувати. Він просто перевірить завантаження з типом MIME application/sla (наразі єдиними, які підтримує Розширення:3D), у яких відсутній шаблон 3dpatent. Відповідні файли, у вмісті яких немає цього шаблону, автоматично буде додано до Category:Files_with_no_machine-readable_patent.

Якщо ви використовуєте будь-який інший шаблон, крім 3dpatent, це не буде корисним для вас, оскільки наразі його неможливо налаштувати.