Розширення:3D
3D Статус релізу: бета |
|
---|---|
Реалізація | Медіа |
Опис | Забезпечує підтримку форматів 3D-файлів. |
Автор(и) | |
Найновіша версія | 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 |
Завантажити | |
Help | Help:Extension:3D/uk |
|
|
Quarterly downloads | 91 (Ranked 53rd) |
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
, це не буде корисним для вас, оскільки наразі його неможливо налаштувати.
Це розширення використовується в одному або декількох проєктах Вікімедіа. Це, мабуть, означає, що розширення стабільне і працює досить добре, щоб його могли використовувати веб-сайти з великим трафіком. Шукайте назву цього розширення у файлах конфігурації Wikimedia CommonSettings.php та InitialiseSettings.php, щоб побачити, де це встановлене. Повний перелік розширень, встановлених на певній вікі, можна переглянути на сторінці Special:Version вікі. |
Це розширення включено до таких вікі-ферм/хостів та/або пакетів: Це не авторитетний список. Деякі вікі-ферми/хости та/або пакунки можуть містити це розширення, навіть якщо вони не вказані тут. Завжди звертайтеся до своїх вікі-ферм/хостів або комплекту для підтвердження. |
- Beta status extensions/uk
- Media handling extensions/uk
- GPL licensed extensions/uk
- Extensions in Wikimedia version control/uk
- BeforePageDisplay extensions/uk
- UploadForm:getInitialPageText extensions/uk
- UploadFormInitDescriptor extensions/uk
- All extensions/uk
- Extensions used on Wikimedia/uk
- Extensions included in Miraheze/uk
- Extensions included in WikiForge/uk
- 3D extensions/uk