wAML - Contribuciones del usuario [es]

Archivo:TLex abierto en su versión de 32 bit.jpg

2023-03-02T21:59:35Z

NikaZhenya:

TLex abierto en su versión de 32 bit.
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-03-02T21:57:41Z

NikaZhenya:

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref><ref name=":3" /><ref>Página oficial de solución de problemas comunes de TLex. [https://tshwanedje.com/kb/]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera remota en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref name=":3">Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]]. Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado para instalarlo.
#* '''Si no permite la instalación''' por falta de Microsoft Visual C++ Redistributable, a continuación:
#*# Descarge [https://aka.ms/vs/17/release/vc_redist.x86.exe este archivo <code>exe</code> (13.2 MB)].<ref>Si el enlace está roto, vaya a [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022 esta página] y, en el apartado «Visual Studio 2015, 2017, 2019, and 2022», seleccione el archivo <code>exe</code> para la arquitectura <code>X86</code>.</ref>
#*# Reinicie la computadora.
#*# '''Repita desde el paso 3''' para instalar el ''driver''. Si el problema persiste:
#*##Tome una captura de pantalla.
#*##Contacte al administrador y espere a recibir asistencia.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo remoto con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

==== Para macOS ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

=== Creación de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario remoto con TLex se siguen los siguientes pasos:

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4">En Windows TLex se instala en las versiones de 32 y 64 bit. No obstante, la conexión a diccionarios remotos solo funciona con la versión de 32 bit. Así que sin importar la arquitectura del sistema, siempre debe abrirse TLex en dicha versión.</ref>
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''
[[Archivo:TLex abierto en su versión de 32 bit.jpg|alt=TLex abierto en su versión de 32 bit. La última pestaña debe indicar 32-bit.|miniaturadeimagen|TLex abierto en su versión de 32 bit. Los diccionarios remotos solo funcionan en esta versión de TLex.]]
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

=== Guardado de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4" />
# [[TLex#Creación de diccionario remoto|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario remoto|abra un diccionario]] remoto.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario remoto|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, de nuevo puede trabajar con el diccionario.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario remoto, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario remoto|este apartado]].</blockquote>Para la apertura de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4" />
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-03-02T21:49:16Z

NikaZhenya: Explicitación del problema durante la instalación del driver MySQL en Windows.

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref><ref name=":3" /><ref>Página oficial de solución de problemas comunes de TLex. [https://tshwanedje.com/kb/]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera remota en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref name=":3">Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]]. Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado para instalarlo.
#* '''Si no permite la instalación''' por falta de Microsoft Visual C++ Redistributable, a continuación:
#*# Descarge [https://aka.ms/vs/17/release/vc_redist.x86.exe este archivo <code>exe</code> (13.2 MB)].<ref>Si el enlace está roto, vaya a [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022 esta página] y, en el apartado «Visual Studio 2015, 2017, 2019, and 2022», seleccione el archivo <code>exe</code> para la arquitectura <code>X86</code>.</ref>
#*# Reinicie la computadora.
#*# '''Repita desde el paso 3''' para instalar el ''driver''. Si el problema persiste:
#*##Tome una captura de pantalla.
#*##Contacte al administrador y espere a recibir asistencia.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo remoto con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

==== Para macOS ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

=== Creación de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario remoto con TLex se siguen los siguientes pasos:

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4">En Windows TLex se instala en las versiones de 32 y 64 bit. No obstante, la conexión a diccionarios remotos solo funciona con la versión de 32 bit. Así que sin importar la arquitectura del sistema, siempre debe abrirse TLex en dicha versión.</ref>
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''
[[Archivo:TLex abierto en su versión de 32 bit.jpg|alt=TLex abierto en su versión de 32 bit. La última pestaña debe indicar 32-bit.|miniaturadeimagen|TLex abierto en su versión de 32 bit. La última pestaña debe indicar <code>32-bit</code>.]]
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

=== Guardado de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4" />
# [[TLex#Creación de diccionario remoto|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario remoto|abra un diccionario]] remoto.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario remoto|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, de nuevo puede trabajar con el diccionario.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario remoto, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario remoto|este apartado]].</blockquote>Para la apertura de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Comprueba que se ha abierto TLex en su versión de 32 bit.<ref name=":4" />
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:TLex abierto en su versión de 32 bit.jpg

2023-03-02T21:39:45Z

NikaZhenya:

TLex abierto en su versión de 32 bit.

TLex

2023-03-02T21:16:31Z

NikaZhenya: Adición de enlace

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref><ref name=":3" /><ref>Página oficial de solución de problemas comunes de TLex. [https://tshwanedje.com/kb/]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera remota en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref name=":3">Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo remoto con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

==== Para macOS ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

=== Creación de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario remoto con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

=== Guardado de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario remoto. (Clic para alargar).]]

# Abra TLex
# [[TLex#Creación de diccionario remoto|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario remoto|abra un diccionario]] remoto.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario remoto|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario de nuevo.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario remoto, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario remoto|este apartado]].</blockquote>Para la apertura de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para la apertura de un diccionario colaborativo.jpg

2023-02-24T18:02:41Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Pasos para la apertura de un diccionario colaborativo.jpg a Archivo:Pasos para la apertura de un diccionario remoto.jpg

#REDIRECCIÓN [[Archivo:Pasos para la apertura de un diccionario remoto.jpg]]

Archivo:Pasos para la apertura de un diccionario remoto.jpg

2023-02-24T18:02:41Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Pasos para la apertura de un diccionario colaborativo.jpg a Archivo:Pasos para la apertura de un diccionario remoto.jpg

Pasos para la apertura de un diccionario remoto
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para la apertura de un diccionario remoto.jpg

2023-02-24T18:02:33Z

NikaZhenya:

Pasos para la apertura de un diccionario remoto
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para el guardado de un diccionario colaborativo.jpg

2023-02-24T18:02:11Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Pasos para el guardado de un diccionario colaborativo.jpg a Archivo:Pasos para el guardado de un diccionario remoto.jpg

#REDIRECCIÓN [[Archivo:Pasos para el guardado de un diccionario remoto.jpg]]

Archivo:Pasos para el guardado de un diccionario remoto.jpg

2023-02-24T18:02:11Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Pasos para el guardado de un diccionario colaborativo.jpg a Archivo:Pasos para el guardado de un diccionario remoto.jpg

Pasos para el guardado de un diccionario remoto
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para el guardado de un diccionario remoto.jpg

2023-02-24T18:01:49Z

NikaZhenya:

Pasos para el guardado de un diccionario remoto
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-24T17:59:39Z

NikaZhenya: colaborativ@ => remoto

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera remota en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo remoto con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

==== Para macOS ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario remoto|el guardado]] o [[TLex#Apertura%20de%20diccionario%20remoto|la apertura]] de diccionarios remotos.

=== Creación de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario remoto con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

=== Guardado de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario remoto. (Clic para alargar).]]

# Abra TLex
# [[TLex#Creación de diccionario remoto|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario remoto|abra un diccionario]] remoto.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario remoto|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario de nuevo.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario remoto, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario remoto ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario remoto|este apartado]].</blockquote>Para la apertura de un diccionario remoto con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario remoto. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario remoto. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario remoto|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario remoto|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T23:15:58Z

NikaZhenya:

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>🟡 Este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex
# [[TLex#Creación de diccionario colaborativo|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario colaborativo|abra un diccionario]] colaborativo.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario colaborativo|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario de nuevo.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario colaborativo, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario colaborativo ===
<blockquote>🟡 Este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Instalación del driver de MySQL en macOS.jpg

2023-02-10T23:04:31Z

NikaZhenya:

Instalación del driver de MySQL en macOS.
[[Categoría:Software]]
[[Categoría:Lexicografía]]
{{DEFAULTSORT:Archivo:Instalación_del_driver_de_MySQL_en_macOS.jpg}}
[[Categoría:Base de datos]]

Archivo:Instalación de driver de MySQL en Windows.jpg

2023-02-10T23:04:15Z

NikaZhenya:

Instalación de driver de MySQL en Windows.
[[Categoría:Software]]
[[Categoría:Lexicografía]]
[[Categoría:Base de datos]]

Archivo:Configuración del driver de MySQL en Windows.jpg

2023-02-10T23:03:35Z

NikaZhenya:

Configuración del driver de MySQL en Windows.
[[Categoría:Software]]
[[Categoría:Lexicografía]]
[[Categoría:Base de datos]]

Archivo:Configuración del driver de MySQL en macOS.jpg

2023-02-10T23:03:10Z

NikaZhenya:

Configuración del driver de MySQL en macOS
[[Categoría:Software]]
[[Categoría:Lexicografía]]
[[Categoría:Base de datos]]

Archivo:Pasos para el guardado de un diccionario remoto.jpg

2023-02-10T23:02:31Z

NikaZhenya:

Pasos para el guardado de un diccionario colaborativo
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para la apertura de un diccionario remoto.jpg

2023-02-10T23:02:06Z

NikaZhenya:

Pasos para la apertura de un diccionario colaborativo
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Instalación del driver de MySQL en macOS..jpg

2023-02-10T23:00:55Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Instalación del driver de MySQL en macOS..jpg a Archivo:Instalación del driver de MySQL en macOS.jpg

#REDIRECCIÓN [[Archivo:Instalación del driver de MySQL en macOS.jpg]]

Archivo:Instalación del driver de MySQL en macOS.jpg

2023-02-10T23:00:55Z

NikaZhenya: NikaZhenya trasladó la página Archivo:Instalación del driver de MySQL en macOS..jpg a Archivo:Instalación del driver de MySQL en macOS.jpg

Instalación del driver de MySQL en macOS.
[[Categoría:Software]]
[[Categoría:Lexicografía]]
[[Categoría:Administración de sistemas]]
{{DEFAULTSORT:Archivo:Instalación_del_driver_de_MySQL_en_macOS.jpg}}

Archivo:Instalación del driver de MySQL en macOS.jpg

2023-02-10T23:00:07Z

NikaZhenya:

TLex

2023-02-10T22:58:11Z

NikaZhenya:

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex
# [[TLex#Creación de diccionario colaborativo|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario colaborativo|abra un diccionario]] colaborativo.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario colaborativo|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario de nuevo.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario colaborativo, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T22:56:19Z

NikaZhenya: /* Prefijo «tl_» */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para el guardado de un diccionario colaborativo.jpg|alt=Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para el guardado de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex
# [[TLex#Creación de diccionario colaborativo|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario colaborativo|abra un diccionario]] colaborativo.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario colaborativo|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario colaborativo, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo y para el administrador son más legibles si se emplean guiones bajos al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar. Una manera de mitigar este inconveniente es el establecimiento de distintas contraseñas a los usuarios <code>Admin</code> de cada diccionario.

=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para el guardado de un diccionario remoto.jpg

2023-02-10T22:55:37Z

NikaZhenya:

Pasos para el guardado de un diccionario colaborativo

TLex

2023-02-10T22:42:04Z

