mkdocs.yml

site_name: Programación Competitiva CUNEF
site_description: >-
  Material de programación competitiva de CUNEF (C++ y Python) para concursos tipo ICPC.
site_url: https://jparisu.github.io/PrograCompetitivaCUNEF/
repo_url: https://github.com/jparisu/PrograCompetitivaCUNEF
edit_uri: edit/main/docs/

# Content lives one folder per item under docs/content/<topic>/<id>/, each with a
# meta.yaml (single source of truth). Derived pieces are generated: the nav
# (tools/gennav.py -> the nav below), the overview data (algorithms.json), the
# front-end taxonomy (assets/js/taxonomy.js), and the clean/contest code + tests.
# Item pages render their metadata/code blocks from meta.yaml via the `macros`
# plugin (see main.py), so the prose page holds only the explanation.

# To compare with the classic ReadTheDocs look, temporarily set `name: readthedocs`
# below and run `mkdocs serve` (note: that theme drops tabs, the palette toggle and
# some niceties). We recommend Material, branded with CUNEF orange (see assets/css/theme.css).
hooks:
  - mkdocs_hooks.py           # expands code includes, stripping hidden comments

theme:
  name: material
  custom_dir: overrides       # custom tabs.html for header hover dropdowns
  language: es
  logo: resources/images/logo.jpg
  favicon: resources/images/logo.jpg
  icon:
    repo: fontawesome/brands/github
  features:
    - content.code.copy       # copy button on every code block (req 6)
    - content.code.annotate
    - content.tabs.link
    - navigation.tabs         # top-level sections as colourful tabs
    - navigation.tabs.sticky
    - navigation.top          # back-to-top button
    - navigation.footer       # prev/next links
    - navigation.indexes
    - search.suggest
    - search.highlight
    - toc.follow
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      toggle: { icon: material/weather-night, name: Cambiar a modo oscuro }
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      toggle: { icon: material/weather-sunny, name: Cambiar a modo claro }

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html
  - toc: { permalink: "#" }
  - pymdownx.highlight: { anchor_linenums: true }
  - pymdownx.inlinehilite
  # Code includes (--8<-- "path") are expanded by mkdocs_hooks.py so hidden
  # comments (//! / #!) are stripped; see the hook. (Replaces pymdownx.snippets.)
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed: { alternate_style: true }                    # C++ / Python tabs
  - pymdownx.emoji:                                               # :material-...: icons
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

plugins:
  - search:
      lang: [es, en]
  # Renders item-page macros (metadata/code_tabs) from meta.yaml — see main.py.
  # Opt-in only: a page runs macros only with front-matter `render_macros: true`,
  # so Material/attr-list syntax on other pages is never touched by Jinja.
  - macros:
      module_name: main
      render_by_default: false
      on_error_fail: true
  - i18n:
      docs_structure: suffix        # index.md (es, default) + index.en.md (en)
      fallback_to_default: true     # missing translation -> Spanish
      languages:
        - locale: es
          default: true
          name: Español
          build: true
        - locale: en
          name: English
          build: true

# Keep per-item source files (code, tests, meta) out of the built site (they
# stay on disk and feed the generators).
exclude_docs: |
  **/code/**
  **/test/**
  **/*.yaml

extra_css:
  - assets/css/theme.css
  - assets/css/ranklist.css
  - assets/css/overview-table.css
  - assets/css/cheatsheet-builder.css

extra_javascript:
  - assets/js/taxonomy.js         # generated taxonomy (levels/types/topics) — load first
  - assets/js/catalog.js          # shared data + filters (reads window.Taxonomy)
  - assets/js/page-icon.js        # topic icon next to the page title
  - assets/js/nav-wip.js          # gray out WIP (unimplemented) entries in the sidebar
  - assets/js/ranklist.js
  - assets/js/overview-table.js
  - assets/js/graph.js
  - assets/js/matrix.js
  - assets/js/topics.js
  - assets/js/todo.js
  - assets/js/cheatsheet-builder.js

