python-book/mkdocs.yml at main · enaguero/python-book · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
site_name: Python Book
site_description: A practical, chapter-based Python handbook.
site_url: !ENV [SITE_URL, https://example.com]
repo_url: !ENV [REPO_URL, https://github.com/your-org/python-book]
repo_name: !ENV [REPO_NAME, your-org/python-book]

nav:
  - Home: index.md
  - Curriculum Tracker: curriculum.md
  - "Foundations (Modules 1-9)":
      - "M1: Computer Fundamentals": modules/m01-computer-fundamentals.md
      - "M2: First Programs": modules/m02-first-programs.md
      - "M3: Variables & Types": modules/m03-variables-and-types.md
      - "M4: Control Flow": modules/m04-control-flow.md
      - "M5: Functions & Loops": modules/m05-functions-and-loops.md
      - "M6: Files & Exceptions": modules/m06-files-and-exceptions.md
      - "M7: Modules & Environments": modules/m07-modules-and-environments.md
      - "M8: OOP & Testing":
          - Object-Oriented Programming: modules/m08-oop.md
          - Testing with pytest: modules/m08-testing.md
      - "M9: Capstone": modules/m09-capstone.md
  - "Beyond the Basics (Modules 10-12)":
      - "M10: Collections & Itertools": modules/m10-collections-and-itertools.md
      - "M11: Datetime & JSON": modules/m11-datetime-and-json.md
      - "M12: Async & Typing":
          - Asyncio Basics: modules/m12-asyncio-basics.md
          - Typing & Code Quality: modules/m12-typing-and-quality.md
  - Exercises:
      - Foundations Exercises: exercises/foundations/index.md
      - Beyond the Basics Exercises: exercises/beyond/index.md
  - Authoring:
      - Chapter Template: authoring/chapter-template.md
      - Interactivity Roadmap: roadmap/interactivity-roadmap.md

theme:
  name: material
  language: en
  features:
    - navigation.sections
    - navigation.path
    - navigation.footer
    - content.code.copy
    - search.suggest
    - search.highlight
    - toc.follow
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: blue grey
      accent: amber
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: blue grey
      accent: amber
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.highlight:
      anchor_linenums: true
  - toc:
      permalink: true

plugins:
  - i18n:
      docs_structure: suffix
      fallback_to_default: true
      reconfigure_material: true
      languages:
        - locale: en
          default: true
          name: English
          build: true
        - locale: es
          name: Espanol
          build: true
          nav_translations:
            Home: Inicio
            Curriculum Tracker: Seguimiento del Curriculo
            "Foundations (Modules 1-9)": "Fundamentos (Modulos 1-9)"
            "Beyond the Basics (Modules 10-12)": "Mas Alla de lo Basico (Modulos 10-12)"
            Exercises: Ejercicios
            Authoring: Autoria
            "M1: Computer Fundamentals": "M1: Fundamentos de Computacion"
            "M2: First Programs": "M2: Primeros Programas"
            "M3: Variables & Types": "M3: Variables y Tipos"
            "M4: Control Flow": "M4: Flujo de Control"
            "M5: Functions & Loops": "M5: Funciones y Bucles"
            "M6: Files & Exceptions": "M6: Archivos y Excepciones"
            "M7: Modules & Environments": "M7: Modulos y Entornos"
            "M8: OOP & Testing": "M8: POO y Pruebas"
            Object-Oriented Programming: Programacion Orientada a Objetos
            Testing with pytest: Pruebas con pytest
            "M9: Capstone": "M9: Proyecto Final"
            "M10: Collections & Itertools": "M10: Collections e Itertools"
            "M11: Datetime & JSON": "M11: Datetime y JSON"
            "M12: Async & Typing": "M12: Async y Tipado"
            Asyncio Basics: Fundamentos de asyncio
            "Typing & Code Quality": "Tipado y Calidad de Codigo"
            Foundations Exercises: Ejercicios de Fundamentos
            Beyond the Basics Exercises: Ejercicios Mas Alla de lo Basico
            Chapter Template: Plantilla de Capitulo
            Interactivity Roadmap: Hoja de Ruta de Interactividad
  - search
  - git-revision-date-localized:
      # Disabled by default to avoid noisy warnings in repos without git history.
      enabled: false
      type: datetime
      fallback_to_build_date: true

extra:
  social:
    - icon: fontawesome/brands/github
      link: !ENV [REPO_URL, https://github.com/your-org/python-book]

extra_javascript:
  - https://cdn.jsdelivr.net/pyodide/v0.27.2/full/pyodide.js
  - assets/js/pyodide-runner.js
  - assets/js/language-switcher.js

extra_css:
  - assets/css/pyodide-runner.css
  - assets/css/language-switcher.css

copyright: Copyright &copy; 2026 Python Book