@learnpack/learnpack 5.0.275 → 5.0.277

package/src/utils/sidebarGenerator.ts

@@ -1,195 +1,195 @@
-import path = require("path")
-
-import Console from "./console"
-import fs = require("fs")
-import { IExercise, IExerciseData } from "../models/exercise-obj"
-import { IConfigObj } from "../models/config"
-import SessionManager from "../managers/session"
-import { fillSidebarJSON } from "./rigoActions"
-
-type TTitleTranslations = {
-  [key: string]: string
-}
-
-export type TSidebar = {
-  [key: string]: TTitleTranslations
-}
-
-export const generateSidebar = (exercises: IExercise[], learnPath: string) => {
-  const sidebarPath = path.join(learnPath, "sidebar.json")
-  let sidebar: TSidebar = {}
-  if (fs.existsSync(sidebarPath)) {
-    sidebar = JSON.parse(fs.readFileSync(sidebarPath, "utf8"))
-  }
-
-  for (const exercise of exercises) {
-    sidebar[exercise.slug] = {
-      ...sidebar[exercise.slug],
-      us: exercise.title,
-    }
-  }
-
-  fs.writeFileSync(sidebarPath, JSON.stringify(sidebar, null, 2))
-
-  return sidebar
-}
-
-export const addExerciseToSidebar = (
-  exerciseSlug: string,
-  targetLanguage: string,
-  translatedSlug: string,
-  learnPath: string
-) => {
-  const sidebarPath = path.join(learnPath, "sidebar.json")
-  let sidebar: TSidebar = {}
-  if (fs.existsSync(sidebarPath)) {
-    sidebar = JSON.parse(fs.readFileSync(sidebarPath, "utf8"))
-  }
-
-  sidebar[exerciseSlug] = {
-    ...sidebar[exerciseSlug],
-    [targetLanguage]: translatedSlug,
-  }
-
-  fs.writeFileSync(sidebarPath, JSON.stringify(sidebar, null, 2))
-
-  return sidebar
-}
-
-export const checkAndFixSidebar = async (
-  configObj: IConfigObj,
-  autoFix = false
-): Promise<boolean> => {
-  if (
-    configObj.config &&
-    fs.existsSync(configObj.config.dirPath + "/sidebar.json")
-  ) {
-    let hasErrors = false
-    const sidebar = fs.readFileSync(
-      configObj.config.dirPath + "/sidebar.json",
-      "utf8"
-    )
-    // parse the sidebar.json file
-    const sidebarJson = JSON.parse(sidebar)
-
-    const exerciseTranslations: Set<string> = new Set()
-    configObj.exercises?.map(e =>
-      // eslint-disable-next-line
-      Object.keys((e.translations || {}) as any).forEach((t) =>
-        exerciseTranslations.add(t)
-      )
-    )
-    // Validation
-    for (const [key, value] of Object.entries(sidebarJson) as [
-      string,
-      TTitleTranslations
-    ][]) {
-      for (const lang of exerciseTranslations) {
-        if (!Object.prototype.hasOwnProperty.call(value, lang)) {
-          hasErrors = true
-        }
-      }
-    }
-
-    if (hasErrors && autoFix) {
-      Console.warning("Filling sidebar.json file with missing translations")
-      const sessionPayload = await SessionManager.getPayload()
-
-      const rigoToken = sessionPayload.rigobot.key
-
-      if (!rigoToken) {
-        Console.error("No Rigobot token found, please login first!")
-        return false
-      }
-
-      const response = await fillSidebarJSON(rigoToken, {
-        needed_translations: JSON.stringify(exerciseTranslations),
-        sidebar_json: JSON.stringify(sidebarJson),
-      })
-
-      const newSidebarJson = JSON.parse(response.parsed.new_sidebar_file)
-      fs.writeFileSync(
-        configObj.config.dirPath + "/sidebar.json",
-        JSON.stringify(newSidebarJson, null, 4)
-      )
-      Console.info("Sidebar.json was filled with missing translations")
-      return true
-    }
-
-    if (hasErrors && !autoFix) {
-      return false
-    }
-
-    return true
-  }
-
-  return false
-}
-
-export const checkAndFixSidebarPure = async (
-  sidebarJson: Record<string, Record<string, string>>,
-  exercises: any[],
-  rigoToken: string,
-  autoFix = true
-): Promise<{
-  valid: boolean
-  fixedSidebar?: Record<string, Record<string, string>>
-}> => {
-  const exerciseTranslations: Set<string> = new Set()
-  for (const e of exercises) {
-    for (const lang of Object.keys(e.translations || {})) {
-      exerciseTranslations.add(lang)
-    }
-  }
-
-  let hasErrors = false
-  const fixedSidebar: Record<string, Record<string, string>> = {
-    ...sidebarJson,
-  }
-
-  for (const exercise of exercises) {
-    const slug = exercise.slug
-    const existingEntry = fixedSidebar[slug]
-
-    if (!existingEntry) {
-      hasErrors = true
-      fixedSidebar[slug] = { us: exercise.slug }
-      continue
-    }
-
-    for (const lang of exerciseTranslations) {
-      if (!Object.prototype.hasOwnProperty.call(existingEntry, lang)) {
-        hasErrors = true
-      }
-    }
-  }
-
-  if (hasErrors && autoFix) {
-    if (!rigoToken) {
-      Console.error("No Rigobot token provided!")
-      return { valid: false }
-    }
-
-    Console.warning(
-      "Filling sidebar JSON with missing translations or exercises"
-    )
-
-    const response = await fillSidebarJSON(rigoToken, {
-      needed_translations: JSON.stringify([...exerciseTranslations]),
-      sidebar_json: JSON.stringify(fixedSidebar),
-    })
-
-    const newSidebarJson = JSON.parse(response.parsed.new_sidebar_file)
-
-    Console.info("Sidebar JSON was fixed")
-    return {
-      valid: true,
-      fixedSidebar: newSidebarJson,
-    }
-  }
-
-  return {
-    valid: !hasErrors,
-    fixedSidebar: hasErrors ? fixedSidebar : undefined,
-  }
-}
+import path = require("path")
+
+import Console from "./console"
+import fs = require("fs")
+import { IExercise, IExerciseData } from "../models/exercise-obj"
+import { IConfigObj } from "../models/config"
+import SessionManager from "../managers/session"
+import { fillSidebarJSON } from "./rigoActions"
+
+type TTitleTranslations = {
+  [key: string]: string
+}
+
+export type TSidebar = {
+  [key: string]: TTitleTranslations
+}
+
+export const generateSidebar = (exercises: IExercise[], learnPath: string) => {
+  const sidebarPath = path.join(learnPath, "sidebar.json")
+  let sidebar: TSidebar = {}
+  if (fs.existsSync(sidebarPath)) {
+    sidebar = JSON.parse(fs.readFileSync(sidebarPath, "utf8"))
+  }
+
+  for (const exercise of exercises) {
+    sidebar[exercise.slug] = {
+      ...sidebar[exercise.slug],
+      us: exercise.title,
+    }
+  }
+
+  fs.writeFileSync(sidebarPath, JSON.stringify(sidebar, null, 2))
+
+  return sidebar
+}
+
+export const addExerciseToSidebar = (
+  exerciseSlug: string,
+  targetLanguage: string,
+  translatedSlug: string,
+  learnPath: string
+) => {
+  const sidebarPath = path.join(learnPath, "sidebar.json")
+  let sidebar: TSidebar = {}
+  if (fs.existsSync(sidebarPath)) {
+    sidebar = JSON.parse(fs.readFileSync(sidebarPath, "utf8"))
+  }
+
+  sidebar[exerciseSlug] = {
+    ...sidebar[exerciseSlug],
+    [targetLanguage]: translatedSlug,
+  }
+
+  fs.writeFileSync(sidebarPath, JSON.stringify(sidebar, null, 2))
+
+  return sidebar
+}
+
+export const checkAndFixSidebar = async (
+  configObj: IConfigObj,
+  autoFix = false
+): Promise<boolean> => {
+  if (
+    configObj.config &&
+    fs.existsSync(configObj.config.dirPath + "/sidebar.json")
+  ) {
+    let hasErrors = false
+    const sidebar = fs.readFileSync(
+      configObj.config.dirPath + "/sidebar.json",
+      "utf8"
+    )
+    // parse the sidebar.json file
+    const sidebarJson = JSON.parse(sidebar)
+
+    const exerciseTranslations: Set<string> = new Set()
+    configObj.exercises?.map(e =>
+      // eslint-disable-next-line
+      Object.keys((e.translations || {}) as any).forEach((t) =>
+        exerciseTranslations.add(t)
+      )
+    )
+    // Validation
+    for (const [key, value] of Object.entries(sidebarJson) as [
+      string,
+      TTitleTranslations
+    ][]) {
+      for (const lang of exerciseTranslations) {
+        if (!Object.prototype.hasOwnProperty.call(value, lang)) {
+          hasErrors = true
+        }
+      }
+    }
+
+    if (hasErrors && autoFix) {
+      Console.warning("Filling sidebar.json file with missing translations")
+      const sessionPayload = await SessionManager.getPayload()
+
+      const rigoToken = sessionPayload.rigobot.key
+
+      if (!rigoToken) {
+        Console.error("No Rigobot token found, please login first!")
+        return false
+      }
+
+      const response = await fillSidebarJSON(rigoToken, {
+        needed_translations: JSON.stringify(exerciseTranslations),
+        sidebar_json: JSON.stringify(sidebarJson),
+      })
+
+      const newSidebarJson = JSON.parse(response.parsed.new_sidebar_file)
+      fs.writeFileSync(
+        configObj.config.dirPath + "/sidebar.json",
+        JSON.stringify(newSidebarJson, null, 4)
+      )
+      Console.info("Sidebar.json was filled with missing translations")
+      return true
+    }
+
+    if (hasErrors && !autoFix) {
+      return false
+    }
+
+    return true
+  }
+
+  return false
+}
+
+export const checkAndFixSidebarPure = async (
+  sidebarJson: Record<string, Record<string, string>>,
+  exercises: any[],
+  rigoToken: string,
+  autoFix = true
+): Promise<{
+  valid: boolean
+  fixedSidebar?: Record<string, Record<string, string>>
+}> => {
+  const exerciseTranslations: Set<string> = new Set()
+  for (const e of exercises) {
+    for (const lang of Object.keys(e.translations || {})) {
+      exerciseTranslations.add(lang)
+    }
+  }
+
+  let hasErrors = false
+  const fixedSidebar: Record<string, Record<string, string>> = {
+    ...sidebarJson,
+  }
+
+  for (const exercise of exercises) {
+    const slug = exercise.slug
+    const existingEntry = fixedSidebar[slug]
+
+    if (!existingEntry) {
+      hasErrors = true
+      fixedSidebar[slug] = { us: exercise.slug }
+      continue
+    }
+
+    for (const lang of exerciseTranslations) {
+      if (!Object.prototype.hasOwnProperty.call(existingEntry, lang)) {
+        hasErrors = true
+      }
+    }
+  }
+
+  if (hasErrors && autoFix) {
+    if (!rigoToken) {
+      Console.error("No Rigobot token provided!")
+      return { valid: false }
+    }
+
+    Console.warning(
+      "Filling sidebar JSON with missing translations or exercises"
+    )
+
+    const response = await fillSidebarJSON(rigoToken, {
+      needed_translations: JSON.stringify([...exerciseTranslations]),
+      sidebar_json: JSON.stringify(fixedSidebar),
+    })
+
+    const newSidebarJson = JSON.parse(response.parsed.new_sidebar_file)
+
+    Console.info("Sidebar JSON was fixed")
+    return {
+      valid: true,
+      fixedSidebar: newSidebarJson,
+    }
+  }
+
+  return {
+    valid: !hasErrors,
+    fixedSidebar: hasErrors ? fixedSidebar : undefined,
+  }
+}

