Skip to content

Commit 8456b27

Browse files
authored
Update ES translation of help.md
1 parent 85eab60 commit 8456b27

1 file changed

Lines changed: 163 additions & 55 deletions

File tree

es/help.md

Lines changed: 163 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,17 @@
22
layout: "page"
33
lang: "es"
44
title: "Usando el sitio web learnlatex.org"
5+
description: "Esta página web explica el objetivo de learnlatex.org y cómo hacer el mejor uso de él"
56
permalink: /es/help
67
---
78

9+
# Help
10+
11+
812
## Navegando por el sitio web
913

1014
El curso consiste en 16 lecciones principales, a las que se puede acceder
11-
desde el índice de la [página inicial](/).
15+
desde [índice]({{ "/" | absolute_url | append: page.lang | append: "/#toc" }}) de la [página inicial](./).
1216

1317
Cada lección dispone de un enlace a otra lección, que permite profudizar
1418
sobre el mismo tema. Es posible abordar las 16 lecciones principales
@@ -18,85 +22,116 @@ Al final del curso, hay una o más lecciones específicas del idioma usado
1822
y una galería con ejemplos de algunos paquetes de LaTeX que no han sido
1923
abordados en este curso.
2024

21-
## Ejecutando los ejemplos
25+
---
26+
27+
## Ejemplos
28+
29+
### Ejecutando los ejemplos
2230

2331
Cada ejemplo contiene un pequeño documento de LaTeX completo, que se muestra
2432
en la página de la siguiente forma:
2533

2634
```latex
2735
\documentclass{article}
2836
\usepackage[T1]{fontenc}
37+
2938
\begin{document}
3039
Example text.
3140
\end{document}
3241
```
3342

