TeXstudio: manual de usuario

Contenido:

 1. Configurando TeXstudio
o 1.1 Configurando el editor
o 1.2 Configuración de los comandos relacionados con el látex
o 1.3 Configurando el sistema de compilación
o 1.4 Configurando algunos problemas generales
o 1.4.1 Configurando el corrector ortográfico
o 1.4.2 Configurar el tesauro
o 1.4.3 Configuración del verificador de sintaxis de látex
o 1.4.4 Configurar el corrector gramatical
o 1.5 Configuración de la autocompletación
o 1.6 Configuración de accesos directos
o 1.7 Configuración del Latex / Math-Menu
o 1.8 Configurar la barra de herramientas personalizada
o 1.9 Configurando el soporte SVN
 2. Editar un documento TeX
o 2.1 Comandos habituales
o 2.2 Creando un documento nuevo
o 2.2.1 Establecer el preámbulo de un documento TeX
o 2.2.2 Usar plantillas para comenzar un nuevo documento
o 2.3 Estructura de un documento
o 2.4 Buscando su documento
o 2.5 Formateando su texto
o 2.6 Espaciamientos
o 2.7 Insertar una lista
o 2.8 Insertar una tabla
o 2.8.1 Manipulación de una mesa
o 2.9 Insertar un entorno de "tabbing"
o 2.10 Insertar una imagen
o 2.10.1 Insertar una imagen usando un "asistente"
o 2.11 Referencias cruzadas y notas
o 2.12 Insertar fórmulas matemáticas
o 2.13 Autocompletar
o 2.14 Tesauro
o 2.15 Comandos especiales
 3. Compilación de un documento
o 3.1 Compilación
o 3.2 Los archivos de registro
 4. Otras características
o 4.1 Acerca de documentos separados en varios archivos
o 4.2 Comprobación de sintaxis
o 4.3 Bibliografía
o 4.4 Soporte SVN
o 4.5 Macros personales
o 4.6 Soporte de Pstricks
o 4.7 Soporte de Metapost
o 4.8 El comando "Convertir a Html"
o 4.9 "Búsqueda adelante / atrás" con TeXstudio
o 4.10 Uso avanzado del encabezado
o 4.11 Sinopsis del comando TeXstudio
o 4.12 Atajos de teclado
 o 4.13 Descripción del formato cwl
o 4.14 Uso de plantillas de tabla
 5. Características experimentales
o 5.1 Skripting avanzado
o 5.2 Hojas de estilo
o 5.3 Escribir sus propias definiciones de idioma
 Registro de cambios

1. Configurando TeXstudio
Antes de usar TeXstudio, debe configurar el editor y los comandos relacionados con el látex
mediante el comando "Configurar TeXstudio" en el menú "Opciones" ("Preferencias" en Mac OS
X). Tenga en cuenta que hay dos niveles de detalle. Las opciones más avanzadas o menos
utilizadas solo son visibles si alternas "Mostrar opciones avanzadas" en la esquina inferior
izquierda.

1.1 Configurando el editor

Puede cambiar la codificación predeterminada para los archivos nuevos ("Configurar TeXstudio" -
> "Editor" -> "Codificación de fuente del editor") si no quiere utilizar utf8 como codificación. No
olvides establecer la misma codificación en el preámbulo de tus documentos. (por ejemplo, \
usepackage [utf8] {inputenc}, si usa utf-8).
TeXstudio puede detectar automáticamente archivos codificados en utf-8 y latin1, pero si usa
una codificación diferente en sus documentos existentes, debe especificarla en el cuadro de
diálogo de configuración antes de abrirlos. (y luego también debe desactivar la detección
automática)

 "Plegable" alterna la capacidad de plegado del código del editor (oculta secciones del texto).
 El cuadro de selección "Modo de sangría" le permite seleccionar, si las líneas sangradas son
seguidas por líneas de la misma sangría después de presionar Enter o dejar que TeXstudio haga
una sangría automática.
1.2 Configuración de los comandos relacionados con el látex

LaTeX viene con una serie de herramientas de línea de comandos para compilar y manipular
documentos LaTeX. La sección de comandos define la ubicación y los argumentos.

La configuración predeterminada debería funcionar con las distribuciones LaTeX recientes y

estándar, pero podría tener que modificarlas ("Configurar TeXstudio" -> "Comandos"). Para
cambiar un comando, simplemente haga clic en el botón al final de la línea correspondiente y
seleccione el comando en el buscador de archivos: TeXstudio adaptará automáticamente la
sintaxis del comando.

Puede usar una serie de caracteres / secuencias de caracteres especiales para abordar el
contexto del documento actual. Se expanden en tiempo de ejecución:

Personaje especial Se expande a

%
nombre de archivo del documento raíz para el documento
actual sin extensión
@ número de línea actual
?seguido de otros Vea las instrucciones en la parte inferior del cuadro de
personajes diálogo de configuración.
[txs-app-dir]
Ubicación del ejecutable de TeXstudio (útil para
configuraciones portátiles)
[txs-settings-dir] Ubicación del archivo de configuración (texstudio.ini)

La sección Búsqueda hacia Adelante / Inversa proporciona algunos comandos de ejemplo para
usuarios comunes.

Siempre puede restaurar la configuración original utilizando el botón de retroceso a la derecha.

1.3 Configurando el sistema de compilación

TeXstudio proporciona comandos generales para traducir látex.

La configuración predeterminada utiliza "pdflatex" y el visor de PDF interno. Se pueden
seleccionar otros comandos y visores, así como un traductor de bibliografía diferente.
El "visor de pdf incrustado" no abre una nueva ventana para ver el documento pdf, sino que lo
presenta directamente al lado del texto en el editor.
Una alternativa útil podría ser utilizar el "latexmk" como comando de compilación (si el comando
 está instalado en su sistema), ya que maneja muy bien las dependencias con biblatex e index.
Las opciones avanzadas permiten una personalización más fina que, en general, no es necesaria.

Los comandos de usuario se pueden definir aquí "agregándolos". Cada comando de usuario tiene un
nombre con un patrón <command id>:<display name>, ej user0:User Command 0. El ID del
comando debe ser único y no debe contener espacios. En modo avanzado , puede hacer referencia
utilizando txs:///"<command id>. El nombre para mostrar se mostrará en el menú de
herramientas. Los comandos del usuario se pueden activar por atajo (alt + shift + F% n) o por el menú
de herramientas (Herramientas / Usuario).
Los comandos de usuario pueden consistir en una combinación de comandos conocidos
seleccionándolos de una lista de comandos disponibles. Esto se activa al hacer clic en el símbolo de
llave.
Alternativamente, un comando se puede seleccionar directamente a través del sistema de archivos.

1.3.1 Configuración avanzada del sistema de compilación

Si habilita las opciones avanzadas, puede configurar el sistema de compilación con más detalle.

Cada comando txs es una lista de programas externos / comandos latex y otros comandos txs
para llamar. Se puede llamar a un programa externo con su línea de comando habitual, mientras
que txs: /// foobar llama a un comando txs con id "foobar".
Los comandos en la lista están separados por |, que es solo un separador (es decir, no pasará el
stdout de un programa al stdin del próximo).

Nota: Use listas de comandos solo para los comandos de meta y usuario listados en Options ->
Build. No usar entonces en Options -> Commands. El último debería ser solo comandos
individuales (es decir, no usar | allí). Si bien actualmente funciona en algunos casos,
generalmente no garantizamos este comportamiento. Puede tener sorprendentes efectos
secundarios como el aborto de la compilación en algunos casos. Además, el uso de
| a Commandspuede ser prohibido por completo sin previo aviso en el futuro.

Cada uno de estos txs-command tiene una identificación única, que se muestra como información
sobre herramientas del nombre que se muestra para los comandos "normales" y en el cuadro de
edición para los comandos del usuario. Algunos comandos importantes son habituales: txs: ///
quick (Build & View, oldbuild anterior), txs: /// compile (compilador predeterminado), txs: ///
view (visor predeterminado), txs: /// latex (latex), txs: /// pdflatex (pdflatex), txs: /// view-
pdf (Visor de Pdf predeterminado), txs: /// view-pdf-external (Visor de PDF externo).

Por ejemplo, en una configuración de compilación típica, puede llamar a txs: /// quick
presionando F1, que llama a txs: /// compile, que primero llama a txs: /// pdflatex que llama a
la pdflatey real, y luego llama a txs: /// view, que llama a txs: /// view-pdf, que llama a txs:
/// view-pdf-internal, que muestra el pdf.
No hay diferencia entre los comandos definidos como comando en la página de configuración de
comando, los comandos definidos como compilación en la página de configuración de
compilación o los comandos definidos como comandos de usuario. Simplemente están separados
en la GUI para simplificar la interfaz.
Esto también significa que puede cambiar cada comando como desee, ignorando su definición
anterior (incluso podría cambiar su id cuando edite el archivo ini).

Sin embargo, hay tres comandos internos siempre definidos, que solo se pueden llamar y no
modificar:

txs: /// interno-pdf-

espectador
txs: /// view-log
txs: /// conditionally-
recompile-bibliography
Abre el visor interno para el documento actual
Visualiza el archivo de registro para el documento
actual
Comprueba si los archivos bib se han modificado y
llama a txs: /// recompile-bibliography, si es así

El visor de PDF interno también acepta las siguientes opciones (txs: /// internal-pdf-viewer) para
modificar su comportamiento:

--incrustado Abre el visor incrustado

Abre el visor en ventana (predeterminado si no se proporciona
--windowed
ninguna opción)
--close- (all |
Cierre todos los espectadores abiertos, o solo espectadores de un
windowed |
tipo específico
embedded)
--preserve- No cambia ningún espectador existente (es decir, siempre abre
existing uno nuevo)
--preserve-
(embedded | No cambia ningún visor incrustado / con ventana existente
windowed)
--preserve-
Solo abre el pdf en el primer visor abierto
duplicates
Determina si el visor debe estar cerrado, cuando el archivo tex
- (no-) cierre
correspondiente está cerrado (valor predeterminado: auto-close
automático
iff incrustado)
Determina si el visor debe estar enfocado (predeterminado: focus
- (no-) foco
iff windowed)
- (no-) primer Determina si el visor debe ponerse al frente (predeterminado:
plano primer plano)
Determina el archivo para abrir. Al igual que en otros
comandos, los patrones de archivos son compatibles. Si no se
nombre del
proporciona este parámetro, TXS utiliza "?am.pdf", es decir, la
archivo
ruta absoluta del archivo principal. Si el parámetro no es un
nombre de archivo absoluto, se busca en el directorio del archivo
 principal, así como enOptions
-> Build -> Build Options ->
Additional Serach Paths -> PDF Files

También es posible modificar los argumentos de los subcomandos llamados con modificadores de
argumento o agregando un nuevo argumento. Estos modificadores se pasan a través de listas
llamadas, por lo que siempre cambiará los argumentos del programa finalmente llamado, incluso
si el subcomando llamado directamente es solo un contenedor alrededor de otro comando:

txs: /// foobar --

Esto agregará la opción xyz
xyz
txs: /// foobar [-- Esto cambiará el valor de la opción xyz a 123 (es decir,
xyz = 123] eliminando cualquier opción xyz definida en foobar)
txs: /// foobar {-- Esto eliminará --xyz = 123 de la línea de comando foobar,
xyz = 123} ignorando las opciones xyz con otros valores
txs: /// foobar {-- Esto eliminará cualquier opción --xyz de la línea de comandos
xyz} foobar, independientemente de su valor
Esto eliminará todas las opciones de la línea de comandos de
txs: /// foobar {}
foobar, dejando solo el nombre del ejecutable

Por último, también hay opciones ocultas, que solo se pueden modificar modificando el archivo
interno: Tools / Kind / LaTeX, Tools / Kind / Rerunnable, Tools / Kind / Pdf, Tools / Kind /
Stdout, Tools / Kind / Viewer, que dan una lista de comandos que se tratan como compilador de
látex (por ejemplo, mostrar el registro después), repetible (repita la llamada de comando, si hay
advertencias), generadores de pdf (por ejemplo, pdflatex), comandos que imprimen a stdout
(por ejemplo, bibtex) y televidentes (por ejemplo, solo abierto una vez).

1.3.2 Detalles del entorno de ejecución

Variables de entorno

