search

enriqueacosta / IllustrativeMath-GrupoLEMA

1 stars 4 forks source link

readme

IllustrativeMath-GrupoLEMA

Prototipo del material de Matemáticas Ilustrativas en versión Pretext.

Para generar versiones web(html), pdf, latex

Debe tener Pretext instalado, o puede iniciar un codespace directamente en este repositorio (los archivos de configuración del codespace se encargan de que Pretext esté instalado en el codespace).

Ejecutar los siguientes comandos desde la terminal (o la terminal del codespace en VSCode), en la carpeta principal (la que contiene este archivo y el archivo project.ptx).

Todos los archivosque se generan se guardan en la carpeta output/.

generar versiones del estudiante

Para generar la página web (gra3-uni4 significa grado3-unidad4):

pretext build gra3-uni4-web-est

Para ver localmente la página web:

pretext view gra3-uni4-web-est

Para generar el pdf:

pretext build gra3-uni4-print-est

Para generar el código latex que produce el pdf:

pretext build gra3-uni4-print-latex-est

generar versiones del profesor

Cambiar -est por -prof en todos los comandos.

Ambas versiones (estudiante y profesor) se generan a partir de los mismos archivos fuente. Los elementos que contienen component="profesor" solo son visibles en la versión del profesor.

Componentes en el código fuente

El en source, para crear un elemento que solo

Por ejemplo:

<objectives component="estudiante">
  <ul>
    <li>Exploremos las fichas de dos colores y los tableros de 5.</li>
  </ul>
</objectives>

<objectives component="profesor">
  <ul>
    <li>Usar fichas de dos colores y los tableros de 5.</li>
    <li>Parafrasear ideas matemáticas de un compañero.</li>
  </ul>
</objectives>

<ul>
  <li>fichas de dos colores</li>
  <li>tableros de 5 <url component="web" href="https://github.com/enriqueacosta/IllustrativeMath-GrupoLEMA/blob/main/external/blm/pdf-source/tableros-de-5.pdf">(ver pdf)</url></li>
</ul>

Ajustes globales

Preludios y postludios a las actividades en las guías del docente

Los comentarios para los profesores en las guías del docente para cada actividad se encuentran dentro de las tags <prelude> y <postlude>. Por defecto, todo lo que está en <prelude> aparece antes del enunciado, y todo lo que está en <postlude> aparece después del enunciado, pero esto se puede ajustar. Si se quiere que ambas aparezcan después del enunciado de la actividad, se debe cambiar el archivo pretext-html.xsl de PreTexT que determina como se produce la página web. Busque las líneas que incluyen el <prelude>

<!-- prelude beforehand, when original -->
<xsl:if test="$b-original">
    <xsl:apply-templates select="prelude">
        <xsl:with-param name="b-original" select="$b-original" />
    </xsl:apply-templates>
</xsl:if>

y muévalas justo antes del <postlude>. Se debe hacer lo mismo con el archivo pretext-latex.xsl para ajustar el orden en el que aparecen en el código latex que produce Pretext.

Generar archivos de imágenes

Las imágenes por lo general es mejor insertarlas sin extensión. Así;

<image source="svg-source/tikz-file-147472">
   <shortdescription>30 objetos en grupos de 5</shortdescription>
</image>

Cuando no se incluye la extensión, Pretext se encarga automáticamente de agregar la extensión .svg para las imágenes en la página web y la extensión .pdf para las imágenes para generar el pdf para impresión con LaTeX (en este caso, la página web buscaría la imagen tikz-file-147472.svg y latex buscaría la imagen tikz-file-147472.pdf). En particular, se deben tener todos los formatos necesarios para una misma imagen.

En el caso de las imágenes que son originalmente svg, la conversión a pdf es mejor hacerla con rsvg-convert usando el comando

rsvg-convert --format=pdf --zoom=1 tikz-file-147472.svg > tikz-file-147472.pdf

