updates

docs/english/analyses/03_analyses.py

@@ -146,7 +146,7 @@ def toggle_hint():
         # Using a selectbox to let users choose between amounts of leptons
         st.markdown("## Number of leptons in the final state")
         st.markdown("In particle colliders, when a particle is produced, it can decay immediately to other particles, which are detected and analyzed. By identifying all the particles in the final state, we can infer what particles were initially created during the collision. One example is the number of leptons in the final state, as different processes produce different numbers of leptons.")
-        st.markdown("Below is a Feynman diagram showing a typical process that results in a final state with two leptons:")
+        st.markdown("Below is a [Feynman diagram](https://cds.cern.ch/record/2791333/files/Feynman%20Diagrams%20-%20ATLAS%20Physics%20Cheat%20Sheet%20in%20Spanish%20%7C%20Diagramas%20de%20Feynman.pdf) showing a typical process that results in a final state with two leptons:")
         # Diagram for Z decay
         image_zdecay = f"images/Z_decay_{theme['base']}.png"
         # Encode the image in base64
@@ -263,7 +263,7 @@ def toggle_hint():
                 st.error("Incorrect. Try thinking about how leptons are produced in pairs.")
 
         st.markdown("## Let's ensure conservation")
-        st.markdown("In particle interactions, certain properties are always conserved, such as *charge* and lepton *flavor*. Understanding these conservation laws helps narrow down the possibilities for what particles are involved in the final state.")
+        st.markdown("In particle interactions, [certain properties are always conserved](https://cds.cern.ch/record/2759491/files/Conservation%20Laws%20-%20ATLAS%20Physics%20Cheat%20Sheet.pdf), such as *charge* and lepton *flavor*. Understanding these conservation laws helps narrow down the possibilities for what particles are involved in the final state.")
         st.markdown("In your analysis, you can look at the flavor of the leptons (whether they are electrons or muons) and their charge (positive or negative). The particles with opposite charge are called antiparticles, a positive electron is called positron and a positive muon is called anti-muon. The plot below shows the distribution of lepton flavors, with one bar for positively charged and one for negatively charged leptons. This helps identify whether the final state obeys conservation laws.")
 
         # Display the pre-generated plot based on the theme

docs/english/experimental/03_ATLAS.md

@@ -1,5 +1,5 @@
 # The ATLAS Experiment