Las variables de entorno disponibles en la ejecución son las mismas que están disponibles en el
contexto en el que se inició TeXstudio. En particular, esto es cierto para el PATH. En Linux / OS
X, la RUTA puede depender de la forma en que inició TeXstudio. Los programas iniciados desde la
GUI pueden tener una configuración PATH diferente de los programas iniciados desde un shell
(porque algunas variables solo pueden definirse en el contexto de un shell (por ejemplo, a través
de ~ / .bashrc).

Por defecto, TeXstudio analiza las variables de entorno en sus comandos. La sintaxis se adapta al
sistema operativo correspondiente. Se escribiría una variable MYVAR como %MYVAR%en Windows
y $MYVARen Linux y OS X. Las variables de entorno de Windows no distinguen entre mayúsculas y
minúsculas, mientras que distinguen entre mayúsculas y minúsculas en Linux y OS X. El análisis
de variables de entorno puede desactivarse en la sección Generar de las opciones .

Directorio de trabajo

El directorio de trabajo está configurado en la ruta del documento raíz.

Funcionalidad Shell

Todos los comandos especificados en la configuración (es decir, Comandos y Comandos de

usuario) se ejecutan directamente. No hay caparazón involucrado. Entonces, la mayoría de las
funcionalidades de shell no funcionan.

Redirección de salida

TeXstudio proporciona capacidades de redirección de salida limitadas. Solo puede enviar al panel
de mensajes ( > txs:///messages) o suprimir el resultado ( > /dev/null). La configuración
predeterminada depende del comando. Los mismos objetivos están permitidos para stderr: 2>
txs:///messages, 2> /dev/null. Además, puede redireccionar al mismo destino que stdout
usando 2>&1.

Un caso de uso típico sería suprimir toda la salida de un comando: >/dev/null 2>&1

Nota: en lugar de la notación de Linux / Unix > /dev/null, puede usar alternativamente la
notación de Windows > nul. Debido a que estos comandos son interpretados directamente por
TXS, ambas variantes funcionan en todos los sistemas operativos.

Usar otra funcionalidad de shell

Si necesita funcionalidad de shell, debe ejecutar explícitamente un shell. Puede hacerlo

directamente en el comando de usuario:

sh -c "/ path / to / testscript foo> bar"

o en Windows:

cmd / C "/path/to/testscript.bat foo> bar"

Alternativamente, puede llamar a un script de contenedor en el comando de usuario

/ path / to / wrapperscript foo bar

y hacer el trabajo real dentro del script de contenedor:

#! / bin / sh
# Soy wrapperscript
/ path / to / testscript $ 1> $ 2

1.4 Configurando algunos problemas generales

Este panel permite la configuración de algunos aspectos generales.

 El "estilo" y el "esquema de color" de TeXstudio se pueden seleccionar. La variante moderna

está más cerca de texmaker 1.9.
 La lista de símbolos puede aparecer "tabbed" (comportamiento anterior, activado con
pestañas) o puede tener pestañas de símbolos pequeños además de las listas de símbolos, lo
que deja más espacio para los símbolos.
 Además, el visor de registro puede aparecer con pestañas, lo que permite un cambio más
rápido entre la tabla de errores, la vista de registro y la vista previa ...
 El idioma de los menús se puede cambiar directamente para ignorar la configuración del
sistema.
1.4.1 Configurando el corrector ortográfico

TeXstudio ofrece un corrector ortográfico integrado que puede usarse a través de un diálogo o
directamente mientras se escribe. Todo el texto fuera de los comandos LaTeX está
marcado. Además, el texto en las opciones de los comandos de LaTeX también se
verifica. TeXstudio determina si una opción contiene texto natural y, por lo tanto, debe
corregirse ortográficamente buscando su definición en las listas de palabras de finalización. Para
obtener más información sobre listas de palabras completas, consulte la sección
sobre finalización y la descripción del formato cwl .

El corrector ortográfico usa el formato del diccionario Hunspell, que se usa ampliamente, por
ejemplo, en OpenOffice, LibreOffice y Firefox. Cada diccionario consta de dos archivos
( .dicy .aff). Los diccionarios en francés, inglés y alemán se distribuyen con TeXstudio. Puede
agregar diccionarios adicionales colocándolos en la ruta del diccionario. Una forma
particularmente conveniente de obtener diccionarios adicionales es descargar una extensión de
diccionario de http://wiki.services.openoffice.org/wiki/Dictionaries o LibreOffice e importarlos
con el botón Importar Diccionario en las opciones.

Puede especificar una o más rutas de búsqueda para los diccionarios en las opciones. Varias rutas
deben estar separadas por punto y coma. Con los caminos puedes usar las cuerdas
especiales [txs-app-dir]y [txs-settings-dir]. Estos se expanden a la ruta del
ejecutable y el archivo de configuración ( texstudio.ini) respectivamente. Esta expansión es
particularmente útil si utiliza una versión portátil en una memoria USB en la que la ubicación
real del programa puede depender de la computadora que está utilizando.

Para facilitar la vida, TeXstudio le permite elegir un idioma preferido para el corrector
ortográfico. Sin embargo, si trabaja con frecuencia con archivos en diferentes idiomas, es posible
que desee anular el comportamiento predeterminado. Esto se puede hacer de dos
formas. Primero puede especificar el idioma del archivo a través del menú de idioma en la línea
de estado. Esta configuración se perderá tan pronto como se cierre el archivo. Para guardar
permanentemente el idioma del archivo, TeXstudio admite un "comentario mágico" especial %
!TeX spellcheck = de_DE. Si este comentario está presente en un archivo, su idioma se
establece automáticamente cuando se carga el archivo.
 Tenga en cuenta: el corrector ortográfico con Ctrl + Shift + F7 comienza en la posición del cursor
y no al principio del documento.

Si el corrector ortográfico interactivo está habilitado (predeterminado), cualquier palabra mal

escrita se subraya con una onda roja. Haga clic derecho en la palabra para abrir un menú con una
lista de posibles correcciones. En este menú contextual también puede agregar la palabra a la
lista de ignorar. Si su diccionario es muy grande (> 5 MB), abrir el menú contextual y mostrar
posibles sugerencias puede llevar algunos segundos. Si no necesita la sugerencia, puede presionar
shift mientras hace clic derecho y no tiene que esperar.

Como la estructura interna de los diccionarios es compleja (por ejemplo, contiene reglas sobre
cómo generar una palabra en diferentes inflexiones), no es posible simplemente agregar palabras
al diccionario. En cambio, si falta una palabra en el diccionario, puede agregarla a una lista de
ignorar, para que el corrector ortográfico no se queje. La lista de ignorar normalmente se guarda
en el mismo directorio que el diccionario. Es un archivo de texto sin formato con la extensión
.ign. Si esto no es posible (por ejemplo, falta de derechos de acceso), la lista se almacena en el
directorio de configuración del usuario.

1.4.2 Configurar el tesauro

El diccionario de sinónimos usa las bases de datos de OpenOffice.org 2.x. Solo las bases de datos
GPL en francés y en inglés de los Estados Unidos y en alemán se distribuyen con TeXstudio.
Los usuarios pueden descargar otras bases de datos
aquí: http://wiki.services.openoffice.org/wiki/Dictionaries

1.4.3 Configuración del verificador de sintaxis de látex

El corrector de sintaxis de látex toma la lista de posibles comandos de finalización para

determinar si un comando es correcto. Además, la lista de finalización contiene información
parcialmente adicional para determinar en qué contexto un comando es válido, si es válido solo
en modo matemático o solo en modo tabular.

1.4.4 Configurar el corrector gramatical

El corrector gramatical se basa en la API http estándar de LanguageTool y requiere una

instalación separada de LanguageTool y java.

Una vez que se instala LanguageTool, puede intentarlo iniciando la aplicación autónoma
LanguageTool e iniciando TeXstudio posteriormente. LanguageTool luego crea un servidor que se
ejecuta localmente en la dirección http: // localhost: 8081 / y TeXstudio se conecta
automáticamente al inicio. Cuando se establece la conexión, todos los párrafos escritos se envían
a LT y después de un breve retraso se resaltan los posibles errores de gramática.

Para iniciar automáticamente LanguageTool con TeXstudio, debe ingresar la ruta al jar LT en la
página de la gramática del diálogo de configuración. Si el ejecutable de Java no está en la ruta
de acceso predeterminada, también debe establecer la ruta hacia allí.

En el modo de configuración avanzada, también puede marcar ciertas reglas LT como

"especiales", cuyas coincidencias se resaltarán de una manera diferente / personalizable. Esto
puede ser útil para hacer un análisis estilístico, por ejemplo, creando una regla propia en LT que
resalte todos los verbos o todos los adverbios.
 Independientemente de LanguageTool, TeXstudio también busca palabras repetidas y malas
(imprecisas / argot). El control de repetición muestra varias palabras atrás y marca la repetición
de palabras cortas en el entorno inmediato y la repetición de palabras largas de hasta 10
palabras. Estas distancias y longitudes se pueden cambiar en la página de configuración de
gramática avanzada.

1.5 Configuración de la autocompletación

TeXstudio ha tomado listas de palabras completas de kile que ampliaban considerablemente la

cantidad de comandos conocidos para completar. TeXstudio entiende el uso de \ documentclass y
\ usepackage para seleccionar listas válidas de comandos para completar así como también la
verificación de sintaxis. Sin embargo, TeXstudio le permite a uno seleccionar las listas de
palabras adicionales en "Configurar TeXstudio" -> "Editor" -> "". Los nombres de las listas de
palabras corresponden al paquete para el que están hechas. La lista latex.cwl contiene los
comandos estándar de látex.
En cuanto a la finalización automática, TeXstudio permite adaptar el comportamiento a su
gusto. Las siguientes opciones están disponibles:

 Finalización habilitada: auto explicativa

 Mayúsculas y minúsculas: le permite completar, por ejemplo, \ Large de \ la ...
 en el primer personaje:?
 Prefijo común automático completo: si solo hay un elemento en la lista o todos los elementos
en la lista de finalización comparten caracteres iniciales comunes, los caracteres comunes se
insertan directamente, como presionar la tecla Tab.
 Completa el texto seleccionado cuando se presiona el carácter sin palabra: cuando está en el
modo de finalización, al presionar un carácter que no es palabra como el espacio, lleva a
aceptar la palabra seleccionada. Esto puede acelerar el tipeo.
 Habilitar información sobre herramientas: muestre sugerencias de herramientas sobre los
comandos latex seleccionados en la lista de finalización.
 Use Placeholders: si los comandos completados tienen opciones que deben completarse,
"place holder" se colocan en estas posiciones y se pueden saltar usando Ctrl + Derecha / Ctrl +
Izquierda.

Si su paquete favorito aún no está presente para su finalización (y luego tampoco para la
verificación de sintaxis), puede proporcionar una lista propia colocando un archivo
"nombredepaquete.cwl" en el directorio de configuración. Este directorio se ubica en ~ / .config
/ texstudio en Linux y usualmente en "c: \ Documents and Settings / User / AppData / Roaming /
texstudio" en windows. Básicamente, el archivo contiene una lista de comandos válidos. Una
descripción del formato exacto y un ejemplo se dan en el apéndice .
1.6 Configuración de accesos directos

Los accesos directos se pueden cambiar haciendo doble clic en "Acceso directo actual" o "Acceso
directo adicional". Se puede seleccionar un atajo de la lista desplegable o ponerlo como texto
directamente. Si un acceso directo debe establecerse en valor predeterminado o eliminarse por
completo, se pueden seleccionar los elementos "<predeterminado>" o "<ninguno>" en la parte
superior de la lista.
1.7 Configuración del Latex / Math-Menu (opción avanzada)

El menú de Matemáticas / Latex se puede adaptar a las preferencias de los usuarios. Para este
menú, los elementos pueden renombrarse y se puede colocar un nuevo Latex-Code. El elemento
apropiado se puede editar directamente haciendo doble clic en ellos.
1.8 Configuración de la barra de herramientas personalizada (opción
avanzada)

Una barra de herramientas personalizada está presente en TMX. Esta barra de herramientas
puede llenarse con acciones del menú Latex, Math y User-Menu. Como muchos de esos elementos
no tienen iconos, también se pueden cargar iconos de usuario. Esto se logra aplicando "cargar
otro ícono" desde el menú contextual en un ítem en la lista personalizada de la barra de
herramientas en el cuadro de diálogo de configuración.
1.9 Configurando el soporte SVN

Para admite SVN (subversión) para el control de versiones de documentos. Para utilizarlo, es
necesario instalar las herramientas de línea de comandos de SVN. Linux y Mac OSX normalmente
proporcionan herramientas svn, para Windows se recomienda la instalación de "SlikSVN".
La ruta completa al comando "svn" y "svnadmin" debe ajustarse en el campo de prioridad de la
página Comandos en las opciones. En la página SVN puede elegir el grado de automatización (ver
a continuación) WSVN, ver a continuación.

Nota: No puede pagar un depósito a través de TeXstudio. Simplemente use las herramientas
normales para esto (ya sea svn checkout en la línea de comandos o la GUI de su elección). Una
vez que tenga una copia de trabajo, TeXstudio puede operar en ella.

"Registrar automáticamente después de guardar" permite a TeXstudio realizar una comprobación

de svn después de guardar cada documento, proporcionando así un historial muy completo de la
creación de un documento. Dado que los documentos de texto son bastante pequeños en
comparación con los espacios de disco, el tamaño de la base de datos svn no debería ser un
problema. Además, los archivos recién guardados (guardar como) se agregan automáticamente al
control svn, siempre que el directorio ya esté bajo el control svn. Si ese no es el caso, TeXstudio
busca en el directorio "Profundidad de búsqueda en el directorio SVN" encima de la estructura
actual para un directorio controlado por svn al que se agregarán los subdirectorios y el
documento TeX. Si no se encuentra un directorio apropiado, se genera automáticamente un
repositorio en un directorio llamado "./repo" y se agrega el documento. Por lo tanto, el usuario
no necesita buscar los comandos necesarios para configurar un repositorio. Esta funcionalidad
solo se activa cuando está habilitada la función "Auto check in".

Con "Revisiones de SVN de usuario para deshacer antes del último guardado", TeXstudio realizará
el deshacer como habitualmente, pero si no hay más comandos deshacedores en el
almacenamiento interno, el documento se cambiará a la versión anterior en el historial de
svn. Los comandos de deshacer adicionales le permiten a uno retroceder aún más a revisiones
anteriores, mientras que un rehacer avanza a versiones más recientes. Este es un enfoque más
interactivo que elegir revisiones svn directamente a través de un comando de menú, ver sección
4.3
2. Editar un documento TeX

2.1 Comandos habituales

Los comandos estándar (cortar, copiar, buscar ...) se pueden iniciar a través del menú "Editar" y
la barra de herramientas "Editar".
 2.2 Creando un documento nuevo
Hay dos maneras diferentes de crear un nuevo documento que se describen en las siguientes
subsecciones:

2.2.1 Establecer el preámbulo de un documento TeX

Para definir el preámbulo de su documento, puede usar el asistente de "Inicio rápido" (menú
"Asistente").

Este diálogo le permite establecer las características principales de su documento (clase, tamaño
del papel, codificación ...).
Nota: Puede agregar otras opciones haciendo clic en los botones "+". Toda su configuración está
grabada.

También puede escribir su propio modelo de preámbulo en el editor: con los comandos "Copiar /
pegar" o "Guardar como", puede usarlo para un nuevo documento.
2.2.2 Usar plantillas para comenzar un nuevo documento

Para documentos nuevos, las plantillas se pueden usar utilizando el comando "Archivo / Nuevo
desde plantilla". Un diálogo brinda una selección de plantillas.

Puede crear un nuevo documento de editor a partir de la plantilla o crearlo como archivo (s) en
el disco y abrirlos en el editor. La primera opción no está disponible para plantillas de archivos
múltiples.

Se pueden crear nuevas plantillas utilizando el comando "Archivo / Hacer plantilla" en un

documento abierto que le gustaría tener una plantilla. Tenga en cuenta que este diálogo
actualmente no admite todas las capacidades del sistema de plantillas. En particular, no puede
proporcionar una imagen de vista previa o crear una plantilla de múltiples archivos con
ella. Tendrás que hacer esto manualmente (ver el formato de la plantilla ).

Las plantillas añadidas por el usuario se pueden editar o eliminar utilizando el menú contextual
en el cuadro de diálogo de selección de plantillas. Las plantillas incorporadas no se pueden
cambiar.
 Las plantillas de usuario se guardan en el /templates/user/subdirectorio del directorio
config.

2.2.2.1 El formato de la plantilla

En su forma más simple, una plantilla es solo un archivo .tex. Se pueden crear plantillas de varios
archivos empaquetando todos los archivos .tex en un archivo zip. Opcionalmente, los metadatos
pueden almacenarse en formato JSON en un archivo separado con el mismo nombre, pero con la
extensión ".json" en lugar de ".tex" o ".zip". Actualmente, las siguientes entradas son compatibles
con los metadatos:

{
"Nombre": "Libro",
"Autor": "TXS incorporado",
"Fecha": "04.01.2013",
"Versión": "1.1",
"Descripción": "Clase LaTeX predeterminada para libros que utilizan
archivos separados para cada capítulo".
"Licencia": "Dominio público",
"FilesToOpen": "./TeX_files/chapter01.tex;main.tex"
}

FilesToOpen solo tiene un efecto para los documentos de varios archivos. Puede agregar una
imagen de vista previa al lado del archivo de la plantilla. De nuevo, debe tener el mismo
nombre, pero la extensión ".png".

2.3 Estructura de un documento

Para definir una nueva parte (sección, subsección ...) en su documento con TeXstudio,
simplemente use este botón de cuadro combinado en la barra de herramientas:

2.4 Buscando su documento

La "Vista de estructura" (panel izquierdo) le permite llegar rápidamente a cualquier parte de su

documento. Todo lo que necesita hacer es hacer clic en cualquier elemento (etiqueta, sección
...) y se lo llevará al principio del área correspondiente en el editor. El mecanismo para saltar a
una línea ya no considera los números de línea, sino que realmente recuerda las líneas de
texto. Por lo tanto, agregar y quitar líneas no conducirá a saltos a ubicaciones incorrectas.

Un fondo gris muestra también la posición actual del cursor en el texto en la vista de
estructura. Un fondo verdoso denota secciones que están en el apéndice.
 La "Vista de estructura" se actualiza automáticamente a medida que escribe. También puede
utilizar el comando "Refrescar estructura" (menú "Idefix") en cualquier momento.

La vista de estructura muestra etiquetas, secciones, incluye y bloques de beamer y todos.

Hay dos tipos de todos que se enumerarán a) todos a partir de un comando similar, por ejemplo,
\ todo {} del paquete todonotes. b) comentarios de tipo todo: este es un comentario con una
primera palabra en mayúscula, por ejemplo, "% TODO", "% FIXME", "% ASK".

