Personalizar Lyx

Personalizar LYX: Caractersticas para
el usuario avanzado
por el equipo LYX*
Versin 2.0.x
31 de diciembre de 2012
* Si
tienes correcciones o comentarios, envalos, por favor, a la lista de correo de Documentacin de LYX, [email protected]. Incluye [Customization] en la cabecera de
asunto, y enva una cc al actual mantenedor de este documento, Richard Heck <[email protected]>.
ndice general
1. Introduccin
2. Archivos de configuracin de LYX

2.1. Qu hay en LYXDir? . . . . . . . . . . . . . . .
2.1.1. Archivos generados automticamente . .
2.1.2. Directorios . . . . . . . . . . . . . . . . .
2.1.3. Archivos que no necesitan modificaciones
2.1.4. Otros archivos en un par de lneas... . . .
2.2. Directorio de configuracin personal . . . . . . .
2.3. Ejecutar LYX con mltiples configuraciones . . .
.
.
.
.
.
.
.
3
3
3
4
5
5
5
6
3. El dilogo Preferencias
3.1. Formatos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2. Copiadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3. Convertidores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
7
8
9
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4. Internacionalizacin de LYX
4.1. Traduccin de LYX . . . . . . . . . . . . . . . . . . . . . . .
4.1.1. Traduccin de la interfaz grfica de usuario (mensajes
4.1.1.1. Mensajes ambiguos . . . . . . . . . . . . . .
4.1.2. Traduccin de la documentacin . . . . . . . . . . . .
4.2. Cosas sobre teclados internacionales . . . . . . . . . . . . . .
4.2.1. El archivo .kmap . . . . . . . . . . . . . . . . . . . .
4.2.2. El archivo .cdef . . . . . . . . . . . . . . . . . . . . .
4.2.3. Teclas muertas . . . . . . . . . . . . . . . . . . . . .
4.2.4. Guardar la configuracin de idioma . . . . . . . . . .
5. Instalacin de clases, formatos . . .
5.1. Instalacin de nuevos archivos LATEX . . . .
5.2. Tipos de archivos de formato . . . . . . . .
5.2.1. Mdulos de formato . . . . . . . . .
5.2.1.1. Formato local . . . . . . . .
5.2.2. Formato para archivos .sty . . . . . .
5.2.3. Formato para archivos .cls . . . . . .
5.2.4. Creacin de plantillas . . . . . . . . .
5.2.5. Actualizacin de antiguos archivos de
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
formato
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11
. . . . . 11
de texto) 11
. . . . . 12
. . . . . 12
. . . . . 13
. . . . . 14
. . . . . 15
. . . . . 16
. . . . . 16
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
17
18
19
20
21
21
23
23
24
ndice general
5.3. Estructura del archivo layout . . . . . . . . . . . . . . . . . . . . . .
5.3.1. Declaracin de la clase de documento . . . . . . . . . . . . . .
5.3.2. Declaracin de un mdulo . . . . . . . . . . . . . . . . . . . .
5.3.3. Nmero de formatoLa primera lnea no comentada de cualquier
archivo layout, inc o module debe contener el nmero de
formato del archivo: . . . . . . . . . . . . . . . . . . . . . . .
5.3.4. Parmetros generales de clases de texto . . . . . . . . . . . . .
5.3.5. Seccin ClassOptions . . . . . . . . . . . . . . . . . . . . . .
5.3.6. Estilos de prrafo . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.7. Internacionalizacin de estilos de prrafo . . . . . . . . . . . .
5.3.8. Flotantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.9. Recuadros flexibles y formato del recuadro . . . . . . . . . . .
5.3.10. Contadores . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.11. Descripcin de las tipografas . . . . . . . . . . . . . . . . . .
5.3.12. Descripcin del formato de cita . . . . . . . . . . . . . . . . .
5.4. Etiquetas para la salida XHTML . . . . . . . . . . . . . . . . . . . .
5.4.1. Estilos de prrafo . . . . . . . . . . . . . . . . . . . . . . . . .
5.4.2. Recuadros XHTML . . . . . . . . . . . . . . . . . . . . . . . .
5.4.3. Flotantes XHTML . . . . . . . . . . . . . . . . . . . . . . . .
5.4.4. Formato de la Bibliografa . . . . . . . . . . . . . . . . . . . .
5.4.5. CSS generado por LYX . . . . . . . . . . . . . . . . . . . . . .
6. Insercin de material externo
6.1. Cmo funciona? . . . . . . . . . . . . . . . . . .
6.2. El archivo de configuracin de plantillas externas
6.2.1. La cabecera de la plantilla . . . . . . . . .
6.2.2. La seccin Format . . . . . . . . . . . . .
6.2.3. Definiciones de prembulo . . . . . . . . .
6.3. El mecanismo de sustitucin . . . . . . . . . . . .
6.4. Discusin sobre seguridad . . . . . . . . . . . . .
ii
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
24
25
26
27
27
30
31
38
39
40
43
44
45
46
47
49
50
51
51
53
53
54
55
56
57
58
60
1 Introduccin
Este manual trata de las caractersticas de LYX que pueden ser modificadas por el
usuario. En l abordamos temas como atajos de teclado, opciones de vista previa en
pantalla, opciones de impresora, envo de comandos mediante LYX Server, internacionalizacin, instalacin de nuevas clases de LATEX y de formatos de LYX, etc. Seguro
que no podemos aspirar a tratar todo lo que se puede cambiar, nuestross desarrolladores aaden caractersticas nuevas ms deprisa de lo que las podemos documentar
pero explicaremos las modificaciones ms comunes y y esperamos orientarte en la direccin correcta para algunas ms desconocidas.
2 Archivos de configuracin de LYX

Este captulo tiene por objetivo ayudarte a encontrar tu camino a travs de los
archivos de configuracin de LYX. Antes de seguir leyendo deberas encontrar donde
estn los directorios de bibliotecas y de usuario, consultando Ayuda . Acerca de LYX.
El directorio de bibliotecas es el sitio en el que LYX tiene sus archivos de configuracin
de sistema; el directorio de usuario es donde puedes colocar tus versiones modificadas.
En este documento, al primero lo denominaremos LYXDir y al segundo UserDir.
2.1.
Qu hay en LYXDir?
LYXDir y sus subdirectorios contienen archivos que pueden emplearse para personalizar el comportamiento de LYX. Puedes cambiar muchos de ellos desde dentro
mismo de LYX mediante el dilogo Herramientas . Preferencias. La mayor parte de las
adaptaciones personales que querrs hacer en LYX se puede hacer en este dilogo.
Sin embargo, muchos otros aspectos internos de LYX pueden cambiarse modificando
los archivos en LYXDir. Estos archivos pertenecen a diversas categoras, descritas en
las siguientes subsecciones.
2.1.1.
Archivos generados automticamente
Los archivos que se encuentran en UserDir se generan al configurar LYX. Contienen

varios valores predeterminados que se obtienen por inspeccin. En general, no es
buena idea modificarlos, puesto que podran ser sobrescritos en cualquier momento.
lyxrc.defaults contiene valores predeterminados para varioscomandos.
packages.lst contiene la lista de paquetes que han sido reconocidos por LYX. No
es utilizada por el propio LYX, pero la informacin extraida, y otras cosas
estn disponibles en Ayuda . Configuracin de LATEX.
textclass.lst la lista de clases de textos encontradas en los directorios layout/,
junto con las clases de documentos LATEX y su descripcin.
lyxmodules.lst la lista de mdulos de formato encontradas en los directorios layout/.
*files.lst lista de varios tipos de archivos relacionados con LATEX encontrados en
el sistema.

doc/LATEXConfig.lyx es generado automticamente durante la configuracin a partir
del archivo LATEXConfig.lyx.in. Contiene informacin sobre la configuracin de LATEX.
2.1.2.
Directorios
Estos directorios estn duplicados en LYXDir y UserDir. Si determinado archivo

existe en ambos sitios, se usar el de UserDir.
bind/
este directorio contiene archivos con la extensin .bind que definen las
combinaciones de teclas usadas en LYX. Si ah existe una versin nacional
de un archivo bind llamado $LANG_xxx.bind, sta se usar en primer
lugar.
clipart/ contiene archivos grficos que pueden ser incluidos en documentos.

doc/
contiene archivos de documentacin de LYX (incluido ste que ests leyendo). El archivo LATEXConfig.lyx merece atencin especial, como se mencion antes. Si existe una versin nacional del documento de ayuda en el
subdirectorio doc/xx, ste se usar en primer lugar. Vase 4 para detalles.
examples/ contiene archivos de ejemplo que describen el uso de algunas caractersticas. Se puede acceder a ellos con el botn Ejemplos en el buscador de
archivos.
images/
contiene archivos de imagen que se usan en el dilogo Documento . Configuracin.

Contiene adems los iconos de las barras de herramientas y las enseas
de LYX mostradas en su inicio.
kbd/
contiene archivos de mapas de teclado. Vase 4.2 para detalles.
layouts/ contiene las clases de textos y los archivos de los mdulos descritos en 5.
lyx2lyx
contiene los guiones de Python lyx2lyx para convertir entre versiones

de LYX. Pueden ejecutarse en lnea de comandos si, digamos, quieres
convertir ficheros por lotes.
scripts/ contiene algunos archivos que demuestran las capacidades de la caracterstica Plantilla externa. Tambin contiene algunos guiones usados por el
propio LYX.
templates/ contiene los archivos de plantillas estndar de LYX descritas en ??.
ui/
contiene archivos con la extensin .ui que definen la interfaz de usuario

de LYX. Esto es, archivos que definen qu tems aparecen en qu mens
y barras de herramientas.
2.2 Directorio de configuracin personal
2.1.3.
Archivos que no necesitan modificaciones
Estos archivos son utilizados internamente por LYX y generalmente no deben ser
modificados sino por los desarrolladores.
CREDITS
contiene la lista de desarrolladores de LYX. Se muestra con el men Ayuda . Acerca de LYX.
chkconfig.ltx es un guin de LATEX usado durante el proceso de configuracin. No

lo ejecutes directamente.
configure.py es el guin utilizado para la reconfiguracin de LYX. Genera los archivos de configuracin en el directorio desde el que se ha ejecutado.
2.1.4.
Otros archivos en un par de lneas...
encodings contiene tablas que describen cmo los distintos cdigos de caracteres se
transcriben a Unicode.
external_templates contiene las plantillas disponibles para la caracterstica Material externo.
languages contiene una lista de los idiomas actualmente soportados por LYX.
2.2.
Directorio de configuracin personal
Aunque uses LYX como usuario sin privilegios, puedes adaptar su configuracin a
tus necesidades. El directorio UserDir contiene todos los archivos de configuracin
personal. Es el directorio especificado como Directorio del usuario en Ayuda . Acerca
de LYX. Este directorio se usa como espejo de LYXDir, que quiere decir que cada archivo
en UserDir es un equivalente del correspondiente archivo en LYXDir. Cualquiera de
los archivos de configuracin descritos en las secciones anteriores puede estar en el
directorio global del sistema, en cuyo caso afectar a todos los usuarios, y en tu
directorio local para tu propio uso.
Para clarificar las cosas vamos a poner unos ejemplos:
Las preferencias establecidas en el dilogo Herramientas . Preferencias se guardan
en un archivo preferences en UserDir.
Si reconfiguras mediante Herramientas . Reconfigurar, LYX ejecuta el guin
configure.py, y los archivos resultantes se escriben en tu directorio de usuario. Esto significa que cualquier archivo adicional de clase de texto que pudieras
haber aadido en UserDir/layouts se sumar a la lista de clases en el dilogo
Documento . Configuracin.

Si consigues alguna documentacin actualizada del sitio de LYX y no puedes
instalarla porque no tienes permisos para administrar tu sistema, solo has de
copiar los archivos en UserDir/doc/XX y las entradas del men Ayuda los
abrirn!
2.3.
Ejecutar LYX con mltiples configuraciones
La libertad de configuracin del directorio local puede no ser suficiente si quieres

tener a tu disposicin ms de una configuracin. Por ejemplo, si quisieras usar diferentes combinaciones de teclas o configuraciones de impresora en distintos momentos.
Esto lo puedes conseguir teniendo varios de estos directorios. Despus especificas qu
directorio usar al arrancar.
Ejecutando LYX con la opcin de lnea de comandos -userdir <algn directorio>
hace que el programa lea la configuracin de ese directorio y no del predeterminado. (Puedes determinar el directorio predeterminado ejecutando LYX sin la opcin
-userdir). Si el directorio especificado no existe, LYX propone su creacin, tal como
hace con el directorio predeterminado la primera vez que se ejecuta el programa.
Puedes modificar las opciones de configuracin en ese directorio personal adicional
exactamente igual que para el directorio predeterminado. Estos directorios son completamente independientes (pero sigue leyendo). Ten presente que establecer algn
valor para la variable de entorno LYX_USERDIR_20x tiene exactamente el mismo efecto.
Tener varias configuraciones tambin requiere ms mantenimiento: si quieres aadir
un nuevo formato a NewUserDir/layouts que est disponible en todas tus configuraciones, debes aadirlo a cada directorio por separado. Puedes evitarlo con el siguiente
truco: despus de que LYX crea un directorio adicional, la mayora de los subdirectorios (vase arriba) estn vacos. Si quieres que la nueva configuracin sea una rplica
de una existente, reemplaza el subdirectorio vaco con un enlace simblico que apunte al subdirectorio deseado. Ten precaucin, no obstante, con el subdirectorio doc/,
puesto que contiene un archivo escrito por el guin de configuracin (tambin accesible mediante Herramientas . Reconfigurar) que es especfico de la configuracin.
3 El dilogo Preferencias
Todas las opciones del dilogo de preferencias se describen en el apndice El dilogo Preferencias de la Gua del usuario. Ah encontrars ms detalles sobre algunas
opciones.
3.1.
Formatos
El primer paso es definir tus propios formatos de archivo si no lo estn ya. Para
hacerlo abre el dilogo Herramientas . Preferencias. En Gestin de archivos . Formatos
de archivo pulsa el botn Nuevo. . . para definir el nuevo formato. El campo Formato
es para el nombre que identificar el formato en la GUI (interfaz grfica de usuario).
El Nombre corto se usa para identificar el formato internamente. Adems debers
introducir una extensin de archivo. Todos estos son imprescindibles. El campo opcional Atajo de teclado sirve para asociar una combinacin de teclas en los mens.
(Por ejemplo, teclear Alt-V D ejecuta Ver . DVI). Visor
Un Formato puede tener un Visor y un Editor asociados. Por ejemplo, podras usar
Ghostview para ver archivos PostScript. Puedes introducir el comando para iniciar
el programa en el campo correspondiente. Al definir este comando puedes usar las
cuatro variables listadas en la siguiente seccin. El visor se lanza cuando ves una
imagen en LYX o usas el men Ver. El editor se lanza cuando pulsas el botn Editar
externamente que se muestra al hacer clic derecho en un grfico o en un material
externo, por ejemplo.
La opcin Formato de documento indica a LYX que ese formato es adecuado para
exportar. Si esto est marcado y existe una ruta de conversin adecuada (vase 3.3),
el formato aparecer en el men Archivo . Exportar. Tambin aparecer en el men
Ver si se ha especificado un visor para ese formato. Los formatos puros de imagen,
como png, no deberan usar esta opcin. Los formatos que pueden corresponder tanto
a grficos vectoriales como a documentos, como pdf, s deberan usarla.
La opcin Formato de grfico vectorial indica a LYX que el formato puede contener
grficos vectoriales. Esta informacin se emplea para determinar el formato objetivo
de los grficos incluidos para la exportacin pdflatex. Los grficos incluidos pueden
requerir conversin a pdf, png, o jpg, puesto que pdflatex no puede manejar otros
formatos de imagen. Si un archivo incluido no est ya en formato pdf, png, o jpg, se
convierte a pdf si la opcin de formato vectorial est marcada, y si no a png.
3.2.
Copiadores
Puesto que todas las conversiones de un formato a otro tienen lugar en el archivo
temporal de LYX, a veces es necesario modificar un archivo antes de copiarlo en
el directorio temporal para que la conversin se pueda realizar.1 Esto lo hace un
Copiador: copia un archivo a (o desde) el directorio temporal y puede modificarlo en
el proceso.
Las definiciones de los copiadores pueden usar cuatro variables:
$$s
El directorio de sistema de LYX (p. e. /usr/share/lyx)
$$i
El archivo de entrada
$$o
El archivo de salida
$$l
El nombre LATEX
El ltimo debera ser el nombre de archivo tal como debera ponerse en un comando
LATEX \include. Solo es pertinente cuando se exportan archivos adecuados para esa
inclusin.
Los copiadores pueden emplearse para hacer casi cualquier cosa con archivos de
salida. Por ejemplo, supongamos que quieres copiar archivos pdf generados a un
directorio especial, /home/you/pdf/. En ese caso deberas escribir un guin para
intrprete de comandos tal como:
#!/ b i n / bash
FROMFILE=$1
TOFILE=basename $2
cp $FROMFILE /home/ you / pdf /$TOFILE
Gurdalo en tu directorio local, /home/you/.lyx/scripts/pdfcopier.sh, supongamos y hazlo ejecutable si ello es necesario en tu sistema. Despus, en el dilogo
Herramientas . Preferencias, en Gestin de archivos . Formatos de archivo, selecciona el
formato PDF(pdflatex) u otro de los formatos pdf e introduce pdfcopier.sh $$i
$$o en el campo Copiador.
LYX usa los copiadores en varias de sus propias conversiones. Por ejemplo, si se
encuentran los programas apropiados, LYX instalar copiadores para los formatos
HTML y HTML (MS Word). Cuando se exporta a estos formatos, el copiador se
encarga de que se copien no solo el archivo HTML principal, sino tambin los diversos
archivos asociados (estilos, imgenes, etc). Todos estos archivos se escriben en un
subdirectorio del directorio en el que se encuentre el archivo original de LYX.2
1
Por ejemplo, el archivo puede hacer referencia a otros archivos imgenes, por ejemplo mediante nombres de archivo relativos, y estos pueden resultar invlidos cuando el archivo se copia
en el directorio temporal.
2
Este copiador puede adaptarse. El argumento opcional -e acepta una lista, separada por comas,
con las extensiones que deben copiarse; si se omite se copiarn todos los archivos. El argumeto
-t determina la extensin aadida al directorio generado. Por omisin es LYXconv, as, el
HTML generado a partir de /ruta/a/archivo.lyx tendr la forma /ruta/a/archivo.html.LYXconv.
3.3 Convertidores
3.3.
Convertidores
Puedes definir tus propios convertidores para convertir archivos entre distintos formatos. Se hace en el dilogo Herramientas . Preferencias . Gestin de archivos . Convertidores.
Para definir un nuevo convertidor de un formato a otro, seleccinalos en las listas
desplegables Del formato y Al formato, introduce el comando necesario para la conversin y despus pulsa el botn Aadir. En la definicin de convertidores se pueden
usar distintas variables:
$$s
El directorio de sistema de LYX
$$i
El archivo de entrada
$$o
El archivo de salida
$$b
El nombre del archivo base del archivo de entrada (sin la extensin)
$$p
La ruta al archivo de entrada
$$r
La ruta al archivo de entrada original (esto es diferente de $$p cuando se

invoca una cadena de convertidores).
$$e
El nombre iconv para la codificacin del documento.
En el campo Indicador adicional puedes introducir los siguientes, separados por comas:
latex
Este convertidor ejecuta alguna forma de LATEX. Har estar disponibles