# === AUTO-GENERATED NAV — do not edit below (run: python tools/gen.py generate) ===
nav:
- Inicio: index.md
- Empezar aquí: start/onboarding.md
- Contenidos:
  - Contenidos:
    - content/index.md
    - Temas: content/topics/index.md
    - Mapa de contenidos: content/matrix.md
    - Grafo de dependencias: content/graph.md
  - Base:
    - content/levels/base/index.md
    - Comparaciones — Técnica: content/fundamentals/comparisons/index.md
    - Tipos nativos — Técnica: content/fundamentals/native-types/index.md
    - Condicionales — Técnica:
      - content/fundamentals/conditionals/index.md
      - En C++: content/fundamentals/conditionals/cpp.md
      - En Python: content/fundamentals/conditionals/python.md
    - Bucles — Técnica:
      - content/fundamentals/loops/index.md
      - En C++: content/fundamentals/loops/cpp.md
      - En Python: content/fundamentals/loops/python.md
    - Arrays — Estructura: content/data-structures/lists/index.md
    - Desbordamiento (overflow) — Técnica: content/fundamentals/overflow/index.md
    - Búsqueda del máximo — Algoritmo: content/search/max-search/index.md
    - Búsqueda lineal — Algoritmo: content/search/linear-search/index.md
    - Complejidad (Big-O) — Técnica: content/fundamentals/complexity/index.md
    - Input/Output — Técnica: content/fundamentals/io/index.md
    - Stack & queue — Estructura: content/data-structures/stack-queue/index.md
    - Sum all — Algoritmo: content/fundamentals/sum-all/index.md
  - Principiante:
    - content/levels/beginner/index.md
    - E/S rápida — Técnica: content/fundamentals/fast-io/index.md
    - Binary search — Algoritmo: content/search/binary-search-array/index.md
    - Dictionaries / maps — Estructura: content/data-structures/dictionaries/index.md
    - Coma flotante — Técnica: content/arithmetics/float-treatment/index.md
    - Iteradores — Técnica: content/fundamentals/iterators/index.md
    - Breadth-first search (BFS) — Algoritmo: content/graphs/bfs/index.md
    - Decimal precision — Técnica: content/fundamentals/decimal-precision/index.md
    - Depth-first search (DFS) — Algoritmo: content/graphs/dfs/index.md
    - Euler factorization — Técnica: content/arithmetics/euler-factorization/index.md
    - Factorización — Técnica: content/arithmetics/factorization/index.md
    - Fibonacci — Algoritmo: content/dynamic-programming/fibonacci/index.md
    - Flood fill — Algoritmo: content/graphs/flood-fill/index.md
    - GCD (Euclid) — Algoritmo: content/arithmetics/gcd/index.md
    - Lambda — Técnica: content/fundamentals/lambda/index.md
    - Merge sort — Algoritmo: content/search/merge-sort/index.md
    - Palindrome checker — Algoritmo: content/strings/palindrome-checker/index.md
    - Prefix sums — Técnica: content/data-structures/prefix-sums/index.md
    - Priority queue (heap) — Estructura: content/data-structures/priority-queue/index.md
    - Punctuation checker — Algoritmo: content/strings/punctuation-checker/index.md
    - Quicksort — Algoritmo: content/search/quick-sort/index.md
    - Recursión — Técnica: content/fundamentals/recursion/index.md
    - Sieve of Eratosthenes — Algoritmo: content/arithmetics/sieve/index.md
    - Trial division — Técnica: content/arithmetics/trial-division/index.md
    - Backtracking — Técnica: content/search/backtracking/index.md
  - Intermedio:
    - content/levels/intermediate/index.md
    - MiniMax — Algoritmo: content/game-theory/minimax/index.md
    - Grafos — Estructura: content/graphs/graphs/index.md
    - Binary exponentiation — Algoritmo: content/arithmetics/binary-exponentiation/index.md
    - Combinatoria — Técnica: content/combinatorics/combinatory/index.md
    - Dijkstra — Algoritmo: content/graphs/dijkstra/index.md
    - Floyd-Warshall — Algoritmo: content/graphs/floyd-warshall/index.md
    - KMP — Algoritmo: content/strings/kmp/index.md
    - Knapsack — Algoritmo: content/dynamic-programming/knapsack/index.md
    - Kruskal (MST) — Algoritmo: content/graphs/kruskal/index.md
    - Longest increasing subsequence — Algoritmo: content/dynamic-programming/lis/index.md
    - Modular inverse — Técnica: content/arithmetics/modular-inverse/index.md
    - Multiplicación de matrices — Algoritmo: content/arithmetics/matrix-multiplication/index.md
    - Newtons binomial — Técnica: content/combinatorics/newton-binomial/index.md
    - Prim (MST) — Algoritmo: content/graphs/prim/index.md
    - Segment tree — Estructura: content/data-structures/segment-tree/index.md
    - Topological sort — Algoritmo: content/graphs/topological-sort/index.md
    - Union-Find (DSU) — Estructura: content/data-structures/union-find/index.md
    - Dynamic programming — Técnica: content/dynamic-programming/dynamic-programming/index.md
  - Avanzado:
    - content/levels/advanced/index.md
    - Bellman-Ford — Algoritmo: content/graphs/bellman-ford/index.md
    - Fenwick Tree (BIT) — Estructura: content/data-structures/fenwick-tree/index.md
    - A* — Algoritmo: content/graphs/a-star/index.md
    - Graph coloring — Algoritmo: content/graphs/graph-coloring/index.md
    - Heap sort — Algoritmo: content/search/heap-sort/index.md
    - Lowest common ancestor — Algoritmo: content/graphs/lca/index.md
    - Matrix exponentiation — Algoritmo: content/arithmetics/matrix-exponentiation/index.md
    - Max flow — Algoritmo: content/graphs/max-flow/index.md
    - Strongly connected components — Algoritmo: content/graphs/scc/index.md
    - Travelling salesman problem — Algoritmo: content/graphs/tsp/index.md
    - Bitmask DP — TSP — Algoritmo: content/dynamic-programming/bitmask-tsp/index.md
  - Experto:
    - content/levels/expert/index.md
    - Convex hull — Algoritmo: content/geometry/convex-hull/index.md
    - Bogosort — Algoritmo: content/search/bogosort/index.md
- Ranking: ranklist/index.md
- Chuletario: cheatsheet/index.md
- Contribuir:
  - Cómo contribuir: contributing/index.md
  - ToDo: contributing/todo.md
  - Sugerencias e incidencias: contributing/issues.md
  - Git y GitHub: contributing/git-github.md
  - Añadir un algoritmo: contributing/add-algorithm.md
  - Scripts del proyecto: contributing/scripts.md
  - Autores: contributing/authors.md