La vista de estructura también ofrece un menú contextual que permite copiar / cortar todo el
texto que pertenece a una sección (incluida la subsección) y pegarlo antes o después de una
sección. La sección puede ser indentada / sin sangrar, lo que significa que el nivel de jerarquía
se cambia por uno, es decir, \ la sección se cambia a \ subsección, y todas las subsecciones se
tratan en consecuencia

Para cada archivo, se pueden usar tres marcadores para acelerar la navegación: simplemente
haga clic en un número de línea para agregar o eliminar un marcador. Cuando ya haya definido
tres marcadores, debe eliminar uno de ellos para agregar un nuevo marcador. Para saltar a la
línea correspondiente a un marcador en el editor, simplemente haga clic en los botones en la
barra de estado.

2.5 Formateando su texto

Puede establecer rápidamente el formato de una parte de su texto con esta barra de
herramientas:
 Opción adicional: un texto seleccionado puede enmarcarse directamente en ciertos
entornos. Ejemplo: al hacer clic en el botón "Negrita" después de haber seleccionado la palabra
"Hola", obtendrá el código: \ textbf {Hello}.
Esta opción está disponible para todos los entornos indicados por "[selección]" en el menú
"LaTeX".

Capitalización

El menú "Editar" -> "Operaciones de texto" contiene algunos métodos para cambiar las
mayúsculas del texto seleccionado:

 A minúscula
 A mayúsculas
 A Titlecase (estricto)
 Para Titlecase (inteligente)

Ambas variantes de "A Titlecase" dejan palabras pequeñas como a, the, of etc. en
minúsculas. Además, "To Titlecase (smart)" no convierte ninguna palabra que contenga letras
mayúsculas, suponiendo que son acrónimos que requieren una capitalización fija (por ejemplo,
"TeXstudio").

Escapar personajes reservados

Si tiene texto que contiene caracteres reservados de TeX y desea que el texto aparezca
literalmente en su documento, debe escapar de los caracteres ocultos reservados para evitar que
LaTeX los interprete. Las siguientes funciones se encargan de eso (Menú: Idefix)

 Pegar en LaTeX: toma el texto del portapapeles y escapa de los caracteres reservados antes
de pegarlo en el editor.
 Convertir a LaTeX: escapa de los caracteres reservados en la selección actual.

Por ejemplo: "Menos del 10% de los usuarios de computadoras conocen el significado de $
PATH". se convertirá en "Menos del 10 \% de los usuarios de computadoras conocen el significado
de \ $ PATH".

2.6 Espaciamientos

Los comandos habituales de "espaciado" están disponibles en los menús "LaTeX" y "Math".

2.7 Insertar una lista

El código de entornos de lista habitual se puede insertar rápidamente a través del menú "LaTeX-
List".
Nota: el atajo para el comando \ item es Ctrl + Shift + I.

2.8 Insertar una tabla

Con el asistente "Tabular" (menú "Asistente"), se puede insertar rápidamente el código LaTeX
para un entorno tabular:
 Puede establecer las características principales de su tabla.
Nota: este diálogo le permite escribir directamente el código en las celdas.
El código LaTeX correspondiente se inserta automáticamente en el editor.

2.8.1 Manipulación de tablas

TeXstudio proporciona algunos comandos para facilitar el manejo de las tablas. Los comandos se
encuentran en LaTeX → Manipular tabla y en la barra de herramientas de la tabla. Tenga en
cuenta que pueden surgir algunos resultados inesperados, si los comandos de construcción de
tablas se vuelven demasiado complejos. Se ofrecen los siguientes comandos:

 Agregar fila después de la fila actual

 Eliminar fila: elimina la fila de la tabla en la que se encuentra el cursor
 Agregar columna: agrega una columna en la tabla completa después de la posición actual del
cursor. Si el cursor está posicionado al inicio de la línea, primera columna, la columna se
agrega como nueva primera columna.
 Eliminar columna: eliminar la columna actual
 Agregar / Eliminar \ hline: agregar / eliminar \ hline en todas las filas que siguen a la fila
actual. Si ya está presente una línea de comando, no se coloca un segundo comando.
 Alinear columnas: alinea los separadores de columna (signo) introduciendo espacios en
blanco. El texto en las celdas se alinea según la especificación en el encabezado de la
tabla. Esto ayuda a leer la fuente de la tabla.
 Remodelar la tabla después de una plantilla. Esto permite forzar la configuración uniforme de
la tabla en un documento. Algunas plantillas están predefinidas, se pueden agregar más,
aunque necesitan programación en el script java. Este comando solo está presente en el menú
(matemáticas / tablas)
 TeXstudio también permite cursores de bloque. Presione <Ctrl> + <Alt> + <Shift> y arrastre el
cursor con el mouse. El cursor de bloque funciona como un conjunto de cursores normales. Puede
copiar y pegar texto como de costumbre. También puede escribir texto nuevo, que se agregará
en cada fila.

2.9 Insertar un entorno de "tabbing"

Para ayudarlo a insertar un código "tabbing", puede usar el asistente "Tabbing" (menú "Wizard"):

2.10 Insertar una imagen

Para insertar una imagen en su documento, simplemente use el comando "\ includegraphics" en
el menú "LaTeX". Luego, haga clic en el botón "navegador" en el cuadro de diálogo para
seleccionar el archivo gráfico.
Nota: puede insertar un entorno LaTeX "figura" (menú "LaTeX - Entornos") antes de insertar la
imagen.

2.10.1 Insertar una imagen usando un "asistente"

Insertar correctamente las cifras es un desafío para los principiantes de LaTeX y todavía bastante
texto para escribir para el experto. Por lo tanto, TeXstudio ofrece un asistente para manejar el
código de inserción de gráficos en su documento. "Opciones de gráficos" define el parámetro
 opcional de \insertgraphics[options]{file}. Si bien los atributos de ancho / alto más
utilizados se pueden configurar fácilmente, como alternativa, usted tiene control total con la
configuración definida por el usuario.
Coloque el gráfico dentro de un figureentorno si no tiene que estar en una posición exacta en
el texto. Entonces LaTeX determinará una posición óptima en la página.
Al presionar el botón "Guardar como predeterminado", la configuración actual (excepto archivo,
título y etiqueta) se almacena y, por lo tanto, se utilizará de manera predeterminada cuando
abra el asistente.
El asistente también entra en juego cuando arrastra una gota de un archivo de imagen a su
documento o usa copiar en el explorador y pegarlo en TeXstudio. Junto con los parámetros
predeterminados ajustables, esto hace que la inserción de nuevas imágenes sea muy
rápida. Además, si inicia el asistente mientras el cursor está en el código de la imagen, el
asistente se usa para manipular la configuración de imagen existente.

2.11 Referencias cruzadas y notas

 Esta caja de herramientas en la barra de herramientas le permite insertar rápidamente el código
de etiqueta, cita, referencia, nota al pie ...
Nota: las etiquetas utilizadas en sus documentos se muestran en la "Vista de estructura".

Opción adicional: para el comando \ ref, un cuadro de diálogo le permite seleccionar

directamente la etiqueta.

2.12 Insertar fórmula matemática

Puede alternar en el entorno "matemática en línea" con el botón "f (x)" en la barra de
herramientas (acceso directo: Ctrl + Alt + M) o con el menú "Matemáticas". El acceso directo para
el entorno "visualizar matemática" es: Alt + Shift + M.
La barra de herramientas "Matemáticas" le permite insertar las formas matemáticas más
corrientes (frac, sqrt ...) como las etiquetas \ left y \ right.

Con los "paneles de símbolos" en la vista de estructura, puede insertar el código de 400 símbolos
matemáticos.

También puede definir el formato de su texto matemático a través del menú "Matemáticas".
Para los entornos de "matriz", un asistente (como el asistente "Tabular") está disponible en el
menú "Asistente". Con este asistente, puede seleccionar el entorno: matriz, matriz, pmatriz ...
Las celdas se pueden completar directamente.
2.13 Terminación automática

Cada vez que presiona \ seguido de una letra, se muestra una lista de posibles etiquetas de
LaTex donde selecciona la correcta. Si escribe letras adicionales, la lista se filtra, por lo que solo
se muestran las etiquetas que comienzan con el texto ya escrito. Si la lista contiene palabras que
comienzan con la misma combinación de letras, puede presionar Tab para completar todas las
letras comunes. Si solo hay un elemento presente en la lista, Tab selecciona este para
completar, como Enter. Este comportamiento es similar a la finalización de pestañas en shell
bash. También puede presionar Ctrl + Espacio para abrir esta lista cuando lo desee.
Si una etiqueta tiene diferentes opciones, se inserta un breve texto descriptivo en su texto, que
le indica el significado de cada opción. Puede presionar Ctrl + Izquierda, Ctrl + Derecha para
seleccionar todas las posiciones.
Además, el texto normal puede completarse comenzando a escribir una palabra y presionando
Ctrl + Espacio. Todas las palabras apropiadas en el documento actual se utilizan como posibles
sugerencias.
Si se va a insertar un entorno, escribir al principio del nombre del entorno y presionar Ctrl + Alt +
Space da sugerencias de entornos adecuados que se insertan completamente con \ begin {env} ..
\ end {env}
Y finalmente las etiquetas de usuario pueden se le asignará una abreviatura que también se
puede usar con terminación. Simplemente escriba el comienzo de la abreviatura y comience la
finalización con Ctrl + Espacio. La abreviatura debe aparecer en la lista de finalización,
especialmente marcada con "abreviatura (plantilla)".
Si cambia un comando completando un nuevo comando, solo se sustituye el nombre del
comando. Lo mismo es cierto para los entornos, donde el entorno se cambia en el comando \
begin- and \ end-command.
2.14 Tesauro

TeXstudio ha integrado un diccionario de sinónimos simple. Las bases de datos de OpenOffice 2.x
se usan para esto. Al colocar el cursor en una palabra y activar el diccionario de sinónimos (Ctrl +
Shift + F8 o Editar / Tesauro), intenta buscar sinónimos para esta palabra. Tenga paciencia si
inicia el diccionario de sinónimos por primera vez, ya que la carga de la base de datos se produce
en ese momento y puede demorar unos minutos.

La primera línea a la izquierda contiene la palabra, para la cual se busca un sinónimo. La

siguiente lista proporciona una lista de clases de palabras. Se puede elegir para reducir el
número de sugerencias. La columna a la derecha contiene la lista de sinónimos sugeridos. Una
palabra seleccionada de esta lista aparece en la primera línea a la derecha como proposición
para reemplazar el texto. Esta palabra se puede cambiar manualmente. También se usa para
hacer más investigaciones de palabras y sus sinónimos que "comienzan con" o "contienen" esa
palabra. Con "búsqueda" se puede usar directamente para buscar un sinónimo de esa palabra.

2.15 Comandos especiales

Eliminar palabra / comando / entorno

Con el atajo Alt + Supr, se elimina la palabra debajo del cursor. Si se trata de un comando, el
comando se elimina, incluidos los corchetes de apertura y cierre. Por ejemplo, "\ textbf {text}"
deja "text". Si se trata de un entorno, el bengin / end adjunto se elimina.

Cambiar el nombre del entorno

Si coloca el cursor en un nombre de entorno o en el comando inicial o final correspondiente,

después de un momento se activa un cursor reflejado en el nombre del entorno que permite el
cambio sincrónico del nombre del entorno en el comando inicial y final. Entonces, si desea
cambiar una construcción de "\ begin {tabular} ... \ end {tabular}" a "\ begin {tabularx} ... \ end
{tabularx}", coloque el cursor de texto en "tabular", espere por un segundo y luego, después de
que aparezca el cursor reflejado, cambie "tabular" a "tabularx".
 Cut Buffer