NikaZhenya: /* Guardado de diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# [[TLex#Creación de diccionario colaborativo|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario colaborativo|abra un diccionario]] colaborativo.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_<ref name=":2" />
#** Por defecto el valor del prefijo es «tl_», véase [[TLex#Prefijo «tl »|el siguiente subapartado]] para más información.
#Dé clic en <code>OK</code>.
#Administre usuarios si lo desea y dé clic en <code>Close</code>.
#*Por defecto solo hay un usuario cuyo nombre y contraseña son <code>Admin</code>.
#*Se recomienda tener varios usuarios con los privilegios asignados según el rol de cada persona.
#*Cada colaborador requiere de estos accesos para [[TLex#Apertura de diccionario colaborativo|la apertura]] del diccionario.
#Espere unos segundos o un par de minutos para que se guarde el diccionario.
#*'''Si no se guardó el diccionario''', revise la información agregada (como el usuario y la contraseña) e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario colaborativo, TLex ofrece el prefijo «tl_» como valor opcional y por defecto. Cada diccionario es guardado en la misma base de datos [[MySQL]], así que el prefijo permite almacenar varios diccionarios. '''Si no se usa el prefijo, solo es posible almacenar un diccionario''' por base de datos ya que TLex sobreescribe la información.

Para recordar con facilidad el prefijo de cada diccionario, se recomienda utilizar una nomenclatura más explícita para el usuario en lugar de «tl_» o, por ejemplo, «dic1_» o «dic2_». En la suposición de que se esta trabajando con dos diccionarios, uno para mexicanismos y otro para educación básica, la recomendación sería utilizar los prefijos «mexicanismos_» y «basica_» de manera respectiva.

El guion bajo al final de cada prefijo también es opcional. Sin embargo, se recomienda mantener esta convención ya que cada diccionario genera diferentes tablas que usan el prefijo, así que para el personal de administración le es más legible el nombre de estas tablas si se emplea el guion bajo al final.

Cabe por demás advertir que '''el uso incorrecto de los prefijos puede provocar una pérdida de información'''. En seguimiento al ejemplo pasado, si por error el usuario guarda el diccionario «basica_» como «mexicanismos_», el diccionario de mexicanismos tendrá pérdida de información porque TLex guardará la información del diccionario para educación básica en su lugar.

=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: nombreDelDiccionario_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T22:14:19Z

NikaZhenya: /* Guardado de diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Abra TLex
# [[TLex#Creación de diccionario colaborativo|Empiece un nuevo diccionario]] o [[TLex#Apertura de diccionario colaborativo|abra un diccionario]] colaborativo.
# Dé click en la pestaña <code>File</code> y luego en la opción <code>Save as: ODBC database</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: dic1_
#** Por defecto el valor del prefijo es «tl_», véase el siguiente subapartado para más información.

==== Prefijo «tl_» ====
Cuando se guarda un diccionario colaborativo, TLex ofrece el prefijo «tl_» como valor opcional y por defecto para un diccionario.

=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: dic1_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:41:48Z

NikaZhenya: /* Guardado de diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Creación de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para la creación de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Dé clic en <code>Start a new dictionary project</code> desde la ventana principal o en <code>New dictionary</code> desde la pestaña <code>File</code>.
# … '''Por documentar'''

Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>Para el guardado de un diccionario colaborativo con TLex se siguen los siguientes pasos:

# Empiece un nuevo diccionario o abra un diccionario colaborativo.

=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> desde la ventana principal o desde la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:34:09Z

NikaZhenya: /* Configuración de conexión remota */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Guardado de diccionario colaborativo|el guardado]] o [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] de diccionarios colaborativos.

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>
=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y el guardado de un nuevo diccionario descrito en [[TLex#Guardado de diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> de la ventana principal o de la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Guardado de diccionario colaborativo|el guardado del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede trabajar con el diccionario. '''Para guardar los cambios, siga las instrucciones de [[TLex#Guardado de diccionario colaborativo|este apartado]].'''

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:31:13Z

NikaZhenya: /* Creación y guardado de nuevo diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

=== Guardado de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>
=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y la creación de un nuevo diccionario descrita en [[TLex#Creación de nuevo diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> de la ventana principal o de la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede modificar el diccionario.

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:30:13Z

NikaZhenya: /* Creación de nuevo diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

=== Creación y guardado de nuevo diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>
=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y la creación de un nuevo diccionario descrita en [[TLex#Creación de nuevo diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> de la ventana principal o de la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.
Si los pasos fueron realizados de manera satisfactoria, ahora puede modificar el diccionario.

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:26:20Z

NikaZhenya:

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

=== Creación de nuevo diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>
=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y la creación de un nuevo diccionario descrita en [[TLex#Creación de nuevo diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo. (Clic para alargar).]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> de la ventana principal o de la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

TLex

2023-02-10T21:25:41Z

NikaZhenya: /* Apertura de diccionario colaborativo */

'''TLex''' o '''TshwaneLex''' es un conjunto de aplicaciones (''suite'') de ''software'' para la producción y el mantenimiento de diccionarios y listados terminológicos. La ''suite'' pertenece a TshwaneDJe Human Language Technology, una empresa privada sudafricana fundada en 2002 por David Joffe,<ref>''Curriculum Vitae'' de David Joffe. [https://tshwanedje.com/members/djoffe/cv.html]</ref> director ejecutivo y programador, y Gilles-Maurice de Schryver,<ref>''Curriculum Vitae'' de Gilles-Maurice de Schryver. [https://tshwanedje.com/members/gmds/cv.html]</ref> lingüista, profesor e investigador. En la actualidad TLex se ofrece como aplicación de escritorio para Windows o macOS. Para su uso se requiere la compra de una licencia, aunque permite su evaluación gratuita. Entre sus clientes están la Oxford University Press, la editorial Macmillan, la Real Academia Nacional de Medicina, el Grupo Clarín, el Instituto de Lengua y Literatura de Malasia, y el Instituto de Lexicología Holandesa.

La [[Academia Mexicana de la Lengua]] utiliza TLex para la elaboración de sus diccionarios.

[[Archivo:TshwaneLex GUI.png|alt=Interfaz gráfica de usuario de TLex.|miniaturadeimagen|Interfaz gráfica de usuario de TLex.]]

== Instalación de TLex ==

=== Instalación de ''suite'' principal ===
Para instalar TLex en cualquiera de los sistemas operativos soportados basta con descargar el archivo ejecutable desde su página oficial de descarga:

* [https://tshwanedje.com/builds/3250/TLex_Suite_Setup_14.1.0.3250.exe Archivo <code>exe</code> para Windows (138 MB)]
* [https://tshwanedje.com/builds/mac64/3214/TLex_Suite_2022_14.1.0.3214.dmg Archivo <code>dmg</code> para macOS (130 MB)]

La página de descarga ofrece otros archivos ejecutables para sistemas operativos Windows y macOS antiguos, además de que da soluciones a potenciales problemas durante la instalación.<ref>Página oficial de descarga de TLex. [https://tshwanedje.com/downloads/download.php?app=TLexSuite]</ref>

=== Instalación de ''software'' adicional ===
TLex se utiliza de manera colaborativa en la [[Academia Mexicana de la Lengua|Academia]]. Es decir, las personas del departamento de lexicografía se conectan a una base de datos [[MySQL]] que almacena los diccionarios; esto permite su elaboración y gestión desde cualquier equipo de cómputo que tenga instalado TLex. Aunque TLex cuenta con una página de soporte<ref>Página oficial de soporte de TLex. [https://tshwanedje.com/support/]</ref> y una guía de usuario,<ref>Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]</ref> estas solo contienen información en inglés, por lo que a continuación se describe el proceso para la instalación del ''software'' necesario para la conexión [[MySQL]].<ref name=":1">Con antelación el administrador de sistemas debe levantar un servidor [[MySQL]] y proporcionar la información de acceso a los usuarios de TLex. En este artículo no se describe dicho proceso porque no es un requisito para el usuario de TLex. Para leer sobre este procedimiento, véase el artículo sobre [[MySQL]].</ref>

==== Para Windows ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]].<ref>En algunos casos se requiere instalar Microsoft Visual C++ Redistributable 2019. En caso de necesitarlo, es posible descargarlo desde [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist esta página]. Una vez instalado es necesario reiniciar la computadora antes de continuar con el proceso.</ref> Para ello:
[[Archivo:Instalación de driver de MySQL en Windows.jpg|alt=Pasos 4-8 en Windows. (Clic para alargar).|miniaturadeimagen|383x383px|Pasos 4-8 en Windows. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-win32.msi el ''driver'' <code>msi</code> (8.9 MB)].<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>Microsoft Windows</code> como sistema operativo y <code>Windows (x86, 32-bit)</code> como versión; a continuación seleccione el archivo <code>MSI Installer</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se está realizando la descarga y espere hasta que finalice.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Next</code>.
# Dé clic en <code>I accept the terms in the license agreement</code> y dé clic en <code>Next</code>.
# Seleccione la instalación <code>Typical</code> y dé clic en <code>Next</code>.
# Dé clic en <code>Install</code> y esperé a que finalice la instalación.<ref name=":0">En ciertos casos se requiere ingresar el usuario y contraseña del administrador antes de continuar.</ref>
# Dé clic en <code>Finish</code> para concluir la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

==== Para macOS ====
Este sistema operativo requiere la descarga y la instalación del ''driver'' de [[MySQL]] y del ''software'' ODBC Manager. Para ello:
[[Archivo:Instalación del driver de MySQL en macOS..jpg|alt=Pasos 4-7 en macOS. (Clic para alargar).|miniaturadeimagen|250x250px|Pasos 4-7 en macOS. (Clic para alargar).]]

# Descargue [https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.32-macos13-x86-64bit.dmg el ''driver'' <code>dmg</code> (8.3 MB)]<ref>Si el enlace está roto, vaya a la [https://dev.mysql.com/downloads/connector/odbc/ página oficial] de descarga y seleccione <code>macOS</code> como sistema operativo y <code>macOS 13 (x86, 64-bit)</code> como versión; a continuación seleccione el archivo <code>DMG Archive</code> y dé clic en <code>Download</code>; para confirmar la descarga dé clic en <code>No thanks, just start my download</code>. Ahora puede continuar con las instrucciones.</ref> y [https://www.odbcmanager.net/downloads/ODBC_Manager64_Installer.dmg el ''software'' <code>dmg</code> ODBC Manager (2.6 MB)].<ref>Si el enlace está roto, vaya a la [https://www.odbcmanager.net/ página oficial] de ODBC Manager y dé clic en la flecha azul para iniciar la descarga. Ahora puede continuar con las instrucciones.</ref>
# Localice el directorio en su computadora en donde se están realizando las descargas y espere hasta que finalicen.
# Dé clic sobre el ''driver'' descargado.
# Dé clic en <code>Continuar</code>.
# Dé clic en <code>Acepto</code> para confirmar el acuerdo de licencia.
# Dé clic en <code>Instalar</code> y esperé a que finalice la instalación.<ref name=":0" />
# Dé clic en <code>Cerrar</code> para concluir la instalación.
# Localice el directorio en su computadora en donde se descargó ODBC Manager y dé clic al archivo.
# '''Repita desde el paso 4''' para realizar la instalación.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible usar TLex como se describe en [[TLex#Uso de TLex|el siguiente apartado]].

== Uso de TLex ==

=== Configuración de conexión remota ===
Para el trabajo colaborativo con TLex, según como se explicó en [[TLex#Instalación de software adicional|el apartado anterior]], se requiere de una conexión remota a la base de datos [[MySQL]] que almacena los diccionarios. A continuación se describe el proceso para la configuración del ''software'' necesario para esta conexión.

==== Para Windows ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para Windows|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Data Sources. Para ello:

[[Archivo:Configuración del driver de MySQL en Windows.jpg|alt=Pasos para la configuración en Windows. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en Windows. (Clic para alargar).]]

#Abra el <code>Panel de Control</code> y seleccione <code>Herramientas administrativas</code>.
#Busque y abra <code>ODBC Data Sources (32-bit)</code>.
#Seleccione la pestaña <code>DSN de sistema</code> y dé clic en <code>Agregar</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 8.0 Unicode Driver</code> y dé clic en <code>Finalizar</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Data Source Name</code>: Lexicografia<ref name=":2">Solo utilice letras o números. No use tildes, espacios ni la letra eñe. Además, no inicie con un número. Por ejemplo, las siguientes nomenclaturas '''son erróneas''': <code>Lexicografía</code>, <code>Un diccionario en español</code>, <code>1Lexicografia</code>.</ref>
#*<code>Description</code>: Base de datos colaborativa
#*<code>TCP/IP Server</code>: 51.222.29.82
#*<code>Port</code>: 3306
#*<code>User</code>: unUsuarioMySQL
#*<code>Password</code>: laContraseñaDelUsuarioMySQL
#*<code>Database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>Test</code> para probar la conexión.
#*'''Si se realizó la conexión''', dirá <code>Connection successful</code>. A continuación:
#*#Dé clic en <code>Aceptar</code>.
#*#Dé clic en <code>OK</code> en la ventana donde ingresó la información.
#*#Dé clic en <code>Aceptar</code> para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

==== Para macOS ====
<blockquote>'''Atención:''' este procedimiento requiere tener instalado el ''software'' adicional descrito en [[TLex#Para macOS|este apartado]].</blockquote>Para configurar la conexión a la base de datos se usa el programa ODBC Manager. Para ello:

[[Archivo:Configuración del driver de MySQL en macOS.jpg|alt=Pasos para la configuración en macOS. (Clic para alargar).|miniaturadeimagen|Pasos para la configuración en macOS. (Clic para alargar).]]

#Busque y abra ODBC Manager entre sus aplicaciones.
#Seleccione la pestaña <code>DSN Sistema</code> y dé clic en <code>Añadir</code>.
#Seleccione el ''driver'' <code>MySQL ODBC 5.3 Unicode Driver</code> y dé clic en <code>OK</code>.
#Agregué la información solicitada y que '''le fue proporcionada por el administrador''',<ref name=":1" /> por ejemplo:
#*<code>Fuente de datos (DSN)</code>: Lexicografia<ref name=":2" />
#*<code>Descripción</code>: Base de datos colaborativa
#*<code>server</code>: 51.222.29.82
#*<code>port</code>: 3306
#*<code>uid</code>: unUsuarioMySQL
#*<code>pwd</code>: laContraseñaDelUsuarioMySQL
#*<code>database</code>: unaBaseDeDatosMySQL
#Dé clic en <code>OK</code> y cierre la ventana para finalizar la configuración.
#*'''Si no se realizó la conexión''', revise la información agregada e intente de nuevo. Si el problema persiste:
#*#Tome una captura de pantalla.
#*#Contacte al administrador y espere a recibir asistencia.

Si los pasos fueron realizados de manera satisfactoria, ahora es posible [[TLex#Apertura%20de%20diccionario%20colaborativo|la apertura]] o [[TLex#Creaci%C3%B3n%20de%20nuevo%20diccionario%20colaborativo|la creación]] de diccionarios colaborativos.

=== Creación de nuevo diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]].</blockquote>
=== Apertura de diccionario colaborativo ===
<blockquote>'''Atención:''' este procedimiento requiere de una conexión remota descrita en [[TLex#Configuración de conexión remota|este apartado]] y la creación de un nuevo diccionario descrita en [[TLex#Creación de nuevo diccionario colaborativo|este apartado]].</blockquote>Para la apertura de un diccionario colaborativo con TLex se siguen los siguientes pasos:
[[Archivo:Pasos para la apertura de un diccionario colaborativo.jpg|alt=Pasos para la apertura de un diccionario colaborativo.|miniaturadeimagen|Pasos para la apertura de un diccionario colaborativo.]]

# Abra TLex.
# Dé clic en <code>Open: ODBC database (with local cache)</code> de la ventana principal o de la pestaña <code>File</code>.
# Agregué la información solicitada, por ejemplo:
#* <code>ODBC data source name</code>: Lexicografia
#** En Windows corresponde al <code>Data Source Name</code> de [[TLex#Para Windows 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#** En macOS corresponde a la <code>Fuente de datos (DSN)</code> de [[TLex#Para macOS 2|este apartado]] para [[TLex#Configuración de conexión remota|la configuración de una conexión remota]].
#* <code>table name prefix</code>: tl_
#** Corresponde al prefijo que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Dé clic en <code>OK</code>.
#Ingrese el usuario y contraseña del diccionario que se determinó durante [[TLex#Creación de nuevo diccionario colaborativo|la creación del diccionario]].
#Espere unos segundos o un par de minutos para que se abra el diccionario.

== Véase también ==

* Sitio oficial de TLex. [https://tshwanedje.com/]
* Guía de usuario de TLex. [https://tshwanedje.com/docs/TLex%20Suite%20User%20Guide.pdf]
* Página de descarga del ''driver'' de [[MySQL]]. [https://dev.mysql.com/downloads/connector/odbc/]
* Sitio oficial de ODBC Manager. [https://www.odbcmanager.net/]

== Notas ==
<references />
[[Categoría:Software]]
[[Categoría:Lexicografía]]

Archivo:Pasos para la apertura de un diccionario remoto.jpg

2023-02-10T21:24:59Z

NikaZhenya:

Pasos para la apertura de un diccionario colaborativo

TLex

2023-02-10T21:09:00Z

NikaZhenya: /* Uso de TLex */

TLex

2023-02-10T21:08:35Z

NikaZhenya: /* Apertura de diccionario colaborativo */

TLex

2023-02-10T20:58:31Z

NikaZhenya: /* Configuración de conexión remota */

TLex

2023-02-10T20:57:21Z

NikaZhenya: /* Para Windows */

TLex

2023-02-10T20:56:51Z

NikaZhenya: /* Para macOS */

TLex

2023-02-10T20:55:47Z

NikaZhenya:

TLex

2023-02-10T20:55:14Z

NikaZhenya: /* Para Windows */

Archivo:Configuración del driver de MySQL en macOS.jpg

2023-02-10T20:53:32Z

NikaZhenya:

Configuración del driver de MySQL en macOS

Archivo:Configuración del driver de MySQL en Windows.jpg

2023-02-10T20:50:09Z

NikaZhenya:

Configuración del driver de MySQL en Windows.

TLex

2023-02-10T20:32:30Z

NikaZhenya: /* Véase también */

TLex

2023-02-10T20:26:07Z

NikaZhenya: /* Para Windows */

Módulo:Documentation/i18n

2023-02-10T20:12:39Z

NikaZhenya: 1 revisión importada

local format = require('Module:TNT').format
local i18n = {}

i18n['cfg-error-msg-type'] = format('I18n/Documentation', 'cfg-error-msg-type')
i18n['cfg-error-msg-empty'] = format('I18n/Documentation', 'cfg-error-msg-empty')

-- cfg['template-namespace-heading']
-- The heading shown in the template namespace.
i18n['template-namespace-heading'] = format('I18n/Documentation', 'template-namespace-heading')

-- cfg['module-namespace-heading']
-- The heading shown in the module namespace.
i18n['module-namespace-heading'] = format('I18n/Documentation', 'module-namespace-heading')

-- cfg['file-namespace-heading']
-- The heading shown in the file namespace.
i18n['file-namespace-heading'] = format('I18n/Documentation', 'file-namespace-heading')

-- cfg['other-namespaces-heading']
-- The heading shown in other namespaces.
i18n['other-namespaces-heading'] = format('I18n/Documentation', 'other-namespaces-heading')

-- cfg['view-link-display']
-- The text to display for "view" links.
i18n['view-link-display'] = format('I18n/Documentation', 'view-link-display')

-- cfg['edit-link-display']
-- The text to display for "edit" links.
i18n['edit-link-display'] = format('I18n/Documentation', 'edit-link-display')

-- cfg['history-link-display']
-- The text to display for "history" links.
i18n['history-link-display'] = format('I18n/Documentation', 'history-link-display')

-- cfg['purge-link-display']
-- The text to display for "purge" links.
i18n['purge-link-display'] = format('I18n/Documentation', 'purge-link-display')

-- cfg['create-link-display']
-- The text to display for "create" links.
i18n['create-link-display'] = format('I18n/Documentation', 'create-link-display')

return i18n

Módulo:TNT

2023-02-10T20:12:39Z

NikaZhenya: 1 revisión importada

--
-- INTRO: (!!! DO NOT RENAME THIS PAGE !!!)
-- This module allows any template or module to be copy/pasted between
-- wikis without any translation changes. All translation text is stored
-- in the global Data:*.tab pages on Commons, and used everywhere.
--
-- SEE: https://www.mediawiki.org/wiki/Multilingual_Templates_and_Modules
--
-- ATTENTION:
-- Please do NOT rename this module - it has to be identical on all wikis.
-- This code is maintained at https://www.mediawiki.org/wiki/Module:TNT
-- Please do not modify it anywhere else, as it may get copied and override your changes.
-- Suggestions can be made at https://www.mediawiki.org/wiki/Module_talk:TNT
--
-- DESCRIPTION:
-- The "msg" function uses a Commons dataset to translate a message
-- with a given key (e.g. source-table), plus optional arguments
-- to the wiki markup in the current content language.
-- Use lang=xx to set language. Example:
--
-- {{#invoke:TNT | msg
-- | I18n/Template:Graphs.tab 
-- | source-table 
-- | param1 }} 
--
--
-- The "doc" function will generate the <templatedata> parameter documentation for templates.
-- This way all template parameters can be stored and localized in a single Commons dataset.
-- NOTE: "doc" assumes that all documentation is located in Data:Templatedata/* on Commons.
--
-- {{#invoke:TNT | doc | Graph:Lines }}
-- uses https://commons.wikimedia.org/wiki/Data:Templatedata/Graph:Lines.tab
-- if the current page is Template:Graph:Lines/doc
--

local p = {}
local i18nDataset = 'I18n/Module:TNT.tab'

-- Forward declaration of the local functions
local sanitizeDataset, loadData, link, formatMessage

function p.msg(frame)
local dataset, id
local params = {}
local lang = nil
for k, v in pairs(frame.args) do
if k == 1 then
dataset = mw.text.trim(v)
elseif k == 2 then
id = mw.text.trim(v)
elseif type(k) == 'number' then
params[k - 2] = mw.text.trim(v)
elseif k == 'lang' and v ~= '_' then
lang = mw.text.trim(v)
end
end
return formatMessage(dataset, id, params, lang)
end

-- Identical to p.msg() above, but used from other lua modules
-- Parameters: name of dataset, message key, optional arguments
-- Example with 2 params: format('I18n/Module:TNT', 'error_bad_msgkey', 'my-key', 'my-dataset')
function p.format(dataset, key, ...)
local checkType = require('libraryUtil').checkType
checkType('format', 1, dataset, 'string')
checkType('format', 2, key, 'string')
return formatMessage(dataset, key, {...})
end

-- Identical to p.msg() above, but used from other lua modules with the language param
-- Parameters: language code, name of dataset, message key, optional arguments
-- Example with 2 params: formatInLanguage('es', I18n/Module:TNT', 'error_bad_msgkey', 'my-key', 'my-dataset')
function p.formatInLanguage(lang, dataset, key, ...)
local checkType = require('libraryUtil').checkType
checkType('formatInLanguage', 1, lang, 'string')
checkType('formatInLanguage', 2, dataset, 'string')
checkType('formatInLanguage', 3, key, 'string')
return formatMessage(dataset, key, {...}, lang)
end

-- Obsolete function that adds a 'c:' prefix to the first param.
-- "Sandbox/Sample.tab" -> 'c:Data:Sandbox/Sample.tab'
function p.link(frame)
return link(frame.args[1])
end

function p.doc(frame)
local dataset = 'Templatedata/' .. sanitizeDataset(frame.args[1])
return frame:extensionTag('templatedata', p.getTemplateData(dataset)) ..
formatMessage(i18nDataset, 'edit_doc', {link(dataset)})
end

function p.getTemplateData(dataset)
-- TODO: add '_' parameter once lua starts reindexing properly for "all" languages
local data = loadData(dataset)
local names = {}
for _, field in ipairs(data.schema.fields) do
table.insert(names, field.name)
end

local numOnly = true
local params = {}
local paramOrder = {}
for _, row in ipairs(data.data) do
local newVal = {}
local name = nil
for pos, columnName in ipairs(names) do
if columnName == 'name' then
name = row[pos]
else
newVal[columnName] = row[pos]
end
end
if name then
if (
(type(name) ~= "number")
and (
(type(name) ~= "string")
or not string.match(name, "^%d+$")
)
) then
numOnly = false
end
params[name] = newVal
table.insert(paramOrder, name)
end
end

-- Work around json encoding treating {"1":{...}} as an [{...}]
if numOnly then
params['zzz123']=''
end

local json = mw.text.jsonEncode({
params=params,
paramOrder=paramOrder,
description=data.description,
})

if numOnly then
json = string.gsub(json,'"zzz123":"",?', "")
end

return json
end

-- Local functions

sanitizeDataset = function(dataset)
if not dataset then
return nil
end
dataset = mw.text.trim(dataset)
if dataset == '' then
return nil
elseif string.sub(dataset,-4) ~= '.tab' then
return dataset .. '.tab'
else
return dataset
end
end

loadData = function(dataset, lang)
dataset = sanitizeDataset(dataset)
if not dataset then
error(formatMessage(i18nDataset, 'error_no_dataset', {}))
end

-- Give helpful error to thirdparties who try and copy this module.
if not mw.ext or not mw.ext.data or not mw.ext.data.get then
error(string.format([['''Missing JsonConfig extension, or not properly configured;
Cannot load https://commons.wikimedia.org/wiki/Data:%s.
See https://www.mediawiki.org/wiki/Extension:JsonConfig#Supporting_Wikimedia_templates''']], dataset))
end

local data = mw.ext.data.get(dataset, lang)

if data == false then
if dataset == i18nDataset then
-- Prevent cyclical calls
error('Missing Commons dataset ' .. i18nDataset)
else
error(formatMessage(i18nDataset, 'error_bad_dataset', {link(dataset)}))
end
end
return data
end

-- Given a dataset name, convert it to a title with the 'commons:data:' prefix
link = function(dataset)
return 'c:Data:' .. mw.text.trim(dataset or '')
end

formatMessage = function(dataset, key, params, lang)
for _, row in pairs(loadData(dataset, lang).data) do
local id, msg = unpack(row)
if id == key then
local result = mw.message.newRawMessage(msg, unpack(params or {}))
return result:plain()
end
end
if dataset == i18nDataset then
-- Prevent cyclical calls
error('Invalid message key "' .. key .. '"')
else
error(formatMessage(i18nDataset, 'error_bad_msgkey', {key, link(dataset)}))
end
end

return p

Módulo:Documentation/config

2023-02-10T20:12:39Z

NikaZhenya: 1 revisión importada

----------------------------------------------------------------------------------------------------
--
-- Configuration for Module:Documentation
--
-- Here you can set the values of the parameters and messages used in Module:Documentation to
-- localise it to your wiki and your language. Unless specified otherwise, values given here
-- should be string values.
----------------------------------------------------------------------------------------------------

local _format = require('Module:TNT').format
local function format(id)
return _format('I18n/Documentation', id)
end

local cfg = {} -- Do not edit this line.

cfg['templatestyles-scr'] = 'Module:Documentation/styles.css'

----------------------------------------------------------------------------------------------------
-- Protection template configuration
----------------------------------------------------------------------------------------------------

-- cfg['protection-template']
-- The name of the template that displays the protection icon (a padlock on enwiki).
cfg['protection-template'] = 'pp-template'

-- cfg['protection-reason-edit']
-- The protection reason for edit-protected templates to pass to
-- [[Module:Protection banner]].
cfg['protection-reason-edit'] = 'template'

--[[
-- cfg['protection-template-args']
-- Any arguments to send to the protection template. This should be a Lua table.
-- For example, if the protection template is "pp-template", and the wikitext template invocation
-- looks like "{{pp-template|docusage=yes}}", then this table should look like "{docusage = 'yes'}".
--]]
cfg['protection-template-args'] = {docusage = 'yes'}

--[[
----------------------------------------------------------------------------------------------------
-- Sandbox notice configuration
--
-- On sandbox pages the module can display a template notifying users that the current page is a
-- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
-- sandbox or not based on the value of cfg['sandbox-subpage']. The following settings configure the
-- messages that the notices contains.
----------------------------------------------------------------------------------------------------
--]]

-- cfg['sandbox-notice-image']
-- The image displayed in the sandbox notice.
cfg['sandbox-notice-image'] = '[[Image:Edit In Sandbox Icon - Color.svg|40px|alt=|link=]]'

--[[
-- cfg['sandbox-notice-pagetype-template']
-- cfg['sandbox-notice-pagetype-module']
-- cfg['sandbox-notice-pagetype-other']
-- The page type of the sandbox page. The message that is displayed depends on the current subject
-- namespace. This message is used in either cfg['sandbox-notice-blurb'] or
-- cfg['sandbox-notice-diff-blurb'].
--]]
cfg['sandbox-notice-pagetype-template'] = format('sandbox-notice-pagetype-template')
cfg['sandbox-notice-pagetype-module'] = format('sandbox-notice-pagetype-module')
cfg['sandbox-notice-pagetype-other'] = format('sandbox-notice-pagetype-other')

--[[
-- cfg['sandbox-notice-blurb']
-- cfg['sandbox-notice-diff-blurb']
-- cfg['sandbox-notice-diff-display']
-- Either cfg['sandbox-notice-blurb'] or cfg['sandbox-notice-diff-blurb'] is the opening sentence
-- of the sandbox notice. The latter has a diff link, but the former does not. $1 is the page
-- type, which is either cfg['sandbox-notice-pagetype-template'],
-- cfg['sandbox-notice-pagetype-module'] or cfg['sandbox-notice-pagetype-other'] depending what
-- namespace we are in. $2 is a link to the main template page, and $3 is a diff link between
-- the sandbox and the main template. The display value of the diff link is set by
-- cfg['sandbox-notice-compare-link-display'].
--]]
cfg['sandbox-notice-blurb'] = format('sandbox-notice-blurb')
cfg['sandbox-notice-diff-blurb'] = format('sandbox-notice-diff-blurb')
cfg['sandbox-notice-compare-link-display'] = format('sandbox-notice-compare-link-display')

--[[
-- cfg['sandbox-notice-testcases-blurb']
-- cfg['sandbox-notice-testcases-link-display']
-- cfg['sandbox-notice-testcases-run-blurb']
-- cfg['sandbox-notice-testcases-run-link-display']
-- cfg['sandbox-notice-testcases-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit. $1 is a link to the test cases page.
-- cfg['sandbox-notice-testcases-link-display'] is the display value for that link.
-- cfg['sandbox-notice-testcases-run-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit, along with a link to run it. $1 is a link to the test
-- cases page, and $2 is a link to the page to run it.
-- cfg['sandbox-notice-testcases-run-link-display'] is the display value for the link to run the test
-- cases.
--]]
cfg['sandbox-notice-testcases-blurb'] = format('sandbox-notice-testcases-blurb')
cfg['sandbox-notice-testcases-link-display'] = format('sandbox-notice-testcases-link-display')
cfg['sandbox-notice-testcases-run-blurb'] = format('sandbox-notice-testcases-run-blurb')
cfg['sandbox-notice-testcases-run-link-display'] = format('sandbox-notice-testcases-run-link-display')

-- cfg['sandbox-category']
-- A category to add to all template sandboxes.
cfg['sandbox-category'] = 'Template sandboxes'

----------------------------------------------------------------------------------------------------
-- Start box configuration
----------------------------------------------------------------------------------------------------

-- cfg['documentation-icon-wikitext']
-- The wikitext for the icon shown at the top of the template.
cfg['documentation-icon-wikitext'] = '[[File:Test Template Info-Icon - Version (2).svg|50px|link=|alt=Documentation icon]]'

----------------------------------------------------------------------------------------------------
-- Link box (end box) configuration
----------------------------------------------------------------------------------------------------

-- cfg['transcluded-from-blurb']
-- Notice displayed when the docs are transcluded from another page. $1 is a wikilink to that page.
cfg['transcluded-from-blurb'] = format('transcluded-from-blurb')

--[[
-- cfg['create-module-doc-blurb']
-- Notice displayed in the module namespace when the documentation subpage does not exist.
-- $1 is a link to create the documentation page with the preload cfg['module-preload'] and the
-- display cfg['create-link-display'].
--]]
cfg['create-module-doc-blurb'] = format('create-module-doc-blurb')

----------------------------------------------------------------------------------------------------
-- Experiment blurb configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['experiment-blurb-template']
-- cfg['experiment-blurb-module']
-- The experiment blurb is the text inviting editors to experiment in sandbox and test cases pages.
-- It is only shown in the template and module namespaces. With the default English settings, it
-- might look like this:
--
-- Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
--
-- In this example, "sandbox", "edit", "diff", "testcases", and "edit" would all be links.
--
-- There are two versions, cfg['experiment-blurb-template'] and cfg['experiment-blurb-module'], depending
-- on what namespace we are in.
--
-- Parameters:
--
-- $1 is a link to the sandbox page. If the sandbox exists, it is in the following format:
--
-- cfg['sandbox-link-display'] (cfg['sandbox-edit-link-display'] | cfg['compare-link-display'])
--
-- If the sandbox doesn't exist, it is in the format:
--
-- cfg['sandbox-link-display'] (cfg['sandbox-create-link-display'] | cfg['mirror-link-display'])
--
-- The link for cfg['sandbox-create-link-display'] link preloads the page with cfg['template-sandbox-preload']
-- or cfg['module-sandbox-preload'], depending on the current namespace. The link for cfg['mirror-link-display']
-- loads a default edit summary of cfg['mirror-edit-summary'].
--
-- $2 is a link to the test cases page. If the test cases page exists, it is in the following format:
--
-- cfg['testcases-link-display'] (cfg['testcases-edit-link-display'])
--
-- If the test cases page doesn't exist, it is in the format:
--
-- cfg['testcases-link-display'] (cfg['testcases-create-link-display'])
--
-- If the test cases page doesn't exist, the link for cfg['testcases-create-link-display'] preloads the
-- page with cfg['template-testcases-preload'] or cfg['module-testcases-preload'], depending on the current
-- namespace.
--]]
cfg['experiment-blurb-template'] = format('experiment-blurb-template')
cfg['experiment-blurb-module'] = format('experiment-blurb-module')

----------------------------------------------------------------------------------------------------
-- Sandbox link configuration
----------------------------------------------------------------------------------------------------

-- cfg['sandbox-subpage']
-- The name of the template subpage typically used for sandboxes.
cfg['sandbox-subpage'] = 'sandbox'

-- cfg['template-sandbox-preload']
-- Preload file for template sandbox pages.
cfg['template-sandbox-preload'] = 'Template:Documentation/preload-sandbox'

-- cfg['module-sandbox-preload']
-- Preload file for Lua module sandbox pages.
cfg['module-sandbox-preload'] = 'Template:Documentation/preload-module-sandbox'

-- cfg['sandbox-link-display']
-- The text to display for "sandbox" links.
cfg['sandbox-link-display'] = format('sandbox-link-display')

-- cfg['sandbox-edit-link-display']
-- The text to display for sandbox "edit" links.
cfg['sandbox-edit-link-display'] = format('sandbox-edit-link-display')

-- cfg['sandbox-create-link-display']
-- The text to display for sandbox "create" links.
cfg['sandbox-create-link-display'] = format('sandbox-create-link-display')

-- cfg['compare-link-display']
-- The text to display for "compare" links.
cfg['compare-link-display'] = format('compare-link-display')

-- cfg['mirror-edit-summary']
-- The default edit summary to use when a user clicks the "mirror" link. $1 is a wikilink to the
-- template page.
cfg['mirror-edit-summary'] = 'Create sandbox version of $1'

-- cfg['mirror-link-display']
-- The text to display for "mirror" links.
cfg['mirror-link-display'] = format('mirror-link-display')

-- cfg['mirror-link-preload']
-- The page to preload when a user clicks the "mirror" link.
cfg['mirror-link-preload'] = 'Template:Documentation/mirror'

----------------------------------------------------------------------------------------------------
-- Test cases link configuration
----------------------------------------------------------------------------------------------------

-- cfg['testcases-subpage']
-- The name of the template subpage typically used for test cases.
cfg['testcases-subpage'] = 'testcases'

-- cfg['template-testcases-preload']
-- Preload file for template test cases pages.
cfg['template-testcases-preload'] = 'Template:Documentation/preload-testcases'

-- cfg['module-testcases-preload']
-- Preload file for Lua module test cases pages.
cfg['module-testcases-preload'] = 'Template:Documentation/preload-module-testcases'

-- cfg['testcases-link-display']
-- The text to display for "testcases" links.
cfg['testcases-link-display'] = format('testcases-link-display')

-- cfg['testcases-edit-link-display']
-- The text to display for test cases "edit" links.
cfg['testcases-edit-link-display'] = format('testcases-edit-link-display')

-- cfg['testcases-create-link-display']
-- The text to display for test cases "create" links.
cfg['testcases-create-link-display'] = format('testcases-create-link-display')

----------------------------------------------------------------------------------------------------
-- Add categories blurb configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['add-categories-blurb']
-- Text to direct users to add categories to the /doc subpage. Not used if the "content" or
-- "docname fed" arguments are set, as then it is not clear where to add the categories. $1 is a
-- link to the /doc subpage with a display value of cfg['doc-link-display'].
--]]
cfg['add-categories-blurb'] = format('add-categories-blurb')

-- cfg['doc-link-display']
-- The text to display when linking to the /doc subpage.
cfg['doc-link-display'] = '/doc'

----------------------------------------------------------------------------------------------------
-- Subpages link configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['subpages-blurb']
-- The "Subpages of this template" blurb. $1 is a link to the main template's subpages with a
-- display value of cfg['subpages-link-display']. In the English version this blurb is simply
-- the link followed by a period, and the link display provides the actual text.
--]]
cfg['subpages-blurb'] = format('subpages-blurb')

--[[
-- cfg['subpages-link-display']
-- The text to display for the "subpages of this page" link. $1 is cfg['template-pagetype'],
-- cfg['module-pagetype'] or cfg['default-pagetype'], depending on whether the current page is in
-- the template namespace, the module namespace, or another namespace.
--]]
cfg['subpages-link-display'] = format('subpages-link-display')

-- cfg['template-pagetype']
-- The pagetype to display for template pages.
cfg['template-pagetype'] = format('template-pagetype')

-- cfg['module-pagetype']
-- The pagetype to display for Lua module pages.
cfg['module-pagetype'] = format('module-pagetype')

-- cfg['default-pagetype']
-- The pagetype to display for pages other than templates or Lua modules.
cfg['default-pagetype'] = format('default-pagetype')

----------------------------------------------------------------------------------------------------
-- Doc link configuration
----------------------------------------------------------------------------------------------------

-- cfg['doc-subpage']
-- The name of the subpage typically used for documentation pages.
cfg['doc-subpage'] = 'doc'

-- cfg['file-docpage-preload']
-- Preload file for documentation page in the file namespace.
cfg['file-docpage-preload'] = 'Template:Documentation/preload-filespace'

-- cfg['docpage-preload']
-- Preload file for template documentation pages in all namespaces.
cfg['docpage-preload'] = 'Template:Documentation/preload'

-- cfg['module-preload']
-- Preload file for Lua module documentation pages.
cfg['module-preload'] = 'Template:Documentation/preload-module-doc'

----------------------------------------------------------------------------------------------------
-- Print version configuration
----------------------------------------------------------------------------------------------------

-- cfg['print-subpage']
-- The name of the template subpage used for print versions.
cfg['print-subpage'] = 'Print'

-- cfg['print-link-display']
-- The text to display when linking to the /Print subpage.
cfg['print-link-display'] = '/Print'

-- cfg['print-blurb']
-- Text to display if a /Print subpage exists. $1 is a link to the subpage with a display value of cfg['print-link-display'].
cfg['print-blurb'] = format('print-blurb')

-- cfg['display-print-category']
-- Set to true to enable output of cfg['print-category'] if a /Print subpage exists.
-- This should be a boolean value (either true or false).
cfg['display-print-category'] = true

-- cfg['print-category']
-- Category to output if cfg['display-print-category'] is set to true, and a /Print subpage exists.
cfg['print-category'] = 'Templates with print versions'

----------------------------------------------------------------------------------------------------
-- HTML and CSS configuration
----------------------------------------------------------------------------------------------------

-- cfg['main-div-id']
-- The "id" attribute of the main HTML "div" tag.
cfg['main-div-id'] = 'template-documentation'

-- cfg['main-div-classes']
-- The CSS classes added to the main HTML "div" tag.
cfg['main-div-class'] = 'ts-doc-doc'
cfg['header-div-class'] = 'ts-doc-header'
cfg['heading-div-class'] = 'ts-doc-heading'
cfg['content-div-class'] = 'ts-doc-content'
cfg['footer-div-class'] = 'ts-doc-footer plainlinks'

cfg['sandbox-class'] = 'ts-doc-sandbox'

-- cfg['start-box-linkclasses']
-- The CSS classes used for the [view][edit][history] or [create] links in the start box.
cfg['start-box-linkclasses'] = 'ts-tlinks-tlinks mw-editsection-like plainlinks'

-- cfg['start-box-link-id']
-- The HTML "id" attribute for the links in the start box.
cfg['start-box-link-id'] = 'doc_editlinks'

----------------------------------------------------------------------------------------------------
-- Tracking category configuration
----------------------------------------------------------------------------------------------------

-- cfg['display-strange-usage-category']
-- Set to true to enable output of cfg['strange-usage-category'] if the module is used on a /doc subpage
-- or a /testcases subpage. This should be a boolean value (either true or false).
cfg['display-strange-usage-category'] = true

-- cfg['strange-usage-category']
-- Category to output if cfg['display-strange-usage-category'] is set to true and the module is used on a
-- /doc subpage or a /testcases subpage.
cfg['strange-usage-category'] = 'Wikipedia pages with strange ((documentation)) usage'

--[[
----------------------------------------------------------------------------------------------------
-- End configuration
--
-- Don't edit anything below this line.
----------------------------------------------------------------------------------------------------
--]]

return cfg

Módulo:Documentation

2023-02-10T20:12:39Z

NikaZhenya: 1 revisión importada

-- This module implements {{documentation}}.

-- Get required modules.
local getArgs = require('Module:Arguments').getArgs
local messageBox = require('Module:Message box')

-- Get the config table.
local cfg = mw.loadData('Module:Documentation/config')
local i18n = mw.loadData('Module:Documentation/i18n')
local p = {}

-- Often-used functions.
local ugsub = mw.ustring.gsub

----------------------------------------------------------------------------
-- Helper functions
--
-- These are defined as local functions, but are made available in the p
-- table for testing purposes.
----------------------------------------------------------------------------

local function message(cfgKey, valArray, expectType)
--[[
-- Gets a message from the cfg table and formats it if appropriate.
-- The function raises an error if the value from the cfg table is not
-- of the type expectType. The default type for expectType is 'string'.
-- If the table valArray is present, strings such as $1, $2 etc. in the
-- message are substituted with values from the table keys [1], [2] etc.
-- For example, if the message "foo-message" had the value 'Foo $2 bar $1.',
-- message('foo-message', {'baz', 'qux'}) would return "Foo qux bar baz."
--]]
local msg = cfg[cfgKey]
expectType = expectType or 'string'
if type(msg) ~= expectType then
error(require('Module:TNT').format('I18n/Documentation', 'cfg-error-msg-type', cfgKey, expectType, type(msg)), 2)
end
if not valArray then
return msg
end

local function getMessageVal(match)
match = tonumber(match)
return valArray[match] or error(require('Module:TNT').format('I18n/Documentation', 'cfg-error-msg-empty', '$' .. match, cfgKey), 4)
end

local ret = ugsub(msg, '$([1-9][0-9]*)', getMessageVal)
return ret
end

p.message = message

local function makeWikilink(page, display)
if display then
return mw.ustring.format('[[%s|%s]]', page, display)
else
return mw.ustring.format('[[%s]]', page)
end
end

p.makeWikilink = makeWikilink

local function makeCategoryLink(cat, sort)
local catns = mw.site.namespaces[14].name
return makeWikilink(catns .. ':' .. cat, sort)
end

p.makeCategoryLink = makeCategoryLink

local function makeUrlLink(url, display)
return mw.ustring.format('[%s %s]', url, display)
end

p.makeUrlLink = makeUrlLink

local function makeToolbar(...)
local ret = {}
local lim = select('#', ...)
if lim < 1 then
return nil
end
for i = 1, lim do
ret[#ret + 1] = select(i, ...)
end
return '<small style="font-style: normal;">(' .. table.concat(ret, ' | ') .. ')</small>'
end

p.makeToolbar = makeToolbar

----------------------------------------------------------------------------
-- Argument processing
----------------------------------------------------------------------------

local function makeInvokeFunc(funcName)
return function (frame)
local args = getArgs(frame, {
valueFunc = function (key, value)
if type(value) == 'string' then
value = value:match('^%s*(.-)%s*$') -- Remove whitespace.
if key == 'heading' or value ~= '' then
return value
else
return nil
end
else
return value
end
end
})
return p[funcName](args)
end
end

----------------------------------------------------------------------------
-- Load TemplateStyles
----------------------------------------------------------------------------

p.main = function(frame)
local parent = frame.getParent(frame)
local output = p._main(parent.args)
return frame:extensionTag{ name='templatestyles', args = { src= message('templatestyles-scr') } } .. output
end

----------------------------------------------------------------------------
-- Main function
----------------------------------------------------------------------------

function p._main(args)
--[[
-- This function defines logic flow for the module.
-- @args - table of arguments passed by the user
--
-- Messages:
-- 'main-div-id' --> 'template-documentation'
-- 'main-div-classes' --> 'template-documentation iezoomfix'
--]]
local env = p.getEnvironment(args)
local root = mw.html.create()
root
:wikitext(p.protectionTemplate(env))
:wikitext(p.sandboxNotice(args, env))
-- This div tag is from {{documentation/start box}}, but moving it here
-- so that we don't have to worry about unclosed tags.
:tag('div')
:attr('id', message('main-div-id'))
:addClass(message('main-div-class'))
:wikitext(p._startBox(args, env))
:wikitext(p._content(args, env))
:done()
:wikitext(p._endBox(args, env))
:wikitext(p.addTrackingCategories(env))
return tostring(root)
end

----------------------------------------------------------------------------
-- Environment settings
----------------------------------------------------------------------------

function p.getEnvironment(args)
--[[
-- Returns a table with information about the environment, including title objects and other namespace- or
-- path-related data.
-- @args - table of arguments passed by the user
--
-- Title objects include:
-- env.title - the page we are making documentation for (usually the current title)
-- env.templateTitle - the template (or module, file, etc.)
-- env.docTitle - the /doc subpage.
-- env.sandboxTitle - the /sandbox subpage.
-- env.testcasesTitle - the /testcases subpage.
-- env.printTitle - the print version of the template, located at the /Print subpage.
--
-- Data includes:
-- env.protectionLevels - the protection levels table of the title object.
-- env.subjectSpace - the number of the title's subject namespace.
-- env.docSpace - the number of the namespace the title puts its documentation in.
-- env.docpageBase - the text of the base page of the /doc, /sandbox and /testcases pages, with namespace.
-- env.compareUrl - URL of the Special:ComparePages page comparing the sandbox with the template.
--
-- All table lookups are passed through pcall so that errors are caught. If an error occurs, the value
-- returned will be nil.
--]]

local env, envFuncs = {}, {}

-- Set up the metatable. If triggered we call the corresponding function in the envFuncs table. The value
-- returned by that function is memoized in the env table so that we don't call any of the functions
-- more than once. (Nils won't be memoized.)
setmetatable(env, {
__index = function (t, key)
local envFunc = envFuncs[key]
if envFunc then
local success, val = pcall(envFunc)
if success then
env[key] = val -- Memoise the value.
return val
end
end
return nil
end
})

function envFuncs.title()
-- The title object for the current page, or a test page passed with args.page.
local title
local titleArg = args.page
if titleArg then
title = mw.title.new(titleArg)
else
title = mw.title.getCurrentTitle()
end
return title
end

function envFuncs.templateTitle()
--[[
-- The template (or module, etc.) title object.
-- Messages:
-- 'sandbox-subpage' --> 'sandbox'
-- 'testcases-subpage' --> 'testcases'
--]]
local subjectSpace = env.subjectSpace
local title = env.title
local subpage = title.subpageText
if subpage == message('sandbox-subpage') or subpage == message('testcases-subpage') then
return mw.title.makeTitle(subjectSpace, title.baseText)
else
return mw.title.makeTitle(subjectSpace, title.text)
end
end

function envFuncs.docTitle()
--[[
-- Title object of the /doc subpage.
-- Messages:
-- 'doc-subpage' --> 'doc'
--]]
local title = env.title
local docname = args[1] -- User-specified doc page.
local docpage
if docname then
docpage = docname
else
docpage = env.docpageBase .. '/' .. message('doc-subpage')
end
return mw.title.new(docpage)
end

function envFuncs.sandboxTitle()
--[[
-- Title object for the /sandbox subpage.
-- Messages:
-- 'sandbox-subpage' --> 'sandbox'
--]]
return mw.title.new(env.docpageBase .. '/' .. message('sandbox-subpage'))
end

function envFuncs.testcasesTitle()
--[[
-- Title object for the /testcases subpage.
-- Messages:
-- 'testcases-subpage' --> 'testcases'
--]]
return mw.title.new(env.docpageBase .. '/' .. message('testcases-subpage'))
end

function envFuncs.printTitle()
--[[
-- Title object for the /Print subpage.
-- Messages:
-- 'print-subpage' --> 'Print'
--]]
return env.templateTitle:subPageTitle(message('print-subpage'))
end

function envFuncs.protectionLevels()
-- The protection levels table of the title object.
return env.title.protectionLevels
end

function envFuncs.subjectSpace()
-- The subject namespace number.
return mw.site.namespaces[env.title.namespace].subject.id
end

function envFuncs.docSpace()
-- The documentation namespace number. For most namespaces this is the same as the
-- subject namespace. However, pages in the Article, File, MediaWiki or Category
-- namespaces must have their /doc, /sandbox and /testcases pages in talk space.
local subjectSpace = env.subjectSpace
if subjectSpace == 0 or subjectSpace == 6 or subjectSpace == 8 or subjectSpace == 14 then
return subjectSpace + 1
else
return subjectSpace
end
end

function envFuncs.docpageBase()
-- The base page of the /doc, /sandbox, and /testcases subpages.
-- For some namespaces this is the talk page, rather than the template page.
local templateTitle = env.templateTitle
local docSpace = env.docSpace
local docSpaceText = mw.site.namespaces[docSpace].name
-- Assemble the link. docSpace is never the main namespace, so we can hardcode the colon.
return docSpaceText .. ':' .. templateTitle.text
end

function envFuncs.compareUrl()
-- Diff link between the sandbox and the main template using [[Special:ComparePages]].
local templateTitle = env.templateTitle
local sandboxTitle = env.sandboxTitle
if templateTitle.exists and sandboxTitle.exists then
local compareUrl = mw.uri.fullUrl(
'Special:ComparePages',
{page1 = templateTitle.prefixedText, page2 = sandboxTitle.prefixedText}
)
return tostring(compareUrl)
else
return nil
end
end

return env
end

----------------------------------------------------------------------------
-- Auxiliary templates
----------------------------------------------------------------------------

function p.sandboxNotice(args, env)
--[=[
-- Generates a sandbox notice for display above sandbox pages.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- Messages:
-- 'sandbox-notice-image' --> '[[Image:Sandbox.svg|50px|alt=|link=]]'
-- 'sandbox-notice-blurb' --> 'This is the $1 for $2.'
-- 'sandbox-notice-diff-blurb' --> 'This is the $1 for $2 ($3).'
-- 'sandbox-notice-pagetype-template' --> '[[w:Wikipedia:Template test cases|template sandbox]] page'
-- 'sandbox-notice-pagetype-module' --> '[[w:Wikipedia:Template test cases|module sandbox]] page'
-- 'sandbox-notice-pagetype-other' --> 'sandbox page'
-- 'sandbox-notice-compare-link-display' --> 'diff'
-- 'sandbox-notice-testcases-blurb' --> 'See also the companion subpage for $1.'
-- 'sandbox-notice-testcases-link-display' --> 'test cases'
-- 'sandbox-category' --> 'Template sandboxes'
--]=]
local title = env.title
local sandboxTitle = env.sandboxTitle
local templateTitle = env.templateTitle
local subjectSpace = env.subjectSpace
if not (subjectSpace and title and sandboxTitle and templateTitle and mw.title.equals(title, sandboxTitle)) then
return nil
end
-- Build the table of arguments to pass to {{ombox}}. We need just two fields, "image" and "text".
local omargs = {}
omargs.image = message('sandbox-notice-image')
-- Get the text. We start with the opening blurb, which is something like
-- "This is the template sandbox for [[Template:Foo]] (diff)."
local text = ''
local frame = mw.getCurrentFrame()
local isPreviewing = frame:preprocess('{{REVISIONID}}') == '' -- True if the page is being previewed.
local pagetype
if subjectSpace == 10 then
pagetype = message('sandbox-notice-pagetype-template')
elseif subjectSpace == 828 then
pagetype = message('sandbox-notice-pagetype-module')
else
pagetype = message('sandbox-notice-pagetype-other')
end
local templateLink = makeWikilink(templateTitle.prefixedText)
local compareUrl = env.compareUrl
if isPreviewing or not compareUrl then
text = text .. message('sandbox-notice-blurb', {pagetype, templateLink})
else
local compareDisplay = message('sandbox-notice-compare-link-display')
local compareLink = makeUrlLink(compareUrl, compareDisplay)
text = text .. message('sandbox-notice-diff-blurb', {pagetype, templateLink, compareLink})
end
-- Get the test cases page blurb if the page exists. This is something like
-- "See also the companion subpage for [[Template:Foo/testcases|test cases]]."
local testcasesTitle = env.testcasesTitle
if testcasesTitle and testcasesTitle.exists then
if testcasesTitle.contentModel == "Scribunto" then
local testcasesLinkDisplay = message('sandbox-notice-testcases-link-display')
local testcasesRunLinkDisplay = message('sandbox-notice-testcases-run-link-display')
local testcasesLink = makeWikilink(testcasesTitle.prefixedText, testcasesLinkDisplay)
local testcasesRunLink = makeWikilink(testcasesTitle.talkPageTitle.prefixedText, testcasesRunLinkDisplay)
text = text .. '<br />' .. message('sandbox-notice-testcases-run-blurb', {testcasesLink, testcasesRunLink})
else
local testcasesLinkDisplay = message('sandbox-notice-testcases-link-display')
local testcasesLink = makeWikilink(testcasesTitle.prefixedText, testcasesLinkDisplay)
text = text .. '<br />' .. message('sandbox-notice-testcases-blurb', {testcasesLink})
end
end
-- Add the sandbox to the sandbox category.
text = text .. makeCategoryLink(message('sandbox-category'))
omargs.text = text
omargs.class = message('sandbox-class')
local ret = '<div style="clear: both;"></div>'
ret = ret .. messageBox.main('ombox', omargs)
return ret
end

function p.protectionTemplate(env)
-- Generates the padlock icon in the top right.
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
-- Messages:
-- 'protection-template' --> 'pp-template'
-- 'protection-template-args' --> {docusage = 'yes'}
local title = env.title
local protectionLevels
local protectionTemplate = message('protection-template')
local namespace = title.namespace
if not (protectionTemplate and (namespace == 10 or namespace == 828)) then
-- Don't display the protection template if we are not in the template or module namespaces.
return nil
end
protectionLevels = env.protectionLevels
if not protectionLevels then
return nil
end
local editLevels = protectionLevels.edit
local moveLevels = protectionLevels.move
if moveLevels and moveLevels[1] == 'sysop' or editLevels and editLevels[1] then
-- The page is full-move protected, or full, template, or semi-protected.
local frame = mw.getCurrentFrame()
return frame:expandTemplate{title = protectionTemplate, args = message('protection-template-args', nil, 'table')}
else
return nil
end
end

----------------------------------------------------------------------------
-- Start box
----------------------------------------------------------------------------

p.startBox = makeInvokeFunc('_startBox')

function p._startBox(args, env)
--[[
-- This function generates the start box.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- The actual work is done by p.makeStartBoxLinksData and p.renderStartBoxLinks which make
-- the [view] [edit] [history] [purge] links, and by p.makeStartBoxData and p.renderStartBox
-- which generate the box HTML.
--]]
env = env or p.getEnvironment(args)
local links
local content = args.content
if not content then
-- No need to include the links if the documentation is on the template page itself.
local linksData = p.makeStartBoxLinksData(args, env)
if linksData then
links = p.renderStartBoxLinks(linksData)
end
end
-- Generate the start box html.
local data = p.makeStartBoxData(args, env, links)
if data then
return p.renderStartBox(data)
else
-- User specified no heading.
return nil
end
end

function p.makeStartBoxLinksData(args, env)
--[[
-- Does initial processing of data to make the [view] [edit] [history] [purge] links.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- Messages:
-- 'view-link-display' --> 'view'
-- 'edit-link-display' --> 'edit'
-- 'history-link-display' --> 'history'
-- 'purge-link-display' --> 'purge'
-- 'file-docpage-preload' --> 'Template:Documentation/preload-filespace'
-- 'module-preload' --> 'Template:Documentation/preload-module-doc'
-- 'docpage-preload' --> 'Template:Documentation/preload'
-- 'create-link-display' --> 'create'
--]]
local subjectSpace = env.subjectSpace
local title = env.title
local docTitle = env.docTitle
if not title or not docTitle then
return nil
end
if docTitle.isRedirect then
docTitle = docTitle.redirectTarget
end

local data = {}
data.title = title
data.docTitle = docTitle
-- View, display, edit, and purge links if /doc exists.
data.viewLinkDisplay = i18n['view-link-display']
data.editLinkDisplay = i18n['edit-link-display']
data.historyLinkDisplay = i18n['history-link-display']
data.purgeLinkDisplay = i18n['purge-link-display']
-- Create link if /doc doesn't exist.
local preload = args.preload
if not preload then
if subjectSpace == 6 then -- File namespace
preload = message('file-docpage-preload')
elseif subjectSpace == 828 then -- Module namespace
preload = message('module-preload')
else
preload = message('docpage-preload')
end
end
data.preload = preload
data.createLinkDisplay = i18n['create-link-display']
return data
end

function p.renderStartBoxLinks(data)
--[[
-- Generates the [view][edit][history][purge] or [create] links from the data table.
-- @data - a table of data generated by p.makeStartBoxLinksData
--]]

local function escapeBrackets(s)
-- Escapes square brackets with HTML entities.
s = s:gsub('%[', '[') -- Replace square brackets with HTML entities.
s = s:gsub('%]', ']')
return s
end

local ret
local docTitle = data.docTitle
local title = data.title
if docTitle.exists then
local viewLink = makeWikilink(docTitle.prefixedText, data.viewLinkDisplay)
local editLink = makeUrlLink(docTitle:fullUrl{action = 'edit'}, data.editLinkDisplay)
local historyLink = makeUrlLink(docTitle:fullUrl{action = 'history'}, data.historyLinkDisplay)
local purgeLink = makeUrlLink(title:fullUrl{action = 'purge'}, data.purgeLinkDisplay)
ret = '[%s] [%s] [%s] [%s]'
ret = escapeBrackets(ret)
ret = mw.ustring.format(ret, viewLink, editLink, historyLink, purgeLink)
else
local createLink = makeUrlLink(docTitle:fullUrl{action = 'edit', preload = data.preload}, data.createLinkDisplay)
ret = '[%s]'
ret = escapeBrackets(ret)
ret = mw.ustring.format(ret, createLink)
end
return ret
end

function p.makeStartBoxData(args, env, links)
--[=[
-- Does initial processing of data to pass to the start-box render function, p.renderStartBox.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
-- @links - a string containing the [view][edit][history][purge] links - could be nil if there's an error.
--
-- Messages:
-- 'documentation-icon-wikitext' --> '[[File:Test Template Info-Icon - Version (2).svg|50px|link=|alt=Documentation icon]]'
-- 'template-namespace-heading' --> 'Template documentation'
-- 'module-namespace-heading' --> 'Module documentation'
-- 'file-namespace-heading' --> 'Summary'
-- 'other-namespaces-heading' --> 'Documentation'
-- 'start-box-linkclasses' --> 'mw-editsection-like plainlinks'
-- 'start-box-link-id' --> 'doc_editlinks'
-- 'testcases-create-link-display' --> 'create'
--]=]
local subjectSpace = env.subjectSpace
if not subjectSpace then
-- Default to an "other namespaces" namespace, so that we get at least some output
-- if an error occurs.
subjectSpace = 2
end
local data = {}

-- Heading
local heading = args.heading -- Blank values are not removed.
if heading == '' then
-- Don't display the start box if the heading arg is defined but blank.
return nil
end
if heading then
data.heading = heading
elseif subjectSpace == 10 then -- Template namespace
data.heading = i18n['template-namespace-heading']
elseif subjectSpace == 828 then -- Module namespace
data.heading = i18n['module-namespace-heading']
elseif subjectSpace == 6 then -- File namespace
data.heading = i18n['file-namespace-heading']
else
data.heading = i18n['other-namespaces-heading']
end

-- Data for the [view][edit][history][purge] or [create] links.
if links then
data.linksClass = message('start-box-linkclasses')
data.linksId = message('start-box-link-id')
data.links = links
end

return data
end

function p.renderStartBox(data)
-- Renders the start box html.
-- @data - a table of data generated by p.makeStartBoxData.
local sbox = mw.html.create('div')
sbox
:addClass(message('header-div-class'))
:tag('div')
:addClass(message('heading-div-class'))
:wikitext(data.heading)
local links = data.links
if links then
sbox
:tag('div')
:addClass(data.linksClass)
:attr('id', data.linksId)
:wikitext(links)
end
return tostring(sbox)
end

----------------------------------------------------------------------------
-- Documentation content
----------------------------------------------------------------------------

p.content = makeInvokeFunc('_content')

function p._content(args, env)
-- Displays the documentation contents
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
env = env or p.getEnvironment(args)
local docTitle = env.docTitle
local content = args.content
if not content and docTitle and docTitle.exists then
content = args._content or mw.getCurrentFrame():expandTemplate{title = docTitle}
end
-- The line breaks below are necessary so that "=== Headings ===" at the start and end
-- of docs are interpreted correctly.
local cbox = mw.html.create('div')
cbox
:addClass(message('content-div-class'))
:wikitext('\n' .. (content or '') .. '\n')
return tostring(cbox)
end

p.contentTitle = makeInvokeFunc('_contentTitle')

function p._contentTitle(args, env)
env = env or p.getEnvironment(args)
local docTitle = env.docTitle
if not args.content and docTitle and docTitle.exists then
return docTitle.prefixedText
else
return ''
end
end

----------------------------------------------------------------------------
-- End box
----------------------------------------------------------------------------

p.endBox = makeInvokeFunc('_endBox')

function p._endBox(args, env)
--[=[
-- This function generates the end box (also known as the link box).
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--]=]

-- Get environment data.
env = env or p.getEnvironment(args)
local subjectSpace = env.subjectSpace
local docTitle = env.docTitle
if not subjectSpace or not docTitle then
return nil
end

-- Check whether we should output the end box at all. Add the end
-- box by default if the documentation exists or if we are in the
-- user, module or template namespaces.
local linkBox = args['link box']
if linkBox == 'off'
or not (
docTitle.exists
or subjectSpace == 2
or subjectSpace == 828
or subjectSpace == 10
)
then
return nil
end

-- Assemble the footer text field.
local text = ''
if linkBox then
text = text .. linkBox
else
text = text .. (p.makeDocPageBlurb(args, env) or '') -- "This documentation is transcluded from [[Foo]]."
if subjectSpace == 2 or subjectSpace == 10 or subjectSpace == 828 then
-- We are in the user, template or module namespaces.
-- Add sandbox and testcases links.
-- "Editors can experiment in this template's sandbox and testcases pages."
text = text .. (p.makeExperimentBlurb(args, env) or '')
text = text .. '<br />'
if not args.content and not args[1] then
-- "Please add categories to the /doc subpage."
-- Don't show this message with inline docs or with an explicitly specified doc page,
-- as then it is unclear where to add the categories.
text = text .. (p.makeCategoriesBlurb(args, env) or '')
end
text = text .. ' ' .. (p.makeSubpagesBlurb(args, env) or '') --"Subpages of this template"
local printBlurb = p.makePrintBlurb(args, env) -- Two-line blurb about print versions of templates.
if printBlurb then
text = text .. '<br />' .. printBlurb
end
end
end

local ebox = mw.html.create('div')
ebox
:addClass(message('footer-div-class'))
:wikitext(text)
return tostring(ebox)
end

function p.makeDocPageBlurb(args, env)
--[=[
-- Makes the blurb "This documentation is transcluded from [[Template:Foo]] (edit, history)".
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- Messages:
-- 'edit-link-display' --> 'edit'
-- 'history-link-display' --> 'history'
-- 'transcluded-from-blurb' -->
-- 'The above [[w:Wikipedia:Template documentation|documentation]]
-- is [[w:Wikipedia:Transclusion|transcluded]] from $1.'
-- 'module-preload' --> 'Template:Documentation/preload-module-doc'
-- 'create-link-display' --> 'create'
-- 'create-module-doc-blurb' -->
-- 'You might want to $1 a documentation page for this [[w:Wikipedia:Lua|Scribunto module]].'
--]=]
local docTitle = env.docTitle
if not docTitle or args.content then
return nil
end
local ret
if docTitle.exists then
-- /doc exists; link to it.
local docLink = makeWikilink(docTitle.prefixedText)
local editUrl = docTitle:fullUrl{action = 'edit'}
local editDisplay = i18n['edit-link-display']
local editLink = makeUrlLink(editUrl, editDisplay)
local historyUrl = docTitle:fullUrl{action = 'history'}
local historyDisplay = i18n['history-link-display']
local historyLink = makeUrlLink(historyUrl, historyDisplay)
ret = message('transcluded-from-blurb', {docLink})
.. ' '
.. makeToolbar(editLink, historyLink)
.. '<br />'
elseif env.subjectSpace == 828 then
-- /doc does not exist; ask to create it.
local createUrl = docTitle:fullUrl{action = 'edit', preload = message('module-preload')}
local createDisplay = i18n['create-link-display']
local createLink = makeUrlLink(createUrl, createDisplay)
ret = message('create-module-doc-blurb', {createLink})
.. '<br />'
end
return ret
end

function p.makeExperimentBlurb(args, env)
--[[
-- Renders the text "Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages."
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- Messages:
-- 'sandbox-link-display' --> 'sandbox'
-- 'sandbox-edit-link-display' --> 'edit'
-- 'compare-link-display' --> 'diff'
-- 'module-sandbox-preload' --> 'Template:Documentation/preload-module-sandbox'
-- 'template-sandbox-preload' --> 'Template:Documentation/preload-sandbox'
-- 'sandbox-create-link-display' --> 'create'
-- 'mirror-edit-summary' --> 'Create sandbox version of $1'
-- 'mirror-link-display' --> 'mirror'
-- 'mirror-link-preload' --> 'Template:Documentation/mirror'
-- 'sandbox-link-display' --> 'sandbox'
-- 'testcases-link-display' --> 'testcases'
-- 'testcases-edit-link-display'--> 'edit'
-- 'template-sandbox-preload' --> 'Template:Documentation/preload-sandbox'
-- 'testcases-create-link-display' --> 'create'
-- 'testcases-link-display' --> 'testcases'
-- 'testcases-edit-link-display' --> 'edit'
-- 'module-testcases-preload' --> 'Template:Documentation/preload-module-testcases'
-- 'template-testcases-preload' --> 'Template:Documentation/preload-testcases'
-- 'experiment-blurb-module' --> 'Editors can experiment in this module's $1 and $2 pages.'
-- 'experiment-blurb-template' --> 'Editors can experiment in this template's $1 and $2 pages.'
--]]
local subjectSpace = env.subjectSpace
local templateTitle = env.templateTitle
local sandboxTitle = env.sandboxTitle
local testcasesTitle = env.testcasesTitle
local templatePage = templateTitle.prefixedText
if not subjectSpace or not templateTitle or not sandboxTitle or not testcasesTitle then
return nil
end
-- Make links.
local sandboxLinks, testcasesLinks
if sandboxTitle.exists then
local sandboxPage = sandboxTitle.prefixedText
local sandboxDisplay = message('sandbox-link-display')
local sandboxLink = makeWikilink(sandboxPage, sandboxDisplay)
local sandboxEditUrl = sandboxTitle:fullUrl{action = 'edit'}
local sandboxEditDisplay = message('sandbox-edit-link-display')
local sandboxEditLink = makeUrlLink(sandboxEditUrl, sandboxEditDisplay)
local compareUrl = env.compareUrl
local compareLink
if compareUrl then
local compareDisplay = message('compare-link-display')
compareLink = makeUrlLink(compareUrl, compareDisplay)
end
sandboxLinks = sandboxLink .. ' ' .. makeToolbar(sandboxEditLink, compareLink)
else
local sandboxPreload
if subjectSpace == 828 then
sandboxPreload = message('module-sandbox-preload')
else
sandboxPreload = message('template-sandbox-preload')
end
local sandboxCreateUrl = sandboxTitle:fullUrl{action = 'edit', preload = sandboxPreload}
local sandboxCreateDisplay = message('sandbox-create-link-display')
local sandboxCreateLink = makeUrlLink(sandboxCreateUrl, sandboxCreateDisplay)
local mirrorSummary = message('mirror-edit-summary', {makeWikilink(templatePage)})
local mirrorPreload = message('mirror-link-preload')
local mirrorUrl = sandboxTitle:fullUrl{action = 'edit', preload = mirrorPreload, summary = mirrorSummary}
local mirrorDisplay = message('mirror-link-display')
local mirrorLink = makeUrlLink(mirrorUrl, mirrorDisplay)
sandboxLinks = message('sandbox-link-display') .. ' ' .. makeToolbar(sandboxCreateLink, mirrorLink)
end
if testcasesTitle.exists then
local testcasesPage = testcasesTitle.prefixedText
local testcasesDisplay = message('testcases-link-display')
local testcasesLink = makeWikilink(testcasesPage, testcasesDisplay)
local testcasesEditUrl = testcasesTitle:fullUrl{action = 'edit'}
local testcasesEditDisplay = message('testcases-edit-link-display')
local testcasesEditLink = makeUrlLink(testcasesEditUrl, testcasesEditDisplay)
testcasesLinks = testcasesLink .. ' ' .. makeToolbar(testcasesEditLink)
else
local testcasesPreload
if subjectSpace == 828 then
testcasesPreload = message('module-testcases-preload')
else
testcasesPreload = message('template-testcases-preload')
end
local testcasesCreateUrl = testcasesTitle:fullUrl{action = 'edit', preload = testcasesPreload}
local testcasesCreateDisplay = message('testcases-create-link-display')
local testcasesCreateLink = makeUrlLink(testcasesCreateUrl, testcasesCreateDisplay)
testcasesLinks = message('testcases-link-display') .. ' ' .. makeToolbar(testcasesCreateLink)
end
local messageName
if subjectSpace == 828 then
messageName = 'experiment-blurb-module'
else
messageName = 'experiment-blurb-template'
end
return message(messageName, {sandboxLinks, testcasesLinks})
end

function p.makeCategoriesBlurb(args, env)
--[[
-- Generates the text "Please add categories to the /doc subpage."
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
-- Messages:
-- 'doc-link-display' --> '/doc'
-- 'add-categories-blurb' --> 'Please add categories to the $1 subpage.'
--]]
local docTitle = env.docTitle
if not docTitle then
return nil
end
local docPathLink = makeWikilink(docTitle.prefixedText, message('doc-link-display'))
return message('add-categories-blurb', {docPathLink})
end

function p.makeSubpagesBlurb(args, env)
--[[
-- Generates the "Subpages of this template" link.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment

-- Messages:
-- 'template-pagetype' --> 'template'
-- 'module-pagetype' --> 'module'
-- 'default-pagetype' --> 'page'
-- 'subpages-link-display' --> 'Subpages of this $1'
--]]
local subjectSpace = env.subjectSpace
local templateTitle = env.templateTitle
if not subjectSpace or not templateTitle then
return nil
end
local pagetype
if subjectSpace == 10 then
pagetype = message('template-pagetype')
elseif subjectSpace == 828 then
pagetype = message('module-pagetype')
else
pagetype = message('default-pagetype')
end
local subpagesLink = makeWikilink(
'Special:PrefixIndex/' .. templateTitle.prefixedText .. '/',
message('subpages-link-display', {pagetype})
)
return message('subpages-blurb', {subpagesLink})
end

function p.makePrintBlurb(args, env)
--[=[
-- Generates the blurb displayed when there is a print version of the template available.
-- @args - a table of arguments passed by the user
-- @env - environment table containing title objects, etc., generated with p.getEnvironment
--
-- Messages:
-- 'print-link-display' --> '/Print'
-- 'print-blurb' --> 'A [[Help:Books/for experts#Improving the book layout|print version]]'
-- .. ' of this template exists at $1.'
-- .. ' If you make a change to this template, please update the print version as well.'
-- 'display-print-category' --> true
-- 'print-category' --> 'Templates with print versions'
--]=]
local printTitle = env.printTitle
if not printTitle then
return nil
end
local ret
if printTitle.exists then
local printLink = makeWikilink(printTitle.prefixedText, message('print-link-display'))
ret = message('print-blurb', {printLink})
local displayPrintCategory = message('display-print-category', nil, 'boolean')
if displayPrintCategory then
ret = ret .. makeCategoryLink(message('print-category'))
end
end
return ret
end

----------------------------------------------------------------------------
-- Tracking categories
----------------------------------------------------------------------------

function p.addTrackingCategories(env)
--[[
-- Check if {{documentation}} is transcluded on a /doc or /testcases page.
-- @env - environment table containing title objects, etc., generated with p.getEnvironment

-- Messages:
-- 'display-strange-usage-category' --> true
-- 'doc-subpage' --> 'doc'
-- 'testcases-subpage' --> 'testcases'
-- 'strange-usage-category' --> 'Wikipedia pages with strange ((documentation)) usage'
--
-- /testcases pages in the module namespace are not categorised, as they may have
-- {{documentation}} transcluded automatically.
--]]
local title = env.title
local subjectSpace = env.subjectSpace
if not title or not subjectSpace then
return nil
end
local subpage = title.subpageText
local ret = ''
if message('display-strange-usage-category', nil, 'boolean')
and (
subpage == message('doc-subpage')
or subjectSpace ~= 828 and subpage == message('testcases-subpage')
)
then
ret = ret .. makeCategoryLink(message('strange-usage-category'))
end
return ret
end

return p

Plantilla:Documentation/en

2023-02-10T20:12:39Z

NikaZhenya: 1 revisión importada

<noinclude>
<languages/>
</noinclude><includeonly>{{#invoke:documentation|main|_content={{ {{#invoke:documentation|contentTitle}}}}}}</includeonly><noinclude>
{{documentation|content=

{{Lua|Module:Documentation}}
This template automatically displays a documentation box like the one you are seeing now, of which the content is sometimes transcluded from another page.
It is intended for pages which are [[Special:MyLanguage/Help:Transclusion|transcluded]] in other pages, i.e. templates, whether in the template namespace or not.

==Usage==

===Customizing display===

Overrides exist to customize the output in special cases:
* <nowiki>{{</nowiki>documentation{{!}}'''heading'''=<nowiki>}}</nowiki> - change the text of the "documentation" heading. If this is set to blank, the entire heading line (including the first [edit] link) will also disappear.

==Rationale==
This template allows any page to use any documentation page, and makes it possible to protect templates while allowing anyone to edit the template's documentation and categories.
It also reduces server resources by circumventing a [[w:Wikipedia:Template limits|technical limitation of templates]] (see a [[:en:Special:Diff/69888944|developer's explanation]]).

==See also==
* [[w:Template:Documentation subpage]]
* {{tim|Documentation}}
* [[w:Wikipedia:Template documentation]]

}}
[[Category:Formatting templates{{#translation:}}|Template documentation]]
[[Category:Template documentation{{#translation:}}| ]]
</noinclude><includeonly>{{#if:{{{content|}}}|
[[Category:Template documentation pages{{#translation:}}]]
}}</includeonly>