package/src/utils/templates/epub/epub.css

@@ -0,0 +1,133 @@
+/* Basic EPUB styling */
+body {
+  font-family: "Georgia", serif;
+  line-height: 1.6;
+  margin: 2em;
+  color: #333;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  color: #2c3e50;
+  margin-top: 1.5em;
+  margin-bottom: 0.5em;
+}
+
+h1 {
+  font-size: 2em;
+  border-bottom: 2px solid #3498db;
+  padding-bottom: 0.3em;
+}
+
+h2 {
+  font-size: 1.5em;
+  border-bottom: 1px solid #bdc3c7;
+  padding-bottom: 0.2em;
+}
+
+p {
+  margin-bottom: 1em;
+  text-align: justify;
+}
+
+code {
+  background-color: #f8f9fa;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-family: "Courier New", monospace;
+  font-size: 0.9em;
+}
+
+pre {
+  background-color: #f8f9fa;
+  padding: 1em;
+  border-radius: 5px;
+  overflow-x: auto;
+  border-left: 4px solid #3498db;
+}
+
+pre code {
+  background-color: transparent;
+  padding: 0;
+}
+
+blockquote {
+  border-left: 4px solid #bdc3c7;
+  margin: 1em 0;
+  padding-left: 1em;
+  font-style: italic;
+  color: #7f8c8d;
+}
+
+ul,
+ol {
+  margin-bottom: 1em;
+  padding-left: 2em;
+}
+
+li {
+  margin-bottom: 0.5em;
+}
+
+a {
+  color: #3498db;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+img {
+  max-width: 100%;
+  height: auto;
+  display: block;
+  margin: 1em auto;
+}
+
+table {
+  border-collapse: collapse;
+  width: 100%;
+  margin: 1em 0;
+}
+
+th,
+td {
+  border: 1px solid #ddd;
+  padding: 8px;
+  text-align: left;
+}
+
+th {
+  background-color: #f2f2f2;
+  font-weight: bold;
+}
+
+#toc {
+  background-color: #f8f9fa;
+  padding: 1em;
+  border-radius: 5px;
+  margin-bottom: 2em;
+}
+
+#toc h2 {
+  border-bottom: none;
+  margin-top: 0;
+}
+
+#toc ol {
+  padding-left: 1em;
+}
+
+#toc li {
+  margin-bottom: 0.3em;
+}
+
+#toc a {
+  color: #2c3e50;
+  font-weight: 500;
+}

