Extension:3D
3D 发行状态: 测试版 |
|
---|---|
实现 | 媒体 |
描述 | 為3D(立體)檔案格式提供支援。 |
作者 | |
最新版本 | 0.0.1 |
兼容性政策 | 快照跟随MediaWiki发布。 master分支不向后兼容。 |
MediaWiki | >= 1.43 |
许可协议 | GNU通用公眾授權條款2.0或更新版本 |
下載 | |
帮助 | Help:Extension:3D/zh |
|
|
季度下載量 | 99 (Ranked 57th) |
Vagrant角色 | three_d |
問題 | 开启的任务 · 报告错误 |
The 3D extension gives the user of a wiki support for uploading and viewing 3D models. See Help:扩展:3D for usage documentation.
目前它支持STL文件格式,这在3D打印字段中最常见。
安裝
Allow 3D file uploads
Tell MediaWiki that it can handle STL uploads. Add this to your LocalSettings.php
:
$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';
Install Extension:3D
- 下载文件,并将其放置在您
extensions/
文件夹中的3D
目录内。 - 将下列代码放置在您的LocalSettings.php 的底部:
wfLoadExtension( '3D' );
- 完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。
Install 3d2png
3d2png is the thumbnail renderer for 3D files. It will render png thumbnails exactly like this extension will display the objects, using the same JS libraries running in Node.js instead of the browser.
To install, clone and activate the 3d2png repository:
git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install
On Linux, you'll also need to install a virtual framebuffer in order for 3d2png to be able to headlessly capture the 3D object.
apt-get install xvfb
After having successfully installed 3d2png, we'll need to tell Extension:3D how to call this thumbnail generator service.
Add this to your LocalSettings.php
, and make sure to update the paths to match your configuration:
$wg3dProcessor = [
'/usr/bin/xvfb-run',
'-a',
'-s',
'-ac -screen 0 1280x1024x24',
'/path-to-your-repository/3d2png.js'
];
Install Extension:MultimediaViewer
MultimediaViewer is not a hard dependency of the 3D extension, but you will need to install it if you want to interact (move, pan, zoom) with the 3D models.
After installing MultimediaViewer, you will need to associate the STL file type with the correct viewer extension, by adding this to your LocalSettings.php
file:
$wgMediaViewerExtensions['stl'] = 'mmv.3d';
配置
Patent agreement
Special:Upload
To add patent agreement selection options to Special:Upload, edit your wiki's MediaWiki:3d-patents
page.
Every line on that page will be turned into an <option>, where everything after the last |
character is the text, and everything before is the template that will be added to the upload content.
Check out commons:MediaWiki:3d-patents for an example.
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',
],
];
扩展:共享资源元数据
Lastly, 扩展:共享资源元数据 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.
Matching files lacking this template in their content will automatically be added to Category:Files_with_no_machine-readable_patent
.
If you use any other template than 3dpatent
, this will not be useful for you, as this is not currently configurable.
此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好,可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。 |
此扩展在以下wiki农场/托管网站和/或软件包中提供: 這不是一份權威名單。 即使某些wiki农场/托管网站和/或软件包未在这里列出,它们也可能提供此扩展。 请检查你的wiki农场/托管网站或软件包以确认提供情况。 |