Si selecciona algo y luego comienza a escribir un comando y completarlo, la selección se coloca

como primer argumento. Por ejemplo, tiene un "texto", selecciónelo y comience a escribir "\
textbf", comando que se completa. El texto resultante es "\ textbf {text}"

3. Compilación de un documento

3.1 Compilación

La forma más fácil de compilar un documento es usar el comando "Compilar" o el comando "Crear
y ver" (botón "Compilar" - atajo: F6). Puede seleccionar el comando predeterminado a través del
diálogo "Configurar TeXstudio".
(También puede ejecutar cada comando uno por uno en el menú "Herramientas").
Nota: el comando "Limpiar" en el "menú Herramientas" le permite borrar los archivos (dvi, toc,
aux ...) generados por una compilación LaTeX (excepto los archivos ps y pdf).

Advertencia: todos sus archivos deben tener una extensión y no puede compilar un archivo "sin
título" o un archivo con un espacio en su nombre .

3.2 Los archivos de registro

Con el comando "Creación rápida", el archivo de registro se muestra automáticamente en el

panel "Mensajes / Archivo de registro". Al hacer clic en un número en la columna "Línea", el
cursor se coloca en la línea correspondiente en el editor y se muestra el error.
Observación: se muestra un resumen de los errores y advertencias de látex antes del archivo de
registro completo.

Los comandos "Next Latex Error" y "Previous LaTeX Error" permiten llegar a los errores detectados
durante la compilación.
 Las líneas con errores, advertencias, cuadros incorrectos se resaltarán con fondo rojo, amarillo o
azul y puede saltar entre ellos usando Ctrl + Arriba / Abajo. (Ctrl + Shift solo para errores, Ctrl +
Alt solo para advertencias, Alt + Shift para cuadros malos solo)
Una información sobre herramientas mostrará más detalles del error si saltas a una línea
(también se muestra si mueves el mouse sobre la marca dejada de los números de línea).

4. Otras características

4.1 Acerca de documentos separados en varios archivos

Los documentos LaTeX pueden distribuirse en varios archivos. TeXstudio entiende

automáticamente las relaciones padre / hijo de los documentos cargados. Esto incluye la
detección del documento raíz y el conocimiento sobre etiquetas y comandos definidos.

4.1.1 Documento raíz

El documento raíz es el archivo más alto en un documento de varios archivos. Para un documento
de un solo archivo, este es el archivo en sí. Por defecto, todas las llamadas a LaTeX se realizarán
en el documento raíz.

TeXstudio detecta automáticamente el documento raíz. Si eso no funciona, puede colocar un

comentario mágico % !TeX root = root-filenameen la parte superior de los archivos
incluidos.

Como último recurso, puede establecer un documento raíz explícito a través de Options ->
Root Document -> Set Current Document As Explicit Root. Esta configuración toma
presencia absoluta. Todos los comandos del menú "Herramientas" se invocarán en este
documento (para ser más precisos, el sistema de compilación explicará el
marcador %de posición en el documento raíz), sin importar qué documento esté activo en el
editor. Además, las etiquetas y los comandos de usuario que se definen en cualquier documento
abierto se pueden usar para completar en cualquier documento abierto.

En versiones anteriores, el documento raíz explícito se llamaba un tanto

engañosamente documento maestro .

4.1.2 Documentos cargados

Obviamente, TeXstudio solo puede usar información (comandos definidos, etiquetas, documentos
hirachy, etc.) de los que tenga conocimiento. Usamos la información en todos los archivos
abiertos, pero si se define una etiqueta en un documento de varios archivos en un archivo no
cargado, TeXstudio no lo sabe y lo marcará como faltante en las referencias. Para remediar esto,
puede simplemente abrir el archivo correspondiente también.

Las versiones más recientes de TeXstudio tienen una opción avanzada Editor ->
Automatically load included files. Está deshabilitado por defecto por razones de
rendimiento con sistemas más antiguos. Cuando habilite esta opción, TeXstudio cargará y
analizará automáticamente todos los archivos de documentos múltiples tan pronto como se abra
uno de los archivos. Es posible que deba establecer el comentario mágico % !TeX root =
root-filenamesi no tiene abierto el documento raíz. Con esta opción habilitada, TeXstudio
 siempre conocerá su documento completo y actuará en consecuencia al realizar resaltado o
finalización.

4.2 Comprobación de sintaxis

El corrector de sintaxis de látex toma la lista de posibles comandos de finalización para

determinar si un comando es correcto. La lista de finalización contiene información parcialmente
adicional para determinar en qué contexto un comando es válido, si es válido solo en modo
matemático o solo en modo tabular.
Además, se comprueba la exactitud de los tabuladores con un poco más de detalle. El número de
columnas se analiza y verifica en las filas siguientes. Si se dan más o menos columnas en una fila,
se muestra un creador de advertencia.

4.3 Bibliografía

Para los archivos "bib", el menú "Bibliografía" le permite insertar directamente las entradas
correspondientes a los tipos de documentos estándar.
Nota: los campos opcionales se pueden eliminar automáticamente con el comando "Limpiar" del
menú "Bibliografía".

4.4 Soporte SVN

Además de las funciones svn compatibles que ya se describen en la sección 1.8, TeXstudio admite
dos comandos más.

"Archivo / chekin" realiza un guardar y registrar explícitamente, con un diálogo de entrada que
solicita un mensaje de registro que se almacena en el historial de svn.

"Archivo / Mostrar revisiones anteriores" muestra un cuadro de diálogo que muestra todas las
revisiones disponibles. Una selección de una revisión anterior conduce a un cambio instantáneo
del documento actual a la revisión anterior. Puede seleccionar y copiar partes antiguas para
transferirlas a la versión más reciente de su documento, copiando las partes y luego volviendo a
la versión más reciente. Si comienza a editar ese documento directamente, el cuadro de diálogo
se cierra y el texto actual es su última versión más reciente, aunque no haya sido guardada.
 4.5 Macros personales

