mkdocs.yml

# ==============================================================================
#  MkDocs DAP Theme — Full Configuration Reference
#  Every available option is documented here.
#  Lines starting with # are comments and have no effect.
#  Remove the # to enable an option.
# ==============================================================================


# ==============================================================================
#  SITE METADATA
#  Basic information about your documentation site.
# ==============================================================================

# The title shown in the browser tab, header breadcrumb, and SEO tags.
# Required.
site_name: davidalvarezp's Docs

# The canonical base URL of your deployed site.
# Required for: canonical URLs, sitemap, absolute OG image URLs, analytics.
# Without this, SEO features will not work correctly.
# Do NOT add a trailing slash.
site_url: https://docs.davidalvarezp.com

# Short description of your project.
# Used as the default <meta name="description"> and og:description.
site_description: Documentación técnica de davidalvarezp.

# Author name.
# Used in <meta name="author"> and JSON-LD structured data.
site_author: davidalvarezp

# Directory that contains your Markdown source files.
# Default: docs
docs_dir: docs

# Directory where the built site is written.
# Default: site
# site_dir: site

# Link to your source code repository.
# Displays a GitHub button in the header that fetches live star count.
# Remove both lines to hide the button.
repo_url: https://github.com/davidalvarezp/docs
repo_name: davidalvarezp/docs

# Copyright notice shown in the footer left column.
copyright: "© 2020-2026 davidalvarezp"


# ==============================================================================
#  THEME
#  Points MkDocs to the custom theme folder.
#  Do not change these two lines.
# ==============================================================================

theme:
  name: null              # Disables any built-in MkDocs theme.
  custom_dir: theme       # Path to the theme folder (relative to mkdocs.yml).

  # Favicon shown in the browser tab.
  # Path relative to docs/. Supports .ico, .png, .svg.
  # Recommended: place a 32×32 px .ico or .png at docs/assets
  favicon: assets/img/favicon.ico


# ==============================================================================
#  EXTRA — All theme-specific configuration lives here.
# ==============================================================================