-The ATLAS detector at CERN is designed to observe the products of particle collisions in the Large Hadron Collider (LHC). Standing at 25 meters tall and 46 meters long, it consists of multiple layers, each serving a specific purpose in detecting particles produced during high-energy collisions. The layers are arranged like the rings of an onion, each capturing different types of particles and measuring unique properties.
+The [ATLAS detector](http://cds.cern.ch/record/2759657/files/Detector%20Overview.pdf) at CERN is designed to observe the products of particle collisions in the Large Hadron Collider (LHC). Standing at 25 meters tall and 46 meters long, it consists of multiple layers, each serving a specific purpose in detecting particles produced during high-energy collisions. The layers are arranged like the rings of an onion, each capturing different types of particles and measuring unique properties.
 
 ![Image 1: The ATLAS detector and its parts.](images/ATLAS_detector.png)
 
@@ -9,16 +9,16 @@ Below is an illustration of the ATLAS detector’s layered structure and how var
 ![Image 2: Cross-sectional view of the ATLAS detector, detailing each layer and showing how various particles are detected as they pass through.](images/detector_signals.png)
 
 ### Inner Detector
-Located closest to the collision point, the Inner Detector tracks the paths of charged particles. A magnetic field causes charged particles to follow curved paths, and the degree of curvature helps determine their momentum and charge. The Inner Detector is used for for identifying particles like electrons, positrons, and charged hadrons.
+Located closest to the collision point, the [Inner Detector](http://cds.cern.ch/record/2759658/files/The%20Inner%20Detector.pdf) tracks the paths of charged particles. A magnetic field causes charged particles to follow curved paths, and the degree of curvature helps determine their momentum and charge. The Inner Detector is used for for identifying particles like electrons, positrons, and charged hadrons.
 
 ### Electromagnetic Calorimeter
-The next layer is the Electromagnetic Calorimeter, which measures the energy of particles that interact electromagnetically, such as electrons and photons. When these particles enter the calorimeter, they produce a shower of secondary particles that deposit energy in the detector, allowing the calorimeter to measure their total energy.
+The next layer is the [Electromagnetic Calorimeter](http://cds.cern.ch/record/2759659/files/Calorimeters.pdf), which measures the energy of particles that interact electromagnetically, such as electrons and photons. When these particles enter the calorimeter, they produce a shower of secondary particles that deposit energy in the detector, allowing the calorimeter to measure their total energy.
 
 ### Hadronic Calorimeter
-Beyond the electromagnetic calorimeter lies the Hadronic Calorimeter, which measures the energy of particles that interact through the strong nuclear force, such as protons, neutrons, and other hadrons. This layer captures energy by absorbing the hadrons and creating a cascade of particles that the detector can measure.
+Beyond the electromagnetic calorimeter lies the [Hadronic Calorimeter](http://cds.cern.ch/record/2759659/files/Calorimeters.pdf), which measures the energy of particles that interact through the strong nuclear force, such as protons, neutrons, and other hadrons. This layer captures energy by absorbing the hadrons and creating a cascade of particles that the detector can measure.
 
 ### Muon Spectrometer
-The outermost layer of the ATLAS detector, the Muon Spectrometer, is specifically designed to detect muons. Unlike other particles, muons can pass through the inner detector layers and the calorimeters without losing much energy. This layer allows ATLAS to track muons accurately.
+The outermost layer of the ATLAS detector, the [Muon Spectrometer](http://cds.cern.ch/record/2759662/files/Muon%20Spectrometer.pdf), is specifically designed to detect muons. Unlike other particles, muons can pass through the inner detector layers and the calorimeters without losing much energy. This layer allows ATLAS to track muons accurately.
 
 ## Particle Signals in ATLAS
 Different particles leave distinct signals as they move through the ATLAS detector as shown in image 1:

docs/english/foundations/03_higgs.md

@@ -1,5 +1,5 @@
 # The Higgs Boson
-The Higgs boson is a fundamental particle that plays a crucial role in giving mass to other particles. Discovered in 2012 by the ATLAS and CMS experiments at CERN’s Large Hadron Collider (LHC), its existence confirmed a vital part of the Standard Model. But what exactly makes it so important?
+The [Higgs boson](http://cds.cern.ch/record/2775211/files/Higgs_Boson.pdf?version=1) is a fundamental particle that plays a crucial role in giving mass to other particles. Discovered in 2012 by the ATLAS and CMS experiments at CERN’s Large Hadron Collider (LHC), its existence confirmed a vital part of the Standard Model. But what exactly makes it so important?
 
 ## The Higgs Field and Mass
 To understand the Higgs boson, we first need to introduce the Higgs field. Imagine the Higgs field as an invisible energy field that fills the entire universe, similar to how water fills an ocean. Particles interact with this field as they move through it, and this interaction slows them down, giving them mass. The stronger a particle’s interaction with the Higgs field, the more mass it gains. Some particles, like photons, don’t interact with the Higgs field at all, which is why they remain massless and can travel at the speed of light.

docs/spanish/analyses/03_analyses.py

@@ -143,7 +143,7 @@ def toggle_hint():
         # Using a selectbox to let users choose between amounts of leptons
         st.markdown("## Número de leptones en el estado final")
         st.markdown("En los colisionadores de partículas, cuando se produce una partícula, puede decaer inmediatamente en otras partículas, que se detectan y analizan. Al identificar todas las partículas en el estado final, podemos inferir qué partículas se crearon inicialmente durante la colisión. Un ejemplo es el número de leptones en el estado final, ya que diferentes procesos producen diferentes cantidades de leptones.")
-        st.markdown("Below is a Feynman diagram showing a typical process that results in a final state with two leptons:")
+        st.markdown("A continuación se muestra un diagrama de Feynman que muestra un proceso típico que da como resultado un estado final con dos leptones:")
         # Diagram for Z decay
         image_zdecay = f"images/Z_decay_{theme['base']}.png"
         # Encode the image in base64
@@ -215,7 +215,7 @@ def toggle_hint():
                         Los pares de leptones son comunes en muchas interacciones de partículas, especialmente cuando se consideran intermediarios neutros""")
         elif n_leptons == 4:
             st.success("""Estás viendo **4 leptones** en el estado final.
-                        Esto a menudo indica una cadena de decaimientos, donde múltiples partículas intermedias decae a pares de leptones.
+                        Esto a menudo indica una cadena de decaimientos, donde múltiples partículas intermedias decaen a pares de leptones.
                         Estos escenarios son interesantes para estudiar interacciones complejas""")
         elif n_leptons != '--':
             st.warning("""Tener un número impar de leptones es inusual en procesos de desintegración simples, ya que los leptones suelen producirse en pares debido a las leyes de conservación.
@@ -259,7 +259,7 @@ def toggle_hint():
                 st.error("Incorrecto. Intenta pensar en cómo se producen los leptones en pares.")
 
         st.markdown("## Garanticemos la conservación")
-        st.markdown("En las interacciones entre partículas, ciertas propiedades siempre se conservan, como la *carga* y el *sabor* leptónico. Comprender estas leyes de conservación ayuda a reducir las posibilidades de las partículas que están involucradas en el estado final.")
+        st.markdown("En las interacciones entre partículas, [ciertas propiedades siempre se conservan](https://cds.cern.ch/record/2791335/files/Conservation%20Laws%20-%20ATLAS%20Physics%20Cheat%20Sheet%20in%20Spanish%20%7C%20Leyes%20de%20Conservación.pdf), como la *carga* y el *sabor* leptónico. Comprender estas leyes de conservación ayuda a reducir las posibilidades de las partículas que están involucradas en el estado final.")
         st.markdown("En tu análisis, puedes ver el 'sabor' de los leptones (es decir, si son electrones o muones) y su carga (positiva o negativa). Las partículas con carga opuesta se llaman antipartículas, un electron positivo se llama positron y un muón positivo, anti-muón. El plot siguiente muestra la distribución del sabor de los leptones, con una barra para leptones cargados positivamente y otra para leptones cargados negativamente. Esto ayuda a identificar si el estado final obedece reglas de conservación.")
 
         # Display the pre-generated plot based on the theme

docs/spanish/experimental/03_ATLAS.md

@@ -1,5 +1,5 @@
 # El experimento ATLAS
-El detector ATLAS del CERN está diseñado para observar los productos de las colisiones de partículas en el Gran Colisionador de Hadrones (LHC). Con 25 metros de alto y 46 metros de largo, está formado por varias capas, donde cada una cumple una función específica: detectar partículas producidas durante colisiones de alta energía. Las capas están dispuestas como los anillos de una cebolla, cada una de las cuales captura distintos tipos de partículas y mide propiedades únicas.
+El [detector ATLAS](http://cds.cern.ch/record/2775035/files/Información%20general%20del%20detector.pdf) del CERN está diseñado para observar los productos de las colisiones de partículas en el Gran Colisionador de Hadrones (LHC). Con 25 metros de alto y 46 metros de largo, está formado por varias capas, donde cada una cumple una función específica: detectar partículas producidas durante colisiones de alta energía. Las capas están dispuestas como los anillos de una cebolla, cada una de las cuales captura distintos tipos de partículas y mide propiedades únicas.
 
 ![Imagen 1: El detector ATLAS y sus partes.](images/ATLAS_detector_spanish.png)
 
@@ -9,16 +9,16 @@ A continuación se muestra una ilustración de la estructura en capas del detect
 ![Imagen 2: Vista en sección transversal del detector ATLAS, que detalla cada capa y muestra cómo se detectan las distintas partículas a medida que pasan por ella.](images/detector_signals.png)
 
 ### Detector interno de trazas
-El detector interno, ubicado más cerca del punto de colisión, registra las trayectorias de las partículas cargadas. Un campo magnético hace que las partículas cargadas sigan trayectorias curvas. El grado de curvatura ayuda a determinar su momento, y la dirección su carga. El detector interno se utiliza para identificar partículas como electrones, positrones y hadrones cargados.
+El [detector interno](http://cds.cern.ch/record/2775036/files/El%20detector%20interno.pdf), ubicado más cerca del punto de colisión, registra las trayectorias de las partículas cargadas. Un campo magnético hace que las partículas cargadas sigan trayectorias curvas. El grado de curvatura ayuda a determinar su momento, y la dirección su carga. El detector interno se utiliza para identificar partículas como electrones, positrones y hadrones cargados.
 
 ### Calorímetro electromagnético
-La siguiente capa es el calorímetro electromagnético, que mide la energía de las partículas que interactúan electromagnéticamente, como los electrones y los fotones. Cuando estas partículas entran en el calorímetro, producen una cascada de partículas secundarias que depositan energía en el detector, lo que permite que el calorímetro mida su energía total.
+La siguiente capa es el [calorímetro electromagnético](http://cds.cern.ch/record/2775040/files/Calorímetros.pdf), que mide la energía de las partículas que interactúan electromagnéticamente, como los electrones y los fotones. Cuando estas partículas entran en el calorímetro, producen una cascada de partículas secundarias que depositan energía en el detector, lo que permite que el calorímetro mida su energía total.
 
 ### Calorímetro hadrónico
-Más allá del calorímetro electromagnético se encuentra el calorímetro hadrónico, que mide la energía de las partículas que interactúan a través de la fuerza nuclear fuerte, como los protones, los neutrones y otros hadrones. Esta capa captura la energía absorbiendo los hadrones y creando una cascada de partículas que el detector puede medir.
+Más allá del calorímetro electromagnético se encuentra el [calorímetro hadrónico](http://cds.cern.ch/record/2775040/files/Calorímetros.pdf), que mide la energía de las partículas que interactúan a través de la fuerza nuclear fuerte, como los protones, los neutrones y otros hadrones. Esta capa captura la energía absorbiendo los hadrones y creando una cascada de partículas que el detector puede medir.
 
 ### Espectrómetro de muones
-La capa más externa del detector ATLAS, el espectrómetro de muones, está diseñada específicamente para detectar muones. A diferencia de otras partículas, los muones pueden pasar a través de las capas internas del detector y los calorímetros sin perder mucha energía. Esta capa permite a ATLAS rastrear los muones con precisión.
+La capa más externa del detector ATLAS, el [espectrómetro de muones](http://cds.cern.ch/record/2775038/files/Espectrómetro%20de%20muones.pdf), está diseñada específicamente para detectar muones. A diferencia de otras partículas, los muones pueden pasar a través de las capas internas del detector y los calorímetros sin perder mucha energía. Esta capa permite a ATLAS rastrear los muones con precisión.
 
 ## Señales de partículas en ATLAS
 Las distintas partículas dejan señales distintivas a medida que pasan por el detector ATLAS, como se muestra en la imagen 1:

docs/spanish/foundations/03_higgs.md

@@ -1,5 +1,5 @@
 # El bosón de Higgs
-El bosón de Higgs es una partícula fundamental que desempeña un papel fundamental en el origen de la masa de las partículas. Descubierto en 2012 por los experimentos ATLAS y CMS en el Gran Colisionador de Hadrones (LHC) del CERN, su existencia confirmó una parte esencial del Modelo Estándar. Pero, ¿qué es exactamente lo que lo hace tan importante?
+El [bosón de Higgs](http://cds.cern.ch/record/2813709/files/El%20Bosón%20de%20Higgs.pdf) es una partícula fundamental que desempeña un papel fundamental en el origen de la masa de las partículas. Descubierto en 2012 por los experimentos ATLAS y CMS en el Gran Colisionador de Hadrones (LHC) del CERN, su existencia confirmó una parte esencial del Modelo Estándar. Pero, ¿qué es exactamente lo que lo hace tan importante?
 
 ## El campo de Higgs y la masa
 Para entender el bosón de Higgs, primero debemos presentar el campo de Higgs. Imaginemos el campo de Higgs como un campo de energía invisible que llena todo el universo, de forma similar a cómo el agua llena un océano. Las partículas interactúan con este campo a medida que se mueven a través de él, y esta interacción las ralentiza, lo que les da masa. Cuanto más fuerte es la interacción de una partícula con el campo de Higgs, más masa gana. Algunas partículas, como los fotones, no interactúan en absoluto con el campo de Higgs, por lo que permanecen sin masa y pueden viajar a la velocidad de la luz.