los registros de errores LATEX de LYX
needaux
Necesita el archivo LATEX .aux para la conversin
xml
La salida es XML
Las tres siguientes no son realmente opciones porque aceptan un argumento en la

forma key = value:
parselog Si se pone, el error estndar del convertidor se redirecciona a un archivo
infile.out, y el guin dado como argumento se ejecutar como: script
<infile.out >infile.log. El argumento puede contener $$s.
resultdir El nombre del directorio en el que el convertidor descargar los archivos
generados. LYX no crear ese directorio y no copia nada en l, aunque
copiar este directorio al destino. El argumento puede contener $$b, que
ser reemplazado por el nombre base de los archivos de entrada y de
salida, respectivamente, cuando se copia el directorio.
Ten en cuenta que resultdir y usetempdir no tienen sentido juntos. El
ltimo ser ignorado si se da el primero.
resultfile Determina el nombre del archivo de salida y puede contener $$b. Solo
es sensible con resultdir y adems es opcional; si no se da, por omisin
es index.
Ninguno de estos tres ltimos se usan actualmente en ninguno de los convertidores
que son instalados por LYX.
No tienes que definir convertidores entre todos los formatos que quieras convertir.
Por ejemplo, observars que no hay convertidor LYX a PostScript, sin embargo LYX
exporta a PostScript. Lo hace creando primero un archivo LATEX (no es necesario
un convertidor para esto), que luego es convertido a DVI mediante el convertidor
LATEX a DVI, y por ltimo convierte el archivo DVI resultante a PostScript. LYX
encuentra automticamente estas cadenas de convertidores y siempre escoger la
cadena ms corta posible. Sin embargo, an puedes definir mltiples mtodos de
conversin entre formatos. Por ejemplo, la configuracin estndar de LYX provee tres
caminos para convertir LATEX a PDF: directamente, usando pdflatex; mediante (DVI
y) PostScript, usando ps2pdf; o mediante DVI, usando dvipdfm. Para construir estas
cadenas alternativas tienes que definir mltiples formatos de archivo objetivo, como
se describe en la seccin 3.1. Por ejemplo, en la configuracin estndar, se definen
los formatos llamados pdf, pdf2, y pdf3, todos ellos compartiendo la extensin .pdf, y
que corresponden a los mtodos de conversin antes mencionados.
10
4 Internacionalizacin de LYX
LYX soporta el uso de una interfaz traducida. La ltima vez que lo comprobamos, LYX suministraba textos en treinta idiomas. El idioma elegido se denomina
locale. (Para lecciones adicionales sobre configuracin de idiomas, vase tambin la
documentacin de locale del sistema operativo. En Linux, la pgina de manual de
locale(5) es un buen punto de partida).
Hay que advertir que estas traducciones funcionarn pero tienen algunos fallos. En
particular, todos los dilogos se han diseado con el ingls en mente, lo que significa que algn texto traducido podra ser demasiado largo para ajustarse al espacio
asignado. Esto solo es un problema de presentacin en pantalla y no causar ningn
perjuicio. Adems, encontrars que algunas traducciones no definen atajos de teclado para todo. A veces, simplemente no hay letras libres suficientes para ello. Otras
veces, el traductor todava no lo ha completado. Nuestro equipo de traduccin, al
que podras unirte si quieres,1 intentar, por supuesto, corregir estas deficiencias en
futuras versiones de LYX.
4.1.
Traduccin de LYX
4.1.1.
Traduccin de la interfaz grfica de usuario (mensajes de

texto)
LYX utiliza la biblioteca GNU gettext para manejar la internacionalizacin de

la interfaz. Para que LYX hable tu idioma preferido en todos los mens y dilogos
es necesario un archivo po para ese idioma. Si est disponible, tendrs que generar
a partir de l un archivo mo e instalarlo. El procedimiento para hacer todo esto se
explica en la documentacin de GNU gettext. Puedes hacer esto solo para ti, pero
tambin podras compartir el resultado de tu trabajo con el resto de la comunidad
LYX. Enva un mensaje a la lista de desarrolladores de LYX para ms informacin
sobre cmo proceder.
En resumen, esto es lo que deberas hacer (xx indica el cdigo del idioma):
Inspecciona el cdigo fuente de LYX. (Vase informacin en la web.)
Copia el archivo lyx.pot a la carpeta de los archivos **.po. Despus lo renombras como xx.po. (Si lyx.pot no est por ningn sitio, puede rehacerse
1
Si usas con fluidez un idioma distinto del ingls, unirse a estos equipos es una estupenda forma
de corresponder a la comunidad LYX!
11
con el comando de consola make lyx.pot en ese directorio, o puedes usar como
muestra un archivo po de algn otro idioma).
Edita xx.po.2 Para algunos nombres de men y otros artilugios hay adems
atajos de teclado que deberan traducirse. Dichas teclas se marcan con una |
delante, y deberan traducirse de acuerdo con las palabras y frases del idioma.
Adems tendras que rellenar la informacin al principio del nuevo archivo po,
correo electrnico, etc., para que la gente sepa dnde enviarte sugerencias o
divertidas diatribas.
Si ests haciendo esto solo para ti, entonces:
Genera xx.mo. Se puede hacer con msgfmt -o xx.mo < xx.po.
Copia el archivo mo a tu directorio local, en la carpeta apropiada para los
mensajes de las aplicaciones en el idioma xx, con el nombre lyx.mo (p. e.
/usr/local/share/locale/xx/LC_MESSAGES/lyx.mo.
Sin embargo, ya se ha dicho, lo mejor sera poder aadir el nuevo archivo po a la
distribucin de LYX, para que otros puedan usarlo. Esto requiere hacer cambios en
LYX, as que enva un correo a la lista de desarrolladores si ests interesado en hacerlo.
4.1.1.1.
Mensajes ambiguos
A veces resulta que un mensaje en ingls tiene diversas traducciones en un idioma dado. Un ejemplo es la palabra To, que en alemn se puede traducir por Nach
o Bis, segn el sentido exacto que tenga to en ingls. GNU gettext no maneja
tales traducciones ambiguas. Por lo tanto, debes aadir alguna informacin contextual al mensaje: en vez de To se pone To[[as in From format x to format y]]
y To[[as in From page x to page y]]. Ahora las dos apariciones de To son
diferentes para gettext y pueden traducirse correctamente por Nach y Bis, respectivamente.
Por supuesto que la informacin contextual debe eliminarse del mensaje original si
no se usa en la traduccin. Por eso hay que ponerla entre dobles corchetes al final del
mensaje (vase el ejemplo). El mecanismo de traduccin de LYX asegura que todo lo
que va entre corchetes al final de los mensajes se quita antes de mostrarlos.
4.1.2.
Traduccin de la documentacin
La documentacin en lnea (men Ayuda) puede (debera!) traducirse. Si hay versiones traducidas de la documentacin disponible3 y locale est adecuadamente
2
Es un archivo de texto, se puede editar en cualquier editor de texto. Pero hay programas especializados para editar estos archivos, como Poedit (para todas las plataformas) o KBabel (para
KDE). Adems, Emacs tiene un modo para editar archivos po.
3
Hasta marzo de 2008, al menos algunos de los documentos han sido traducidos a catorce idiomas,
y el Tutorial est disponible en algunos ms.
12
4.2 Cosas sobre teclados internacionales

configurado, LYX las cargar automgicamente. LYX busca las traducciones en
LYXDir/doc/xx/DocName.lyx, donde xx es el cdigo para el idioma en uso actualmente. Si no hay versin traducida se presentar por omisin la versin inglesa del
documento. Ten en cuenta que las versiones traducidas deben tener los mismos nombres de archivo (el DocName de antes) que el original. Si te animas a traducir documentacin (de paso, una excelente manera de leerla atentamente!), hay algunas cosas
que deberas tener en cuenta:
Consulta la web de traduccin de la documentacin en http://www.lyx.org/Translation.
As podrs comprobar el estado actual de traduccin de documentos a tu idioma. Tambin si hay alguien que est coordinando la traduccin a tu idioma. Si
no hay nadie comuncanos, por favor, si ests interesado en ello.
Una vez que te has decidido a empezar, he aqu algunos consejos que te pueden
ahorrar inconvenientes:
nete al equipo de documentacin! En Ayuda . Introduccin, que por cierto,
es el primer documento que se debera traducir, hay informacin sobre cmo
hacerlo.
Infrmate sobre las normas tipogrficas de tu idioma. La tipografa es un antiguo arte que ha desarrollado durante siglos una gran variedad de convenciones
en diversas partes del mundo. Estudia tambin la terminologa profesional de los
tipgrafos en tu pas. Inventar tu propia terminologa slo provocar confusin.
(Cuidado! La tipografa es adictiva!)
Haz una copia del documento para trabajar sobre ella. Puedes guardarla como
archivo personal de traduccin en tu directorio ~/.lyx/doc/xx/.
De vez en cuando el documento original (del equipo LYX) ser actualizado. Usa
el visor de fuentes en http://www.lyx.org/trac/timeline para ver los cambios
realizados. De esta manera puedes ver fcilmente qu partes del documento
traducido necesitan actualizarse.
Si encuentras un error en el documento original, corrjelo y notifica los cambios
al equipo de documentacin! (No te has olvidado de contactar con el equipo de
documentacin, verdad?)
4.2.
Cosas sobre teclados internacionales
Las dos secciones siguientes describen con detalle la sintaxis de los archivos .kmap
y .cdef. Deberan servir de ayuda para disear tus propios mapas de teclado si los
suministrados no satisfacen tus necesidades.
13
4.2.1.
El archivo .kmap
Un archivo .kmap asocia pulsaciones de teclas con caracteres o secuencias de ellos.

Como sugiere el nombre, sirve para trazar un mapa del teclado. En esta seccin se
describen las palabras clave kmap, kmod, kxmod y kcomb del archivo .kmap.
Asocia un carcter a una cadena
kmap
\kmap char string

Esto asocia char a string. Anotar que en string, la doble comilla (") y la barra invertida
(\) deben escaparse con una barra (\) previa.
Un ejemplo de una declaracin de kmap para hacer que el smbolo / sea generado
por la tecla & es:
\kmap & /
Especifica un carcter acentuado
kmod
\kmod char accent allowed

Esto har que el carcter char sea un acento accent sobre el(los) carcter(es) permitido(s) allowed. Este es el mecanismo de tecla muerta4 .
Si pulsas char y despus una tecla que no est entre las permitidas (allowed), en la
salida obtendrs el carcter char seguido por el otro carcter, el no permitido. Hay
que tener en cuenta que Retroceso cancela una tecla muerta, de modo que si pulsas
char Retroceso, el cursor no retrocede una posicin sino que anula el efecto que char
hubiera tenido sobre la siguiente pulsacin.
En el ejemplo siguiente, el carcter va a generar un acento agudo permitido sobre
los caracteres a, e, i, o, u, A, E, I, O, U:
\kmod acute aeiouAEIOU
kxmod
Especifica una excepcin para el carcter acentuado
\kxmod
accent char result
Define una excepcin para el accent sobre char. El accent debe haber sido asignado a
una pulsacin con una declaracin previa de \kmod y char no debe estar en el conjunto
allowed de accent. Si tecleas la secuencia accent char da como resultado result. Si dicha
declaracin no existe en el archivo .kmap y tecleas accent char, obtendrs accent_key
char, donde accent_key es el primer argumento de la declaracin \kmod.
El comando siguiente generar i cuando teclees agudo-i (i):
4
El trmino tecla muerta se refiere a una tecla que no genera ningn carcter por s mismo, pero
seguida de otra tecla genera el carcter acentuado deseado. Por ejemplo, un carter con diresis,
, se genera de esta manera.
14
4.2 Cosas sobre teclados internacionales

\kxmod acute i "\\{\\i}"
kcomb
Combina dos caracteres acentos
\kcomb accent1 accent2 allowed

Esto es bastante esotrico. Permite combinar el efecto de accent1 y accent2 (en ese
orden!) sobre los caracteres permitidos allowed. Las teclas para accent1 y accent2
deben haber sido declaradas con un comando \kmod previamente en el archivo.
Considera este ejemplo del archivo greek.kmap:
\kmod ; acute aeioyvhAEIOYVH \kmod : umlaut iyIY \kcomb acute umlaut iyIY
Esto permite pulsar ;:i y obtener el efecto de \{\"{i}}. En este caso un retroceso
cancela la ltima tecla muerta, as que si tecleas ;: Retroceso i obtienes \{i}.
4.2.2.
El archivo .cdef
Despus de realizados el mapa .kmap, un archivo .cdef traza el mapa de las cadenas que los smbolos generan para los caracteres en la tipografa actual. La distribucin de LYX actualmente incluye al menos los archivos iso8859-1.cdef and
iso8859-2.cdef.
En general el archivo .cdef es una secuencia de declaraciones de la forma:
char_index_in_set string
Por ejemplo, para asociar \{e} al correspondiente carcter en el conjunto iso-8859-1
(233), se usa:
233 "\\{e}"
con \ y " escapados en string. Anotar que el mismo carcter puede aplicarse a ms
de una cadena. En el archivo iso-8859-7.cdef tienes
192 "\\{\\\"{i}}"
192 "\\\"{\\{i}}"
Si LYX no puede encontrar una declaracin para la cadena por una tecla o una
secuencia con tecla muerta, intentar si aparece como un carcter acentuado y probar
a dibujar un acento sobre el carcter en la pantalla.
15
4.2.3.
Teclas muertas
Hay una segunda manera de aadir soporte para caracteres internacionales mediante las denominadas teclas muertas. Una tecla muerta trabaja en combinacin
con una letra para generar un carcter acentuado. Aqu explicaremos como crear una
sencillsima tecla muerta para ilustrar cmo funciona.
Supongamos que necesitas el carcter circunflejo ^. Podras asociar la tecla ^ (antes Maysculas-6) al comando LYX accent-circumflex en tu archivo lyxrc. Ahora,
cuando pulses la tecla ^ seguida de una letra, obtendrs esa letra con circunflejo sobre
ella. Por ejemplo, la secuencia ^e genera . Si pruebas ^t, sin embargo, LYX
no imprime nada puesto que t nunca lleva un circunflejo. Pulsar Espacio tras una
tecla muerta imprime el acento solo. Advierte este ltimo punto! Si asocias una tecla
a una tecla muerta necesitars reasociar el carcter de esa tecla a otra tecla. Asociar
la tecla , a una cedilla es una mala idea, puesto que solo obtendrs cedillas en lugar
de comas.
Una forma habitual de asociar teclas muertas es usar Meta-, Ctrl-, y Maysculasen combinacin con un acento, como ~ o , o ^. Otra forma incluye el uso de
xmodmap y xkeycaps para configurar la tecla especial Mode_Switch. Esta tecla acta
de alguna forma como Maysculas y permite teclas a caracteres acentuados. Tambin
puedes transformar teclas en muertas asocindolas a algo como usldead_cedilla
y despus asociando esta tecla simblica al correspondiente comando LYX.5 Puedes
hacer casi cualquier cosa con la tecla Mode_Switch: una de las teclas Ctrl-, una tecla
de funcin de reserva, etc. En cuanto a los comandos LYX que generan acentos,
consulta la entrada para accent-acute en Reference Manual. Ah encontrars la
lista completa.
4.2.4.
Guardar la configuracin de idioma
Puedes editar tus preferencias para que el entorno de idioma adecuado sea automticamente configurado al iniciar LYX, en el dilogo Herramientas . Preferencias.
Nota de John Weiss: Esto es exactamente lo que hago en mis archivos ~/.lyx/lyxrc y
~/.xmodmap. Tengo mi tecla Bloq Despl configurada como Mode_Shift y unas cuantas de estas teclas simblicas usldead_* asociadas a cosas como Bloq Despl-^ y Bloq Despl-~. As es
como genero mis caracteres acentuados.
16
5 Instalacin de nuevas clases de

documento, formatos y plantillas
En este captulo describimos los procedimientos para crear e instalar nuevos archivos de plantillas y formatos de LYX, as como repasar la instalacin correcta de
nuevas clases de documentos LATEX.
En primer lugar, permite que digamos algo sobre la relacin entre LYX y LATEX. Lo
que hay que entender es que, en cierto sentido, LYX no sabe nada de LATEX. Desde
el punto de vista de LYX, LATEX solo es uno ms de los varios formatos de soporte
en los que es capaz de generar salida. Otros son DocBook, texto sencillo y XHTML.
LATEX es, por supuesto, un formato particularmente importante, pero muy poca de
la informacin que LYX tiene sobre LATEX est realmente contenida en el propio
programa.1 Esa informacin, incluso para las clases estndar como article.cls, est
almacenada en archivos de formato (layout). De igual manera LYX no sabe gran cosa
sobre DocBook o XHTML. Esa informacin est en los archivos de formato.
El archivo de formato para una determinada clase de documento se puede considerar como un manual de instrucciones para traducir las estructuras de LYX
prrafos y sus estilos, ciertos tipos de recuadros, etc. a las estructuras correspondientes de LATEX, DocBook o XHTML. Por ejemplo, casi todo lo que LYX sabe sobre
article.cls est contenido en el archivo article.layout y en otros archivos incluidos en este. Por esta razn, quien intente escribir archivos de formato debera empezar
por estudiar los archivos existentes. Un buen sitio para empezar es stdsections.inc,
que est incluido en article.layout, book.layout y muchos otros archivos de formato para clases de documento. En este archivo se definen las secciones y dems:
stdsections.inc indica a LYX como traducir los prrafos con estilos como Seccin,
Subseccin, etc., a los comandos y etiquetas correspondientes en LATEX, DocBook
y XHTML. El archivo article.layout solo incluye, bsicamente, varios de estos
archivos std*.inc.
Pero definir la correspondencia LYX-LATEX no es lo nico que hacen los archivos de
formato. Su otra tarea es definir cmo aparecern en pantalla las estructuras de LYX.
El hecho de que los archivos de formato tengan estas dos tareas es a veces fuente de
confusin, porque son totalmente independientes. Indicar a LYX cmo traducir cierto
estilo de prrafo a LATEX no le dice cmo mostrarlo en pantalla; a la inversa, indicar
cmo mostrar en pantalla un estilo de prrafo no tiene nada que ver con su traduccin
a LATEX (solo permite indicar a LATEX cmo mostrarlo). As pues, en general, cuando
1
Algunos comandos son lo bastante complejos como para ser incluidos en el cdigo de LYX. Pero
en general los desarrolladores consideran esto una mala cosa.
17
5 Instalacin de clases, formatos . . .

defines una nueva construccin en LYX, siempre tienes que hacer dos cosas: 1) indicar
la traduccin a LATEX y, 2) indicar la presentacin en pantalla.
Gran parte de lo dicho es cierto, tambin, en relacin con otros formatos de salida,
aunque XHTML es un poco diferente porque en este caso LYX es capaz, en cierta
medida, de usar la informacin de la presentacin de un prrafo en pantalla para
generar la presentacin (en forma de CSS) del prrafo en un navegador. Incluso en
este caso, no obstante, la distincin entre lo que hace LYX internamente y la forma en
que las cosas se muestran externamente sigue en vigor, y ambas se pueden controlar
separadamente. Vase 5.4 para ms detalles.
5.1.
Instalacin de nuevos archivos LATEX
Algunas instalaciones quiz no incluyan un paquete LATEX que te gustara usar

en LYX. Por ejemplo, podras necesitar FoilTEX, un paquete para preparar transparencias o diapositivas para proyectores. Las modernas distribuciones de LATEX como
TEXLive (2008 o posterior) o MiKTEX proveen una interfaz de usuario para eso. Por
ejemplo, en MiKTEX inicia su programa Administrador de paquetes para obtener
una lista de los disponibles. Para instalar uno, haz clic derecho sobre l o usa el botn
de la herramienta de instalacin.
Si tu distribucin LATEX no proporciona tal administrador de paquetes, o si el
paquete no est disponible en ella, sigue los siguientes pasos para instalarlo manualmente:
1. Consigue el paquete de CTAN o de otro sitio.
2. Si el paquete contiene un archivo con la extensin .ins (es el caso de FoilTEX)
abre una consola, cambia a la carpeta del archivo y ejecuta el comando latex
foiltex.ins. As desempaquetamos y disponemos de todos los archivos para
instalar. La mayora de paquetes LATEX no estn empaquetados y podemos
saltar este paso.
3. Tienes que decidir si el paquete estar disponible para todos los usuarios o no.
a) En sistemas *nix (Linux, OSX, etc.), si el paquete va estar disponible
para todos los usuarios del sistema, hay que instalarlo en el rbol local de TEX, de lo contrario instlalo en tu directorio TEX de usuario. La
ubicacin de estos rboles, si no existen ya, depende del sistema. Para
encontrarlos mira en el archivo texmf.cnf.2 La ubicacin del rbol local
de TEX est definida por la variable TEXMFLOCAL; generalmente algo como
/usr/local/share/texmf/ . La ubicacin del rbol user de TEX est definida por TEXMFHOME y generalmente es $HOME/texmf/ . (Si estas variables
no estn predefinidas, debes hacerlo.) Probablemente necesites permiso de
2
Usualmente es el directorio $TEXMF/web2c, aunque se puede ejecutar el comando kpsewhich

