mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-12-22 21:21:32 +00:00
- Spanish Customization.lyx: updates by Ignacio
- English Customization.lyx: fix preamble comment git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@29537 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
parent
9ba69f3f1b
commit
92b4d6d431
@ -1,14 +1,14 @@
|
||||
#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
|
||||
\lyxformat 354
|
||||
\lyxformat 355
|
||||
\begin_document
|
||||
\begin_header
|
||||
\textclass scrbook
|
||||
\begin_preamble
|
||||
% DO NOT ALTER THIS PREAMBLE!!!
|
||||
%
|
||||
% This preamble is designed to ensure that the User's Guide prints
|
||||
% This preamble is designed to ensure that this document prints
|
||||
% out as advertised. If you mess with this preamble,
|
||||
% parts of the User's Guide may not print out as expected. If you
|
||||
% parts of this document may not print out as expected. If you
|
||||
% have problems LaTeXing this file, please contact
|
||||
% the documentation team
|
||||
% email: lyx-docs@lists.lyx.org
|
||||
|
@ -1,4 +1,4 @@
|
||||
#LyX 1.6.2svn created this file. For more info see http://www.lyx.org/
|
||||
#LyX 1.6.3svn created this file. For more info see http://www.lyx.org/
|
||||
\lyxformat 345
|
||||
\begin_document
|
||||
\begin_header
|
||||
@ -6,9 +6,9 @@
|
||||
\begin_preamble
|
||||
% DO NOT ALTER THIS PREAMBLE!!!
|
||||
%
|
||||
% This preamble is designed to ensure that the User's Guide prints
|
||||
% This preamble is designed to ensure that the manual prints
|
||||
% out as advertised. If you mess with this preamble,
|
||||
% parts of the User's Guide may not print out as expected. If you
|
||||
% parts of the document may not print out as expected. If you
|
||||
% have problems LaTeXing this file, please contact
|
||||
% the documentation team
|
||||
% email: lyx-docs@lists.lyx.org
|
||||
@ -75,8 +75,8 @@ End
|
||||
\paperfontsize 12
|
||||
\spacing single
|
||||
\use_hyperref true
|
||||
\pdf_title "LyX Configuration Manual"
|
||||
\pdf_author "LyX Team"
|
||||
\pdf_title "Manual Personalización de LyX"
|
||||
\pdf_author "Equipo LyX"
|
||||
\pdf_subject "LyX-documentation Customization"
|
||||
\pdf_keywords "LyX, documentation, customization"
|
||||
\pdf_bookmarks true
|
||||
@ -182,10 +182,10 @@ Este manual trata de las características de LyX que pueden ser modificadas
|
||||
en pantalla, opciones de impresora, envío de comandos mediante LyX Server,
|
||||
internacionalización, instalación de nuevas clases de LaTeX y de formatos
|
||||
de LyX, etc.
|
||||
Seguro que no podemos aspirar a tratar todo lo que se puede cambiar, —nuestros
|
||||
Seguro que no podemos aspirar a tratar todo lo que se puede cambiar, —nuestross
|
||||
desarrolladores añaden características nuevas más deprisa de lo que las
|
||||
podemos documentar— pero explicaremos las modificaciones más comunes y
|
||||
esperamos orientarte en la dirección correcta para algunas más desconocidas.
|
||||
y esperamos orientarte en la dirección correcta para algunas más desconocidas.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
@ -1240,136 +1240,9 @@ Guía del usuario
|
||||
\end_layout
|
||||
|
||||
\begin_layout Section
|
||||
Usando el diálogo por primera vez
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
El archivo
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
UserDir/preferences
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
contendrá solo los cambios hechos al comportamiento predeterminado, parte
|
||||
del cuál es del código duro de LyX y otra parte está en el archivo de sistema
|
||||
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
LyXDir/lyxrc.defaults
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
.
|
||||
Ten en cuenta que en ambos archivos las líneas que comienzan con
|
||||
\begin_inset Quotes fld
|
||||
\end_inset
|
||||
|
||||
#
|
||||
\begin_inset Quotes frd
|
||||
\end_inset
|
||||
|
||||
son solo comentarios y no son interpretados.
|
||||
Sin embargo, solo los administradores del sistema deberían editar
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
LyXDir/lyxrc.defaults
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
.
|
||||
Los usuarios deberían utilizar el diálogo
|
||||
\begin_inset Flex CharStyle:MenuItem
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
Herramientas\SpecialChar \menuseparator
|
||||
Preferencias
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
para crear y modificar su propio archivo
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
UserDir/preferences
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Creemos que el diálogo
|
||||
\begin_inset Flex CharStyle:MenuItem
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
Herramientas\SpecialChar \menuseparator
|
||||
Preferencias
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
resultará bastante explícito por sí mismo.
|
||||
La mayoría de las cosas en este diálogo tiene 'ayudas emergentes' asociadas:
|
||||
basta colocar el puntero del ratón sobre alguna opción.
|
||||
Antes de fijarnos a continuación en algunos de los comandos más importantes,
|
||||
una advertencia: algunos de los cambios aplicados (p.
|
||||
\begin_inset space \thinspace{}
|
||||
\end_inset
|
||||
|
||||
e.
|
||||
\begin_inset space ~
|
||||
\end_inset
|
||||
|
||||
las fuentes de pantalla) tendrán un efecto inmediato, otros no (p.
|
||||
\begin_inset space \thinspace{}
|
||||
\end_inset
|
||||
|
||||
e.
|
||||
\begin_inset space ~
|
||||
\end_inset
|
||||
|
||||
los atajos de teclado).
|
||||
Si parece que no cambia nada, hay que
|
||||
\begin_inset Flex CharStyle:MenuItem
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
Guardar
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
cambios y reiniciar LyX.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Section
|
||||
Manejo de archivos
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
LyX dispone de un poderoso mecanismo para convertir a y desde cualquier
|
||||
formato de archivo usando programas externos.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsection
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sub:Formatos"
|
||||
name "sec:Formatos"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -1543,7 +1416,8 @@ Editar externamente
|
||||
|
||||
\end_inset
|
||||
|
||||
en un gráfico o en un material externo, por ejemplo.
|
||||
que se muestra al hacer clic derecho en un gráfico o en un material externo,
|
||||
por ejemplo.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
@ -1561,7 +1435,7 @@ Formato de documento
|
||||
Si esto está marcado y existe una ruta de conversión adecuada (véase
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sub:Convertidores"
|
||||
reference "sec:Convertidores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -1732,7 +1606,7 @@ png
|
||||
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsection
|
||||
\begin_layout Section
|
||||
Copiadores
|
||||
\end_layout
|
||||
|
||||
@ -2069,10 +1943,10 @@ status collapsed
|
||||
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsection
|
||||
\begin_layout Section
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sub:Convertidores"
|
||||
name "sec:Convertidores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -2213,6 +2087,50 @@ $$p
|
||||
La ruta al archivo de entrada
|
||||
\end_layout
|
||||
|
||||
\begin_layout Labeling
|
||||
\labelwidthstring 00.00.0000
|
||||
|
||||
\color red
|
||||
|
||||
\backslash
|
||||
begin_layout Labeling
|
||||
\backslash
|
||||
labelwidthstring 00.00.0000
|
||||
\backslash
|
||||
begin_inset Flex CharStyle:Code status collapsed
|
||||
\end_layout
|
||||
|
||||
\begin_layout Labeling
|
||||
\labelwidthstring 00.00.0000
|
||||
|
||||
\color red
|
||||
|
||||
\backslash
|
||||
begin_layout Plain Layout $$r
|
||||
\backslash
|
||||
end_layout
|
||||
\end_layout
|
||||
|
||||
\begin_layout Labeling
|
||||
\labelwidthstring 00.00.0000
|
||||
|
||||
\color red
|
||||
|
||||
\backslash
|
||||
end_inset
|
||||
\end_layout
|
||||
|
||||
\begin_layout Labeling
|
||||
\labelwidthstring 00.00.0000
|
||||
|
||||
\color red
|
||||
The path to the original input file (this is different from $$p when chain
|
||||
of converters is called).
|
||||
|
||||
\backslash
|
||||
end_layout
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
En el campo
|
||||
\begin_inset Flex CharStyle:MenuItem
|
||||
@ -2456,7 +2374,7 @@ dvipdfm
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sub:Formatos"
|
||||
reference "sec:Formatos"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -5709,13 +5627,14 @@ default
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsection
|
||||
Módulos de formato
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sub:Módulos-de-formato"
|
||||
|
||||
\end_inset
|
||||
|
||||
Módulos de formato
|
||||
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
@ -5810,11 +5729,11 @@ La declaración del módulo debería seguir a continuación con líneas como:
|
||||
\begin_layout LyX-Code
|
||||
#Deberás añadir
|
||||
\backslash
|
||||
theendnotes en ERT allí donde quieras
|
||||
theendnotes en código TeX allí donde
|
||||
\end_layout
|
||||
|
||||
\begin_layout LyX-Code
|
||||
#que aparezcan las notas finales.
|
||||
#quieras que aparezcan las notas finales.
|
||||
|
||||
\end_layout
|
||||
|
||||
@ -6682,7 +6601,7 @@ ClassOptions
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:classoptions"
|
||||
reference "sub:classoptions"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -6773,7 +6692,7 @@ Counter
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:contadores"
|
||||
reference "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -6817,7 +6736,7 @@ DefaultFont
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -6996,7 +6915,7 @@ Float
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:flotantes"
|
||||
reference "sub:flotantes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -7071,7 +6990,7 @@ e., un nuevo estilo de texto.
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:estilo-del-texto"
|
||||
reference "sub:estilo-del-texto"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -7818,7 +7737,7 @@ ClassOptions
|
||||
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:classoptions"
|
||||
name "sub:classoptions"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -8557,7 +8476,7 @@ y
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -8883,7 +8802,7 @@ string=""
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:contadores"
|
||||
reference "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -8929,7 +8848,7 @@ LabelFont
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -9022,7 +8941,7 @@ LabelCounter
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:contadores"
|
||||
reference "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -9076,7 +8995,7 @@ style-name
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:contadores"
|
||||
reference "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -9362,7 +9281,7 @@ Counter
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:contadores"
|
||||
reference "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -10580,7 +10499,7 @@ TextFont
|
||||
Véase la sección
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -10633,7 +10552,7 @@ float=0
|
||||
Flotantes
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:flotantes"
|
||||
name "sub:flotantes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -11218,7 +11137,7 @@ type
|
||||
Recuadros flexibles y formato del recuadro
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:estilo-del-texto"
|
||||
name "sub:estilo-del-texto"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -11353,9 +11272,9 @@ InsetLayout
|
||||
\end_inset
|
||||
|
||||
permite personalizar los parámetros de diseño de notas al pie, notas al
|
||||
margen, notas, recuadros de código TeX, ramas, listados de programa, índices,
|
||||
cuadros, tablas, algoritmos, URL, y argumentos opcionales, así como para
|
||||
definir recuadros flexibles.
|
||||
margen, notas, recuadros de código TeX (ERT), ramas, listados de programa,
|
||||
índices, cuadros, tablas, algoritmos, URL, y argumentos opcionales, así
|
||||
como para definir recuadros flexibles.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
@ -11837,7 +11756,7 @@ Font
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -11893,7 +11812,7 @@ e.
|
||||
\begin_inset space \space{}
|
||||
\end_inset
|
||||
|
||||
en ERT o URL.
|
||||
en código TeX o URL.
|
||||
Un parche.
|
||||
\end_layout
|
||||
|
||||
@ -11991,7 +11910,7 @@ LabelFont
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:fuentes"
|
||||
reference "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -12020,8 +11939,8 @@ LabelString
|
||||
\end_inset
|
||||
|
||||
Lo que se mostrará sobre el botón u otra parte como etiqueta del recuadro.
|
||||
Algunos tipos de recuadro (ERT y ramas) modifican esta etiqueta sobre la
|
||||
marcha.
|
||||
Algunos tipos de recuadro (código TeX y ramas) modifican esta etiqueta
|
||||
sobre la marcha.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Description
|
||||
@ -12340,7 +12259,7 @@ reference "des:Requires"
|
||||
Contadores
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:contadores"
|
||||
name "sub:contadores"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -12823,7 +12742,7 @@ section
|
||||
Descripción de las fuentes
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:fuentes"
|
||||
name "sub:fuentes"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -13677,19 +13596,6 @@ Es relativamente fácil añadir en LyX definiciones personalizadas de plantillas
|
||||
externas.
|
||||
Sin embargo, hay que ser consciente de que hacer esto de manera descuidada
|
||||
generará muy probablemente un agujero de seguridad fácil de explotar.
|
||||
Así pues, antes de hacer esto, es recomendable leer la discusión sobre
|
||||
seguridad en la sección
|
||||
\begin_inset space ~
|
||||
\end_inset
|
||||
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sec:Security-discussion"
|
||||
|
||||
\end_inset
|
||||
|
||||
.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
@ -14138,7 +14044,7 @@ InputFormat
|
||||
|
||||
\begin_inset CommandInset ref
|
||||
LatexCommand ref
|
||||
reference "sub:Formatos"
|
||||
reference "sec:Formatos"
|
||||
|
||||
\end_inset
|
||||
|
||||
@ -15248,181 +15154,5 @@ status collapsed
|
||||
necesita el nombre relativo para reescribir el contenido del archivo.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Section
|
||||
\begin_inset CommandInset label
|
||||
LatexCommand label
|
||||
name "sec:Security-discussion"
|
||||
|
||||
\end_inset
|
||||
|
||||
Security discussion
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
\begin_inset Box Shadowbox
|
||||
position "t"
|
||||
hor_pos "c"
|
||||
has_inner_box 1
|
||||
inner_pos "t"
|
||||
use_parbox 0
|
||||
width "100col%"
|
||||
special "none"
|
||||
height "1in"
|
||||
height_special "totalheight"
|
||||
status open
|
||||
|
||||
\begin_layout Plain Layout
|
||||
WARNING: This section is definitely outdated.
|
||||
\begin_inset Note Note
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
N.
|
||||
del T.: Sección definitivamente anticuada, por lo que no merece la pena
|
||||
traducirla.
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
The external material feature interfaces with a lot of external programs
|
||||
and does so automatically, so we have to consider the security implications
|
||||
of this.
|
||||
In particular, since you have the option of including your own filenames
|
||||
and/or parameter strings and those are expanded into a command, it seems
|
||||
that it would be possible to create a malicious document which executes
|
||||
arbitrary commands when a user views or prints the document.
|
||||
This is something we definately want to avoid.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
However, since the external program commands are specified in the template
|
||||
configuration file only, there are no security issues if LyX is properly
|
||||
configured with safe templates only.
|
||||
This is so because the external programs are invoked with the
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
execvp
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
-system call rather than the
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
system
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
system-call, so it's not possible to execute arbitrary commands from the
|
||||
filename or parameter section via the shell.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
This also implies that you are restricted in what command strings you can
|
||||
use in the external material templates.
|
||||
In particular, pipes and redirection are not readily available.
|
||||
This has to be so if LyX should remain safe.
|
||||
If you want to use some of the shell features, you should write a safe
|
||||
script to do this in a controlled manner, and then invoke the script from
|
||||
the command string.
|
||||
In the
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
lib/scripts
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
directory of the LyX installation, you can find a safe wrapper script
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
general_command_wrapper.py
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
that supports redirection of input and output.
|
||||
That can serve as an example for how to write safe template scripts.
|
||||
For a more advanced example that uses
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
fork
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
and friends, take a look at the
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
pic2ascii.py
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
converter script.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
It is possible to design a template that interacts directly with the shell,
|
||||
but since this would allow a malicious user to execute arbitrary commands
|
||||
by writing clever filenames and/or parameters, we generally recommend that
|
||||
you only use safe scripts that work with the
|
||||
\begin_inset Flex CharStyle:Code
|
||||
status collapsed
|
||||
|
||||
\begin_layout Plain Layout
|
||||
execvp
|
||||
\end_layout
|
||||
|
||||
\end_inset
|
||||
|
||||
system call in a controlled manner.
|
||||
Of course, for use in a controlled environment, it can be tempting to just
|
||||
fall back to use ordinary shell scripts.
|
||||
If you do so, be aware that you
|
||||
\emph on
|
||||
will
|
||||
\emph default
|
||||
provide an easily exploitable security hole in your system.
|
||||
Of course it stands to reason that such unsafe templates will never be
|
||||
included in the standard LyX distribution, although we do encourage people
|
||||
to submit new templates in the open source tradition.
|
||||
But LyX as shipped from the official distribution channels will never have
|
||||
unsafe templates.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Including external material provides a lot of power, and you have to be
|
||||
careful not to introduce security hazards with this power.
|
||||
A subtle error in a single line in an innocent looking script can open
|
||||
the door to huge security problems.
|
||||
So if you do not fully understand the issues, we recommend that you consult
|
||||
a knowledgable security professional or the LyX development team if you
|
||||
have any questions about whether a given template is safe or not.
|
||||
And do this before you use it in an uncontrolled environment.
|
||||
\end_layout
|
||||
|
||||
\end_body
|
||||
\end_document
|
||||
|
Loading…
Reference in New Issue
Block a user