Skip to content

Latest commit

 

History

History
139 lines (83 loc) · 6.43 KB

README.md

File metadata and controls

139 lines (83 loc) · 6.43 KB

Repositorio de fórmulas en LaTeX

Este repositorio pretende ser un compendio de fórmulas en LaTeX que puedan ser reutilizadas, sin necesidad de buscar en todo internet o de reescribir las fórmulas cada que se necesiten.

No se tiene como objetivo ser un apunte en el que se profundize sobre las fórmulas.

Contenidos

Important

Para contribuir, por favor lee la guía de contribución en CONTRIBUTING.md.

Estructura del repositorio

Note

Es muy probable que la información de esta sección se mueva a CONTRIBUTING.md, ya que el README debería estar enfocado más en el uso del repositorio. Si tienes alguna sugerencia, por favor abre un issue.

Usaremos el término formulario para referirnos a cualquier archivo markdown (.md) que contenga fórmulas en LaTeX.

Actualmente los formularios se encuentran en la carpeta formularios.

Organización de un formulario

TL;DR: En la siguiente sección se explica a detalle y con ejemplos cómo se organiza un formulario. Si prefieres omitir la explicación y ver directamente un ejemplo, el formulario "Transformada de Fourier" es excelente para ver toda la estructura de un formulario.

Un formulario se compone de tres secciones:

  1. Frontmatter

  2. Fórmulas

  3. Temas relacionados (todo)

Ejemplo de un formulario
---
title: Series de Fourier
---

# Fórmulas

### Serie de Fourier trigonométrica

\[ f(t) = \frac{a*0}{2} + \sum*{n=1}^{\infty} \left( a_n \cos \left( \frac{2\pi n t}{T} \right) + b_n \sin \left( \frac{2\pi n t}{T} \right) \right) \]

# Temas relacionados

- [Transformada de Fourier](Transformada%20de%20Fourier.md)

Frontmatter

El Frontmatter, que es la sección entre dos --- en la que se pueden poner metadatos en un archivo Markdown, se incluirán metadatos del formulario.

Hasta ahora se tiene planeado incluir los siguientes campos:

  • title: Título del formulario. De momento no tiene ninguna función, pero se planea usarlo para generar los índices de áreas (ver Generación de índices).

Fórmulas

Esta sección contendrá las fórmulas en LaTeX. Se iniciará con un título de nivel 1 (# Fórmulas) y se organizarán las fórmulas por subtema de nivel 2 (## Subtema 1, ## Subtema 2, etc.).

Dentro de cada subtema se pondrán las fórmulas, empezando con un título de nivel 3 (### Fórmula 1, ### Fórmula 2, etc.) y la fórmula en LaTeX (para aquellas fórmulas que no necesiten subtema se podrán incluir inmediatamente después del título # Fórmulas).

Opcionalmente se pueden incluir referencias, para lo cual se pondrá un título de nivel 6 al final de la fórmula (###### Referencias) y dentro las referencias (se recomienda citar en APA para mantener un estilo, pero no es estrictamente necesario). Para aquellas referencias que sirvan para todas o la mayoría de las fórmulas de un subtema se podrá poner el título de nivel 6 antes de las fórmulas.

Ejemplo de fórmulas

El formulario de Transformada de Fourier es un muy buen ejemplo de la organización de fórmulas y, en general, de la estructura para un formulario.

# Fórmulas

## Subtema 1

###### Referencias ------- (Referencias para todas las fórmulas de este subtema)

- [Wikipedia](https://es.wikipedia.org/wiki/Serie_de_Fourier)

### Fórmula con referencias únicas

$$
f(t) = \frac{a*0}{2} + \sum*{n=1}^{\infty} \left( a_n \cos \left( \frac{2\pi n t}{T} \right) + b_n \sin \left( \frac{2\pi n t}{T} \right) \right)
$$

###### Referencias ------- (Referencias para esta fórmula)

- [Wikipedia](https://es.wikipedia.org/wiki/Serie_de_Fourier)

### Fórmula sin referencias únicas

$$
a_n = \frac{2}{T} \int_{0}^{T} f(t) \cos \left( \frac{2\pi n t}{T} \right) \, dt
$$

Nota: este formato puede cambiar en el futuro si es necesario.

Important

Para las fórmulas se podrá usar el formato estándar de LaTeX $$ $$, aunque se recomienda usar el bloque de código math.
En caso de que existan problemas de renderizado con la sintaxis de LaTeX, será obligatorio usar el bloque de código math con el objetivo de mantener la compatibilidad, ya que es la implementación más estable y compatible del GitHub Flavored Markdown con la sintáxis de LaTeX.
En esta discusión se da una breve razón (no oficial) del porque la incompatibilidad y en esta otra se pide que lo arreglen.

Temas relacionados

TODO Aquí se pondrá una explicación de cómo se estructuran los temas relacionados en un formulario y su objetivo.

Planes futuros

Generación de índices

Se planea compilar los formularios para generar índices de cada área. En el índice se enlazarán los formularios del área, mostrando el título del formulario (en caso de no estar definido se usará el nombre del archivo enlazado).

Las áreas a las que pertenece un formulario se definiran en la sección # Áreas, la cual contendrá una lista como se muestra:

# Áreas

- [Área 1]
- [Área 2]
Explicación de los enlaces

La notación anterior [Área 1] es para un enlace con estilo de referencia (más información aquí), en principio no es necesario agregar el estilo de referencia, ya que al compilar los formularios se añadirá y si ya se encuentra se quitará y se reemplazará por el enlace correcto.

Cambio de variables

Opción para cambiar las variables de las fórmulas, por ejemplo, cambiar t por x en todas las fórmulas de un formulario o de forma más compleja un conjunto a otro. Por ejemplo en el formulario de las Series de Fourier poder escoger entre usar la frecuencia angular, la frecuencia o el periodo:

$$ n\omega_0=\frac{2\pi n}{T} = 2\pi nf $$