Extension:3D

MediaWiki manüel uzantıları

3D Sürüm durumu: beta
Uygulama	Medya
Açıklama	3B dosya formatları için destek sağlar.
Yazar(lar)	Gilles Dubuc Matthias Mullie Mark Holmquist
En son sürüm	0.0.1
Uyumluluk politikası	MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki	>= 1.43
Lisans	GNU Genel Kamu Lisansı 2.0 veya üstü
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi
Yardım	Help:Extension:3D/tr
Parametreler $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Kullanılan kancalar BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	101 (Ranked 53rd)
Vagrant rolü	three_d
Sorunlar	Açık görevler · Hata bildir

3D uzantısı kullanıcıya 3D modelleri yüklemek ve görüntülemek için bir viki desteği verir. Kullanım belgeleri için Help:Extension:3D sayfasına bakın.

Şu anda 3B yazdırma alanında yaygın olan STL dosya biçimini desteklemektedir.

Kurulum

1. 3D dosya yüklemelerine izin ver

MediaWiki'ye STL yüklemelerini işleyebileceğini bildirin. Bunu LocalSettings.php klasörünüze ekleyin:

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

2. Yükleme Uzantısı: 3D

• Dosya(ları)yı indirin ve extensions/ klasörünüzdeki 3D adlı dizine yerleştirin.
• LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( '3D' );
  

•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

3. 3d2png'yi yükleyin

3d2png 3D dosyalar için küçük resim oluşturucudur. Bu küçük resim, tam olarak bu uzantının tarayıcı yerine Node.js'de çalışan aynı JS kitaplıklarını kullanarak nesneleri görüntüleyeceği gibi küçük resimler oluşturur.

3d2png deposunu kurmak, klonlamak ve etkinleştirmek için:

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

Linux'ta, 3d2png 3D nesnesini başsızca yakalayabilmesi için bir sanal çerçeve tamponu da kurmanız gerekir.

apt-get install xvfb

3d2png başarıyla kurduktan sonra, Extension:3D'ye bu küçük resim oluşturma servisini nasıl arayacağımızı söylememiz gerekecek. Bunu LocalSettings.php klasörünüze ekleyin ve yolları yapılandırmanıza uyacak şekilde güncellediğinizden emin olun:

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

ExtensionːMultimediaViewer yükle

MultimediaViewer, 3D uzantının zor bir bağımlılığı değildir, ancak 3D modellerle etkileşim kurmak (taşımak, kaydırmak, zum yapmak) istiyorsanız onu yüklemeniz gerekir. MultimediaViewer kurulumu sonrasında, bunu LocalSettings.php dosyanıza ekleyerek STL dosya türünü doğru görüntüleyici uzantısıyla ilişkilendirmeniz gerekir:

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

Yapılandırma

Patent sözleşmesi

Special:Upload

SpecialːUpload patent sözleşmesi seçim seçenekleri eklemek için vikinizin MediaWiki:3d-patents sayfasını düzenleyin. Bu sayfadaki her satır bir <option> haline getirilir; burada son | karakterinden sonraki her şey metindir ve önceki her şey yükleme içeriğine eklenecek şablondur. Örnek olarak commons:MediaWiki:3d-patents sayfasına göz atın.

İçeriğe eklenecek şablon oluşturduğunuzdan emin olun. Yani Template:3dpatent

Special:UploadWizard

Special:UploadWizard patent anlaşmasını da destekliyor, ancak biraz daha az esnek. Üçüncü taraf bir STL dosyası yüklerken, yüklemenizin herhangi bir patenti ihlal etmediğini onaylayan bir iletişim kutusu görüntülenecektir. Kendinizden birini yüklerken, tasvir edilen 3d nesnelerin kendi çalışmanız olduğunu da onaylamanız istenir. Yükleme içeriğine eklenen şablon sırasıyla {{3dpatent}} veya {{3dpatent|ownwork}} olacaktır.

Bu mesajların ifadelerini değiştirmek için bu sayfalar değiştirilebilir: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty ve MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Hangi dosya türlerinin patent sözleşmesi gerektirdiğini, yükleme içeriğine hangi şablonun eklendiğini veya URL'lerin işaret ettiği yeri değiştirmek için LocalSettings.php değiştirin. Varsayılan ayarlar aşağıdadır:

$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

Son olarak, Extension:CommonsMetadata söz konusu patent lisansı olmadan 3D yüklemeleri izlemek için bir yol sağlar, ancak yapılandırılabilir değildir. Sadece 3dpatent şablonu olmayan application/sla mime türü (şu anda yalnızca Extension:3D tarafından desteklenenler) olan yüklemeleri kontrol edecektir. Bu şablonu içermeyen dosyaların içeriğinde eşleşen dosyalar Category:Files_with_no_machine-readable_patent otomatik olarak eklenir.

3dpatent dışında başka bir şablon kullanırsanız, şu anda yapılandırılamadığı için bu sizin için yararlı olmayacaktır.