texmf.cnf para localizarlo.
18
5.2 Tipos de archivos de formato

administrador para crear o modificar el rbol local, pero no para el rbol
user.
En general, es recomendable instalar en el rbol user porque no ser modificado o sobrescrito al actualizar el sistema. Adems, se guardar copia
de l cuando hagas copia de seguridad de tu directorio home (que debe
ser lo habitual).
b) En Windows, para que el nuevo paquete est disponible a todos los usuarios, cambia a la carpeta donde est instalado LATEX y en la subcarpeta
~\tex\latex, (En MiKTEX, debera ser ~:\Programs\MiKTEX\tex\latex )
crea una nueva carpeta foiltex y copia en ella todos los archivos del
paquete. Para hacer el paquete disponible solo a un usuario o si no dispones de permisos, haz lo mismo pero en el directorio de LATEX, p. ej.,en
MiKTEX 2.8 en WinXP
~:\Documents and Settings\<username>\Application Data\
MiKTEX\2.8\tex\latex
en Vista sera
~:\Users\<username>\AppData\Roaming\2.8\MiKTEX\tex\latex .
4. Ahora hay que decir a LATEX que hay archivos nuevos. Esto depende de la
distribucin de LATEX:
a) Para TEXLive ejecuta el comando texhash en una consola. Si el paquete
se instal para todos los usuarios harn falta permisos de administrador.
b) Para MiKTEX, si el paquete se instal para todos los usuarios, inicia el
programa Settings (Admin) y pulsa el botn Refresh FNDB. Si no,
inicia el programa Settings y haz lo mismo.
5. Finalmente, hay que decir a LYX que hay nuevos paquetes disponibles. Usa el
men Herramientas . Reconfigurar y reinicia LYX.
Ya est instalado el paquete. En nuestro ejemplo, la clase de documento Slides (FoilTex)
estar ahora disponible en Documento . Configuracin . Clases de documento.
Si quieres usar una clase de documento LATEX que no aparece listada en Documento . Configuracin . Clases de documento, debes crear un archivo de formato (layout)
para ella. Este es el tema de la seccin siguiente.
5.2.
Tipos de archivos de formato
Esta seccin describe los diversos tipos de arhivos de LYX que contienen informacin
sobre el formato. Los archivos .layout describen estilos de prrafo y de carcter, y
determinan cmo los debera presentar LYX y cmo deberan traducirse a LATEX,
DocBook, XHTML o cualquier otro formato de salida que se vaya a usar.
Intentaremos aqu dar una minuciosa descripcin del proceso; sin embargo, hay
tantos tipos diferentes de documentos soportados por clases de LATEX que no podemos
19

aspirar a tratar todas las distintas posibilidades o problemas que puedas encontrar.
La lista de usuarios de LYX es frecuentada por gente con mucha experiencia en el
diseo de formatos deseosa de compartir sus conocimientos.
Cuando te pongas a escribir un nuevo formato, es de gran ayuda echar un vistazo
a los formatos de ejemplo suministrados con LYX. Si escribes un layout de LYX para
una clase de documento LATEX o un mdulo que podra ser til tambin a otros, no
dudes en compartir tu labor envindola a seccin Layouts en wiki LyX o incluso a
la lista de desarrolladores de LYX para poderlo incluir en la distribucin.3
5.2.1.
Mdulos de formato
Hemos hablado hasta ahora de archivos de formato. Pero hay distintos tipos de archivos con informacin sobre formatos. Estrictamente, los archivos de formato tienen
la extensin .layout y proporcionan a LYX informacin sobre las clases de documento. Sin embargo, a partir de LYX 1.6, esta informacin puede proporcionarse tambin
en mdulos, que tienen la extensin .module. Los mdulos son a los paquetes LATEX lo
que los formatos a las clases LATEX, y algunos mdulos como el mdulo Notas finales dan soporte especfico a un paquete determinado en este caso endnotes. En
cierto sentido, los mdulos de formato son similares a los archivos incluidos4 como stdsections.inc, ya que, como estos, los mdulos no son especficos para una
clase de documento dada, sino que se pueden usar con muchos formatos diferentes.
La diferencia es que el uso de un archivo incluido con article.cls requiere editar
dicho archivo, mientras que los mdulos se seleccionan en el dilogo Documento .
Configuracin.
La construccin de mdulos es la forma ms fcil de iniciarse en la edicin del
formato, puesto que puede ser tan sencillo como aadir un nuevo estilo de prrafo o un
recuadro flexible. No obstante, los mdulos pueden, en principio, contener cualquier
cosa que pueda contener un archivo layout.
Despus de crear un mdulo nuevo y copiarlo en la carpeta layouts/, tendrs
que reconfigurar LYX y reiniciar despus para que el mdulo aparezca en el men.
Sin embargo, los cambios que hagas al mdulo se vern inmediatamente si abres
Documento . Configuracin, seleccionas lo que sea y despus pulsas OK. Es muy
recomendable guardar el trabajo antes de hacer eso. De hecho, es muy recomendable
no intentar editar los mdulos mientras se est trabajando simultneamente en un
documento. Aunque los desarrolladores, por supuesto, se esfuerzan en mantener la
estabilidad de LYX en estas situaciones, errores sintcticos y similares en el archivo
del mdulo podran causar extraos comportamientos.
3
Hay que advertir que LYX se acoge a la licencia GPL, por tanto cualquier material aportado debe
tener la misma licencia.
4
Estos pueden tener cualquier extensin pero, por convenio, se usa la extensin .inc.
20

5.2.1.1.
Formato local
Los mdulos son a LYX lo que los paquetes a LATEX. Sin embargo, a veces puede
suceder que necesites un recuadro especfico o un estilo de carcter solo para un documento, y escribir un mdulo que estar disponible tambin para otros documentos
tiene poco sentido. En estos casos, lo que necesitas es el Formato local de LYX.
Se encuentra en Documento . Configuracin . Formato local. El gran cuadro de texto
permite introducir todo lo que podra incluirse en un archivo de formato o en un
mdulo. De hecho, el formato local de un documento se puede considerar como un
mdulo que le pertenece solo a l. Por tanto, en particular, hay que introducir una
etiqueta Format. Cualquier formato es aceptable, pero debera usarse normalmente
el actual formato. (En LYX 2.0 el formato actual es 35). Debes tener en cuenta que
el formato local no es soportado por versiones de LYX anteriores a 1.6, por tanto no
deberas usarlo si quieres poder exportar el documento a LYX 1.5 o anteriores sin
perder la informacin del formato local. Si quieres poder exportar a 1.6 el formato
local es soportado pero no hay IU par l, deberas usar formato 11 y, por supuesto,
usar solo estructuras que estuvieran disponibles en LYX 1.6.
Una vez introducido algo en el panel Local Layout, LYX habilitar el botn Validar de debajo. Pulsando ese botn LYX determinar si lo introducido es informacin
vlida para el formato elegido. LYX informar del resultado pero, desafortunadamente, no indicar qu errores pudiera haber habido. Sin embargo, si LYX se ha arrancado
en una terminal se vern ah los errores. El formato local no se podr guardar hasta
que se haya introducido algo vlido.
Las advertencias al final de la seccin anterior se aplican tambin aqu. Es mejor
no enredar con formato local mientras se est trabajando, especialmente si no se ha
guardado el documento. Dicho esto, usar formato local en un documento de prueba puede ser una forma muy conveniente de probar ideas de formato, o incluso de
empezar a desarrollar un mdulo.
5.2.2.
Formato para archivos .sty
Probablemente te vas a encontrar con dos situaciones a la hora de querer soportar

una nueva clase de documento LATEX, segn se trate de archivos de estilo (.sty) o de
archivos de clases LATEX 2 (.cls). Dar soporte a un nuevo estilo es bastante fcil.
Dar soporte a una nueva clase es un poco ms difcil. Trataremos el primer caso en
esta seccin y el otro en la siguiente. Lo mismo cabe decir, por supuesto, para el
soporte de un nuevo DocBook DTD.
El caso ms sencillo es aquel en el que la nueva clase de documento se suministra
como archivo de estilo que se usar conjuntamente con una clase ya soportada. Para
nuestro ejemplo supondremos que el archivo de estilo se llama myclass.sty y que se
usar conjuntamente con report.cls, que es una clase estndar.
Empieza por copiar el archivo layout existente en tu directorio local:5
5
Evidentemente, cul es tu directorio local variar segn la plataforma, y adems LYX permite
especificarlo al inicio usando la opcin -userdir.
21

cp report.layout ~/.lyx/layouts/myclass.layout
Despus edita myclass.layout y cambia la lnea:
\DeclareLATEXClass{report}
por la lnea
\DeclareLATEXClass[report, myclass.sty]{report (myclass)}
Despus aade:
Preamble
\usepackage{myclass}
EndPreamble
cerca del principio del archivo.
Inicia LYX y selecciona Herramientas . Reconfigurar. Despus reinicia LYX y haz una
prueba con un documento nuevo. En el dilogo Documento . Configuracin deberas
ver report (myclass) en la lista de clases de documento. Es probable que algunos de
los comandos de secciones y dems en tu nueva clase funcionen de distinta manera
a como lo hacen en la clase estndar report en este ejemplo, de modo que si
quieres, ahora puedes enredar un rato con los ajustes de las distintas secciones. La
informacin del formato de las secciones se encuentra en stdsections.inc, pero no
necesitas copiar ni cambiar este archivo. Simplemente aade tus cambios a tu archivo
layout despus de la lnea Input stdclass.inc, que incluye stdsections.inc. Por
ejemplo, podras aadir estas lneas:
Style Chapter
Font
Family Sans
EndFont
End
para cambiar la tipografa de los encabezados de captulo a sans-serif. Esto sobrescribir (o, en este caso, aadir) la declaracin para el estilo Captulo.
Tu nuevo paquete puede proporcionar adems comandos o entornos no presentes en
la clase base. En este caso, los aadirs al archivo layout. Vase 5.3 para informacin
sobre cmo hacerlo.
Si myclass.sty se puede usar con diferentes clases de documento, e incluso si no es
as, lo ms sencillo sera escribir un mdulo que puedes cargar con la clase base. El
mdulo ms simple posible podra ser:
22