(el --zoom=1 es para tener la opción de cambiar el tamaño, pero normalmente debe ser 1)

Para instalar rsvg-convert en MacOS usar brew install librsvg con homebrew.

En la carpeta de scripts hay varios scripts para automatizar estas conversiones.

También se podría usar ImageMagick, pero la conversión de svg a pdf produce archivos muy grandes.

Si no se quiere usar como formato por defecto pdf para las imágenes en latex, se debe editar el archivo pretext-latex.xsl de la instalación de Pretext. Busque .pdf para encontrar las líneas que determinan la extensión que se le agrega a las imágenes:

<xsl:if test="$extension = ''">
    <xsl:text>.pdf</xsl:text>
</xsl:if>

Por ejemplo, si prefiere usar imágenes en png, cambie el .pdf a .png.

Imágenes nuevas con código Tikz

Este repositorio tiene su propia definición de tipo de documento de LaTeX para generar figuras con TikZ. Ver los archivos source/assets/tikz-source/LEMA-Tikz-IM.cls y source/assets/tikz-source/LEMA-Tikz-IM.sty. Esto habilita el \documentclass{LEMA-Tikz-IM} que tiene la opción de grado, como \documentclass[grado3]{LEMA-Tikz-IM} que ajusta la fuente de las imágenes de acuerdo al grado (la fuente debe ser mayor para los primeros grados). Por eso, es importante usar la unidad de medidad ex o em en las partes de estas imágenes TikZ que se deben adaptar al tamaño del texto (por ejemplo, los anchos de tablas, las distancias de las etiquetas a los objetos, etc).

Ver ejemplos de los archivos .tex de imagenes en la carpeta `souce/assets/tikz-source.

Para estas imágenes se debe generar el formato .pdf con pdfLaTeX, y el formato .svg para la web a partir del pdf que produce pdfLaTeX. Esto se puede hacer de manera automática con el script scripts/convertAllPDFtoSVGinFolder que se escribió para este fin.

Producir versiones pdf de los problemas de cierre -cool.ptx

Los problemas de cierre todos están en archivos *-cool.ptx. Para generar las versiones pdf imprimibles de estos archivos (para los estudiantes) se usa el script /scripts/createStandaloneCools. Este script toma todos los -cool.ptx de una carpeta y genera los pdf en ../assets/cools-pdf (o donde especifique la variable $outFolder en el script). Para correrlo, se debe copiar el archivo del script a la carpeta con los -cool.ptx que se quiere procesar y correr en la terminal con ./createStandaloneCools.

El diseño gráfico de estos pdf se especifica en el archivo /source/custom-xsl/pretext-latex-cool.xsl que determina el encabezado de LaTeX que genera los pdf.

Licencia

Mientras se descifran los detalles de copyright y licencias, este material es ©Enrique Acosta (enriqueacosta.github.io) y se publica bajo una licencia Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY NC SA 4.0). En breve e incompleto (los detalles están en las licencias), tiene toda libertad para adaptar, copiar y distribuir este material siempre y cuando no lo use para fines comerciales y le mantenga la misma licencia y dé la atribución correspondiente (mencione al Grupo LEMA(www.grupolema.org) y a Illustrative Mathematics) .

Ver una copia de la licencia en creativecommons.org.

Material de K-5 adaptado de IM K–5 Math v.I, © 2021 Illustrative Mathematics® illustrativemathematics.org en su versión en español en im.kendallhunt.com, distribuido con una licencia Creative Commons Attribution 4.0 International License (CC BY 4.0). Ver detalles de esta licencia en https://creativecommons.org/licenses/by/4.0/

El material de 6-8 es IM copyright © Open Up Resources openupresources.org y de autoría de Illustrative Mathematics® y tiene licencia Creative Commons Attribution 4.0 International License (CC BY 4.0).

Nota: Las traducciones anteriormente mencionadas fueron lideradas y coordinadas por miembros del Grupo LEMA. Ver detalles en: illustrativemathematics.org.