34-
El ejemplo esta completo. Sin embargo, puede que quiera editarlo para hacer
35-
pequeños cambios, quizá como parte de los ejercicios propuestos al final de
36-
cada lección.
43+
Cada ejemplo contiene un código completo e independiente. Sin embargo, puede que quiera editarlo para hacer
44+
pequeños cambios, quizá como parte de los ejercicios propuestos al final de cada lección.
45+
3746
El editor usado es [ACE](https://ace.c9.io/).
3847

39-
Haga lo que haga, editar o no el texto del ejemplo, hay tres maneras básicas de ejecutarlo.
48+
Puede configurar el tema usado en el editor (por ejemplo usando un
49+
teme oscuro, con el texto claro sobre fondo negro) en el apartado de [Configuración del sitio web](settings).
50+
Una manera adecuada de probar los diferentes temas disponibles es usando <kbd>Ctrl</kbd><kbd>,</kbd> (<kbd>⌘</kbd>+<kbd>,</kbd> en Mac) cuando se encuentre
51+
en el texto de alguno de los ejemplos del sitio web. Esta combinación de teclas le mostrará un panel que le permitirá cambiar todos los parámetros de ACE.
4052

53+
El depósito de ACE dispone de una página [muy útil para conocer las teclas de acceso rápido del editor] https://github.com/ajaxorg/ace/wiki/Default-Keyboard-Shortcuts).
4154

42-
1. Usar un servicio de **LaTeX en línea**. El botón <button style="padding:0 1px;font-size:90%">LaTeX Online</button>
43-
enviará el código al servicio
44-
[TeXLive.net](https://texlive.net) [^1].
45-
46-
El servicio TeXLive.net fue desarrolado especifícamente para ser compatible con este sitio y
47-
en particular hace uso de [PDF.js](https://mozilla.github.io/pdf.js/)
48-
para permitir mostrar documentos PDF en dispositivos móviles y otros sistemas que no dispongan
49-
de lectores de archivos PDF.
50-
51-
El documento PDF resultante (o la sección del registro de errores) será
52-
mostrado en línea, inmediatamente después del ejemplo. Un botón <button style="padding:0 1px;font-size:90%">Borrar
53-
Salida</button> estará a su disposición para eliminar el resultado obtenido
54-
(o también puede dejarlo y continuar con el resto de la lección).
55-
56-
Note que **LaTeX Online** no le pedirá, ni iniciar sesión ni registrarse, por
57-
lo que es muy apropiado para los pequeños ejemplos, pero ni este sitio ni los
58-
sitios de `latexcgi`, `latexonline.cc` o `latex-on-http` dispodrá de herramientas
59-
para guardar su documento. Cualquier cambio que haga en el ejemplo
60-
se perderá al cambiar de página.
61-
62-
2. Usar el servicio **Overleaf**. El botón <button style="padding:0 1px;font-size:90%">Abrir en Overleaf</button>
63-
enviará el código a [Overleaf](https://www.overleaf.com/about).
55+
56+
57+
### Tres maneras de ejecutar un ejemplo
58+
59+
* Usando el servicio Overleaf
60+
* Usando el servicio TeXLive.net
61+
* Usando un sistema TeX instalado localmente
62+
63+
#### Usando el servicio Overleaf
64+
65+
Overleaf es uno de los servicios en línea más populares para editar textos en LaTeX. El
66+
botón <button>Abrir en Overleaf</button>, en la parte inferior de los ejemplos, enviará el
67+
código a [Overleaf](https://www.overleaf.com/about).
68+
69+
Si no tiene una cuenta, o si los datos de su cuenta no están guardados
70+
en su explorador, usted será redirigido a una página de inicio de
71+
sesión, para acceder a su cuenta o para registrarse en Overleaf. Este servicio
72+
es gratuito, pero le pedirá algunos detalles y aceptar los términos
73+
y condiciones del servicio.
6474

65-
Si no tiene una cuenta, o si los datos de su cuenta no están guardados
66-
en su explorador, usted será redirigido a una página de inicio de
67-
sesión, para acceder a su cuenta o para registrarse en Overleaf. Este servicio
68-
es gratuito, pero le pedirá algunos detalles y aceptar los términos
69-
y condiciones del servicio.
75+
Si su cuenta de Overleaf ya ha sido guardada en su explorador, Overleaf
76+
abrirá una nueva pestaña de nuevo proyecto con el código del ejemplo.
77+
A partir de ese momento, podrá editarlo en Overleaf que ejecutará
78+
automáticamente LaTeX mostrándole el resultado de su documento o el
79+
registro de errores.
7080

71-
Si su cuenta de Overleaf ha sido guardada en su explorador, Overleaf
72-
abrirá una nueva pestaña de nuevo proyecto con el código del ejemplo.
73-
A partir de ese momento, podrá editarlo en Overleaf que ejecutará automáticamente
74-
LaTeX mostrándole el resultado de su documento o el registro de errores.
81+
A diferencia de lo que ocurre en TeXLive.net, con Overleaf tiene la posibilidad
82+
de guardar el proyecto en su cuenta y volver a él más tarde.
83+
84+
#### Usando el servicio TeXLive.net
85+
86+
El <button>Ejecutar en TeXLive.net</button>, en la parte inferior de los ejemplos, enviará el código al
87+
servicio en línea [TeXLive.net](https://texlive.net)[^1].
88+
89+
El servicio TeXLive.net fue desarrollado específicamente para ser compatible con nuestro sitio web, y
90+
hace uso en particular de [PDF.js](https://mozilla.github.io/pdf.js/)
91+
para permitir visualizar documentos PDF en dispositivos móviles y otros sistemas que no dispongan
92+
de lectores de archivos PDF.
93+
94+
El documento PDF resultante (o la sección del registro de errores) será
95+
mostrado en línea, inmediatamente después del ejemplo. Un botón <button>Borrar
96+
Salida</button> estará a su disposición para que pueda eliminar el resultado obtenido
97+
(o también puede dejarlo y continuar con el resto de la
98+
lección).
7599

76-
Las funcionalidades de edición en Overleaf son mucho más avanzadas que las
77-
de este sitio web y podrá guardar su proyecto en su cuenta Overleaf, teniendo
78-
la posibilidad de volver más tarde a su código.
100+
Note que **LaTeX Online** no le pedirá, ni iniciar sesión ni registrarse, por lo que es
101+
muy apropiado para los pequeños ejemplos, pero este sitio no dispone de herramientas
102+
para guardar su documento. Cualquier cambio que haga en el ejemplo
103+
se perderá al cambiar de página.
104+
105+
#### Usando un sistema TeX instalado localmente
106+
107+
Si tiene un sistema TeX instalado localmente en su ordenador, puede copiar
108+
el texto del ejemplo, bien seleccionándolo o usando las
109+
teclas de acceso rápido en el editor
110+
(<kbd>Ctrl</kbd>+<kbd>A</kbd> <kbd>Ctrl</kbd>+<kbd>C</kbd> en Windows
111+
por ejemplo). Esto pondrá el código en el portapapeles de su sistema operativo.
112+
Usted podrá abrir entonces un archivo en blanco, en su editor de LaTeX local
113+
y pegar en él, el contenido del partapapeles.
114+
115+
### En caso de problemas
79116

80-
3. Si tiene un sistema TeX instalado localmente en su ordenador, puede copiar
81-
el texto del ejemplo, bien seleccionándolo o usando las teclas de acceso rápido
82-
en el editor (Ctrl-A Ctrl-C en Windows por ejemplo). Esto pondrá el código en el
83-
potapapeles de su sistema operativo. Usted podrá abrir entonces un archivo en blanco, en
84-
su editor de LaTeX local y pegar el contenido del partapapeles.
117+
Nuestros ejemplos deben ser usados utilizando una instalación de LaTeX actualizada. Todos ellos
118+
funcionan los servicios en línea que ponemos a su disposición, así que si un de nuestros
119+
ejemplos le da errores, quizá deba verificar si su sistema de LaTeX está
120+
actualizado
121+
122+
---
85123

86124
## Eligiento el motor de TeX
87125

88-
Cuando se compilan los documentos de los ejemplos, el motor por
89-
defecto es `pdflatex` a menos que use el paquete `fontspec`
90-
en cuyo caso se usará `xelatex`.
126+
Cuando se compilan los los documentos de ejemplo, el motor usado por defecto es `pdflatex`.
91127

92128
Puede forzar en uso de `pdflatex`, `xelatex`, `lualatex`,
93129
`platex` o `uplatex` añadiendo un comentario de la forma siguiente:
94130

95131
`% !TEX ` _culquier texto_ `lualatex`
96132

97-
el espacio inicial es opcional y la diferencia entre mayúsculas y minúsculas
98-
se ignora, al igual que la parte _cualquier texto_ situada entre la primera y
99-
la última palabra.
133+
donde el espacio inicial es opcional y la diferencia entre mayúsculas y minúsculasse ignora,
134+
al igual que la parte _cualquier texto_ situada entre la primera y la última palabra.
100135

101136
Esto permire el uso de `% !TEX program=pdflatex` utilizado en algunos editores de TeX,
102137
aunque el uso de `program=` no sea necesario y esté actualmente restringido
@@ -106,18 +141,24 @@ sistemas en línea que son usados.
106141
Puede ver un ejemplo de un comentario usado para especificar el uso de LuaLaTex en
107142
[uno de los ejemplos de este sitio](more-14).
108143

109-
Si se elige `platex` o `uplatex`, se usará el programa `dvipdfmx` para
144+
Si se elige el moror `platex` o `uplatex`, se usará el programa `dvipdfmx` para
110145
producir el archivo PDF a partir del archivo DVI, que estas variantes generan.
146+
De forma similar se usarán los programas `dvips` y `ps2pdf` si se especifica `latex`.
147+
148+
Si ningún motor de TeX es especificado en un comentario del tipo `% !TeX`, entonces se usará `pdflatex`
149+
a menos que haya especificado un motor por defecto en el apartado de [Configuración del sitio web](settings).
150+
151+
---
111152

112153
## Eligiendo cómo mostrar la salida
113154

114-
Si usa un sistema de LaTeX en línea, el PDF resultante
155+
Si usa el sistema TeXLive.net, el PDF resultante
115156
de la ejecución del ejemplo se mostrará, por defecto, usando
116157
[PDF.js](https://mozilla.github.io/pdf.js/). Esto permite disponer
117158
de un comportamiento consistente en la mayor parte de los exploradores.
118159

119160
Si prefiere utilizar el lector PDF por defecto de su explorador (ya sea
120-
uno propio a su explorador o un aplicación externa que haya configurado),
161+
uno propio a su explorador, o un aplicación externa que haya configurado),
121162
añada un comentario de la forma:
122163

123164
`% !TEX ` _cualquier texto_ `pdf`
@@ -128,10 +169,77 @@ ver el archivo log, aunque el documento genere un PDF sin
128169
errores. Esto puede ser especificado usando `log` como argumento final en
129170
el comentario anterior.
130171

172+
Una alternativa al uso del comentario`% !TeX`, consiste a especificar
173+
el tipo de salida desadi en el apartado de [Configuración del sitio web](settings).
174+
La configuration es específica de cada explorador, así que por ejemplo usted
175+
puede elegir usar por defecto `pdfjs` en su teléfono móvil,
176+
y usar `pdf` en el explorador de su ordenador o computadora, para utilizar su visualizador PDF por defecto.
177+
178+
179+
---
180+
181+
## Salida HTML (make4ht, LaTeXML, lwarp)
182+
183+
Si utiliza el sistema TeXLive.net, dispondrá de opciones de salida adicionales:
184+
`make4ht`, `LaTeXML` or `lwarp` podrán ser especificados. Estos devuelven como salida una o más páginas HTML
185+
en un marco dentro de la misma página. Estas opciones pueden ser especificadas al mismo tiempo
186+
que los motores `xelatex` or `lualatex` o el motor por defecto `pdflatex`.
187+
188+
Para habilitar este formaro de salida, añada un comentario de la forma:
189+
190+
191+
```
192+
% !TeX make4ht
193+
```
194+
{: .noedit :}
195+
196+
197+
Remplace `make4ht` por `LaTeXML` o `lwarp` para especificar estos sistemas.
198+
199+
200+
201+
De forma alternativa puede especificar `make4ht`, `LaTeXML` o `lwarp` como salida por defecto en el
202+
apartado de [Configuración del sitio web](settings).
203+
204+
205+
Si usa un sistema TeX instalado localmente, la misma salida aue con la opción `make4ht` puede ser obtenida
206+
ejecutando el siguiente comando
207+
208+
```
209+
make4ht document.tex "learnlatex4ht,2,mathml,mathjax,svg"
210+
```
211+
{: .noedit :}
212+
213+
añadiendo como opción adicional `-x` o `-l` si XeLaTeX o LuaLaTeX son especificados.
214+
215+
Otras configuraciones son posibles si utiliza su sistema TeX instalado localmente. Consulte el [manual
216+
make4ht](https://texdoc.org/pkg/make4ht).
217+
218+
219+
Para ejecutar `LaTeXML` en su sistema locañ, debe instalar LaTeXML (no forñma parte ni de TeX Live ni de MiKTeX)
220+
y usar el siguiente comando
221+
222+
```
223+
latexml document.tex > document.xml
224+
latexmlpost --format=html5 \
225+
--javascript='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' \
226+
--destination=document.html" document.tex
227+
```
228+
{: .noedit :}
229+
230+
Otras muchas configuraciones LaTeXML son posibles,
231+
[como se comenta en su manual](https://dlmf.nist.gov/LaTeXML/manual/).
232+
233+
234+
La configuración `lwarp` no la comentaremos aquí, está en experimentación y puede variar aún.
235+
Puede consultar la versión actual en el
236+
[depósito de origen](https://github.com/davidcarlisle/latexcgi/blob/main/lwarp/latexcgilwarp).
237+
238+
131239
---
132240

133241
[^1]: Note que durante el desarrollo del sitio web hemos usado también
134242
[LaTeX.Online](https://latexonline.cc/) y
135243
[LaTeX-on-HTTP](https://github.com/YtoTech/latex-on-http)
136244
y agradecemos a los desarrolladores de estos servicios por realizar las actualizaciones necesarias que
137-
han permitido que los ejemplos de esta web estén disponibles desde el principio.
245+
han permitido que los ejemplos de esta web estén disponibles desde el principio.

0 commit comments

Comments
 (0)