mkdocs.yml

site_name: Pydoll - Async Web Automation Library
site_url: https://pydoll.tech/docs/
repo_url: https://github.com/autoscrape-labs/pydoll
repo_name: autoscrape-labs/pydoll
use_directory_urls: true
docs_dir: docs

# Configuração da navegação
nav:
  - Pydoll: index.md
  - Features:
      - Overview: features/index.md
      - Core Concepts: features/core-concepts.md
      - Element Finding: features/element-finding.md
      - Automation:
          - Human-Like Interactions: features/automation/human-interactions.md
          - Keyboard Control: features/automation/keyboard-control.md
          - File Operations: features/automation/file-operations.md
          - IFrames: features/automation/iframes.md
          - Screenshots & PDF: features/automation/screenshots-and-pdfs.md
      - Network:
          - Network Monitoring: features/network/monitoring.md
          - Request Interception: features/network/interception.md
          - Browser-Context HTTP Requests: features/network/http-requests.md
      - Browser Management:
          - Multi-Tab Management: features/browser-management/tabs.md
          - Browser Contexts: features/browser-management/contexts.md
          - Cookies & Sessions: features/browser-management/cookies-sessions.md
      - Configuration:
          - Browser Options: features/configuration/browser-options.md
          - Browser Preferences: features/configuration/browser-preferences.md
          - Proxy Configuration: features/configuration/proxy.md
      - Advanced:
          - Behavioral Captcha Bypass: features/advanced/behavioral-captcha-bypass.md
          - Event System: features/advanced/event-system.md
          - Remote Connections: features/advanced/remote-connections.md
          - Retry Decorator: features/advanced/decorators.md
  - Deep Dive:
      - Overview: deep-dive/index.md
      - Core Fundamentals:
          - Overview: deep-dive/fundamentals/index.md
          - Chrome DevTools Protocol: deep-dive/fundamentals/cdp.md
          - Connection Layer: deep-dive/fundamentals/connection-layer.md
          - Python Type System: deep-dive/fundamentals/typing-system.md
          - Iframes & Contexts: deep-dive/fundamentals/iframes-and-contexts.md
      - Internal Architecture:
          - Overview: deep-dive/architecture/index.md
          - Browser Domain: deep-dive/architecture/browser-domain.md
          - Tab Domain: deep-dive/architecture/tab-domain.md
          - WebElement Domain: deep-dive/architecture/webelement-domain.md
          - FindElements Mixin: deep-dive/architecture/find-elements-mixin.md
          - Event Architecture: deep-dive/architecture/event-architecture.md
          - Browser Requests Architecture: deep-dive/architecture/browser-requests-architecture.md
          - Shadow DOM: deep-dive/architecture/shadow-dom.md
      - Network & Security:
          - Overview: deep-dive/network/index.md
          - Network Fundamentals: deep-dive/network/network-fundamentals.md
          - HTTP/HTTPS Proxies: deep-dive/network/http-proxies.md
          - SOCKS Proxies: deep-dive/network/socks-proxies.md
          - Proxy Detection: deep-dive/network/proxy-detection.md
          - Building Proxy Servers: deep-dive/network/build-proxy.md
          - Legal & Ethical: deep-dive/network/proxy-legal.md
      - Fingerprinting:
          - Overview: deep-dive/fingerprinting/index.md
          - Network Fingerprinting: deep-dive/fingerprinting/network-fingerprinting.md
          - Browser Fingerprinting: deep-dive/fingerprinting/browser-fingerprinting.md
          - Behavioral Fingerprinting: deep-dive/fingerprinting/behavioral-fingerprinting.md
          - Evasion Techniques: deep-dive/fingerprinting/evasion-techniques.md
      - Practical Guides:
          - Overview: deep-dive/guides/index.md
          - CSS Selectors vs XPath: deep-dive/guides/selectors-guide.md
  - API Reference:
      - Overview: api/index.md
      - Browser:
          - Chrome: api/browser/chrome.md
          - Edge: api/browser/edge.md
          - Options: api/browser/options.md
          - Tab: api/browser/tab.md
          - Requests: api/browser/requests.md
          - Managers: api/browser/managers.md
      - Elements:
          - WebElement: api/elements/web_element.md
          - ShadowRoot: api/elements/shadow_root.md
          - Mixins: api/elements/mixins.md
      - Connection:
          - Connection Handler: api/connection/connection.md
          - Managers: api/connection/managers.md
      - Commands:
          - Overview: api/commands/index.md
          - Browser: api/commands/browser.md
          - DOM: api/commands/dom.md
          - Input: api/commands/input.md
          - Network: api/commands/network.md
          - Page: api/commands/page.md
          - Runtime: api/commands/runtime.md
          - Storage: api/commands/storage.md
          - Target: api/commands/target.md
          - Fetch: api/commands/fetch.md
      - Protocol:
          - Base Types: api/protocol/base.md
          - Browser: api/protocol/browser.md
          - DOM: api/protocol/dom.md
          - Fetch: api/protocol/fetch.md
          - Input: api/protocol/input.md
          - Network: api/protocol/network.md
          - Page: api/protocol/page.md
          - Runtime: api/protocol/runtime.md
          - Storage: api/protocol/storage.md
          - Target: api/protocol/target.md
      - Core:
          - Constants: api/core/constants.md
          - Exceptions: api/core/exceptions.md
          - Utils: api/core/utils.md