TeXstudio le permite insertar sus propias macros (accesos directos: Shift + F1 ... Shift +
F10). Estas macros se definen con el menú "Macros - Editar macros". Las macros pueden consistir
en texto simple que se coloca directamente en txs. También puede ser un "entorno" que se
extiende automáticamente por principio / fin y puede ser un script de Java. La funcionalidad
necesaria se puede seleccionar mediante la casilla de verificación.
La "abreviatura" es un pseudo-comando para el látex que completa. Si se completa el pseudo-
comando, la macro se insertará en su lugar. Tenga en cuenta que el pseudo-comando debe
comenzar con una barra invertida ("\").
"Trigger" es una expresión regular que activa la inclusión de la macro: cuando los últimos
caracteres escritos coinciden con esta expresión, se eliminan y la macro se inserta / ejecuta.

4.5.1 Macros de texto

Aparte del texto normal, algunos códigos especiales son reconocidos y reemplazados en la inserción.

 Si escribe% | en algún lugar el cursor se colocará en ese lugar en el texto insertado. (Un
segundo% | seleccionará todo entre ellos).
 Escriba% <something%> para marcarlo como marcador de posición que se resalta en el texto y
se puede seleccionar con Ctrl + Izquierda / Derecha.
 Las propiedades adicionales del marcador de posición se pueden establecer después de un% :,
por ejemplo,% <algo%: persistente, id: 123, espejo%>. Las propiedades disponibles son:
o seleccionar: se seleccionará el marcador de posición (similar a% |)
o multilínea: el marcador de posición se utiliza para texto de líneas múltiples. Si una
inserción de macro reemplaza un texto existente, el texto reemplazado se inserta
nuevamente en un marcador de posición en la macro. Si el texto original abarca más
de una línea, se insertará en un marcador de posición con la propiedad de líneas
múltiples. De lo contrario, en un marcador de posición con la propiedad seleccionada.
o persistente: el marcador de posición no se elimina automáticamente, cuando se
cambia su texto en el editor
o espejo: el marcador de posición es un espejo de otro marcador de posición en la
macro y, por lo tanto, siempre tendrá el mismo contenido que el marcador de
posición original. Debes establecer una identificación, para que sepa qué marcadores
de posición están conectados
o id: 123: la identificación del marcador de posición
o columnShift: -12: el marcador de posición no se coloca donde están los marcadores%
<, pero algunas columnas a la izquierda de este
o traducible: el texto del marcador de posición debe agregarse a las traducciones (solo
aplicable a macros que se conocen durante la compilación de texstudio).
 La opción% ( filefilter %) se reemplazará por un nombre de archivo que se solicita en un
cuadro de diálogo de archivo. El filtro de archivos es el formato estándar Qt-Filefilter. Por
ejemplo, "Imágenes (* .png * .xpm * .jpg) ;; Archivos de texto (* .txt) ;; Archivos XML (* .xml)",
ver también Qt-Doc

4.5.2 Macros de entorno

El texto se usará como nombre-entorno, por lo que se insertará "% environment" como:
\ begin {environment}

\ end {environment}

Nota: texstudio necesita que el nombre-env comience con "%", aunque ese carácter no sea colocado en
la inserción.

4.5.3 macros de Javascript

En lugar de utilizar fragmentos de código, también puede hacer uso de javascript. Para hacerlo, ponga
"% SCRIPT" en la primera línea. El siguiente código se interpretará como javascript. El lenguaje está
basado en ECMAScript . Para acceder al documento, se introducen estos objetos:

 "editor" permite algunas operaciones de nivel superior como buscar / guardar / cargar. en el
documento actual
 "cursor" da acceso a las operaciones del cursor, como mover, insertar y eliminar textos.
 "fileChooser" da acceso al diálogo filechooser, un diálogo de selección de archivo muy simple
 "aplicación" para acceder a cosas amplias de la aplicación, como el portapapeles o los menús

La siguiente tabla ofrece una descripción general de los posibles comandos.

Mando Descripción
 Alcance global
alerta (str), información (str),
advertencia (str) o crítica (str)
confirmar (str) o
confirmarAdvertencia (str)
depurar (str)
writeFile (nombre, valor)
readFile (nombre)
sistema (cmd, workingDirectory = "")
setGlobal (nombre, valor)
getGlobal (nombre)
hasGlobal (nombre)
setPersistent (nombre, valor)
getPersistent (nombre)
muestra str en un cuadro de mensaje
con un cierto icono
muestra str como una pregunta sí / no
en un cuadro de mensaje
imprime str para stdout
Escribe valor para el nombre del
archivo (requiere privilegios de
escritura)
Lee el nombre completo del archivo
(requiere privilegios de lectura)
Llama a cmd y devuelve un objeto
ProcessX que tiene este metodo:
 waitForFinished: Espere hasta
que el proceso haya terminado
 readAllStandardOutputStr:
devuelve el stdout
 readAllStandardErrorStr:
devuelve el stderr
 exitCode: El código de salida
 exitStatus: el estado de salida
de qt
 terminar o matar: Detiene el
proceso
Si no se establece workingDirectory,
el directorio de trabajo se heredará
del ejecutable de TeXstudio.
Establece una variable temporal
global
Lee una variable global
Verifica la existencia de una variable
global
Establece una variable de
configuración global. (puede cambiar
los valores del archivo ini, requiere
privilegios de escritura)
Lee una variable de configuración
global. (puede leer todos los valores

hasPersistent (nombre)
hasReadPrivileges ()
hasWritePrivileges ()
registerAsBackgroundScript ([id])
triggerMatches
triggerId
incluir (script)
pdfs
Objeto Editor
Busca algo en el editor.
editor.search (searchFor, [opciones],
[alcance], [devolución de llamada])
del archivo ini, requiere privilegios de
lectura)
Comprueba si existe una variable de
configuración global. (requiere
privilegios de lectura)
Comprueba si el script tiene
privilegios de lectura
Comprueba si el script tiene
privilegios de escritura
Permite que el script se ejecute en
segundo plano (necesario si el script
debe manejar eventos / señales)
Coincidencias de la expresión de
activación periódica, si el script fue
llamado por un desencadenador
de editor .
Id. Numérico del desencadenador si
un desencadenante
de evento invocó el guión .
Incluye otro script Puede ser un
nombre de archivo o el nombre de una
macro.
Lista de todos los lectores de PDF
internos abiertos.
 searchFor es el texto que se
busca. Puede ser una cadena
(por ejemplo, "..") o una
expresión regular (por ejemplo,
/[.]{2}/).
 opciones es una cadena y una
combinación de "i", "g", "w"
para especificar un
caso- i nsensitive búsqueda,
un g de búsqueda lobal
(continuar después de que el
primer partido) o un

editor.replace (searchFor,
[opciones], [alcance], [replaceWith]) devolución de llamada. Si es una
editor.replaceSelectedText
(newText, [opciones])
Opciones es un objeto que puede
tener las siguientes propiedades:
todo- w búsqueda ord-
solamente.
 El alcance es un cursor que
restringe el ámbito de
búsqueda (ver
editor.documento (). cursor).
 la devolución de llamada es una
función que se solicita para
cada coincidencia. Un cursor
que describe la posición de la
coincidencia se pasa como
primer argumento.
Todos los argumentos, excepto
searchFor, son opcionales y el orden
puede cambiarse (lo que puede no ser
compatible en el futuro).La función
devuelve el número de coincidencias
encontradas.
Esta función busca y reemplaza algo
en el editor. Se comporta como
editor.search además del argumento
replaceWith que puede ser una
cadena simple o una función de
función, el valor de retorno de
replaceWith se usa para reemplazar la
coincidencia descrita por el cursor
pasado a replaceWith.
Esta función reemplaza las selecciones
actuales con newText o inserta
newText, si no se selecciona nada.
Si newText es una función, se
invocará con el texto seleccionado y
el cursor correspondiente, y el valor
de retorno será el newText.
Se recomienda utilizar esta función
para todas las sustituciones /
inserciones de texto, ya que es la
forma más fácil de manejar múltiples
selecciones de cursores / bloque
correctamente. Aunque solo está
disponible en txs> = 2.8.5.

editor.insertSnippet (texto);
editor.undo ();
editor.redo ();
editor.cut ();
editor.copy ();
editor.paste ();
editor.selectAll ();
editor.selectNothing ();
editor.cutBuffer
 {"noEmpty": true} solo
reemplaza; no inserta nada si la
selección está vacía
 {"onlyEmpty": true} solo se
inserta en la posición del
cursor; no cambia el texto
seleccionado no vacío
 {"append": true} agrega
newText a la selección actual,
no elimina el texto anterior
 {"prepend": true} Prepara
texto nuevo para la selección
actual, no elimina el texto
anterior
 {"macro": true} Trata newText
como texto macro normal, por
ejemplo, insertando% <%>
marcadores de posición
Ejemplos:
editor.replaceSelectedText("world",
{"append": true} )Agrega "mundo" a
las selecciones actuales.
editor.replaceSelectedText(function(
s){return
s.toUpperCase();})Convierte la
selección actual a mayúscula.
Inserta un fragmento de texto en el
editor. Para obtener una lista de
funciones extendidas y sintaxis,
consulte Macros de texto .
deshacer el último comando en editor
rehacer el último comando en editor
cortar la selección al portapapeles
copiar la selección al portapapeles
pegar contenidos del portapapeles
seleccionar todo
seleccionar nada (selecciones claras)
Si se desencadenó una macro al
presionar una tecla y hubo una
selección anterior a la pulsación de
tecla, el contenido de la selección se
almacena en cutBuffer. La selección y

editor.find ();
editor.find (QString text, bool
highlight, bool regex, bool word =
falso, bool caseSensitive = falso);
editor.find (QString text, bool
highlight, bool regex, bool word,
bool caseSensitive, bool deCursor,
bool selection);
editor.findNext ();
editor.replacePanel ();
editor.gotoLine ();
editor.indentSelection ();
editor.unindentSelection ();
editor.commentSelection ();
editor.uncommentSelection ();
editor.clearPlaceHolders ();
editor.nextPlaceHolder ();
editor.previousPlaceHolder ()
editor.setPlaceHolder (int i, bool
selectCursors = true);
editor.setFileName (f);
editor.write (str)
editor.insertText (str)
editor.setText ( texto )
editor.text ()
editor.text (línea int)
Objeto de documento
su contenido se eliminan antes de que
se ingrese la macro.
activar "buscar panel"
activar "buscar panel" con valores
predefinidos
activar "buscar panel" con valores
predefinidos
encontrar siguiente
reemplazar (si encuentra el panel
abierto y se selecciona algo)
activar "ir al panel de línea"
selección de sangría
selección de no elegidos
selección de comentarios
eliminar comentario
claro lugar titulares
saltar al siguiente lugar
saltar al lugar anterior
establecer Placeholder
establecer nombre de archivo para f
inserta str en la posición actual de los
cursores (si hay espejos de cursor, str
será insertado por todos)
inserta str en la posición actual del
cursor (los espejos del cursor se
ignoran, por lo que es preferible usar
replaceSelectedText o write en su
lugar)
reemplazar todo el texto del
documento actual por texto
devolver el texto del documento
completo
devolver el texto de la linea
editor.document (). lineCount () Devuelve la cantidad de líneas
editor.document (). visualLineCount Devuelve el número de líneas visuales
() (contando líneas envueltas)
Devuelve un objeto de cursor. Si se da
editor.document (). cursor (línea,
lineTo, el cursor tiene una selección
[columna = 0], [líneaA = -1],
de la línea: de la columna a la línea A:
[columnaA = longitud de líneaA])
de la columna, de lo contrario, no.
editor.document (). text
Devuelve el texto completo del
([removeTrailing = false],
documento
[preserveIndent = true])
Devuelve una matriz de todas las
editor.document (). textLines ()
líneas de texto
editor.document (). lineEndingString Devuelve una cadena que contiene el
() final de una línea (\ n o \ n \ r)
Devuelve verdadero si deshacer es
editor.document (). canUndo ()
posible
editor.document (). canRedo () Devuelve true si es posible rehacer
editor.document (). expand (lineNr) Expande la línea
editor.document (). collapse (lineNr) Contraer la línea
editor.document (). expandParents Expandir todos los padres de la línea
(lineNr) hasta que sea visible
editor.document (). foldBlockAt Se contrae o expande el primer
(bool unFold, lineNr); bloque antes de lineNr
editor.document (). Devuelve el documento abierto que
getMasterDocument (); incluye directamente este documento
editor.document (). Obsoleto: use getRootDocument () en
getTopMasterDocument (); su lugar
Devuelve el documento abierto que
editor.document (). indirectamente incluye este
getRootDocument (); documento y no está incluido en
ningún otro documento
editor.document (). Devuelve el contenido de un
getMagicComment (nombre); comentario mágico, si existe
editor.document ().
updateMagicComment (nombre, Cambia un comentario mágico
valor, [crear = falso]);
Devuelve los identificadores de todas
editor.document (). labelItems /
las etiquetas / referencias o archivos
refItems / bibItems
de bibliografía incluidos.
editor.document (). getLastEnvName Devuelve el nombre del entorno
(lineNr) actual (al final de la línea).
 Objeto Document Manager
documentManager.currentDocument
document.masterDocument
[documentManager.] documentos
documentManager.findDocument
(fileName)
documentManager.singleMode ()
documentManager.getMasterDocume
ntForDoc (documento)
documentManager.getRootDocument
ForDoc (documento)
documentManager.findFileFromBibId
(id)
Objeto Cursor
cursor.atEnd ()
cursor.atStart ()
cursor.atBlockEnd ()
cursor.atBlockStart ()
cursor.atLineEnd ()
cursor.atLineStart ()
cursor.hasSelection ()
Documento actual (generalmente lo
mismo que editor.document (), a
menos que el script se ejecute en
modo de fondo)
Documento maestro
Matriz de todos los documentos
abiertos
Devuelve el documento abierto con un
cierto nombre de archivo
Devuelve si no hay un documento
maestro explícito
Obsoleto: use
getRootDocumentForDoc (document)
en su lugar
Devuelve el documento abierto
(posiblemente indirectamente)
incluyendo el documento dado
Devuelve el nombre del archivo del
babero que contiene una entrada con
el ID proporcionado
devuelve si el cursor está al final del
documento
devuelve si el cursor está al comienzo
del documento
devuelve si el cursor está al final de
un bloque
devuelve si el cursor está al comienzo
de un bloque
devuelve si el cursor está al final de
una línea
devuelve si el cursor está al comienzo
de una línea
devolver si el cursor tiene una
selección

cursor.lineNumber ()
cursor.columnNumber ()
cursor.anchorLineNumber ()
cursor.anchorColumnNumber ()
cursor.shift (desplazamiento int)
cursor.setPosition (int pos,
MoveMode m = MoveAnchor)
cursor.movePosition (int offset,
MoveOperation op = NextCharacter,
MoveMode m = MoveAnchor);
devuelve el número de línea del
cursor
devuelve la columna del cursor
devuelve el número de línea del
anclaje.
devuelve la columna del ancla.
Cambie la posición del cursor
(columna de texto) por un número de
columnas (caracteres)
establecer la posición del cursor
después de pos-caracteres contados
desde el inicio del documento (muy
lento)
mover los tiempos de desplazamiento
del cursor . MoveOperations puede
ser:
 cursorEnums.NoMove
 cursorEnums.Up
 cursorEnums.Down
 cursorEnums.Left
 cursorEnums.PreviousCharacter
= Izquierda
 cursorEnums.Right
 cursorEnums.NextCharacter =
Derecho
 cursorEnums.Start
 cursorEnums.StartOfLine
 cursorEnums.StartOfBlock =
StartOfLine
 cursorEnums.StartOfWord
 cursorEnums.StartOfWordOrCo
mmand
 cursorEnums.PreviousBlock
 cursorEnums.PreviousLine =
PreviousBlock
 cursorEnums.PreviousWord
 cursorEnums.WordLeft
 cursorEnums.WordRight
 cursorEnums.End
 cursorEnums.EndOfLine
 cursorEnums.EndOfBlock =
EndOfLine
 cursorEnums.EndOfWord

cursor.moveTo (int línea, columna
int);
cursor.eraseLine ();
cursor.insertLine (bool keepAnchor =
false);
cursor.insertText (text, bool
keepAnchor = false)
cursor.selectedText ()
cursor.clearSelection ();
cursor.removeSelectedText ();
cursor.replaceSelectedText (texto);
cursor.deleteChar ();
cursor.deletePreviousChar ();
cursor.beginEditBlock ();
cursor.endEditBlock ();
Objeto de la aplicación
app.getVersion ()
 cursorEnums.EndOfWordOrCom
mand
 cursorEnums.NextWord
 cursorEnums.NextBlock
 cursorEnums.NextLine =
NextBlock
Las opciones para MoveMode son:
 cursorEnums.MoveAnchor
 cursorEnums.KeepAnchor
 cursorEnums.ThroughWrap
mover el cursor a la línea y a
la columna
eliminar la línea actual
insertar línea vacía
insertar texto de texto en el cursor
(esta función ignorará las sangrías y
los duplicados, vea editor.write y
editor.insertText)
devolver el texto seleccionado
borra la selección
elimina el texto seleccionado
reemplazar texto seleccionado
con texto
quita char a la derecha del cursor
elimina el carácter izquierdo del
cursor
comienza un nuevo bloque de
edición. Todas las operaciones del
cursor encapsuladas en un bloque de
edición se deshacen / rehacen a la
vez.
termina un bloque de edición
Versión actual (0xMMmm00)

app.clipboard
app.getCurrentFileName ()
app.getAbsoluteFilePath (rel, ext =
"")
app.load (archivo)
app.fileOpen / Save / Close /.../
editUndo /.../ QuickBuild / ...
app.newManagedMenu ([menú
principal,] id, título)
app.getManagedMenu (id)
app.newManagedAction (menú, id,
título)
app.getManagedAction ([id])
app.createUI (archivo, [padre])
app.createUIFromString (cadena,
[padre])
Propiedad para leer / escribir en el
portapapeles
Nombre de archivo del archivo
editado actualmente
Convierte un nombre de archivo
relativo a uno absoluto
Carga un archivo
Todos los comandos de menú (es
decir, todos los espacios en el archivo
texmaker.h). Puede ver una lista de
todas las ranuras existentes en la
página "menú" del diálogo de
configuración.
Crea un nuevo menú y lo devuelve
Devuelve un QMenu con cierta
identificación
Crea una nueva acción y la devuelve
 menú: menú principal
 id: identificación de la acción
nueva (la identificación final
única será identificador de
menú / identificación de
acción )
 leyenda: texto visible
Puede usar action.triggered.connect
(function () {...}); para vincular una
función a la acción devuelta (para más
información, consulte
la documentación de señal / ranura
de qt ).
Devuelve una QAction con una
identificación determinada (todas las
identificaciones tienen el formato
main / menu1 / menu2 /.../ menuN /
action, generalmente con un menú,
por ejemplo, "main / edit / undo", ver
texmaker.cpp)
Carga un determinado archivo ui y
crea un QWidget * a partir de él
Crea un QWidget * descrito en la
cadena

app.slowOperationStarted () /
slowOperationEnded ()
app.simulateKeyPress (atajo)
Clase UniversalInputDialog
nuevo UniversalInputDialog ()
dialog.add (defaultValue,
[description, [id]])
dialog.get (nr / id)
dialog.getAll ()
dialog.exec ()
dialog.show ()
UniversalInputDialog
([[defaultValue_0, description_0,
id_0], [defaultValue_1,
description_1, id_1], ...])
Notificar a txs sobre el inicio / fin de
una operación lenta para desactivar
temporalmente la detección de bucle
sin fin.
Dispare un evento KeyPress para el
atajo dado,
ej app.simulateKeyPress("Shift+Up").
Nota : esto es principalmente para
atajos y navegación. Actualmente, no
es compatible con todas las funciones
de un evento KeyPress. En particular,
no puede escribir ningún texto.
Crea un nuevo diálogo
Agrega una nueva variable con el valor
predeterminado dado, la descripción
opcional y el ID al diálogo; y devuelve
el componente qt correspondiente.
Un valor predeterminado de cadena se
convierte en QLineEdit, un número en
QSpinBox y una matriz en
QComboBox.
Devuelve el valor actual de la nr-
ésima variable añadida o la variable
con una determinada identificación.
Devuelve el valor de todas las
variables como conjunto combinado
numérico / asociativo. Puede usar
returnvalue [i] para obtener la
variable i-th, y returnvalue.id para
obtener la variable con una
determinada identificación.
Muestra el diálogo. Devuelve 1 si el
usuario aceptó el diálogo, 0 si fue
cancelado.
Muestra el diálogo de forma
asincrónica.
Forma abreviada: crea un nuevo
cuadro de diálogo, agrega todas las
variables de la matriz y ejecuta exec
en ella.
 Objeto FileChooser
fileChooser.exec ()
fileChooser.setDir (dir)
fileChooser.setFilter (filtro)
fileChooser.fileName ()
mostrar el diálogo y esperar hasta que
se cierre de nuevo
establecer el directorio en el diálogo
para dir
establecer filtro de archivo
para filtrar , utilizando el formato
QT, ver arriba
devolver el nombre de archivo
seleccionado (después de exec)

Algunos ejemplos:

 Copie el nombre actual del archivo al portapapeles:

 %GUIÓN

app.clipboard = editor.fileName ();

 Ejecución del texto del editor:

 %GUIÓN

eval (editor.text ());

 Mostrar todas las propiedades de un objeto:

 %GUIÓN
 function write_properties (obj) {
 app.fileNew ();
 newEditor =
documentManager.currentDocument.editorView.editor; // accede al
documento recién creado
 newEditor.setText (Object.getOwnPropertyNames (obj) .join
("\ n")); // imprime las propiedades
 }
 obj = editor; // objeto para mostrar (por ejemplo, el editor
actual)

write_properties (obj)

 Acción adicional en el menú de edición

 %GUIÓN
  var menu = app.getManagedMenu ("main / edit"); // obtener el
menú de edición
 var act = app.newManagedAction (menú, "script", "scripttest");
// añadir acción
 act.triggered.connect (function () {alert ("called");}); //
registra manejador simple

registerAsBackgroundScript ("prueba"); // mantener el

controlador válido

 Diálogo asincrónico:
 %GUIÓN
 var ui = createUI ("... ruta a su archivo ui ..."); // cuadro de
diálogo de carga
 ui.accepted.connect (function () {alert ("x");}) // reacciona al