package/src/utils/templates/isolated/exercises/01-hello-world/README.es.md

@@ -1,26 +1,26 @@
-# `01` Primer Ejercicio
-
-Hemos creado este primer ejercicio como ejemplo. Lo puedes ubicar en la carpeta `./01-hello-world`.
-
-1. Cada ejercicio debe estar ubicado en carpetas separadas y debe tener un archivo README.md con las instrucciones del ejercicio escrito en markdown.
-2. Puedes tener un archivo README el cual será como una página de un libro, sin archivos de código.
-3. También puedes agregar un archivo `README.[lenguaje].md` para traducciones, por ejemplo `README.es.md` para español.
-
-## Inserta videos
-
-Si quieres incluir algún video introductorio para cada ejercicio, agrega la propiedad `intro` en el inicio del README.md para ese ejercicio en particular:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
-
-Tambien puedes agregar un video explicando la solución para cada ejercicio agregando la propiedad `tutorial` al inicio del markdown del README.md correspondiente:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
-tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
+# `01` Primer Ejercicio
+
+Hemos creado este primer ejercicio como ejemplo. Lo puedes ubicar en la carpeta `./01-hello-world`.
+
+1. Cada ejercicio debe estar ubicado en carpetas separadas y debe tener un archivo README.md con las instrucciones del ejercicio escrito en markdown.
+2. Puedes tener un archivo README el cual será como una página de un libro, sin archivos de código.
+3. También puedes agregar un archivo `README.[lenguaje].md` para traducciones, por ejemplo `README.es.md` para español.
+
+## Inserta videos
+
+Si quieres incluir algún video introductorio para cada ejercicio, agrega la propiedad `intro` en el inicio del README.md para ese ejercicio en particular:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```
+
+Tambien puedes agregar un video explicando la solución para cada ejercicio agregando la propiedad `tutorial` al inicio del markdown del README.md correspondiente:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```