theme:
  name: material
  font:
    text: Roboto
    code: Roboto Mono
  palette:
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: custom
      accent: indigo
      toggle:
        icon: material/toggle-switch-off-outline
        name: Dark Mode
  
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: custom
      accent: indigo
      toggle:
        icon: material/toggle-switch
        name: Light Mode
  icon:
    repo: fontawesome/brands/github
    logo: material/lightning-bolt
  favicon: resources/images/favicon.png
  features:
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.indexes
    - navigation.expand
    - navigation.path
    - navigation.top
    - toc.follow
    - content.code.copy
    - content.code.select
    - content.tooltips
    - search.highlight
    - search.suggest
  
plugins:
  - search
  - i18n:
      docs_structure: folder
      fallback_to_default: true
      reconfigure_material: false
      reconfigure_search: true
      languages:
        - locale: en
          default: true
          name: English
          build: true
          site_name: "Pydoll - Async Web Automation Library"
        - locale: zh
          name: 中文
          build: true
          site_name: "Pydoll - 异步网页自动化库"
          nav_translations:
            Pydoll: Pydoll
            Features: 特性
            Overview: 概述
            Core Concepts: 核心概念
            Element Finding: 元素查找
            Automation: 自动化
            Human-Like Interactions: 类人交互
            Keyboard Control: 键盘控制
            File Operations: 文件操作
            IFrames: IFrame交互
            Screenshots & PDF: 截图与PDF
            Network: 网络
            Network Monitoring: 网络监控
            Request Interception: 请求拦截
            Browser-Context HTTP Requests: 浏览器上下文HTTP请求
            Browser Management: 浏览器管理
            Multi-Tab Management: 多标签页管理
            Browser Contexts: 浏览器上下文
            Cookies & Sessions: Cookie与会话
            Configuration: 配置
            Browser Options: 浏览器选项
            Browser Preferences: 浏览器偏好设置
            Proxy Configuration: 代理配置
            Advanced: 高级功能
            Behavioral Captcha Bypass: 行为验证码绕过
            Event System: 事件系统
            Remote Connections: 远程连接
            Retry Decorator: Retry 装饰器
            Deep Dive: 深入了解
            Core Fundamentals: 核心基础
            Chrome DevTools Protocol: Chrome DevTools 协议
            Connection Layer: 连接层
            Python Type System: Python类型系统
            Internal Architecture: 内部架构
            Browser Domain: 浏览器域
            Tab Domain: 标签页域
            WebElement Domain: Web元素域
            FindElements Mixin: 查找元素混合器
            Event Architecture: 事件架构
            Browser Requests Architecture: 浏览器请求架构
            Shadow DOM: Shadow DOM 架构
            Network & Security: 网络与安全
            Network Fundamentals: 网络基础
            HTTP/HTTPS Proxies: HTTP/HTTPS 代理
            SOCKS Proxies: SOCKS 代理
            Proxy Detection: 代理检测
            Building Proxy Servers: 构建代理服务器
            Legal & Ethical: 法律与道德
            Fingerprinting: 指纹识别
            Network Fingerprinting: 网络指纹识别
            Browser Fingerprinting: 浏览器指纹识别
            Behavioral Fingerprinting: 行为指纹识别
            Evasion Techniques: 规避技术
            Practical Guides: 实用指南
            CSS Selectors vs XPath: CSS选择器 vs XPath
            API Reference: API 参考
            Browser: 浏览器
            Chrome: Chrome
            Edge: Edge
            Options: 选项
            Tab: 标签页
            Requests: 请求
            Managers: 管理器
            Elements: 元素
            WebElement: Web元素
            ShadowRoot: Shadow根
            Mixins: 混合器
            Connection: 连接
            Connection Handler: 连接处理器
            Commands: 命令
            DOM: DOM
            Input: 输入
            Network: 网络
            Page: 页面
            Runtime: 运行时
            Storage: 存储
            Target: 目标
            Fetch: 获取
            Protocol: 协议
            Base Types: 基础类型
            Overview: 概述
            Events: 事件
            Browser: 浏览器
            DOM: DOM
            Fetch: 获取
            Input: 输入
            Network: 网络
            Page: 页面
            Runtime: 运行时
            Storage: 存储
            Target: 目标
            Core: 核心
            Constants: 常量
            Exceptions: 异常
            Utils: 工具
        - locale: pt
          name: Português (BR)
          build: true
          site_name: "Pydoll - Biblioteca de Automação Web Assíncrona"
          nav_translations:
            Pydoll: Pydoll
            Features: Recursos
            Overview: Visão Geral
            Core Concepts: Conceitos Fundamentais
            Element Finding: Pesquisa de Elementos
            Automation: Automação
            Human-Like Interactions: Interações Humanas
            Keyboard Control: Controle de Teclado
            File Operations: Operações com Arquivos
            IFrames: IFrames
            Screenshots & PDF: Capturas e PDF
            Network: Rede
            Network Monitoring: Monitoramento de Rede
            Request Interception: Interceptação de Requisições
            Browser-Context HTTP Requests: Requisições HTTP no Contexto do Navegador
            Browser Management: Gerenciamento do Navegador
            Multi-Tab Management: Gerenciamento de Abas
            Browser Contexts: Contextos do Navegador
            Cookies & Sessions: Cookies e Sessões
            Configuration: Configuração
            Browser Options: Opções do Navegador
            Browser Preferences: Preferências do Navegador
            Proxy Configuration: Configuração de Proxy
            Advanced: Avançado
            Behavioral Captcha Bypass: Bypass de Captcha Comportamental
            Event System: Sistema de Eventos
            Remote Connections: Conexões Remotas
            Retry Decorator: Decorator Retry
            Deep Dive: Análise Profunda
            Core Fundamentals: Fundamentos Centrais
            Chrome DevTools Protocol: Protocolo Chrome DevTools
            Connection Layer: Camada de Conexão
            Python Type System: Sistema de Tipos Python
            Internal Architecture: Arquitetura Interna
            Browser Domain: Domínio do Navegador
            Tab Domain: Domínio da Aba
            WebElement Domain: Domínio do WebElement
            FindElements Mixin: Mixin FindElements
            Event Architecture: Arquitetura de Eventos
            Browser Requests Architecture: Arquitetura de Requisições do Navegador
            Shadow DOM: Arquitetura Shadow DOM
            Network & Security: Rede e Segurança
            Network Fundamentals: Fundamentos de Rede
            HTTP/HTTPS Proxies: Proxies HTTP/HTTPS
            SOCKS Proxies: Proxies SOCKS
            Proxy Detection: Detecção de Proxy
            Building Proxy Servers: Construindo Servidores Proxy
            Legal & Ethical: Legal & Ética
            Fingerprinting: Fingerprinting
            Network Fingerprinting: Fingerprinting de Rede
            Browser Fingerprinting: Fingerprinting do Navegador
            Behavioral Fingerprinting: Fingerprinting Comportamental
            Evasion Techniques: Técnicas de Evasão
            Practical Guides: Guias Práticos
            CSS Selectors vs XPath: Seletores CSS vs XPath
            API Reference: Referência da API
            Browser: Navegador
            Chrome: Chrome
            Edge: Edge
            Options: Opções
            Tab: Aba
            Requests: Requisições
            Managers: Gerenciadores
            Elements: Elementos
            WebElement: Elemento Web
            ShadowRoot: Shadow Root
            Mixins: Mixins
            Connection: Conexão
            Connection Handler: Manipulador de Conexão
            Commands: Comandos
            DOM: DOM
            Input: Entrada
            Network: Rede
            Page: Página
            Runtime: Tempo de Execução
            Storage: Armazenamento
            Target: Alvo
            Fetch: Fetch
            Protocol: Protocolo
            Base Types: Tipos Base
            Overview: Visão Geral
            Events: Eventos
            Browser: Navegador
            DOM: DOM
            Fetch: Fetch
            Input: Entrada
            Network: Rede
            Page: Página
            Runtime: Tempo de Execução
            Storage: Armazenamento
            Target: Alvo
            Core: Núcleo
            Constants: Constantes
            Exceptions: Exceções
            Utils: Utilitários
  - mkdocstrings:
      handlers:
        python:
          options:
            show_root_heading: true
            show_if_no_docstring: true
            inherited_members: true
            members_order: source
            separate_signature: true
            filters:
            - '!^_'
            - '!^__'
            merge_init_into_class: true
            docstring_section_style: spacy
            signature_crossrefs: true
            show_symbol_type_heading: true
            show_symbol_type_toc: true
            show_source: false
            show_bases: true
            heading_level: 1

extra:   
  alternate:
    - name: English
      link: /docs/
      lang: en
    - name: Português (BR)
      link: /docs/pt/
      lang: pt
    - name: 中文
      link: /docs/zh/
      lang: zh

extra_css:
  - resources/stylesheets/termynal.css
  - resources/stylesheets/extra.css

extra_javascript:
  - resources/scripts/termynal.js
  - resources/scripts/extra.js
  - https://unpkg.com/mermaid@10.0.0/dist/mermaid.min.js

markdown_extensions:
  - pymdownx.critic
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.details
  - pymdownx.keys
  - footnotes
  - admonition
  - markdown.extensions.attr_list
  - pymdownx.tabbed:
      alternate_style: true
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - md_in_html