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
  - Getting Started:
      - Installation: getting-started.md
      - Your first automation: first-automation.md
      - Migrating from Selenium & Playwright: migrating.md
  - Basics:
      - Async Python in practice: basics/async-python.md
      - Selectors, CSS and XPath: basics/selectors.md
  - Guides:
      - Overview: guides/index.md
      - Core concepts: guides/core-concepts.md
      - Finding and extracting:
          - Element finding: guides/element-finding.md
          - DOM traversal: guides/dom-traversal.md
          - Structured extraction: guides/structured-extraction.md
      - Interacting:
          - Keyboard: guides/keyboard.md
          - Mouse: guides/mouse.md
          - File operations: guides/file-operations.md
          - Iframes: guides/iframes.md
          - Screenshots and PDFs: guides/screenshots-and-pdfs.md
      - Network:
          - Network monitoring: guides/network-monitoring.md
          - Request interception: guides/request-interception.md
          - Browser-context HTTP requests: guides/http-requests.md
          - HAR recording: guides/network-recording.md
      - Managing the browser:
          - Tabs: guides/tabs.md
          - Browser contexts: guides/browser-contexts.md
          - Cookies and sessions: guides/cookies-and-sessions.md
          - Browser options: guides/browser-options.md
          - Browser preferences: guides/browser-preferences.md
          - Proxies: guides/proxies.md
          - Remote connections: guides/remote-connections.md
      - Reacting to events:
          - Events: guides/events.md
          - Retrying: guides/retrying.md
  - Stealth:
      - Overview: stealth/index.md
      - Evasion techniques: stealth/evasion-techniques.md
      - Human-like interactions: stealth/human-like-interactions.md
      - Captcha bypass: stealth/captcha-bypass.md
      - Fingerprint injection: stealth/fingerprint-injection.md
  - Deep Dive:
      - Overview: deep-dive/index.md
      - Chrome DevTools Protocol: deep-dive/cdp.md
      - Network & proxies:
          - 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 a proxy server: 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
          - Auditing a fingerprint: deep-dive/fingerprinting/auditing.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
      - Elements:
          - WebElement: api/elements/web_element.md
          - ShadowRoot: api/elements/shadow_root.md
      - Extraction: api/extraction.md
      - Connection: api/connection/connection.md
      - Core:
          - Constants: api/core/constants.md
          - Exceptions: api/core/exceptions.md

theme:
  name: material
  custom_dir: overrides
  font:
    text: Chivo
    code: JetBrains Mono
  palette:
    scheme: slate
    primary: custom
    accent: indigo
  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
            Getting Started: 快速上手
            Installation: 安装
            Your first automation: 你的第一个自动化
            Migrating from Selenium & Playwright: 从 Selenium 和 Playwright 迁移
            Basics: 基础
            Async Python in practice: 异步 Python 实践
            Selectors, CSS and XPath: 选择器、CSS 和 XPath
            Guides: 指南
            Overview: 概述
            Core concepts: 核心概念
            Finding and extracting: 查找与提取
            Element finding: 元素查找
            DOM traversal: DOM 遍历
            Structured extraction: 结构化提取
            Interacting: 交互
            Keyboard: 键盘
            Mouse: 鼠标
            File operations: 文件操作
            Iframes: IFrame
            Screenshots and PDFs: 截图与 PDF
            Network: 网络
            Network monitoring: 网络监控
            Request interception: 请求拦截
            Browser-context HTTP requests: 浏览器上下文 HTTP 请求
            HAR recording: HAR 录制
            Managing the browser: 管理浏览器
            Tabs: 标签页
            Browser contexts: 浏览器上下文
            Cookies and sessions: Cookie 与会话
            Browser options: 浏览器选项
            Browser preferences: 浏览器偏好设置
            Proxies: 代理
            Remote connections: 远程连接
            Reacting to events: 响应事件
            Events: 事件
            Retrying: 重试
            Stealth: Stealth
            Evasion techniques: 规避技术
            Human-like interactions: 类人交互
            Captcha bypass: 验证码绕过
            Fingerprint injection: 指纹注入
            Deep Dive: 深入了解
            Chrome DevTools Protocol: Chrome DevTools 协议
            Network & proxies: 网络与代理
            Network fundamentals: 网络基础
            HTTP/HTTPS proxies: HTTP/HTTPS 代理
            SOCKS proxies: SOCKS 代理
            Proxy detection: 代理检测
            Building a proxy server: 构建代理服务器
            Legal & ethical: 法律与道德
            Fingerprinting: 指纹识别
            Network fingerprinting: 网络指纹识别
            Browser fingerprinting: 浏览器指纹识别
            Behavioral fingerprinting: 行为指纹识别
            Auditing a fingerprint: 审计一个 fingerprint
            API Reference: API 参考
            Browser: 浏览器
            Options: 选项
            Elements: 元素
            Constants: 常量
            Exceptions: 异常
        - locale: pt
          name: Português (BR)
          build: true
          site_name: "Pydoll - Biblioteca de Automação Web Assíncrona"
          nav_translations:
            Pydoll: Pydoll
            Getting Started: Primeiros passos
            Installation: Instalação
            Your first automation: Sua primeira automação
            Migrating from Selenium & Playwright: Migrando do Selenium e Playwright
            Basics: Fundamentos
            Async Python in practice: Python assíncrono na prática
            Selectors, CSS and XPath: Seletores, CSS e XPath
            Guides: Guias
            Overview: Visão geral
            Core concepts: Conceitos fundamentais
            Finding and extracting: Encontrar e extrair
            Element finding: Encontrar elementos
            DOM traversal: Percorrer o DOM
            Structured extraction: Extração estruturada
            Interacting: Interagir
            Keyboard: Teclado
            Mouse: Mouse
            File operations: Operações com arquivos
            Iframes: Iframes
            Screenshots and PDFs: Capturas de tela e PDFs
            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
            HAR recording: Gravação HAR
            Managing the browser: Gerenciar o navegador
            Tabs: Abas
            Browser contexts: Contextos do navegador
            Cookies and sessions: Cookies e sessões
            Browser options: Opções do navegador
            Browser preferences: Preferências do navegador
            Proxies: Proxies
            Remote connections: Conexões remotas
            Reacting to events: Reagir a eventos
            Events: Eventos
            Retrying: Repetição
            Stealth: Stealth
            Evasion techniques: Técnicas de evasão
            Human-like interactions: Interações humanizadas
            Captcha bypass: Bypass de captcha
            Fingerprint injection: Injeção de fingerprint
            Deep Dive: Análise profunda
            Chrome DevTools Protocol: Protocolo Chrome DevTools
            Network & proxies: Rede e proxies
            Network fundamentals: Fundamentos de rede
            HTTP/HTTPS proxies: Proxies HTTP/HTTPS
            SOCKS proxies: Proxies SOCKS
            Proxy detection: Detecção de proxy
            Building a proxy server: Construindo um servidor proxy
            Legal & ethical: Legal e ético
            Fingerprinting: Fingerprinting
            Network fingerprinting: Fingerprinting de rede
            Browser fingerprinting: Fingerprinting de navegador
            Behavioral fingerprinting: Fingerprinting comportamental
            Auditing a fingerprint: Auditando um fingerprint
            API Reference: Referência da API
            Browser: Navegador
            Options: Opções
            Elements: Elementos
            Constants: Constantes
            Exceptions: Exceções
  - 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
  - resources/stylesheets/landing-theme.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