cierre del cuadro de diálogo
 registerAsBackgroundScript ("abc"); // mantener la función
válida

ui.show (); // mostrar el diálogo

El diálogo se describe en un archivo ui que se puede crear con el Qt Designer.

Más ejemplos se pueden encontrar en Wiki .

4.5.4 Disparadores

4.5.4.1 Expresiones regulares

En su forma más simple, el disparador es simplemente un texto, que es reemplazado por la

macro. Ej trigger = "eg" macro = "example given", "eg" en "the leg" se reemplaza presionando "g"
por "example given"
Como el trigger es una expresión regular, se pueden crear activadores más elaborados. TXS hace
uso de la búsqueda por detrás: "(? <= \ S)%" se usa para reemplazar un "%" si el carácter anterior
es un espacio. Se puede encontrar más ayuda sobre expresiones regulares en Internet.

Puede acceder a la expresión coincidente en el script a través de la variable

global triggerMatches. triggerMatcheses una matriz. Su componente cero es la
coincidencia con la expresión regular completa. Los siguientes elementos son coincidentes con
los grupos (si los grupos están definidos).

Ejemplo:

Disparador: # ([az])
Texto escrito: #a
triggerMatches [0] == '#a'
triggerMatches [1] == 'a'

Nota: los disparadores están inactivos mientras el completo está activo. Por ejemplo, no puede
activarse \\secsi el completer está abierto sugiriendo completar \section.
4.5.4.2 Limitación del alcance

Para el alcance en el que se activará una macro, puede anteponer una expresión del
patrón (?[scope-type]:...).

Ámbito que limita

Sentido
la expresión
La macro solo está activa si el resaltado del documento
(?language:...) coincide con el idioma especificado.
Ejemplo:(?language:latex)
Restrinja la macro a ciertos entornos resaltados. Los
valores posibles corresponden a la lista en la página de
(?highlighted-
as:...) configuración de resaltado de sintaxis.
Ejemplo:(?highlighted-as:numbers,math-
delimiter,math-keyword)
(?not-highlighted- Similar a (?highlighted-as:...), pero la macro está
as:...) desactivada en los entornos especificados.

Puedes combinar (?language:...)y (?highlighted-as:...)expresiones. Sin embargo,

peinar (?highlighted-as:...)y (?not-highlighted-as:...)no tiene sentido
lógicamente y tiene un comportamiento indefinido.

Tenga en cuenta que todavía necesita la expresión regular del disparador. He aquí un ejemplo
complejo completo: (?language:latex)(?highlighted-
as:comment,commentTodo)FIXME. Este desencadenador responde al tipeo "FIXME", pero solo
en comentarios y notas pendientes de documentos de látex.

4.5.4.3 Desencadenantes de eventos

Además, los siguientes términos de activación especiales (sin paréntesis) se pueden utilizar para
ejecutar el script cuando se produce el evento correspondiente:

Disparador
Ejecutado en el evento
especial
? txs-start TeXstudio se inició.
?archivo
Se crea un nuevo archivo
nuevo
?Nuevo desde
Se crea un nuevo archivo a partir de una plantilla
plantilla
?cargar
Se carga un archivo
archivo
El archivo que contiene la macro está cargado (solo tiene
? load-this-file
sentido, si el script se define como comentario mágico )
?guardar el
Se guarda un archivo
archivo
 ?cerrar el
Un archivo está cerrado
archivo
? maestro-
Un documento no está definido como documento maestro
cambiado
? after-typeset Un comando de látex ha terminado
La ejecución de un comando ha finalizado (por ejemplo, un
? after- comando de compilación que llama a latex dos veces y abre el
command-run visor, activará este evento una vez, pero después de compuso dos
veces)

Múltiples de estos factores desencadenantes especiales se pueden combinar por | símbolos.

4.6 Soporte de Pstricks

Los comandos pstricks principales se pueden insertar con el panel "Pstricks" en la "Vista de
estructura".

4.7 Soporte de Metapost

Las palabras clave de metapost se pueden insertar con el panel "Metapost" en la "Vista de
estructura" y el comando "mpost" se puede iniciar a través del menú "Herramientas".

4.8 El comando "Convertir a Html"

Este comando (del menú "Herramientas") produce un conjunto de páginas html de un archivo
fuente LaTeX con una imagen para cada página html. Cada página en la presentación de
diapositivas corresponde a una de las páginas de postscript que obtendría ejecutando LaTeX.
El comando también produce una página de índice correspondiente a la tabla de contenido que
obtendría con LaTeX. Cada elemento de la página de índice incluye un enlace a la página html
correspondiente.

Puede crear enlaces en las páginas html utilizando el comando \ ttwplink {} {} en el archivo tex.
Sinopsis:
\ ttwplink {http://www.mylink.com} {my text} (enlace externo)
\ ttwplink {page3.html} {mi texto} (enlace interno)
\ ttwplink {name_of_a_label} {mi texto} (enlace interno )
Advertencia: no puede usar este comando con el paquete hyperref (y algunos otros
paquetes). Este comando solo se puede usar con la herramienta "Convertir a html".
4.9 "Búsqueda adelante / atrás" con TeXstudio

Visor de pdf integrado

TeXstudio proporciona un visor de pdf integrado que ofrece búsqueda directa e

inversa. Asegúrese de que synctex esté activado en el comando pdflatex (se debe agregar la
opción -synctex = 1), aunque TeXstudio le preguntará si puede corregir el comando si no está
configurado correctamente.
La búsqueda directa se realiza automáticamente cada vez que se abre el visor de PDF. TeXstudio
saltará a la posición en la que se encuentra el cursor actualmente. Además, puede presionar
CTRL + clic izquierdo en una palabra en el editor de texto para saltar al pdf o usar el menú
contextual y seleccionar "Ir a PDF".
Inverse se puede activar haciendo clic en el pdf con CTRL + botón izquierdo del mouse o
seleccionando "saltar a la fuente" en el menú contextual, que se activa con un clic derecho del
mouse. Además, es posible habilitar "Desplazamiento siguiendo al cursor" en pdf-viewer /
configure. Esto mantendrá la posición del visor de PDF sincronizada con la oposición del cursor
 en el editor. Del mismo modo, "Cursor sigue en desplazamiento" mantiene la posición del editor
sincrónica en la posición del visualizador de PDF.

Configuración general para espectadores externos

Algunos (dvi) visores pueden saltar (y destacar visualmente) una posición en el archivo DVI que
corresponde a un cierto número de línea en el archivo fuente (de La) TeX.
Para habilitar esta búsqueda directa, puede ingresar la línea de comando del visor
correspondiente como línea de comando para una herramienta de usuario en el menú Usuario
(Comandos de usuario / usuario / Editar ...) o en la línea de comando del visor en el cuadro de
diálogo de configuración ( "Opciones / Configurar TeXstudio" -> "Comandos"). Cuando se lanza el
visor, el @ -placeholder será reemplazado por el número de línea actual y ? C: ame por el
nombre de archivo absoluto completo del archivo actual.

En Windows, puede ejecutar comandos DDE insertando un comando de la forma: dde: ///
service / control / [commands ...] o (desde TeXstudio 1.9.9) también dde: ///
programpath: service / control / [commands ...] para iniciar el programa si es
necesario.

A continuación puede encontrar una lista de comandos para algunos lectores comunes. Por
supuesto, debe reemplazar (la ruta de su programa) con la ruta del programa en su
computadora, si desea usar un comando.

Sumatra

Inicie Sumatra desde TeXstudio y configure Sumatra para la búsqueda inversa: " (su ruta
sumatra) " -reusar-instancia-búsqueda-inversa "\" (su ruta TeXstudio) \
"\" %% f \ "-line %% l" " ? am.pdf "

Saltar a una línea en un Sumatra en ejecución (solo Windows): dde: /// SUMATRA /
control / [ForwardSearch ("? am.pdf ","? c: am.tex ", @, 0, 0,1)]

Ejecute Sumatra si no se está ejecutando y salte a una línea en él (solo Windows): dde:
/// (su ruta de Sumatra) : SUMATRA / control / [ForwardSearch ("?
Am.pdf", " ? c: am.tex ", @, 0,0,1)]

Ejecute TeXstudio desde Sumatra: " (su ruta de TeXstudio) ""% f "

-line% l Un posible valor para (su ruta de Sumatra) es C: / Archivos de programa /

SumatraPDF / SumatraPDF.exe

Foxit Reader

Inicie Foxit Reader desde TeXstudio: " (su ruta de Reader)" "? Am.pdf"

Acrobat Reader
 Inicie Acrobat Reader desde TeXstudio: " (su ruta de acceso de Reader)" "?
Am.pdf" La

navegación y el cierre se realizan a través de comandos DDE. Desde la versión 10 de los

productos de Adobe, el nombre del servicio DDE contiene una letra para el Producto y el número
de versión.

Producto Nombre del Servicio

Adobe Reader 9 acroview
Adobe Acrobat 9 acroview
Adobe Reader 10 acroviewR10
Adobe Acrobat 10 acroviewA10
Adobe Reader 11 acroviewR11
Adobe Acrobat 11 acroviewA11
Adobe Reader DC acroviewR15
Adobe Acrobat DC acroviewA15

El siguiente ejemplo es para Adobe Reader DC:

salta a una posición en un Adobe Reader en ejecución (solo Windows): dde: ///
acroviewR15 / control / [DocOpen ("? Am.pdf")] [FileOpen ("? Am. pdf ")]
[DocGotoNameDest ("? am.pdf "," jump-position ")] jump-position se puede
definir con el paquete hyperref
Si tiene el problema que Adobe Reader no abre, debe agregar la ruta del programa de esta
manera: dde: /// "C: \ Archivos de programa (x86) \ Adobe \ Acrobat
Reader DC \ Reader \ AcroRd32.exe": acroviewR15 / control / [DocOpen ("?
am.pdf")] [FileOpen (" ? am.pdf ")] [DocGotoNameDest ("? am.pdf ","
jump-position ")]

Cierre el documento en un Adobe Reader en ejecución (solo Windows): dde: ///

acroviewR15 / control / [DocOpen (" ? am.pdf ")] [FileOpen ("? Am.pdf")]
[DocClose ("? Am.pdf")]

Nota: Dado que Adobe Reader bloquea la escritura en archivos PDF que están abiertos en Reader,
debe cerrar el PDF antes de volver a compilar. Puede definir un Comando de usuario para el
comando DDE anterior y llamarlo al principio de su cadena de compilación. Esto garantiza que el
archivo se cerrará y, por lo tanto, se puede escribir durante la compilación.

Yap (Sin embargo, otra vista previa)

Inicie Yap desde TeXstudio: " (su ruta Yap) " -1 -s @? C: m.tex% .dvi

Inicie TeXstudio desde Yap: " (su ruta TeXstudio) " "% f" -line% l

Un posible valor para (su ruta Yap) es C: \ Archivos de programa \ MiKTeX 2.7 \
miktex \ bin \ yap.exe
xdvi

Inicie xdvi desde TeXstudio: xdvi% .dvi -sourceposition @ :? c: m.tex

Inicie xdvi desde TeXstudio y habilite la búsqueda inversa: xdvi -editor "texstudio% f -
line"% .dvi -sourceposition @:%. Tex

kdvi

Ejecute kdvi desde TeXstudio: kdvi "archivo:% .dvi # src: @? C: m.tex"

Okular

Inicie okular desde TeXstudio: okular --unique% .dvi # src: @? C: m.tex

Ejecute TeXstudio desde Okular: texstudio% f -line% l

Desnatar

Inicie Skim desde TeXstudio: (su ruta Skim) / Contents / SharedSupport /

displayline @? Am.pdf? C: ame

Ejecute TeXstudio desde skim:

Comando: /applications/texstudio.app/contents/macos/texstudio con
argumentos: "% file "-line% line

Un valor posible para (su ruta de Skim) es /Applications/Skim.app

qpdfview

Inicie qpdfview desde TeXstudio: qpdfview --unique? Am.pdf # src:? C: am.tex: @:

0 2> / dev / null

Ejecute TeXstudio desde qpdfview: texstudio "% 1" -line% 2

4.10 Uso avanzado del encabezado

Los llamados "comentarios mágicos" son una forma de adaptar las opciones del editor a nivel de
documento. El concepto se introdujo originalmente en TeXshop y desde entonces se ha adoptado
en varios editores. TeXstudio admite los siguientes comentarios mágicos:

 % !TeX spellcheck = de_DE

 Define el lenguaje utilizado para la corrección ortográfica del documento. Esto anula la
configuración global de corrección ortográfica. Sin embargo, se debe instalar un
diccionario apropiado.

 % !TeX encoding = utf8

Define la codificación de caracteres de un documento.

 % !TeX root = filename

Define el documento raíz para este archivo (es decir, el archivo que se pasará al
compilador LaTeX al compilar). Esta configuración anula la detección de raíz automática
en TeXstudio. A su vez, se reemplaza si se establece un documento raíz
explicto en Options -> Root Document.

 % !TeX program = pdflatex

