Extensión:3D

From mediawiki.org
This page is a translated version of the page Extension:3D and the translation is 100% complete.
Manual de extensiones de MediaWiki
3D
Estado de lanzamiento: beta
Implementación Multimedia
Descripción Proporciona soporte para formatos de archivos 3D.
Autor(es)
Última versión 0.0.1
Política de compatibilidad Lanzamientos de screenshots junto con MediaWiki. Master no es compatible con versiones anteriores.
MediaWiki >= 1.42
Licencia GNU Licencia Pública general 2.0 o posterior
Descarga
  • $wgMax3d2pngMemory
  • $wg3dProcessEnviron
  • $wgAjaxPatentPreview
Descargas trimestrales 94 (Ranked 71st)
Función de vagabundo three_d
Asuntos Tareas abiertas · Reportar un bug

La extensión 3D ofrece al usuario de unA wiki soporte para subir y ver modelos 3D. Véase Help:Extension:3D para la documentación de uso.

Actualmente admite el formato de archivo STL, que es común en el campo de la impresión 3D.

Instalación

Permite cargas de archivos en 3D

Dile a MediaWiki que puede manejar las subidas de STL. Añade esto a su LocalSettings.php:

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

Instalar extensión:3D

  • Descarga y extrae los archivos en un directorio denominado «3D» dentro de la carpeta extensions/.
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( '3D' );
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Instalar 3d2png

3d2png es el renderizado de miniaturas para archivos 3D. Renderá miniaturas png exactamente como esta extensión mostrará los objetos, utilizando las mismas bibliotecas JS que se ejecutan en Node.js en lugar del navegador.

Para instalar, clonar y activar el repositorio 3d2png:

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

En Linux, también necesitarás instalar un marco virtual para que 3d2png pueda capturar el objeto 3D sin cabeza.

apt-get install xvfb

Después de haber instalado con éxito 3d2png, tendremos que decirle a Extension:3D cómo llamar a este servicio de generador de miniaturas. Añade esto a su LocalSettings.php, y asegúrese de actualizar los caminos para que coincidan con su configuración:

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

Instalar Extension:MultimediaViewer

MultimediaViewer no es una dependencia dura de la extensión 3D, pero tendrás que instalarlo si desea interactuar (mover, desplazar, zoom) con los modelos 3D. Después de instalar MultimediaViewer, deberá asociar el tipo de archivo STL con la extensión de visor correcta, añadiendo esto a su archivo LocalSettings.php:

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

Configuración

Acuerdo de patente

Especial:Subir

Para añadir opciones de selección de acuerdo de patente a Special:Upload, edita la página MediaWiki:3d-patents de tu wiki. Cada línea de esa página se convertirá en una <opción>, donde todo lo que sigue al último carácter | es el texto y todo lo que está antes es la plantilla que se agregará al contenido cargado. Mira commons:MediaWiki:3d-patents por ejemplo.

Asegúrese de crear la(s) plantilla(s) que se agregarán al contenido. Es decir, Template:3dpatent"

Especial:AsistenteCarga

Special:AsistenteCarga también admite acuerdos de patentes, aunque un poco menos flexibles. Cuando se carga un archivo de terceros de STL, se mostrará un diálogo para confirmar que su carga no infringe ninguna patente. Al subir uno de los tuyos, también pedirá que confirmes que los objetos 3D representados son tu propio trabajo. La plantilla añadida al contenido de carga será de {{3dpatent}} o {{3dpatent|ownwork}} respectivamente.

Para cambiar la frase de estos mensajes, estas páginas pueden ser alteradas: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Para cambiar qué tipos de archivos requieren un acuerdo de patente, qué plantilla se añade al contenido de carga o a dónde apunta la URL, cambia LocalSettings.php. A continuación se presentan las configuraciones predeterminadas:

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

Extensión:CommonsMetadata

Por último, Extension:CommonsMetadata proporciona una manera de rastrear las subidas 3D sin dicha licencia de patente, aunque no es configurable en absoluto. Sólo comprobará si hay cargas con un tipo de mime de application/sla (actualmente las únicas compatibles con la Extensión:3D) que carecen de la plantilla de 3dpatent. Los archivos correspondientes que carecen de esta plantilla en su contenido se agregarán automáticamente a Category:Files_with_no_machine-readable_patent.

Si utiliza cualquier plantilla que no sea 3dpatent, esto no te será útil, ya que actualmente no se puede configurar.