extra:

  # ----------------------------------------------------------------------------
  #  LANGUAGE
  #  Controls all UI strings (search placeholder, button labels, etc.).
  #  Built-in values: en (English) | es (Spanish)
  #  To add a new language, open theme/main.html and add an
  #  {% elif lang == 'xx' %} block in the i18n section.
  # ----------------------------------------------------------------------------
  language: es

  # ----------------------------------------------------------------------------
  #  COLOR SCHEME
  #  The default color scheme on first visit.
  #  The user can toggle between dark and light using the header button.
  #  Their choice is saved in localStorage and applied instantly on every
  #  subsequent page load with no flash (FOUC prevention).
  #  Values: dark | light
  # ----------------------------------------------------------------------------
  color_scheme: dark

  # ----------------------------------------------------------------------------
  #  ACCENT COLOR
  #  The default accent color on first visit.
  #  The user can change it using the color swatches in the header panel.
  #  Their choice is also saved in localStorage.
  #
  #  Values:   dark mode hex   light mode hex
  #  purple    #bd93f9         #6d28d9
  #  green     #50fa7b         #15803d
  #  cyan      #8be9fd         #0369a1
  #  pink      #ff79c6         #be185d
  #  orange    #ffb86c         #c2410c
  #  red       #ff5555         #b91c1c
  # ----------------------------------------------------------------------------
  accent_color: green

  # ----------------------------------------------------------------------------
  #  SIDEBAR PROFILE CARD
  #  Shown at the top of the sidebar above the navigation.
  #  All fields are optional — omit any you don't need.
  #  Remove the entire sidebar: block to hide the profile card.
  # ----------------------------------------------------------------------------
  sidebar:

    # Path to the avatar image, relative to docs/.
    # Recommended size: at least 168×168 px (displayed at 84×84 px, 2× for HiDPI).
    # Remove this line to hide the avatar circle.
    image: assets/img/avatar.png

    # Display name shown below the avatar.
    # Falls back to site_name if omitted.
    name: davidalvarezp

    # Short subtitle shown below the name in a smaller muted font.
    # Remove this line to hide the tagline.
    tagline: Systems Administrator

    # Social / external links shown as icon buttons below the tagline.
    # Use platform: to render an icon automatically.
    # Use title: instead of platform: to render a text pill (no icon).
    #
    # Supported platform values (case-insensitive):
    #   github      twitter / x    linkedin      instagram
    #   discord     youtube        mastodon       facebook
    #   twitch      reddit         npm            pypi
    #   email       website        (any unknown value → globe icon)
    links:
      - platform: website
        url: https://davidalvarezp.com
      - platform: github
        url: https://github.com/davidalvarezp
      - platform: twitter
        url: https://x.com/sudodap
      - platform: youtube
        url: https://youtube.com/@davidalvarezp

      # Text pill example (no platform icon):
      # - title: My Blog
      #   url: https://blog.example.com

  # ----------------------------------------------------------------------------
  #  TOP NAVIGATION BAR  (extra.navmenu)
  #  A horizontal sticky bar rendered below the header.
  #  Completely independent from the sidebar nav: key.
  #
  #  - Depth 0 items are shown directly on the bar.
  #  - Items with children render as dropdown triggers.
  #  - Dropdowns at depth 0 open downward.
  #  - Dropdowns at depth 1+ fly out to the right on desktop.
  #  - On mobile all dropdowns stack vertically with max-height animation.
  #  - Active state is detected by JS (current pathname match).
  #  - Nesting is unlimited (5+ levels tested).
  #
  #  Write URLs exactly as they appear in production.
  #  With use_directory_urls: true (default) pages use trailing slashes.
  #
  #  Remove the entire navmenu: block to hide the top navigation bar.
  # ----------------------------------------------------------------------------
  navmenu:
    - title: Home
      url: /
    - title: Homelab
      url: /homelab/
    - title: Sistemas
      children:
        - title: Linux
          url: /sys/lin/
        - title: Windows
          url: /sys/win/
    - title: Ciberseguridad
      children:
        - title: WebSec Audit
          url: /websec-audit
        
        # Nested example — flyout sub-menu:
        # - title: Advanced
        #   children:
        #     - title: Plugins
        #       url: /guide/advanced/plugins/
        #     - title: Hooks
        #       url: /guide/advanced/hooks/
    - title: Socials
      children:
        - title: Youtube
          url: https://youtube.com/@davidalvarezp

  # ----------------------------------------------------------------------------
  #  ANALYTICS
  #  Supports Google Analytics 4 (GA4) and Universal Analytics (UA).
  #
  #  Analytics is only injected when site_url is set, so it never fires
  #  during local development (mkdocs serve).
  #
  #  Both scripts check the browser's Do Not Track header and skip loading
  #  if it is set to "1".
  #
  #  Remove the entire analytics: block to disable analytics completely.
  # ----------------------------------------------------------------------------
  analytics:

    # Analytics provider. Currently only "google" is supported.
    provider: google

    # Your tracking ID.
    # GA4:                  G-XXXXXXXXXX
    # Universal Analytics:  UA-XXXXXXXX-X
    property: G-S34Y1DQ8K1

    # GDPR / LOPD cookie consent banner.
    # When true:
    #   - Analytics does NOT load on page load.
    #   - A banner appears with Accept and Reject buttons.
    #   - If accepted, analytics loads immediately and choice is stored.
    #   - If rejected, analytics never loads and any GA cookies are deleted.
    #   - A small icon button stays in the bottom-right corner so the user
    #     can reopen the banner and change their choice at any time.
    #   - Consent is stored in localStorage under 'mk-cookie-consent'.
    # When false or omitted:
    #   - Analytics loads on every page without asking.
    # Default: false
    cookie_consent: true

    # URL of your privacy policy page.
    # When set, a "Privacy policy" link appears inside the consent banner.
    # Use a path relative to site_url (with leading slash).
    # Remove this line to hide the link.
    privacy_policy: /privacy/

  # ----------------------------------------------------------------------------
  #  SEO EXTRAS
  #  These complement the automatic SEO meta tags generated by
  #  theme/partials/seo.html, which already handles:
  #    - <meta description>, <meta author>, <meta robots>
  #    - <link rel="canonical">
  #    - <link rel="sitemap"> (points to /sitemap.xml, auto-generated by MkDocs)
  #    - Open Graph: og:type, og:title, og:description, og:url, og:image
  #    - Twitter Cards: twitter:card, twitter:title, twitter:description, twitter:image
    #    - JSON-LD: WebSite (home) or TechArticle (inner pages)
  #    - <meta name="theme-color"> for mobile browser chrome
  #
  #  Remove the entire seo: block if you don't need OG image or Twitter handles.
  # ----------------------------------------------------------------------------
  seo:

    # Default Open Graph and Twitter Card image.
    # Path relative to docs/. Place the file at docs/assets/img/og-default.png.
    # Recommended size: 1200×630 px.
    # Can be overridden per page via frontmatter (see Per-page SEO below).
    # Remove this line if you don't have an OG image.
    og_image: assets/img/avatar.png

    # Twitter/X site handle (the account that owns the site).
    # Include the @ symbol.
    # Remove this line if you don't have a Twitter account.
    twitter_site: "@sudodap"

    # Twitter/X author handle (the person who wrote the content).
    # Can be the same as twitter_site.
    # Remove this line to omit the twitter:creator tag.
    twitter_creator: "@sudodap"

  # ----------------------------------------------------------------------------
  #  FOOTER SOCIAL LINKS
  #  Shown as icon buttons in the center column of the footer.
  #  Uses the same platform values as sidebar.links (see above).
  #  Remove the entire social: block to hide the social icon row.
  # ----------------------------------------------------------------------------
  social:
    - platform: website
      url: https://davidalvarezp.com
    - platform: github
      url: https://github.com/davidalvarezp
    - platform: youtube
      url: https://youtube.com/@davidalvarezp
    - platform: instagram
      url: https://instagram.com/davidalvarezzp
    - platform: email
      url: mailto:contact@davidalvarezp.com
    - platform: twitter
      url: https://twitter.com/sudodap
    - platform: linkedin
      url: https://linkedin.com/in/davidalvarezp

    # - platform: discord
    #   url: https://discord.gg/your-server
    # - platform: youtube
    #   url: https://youtube.com/@your-channel
    # - platform: mastodon
    #   url: https://mastodon.social/@your-handle


