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

This page is a translated version of the page Extension:3D and the translation is 100% complete.
Довідка про розширення MediaWiki
OOjs UI icon advanced.svg
3D
Статус релізу: бета
Asad Al-Lat.stl
Реалізація Медіа
Опис Забезпечує підтримку форматів 3D-файлів.
Автор(и)
Найновіша версія 0.0.1
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.31.0+
Ліцензія GNU General Public License 2.0 or later
Завантажити
Help Help:Extension:3D/uk

Переглянути використання

Vagrant role three_d
Issues Open tasks · Report a bug

Розширення 3D надає користувачеві вікі підтримку для завантаження та перегляду 3D-моделей. Див. Help:Extension: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, це не буде корисним для вас, оскільки наразі його неможливо налаштувати.