Define el compilador que se utilizará para el documento. Para ser precisos, anula el
compilador predeterminado (comando txs:///compile) que se utiliza en las acciones
"Crear y ver", así como "Compilar".

 % !TeX TXS-program:bibliography = txs:///biber

Esta es una configuración específica de TeXstudio. Anula el comando del sistema de

compilación especificado a la izquierda por el de la derecha. En el ejemplo, le decimos
a TXS que use el comando biber ( txs:///biber) para el general "Comando de
bibliografía (txs: /// bibliografía). Consulte también la descripción del sistema de
compilación .

 % !TeX TXS-SCRIPT = foobar

% //Trigger = ?load-this-file
% app.load("/tmp/test/test.tex");
% app.load("/tmp/test/a.tex");
% TXS-SCRIPT-END

Esto define una macro javascript temporal que se ejecuta, cuando se carga el archivo, y
que a su vez carga los dos archivos en / tmp / test. .

Las macros definidas a través de TXS-SCRIPT están activas en todos los archivos de un
documento (por ejemplo, archivos incluidos). No puedes ejecutarlos manualmente. Se
ejecutan mediante el activador (expresión regular o activador especial, consulte la
sección sobre activadores). La macro solo se lee una vez, cuando se abre el archivo. Los
cambios durante una sesión de edición solo tendrán efecto cuando vuelva a abrir el
archivo.

 % !BIB program = biber

El % !BIB programcomando especial se entiende por compatibilidad con TeXShop y

TeXWorks (también en la variante % !BIB TS-program). Esto es equivalente a% !TeX
TXS-program:bibliography = txs:///biber

4.11 Sinopsis del comando TeXstudio

 texstudio file [--config DIR] [--root] [--line xx[:cc]] [--insert-cite
citation] [--start-always] [--pdf-viewer-only] [--page yy] [--no-session]

--config
DIR usa el directorio de configuraciones especificado.
--ini-file
FILE obsoleto : use --configen su lugar.

--root
define el documento como documento raíz explícito (anteriormente
llamado documento maestro ).
--master obsoleto : use --rooten su lugar.
--line coloque el cursor en la línea LINE y en la columna COL, por
xx[:cc] ejemplo, "--line 2: 5" saltará a la columna 5 en la línea 2.
presiona una tecla bibtex para TeXstudio, que se insertará en la
posición del cursor. Esto está pensado como una interfaz para que
los gerentes de bibliografía externa envíen citas a TeXstudio. Puede
--insert- pasar un comando (también personalizado) como \ mycite {key} o
cite solo la clave. En este último caso, se expande a \ cite
citation {key}. También se admiten listas de claves separadas por
comas. TeXstudio reconoce, si el cursor ya está dentro de una
macro de citas. Si es así, solo la clave se inserta en una posición
apropiada; de lo contrario, se inserta el comando de cita completa.
--start- iniciar una nueva instancia, incluso si TXS ya se está
always ejecutando. Esto permite el uso de instancias múltiples.
--pdf-
viewer- funcionar como un visor de pdf independiente sin un editor
only
--page mostrar una determinada página en el visor de PDF
--no-
session no cargue / guarde la sesión al inicio / cierre

Opciones adicionales solo disponibles en versiones de depuración de texstudio:

--disable-tests Evite ejecutar cualquier prueba.

--execute-tests Fuerza ejecutando las pruebas más comunes.
--execute-all-tests Fuerza ejecutando todas las pruebas.

Nota: las pruebas más comunes se ejecutan automáticamente, si hubo cambios en el ejecutable
(es decir, se ha compilado TXS desde la última ejecución). Además, todas las pruebas se
ejecutan una vez a la semana.

4.12 Atajos de teclado

Los atajos de teclado se pueden modificar en Opciones -> Accesos directos.

La siguiente lista es una descripción general de los atajos de teclado

predeterminados. Dependiendo del sistema operativo, puede haber algunas desviaciones para
adaptarse a las convenciones de acceso directo específicas del sistema operativo.
 "Menú Archivo :
o Nuevo: Ctrl + N
o Abierto: Ctrl + O
o Guardar: Ctrl + S
o Guardar como: Ctrl + Alt + S
o Guardar todo: Ctrl + Shift + Alt + S
o Cerrar: Ctrl + W
o Imprimir código fuente: Ctrl + P
o Salir: Ctrl + Q
 "Menú de edición :
o Deshacer: Ctrl + Z
o Rehacer: Ctrl + Y
o Copiar: Ctrl + C
o Cortar: Ctrl + X
o Pegar: Ctrl + V
o Seleccionar todo: Ctrl + A
o Expandir selección a Word: Ctrl + D
o Expandir selección a línea: Ctrl + L
o Eliminar línea: Ctrl + K
o Eliminar hasta el final de la línea: Alt + K
o Buscar: Ctrl + F
o Buscar siguiente: F3 / Ctrl + G
o Buscar prev: Shift + F3 / Ctrl + Shift + G
o Reemplazar: CTrl + R
o Ir a línea: Ctrl + G
o Ir al cambio anterior: Ctrl + H
o Ir al siguiente cambio: Ctrl + Shift + H
o Vaya a Bookmark 0..9: Ctrl + 0..9
o Establecer marcador 0..9: Ctrl + Shift + 0..9
o Establecer marcador sin nombre: Ctrl + Shift + B
o Siguiente marcador: Ctrl + Abajo
o Marcador anterior: Ctrl + Arriba
o Regresar: Alt + Izquierda
o Adelante: Alt + Derecha
o Insertar carácter Unicode: Ctrl + Alt + U
 Menú "Idefix":
o Borrar palabra / Cmd / Env: Alt + Supr
o Pegar como LaTeX: Ctrl + Shift + V
o Mostrar vista previa: Alt + P
o Comentario: Ctrl + T
o Descomentar: Ctrl + U
o Siguiente error de látex: Ctrl + Shift + Abajo
o Error anterior de látex: Ctrl + Shift + Arriba
o Next Latex Bad Box: Mayús + Alt + Abajo
o Cuadro anterior de látex defectuoso: Mayús + Alt + Arriba
o Ir a la definición: Ctrl + Alt + F
o Finalización normal: Ctrl + espacio
o \ begin Terminación: Ctrl + Alt + Space
o Terminación de texto normal: Alt + Shift + Espacio
o Cerrar el último entorno abierto: Alt + Retorno
o Eliminar marcadores de posición: Ctrl + Shift + K
 "Menú de herramientas :
o Construir y ver: F5
o Compilar: F6
o Vista: F7
o Bibliografía: F8
o Glosario: F9
o Verificar ortografía: Ctrl +:
 o Tesauro: Ctrl + Shift + F8
 Menú "LaTeX":
o item: Ctrl + Shift + I
o Cursiva: Ctrl + I
o Inclinado: Ctrl + Shift + S
o Negrita: Ctrl + B
o Máquina de escribir: Ctrl + Shift + T
o Pequeñas mayúsculas: Ctrl + Shift + C
o Énfasis: Ctrl + Shift + E
o Nueva línea: Ctrl + Retorno
o begin {environment}: Ctrl + E
o Insertar referencia a la siguiente etiqueta: Ctrl + Alt + R
 Menú "Matemáticas":
o Modo matemático en línea: Ctrl + Shift + M
o Mostrar el modo matemático: Alt + Shift + M
o Ecuaciones numeradas: Ctrl + Shift + N
o Subíndice: Ctrl + Shift + D
o Superíndice: CTrl + Shift + U
o Frac: Alt + Shift + F
o Dfrac: Ctrl + Shift + F
o Sqrt: Ctrl + Shift + Q
o Izquierda: Ctrl + Shift + L
o Derecha: Ctrl + Shift + R
 "Menú del Usuario :
o Etiquetas de usuario: Shift + F1 ... Shift + F10
o Comandos de usuario: Shift + Alt + F1 ... Shift + Alt + F10
 "Ver menú :
o Documento anterior: Ctrl + PgDown
o Documento siguiente: Ctrl + RePág
o Editor de foco: Ctrl + Alt + Izquierda
o Visor de enfoque: Ctrl + Alt + derecha
o Cerrar algo: Esc
o Editor de acercamiento: Ctrl ++
o Editor Alejar: Ctrl + -
o Modo Fullscreeen: F11

4.13 Descripción del formato cwl

cwl significa lista de palabras de finalización y es un formato de archivo utilizado originalmente

en Kile para definir los comandos enumerados en el finalizador. TeXstudio usa un formato
extendido de cwls para incluir información semántica adicional y permitir la ubicación del cursor
y marcador de posición. Los usa para los siguientes propósitos:

 Poblando el autocompletado
 Conocimiento sobre los comandos válidos en el documento actual (según \ usepackage
statements)
 Información semántica que proporciona un contexto adicional en el editor; por ejemplo, un
comando \ ref-like verificará la existencia de la etiqueta a la que se hace referencia

4.13.1 formato de archivo cwl

Cada línea de un archivo cwl define un comando. Las líneas de comentarios son posibles y
comienzan con #. La sintaxis del comando es
 <command>[#classification]

Si no se proporciona ninguna clasificación, el comando se considera válido en cualquier posición

en un documento LaTeX. El char #no se puede usar dentro de a command, ya que tiene un
significado especial:

 #include:<packagename>(al inicio de la línea): también carga packagename.cwl. Esto

debería usarse para indicar que un paquete depende de otros paquetes.
 #repl:<search> <replacement> (al inicio de la línea): defina una sustitución de letra,
por ejemplo, "a -> ä para alemán. Solo se usa para reemplazar letras en la revisión ortográfica
(babel)
 #keyvals:<command>(al inicio de la línea): comienza la definición de keyvals
para command, mira graphicx.cwl en el código fuente. Para especificar valores posibles para
las claves, agréguelos después de # eg. mode=#text,math
En lugar de claves / valores únicos, se pueden proporcionar listas especiales completas, por
ejemplo color=#%color, ver también tikz.cwl.
commandpuede constar de dos partes, por ejemplo, \ documentclass / tesis, que solo es válida
cuando el comando \ documentclass utiliza la tesis como argumento.
Si se agrega #c, los valores de clave solo se usan para completar, no para verificar la sintaxis
 #endkeyvals (al inicio de la línea): definición final de los keyvals, vea graphicx.cwl en el
código fuente
 #ifOption:<option> (al inicio de la línea): el siguiente bloque solo se carga si se utilizó
<option> en el comando usepackage, por ejemplo \ usepackage [svgnames] {color} -> option =
svgnames
 #endif (al inicio de la línea): fin del bloque condicional
 #(al inicio de la línea con la excepción de #include,#repl,#keyvals or
#endkeyvals ): esta línea es un comentario y será ignorada.
 # (en el medio de una línea): separa el comando de la clasificación

Los archivos cwl deben codificarse como UTF-8.

4.13.2 Formato de comando

En su forma más simple, el comando es solo una expresión válida de LaTeX como la encontrará
en la documentación, por ejemplo \section{title}. Por defecto, cada opción se trata como
un marcador de posición. Alternativamente, puede simplemente definir una posición de parada
para el cursor por %|(Ejemplo:) \left(%|\right)o usar %< %>para marcar solo parte de una
opción como marcador de posición (Ejemplo:) \includegraphics[scale=%<1%>]{file}. Se
pueden incluir nuevas líneas en un comando de %\.

Nombres de argumento

Los nombres de los argumentos son visibles en la ventana de completación y después de

completarse como marcadores de posición en el editor. En general, puede nombrar los
argumentos como desee. Nos comprometemos a proporcionar nombres significativos, por
ejemplo, en \parbox[position]{width}{text}lugar de \parbox[arg1]{arg2}{arg3}.

Hay algunos nombres de argumento que tienen un significado especial:

 texto termina con %text: el corrector ortográfico funcionará dentro de este argumento (por
defecto, los argumentos no están corregidos ortográficamente).
  titleo short title: el corrector ortográfico funcionará dentro de este argumento (por
defecto, los argumentos no están corregidos ortográficamente). Además, el argumento se
establecerá en negrita (como en la sección)
 bibidy keylists: si se usa en un comando clasificado como "C". Vea la descripción del
clasificador a continuación.
 cmdy commando termina con %cmd: definición de comando, por ejemplo \ newcommand
{cmd}. Este "cmd" se considerará que no tiene argumentos y no transmite ninguna
funcionalidad.
 defy definition: definición real para comando, por ejemplo, \ newcommand {cmd}
{definition}. Esta "definición" se ignorará para la comprobación de sintaxis.
 args: número de argumentos para el comando, por ejemplo, \ newcommand {cmd} [args]
{definition}.
 package: nombre del paquete, por ejemplo \ usepackage {package}
 citekey: definición de un nuevo nombre de clave de cita, por ejemplo \ bibitem {citekey}
 titley short title: nombre de la sección, por ej. \ section {title}
 color: nombre del color, p. ej. \ textcolor {color}
 width, length, heightO termina con %l: anchura o la opción de longitud por ejemplo, \
abc {tamaño% l}
 colsy preamble: definición de columnas en tablas, etc. , por ejemplo, \ begin {tabular}
{cols}
 file:nombre del archivo
 URL: URL
 options: opciones de paquete, por ejemplo \ usepackage [opciones]
 imagefile: nombre de archivo de una imagen
 termina con %todo: El argumento se resalta como todo. Nota: Para agregar el elemento a la
lista de tareas pendientes en el panel de estructura, debe agregar adicionalmente el
clasificador D. Ver todonotes.cwl para ver un ejemplo.
 key: etiqueta / clave de referencia
 labelcon opción #ro tecla que termina con %ref: tecla de la tecla
 labelcon opción #lo tecla que termina con %labeldef: define una etiqueta
 labellist: lista de etiquetas empleadas por cleveref
 bib filey bib files: archivo de bibliografía
 class: clase de documento
 placementy position: posición de env
 %plain: las opciones que terminan con %plainse interpretan para no tener ningún
significado especial. De esta forma, puede definir, por ejemplo, label%plaintener un
marcador de posición labelsin la semántica que define una etiqueta.
 beamertheme: tema de beamer, p. ej. \ usebeamertheme {beamertheme}
 keys, keyvalsy %<options%>: clave / lista de valores
 envname: nombre del entorno para \ newtheorem, por ejemplo \ newtheorem {envname} #N
(la clasificación N debe estar presente!)

Un% -suffix tiene prioridad sobre la detección por nombre, es decir, un argumento file%textse
tratará como texto no como archivo.

4.13.3 Formato de clasificación

Las siguientes clasificaciones son conocidas por TXS:

Clasificador Sentido
 comando inusual que se utiliza para completar solo con la
* pestaña "todos". Este marcador puede ser seguido por otras
clasificaciones.
no mostrar en absoluto en absoluto. Este marcador puede ser
S
seguido por otras clasificaciones.
metro válido solo en el entorno de matemáticas
t válido solo en el entorno tabular (o similar)
T válido solo en el entorno de tabulación
válido solo en el entorno de texto (es decir, no en env de
norte
matemáticas)
r este comando declara una referencia como "\ ref {key}"
do este comando declara una cita como "\ cite {key}"
este comando declara una cita compleja como "\ textcquote
do
{bibid} {text}". La clave debe darse comobibid
l este comando declara una etiqueta como "\ label {key}"
este comando declara un comando de definición como "\
re
newcommand {cmd} {def}"
este comando declara un comando include graphics como "\
gramo
includegraphics {file}"
este comando declara un comando de archivo de inclusión
yo
como "\ include {file}"
este comando declara un paquete usado como "\ usepackage
tu
{package}"
este comando declara una bibliografía como "\ bibliography
segundo
{bib}"
este comando declara un comando url como "\ url {URL},
U
donde URL no está marcada"
este comando declara un ítem todo (se agregará a la lista de
tareas pendientes en el panel lateral). Nota: Para resaltar el
re
elemento en el editor, debe agregar adicionalmente el
sufijo %todo. Ver todonotes.cwl para ver un ejemplo.
este comando declara un color (se usará solo para completar
segundo
el color, sin verificación de sintaxis)
este comando declara una definición especial, la clase de
definición se da después de un "#". El nombre de clase
s
necesita un% anterior. (por ejemplo,% de color), también vea
los ejemplos a continuación.
este comando declara un entorno tipo literal "\ begin
V
{Verbatim}"
este comando declara un nuevo comando tipo teorema como
norte
"\ newtheorem {envname}"
 este comando declara un comando de estructura. El nivel está
entre L0 ( \part-like) hasta L5 ( \subparagraph-like). Los
L0 a L5
comandos de estructura se destacan en el código, se pueden
plegar y aparecer en el contorno de la estructura.
/ env1,
válido solo en el entorno env1 o env2 etc.
env2, ...
alias de entorno, significa que el entorno se maneja como el
\ env
entorno "env". Esto es útil para env = math o tabular.

Los clasificadores que especifican el significado de los argumentos (como c o i) siempre se

aplican al primer parámetro no opcional. Esta es una limitación actual del formato cwl y del
analizador LaTeX en TXS. Por ejemplo \ref{label}#r,
y \ref[option]{label}#rfuncionará como se espera,
pero \ref{arg}{label}#rinterpretará argcomo referencia. Recomendamos no especificar
ninguna clase en tal caso.

Ejemplos:

Línea Explicación
# test comentario
comando inusual que solo se
\typein{msg}#* muestra en la terminación
"todo"
\sqrt{arg}#m solo en modo matemático válido
declara un comando de
\pageref{key}#r referencia que se usa
correctamente para completar
comando inusual que solo es
\vector(xslope,yslope){length}#*/picture válido en el entorno de la
imagen
declara que el entorno "align" se
maneja como un env de math,
\begin{align}#\math con respecto a la validez del
comando y el resaltado de la
sintaxis.
\definecolor{name}{model}{color- se agrega namea la lista
spec}#s#%color especial%color

4.13.4 pautas de la CEI

Aunque TeXstudio puede crear automáticamente cwls desde paquetes, estos cwls autogenerados
no contienen nombres de argumentos significativos ni clasificación de comandos. Por lo tanto,
enviamos cheques sintonizados a mano para muchos paquetes. Alentamos a los usuarios a
contribuir con nuevos archivos cwl. Estos deberían tener los siguientes atributos:
  basado en paquetes: cada cwl debe corresponder a un paquete. La excepción son algunos
cwls que contienen comandos fundamentales (La) TeX, pero ya los hemos escrito, así que no
debería tener que molestarse. El cwl debe nombrarse como el paquete para que funcione la
carga automática. Si tu\usepackage{mypackage} TeXstudio cargará mypackage.cwl si está
disponible.
 completo: El comando cwl debe contener todos los comandos en el paquete. Si usa un
comando no especificado en el editor, syntaxchecker lo marcará como desconocido.
 específico: los comandos deben clasificarse si es posible. Esto permite a TeXstudio dar un
contexto adicional al comando (por ejemplo, advertir si se usa un comando matemático fuera
de un entorno matemático o verificar referencias y citas).
 priorizado: algunos paquetes pueden especificar muchos comandos. Marque los inusuales por
el * -classifier para evitar que el que completa el hacinamiento con comandos poco utilizados.

4.13.4 colocación de archivos cwl

Los archivos cwl se pueden proporcionar desde tres ubicaciones. Si está presente, se toma el usuario
proporcionado cwl, si no se toman las versiones incorporadas. Como último recurso, txs genera
automáticamente ciclos de estilos de látex, aunque estos solo sirven para proporcionar información de
sintaxis. La información de contexto para los argumentos no está disponible y no se dan sugerencias de
finalización.

 % appdata% \ texstudio \ completion \ user o .config / texstudio / completion / usuario

generado por el usuario cwls
 incorporado
 % appdata% \ texstudio \ completion \ autogenerated o .config / texstudio / completion /
autogenerated auto-generated cwls

4.14 Uso de plantillas de tabla

Texstudio ofrece la posibilidad de reformatear una tabla de látex existente después de una
plantilla de tabla.
Por ejemplo, ha ingresado la siguiente tabla en txs:

\ begin {tabular} {ll}

a & b \\
discos compactos\\
\ end {tabular}

Coloque el cursor dentro de la tabla y seleccione el menú "Latex / Manipulate Tables / Remodel
Table Using Template".
Ahora puede seleccionar una plantilla que defina el formateo de la tabla. Numerosas plantillas
están predefinidas por txs:

 fullyframed_firstBold
 fullyframed_longtable
 plain_tabular
 plain_tabularx
 rowcolors_tabular

Al seleccionar la primera entrada, la tabla se reformatea a:

 \ begin {tabular} {| l | l |}
\ hline
\ textbf {a} & \ textbf {b} \\ \ hline
c & d \\ \ hline
\ end {tabular}

Estas plantillas ofrecen la oportunidad de volver a formatear fácilmente las tablas después de
una moda predefinida, logrando así un estilo de tabla uniforme en un documento, incluso si las
tablas se ingresan en un estilo muy simple.

4.14.1 Creación de plantillas de tabla

Las plantillas también pueden ser definidas por el usuario. Tienen que ser el lugar en el
directorio de configuración (Linux: ~ / .config / texstudio) y necesitan lleva el nombre del
esquema de tabletemplate_ nombre Js.

Los metadatos se utilizan para proporcionar información adicional para la plantilla. Se puede
almacenar en un metaDataobjeto en el código fuente. El código var metaData = {tiene que
comenzar en la primera línea del archivo. Actualmente solo se aceptan valores de cadena. Es
posible usar etiquetas html para formatear. Ejemplo:

var metaData = {
"Nombre": "filas de colores",
"Descripción": "Formatea la tabla usando colores alternativos para
filas. <br> <code> \ usepackage [table] {xcolor} </ code> es
necesario.",
"Autor": "Jan Sundermeyer",
"Fecha": "4.9.2011",
"Versión": "1.0"
}

La plantilla en sí es un javascript (ver arriba) con algunas variables prefinadas que contienen
toda la tabla. La nueva tabla solo se coloca como reemplazo de la anterior, utilizando
información de esas variables. 3 variables son dadas:

 def la definición de tabla simplificada sin ningún formato (es decir, ll en lugar de | l | l |)
 defSplit la definición de tabla dividida por columna (array = l, l, p {2cm})
 Env el nombre del entorno actual de la tabla anterior como "tabular" o "tabla larga"
 tab la tabla actual. Es una lista de líneas, cada línea es una lista de columnas que contiene el
contenido de la celda como cadena

Para ver el principio de trabajo, aquí se proporciona la fuente de la plantilla "plain_tabular".

función print (str) {// define esta función para hacer que la fuente
sea más legible
cursor.insertText (str)
}
function println (str) {// define esta función para hacer que la fuente
sea más legible
 cursor.insertText (str + "\ n")
}
var arDef = def.split ("") // divide la definición de la tabla (ll ->
'l' 'l')
println ("\\ begin {tabular} {" + arDef.join ("") + "}") print table
env
for (var i = 0; i <tab.length; i ++) {// recorre todas las filas de la
tabla
var line = tab [i]; // line es una lista de todas las columnas de la
fila [i]
for (var j = 0; j <line.length; j ++) {// itera por todas las
columnas de una fila
print (línea [j]) // imprimir celda
if (j <line.length-1) // si no las últimas columnas
print ("&") // imprimir y
}
println ("\\\\") // cerrar fila con \\, tenga en cuenta que js exige
barras diagonales inversas en la cadena
}
println ("\\ end {tabular}") // entorno cercano

Como se puede ver en el ejemplo, la tabla debe reconstruirse por completo, lo que permite un
nuevo formato. Un segundo ejemplo da una tabla un poco más elaborada (fullyframed_firstBold):

función print (str) {

cursor.insertText (str)
}
función println (str) {
cursor.insertText (str + "\ n")
}
if (env == "tabularx") {
println ("\\ begin {tabularx} {\\ linewidth} {|" + defSplit.join
("|") + "|}")
}más{
println ("\\ begin {" + env + "} {|" + defSplit.join ("|") + "|}")
}
println ("\\ hline")
para (var i = 0; i <tab.length; i ++) {
var line = tab [i];
for (var j = 0; j <line.length; j ++) {
var col = línea [j];
var mt = col.match (/ ^ \\ textbf /);
if (i == 0 &&! mt)
print ("\\ textbf {")
imprimir (línea [j])
if (i == 0 &&! mt)
impresión("}")
if (j <line.length-1)
impresión("&")
}
println ("\\\\\\ hline")
}
println ("\\ end {" + env + "}")

5. Características provisionales
 Estas características le permiten modificar los aspectos centrales de TeXstudio y, por lo tanto,
ofrecen una gran flexibilidad para adaptar TeXstudio a sus necesidades. Dado que estas
características son complejas o están estrechamente ligadas a las partes internas, no podemos
garantizar la funcionalidad en todos los casos y para siempre. Por una vez, no tenemos
suficientes recursos para brindar soporte completo. Además, la dependencia de los internos
concuerda con nuestra necesidad de cambiar libremente las partes internas sin restricciones para
el desarrollo futuro.

Sin embargo, decidimos que estas características pueden ser de interés para los usuarios
experimentados. Como compromiso, proporcionamos estas características tentativamente.

No garantizamos que esto siga funcionando en futuras versiones. La funcionalidad puede

cambiar o eliminarse sin previo aviso.

5.1 Skripting avanzado

Puede modificar el comportamiento o agregar nuevas funcionalidades usando Javascript

Macros . La sección anterior enumera los comandos principales, pero hay más comandos que no
están documentados. Varios de ellos se usan en la sección de ejemplos en la wiki . Los nombres y
firmas de estas funciones están directamente vinculados al código interno de C ++ de TeXstudio
y, por lo tanto, pueden cambiar a medida que desarrollamos TeXstudio.

5.2 Hojas de estilo

Qt admite la modificación de la apariencia de una aplicación que utiliza hojas de estilo . Puede
usar esto para adaptar la GUI de la ventana principal colocando un archivo stylesheet.qssen
el directorio de configuraciones. El archivo se lee al inicio del programa.

Tenga en cuenta que la hoja de estilo puede interferir con otras formas de configuración de la
GUI, en particular, el esquema de colores de estilo y otras opciones. Por lo tanto, no
garantizamos un comportamiento consistente al usar hojas de estilo

5.3 Escribir sus propias definiciones de idioma

TeXstudio usa QCodeEdit como componente editor. Especifica idiomas en un formato especial de
XML denominado QNFA. Esto incluye resaltar, paréntesis (para emparejar) y doblar el código. En
una instalación normal de TeXstudio no encontrará ningún archivo .qnfa, porque compilamos los
archivos de los idiomas incluidos en el binario. Puede agregar sus propios idiomas o sobrescribir
los predeterminados colocando los archivos .qnfa apropiados en una languagescarpeta dentro
del directorio de configuraciones. Las definiciones aquí tienen prioridad sobre las integradas.

El archivo .qnfa especifica la sintaxis del idioma. La información de formato real se especifica en
un archivo .qxf. Puede usar los formatos especificados en defaultFormats.qxf o proporcionar su
propio archivo .qxf junto con el archivo .qnfa.

Debe leer la especificación de formato de sintaxis y echar un vistazo a los formatos enviados con
TeXstudio .

Nota: Exponemos la especificación del idioma como usuario final para darle más flexibilidad al
adaptar TeXstudio a sus necesidades. Pero debes tomarlo como está, porque no tenemos la
capacidad de brindar apoyo aquí. Es una poderosa API, pero no está pulida ni tiene todas las
funciones. Es posible que encuentre algunos constructos en los archivos .qnfa enviados, que no
 están documentados en la especificación de formato de sintaxis. Además, el formato basado en
expresiones regulares de QNFA no es suficiente para definir todo el resaltado que queríamos para
LaTeX. Por lo tanto, tenemos funcionalidad de resaltado adicional implementada directamente
en el código fuente para el lenguaje "(La) TeX", por ejemplo, el resaltado dentro de los
paréntesis de \beginy \end. No podrá modificar esto ni agregarlo a otros idiomas.

Ejemplo

El siguiente es un pequeño ejemplo que especifica algunos resaltados del código python:

python.qnfa

<! DOCTYPE QNFA>

<QNFA language = "Python" extensiones = "py" defaultLineMark = "">
<sequence parenthesis = "round: open" parenthesisWeight = "00"> \ (</
sequence>
<sequence parenthesis = "round: close" parenthesisWeight = "00"> \)
</ sequence>
<! - resaltar definición y nombre de la función ->
<sequence id = "python / definición" format = "python: definición">
def $ s? $ w * </ sequence>
<sequence id = "python / number" format = "python: number"> [0-9] +
</ sequence>
<list id = "python / keyword" format = "python: palabra clave">
<palabra> retorno </ word>
<palabra> si </ word>
<palabra> elif </ word>
<palabra> else </ word>
</ list>
</ QNFA>

python.qxf

<! DOCTYPE QXF>

<QXF version = "1.0">
<! - especificación completa ->
<format id = "python: palabra clave">
<bold> falso </ bold>
<italic> falso </ italic>
<overline> falso </ overline>
<subrayado> falso </ subrayado>
<tachado> falso </ tachado>
<waveUnderline> falso </ waveUnderline>
<primer plano> # B200FF </ primer plano>
</ format>
<! - pero es suficiente para especificar desviaciones del valor
predeterminado ->
<format id = "python: número">
<italic> verdadero </ italic>
<overline> falso </ overline>
<primer plano> # 007F0E </ primer plano>
</ format>
<format id = "python: definición">
<bold> verdadero </ bold>
</ format>
 </ QXF>

Los resultados son los siguientes:

Registro de cambios
El registro de cambios se puede encontrar
en http://texstudio.sourceforge.net/manual/current/CHANGELOG.txt .