# ==============================================================================
#  PLUGINS
#  Only the built-in search plugin is needed.
#
#  ⚠️  Do NOT add "sitemap" to this list.
#      The sitemap is built into MkDocs core and is generated automatically
#      on every `mkdocs build`. Adding it as a plugin causes an error.
# ==============================================================================

plugins:
  - search   # Built-in full-text search. Always include this.

  # Optional third-party plugins (install separately with pip):
  #
  # Minify HTML/CSS/JS output for production:
  # - minify:
  #     minify_html: true
  #     minify_js: true
  #     minify_css: true
  #
  # Show last-updated date on each page (requires git history):
  # - git-revision-date-localized:
  #     enable_creation_date: true
  #     type: date


# ==============================================================================
#  MARKDOWN EXTENSIONS
#  These power syntax highlighting, admonitions, code blocks, and more.
#  The theme is designed and tested with this exact set.
# ==============================================================================

markdown_extensions:

  # Syntax highlighting via Pygments.
  # anchor_linenums: adds anchor links to line numbers.
  # use_pygments: uses server-side highlighting (recommended).
  - pymdownx.highlight:
      anchor_linenums: true
      use_pygments: true

  # Allows nested fenced code blocks and custom block types.
  - pymdownx.superfences

  # Inline code highlighting: `#!python print("hello")`.
  - pymdownx.inlinehilite

  # Include content from other files using --8<-- syntax.
  - pymdownx.snippets

  # Admonition blocks: !!! note, !!! tip, !!! warning, !!! danger, !!! info
  - admonition

  # Collapsible admonitions: ??? note (collapsed by default)
  - pymdownx.details

  # Add HTML attributes and CSS classes to Markdown elements.
  - attr_list

  # Use Markdown inside HTML blocks.
  - md_in_html

  # GitHub-flavored Markdown tables.
  - tables

  # Table of contents with permalink anchors on headings.
  - toc:
      permalink: true        # Adds ¶ anchor link to each heading.
      # permalink: "🔗"      # Custom permalink symbol.
      # title: On this page  # TOC box title (used by some themes, not this one).
      # toc_depth: 3         # Maximum heading level included. Default: 6.
      # separator: "-"       # Separator used in generated anchor IDs.


# ==============================================================================
#  EXTRA CSS
#  Additional CSS files loaded after all theme stylesheets.
#  Place files in docs/ (they are copied to the built site as-is).
#  Use CSS custom properties (var(--accent), var(--bg), etc.) to stay
#  in sync with the theme's color scheme and accent color.
# ==============================================================================

# extra_css:
#   - assets/extra.css


# ==============================================================================
#  EXTRA JAVASCRIPT
#  Additional JS files loaded after all theme scripts.
#  Place files in docs/ (they are copied to the built site as-is).
# ==============================================================================