package/src/utils/templates/isolated/exercises/01-hello-world/README.md

@@ -1,26 +1,26 @@
-# `01` First Exercise
-
-We created this first exercise as an example, you can find it located in the folder `./01-hello-world`.
-
-1. Every exercise must be located on a separate folder and it must have a README.md file inside with the exercise instructions written in markdown.
-2. You can have just a README file and it will be like a page in a book, no code files.
-3. You can also add a `README.[lang].md` file for translations, for example: `README.es.md` for spanish.
-
-## Video compatibility
-
-If you want to include some video introduction for each exercise, add a `intro` property in the markdown frontmatter of the README.md for that particular exercise:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
-
-You can also add a video solution for each exercise by adding a `tutorial` property on the markdown frontmatter of it's README.md:
-
-```markdown
----
-intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
-tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
----
-```
+# `01` First Exercise
+
+We created this first exercise as an example, you can find it located in the folder `./01-hello-world`.
+
+1. Every exercise must be located on a separate folder and it must have a README.md file inside with the exercise instructions written in markdown.
+2. You can have just a README file and it will be like a page in a book, no code files.
+3. You can also add a `README.[lang].md` file for translations, for example: `README.es.md` for spanish.
+
+## Video compatibility
+
+If you want to include some video introduction for each exercise, add a `intro` property in the markdown frontmatter of the README.md for that particular exercise:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```
+
+You can also add a video solution for each exercise by adding a `tutorial` property on the markdown frontmatter of it's README.md:
+
+```markdown
+---
+intro: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+tutorial: "https://www.youtube.com/watch?v=YkgkThdzX-8"
+---
+```