Skip to content

Commit 152141b

Browse files
authored
Merge pull request #175 from fersdt/main
Update ES translation of index.md and help.md
2 parents 224b40c + 8456b27 commit 152141b

4 files changed

Lines changed: 177 additions & 119 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.

es/includes/buttons.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
runlatex.texts ={
22
"Open in Overleaf": "Abrir en Overleaf",
3-
"TeXLive.net": "LaTeX Online",
3+
"TeXLive.net": "Ejecutar en TeXLive.net",
44
"Delete Output": "Borrar Salida",
55
"Compiling PDF": "Compilando PDF",
66
// The following not used on learnlatex.org

es/index.md

Lines changed: 10 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -10,87 +10,34 @@ permalink: /es/
1010

1111
<h2 class="heading__introduction">Dé sus primeros pasos en LaTeX, un sistema para la preparación de documentos diseñado para obtener una gran calidad tipográfica.</h2>
1212

13-
<div
13+
<div
1414
class="text-columns">
1515
<section>
16-
<h3
17-
class="text-columns__heading"
18-
>Introduccción</h3>
16+
<h3 class="text-columns__heading">Introduccción</h3>
1917
<p>LaTeX puede dar un poco de miedo a los nuevos usuarios ya que <em>no</em> es un procesador de textos,
2018
y porque no es un programa único. Nuestro objetivo es ayudarle a
2119
dar sus primeros pasos en LaTeX partiendo de las nociones básicas, la instalación, la escritura del código, sin
2220
intentar enseñarle <em>todo</em> de una sola vez. <a href="./mission">Más información sobre nuestra misión &hellip;</a></p>
2321
</section>
2422
<section>
25-
<h3
26-
class="text-columns__heading"
27-
>¿Cómo funciona?</h3>
28-
<p>Hemos seleccionado las 16 cosas más importantes que necesitará conocer y las hemos explicado en breves <em>lecciones</em> que no le debería llevar mucho tiempo a abordar. En cada lección damos muchos ejemplos. Podrá editarlos y ejecutarlos en este sitio Web. <a href="./help#examples">Más sobre los ejemplos &hellip;</a></p>
23+
<h3 class="text-columns__heading">¿Cómo funciona?</h3>
24+
<p>Hemos seleccionado las nociones más importantes que debe conocer y las hemos explicado en <em>16 pequeñas lecciones</em> que no le deberían llevar mucho tiempo. En cada lección damos muchos ejemplos de buenas prácticas. Podrá editarlos y ejecutarlos en este sitio Web. <a href="./help#examples">Más sobre los ejemplos &hellip;</a></p>
2925
</section>
3026
</div>
3127

32-
# ¡Bienvenido a learnlatex.org!
28+
<h2 class="heading__toc" id="toc">Lecciones</h2>
3329

34-
Este sitio web tiene como objetivo ayudarle en sus primeros pasos en LaTeX,
35-
un sistema de elaboración de documentos que permite obtener una alta calidad
36-
tipográfica. LaTeX puede dar miedo a los nuevos usuarios, ya que no es un procesador
37-
de textos y al no serlo no es sólo un programa. Nuestro objetivo es ayudarle a
38-
dar sus primeros pasos sin intentar mostrarle _todo_ de una sola vez.
39-
40-
Para ello, hemos seleccionado 16 de los temas más importantes que necesitará
41-
conocer y los hemos convertido en pequeñas "lecciones". Cada lección es muy
42-
concreta y concisa, con lo que no debería llevarle mucho tiempo. En cada lección, damos
43-
ejemplos de lo que podría escribir, y estos ejemplos puede probarlos en línea.
44-
45-
Sabemos que la gente querrá aprender más de lo que abarcan las 16 lecciones
46-
cortas. Para guiarle cuando necesite más información, hemos añadido
47-
una sección "ir más allá" en cada lección.
48-
49-
## Cómo funcionan los ejemplos
50-
51-
Para ayudarle a aprender, el sitio web incluye muchos ejemplos. En la
52-
[lección 2](lesson-02) hablaremos sobre cómo usar LaTeX, en línea o con
53-
una instalación local en su PC. Para ayudarle en sus comienzos, hemos preparado
54-
ejemplos que puede editar y ejecutar dede el sitio web. También hemos añadido
55-
un enlace a [Overleaf](https://www.overleaf.com), uno de los servicios más
56-
populares de edición de LaTeX en línea. Pero no se preocupe, también podrá
57-
usar los ejemplos en su ordenador. Puede leer más, sobre cómo usar los ejemplos
58-
en [la página de ayuda](help).
59-
60-
Nuestros ejemplos están pensados para una instalación de LaTeX actualizada.
61-
Funcionan bien con nuestros dos sistemas de demostración en línea, con lo que
62-
si obtiene errores con los ejemplos disponibles, quizá deba verificar si su sistema
63-
de LaTeX está correctamente actualizado.
64-
65-
<h2
66-
class="heading__toc"
67-
id="toc"
68-
>Lecciones</h2>
69-
70-
<p
71-
class="paragraph__toc"
72-
>Al final de cada lección hemos añadido un enlace a una sección titulada <b>Más sobre este tema</b>. Aquí encontrará información detallada cuando necesite profudizar sobre un tema en particular, pero no es imprescindible consultarla si no lo necesita.
30+
<p class="paragraph__toc"> Hemos incluido una sección titulada <b>Más sobre este tema</b>, al final de cada lección. Aquí encontrará información detallada cuando necesite profudizar sobre un tema en particular, pero no es imprescindible consultarla si no lo necesita.</p>
7331

7432
{% include toc-lessons.html prefix="es/lesson" %}
7533

76-
<h2
77-
class="heading__toc"
78-
>Lecciones adicionales</h2>
79-
<ul
80-
class="lessons-toc">
34+
<h2 class="heading__toc">Lecciones adicionales</h2>
35+
<ul class="lessons-toc">
8136
{% include toc-additional-lessons.html prefix="es/language" %}
8237
{% include toc-additional-lessons.html prefix="es/extra" %}
8338
</ul>
8439

8540
## Para profundizar
8641

87-
Las lecciones específicas no cubren absolutamente todo lo que usted necesitará
88-
saber sobre LaTeX; pretenden enseñarle lo necesario para comenzar y _entender_ los
89-
ejemplos y consejos que se pueda encontrar. Abordamos cómo buscar más información
90-
en [la última lección](lesson-16), pero merece la pena decir que disponer
91-
de un libro sobre LaTeX es aún la mejor manera para profundizar. Le
92-
recomendaremos algunos en la última lección.
93-
94-
Por último, le ofrecemos una collección de pequeños ejemplos que muestran
95-
un abanico de diferentes áreas, que no se abordan en esta introducción,
96-
así como los diferentes paquetes de LaTeX asociados a estas áreas.
42+
La mejor manera de profundizar es consultando un libro. Abordamos cómo buscar más información
43+
en [la última lección](lesson-16), en la que le aconsejamos también algunos libros.

0 commit comments

Comments
 (0)