# extra_javascript:
#   - assets/extra.js


# ==============================================================================
#  HOOKS
#  Python scripts that run at specific points in the MkDocs build process.
#  Place the file in your project root (next to mkdocs.yml).
# ==============================================================================

# hooks:
#   - hooks.py


# ==============================================================================
#  SIDEBAR NAVIGATION  (nav)
#  Defines the structure shown in the sidebar.
#  MkDocs processes this list, resolves URLs, and marks the active page.
#
#  This is INDEPENDENT from extra.navmenu (the top navigation bar).
#  You can have different structures in each.
#
#  Rules:
#   - Every .md file in docs/ that is referenced here becomes a page.
#   - Sections (items with children) become collapsible groups.
#   - Nesting is unlimited.
#   - If nav: is omitted, MkDocs auto-generates it from the docs/ folder.
#
#  Per-page SEO frontmatter (add to the top of any .md file):
#    ---
#    title: Custom Page Title
#    description: Custom meta description for this page.
#    image: assets/img/custom-og.png
#    noindex: true
#    ---
# ==============================================================================

nav:
  - Inicio: index.md
  - Homelab:
    - Mi Homelab: homelab/index.md
    - Host: homelab/host/index.md
    - LXC: homelab/lxc/index.md
    - Infraestructura: homelab/lxc/CI/index.md
    - Servicios: homelab/lxc/CS/index.md
  - Sistemas:
    - Introducción: sys/index.md
    - Linux:
      - Comandos: sys/lin/cmd/index.md
      - Linux Server:
        - Servidores Linux: sys/lin/ser/index.md
        - 1. Fundamentos: 
          - 1.00 Fundamentos Linux: sys/lin/ser/01-fundamentos/index.md
          - 1.01 Introducción: sys/lin/ser/01-fundamentos/01-introduccion.md
          - 1.08 Procesos: sys/lin/ser/01-fundamentos/08-procesos.md
          - 1.09 Paquetes: sys/lin/ser/01-fundamentos/09-paquetes.md
          - 1.10 Documentación: sys/lin/ser/01-fundamentos/10-documentacion.md
          - 1.11 CheatSheet: sys/lin/ser/01-fundamentos/11-cheatsheet.md
          - 1.12 Laboratorios: sys/lin/ser/01-fundamentos/12-laboratorios.md
          - 1.13 Errores comunes: sys/lin/ser/01-fundamentos/13-errores-comunes.md
          - 1.14 Casos reales: sys/lin/ser/01-fundamentos/14-casos-reales.md
        - 2. Uso diario:
          - 2.00 Introducción: sys/lin/ser/02-uso-diario/index.md
          - 2.01 Flujo: sys/lin/ser/02-uso-diario/01-flujo.md
          - 2.02 Archivos: sys/lin/ser/02-uso-diario/02-archivos.md
          - 2.03 Edición: sys/lin/ser/02-uso-diario/03-edicion.md
          - 2.04 Búsqueda: sys/lin/ser/02-uso-diario/04-busqueda.md
          - 2.05 Permisos: sys/lin/ser/02-uso-diario/05-permisos.md
          - 2.06 Usuarios: sys/lin/ser/02-uso-diario/06-usuarios.md
          - 2.07 Procesos: sys/lin/ser/02-uso-diario/07-procesos.md
          - 2.08 Red: sys/lin/ser/02-uso-diario/08-red.md
          - 2.09 Paquetes: sys/lin/ser/02-uso-diario/09-paquetes.md
          - 2.10 Logs: sys/lin/ser/02-uso-diario/10-logs.md
          - 2.11 Automatización: sys/lin/ser/02-uso-diario/11-automatizacion.md
          - 2.12 Productividad: sys/lin/ser/02-uso-diario/12-productividad.md
          - 2.13 CheatSheet: sys/lin/ser/02-uso-diario/13-cheatsheet.md
          - 2.14 Laboratorios: sys/lin/ser/02-uso-diario/14-laboratorios.md
          - 2.15 Errores: sys/lin/ser/02-uso-diario/15-errores.md
          - 2.16 Casos reales: sys/lin/ser/02-uso-diario/16-casos-reales.md
      - Linux Desktop: 
        - PC Linux: sys/lin/des/index.md
    - Windows:
      - Windows Server: 
        - Servidores Windows: sys/win/ser/index.md
      - Windows Desktop:
        - PC Windows: sys/win/des/index.md