#\DeclareLYXModule{My Package}
#DescriptionBegin
#Support for mypkg.sty.
#DescriptionEnd
Format 21
Preamble
\usepackage{mypkg}
EndPreamble
Un mdulo ms complejo podra modificar el comportamiento de alguna estructura
ya existente o definir algunas nuevas. De nuevo te remitimos a 5.3 para los detalles.
5.2.3.
Formato para archivos .cls
En este caso hay dos opciones. Una, que el archivo de clase est l mismo basado en
una clase de documento existente. Por ejemplo, muchas clases de tesis estn basadas
en book.cls. Para ver si el tuyo lo est, busca una lnea parecida a
\LoadClass{book}
en el archivo. Si est, entonces puedes proceder en gran parte como en la seccin
anterior, aunque la lnea DeclareLATEXClass ser diferente. Si tu nueva clase es tesis
y est basada en book, la lnea debera poner:6
\DeclareLATEXClass[thesis,book]{thesis}
Si, por el contrario, la nueva clase no est basada en una ya existente, probablemente
tendrs que ir pensando en tu propio formato. Recomendamos firmemente copiar un
archivo de formato existente que use una clase de LATEX parecida y modificarlo, si es
posible. O al menos, usa un archivo existente como punto de partida para ver qu
items son los que te deben preocupar. Los detalles se discuten a continuacin.
5.2.4.
Creacin de plantillas
Una vez escrito un archivo de formato para una clase nueva de documento, podras
pensar en escribir adems una plantilla para ella. Una plantilla funciona como una
especie de tutorial para tu formato, mostrando cmo podra usarse, aunque sea con
contenido irrelevante. Naturalmente, puedes echar un vistazo a las plantillas incluidas
en LYX para obtener ideas.
Las plantillas se crean exactamente igual que un documento normal: usando LYX.
La nica diferencia es que los documentos corrientes tienen todos los ajustes posibles,
incluso el esquema de tipografas y el tamao del papel. Generalmente, un usuario no
6
Y ser mucho ms fcil si guardas el archivo como thesis.layout: LYX supone que la clase de
documento tiene el mismo nombre que el archivo de formato.
23

desea que una plantilla sobrescriba sus ajustes preferidos para dichos parmetros. Por
esta razn, el diseador de una plantilla debera quitar comandos como \font_roman
o \papersize de los archivos de plantillas de LYX. Esto se puede hacer con cualquier
editor de texto sencillo, por ejemplo vi o notepad.
Los archivos editados de plantillas que has creado se ubican en UserDir/templates/,
copia los que uses del directorio global de plantillas en LYXDir/templates/ al mismo
sitio y redefine la ruta a las plantillas en el dilogo Herramientas . Preferencias . Rutas.
De paso advertiremos que hay una plantilla, defaults.lyx, que tiene un papel especial: esta plantilla se carga cada vez que abres un documento nuevo con Archivo .
Nuevo, con el fin de proporcionar ajustes predeterminados por omisin. Para (re)crear
esta plantilla desde dentro de LYX, lo que debes hacer es abrir un documento, establecer los ajustes deseados y usar el botn Guardar como predeterminados.
5.2.5.
Actualizacin de antiguos archivos de formato
El formato de los archivos de formato cambia con cada nueva versin de LYX, de
modo que los antiguos archivos de formato deben ser convertidos. Desde LYX 1.4.0
este proceso ha sido automatizado: si LYX lee un archivo de formato con formato
antiguo lanzar la herramienta de conversin layout2layout.py, que lo convierte a
un archivo temporal con el formato actual. El archivo original se deja sin tocar. Si
lo usas a menudo y lo quieres convertir permanentemente para evitar que LYX tenga
que hacerlo cada vez, ejecuta el convertidor a mano:
mv myclass.layout myclass.old
python LYXDir/scripts/layout2layout.py myclass.old myclass.layout
Debes reemplazar LYXDir con el nombre de tu directorio LYX en el sistema.
La conversin manual no puede manejar archivos incluidos, as que estos tendrn
que convertirse separadamente.
5.3.
Estructura del archivo layout
Ha llegado por fin el momento de ponerte manos a la obra y crear o editar tu propio
archivo de formato; las siguientes secciones describen aquello a lo que te vas a enfrentar. Nuestro consejo es ir despacito, probando y guardando a menudo, escuchando
msica relajante y disfrutando de un par de tus copas favoritas; ms si ests muy
atascado. En realidad no es para tanto, pero la multitud de opciones puede llegar a
abrumarte si intentas hacer muchas cosas a la vez. Ve a por otra copa, por si acaso.
Todos los rtulos o etiquetas en los archivos de formato son insensibles a las maysculas; esto significa que Style, style y StYlE son el mismo comando. Los valores
posibles se imprimen entre corchetes detrs del nombre de la caracterstica. Si en
una descripcin de una clase de texto no se especifica una caracterstica, el valor por
omisin se escribe en estilo nfasis . Si el argumento tiene un tipo de dato como
string o float, el valor por omisin se muestra de esta manera: float=default .
24
5.3 Estructura del archivo layout
5.3.1.
Declaracin de la clase de documento
Las lneas de un archivo de formato que empiezan con # son comentarios. Hay una
excepcin a esta regla: todos los formatos deben comenzar con lneas como:
# % Do not delete the line below; configure depends on this7
# \DeclareLATEXClass{article}
La segunda lnea se usa en la (re)configuracin de LYX. El archivo layout es leido

por el guin de LATEX chkconfig.ltx de un modo especial tal que # se ignora. La
primera lnea es solo un comentario y la segunda contiene la declaracin de la clase
de texto. Si estas lneas aparecen en un archivo llamado article.layout, entonces
definen una clase de texto de nombre article (el nombre del archivo de formato) que
usa la clase de documento LATEX article.cls (por omisin se usa el mismo nombre
para ambos). La palabra article se utiliza como descripcin de la clase de texto y
es la que aparece en el dilogo Documento . Configuracin.
Supongamos que has escrito tu propia clase de texto, que utiliza la clase de documento article.cls, pero en la que has cambiado el aspecto de los encabezados
de seccin. Si lo pones en un archivo myarticle.layout, la cabecera de este archivo
debera ser:
# % Do not delete the line below; configure depends on this
# \DeclareLATEXClass[article]{article (con mis encabezados)}
Esto declara la clase de texto myarticle, asociada con la clase de documento LATEX
article.cls, y cuya descripcin es article (con mis encabezados). Si la clase de
texto depende de varios paquetes, puedes declararla as:
# \DeclareLATEXClass[article,foo.sty]{article (con mis encabezados)}
Esto indica que la clase de texto utiliza el paquete foo.sty. Finalmente, tambin es
posible declarar clases para cdigo DocBook. Una declaracin tpica podra ser:
# \DeclareDocBookClass[article]{SGML (DocBook article)}
Anotar que estas declaraciones pueden llevar tambin un parmetro opcional que
declare el nombre de la clase de documento (pero no una lista).
As, para ser lo ms explcito posible, la forma de la declaracin del formato es:
#
7
\DeclareLATEXClass[class,package.sty]{descripcin del formato}
N. del T.: No borrar la lnea siguiente; la configuracin depende de ella
25

La clase solo debe especificarse si el nombre de archivo de la clase LATEX y el nombre
de archivo del formato son diferentes; si el nombre del archivo de clase no se especifica,
LYX simplemente supondr que es el mismo que el del archivo de formato.
Cuando la clase de texto se ha modificado segn tus necesidades, lo que debes
hacer es copiarla a LYXDir/layouts/ o a UserDir/layouts, ejecutar Herramientas .
Reconfigurar, y reiniciar LYX. Ahora la nueva clase de texto debera estar disponible
junto con las dems.
Una vez instalado el layout, puedes editarlo y ver los cambios sin tener que reconfigurar ni reiniciar LYX. 8 Se puede forzar la recarga del formato en uso mediante la
funcin LYX layout-reload. No hay atajo predeterminado para esta funcin aunque
por supuesto, puedes asociarle t mismo una secuencia de teclas. Normalmente
usars esta funcin introducindola simplemente en el mini-buffer.
Aviso: Esto es mucho ms que una caracterstica avanzada. Es muy recomendable que no intentes editar tu formato mientras ests trabajando en un documento
importante. Usa un documento de prueba. Los errores sintcticos y similares en tu
archivo de formato podran provocar comportamientos extraos. En particular, tales errores podran provocar que LYX vea el formato actual como invlido e intente
cambiar a algn otro.9 El equipo LYX procura que LYX se mantenga estable en estos
casos, pero es mejor prevenir que curar.10
5.3.2.
Declaracin de un mdulo
Un mdulo debe empezar con una lnea como la siguiente:

#\DeclareLYXModule[endnotes.sty]{Endnotes}
El argumento imprescindible es, entre llaves, el nombre del mdulo tal como deber
aparecer en Documento . Configuracin . Mdulos. El argumento entre corchetes es
opcional: declara cualesquiera paquetes LATEX de los que depende el mdulo. Ten en
cuenta que solo los paquetes de los que LYX tiene constancia deberan listarse entre
los corchetes.11 LYX no comprobar paquetes arbitrarios. Tambin es posible usar
la forma from->to como argumento opcional, que declara que el mdulo solo puede
usarse cuando existe una cadena de conversin entre los formatos from y to.
La declaracin del mdulo debe proseguir con lneas como las siguientes:12
#DescriptionBegin
8
En versiones de LYX anteriores a 1.6 no era as. Como resultado, la edicin de archivos de formato
poda llevar mucho tiempo, pues constantemente haba que reconfigurar y reiniciar.
9
En realidad, los errores en la sintaxis pueden causar incluso el cierre de LYX, porque ciertos tipos
de error pueden hacer que LYX sea incapaz de leer cualquier informacin de formato. Por favor
ten cuidado.
10
De todos modos, haz copias de seguridad regularmente. Y s bueno con mam.
11
La lista de tales paquetes solo est documentada en el cdigo fuente.
12
Preferiblemente en ingls si el mdulo se va a publicar en LYX. Esta descripcin aparecer en la
lista de mensajes para ser traducidos en la siguiente actualizacin de la interfaz.
26

#Adds an endnote command, in addition to footnotes.
#You will need to add \theendnotes in TEX code where you
#want the endnotes to appear.
#DescriptionEnd
#Requires: somemodule | othermodule
#Excludes: badmodule
La descripcin se usa en Documento . Configuracin . Mdulos para proporcionar al
usuario informacin sobre las acciones del mdulo. La lnea Requires sirve para
identificar otros mdulos con los que se debe usar este; la lnea Excludes identifica los
mdulos con los que este no se puede usar. Ambas son opcionales, y, como se ve, varios
mdulos deben separarse con el smbolo tubera: |. Anotar que los mdulos requeridos
se tratan de forma disyuntiva: debe usarse al menos uno de los mdulos requeridos.
Y no se puede usar ningn mdulo excluido. Aqu, los mdulos se identifican por sus
nombres de archivo sin la extensin .module. Por tanto, somemodule es realmente
somemodule.module.
5.3.3.
Nmero de formatoLa primera lnea no comentada de

cualquier archivo layout, inc o module debe contener
el nmero de formato del archivo:
Format [int] El nmero de formato del archivo layout.

Esta etiqueta se introdujo en LYX 1.4.0. Los archivos de formato de LYX 1.3.x y
anteriores no tienen un nmero explcito y se considera de formato 1. El nmero
para la versin actual de LYX es formato 21. Cada versin de LYX es capaz de
leer los formatos de versiones anteriores, de la misma forma que puede leer archivos
producidos con versiones de LYX anteriores. Sin embargo, no est previsto convertir a
formatos anteriores. Por tanto, LYX 1.6.x no podr leer archivos de formato nmero
21, solo archivos en formato 11 o anteriores.
5.3.4.
Parmetros generales de clases de texto
Estos son los parmetros generales que describen completamente una clase de documento. (Esto no significa que deban aparecer en archivos .layout en vez de en
mdulos. Un mdulo puede contener cualquier etiqueta de formato).
AddToHTMLPreamble Aade informacin para el bloque <head> cuando esta clase de
documento se exporte a XHTML. Tpicamente, debera usarse para exportar
informacin de estilo CSS, aunque se puede usar para cualquier cosa que pueda
aparecer en <head>. Debe acabar con EndPreamble.
AddToPreamble Aade informacin al prembulo del documento. Debe terminar con
EndPreamble.
27

CiteFormat Define formatos a usar en la presentacin de informacin bibliogrfica.
Vase la seccin 5.3.12 para detalles. Debe terminar con End.
ClassOptions Describe varias opciones globales soportadas por la clase de documento. Vase la seccin 5.3.5 para una descripcin. Debe terminar con End.
Columns [1 , 2] Establece el nmero de columnas por omisin. Se puede cambiar en
el dilogo Documento . Configuracin.
Counter Esta secuencia define un nuevo contador. Vase la seccin 5.3.10 para detalles. Debe terminar con End.
DefaultFont Establece la tipografa por omisin para presentar el documento. Vase
la seccin 5.3.11 para cmo declarar tipografas. Debe terminar con EndFont.
DefaultModule [string] Especifica un mdulo que se incluir por omisin en esta
clase de documento; deber declararse por su nombre de archivo sin la extensin
.module. El usuario puede, an as, quitar el mdulo, pero estar activo al
principio. (Esto se aplica solo cuando se crean archivos nuevos, o si esta clase
se elige para un documento existente.)
DefaultStyle [string] Este es el estilo que ser asignado a prrafos nuevos, generalmente Normal. Si no se especifica, se escoger por omisin el primer estilo
definido, pero es muy recomendable usar esta instruccin.
ExcludesModule [string] Indica que el mdulo en cuestin que debera especificarse por el nombre de archivo sin la extensin .module no puede utilizarse
con esta clase de documento. Esto podra usarse en un archivo de formato
especfico de una publicacin para, digamos, impedir el empleo del mdulo
theorems-sec, que numera los teoremas y dems por secciones. Esta etiqueta no puede utilizarse en un mdulo. Los mdulos tienen su propia forma de
excluir otros mdulos (vase 5.2.1).
Float Define un nuevo flotante. Vase la seccin 5.3.8 para detalles. Debe terminar
con End.
HTMLPreamble Da informacin para el bloque <head> cuando esta clase de documento se exporte a XHTML. Advertir que esto sobrescribir completamente
cualquier declaracin anterior de HTMLPreamble o AddToHTMLPreamble. (Usa
AddToHTMLPreamble si solo quieres aadir material al prembulo). Debe acabar con EndPreamble.
HTMLTOCSection [string] Formato del ndice general, bibliografa, etc., cuando el
documento se exporte a HTML. Para article, normalmente ser Seccin; para
book, Captulo. Si no se especifica, LYX intentar deducir qu formato usar.
28

IfCounter [string] Modifica las propiedades del contador dado. Si el contador no
existe, esta seccin se ignora. Debe acabar con End.
Vase la seccin 5.3.10 para ms detalles.
IfStyle [string] Modifica las propiedades del estilo de prrafo dado. Si el estilo no
existe, esta seccin se ignora. Debe acabar con End.
Input Como su nombre indica, este comando permite incluir otro archivo de definicin de formato en el tuyo con el fin de evitar la duplicacin de comandos.
Ejemplos habituales son los archivos de formatos estndar, como stdclass.inc,
que contiene la mayora de los diseos bsicos.
InsetLayout Esta seccin (re)define el formato de un recuadro. Puede aplicarse a
uno existente o a uno nuevo, definido por el usuario, p. e., un nuevo estilo de
texto. Vase la seccin 5.3.9 para ms informacin. Debe terminar con End.
LeftMargin [string] Una cadena que indica la anchura del margen izquierdo en la
pantalla, por ejemplo MMMMM. (Esto no es una longitud, como 2ex.
NoCounter [string] Este comando elimina un contador existente, generalmente uno
definido en un archivo incluido.
NoFloat Este comando borra un flotante existente. Es particularmente til si quieres
suprimir un flotante que ha sido definido en un archivo de entrada.
NoStyle Este comando borra un estilo existente. Es particularmente til si quieres
suprimir un estilo que ha sido definido en un archivo de entrada.
OutputFormat Una cadena que indica el formato de archivo (tal como se define
en el dilogo Preferencias) producido por esta clase. Principalmente, es til
cuando OutputType es literate y se quiere definir un nuevo tipo de documento
literate. Esta cadena se redefine a docbook, latex, o literate si se encuentra
el correspondiente parmetro OutputType.
OutputType Una cadena que indica qu clase de documentos de salida que usan
esta clase se generarn. Por el momento, las opciones son : docbook, latex,
y literate.
PageStyle [plain , empty, headings] El estilo de pgina predeterminado de la clase.
Puede cambiarse en el dilogo Documento . Configuracin.
Preamble Establece el prembulo LATEX para el documento. Anotar que esto anular
completamente cualesquiera declaraciones Premable o AddToPreamble anteriores. (Usa AddToPreamble si solo quieres aadir material al prembulo). Debe
terminar con EndPreamble.
29

Provides [string] [0 , 1] Si la clase ya proporciona, o no, la caracterstica string.
Una caracterstica es en general el nombre de un paquete (amsmath, makeidx,
. . . ) o una macro (url, boldsymbol,. . . ); la lista completa de caractersticas
soportadas no est documentada, desafortunadamente, fuera del cdigo fuente
de LYX vase LATEXFeatures.cpp si hay inters. Ayuda . Configuracin de
LATEX tambin ofrece un vistazo de los paquetes soportados.
ProvidesModule [string] Indica que este formato proporciona la funcionalidad del
mdulo mencionado, que deber especificarse con su nombre de archivo sin la
extensin .module. Esto se usar tpicamente si el formato incluye el mdulo
directamente, preferiblemente a usar la etiqueta DefaultModule para indicar
que debera utilizarse. Podra ser empleado en un mdulo que provea una implementacin alternativa de la misma funcionalidad.
Requires [string] Si la clase requiere la caracterstica string. Mltiples caractersticas deben separarse con comas. Multiple features must be separated by
commas. Anotar que solo se pueden demandar caractersticas soportadas.
RightMargin [string] Una cadena que indica la anchura del margen derecho en la
pantalla, por ejemplo, MMMMM.
SecNumDepth [int=3] Establece qu divisiones se numeran. Corresponde al contador
LATEX secnumdepth.
Sides [1, 2] Si debe imprimirse en una o en ambas caras del papel. Se puede cambiar
en el dilogo Documento . Configuracin.
Style [<nombre>] Esta secuencia define un nuevo estilo de prrafo. Si el estilo ya
existe, en ese caso se redefinirn algunos de los parmetros. Vase la seccin 5.3.6
para detalles. Debe terminarcon End.
TitleLatexName [string="maketitle"] El nombre del comando de entorno a usar
con TitleLatexType.
TitleLatexType [CommandAfter , Environment] Indica qu clase de diseo se emplea para definir el ttulo de un documento. CommandAfter significa que la macro
con nombre TitleLatexName se insertar despus del ltimo formato que tiene
InTitle 1. Environment corresponde al caso en que todos los formatos que
tienen InTitle 1 debera ser incluido en el entorno TitleLatexName.
TocDepth [int=3] Establece qu divisiones se incluyen en el ndice general. Corresponde al contador LATEX tocdepth.
5.3.5.
Seccin ClassOptions
La seccin ClassOptions puede contener las siguientes entradas:
30

FontSize [string="10|11|12"] La lista de los tamaos de carcter disponibles para
la tipografa principal del documento, separados por |.
Header Para establecer la lnea DTD con las clases con salida basada en XML. P. e.:
PUBLIC -//OASIS//DTD DocBook V4.2//EN.
Other [string=""] Algunas opciones de clase de documento, separadas por coma,
que se aadirn a la parte opcional del comando \documentclass.
PageStyle [string="empty|plain|headings|fancy"] Lista de los estilos de pgina
disponibles, separados por |.
La seccin ClassOptions debe terminar con End.
5.3.6.
Estilos de prrafo
Una descripcin de estilo de prrafo tiene una aspecto como ste:13

Style name
...
End
donde se permiten los comandos siguientes:
Align [block, left, right, center] Alineacin del prrafo.
AlignPossible [block, left, right, center] Una lista separada con comas de
alineaciones permitidas. (Algunos estilos de LATEX prohiben ciertos alineamientos, ya que no tendran sentido. Por ejemplo una alineacin a la derecha o al
centro de una lista numerada no es posible).
BabelPreamble Esto sobrescribir completamente cualquier anterior declaracin
BabelPreamble para este estilo. Debe terminar con EndBabelPreamble. Vase
la seccin 5.3.7 para detalles sobre su uso.
BottomSep [float=0]14 El espacio vertical con el que el ltimo de una cadena de
prrafos con este estilo se separa del siguiente prrafo. Si el prrafo siguiente
tiene otro estilo, las separaciones no son simplemente aadidas sino que se pone
la mxima.
Category [string] La categora para este estilo. Se usa para agrupar estilos relacionados en el recuadro de estilo en la barra de herramientas. Se puede poner
cualquier cadena en string pero mejor usar categoras existentes con tus propios estilos.
13
14
Anotar que esto definir un nuevo diseo o modificar uno existente.

Anotar que aqu un float es un nmero real, como: 1.5.
31

CommandDepth Profundidad del comando XML. Usado solo con formatos tipo XML.
CopyStyle [string] Copia todas las caractersticas de un estilo existente en el actual.
DependsOn [<nombre>] El nombre de un estilo cuyo prembulo debera salir antes
que ste. Esto permite asegurar un orden de los retazos de prembulo si las
definiciones de macros dependen de otra.15
EndLabeltype [No_Label, Box, Filled_Box, Static] El tipo de etiqueta que se
pone al final del prrafo (o secuencia de prrafos si LatexType es Environment,
Item_Environment o List_Environment). No_Label quiere decir nada, Box
(resp. Filled_Box) es un cuadrado blanco (resp. negro) adecuado para marcas
finales de demostraciones, Static es una cadena de texto explcito.
EndLabelString [string=""] La cadena usada para una etiqueta con un Static
EndLabelType.
16
Font La tipografa usada para el cuerpo del texto y para la etiqueta. Vase la seccin 5.3.11. Anotar que al definir esta tipografa se define automticamente la
de la etiqueta, LabelFont. As que debera definirse primero sta si se quiere
definir tambin LabelFont.
FreeSpacing [0, 1] Usualmente LYX no permite insertar ms de un espacio entre
palabras, puesto que un espacio se considera como la separacin entre dos palabras, no un carcter o smbolo por s mismo. Esto es una buena cosa pero a
veces puede ser molesta, por ejemplo, para escribir cdigo de programas o de
LATEX puro. Por esta razn se puede habilitar FreeSpacing. Anotar que LYX
crear espacios protegidos para los espacios adicionales en modos que no sean
LATEX.
HTML* Para la salida XHTML. Vase 5.4.1.
InnerTag [[FIXME]] (Usado solo con formatos tipo XML.)
InPreamble [0, 1] Si 1, marca el estilo para ser incluido en el prembulo del documento en lugar de en el cuerpo del documento. til para clases de documento
que piden informaciones tales como ttulo y autor en el prembulo. Esto solo
funciona para estilos para los que LatexType es Command o Paragraph.
InTitle [0, 1] Si es 1, marca el estilo como parte de un bloque de ttulo (vanse
tambin las entradas globales TitleLatexType y TitleLatexName).
15
Anotar que, excepto esta funcionalidad, no hay forma de asegurar ningn orden de los prembulos.
El orden que se ve en una versin dada de LYX puede cambiar sin previo aviso en versiones
posteriores.
32

ItemSep [float=0] Esto proporciona espacio extra entre prrafos que tienen el mismo formato. Si se ponen otros formatos en un entorno, cada uno es separado
con el comando de entorno ParSep. Pero el conjunto de los tems del entorno
son separados adicionalmente con este ItemSep. Anotar que esto es un multiplicador.
ItemTag [[FIXME]] (Usado solo con formatos tipo XML.)
KeepEmpty [0, 1] Habitualmente, LYX no permite dejar un prrafo vaco, porque llevara a una salida de LATEX vaca. Sin embargo, hay algunos casos donde podra
ser til: en una plantilla de carta, los campos requeridos pueden proporcionarse
vacos, as el usuario no los olvida; en algunos casos especiales, se puede usar
un estilo que no contiene texto real como una especie de salto.
LabelBottomsep [float=0] El espacio vertical entre la etiqueta y el cuerpo del texto.
Solo se usa para etiquetas que estn sobre el cuerpo del texto (Top_Environment
y Centered_Top_Environment).
LabelCounter [string=""] El nombre del contador para numeracin automtica.
Esto debe ponerse si LabelType es Counter. En ese caso, el contador avanzar
un paso cada vez que que aparezca el estilo.
Esto puede ponerse tambin si LabelType es Enumerate, aunque este caso es
un poco complicado. Supongamos que declaras LabelCounter myenum. Entonces, los contadores reales usados son myenumi, myenumii, myenumiii, y
myenumiv, como en LATEX. Estos contadores deben declararse todos por separado.
Vase la seccin 5.3.10 para detalles sobre contadoresLabelFont La tipografa
usada para la etiqueta. Vase la seccin 5.3.11.
LabelIndent [string=""] Texto que indica cunto se debe sangrar una etiqueta.
LabelSep [string=""] Texto que indica el valor de espacio horizontal entre la etiqueta y el cuerpo del texto. Solo se usa para etiquetas que no estn sobre el
cuerpo del texto.
LabelString [string=""] La cadena usada para una etiqueta del LabelType Static.
Si LabelCounter est establecido, esta cadena puede contener los comandos especiales de formato descritos en la seccin 5.3.10.
LabelStringAppendix [string=""] Esta se usa en el apndice en vez de LabelString.
Anotar que toda declaracin de LabelString reconfigura tambin
LabelStringAppendix.
LabelTag [FIXME] (Usado solo con formatos tipo XML.)
LabelType [No_Label, Manual, Static, Top_Environment,
Centered_Top_Environment, Counter, Sensitive, Enumerate,
Itemize, Bibliography]
33

Manual significa que la etiqueta es la primera palabra (hasta elprimer espacio
real). Usa espacios protegidos si quieres ms de una palabra como etiqueta.
Static significa que la etiqueta es simplemente cualquier LabelString declarado como tal. Esto es realmente esttico.
Top_Environment y Centered_Top_Environment son casos especiales de
Static. La etiqueta se imprimir encima del prrafo, pero solo encima de
un entorno o de una cadena de prrafos con este estilo. Esto se podra usar
con el estilo Resumen, por ejemplo.
Sensitive es un caso especial para las etiquetas de las leyendas de Figura y
Tabla. Sensitive quiere decir que la cadena (en cdigo) de la etiqueta
depende de la clase de flotante: Est codificado para ser FloatType N,
donde N es el valor del contador asociado al flotante.
Counter define automticamente etiquetas numeradas. LabelString se expandir para resolver cualesquiera referencias a contadores que haya: por ejemplo, podra ser Section \thechapter.\thesection. Vase la seccin
5.3.10 para ms informacin.
Enumerate produce los tipos habituales de etiquetas de enumeracin. Por ahora
est codificado para usar nmeros arbigos, minsculas, nmeros romanos
en minsculas y maysculas, respectivamente, para los cuatro niveles de
profundidad posibles.
Itemize produce varias marcas para los distintos niveles. Tambin est codificado.
Bibliography se usa internamente por LYX y solo debera emplearse con
LatexType BibEnvironment.
LangPreamble Esto sobrescribir completamente cualquier declaracin anterior de
LangPreamble para este estilo. Debe acabar con EndLangPreamble. Vase la
seccin 5.3.7 para detallessobre su uso.
LatexName [<nombre>] El nombre correspondiente en LATEX, ya sea de un comando
o de un entorno.
LatexParam [<parmetro>] Un parmetro opcional para el correspondiente LatexName.
Este parmetro no se puede cambiar desde dentro de LYX.
LatexType [Paragraph, Command, Environment, Item_Environment,
List_Environment, Bib_Environment] Cmo debera traducirse el estilo a
LATEX.17
Paragraph no significa nada especial.
17
LatexType es un poco engaoso porque estas reglas se aplican tambin a clases SGML. Consulta
los archivos de clases SGML para ejemplos concretos.
34

Command significa \LatexName {...}.
Environment significa \begin{LatexName }...\end{LatexName }.
Item_Environment eslo mismo que Environment, excepto que un \item se
genera para cada prrafo de este entorno.
List_Environment es lo mismo que Item_Environment, excepto que
LabelWidthString se pasa como un argumento al entorno.
LabelWidthString puede definirse en el dilogo Editar . Configuracin de prrafos.
Bib_Environment is like Environment but adds additionally the necessary
mandatory argument to the begin statement of the bibliography environment:
\begin{thebibliography}{99} It is therefore only useful for bibliography environments.
Poniendo juntas las ltimas cosas, la salida LATEX ser una de estas:
\LatexName[LatexParam]{...}
o:
\begin{LatexName}[LatexParam] ... \end{LatexName}.
dependiendo del tipo de LATEX.
LeftMargin [string=""] Si pones estilos en entornos, los LeftMargin no son sim4
. Anotar que este paplemente aadidos, sino aumentados en un factor depth+4
rmetro se usa tambin cuando Margin se define como Manual o Dynamic. En
ese caso se aade al margen manual o dinmico.
Por ejemplo MM significa que el prrafo se sangra con la anchura de MM en
la tipografa normal. Se puede obtener una anchura negativa anteponiendo -
a la cadena. Se eligi este mtodo para que el aspecto sea el mismo con cada
una de las tipografas de pantalla usadas.
Margin [Static, Manual, Dynamic, First_Dynamic, Right_Address_Box]
El tipo de margen que el estilo tiene en el lado izquierdo.
Static significa un margen fijo.
Manual significa que el margen izquierdo depende de la cadena introducida en el
dilogo Editar . Configuracin del prrafo. . . . Esto se utiliza para componer
bonitas listas sin tabuladores.
Dynamic significa que el margen depende del tamao de la etiqueta. Esto se usa
para las cabeceras automticas de las listas numeradas. Es obvio que la
cabecera 5.4.3.2.1 Cabecera muy larga debe tener un margen izquierdo
ms amplio (tan ancho como 5.4.3.2.1 ms el espacio) que 3.2 Cabecera
muy larga, aunque los procesadores de texto corrientes no sean capaces
de hacer esto.
35

First_Dynamic es similar, pero solo la primera fila del prrafo es dinmica,
mientras que las dems son estticas; esto se emplea, por ejemplo, para
descripciones.
Right_Address_Box significa que el margen se elige de manera que la fila ms
larga de este prrafo se adapte al margen derecho. Esto se emplea para
componer una direccin en el lado derecho de la pgina.
NeedProtect [0 , 1] Si los comandos frgiles en este estilo deberan ser protegidos,
\protect. (Nota: es no si este comando debera l mismo ser protegido.)
Newline [0, 1 ] Si las lneas nuevas se transforman en lneas nuevas LATEX (\\) o no.
La transformacin puede desactivarse para permitir una edicin ms confortable
de LATEX en LYX.
NextNoIndent [0 , 1] Si se permite sangrar la primera fila del prrafo siguiente. 1
significa que no se permite hacerlo; 0 significa que puede hacerse si se desea.
ObsoletedBy [<nombre>] Nombre de un estilo que ha reemplazado este estilo. Esto
se emplea para renombrar un estilo, mientras que se mantiene compatibilidad
hacia atrs.
OptionalArgs [int=0] El nmero de argumentos opcionales que puede usarse con
este estilo. Es til para cosas como encabezados de seccin, y solo tiene sentido con LATEX. En la salida, los argumentos opcionales precedern todos a los
argumentos requeridos (abajo). As que podemos tener construcciones como:
\mycmd[opt1]{req1}{contenido del prrafo}
pero no cosas como:
\mycmd[opt1]{req1}[opt2]{contenido del prrafo}
al menos, no sin ERT (con lo que puedes tener cualquier cosa).
ParbreakIsNewline [0 , 1] Indica que los prrafos no sern separados por una lnea
vaca en la salida LATEX, solo por un salto de lnea; junto con PassThru 1, esto
permite emular un editor de texto simple (como un recuadro ERT).
ParIndent [string=""] El sangrado de la primera lnea de un prrafo. Parindent
estar fijado para un determinado estilo. La excepcin es el estilo Normal,
puesto que la sangra de un prrafo de estilo Normal puede prohibirse con
NextNoIndent. Adems, los prrafos de estilo Normal dentro de entornos usan
la sangra Parindent del entorno, no su propio valor. Por ejemplo, los prrafos
Normal en una enumeracin no se sangran.
ParSep [float=0] El espacio vertical entre dos prrafos de este estilo.
36

Parskip [float=0] LYX permite al usuario elegir entre sangrado o espacio vertical para separate paragraphs. Si se elige sangrado, este valor es completamente ignorado. Si se elige espacio vertical, el sangrado de un estilo tipo
Prrafo de LATEX se ignora y todos los prrafos son separados con este argumento parskip. El espacio vertical se calcula con Parskip * DefaultHeight,
donde DefaultHeight es la altura de una fila con la tipografa normal. De esta
forma, el aspecto queda igual con diferentes tipografas de pantalla.
PassThru [0, 1] Si el contenido de este prrafo debera aparecer en la salida en forma
cruda, es decir sin las traducciones especiales que LATEX necesitara.
Preamble Informacin a incluir en el prembulo LATEX cuando se usa este estilo.
Utilizado para definir macros, paquetes a cargar, etc., requeridos por este estilo
en particular. Debe terminar con EndPreamble.
RefPrefix [string] El prefijo a usar cuando se crean etiquetas que se refieren a
prrafos de este tipo. Esto permite el uso de referencias con formato.
RequiredArgs [int=0] El nmero de argumentos requeridos que el comando LATEX
o el entorno correspondiente a este estilo esperan. En el caso de un comando,
estos son argumentos requeridos que no sean los asociados con el contenido del
prrafo mismo. Estos no se tienen que proporcionar realmente: LYX exportar
argumentos vacos si es necesario. Los argumentos opcionales se exportarn antes que los requeridos. Vase la discusin de la etiqueta anterior OptionalArgs
para ms informacin.
Requires [string] Si el estilo requiere la caracterstica string. Vase arriba (sec. 5.3.4)
la descripcin de Provides para informacin sobre caractersticas.
RightMargin [string=""] Similar a LeftMargin.
Spacing [single , onehalf, double, other <valor>] Esto define cul debera ser el
espacio predefinido en el estilo. Los argumentos single, onehalf y double corresponden respectivamente a un multiplicador de 1, 1.25 y 1.667. Si se especifica
el argumento other, entonces se debera proporcionar adems un argumento
numrico que ser el valor real del multiplicador. Anotar que, al contrario que
otros parmetros, Spacing implica la generacin de cdigo LATEX especfico,
usando el paquete LATEX setspace.
Spellcheck [0, 1 ] Correccin ortogrfica de prrafos de este estilo. Por omisin, s.
TextFont La tipografa para el cuerpo del texto. Vase la seccin 5.3.11.
TocLevel [int=3] El nivel del estilo en el ndice general. Esto se usa para la numeracin automtica de los encabezados de seccin.
37

TopSep [float=0] El espacio vertical con el que el primero de una cadena de prrafos
con este estilo se separa del prrafo anterior. Si el prrafo anterior tiene otro
estilo, la separacin no es simplemente aadida, sino que se pone la mxima.
5.3.7.
Internacionalizacin de estilos de prrafo
LYX ha soportado desde hace tiempo la internacionalizacin de la informacin de

formato, pero, hasta la versin 2.0, esto se aplicaba solo a la interfaz de usuario y
no a la salida, digamos, PDF. As, por ej., autores franceses tenan que acudir a feos
trucos para conseguir Thorme 1 en vez de Theorem 1. Gracias a Georg Baum,
este ya no es el caso.
Si un Style define texto que se mostrar en el documento exportado, puede usar
LangPreamble y BabelPreamble para soportar correctamente documentos con idioma distinto del ingls e incluso documentos plurilinges. El siguiente extracto (del
archivo theorems-ams.inc) muestra cmo funciona:
Preamble
\theoremstyle{remark}
\newtheorem{claim}[thm]{\protect\claimname}
EndPreamble
LangPreamble
\providecommand{\claimname}{_(Claim)}
EndLangPreamble
BabelPreamble
\addto\captions$$lang{\renewcommand{\claimname}{_(Claim)}}
EndBabelPreamble
En principio, cualquier LATEX legal puede aparecer en las etiquetas LangPreamble y
BabelPreamble, pero en la prctica el aspecto ser generalmente como el mostrado
aqu. La clave para una correcta traduccin del texto impreso es la definicin del
comando LATEX \claimname y su uso en \newtheorem.
La etiqueta LangPreamble proporciona internacionalizacin basada en el idioma
global del documento. El contenido de la etiqueta se incluir en el prembulo, igual
que con la etiqueta Preamble. Lo que la hace especial es el uso de la funcin _(),
que ser reemplazada, cuando LYX genere la salida LATEX, por la traduccin de su
argumento al idioma del documento.
La etiqueta BabelPreamble es ms compleja, puesto que est pensada para dar
soporte a documentos plurilinges y ofrece una interfaz al paquete babel. Su contenido se aadir al prembulo una vez por cada idioma que aparezca en el documento.
En este caso, el argumento en _() se reemplazar por su traduccin al idioma en
cuestin; la expresin $$lang es reemplazada por el nombre del idioma (el usado por
el paquete babel).
Un documento en alemn que tambin incluya una seccin en francs tendra lo
siguiente en el prembulo:
38
\addto\captionsfrench{\renewcommand{\claimname}{Affirmation}}
\addto\captionsngerman{\renewcommand{\claimname}{Behauptung}}
\providecommand{\claimname}{Behauptung}
LATEX y babel conspirarn para producir el texto correcto en la salida.
Un punto importante a tener en cuenta aqu es que las traducciones son proporcionadas por el propio LYX, por medio del mismo mecanismo empleado para la
internacionalizacin de la interfaz de usuario. Esto quiere decir, en definitiva, que
LangPreamble y BabelPreamble realmente solo son tiles en archivos de formato
que son proporcionados por LYX, puesto que el texto introducido en archivos de
formato creados por el usuario no sern tenidos en cuenta por las rutinas de internacionalizacin de LYX. Sin embargo, cualquier formato creado con la intencin de ser
incluido en LYX debera usar estas etiquetas en los lugares apropiados.
5.3.8.
Flotantes
Es necesario definir los flotantes (figura, cuadro, . . . ) en la propia clase de texto.

Los flotantes normales se incluyen en el archivo stdfloats.inc, as que no tendrs
ms que aadir
Input stdfloats.inc
en tu archivo de formato. Si quieres implementar una clase de texto que proponga
algn otro tipo de flotante (como la clase AGU empaquetada con LYX), la informacin
siguiente te servir de ayuda:
Extension [string=] La extensin del nombre de un archivo auxiliar para la lista
de figuras (u otra cosa). LATEX escribe las leyendas en este archivo.
GuiName [string=] La cadena que se usar en los mens y tambin para la leyenda.
Esto se traduce al idioma actual si se usa.
HTML* Controlan la salida XHTML. Vase la seccin 5.4.
IsPredefined [0, 1] Indica si el flotante est ya definido en la clase de documento
o si necesitamos cargar el paquete LATEX float para definirlo sobre la marcha.
Por omisin 0, que significa: usar float. Deber ponerse 1 si el flotante ya est
definido por la clase de documento LATEX.
ListCommand [string=] El comando usado para generar una lista de flotantes de
este tipo; debe omitirse el precedente \. Esto debe ponerse si UsesFloatPkg
es false, puesto que no hay una forma estndar de generar este comando. Se
ignora si UsesFloatPkg es true, porque en este caso s hay una forma estndar
de definir el comando.
39

ListName [string=] Un ttulo para una lista de flotantes de este tipo (ndice de
figuras, tablas o lo que sea). Se usa para el nombre del recuadro en LYX; se
pasa a LATEX para usarlo como ttulo all; y se usa como ttulo en la salida. Ser
traducido al idioma del documento.
NumberWithin [string=] Este argumento (opcional) determina si los flotantes de
esta clase sern numerados dentro de alguna unidad de seccin del documento.
Por ejemplo, si NumberWithin es chapter, los flotantes sern numerados
dentro de los captulos.
Placement [string=] La colocacin por omisin para la clase dada de flotantes. El
valor de string deber ser un estndar LATEX: t, b, p y h, por top (arriba),
bottom (abajo), page (pgina), y here (aqu), respectivamente.18 Por
encima de stos hay un nuevo tipo, H, que no corresponde realmente a un
flotante, ya que se refiere a: ponerlo aqu, here, y en ninguna otra parte.
Anotar que, sin embargo, el colocador H es especial y, debido a detalles de
implementacin, no puede usarse en tipos de flotantes no empotrados. Si no
comprendes lo que esto significa, usa solo tbp.
RefPrefix [string] El prefijo a usar cuando se crean etiquetas referidas a flotantes
de este tipo. Esto permite el uso de referencias con formato. Puedes quitar cualquier RefPrefix puesto por un estilo copiado usando el valor especial OFF,
todas maysculas.
Style [string=] El estilo usado cuando se define el flotante con \newfloat.
Type [string=] El tipo de la nueva clase de flotante, como programa o algoritmo. Despus del apropiado \newfloat, comandos tales como \begin{program}
o \end{algorithm*} estarn disponibles.
UsesFloatPkg [0, 1 ] Nos dice si este flotante se define usando el paquete LATEX
float, bien por el archivo de clase o por un paquete, o bien sobre la marcha
por el propio LYX.
Anotar que al definir un flotante con tipo type automticamente se define el correspondiente contador con nombre type .
5.3.9.
Recuadros flexibles y formato del recuadro
Los recuadros flexibles son de tres tipos:

estilo del texto (CharStyle): estos definen diseos semnticos correspondientes
a comandos LATEX como \noun y \code.
18
Anotar que el orden de estas letras en la cadena es irrelevante, como en LATEX.
40

definido por el usuario (Custom): estos se pueden usar para definir recuadros
plegables personalizados, del tipo de los de cdigo TEX, notas al pie y similares.
Un ejemplo obvio es un recuadro de nota final, definido en el mdulo del mismo
nombre (endnotes).
elementos XML (Element): para usar con las clases DocBook.
Los recuadros flexibles se definen usando la etiqueta InsetLayout, que se explicar
en un momento.
La etiqueta InsetLayout tambin sirve para otra funcin: puede utilizarse para
personalizar el diseo general de muchos tipos diferentes de recuadros. Actualmente,
InsetLayout permite personalizar los parmetros de diseo de notas al pie, notas
al margen, notas, recuadros de cdigo TEX (ERT), ramas, listados de programa,
ndices, cuadros, tablas, algoritmos, URL, y argumentos opcionales, as como para
definir recuadros flexibles.
La definicin de InsetLayout debe comenzar con una lnea de la forma:
InsetLayout <type>
Aqu, <Type> indica el recuadro cuyo formato se va a definir, y hay dos casos.
1. Se va a modificar el formato para un tipo de recuadro preexistente. En este
caso,<type> puede ser uno cualquiera de los siguientes: Algorithm, Branch,
Box, Box:shaded, ERT, Figure, Foot, Index, Info, Info:menu, Info:shortcut,
Info:shortcuts, Listings, Marginal, Note:Comment, Note:Note,
Note:GreyedOut, OptArg, Table, o URL.
2. Se va a definir el formato para un recuadro flexible. En este caso, <type> puede
ser cualquier identificador vlido no utilizado por un recuadro preexistente.
El identificador puede incluir espacios, pero en este caso debe ponerse todo
entre comillas. Puede adems incluir un identificador de nombre del espacio,
precedido de dos puntos, como Flex:Code. Anotar que la definicin de un
flexible debe incluir adems una entrada LYXType.
La definicin de InsetLayout puede contener las siguientes entradas:
BgColor [<nombre>] El color para el fondo del recuadro. Los nombres colores vlidos
son definidos en src/ColorCode.h.
ContentAsLabel [0 , 1] Si usar no el contenido del recuadro como etiqueta del mismo
cuando el recuadro se cierra. Por omisin, falso.
CopyStyle [<type>] As with paragraph styles, vase seccin 5.3.6. Note that you
need to specify the complete type, e. g. CopyStyle Flex:<nombre>.
CustomPars [0 , 1] Indica si el usuario puede emplear el dilogo Configuracin del
prrafo para modificar el prrafo.
41

Decoration Puede ser Classic, Minimalistic, o Conglomerate, que describe el
estilo de presentacin para el marco y los botones del recuadro. Las notas al
pie usan generalmente Classic, los recuadros de cdigo TEX Minimalistic, y
los de estilos del texto Conglomerate.
Display [0, 1 ] Solo es til si LatexType es Environment. Indica si el entorno se
ubicar en su propio espacio en la salida o si aparecer en lnea con el texto
circundante. Si se pone falso, se supone que el entorno LATEX ignora los espacios
en blanco (incluyendo un carcter de lnea nueva) despus de las etiquetas
\begin{LatexName } y \end{LatexName }. Por omisin, verdadero.
End Requerido al final de las declaraciones de formato del recuadro InsetLayout.
Font La tipografa usada tanto para el cuerpo del texto como para la etiqueta. Vase
la seccin 5.3.11. Anotar que al definir esta tipografa se define automticamente
el mismo valor para la etiqueta, LabelFont, as que define aquella primero y
despus define LabelFont si las quieres diferentes.
ForceLTR [0 , 1] Fuerza el idioma latex que genera salida Izquierda-Derecha (latin),
p. e. en cdigo TEX o URL. Un parche.
ForcePlain [0 , 1] Indica si debera usarse PlainLayout o, por el contrario el usuario
puede cambiar el estilo de prrafo del recuadro.
FreeSpacing [0, 1] As with paragraph styles, vase seccin 5.3.6.
HTML* Controlan la salida XHTML. Vase la seccin 5.4.
InToc [0 , 1] Incluye o no el contenido de este inset en la cadena generada para el
panel Navegador de contorno. El no sera, por ejemplo, para que el contenido
de una nota al pie en un encabezado de seccin no aparezca en el ndice que se
despliega en el navegador de contorno, sin embargo, normalmente s se incluira
el contenido de un estilo de carcter. Predeterminado es false: no incluir.
KeepEmpty [0, 1] As with paragraph styles, vase seccin 5.3.6.
LabelFont La tipografa para la etiqueta. Vase la seccin 5.3.11. Anotar que esta
definicin nunca puede aparecer antes de Font, para que sea efectiva.
LabelString [string=] Lo que se mostrar sobre el botn u otra parte como etiqueta del recuadro. Algunos tipos de recuadro (cdigo TEX y Ramas) modifican
esta etiqueta sobre la marcha.
LatexName [<nombre>] El nombre LATEX correspondiente al asunto. Cualquier nombre de entorno o de comando.
LatexParam El parmetro opcional para el correspondiente LatexName, incluyendo
posibles pares de corchetes, []. Este parmetro no se puede cambiar desde
dentro de LYX.
42

LatexType As with paragraph styles, vase seccin 5.3.6.
LyxType Puede ser charstyle, custom, element, o end (indicando una definicin ficticia que finaliza definiciones de estilos de texto, etc). Esta entrada es requerida
y solo es significativa para recuadros flexibles. Entre otras cosas, determina en
qu mens aparecer este recuadro. Si LYXType es charstyle MultiPar es falso.
MultiPar se puede poner como verdadero para recuadros de estilos charstyle,
si ponindolo despus de LYXType.
MultiPar [0 , 1] Indica si se permiten mltiples prrafos en este recuadro. Adems
establecer para CustomPars el mismo valor y para ForcePlain el valor opuesto.
Estos pueden modificarse a otros valores si se usan despus de MultiPar.
NeedProtect [0 , 1] Si los comandos frgiles deben o no ser \protected en este
recuadro. (Nota: es no si el comando mismo debe ser protegido.)
ParbreakIsNewline [0 , 1] Igual que para estilos de prrafo, vase seccin 5.3.6. Por
omisin es falso.
PassThru [0, 1] Igual que para estilos de prrafo, vase seccin 5.3.6.
Preamble Igual que para estilos de prrafo, vase seccin 5.3.6.
RefPrefix [string] Prefijo a usar cuando se crean etiquetas que se refieren a recuadros de este tipo. Esto permite el uso de referencias con formato.
Requires
[string] Igual que para estilos de prrafo, vase seccin 5.3.6.
ResetsFont [0, 1 ] Si este recuadro debera usar la tipografa de su entorno o la suya

propia. Por omisin es su propia tipografa.
Spellcheck [0, 1 ] Revisar la ortografa del contenido del recuadro. Por omisin, s.
5.3.10.
Contadores
Es necesario definir los contadores (chapter, figure, . . . ) en la propia clase de texto.

Los contadores estndar estn definidos en el archivo stdcounters.inc, de modo
que no tienes ms que aadir
Input stdcounters.inc
en el archivo de formato para que funcionen. Pero si quieres puedes definir contadores
personalizados. La declaracin de un contador debe comenzar con:
Counter <nombre>
donde <nombre> es el nombre del contador. Hay que terminar con End.
Se pueden usar adems los parmetros siguientes:
43

LabelString [string=""] Si se define esta cadena, indica cmo se muestra el contador. Al establecer este valor tambin se da el mismo valor a LabelStringAppendix.
Para los valores de string se pueden usar las estructuras siguientes:
\thecounter ser reemplazado por la expansin de LabelString
(o LabelStringAppendix) del contador counter.
los valores del contador pueden expresarse usando macros tipo LATEX como \numbertype {counter }, donde numbertype puede ser: arabic: 1,
2, 3,. . . ; alph para minsculas: a, b, c, . . . ; Alph para maysculas: A, B,
C, . . . ; roman nmeros romanos en minscula: i, ii, iii, . . . 19 ; Roman para
romanos en maysculas: I, II, III.
Si no se define LabelString, se construye un valor por omisin as: si el contador
tiene un contador maestro master (definido mediante Within), se usa la cadena
\themaster.\arabic{counter}; si no, se usa la cadena \arabic{counter}.
LabelStringAppendix [string=""] Lo mismo que LabelString, pero para el apndice.
PrettyFormat [string=] Un formato para usar con las referencias a este contador.
Por ejemplo, podramos querer las referencias a los nmeros de seccin en la
forma Seccin 2.4. La cadena debera contener ##. Esto ser reemplazado
por el nmero correspondiente del contador. As pues, para secciones sera:
Section ##.
Within [string=""] Si esto se establece para el nombre de otro contador, el presente
contador se reiniciar cada vez que el otro aumente. Por ejemplo, subsection
se numera dentro de section.
5.3.11.
Descripcin de las tipografas
Una descripcin de una tipografa se ve como:

Font or LabelFont
...
EndFont
Estn disponibles los comandos siguientes:
Color [none , black, white, red, green, blue, cyan, magenta, yellow]
Family [Roman, Sans, Typewriter]
19
N. del T.: El estilo spanish de babel los transforma automticamente en versalitas, i, ii. . . , ya que
los romanos en minscula no se usan en espaol.
44

Misc [string] Son argumentos vlidos: emph, noun, strikeout, underbar, uuline,
uwave, no_emph, no_noun, no_strikeout, no_bar, no_uuline y no_uwave. Cada uno de ellos activa o desactiva el atributo correspondiente. Por ejemplo, emph
activa nfasis, y no_emph lo desactiva.
Si esto ltimo parece superfluo, recordemos que la configuracin de tipografas
para el presente contexto se hereda generalmente del contexto circundante. Por
eso no_emph desactivara el nfasis que estaba vigente, digamos, en un entorno
teorema.
Series [Medium, Bold]
Shape [Up, Italic, SmallCaps, Slanted]
Size [tiny, small, normal , large, larger, largest, huge, giant]
5.3.12.
Descripcin del formato de cita
Los bloques CiteFormat se usan para describir la forma en que debe mostrarse
la informacin bibliogrfica, tanto en LYX (en el dilogo de citas y en las ayudas
emergentes, por ejemplo) como en la salida XHTML. El aspecto de unode estos
bloques podra ser este:
CiteFormat
article ...
book ...
End
Las lneas definen cmo se va a mostrar la informacin bibliogrfica asociada con un
artculo o libro, respectivamente, y tales definiciones se pueden dar para cualquier
tipo de entrada que pudiera estar presente en un archivo BibTEX. LYX define un
formato por omsin en el cdigo fuente que se usar si no se da una definicin especfica. LYX predefine varios formatos en el archivo stdciteformats.inc, que se
incluye en la mayora de las clases de documento de LYX.
Las definiciones usan un lenguaje simple que permite reemplazar las claves BibTEX
por sus valores. Las claves deben encerrarse entre smbolos %, p. ej.: %author %. As,
una simple definicin sera:
misc %author %, %title.
Esto imprimira el autor, una coma, a continuacin el ttulo entre comillas y un punto
para finalizar.
A veces querrs, por supuesto, imprimir una clave solo si existe. Esto puede hacerse
mediante una construccin condicional tal como: { %volume %[[vol. %volume %]]},
que quiere decir: si la clave volume existe, imprime vol. seguido de la clave. Tambin
es posible tener una clusula de otro modo en el condicional, como:
45

{ %author %[[ %author %]][[ %editor %, ed.]]}
Aqu, la clave author se imprime si existe; por otra parte, se imprime la clave author
seguida por , ed.. Advierte que la clave se encierra entre signos %; el condicional
entero se encierra entre llaves; y las clusulas condicional y por otra parte se ponen
entre cobles corchetes, [[ y ]]. No debe haber espacios entre ninguno de ellos.
Hay otra pieza de sintaxis disponible en las definiciones, como esta: {!<i>!}. Define
una pieza de informacin para ser usada cuando creamos texto enriquecido. Obviamente, no queremos etiquetas HTML cuando escribimos texto sencillo, por tanto
deben ponerse entre {! y !}.
Adems, hay dos clases especiales de definiciones disponibles en un bloque CiteFormat.
Un ejemplo de la primera sera:
!quotetitle %title %
Esto es una abreviacin, o macro, y se puede usar tratndola como si fuera una
clave: %!quotetitle %. LYX tratar %!quotetitle % exactamente como tratara su
definicin. Por tanto, permtenos un aviso obvio. No hagas:
!funfun %funfun %
ni nada parecido. LYX no caera en un bucle infinito, pero s en uno muy largo.
El segundo tipo especial de definicin sera como:
_pptext pp.
Esto define un trozo de texto traducible, que permite traducir partes relevantes de la
bibliografa. Puede incluirse en una definicin tratndolo como una clave: %_pptext %.
Varios de estos estn predefinidos en stdciteformats.inc. Advertiremos que no son
macros en el sentido definido. No se expandirn.
Aqu hay, pues, un ejemplo que usa todas estas caractersticas:
!authoredit { %author %[[ %author %, ]][[{ %editor %[[ %editor %, %_edtext %,
]]}]]}
As definimos una macro que imprime el autor seguido de coma, si la clave author
est definida, o imprime el nombre del editor seguido por el texto _edtext o su
traduccin (por omisin ed.), si la clave editor est definida. De hecho, esto est
definido en stdciteformats.inc, por tanto puedes usarlo en tus propias definiciones
o redefiniciones, si cargas antes ese archivo.
5.4.
Etiquetas para la salida XHTML
Como para LATEX o DocBook, el formato de salida XHTML en LYX tambin se

controla mediante la informacin contenida en archivos de formato. En general, LYX
provee valores predefinidos sensatos y, como se mencion anteriormente, incluso construir reglas de estilo CSS a partir de las otras etiquetas de formato. Por ejemplo,
46
5.4 Etiquetas para la salida XHTML

LYX intentar usar la informacin proporcionada por la declaracin Font para el
estilo Chapter para escribir CSS que formatear adecuadamente los encabezados de
captulo.
En muchos casos, por tanto, no tendrs que hacer nada para obtener una aceptable salida XHTML para tus propios entornos, recuadros personalizados y cosas as.
Pero en ciertos casos querrs hacer cambios, y para eso LYX proporciona un nmero
de etiquetas de formato que se pueden usar para personalizar los XHTML y CSS
generados.
Advertimos que hay dos etiquetas, HTMLPreamble y AddToHTMLPreamble que pueden aparecer fuera de las declaraciones de estilos y recuadros. Vase 5.3.4 para detalles
sobre esto.
5.4.1.
Estilos de prrafo
El tipo de XHTML que genera LYX para un prrafo depende de si se trata de un

prrafo normal, de un comando o de un entorno, en los que esto se determina por el
contenido de la correspondiente etiqueta LATEXType.
Para un comando o prrafo, la salida XHTML tiene la forma siguiente:
<tag attr=value>
<labeltag attr=value>Label</labeltag>
Contents of the paragraph.
</tag>
Por supuesto, label tags se omiten si el prrafo no tiene rtulo.
Para un entorno que no sea algn tipo de lista, XHTML toma la forma:
<tag attr=value>
<itemtag attr=value><labeltag attr=value>Environment Label</labeltag>First pa
<itemtag>Second paragraph.</itemtag>
</tag>
El rtulo se genera solo para el primer prrafo, como debera ser, por ejemplo, para
un teorema.
Para una lista disponemos de una de estas formas:
<tag attr=value>
<itemtag attr=value><labeltag attr=value>List Label</labeltag>First item.</it
<itemtag attr=value><labeltag attr=value>List Label</labeltag>Second item.</i
</tag>
<tag attr=value>
<labeltag attr=value>List Label</labeltag><itemtag attr=value>First item.</it
<labeltag attr=value>List Label</labeltag><itemtag attr=value>Second item.</i
</tag>
47

Observa los diferentes rdenes de labeltag e itemtag. El orden que obtenemos
depende del ajuste de HTMLLabelFirst: Si HTMLLabelFirst es falso (por omisin),
se obtiene el primero de ellos, con el rtulo dentro del tem; si verdadero, se obtiene
el segundo, con el rtulo fuera del tem.
Las etiquetas especficas y la salida de los atributos para cada tipo de prrafo puede
ser controlado por medio de las etiquetas de formato que vamos a describir. Como
mencionamos antes, sin embargo, LYX usa predefinidos adecuados para muchos de
estos valores, por lo que generalmente no necesitars hacer nada para obtener una
buena salida XHTML. Partiendo de las etiquetas ya disponibles puedes afinar lascosas
a tu gusto.
HTMLAttr [string] Especifica informacin de los atributos a entregar con la etiqueta principal. Por ejemplo, class=mydiv. Por omisin, LYX producir
class=layoutname, donde layoutname es el nombre del formato en LYX,
en minsculas, por ejemplo: chapter. Esto no debera contener ninguna informacin de estilo. Usa HTMLStyle para ese propsito.
HTMLForceCSS [0 , 1] Si producir la informacin CSS predeterminada que LYX genera
para este formato, incluso si se proporciona explcitamente informacin adicional mediante HTMLStyle. Poner 1 permite alterar o aumentar el CSS generado,
no sobrescribirlo totalmente. Por omisin es 0.
HTMLItem [string] Etiqueta a usar para prrafos individuales de entornos, reemplazando itemtag en los ejemplos de arriba. Por omisin, div.
HTMLItemAttr [string] Atributos para la etiqueta tem. Por omisin class=layoutname_item

Esto no debera contener ninguna informacin de estilo. Usa HTMLStyle para
ese propsito.
HTMLLabel [string] Etiqueta a usar para rtulos de prrafos e tems, reemplazando
labeltag en los ejemplos de arriba. Por omisin, span, a menos que LabelType
sea Top_Environment o Centered_Top_Environment, en cuyos casos es div por
omisin.
HTMLLabelAttr [string] Atributos para la etiqueta del rtulo. Por omisin es class=layoutname
Esto no debera contener ninguna informacin de estilo. Usa HTMLStyle para
ese propsito.
HTMLLabelFirst [0 , 1] Solo es significativo para entornos tipo lista, esta etiqueta controla si la etiqueta de rtulo se genera antes o dentro de la etiqueta de tem. Se usa, por ejemplo, en el entorno descripcin, donde queremos
<dt>...</dt><dd>...</dd>. Por omisin, 0: la etiqueta de rtulo se genera
dentro de la etiqueta de tem.
HTMLPreamble Informacin para generar en la seccin <head> cuando se usa este
estilo. Esto podra, por ejemplo, utilizarse para incluir un bloque <script>
definiendo un controlador onclick.
48

HTMLStyle Informacin de estilo CSS a incluir cuando se usa este estilo. Advertimos
que esto ser automticamente envuelto en un bloque <style> generado por el
formato, por tanto solo es necesario incluir el propio CSS.
HTMLTag [string] Etiqueta para el rtulo principal, reemplazando tag en losejemplos
de arriba. Por omisin es div.
HTMLTitle [0 , 1] Marca este estilo como el que se va a usar para generar la etiqueta <title> para el archivo XHTML. Por omisin, es falso. El archivo
stdtitle.inc lo establece verdadero para el entorno title.
5.4.2.
Recuadros XHTML
La salida XHTML de los recuadros tambin se puede controlar por informacin en

archivos layout.20 Tambin en este caso, LYX intenta proporcionar valores predefinidos adecuados, y construye reglas de estilo CSS, pero todo puede personalizarse.
Para los recuadros, LYX produce XHTML en la forma:
<tag attr=value>
<labeltag>Label</labeltag>
<innertag attr=value>Contents of the inset.</innertag>
</tag>
Si el recuadro permite prrafos mltiples o sea, si MultiPar es verdadero el
contenido del recuadro se generar en forma de prrafos estructurados segn los
estilos usados para dichos prrafos (normal, cita, y similares). El rtulo de la etiqueta
se omite si el prrafo no lo tiene y, por el momento, es siempre span. La etiqueta
interior es opcional y, por omisin, no aparece.
Las etiquetas y atributos especficos para cada recuadro se pueden controlar mediante las siguientes etiquetas de formato.
HTMLAttr [string] Especifica informacin de atributos a generar con la etiqueta
principal. Por ejemplo, class=myinset onclick=.... Por omisin, LYX
generar class=insetname, donde insetname es el nombre del recuadro
en LYX, en minsculas y con los caracteres no alfanumricos convertidos en
guiones bajos, por ejemplo: footnote.
HTMLForceCSS [0 , 1] Si producir la informacin CSS predeterminadad que LYX genera para este formato, incluso si se da explcitamente informacin adicional
con HTMLStyle. Si esto es 1 parmite alterar o aumentar el CSS generado, en
vez de sobrescribirlo. Por omisin, 0.
HTMLInnerAttr [string] Atributos para la etiqueta interna. Por omisin, es class=insetname_inner

20
Por ahora, esto solo es cierto para recuadros de texto (recuadros en los que puedes escribir) y
no para recuadros de commandos (recuadros asociados con cuadros de dilogo).
49

HTMLInnerTag [string] La etiqueta interna, reemplazando innertag en los ejemplos
de arriba. Por omisin, ninguna.
HTMLIsBlock [0, 1 ] Si este recuadro representa un bloque de texto independiente
(como una nota al pie) o bien representa material que est incluido en el texto
circundante (como una rama). Por omisin, 1.
HTMLLabel [string] Un rtulo para este recuadro, posiblemente incluyendo una referencia a un contador. Por ejemplo, para notas al pie, podra ser: \arabic{footnote}.
Esto es opcional y no hay valor predeterminado.
HTMLPreamble Informacin que saldr en la seccin <head> cuando se usa este estilo.
Esto podra usarse, por ejemplo, para incluir un bloque <script> que defina
un controlador onclick.
HTMLStyle Informacin de estilo CSS a incluir cuando se usa este estilo. Esto ser
automticamente envuelto en un bloque <style> generado por el formato, por
lo que solo hay que incluir el propio CSS.
HTMLTag [string] La etiqueta a usar para el rtulo principal, reemplazando tag en
los ejemplos de arriba. El valor por omisin depende de MultiPar: Si MultiPar
es verdadero, es div; si es falso, el valor por omisin es span.
5.4.3.
Flotantes XHTML
La salida XHTML para flotantes tambin se puede controlar mediante informacin

en archivos layout. La salida tiene la forma:
<tag attr=value>
Contents of the float.
</tag>
La leyenda, si la hay, es un recuadro separado y se generar como tal. Su aspecto
puede controlarse con InsetLayout para recuadros de leyendas.
HTMLAttr [string] Especifica informacin de los atributos a generar con la etiqueta
principal, Por ejemplo, class=myfloat onclick=.... Por omisin, LYX
generar class=float float-floattype, donde floattype es el nombre
en LYX para este tipo de flotante, como determina la declaracin de flotante (vase 5.3.8), aunque en minsculas y con los caracteres no alfanumricos
sustituidos por guiones bajos, por ejemplo: float-table.
HTMLStyle Informacin de estilo CSS a incluir cuando se usa este flotante. Esto ser
automticamente envuelto en un bloque <style> generado por el formato, por
lo que solo hay que incluir el propio CSS.
HTMLTag [string] La etiqueta a usar para este flotante, reemplazando "tag" en el
ejemplo de arriba. El valor por omisin es div y raramente habr que cambiarlo.
50
5.4.4.
Formato de la Bibliografa
La bibliografa se puede formatear usando bloques CiteFormat. Vase la seccin

5.3.12 para los detalles.
5.4.5.
CSS generado por LYX
Hemos mencionado ya que LYX generar reglas de estilo CSS predeterminadas

para recuadros y estilos de prrafo, basados en la informacin suministrada para
otros formatos. En esta seccin comentaremos qu informacin usa LYX y cmo la
usa.
Actualmente, LYX auto-genera CSS solo para informacin sobre tipografas, haciendo uso de Family, Series, Shape, y Size especificados en la declaracin Font.
(Vase 5.3.11.) La traduccin es bastante sencilla y evidente. Por ejemplo, Family
Sans se convierte en font-family: sans-serif;. La correspondencia entre tamaos LYX y tamaos CSS es un poco menos obvia, pero intuitiva en todo caso.
Vase la funcin getSizeCSS() en src/FontInfo.cpp para los detalles.
51
6 Insercin de material externo

AVISO: Esta parte de la documentacin no ha sido actualizada desde hace tiempo.
Esperamos que an sea adecuada, pero no hay garantas.
El uso de material de procedencia externa a LYX se trata con detalle en el manual
Objetos insertados. En el presente documento se trata sobre lo que debe suceder entre
bambalinas para incluir nuevas clases de material.
6.1.
Cmo funciona?
La caracterstica material externo se basa en el concepto plantilla. Una plantilla es

una especificacin de la forma en que LYX interacta con ciertos tipos de material. De
por s, LYX incluye plantillas predefinidas para figuras Xfig, varios tipos de imgenes
raster, diagramas de ajedrez y notacin musical LilyPond. Puedes comprobar la lista
actual en el men Insertar . Archivo . Material externo. Adems, es posible construir
plantillas propias para soportar determinado tipo de material. Ms tarde describiremos con ms detalle lo que esto implica, y esperamos que nos enves tus plantillas
para que se puedan incluir en prximas versiones de LYX.
Otra idea bsica de la caracterstica material externo es distinguir entre el archivo
original que sirve como base para el material final y el archivo generado que se incluye
en el documento impreso o exportado. Por ejemplo, consideremos el caso de una figura
hecha con Xfig. El programa Xfig en s mismo trabaja sobre un archivo original con
extensin .fig. Dentro de Xfig, se crea o modifica una figura y se guarda como un
archivo .fig. Para incluir la figura en un documento, se ejecuta transfig con el fin
de crear un archivo PostScript que puede incluirse fcilmente en el archivo LATEX. En
este caso, el archivo .fig es el original, y el archivo PostScript es el archivo generado.
Esta distincin es importante para permitir la actualizacin del material durante
el proceso de escritura del documento. Adems, provee la flexibilidad necesaria para
soportar mltiples formatos de exportacin. Por ejemplo, en el caso de un archivo
de texto sencillo, no es una brillante idea incluir la figura como PostScript puro. En
vez de esto, es preferible incluir solo una referencia a la figura o bien probar algn
convertidor de grficos a Ascii para que el resultado final se parezca al grfico real. La
gestin de material externo de LYX permite hacer esto porque se basa en parmetros
apropiados para los diferentes formatos de exportacin soportados.
Adems de soportar la generacin de diferentes productos de acuerdo con el formato de exportacin, existe una profunda integracin con las aplicaciones de edicin
y visualizacin. En el caso de figuras Xfig, es posible editar el archivo original en Xfig
53

con un simple clic derecho sobre el recuadro y tambin previsualizar el PostScript
generado con ghostview. Se acabaron los enredos con la lnea de comandos y/o el navegador de archivos para localizar y manipular los archivos originales o los generados.
De esta manera, se pueden por fin aprovechar las ventajas de muy diversas aplicaciones importantes para la composicin de los documentos, y por tanto aumentar el
rendimiento.
6.2.
El archivo de configuracin de plantillas externas
Es relativamente fcil aadir en LYX definiciones personalizadas de plantillas externas. Sin embargo, hay que ser consciente de que hacer esto de manera descuidada
generar muy probablemente un agujero de seguridad fcil de explotar. As pues,
antes de hacer esto, lee por favor la discusin sobre seguridad en la seccin 6.4
Una vez dicho esto, te animamos a que enves cualquiera plantilla interesante que
compongas.
Las plantillas externas se definen en el archivo LYXDir/lib/external_templates.
Puedes colocar tus versiones propias en UserDir/external_templates.
Una plantilla tpica tiene un aspecto como este:
Template XFig
GuiName "XFig: $$AbsOrRelPathParent$$Basename"
HelpText
An XFig figure.
HelpTextEnd
InputFormat fig
FileFilter "*.fig"
AutomaticProduction true
Transform Rotate
Transform Resize
Format LATEX
TransformCommand Rotate RotationLatexCommand
TransformCommand Resize ResizeLatexCommand
Product "$$RotateFront$$ResizeFront
\\input{$$AbsOrRelPathMaster$$Basename.pstex_t}
$$ResizeBack$$RotateBack"
UpdateFormat pstex
UpdateResult "$$AbsPath$$Basename.pstex_t"
Requirement "graphicx"
ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t"
ReferencedFile latex "$$AbsPath$$Basename.eps"
ReferencedFile dvi "$$AbsPath$$Basename.eps"
FormatEnd
Format PDFLATEX
54
6.2 El archivo de configuracin de plantillas externas

TransformCommand Rotate RotationLatexCommand
TransformCommand Resize ResizeLatexCommand
Product "$$RotateFront$$ResizeFront
\\input{$$AbsOrRelPathMaster$$Basename.pdftex_t}
$$ResizeBack$$RotateBack"
UpdateFormat pdftex
UpdateResult "$$AbsPath$$Basename.pdftex_t"
Requirement "graphicx"
ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pdftex_t"
ReferencedFile latex "$$AbsPath$$Basename.pdf"
FormatEnd
Format Ascii
Product "$$Contents(\"$$AbsPath$$Basename.asc\")"
UpdateFormat asciixfig
UpdateResult "$$AbsPath$$Basename.asc"
FormatEnd
Format DocBook
Product "<graphic fileref=\"$$AbsOrRelPathMaster$$Basename.eps\">
</graphic>"
UpdateFormat eps
UpdateResult "$$AbsPath$$Basename.eps"
ReferencedFile docbook "$$AbsPath$$Basename.eps"
ReferencedFile docbook-xml "$$AbsPath$$Basename.eps"
FormatEnd
Product "[XFig: $$FName]"
FormatEnd
TemplateEnd
Como puedes ver, la plantilla se incluye entre Template . . . TemplateEnd. Contiene
una cabecera que especifica algunas configuraciones generales y, por cada formato de
archivo de documento primario soportado, una seccin Format . . . FormatEnd.
6.2.1.
La cabecera de la plantilla
AutomaticProduction true|false Si el archivo representado por la plantilla debe

ser generado por LYX. Este comando debe aparecer exactamente una vez.
FileFilter <pattern> Un patrn global que se usa en el dilogo del archivo para
filtrar los archivos deseados. Si hay ms de una posible extensin de archivo
(p. e., tgif tiene .obj y .tgo), se pone algo como "*.{obj,tgo}". Este comando
debe aparecer exactamente una vez.
GuiName <guiname> El texto mostrado sobre el botn. Este comando debe aparecer
exactamente una vez.
55

HelpText <text> HelpTextEnd El texto de ayuda que se muestra en dilogo. Da
suficiente informacin sobre lo que puede proporcionar la plantilla. Este comando debe aparecer exactamente una vez.
InputFormat <format> El formato de archivo del original. Debe ser el nombre de
un formato conocido por LYX (vase la seccin 3.1). Se pone un * si la
plantilla puede manejar archivos originales o ms de un formato. En este caso,
LYX intentar inspeccionar el archivo mismo para deducir su formato. Este
comando debe aparecer exactamente una vez.
Template <id> Un nombre nico para la plantilla. No debe contener macros de
sustitucin (vase abajo).
Transform Rotate|Resize|Clip|Extra Este comando especifica qu transformaciones son soportadas por esta plantilla. Puede aparecer ninguna o varias veces.
Este comando facilita las correspondientes pestaas en el dilogo de material externo. Cada comando Transform debe tener el correspondiente TransformCommand
o bien TransformOption en la seccin Format. De lo contrario la transformacin
no ser soportada por ese formato.
6.2.2.
La seccin Format
Format LATEX|PDFLATEX|PlainText|DocBook El formato de archivo del documento primario para el que es esta definicin de formato. No toda plantilla tiene una
representacin sensible en los formatos de archivo de todos los documentos. No
obstante, es preferible definir una seccin Format para todos los formatos. Se
usa un texto postizo si no hay representacin disponible. Entonces, al menos,
se puede ver una referencia al material externo en el documento exportado.
Option <name> <value> Este comando define una macro adicional, $$<name>, para
sustitucin en Product. <value> puede contener en s mismo macros de sustitucin. La ventaja sobre el uso de <value> directamente en Product es que
el valor sustituido de $$<name> est saneado as que es un argumento opcional
vlido en el formato del documento. Este comando puede aparecer ninguna o
ms veces.
Product <text> El texto que se inserta en el documento exportado. Realmente este
es el comando ms importante y puede ser bastante complejo. Este comando
debe aparecer exactamente una vez.
Preamble <name> Este comando especifica un fragmento de prembulo que se incluir en el prembulo LATEX. Tiene que definirse usando PreambleDef . . .
PreambleDefEnd. Este comando puede aparecer ninguna o ms veces.
ReferencedFile <format> <filename> Este comando indica los archivos que se
crean por el proceso de conversin y que son necesarios para un formato de
56
6.2 El archivo de configuracin de plantillas externas

exportacin particular. Si el nombre del archivo es relativo, se interpreta como
relativo al documento maestro. Este comando puede darse ninguna o ms veces.
Requirement <package> El nombre de un paquete LATEX requerido. El paquete se
incuye mediante \usepackage{} en el prembulo LATEX. Este comando puede
aparecer ninguna o ms veces.
TransformCommand Rotate RotationLatexCommand Este comando especifica que
el comando LATEX incluido debera usarse para la rotacin. Este comando puede
aparecer una vez o ninguna.
TransformCommand Resize ResizeLatexCommand Este comando especifica que el
comando LATEX incluido debera usarse para cambiar el tamao. Este comando
puede aparecer una vez o ninguna.
TransformOption Rotate RotationLatexOption Este comando especifica que la
rotacin se hace mediante un argumento opcional. Este comando puede aparecer
una vez o ninguna.
TransformOption Resize ResizeLatexOption Este comando especifica que el cambio de tamao se hace mediante un argumento opcional. Este comando puede
aparecer una vez o ninguna
TransformOption Clip ClipLatexOption Este comando especifica que el recorte
se hace mediante un argumento opcional. Este comando puede aparecer una
vez o ninguna.
TransformOption Extra ExtraLatexOption Este comando especifica que se usa
un argumento extra opcional. Este comando puede aparecer una vez o ninguna.
UpdateFormat <format> El formato de archivo del archivo convertido. Debe ser el
nombre de un formato conocido por LYX (vase Convertidores de Gestin de
archivos en el dilogo Herramientas . Preferencias). Este comando debe aparecer
exactamente una vez.
UpdateResult <filename> El nombre de archivo del archivo convertido. El nombre
de archivo debe ser absoluto. Este comando debe aparecer exactamente una vez.
6.2.3.
Definiciones de prembulo
El archivo de configuracin de plantillas externas puede contener definiciones de

prembulo adicionales encerradas entre PreambleDef . . . PreambleDefEnd. Se pueden
usar por las plantillas en la seccin Format.
57
6.3.
El mecanismo de sustitucin
Cuando la funcin de material externo recurre a un programa externo, se hace sobre

la base de un comando definido en el archivo de configuracin de la plantilla. Estos
comandos pueden contener varias macros que se expanden antes de su ejecucin. La
ejecucin tiene lugar siempre en el directorio del documento.
Adems, cada vez que el material externo se va a mostrar, el nombre ser generado
por el mecanismo de sustitucin, y la mayora de los dems comandos en la definicin
de la plantilla soportan tambin sustitucin.
Las macros disponibles son las siguientes:
$$AbsOrRelPathMaster La ruta del archivo, absoluta o relativa al documento LYX
maestro.
$$AbsOrRelPathParent La ruta del archivo, absoluta o relativa al documento LYX.
$$AbsPath La ruta absoluta del archivo.
$$Basename El nombre de archivo sin ruta y sin la extensin.
$$Contents(filename.ext) Esta macro expandir los contenidos del archivo con
el nombre filename.ext.
$$Extension La extensin de archivo (incluyendo el punto).
$$FName El nombre de archivo del archivo especificado en el dilogo de material
externo. Esto es bien un nombre absoluto, bien relativo al documento LYX.
$$FPath La parte de la ruta de $$FName (nombre absoluto o relativo al documento
LYX).
$$RelPathMaster La ruta del archivo, relativa al documento maestro LYX.
$$RelPathParent La ruta del archivo, relativa al documento LYX.
$$Sysdir Esta macro expandir a la ruta absoluta del directorio de sistema. Esto
se usa habitualmente para apuntar a los varios guiones de ayuda que se empaquetan con LYX.
$$Tempname Un nombre y ruta completa a un directorio temporal que ser borrado
automticamente siempre que el documento se cierra, o se suprime la insercin
de material externo.
Todas las macros de ruta contienen un separador de rastreo del directorio, as se puede
construir, p. e., el nombre de archivo absoluto con $$AbsPath$$Basename$$Extension.
Las macros anteriores son sustituidas en todos los comandos a menos que se indique
lo contrario. El comando Product soporta adicionalmente las siguientes sustituciones
si se habilitan por los comandos Transform y TransformCommand:
58
6.3 El mecanismo de sustitucin

$$ResizeFront La parte delantera del comando para cambiar el tamao.
$$ResizeBack La parte trasera del comando para cambiar el tamao.
$$RotateFront La parte delantera del comando para la rotacin.
$$RotateBack La parte trasera del comando para la rotacin.
La cadena de valor del comando Option soporta adicionalmente las siguientes sustituciones si stas se han habilitado por los comandos Transform y TransformOption:
$$Clip La opcin recorte.
$$Extra La opcin extra.
$$Resize La opcin cambio de tamao.
$$Rotate La opcin rotacin.
Te puedes preguntar por qu hay tantas macros de ruta. Por dos razones, principalmente:
1. Los nombres de archivo relativo y absoluto deberan permanecer relativo o absoluto, respectivamente. Los usuarios pueden tener razones para preferir cualquiera de ambas formas. Los nombres relativos son tiles para documentos portables que deberan funcionar en mquinas diferentes, por ejemplo. Los nombres
absolutos pueden ser requeridos por algunos programas.
2. LATEX procesa los nombres de archivo relativos de manera diferente a LYX y
otros programas en archivos anidados incluidos. Para LYX, un nombre de archivo relativo es siempre relativo al documento que contiene el nombre de archivo.
Para LATEX, es siempre relativo al documento maestro. Estas dos definiciones
son idnticas si se tiene solo un documento, pero son distintas si se tiene un
documento maestro que incluye documentos parciales. Esto quiere decir que
los nombres de archivo relativos deben ser transformados cuando se presentan a LATEX. Afortunadamente, LYX hace esto automticamente si se eligen las
macros correctas.
As pues, qu macros de ruta deberan emplearse en las definiciones de plantillas
nuevas? La regla no es difcil:
Usar $$AbsPath si se requiere una ruta absoluta.
Usar $$AbsOrRelPathMaster si la cadena sustituida es algn tipo de entrada
LATEX.
Si no, usar $$AbsOrRelPathParent con el fin de preservar la eleccin del usuario.
59

Hay casos especiales en los que esta regla no funciona y se necesitan, p. e., nombres relativos, pero normalmente funcionar bien. Un ejemplo de uno de estos casos es el comando ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t" en
la plantilla XFig de arriba: no podemos usar el nombre absoluto porque el copiador
para archivos .pstex_t necesita el nombre relativo para reescribir el contenido del
archivo.
6.4.
Discusin sobre seguridad
La funcin material externo interacta con muchos programas externos y lo hace

de forma automtica, as que hemos de tener en cuenta las implicaciones de seguridad
que esto conlleva. En particular, puesto que tienes la opcin de incluir tus propios
archivos y/o cadenas de parmetros y estos se expanden en un comando, parece
posible crear un documento malicioso que ejecute comandos arbitrarios cuando un
usuario ve o imprime el documento. Esto es algo que definitivamente queremos evitar.
Sin embargo, dado que los comandos de material externo se especifican solo en
el archivo de configuracin de la plantilla, no hay problemas de seguridad si LYX
est adecuadamente configurado solo con plantillas seguras. Esto es as porque los
programas externos se invocan con la llamada al sistema execvp ms bien que con
la llamada system, de modo que no es posible ejecutar comandos arbitrarios desde
la seccin del nombre de archivo o de parmetros mediante el shell.
Esto implica adems que hay restricciones en las cadenas de comandos que puedes
usar en las plantillas de material externo. En particular, las tuberas y la redireccin
no estn fcilmente disponibles. Esto debe ser as para que LYX permanezca seguro.
Si quieres usar algunas caractersticas de shell, deberas escribir un guin seguro
para hacerlo de manera controlada, y despus invocar el guin desde la cadena de
comandos.
Es posible disear una plantilla que interacte directamente con el shell, pero puesto que esto permitira a un usuario malicioso ejecutar comandos arbitrarios escribiendo nombres de archivo y/o parmetros astutos, generalmente recomendamos usar solo
guiones seguros que trabajen con la llamada execvp al sistema en forma controlada.
Por supuesto, para usar en un entorno controlado, puede ser tentador caer en el uso
de guiones de shell ordinarios. Si lo haces as, s consciente de que vas a suministrar
un agujero se seguridad fcilmente explotable en tu sistema. Evidentemente, es de
razn que tales plantillas inseguras nunca sern incluidas en la distribucin estndar
de LYX, aunque alentamos a la gente a que, a la usanza del software libre, enve
nuevas plantillas. No obstante, LYX nunca tendr plantillas inseguras tal y como se
distribuye por los canales oficiales.
Incluir material externo suministra mucha potencia y has de ser cuidadoso en no
introducir riesgos de seguridad a costa de esta potencia. Un sutil error en una simple
lnea en un guin aparentemente inocente puede abrir la puerta a graves problemas de
seguridad. As, si no comprendes totalmente estos asuntos, recomendamos consultar
a un profesional entendido en seguridad o al equipo de desarrollo de LYX si tienes
60
6.4 Discusin sobre seguridad

dudas acerca de si una plantilla dada es o no segura. Y hazlo antes de usarla en un
entorno no controlado.
61

Personalizar Lyx

Cargado por

Copyright:

Formatos disponibles

Personalizar Lyx

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Personalizar Lyx

Cargado por

Copyright:

Formatos disponibles

Personalizar LYX: Caractersticas para

2. Archivos de configuracin de LYX

2 Archivos de configuracin de LYX

Archivos generados automticamente

Los archivos que se encuentran en UserDir se generan al configurar LYX. Contienen

2 Archivos de configuracin de LYX

Estos directorios estn duplicados en LYXDir y UserDir. Si determinado archivo

clipart/ contiene archivos grficos que pueden ser incluidos en documentos.

contiene archivos de imagen que se usan en el dilogo Documento . Configuracin.

contiene archivos de mapas de teclado. Vase 4.2 para detalles.

contiene los guiones de Python lyx2lyx para convertir entre versiones

contiene archivos con la extensin .ui que definen la interfaz de usuario

2.2 Directorio de configuracin personal

Archivos que no necesitan modificaciones

chkconfig.ltx es un guin de LATEX usado durante el proceso de configuracin. No

Otros archivos en un par de lneas...

Directorio de configuracin personal

2 Archivos de configuracin de LYX

Ejecutar LYX con mltiples configuraciones

La libertad de configuracin del directorio local puede no ser suficiente si quieres

El directorio de sistema de LYX (p. e. /usr/share/lyx)

El directorio de sistema de LYX

El nombre del archivo base del archivo de entrada (sin la extensin)

La ruta al archivo de entrada

La ruta al archivo de entrada original (esto es diferente de $$p cuando se

El nombre iconv para la codificacin del documento.

Este convertidor ejecuta alguna forma de LATEX. Har estar disponibles

Necesita el archivo LATEX .aux para la conversin

Las tres siguientes no son realmente opciones porque aceptan un argumento en la

Traduccin de la interfaz grfica de usuario (mensajes de

LYX utiliza la biblioteca GNU gettext para manejar la internacionalizacin de

4.2 Cosas sobre teclados internacionales

Cosas sobre teclados internacionales

Un archivo .kmap asocia pulsaciones de teclas con caracteres o secuencias de ellos.

\kmap char string

\kmod char accent allowed

Especifica una excepcin para el carcter acentuado

accent char result

4.2 Cosas sobre teclados internacionales

Combina dos caracteres acentos

\kcomb accent1 accent2 allowed

Guardar la configuracin de idioma

5 Instalacin de nuevas clases de

5 Instalacin de clases, formatos . . .

Instalacin de nuevos archivos LATEX

Algunas instalaciones quiz no incluyan un paquete LATEX que te gustara usar

Usualmente es el directorio $TEXMF/web2c, aunque se puede ejecutar el comando kpsewhich

5.2 Tipos de archivos de formato

Tipos de archivos de formato

5 Instalacin de clases, formatos . . .

5.2 Tipos de archivos de formato

Formato para archivos .sty

Probablemente te vas a encontrar con dos situaciones a la hora de querer soportar

5 Instalacin de clases, formatos . . .

5.2 Tipos de archivos de formato

Formato para archivos .cls

5 Instalacin de clases, formatos . . .

Actualizacin de antiguos archivos de formato

Estructura del archivo layout