moodle-docs-theme 0.2.1__tar.gz → 0.4.0__tar.gz

{moodle_docs_theme-0.2.1/moodle_docs_theme.egg-info → moodle_docs_theme-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moodle-docs-theme
-Version: 0.2.1
+Version: 0.4.0
 Summary: Um tema Sphinx reutilizável inspirado visualmente na documentação oficial do Moodle (docs.moodle.org)
 Home-page: https://github.com/moodle-by-kelsoncm/moodle-docs-theme
 Author: KelsonCM
@@ -13,15 +13,15 @@ Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: sphinx>=4.0
@@ -44,7 +44,7 @@ mantidos por organizações no GitHub. Mantém a mesma identidade visual — cab
 com faixa de destaque laranja, títulos em roxo, links em azul — em toda a documentação
 da sua organização.
 
-![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![Sphinx](https://img.shields.io/badge/sphinx-4.0%2B-green)
 ![CI & Docs](https://github.com/moodle-by-kelsoncm/moodle-docs-theme/actions/workflows/publish-pypi.yml/badge.svg)
 ![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)
@@ -56,6 +56,7 @@ da sua organização.
 - **Design inspirado no MoodleDocs**: cabeçalho claro com faixa de destaque laranja
   (`#f98012`), títulos em roxo (`#6c336d`), links em azul (`#3366cc`) — a mesma
   linguagem visual do docs.moodle.org.
+- **Internacionalização bilíngue**: suporte nativo aos idiomas Inglês (`en`, default) e Português do Brasil (`pt-br`), com seletor de bandeiras (EUA e Brasil) no cabeçalho e roteador inteligente `index.html` na raiz.
 - **Modo escuro**: alternância de tema claro/escuro com detecção de preferência do
   sistema e persistência em `localStorage`.
 - **Customização simples**: cores, logotipo, fontes e links de navegação configuráveis

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/README.md

@@ -8,7 +8,7 @@ mantidos por organizações no GitHub. Mantém a mesma identidade visual — cab
 com faixa de destaque laranja, títulos em roxo, links em azul — em toda a documentação
 da sua organização.
 
-![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![Sphinx](https://img.shields.io/badge/sphinx-4.0%2B-green)
 ![CI & Docs](https://github.com/moodle-by-kelsoncm/moodle-docs-theme/actions/workflows/publish-pypi.yml/badge.svg)
 ![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)
@@ -20,6 +20,7 @@ da sua organização.
 - **Design inspirado no MoodleDocs**: cabeçalho claro com faixa de destaque laranja
   (`#f98012`), títulos em roxo (`#6c336d`), links em azul (`#3366cc`) — a mesma
   linguagem visual do docs.moodle.org.
+- **Internacionalização bilíngue**: suporte nativo aos idiomas Inglês (`en`, default) e Português do Brasil (`pt-br`), com seletor de bandeiras (EUA e Brasil) no cabeçalho e roteador inteligente `index.html` na raiz.
 - **Modo escuro**: alternância de tema claro/escuro com detecção de preferência do
   sistema e persistência em `localStorage`.
 - **Customização simples**: cores, logotipo, fontes e links de navegação configuráveis

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/__init__.py

@@ -5,7 +5,7 @@ moodle_docs_theme - A reusable Sphinx HTML theme inspired by docs.moodle.org (Mo
 import os
 from typing import Dict, Any
 
-__version__ = "0.2.1"
+__version__ = "0.4.0"
 
 
 def get_html_theme_path() -> str:

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/cli.py

@@ -66,12 +66,18 @@ def cmd_init(args: argparse.Namespace) -> int:
     plugin_path = args.plugin_path or inferred_path
     plugin_dir_name = args.plugin_dir_name or inferred_dir
 
+    tagline_en = getattr(args, "tagline_en", None) or f"Official documentation for {project_name}"
+    tagline_pt = getattr(args, "tagline_pt", None) or tagline or f"Documentação oficial de {project_name}"
+
     context: dict[str, str] = {
         "project_name": project_name,
+        "project_underline": "=" * max(len(project_name), 10),
         "repo_name": repo_name,
         "github_url": github_url,
         "github_repo": repo_name,
         "tagline": tagline,
+        "tagline_en": tagline_en,
+        "tagline_pt": tagline_pt,
         "version": version,
         "year": year,
         "plugin_path": plugin_path,
@@ -84,39 +90,89 @@ def cmd_init(args: argparse.Namespace) -> int:
 
     target_docs_dir.mkdir(parents=True, exist_ok=True)
 
-    files_to_render = [
-        ("conf.py.tpl", "conf.py"),
-        ("index.md.tpl", "index.md"),
-        ("installation.md.tpl", "installation.md"),
-        ("configuration.md.tpl", "configuration.md"),
-        ("usage.md.tpl", "usage.md"),
-    ]
-
-    print(f"-> Inicializando template de documentação em: {target_path}")
-
     created_files: list[str] = []
-    for src_name, dst_name in files_to_render:
-        src_file = template_docs_dir / src_name
-        dst_file = target_docs_dir / dst_name
-
-        if dst_file.exists() and not args.force:
-            print(f"   [IGNORADO] Arquivo já existe: {dst_file.relative_to(target_path)} (use --force para sobrescrever)")
-            continue
+    print(f"-> Inicializando template de documentação em: {target_path}")
 
-        rendered = _render_template(src_file, context)
-        dst_file.write_text(rendered, encoding="utf-8")
-        created_files.append(str(dst_file.relative_to(target_path)))
-        print(f"   [CRIADO]   {dst_file.relative_to(target_path)}")
+    single_lang = getattr(args, "single_lang", False)
+
+    if single_lang:
+        # Modo legado (monolíngue) na raiz de docs/
+        files_to_render = [
+            ("conf.py.tpl", "conf.py"),
+            ("index.md.tpl", "index.md"),
+            ("installation.md.tpl", "installation.md"),
+            ("configuration.md.tpl", "configuration.md"),
+            ("usage.md.tpl", "usage.md"),
+        ]
+        for src_name, dst_name in files_to_render:
+            src_file = template_docs_dir / src_name
+            dst_file = target_docs_dir / dst_name
+
+            if dst_file.exists() and not args.force:
+                print(f"   [IGNORADO] Arquivo já existe: {dst_file.relative_to(target_path)} (use --force para sobrescrever)")
+                continue
+
+            rendered = _render_template(src_file, context)
+            dst_file.write_text(rendered, encoding="utf-8")
+            created_files.append(str(dst_file.relative_to(target_path)))
+            print(f"   [CRIADO]   {dst_file.relative_to(target_path)}")
+    else:
+        # Modo bilíngue padrão: docs/en e docs/pt-br com index.html na raiz
+        idx_src = template_docs_dir / "index.html"
+        idx_dst = target_docs_dir / "index.html"
+        if idx_src.exists():
+            if not idx_dst.exists() or args.force:
+                shutil.copy2(idx_src, idx_dst)
+                created_files.append(str(idx_dst.relative_to(target_path)))
+                print(f"   [CRIADO]   {idx_dst.relative_to(target_path)}")
+            else:
+                print(f"   [IGNORADO] Arquivo já existe: {idx_dst.relative_to(target_path)}")
+
+        bilingual_specs = [
+            ("en", [
+                ("conf.py.tpl", "conf.py"),
+                ("index.rst.tpl", "index.rst"),
+                ("installation.rst.tpl", "installation.rst"),
+                ("configuration.rst.tpl", "configuration.rst"),
+                ("usage.rst.tpl", "usage.rst"),
+            ]),
+            ("pt-br", [
+                ("conf.py.tpl", "conf.py"),
+                ("index.rst.tpl", "index.rst"),
+                ("installation.rst.tpl", "installation.rst"),
+                ("configuration.rst.tpl", "configuration.rst"),
+                ("usage.rst.tpl", "usage.rst"),
+            ]),
+        ]
+
+        for lang_folder, files in bilingual_specs:
+            lang_dir = target_docs_dir / lang_folder
+            lang_dir.mkdir(parents=True, exist_ok=True)
+            tpl_lang_dir = template_docs_dir / lang_folder
+
+            for src_name, dst_name in files:
+                src_file = tpl_lang_dir / src_name
+                dst_file = lang_dir / dst_name
+
+                if dst_file.exists() and not args.force:
+                    print(f"   [IGNORADO] Arquivo já existe: {dst_file.relative_to(target_path)} (use --force para sobrescrever)")
+                    continue
+
+                rendered = _render_template(src_file, context)
+                dst_file.write_text(rendered, encoding="utf-8")
+                created_files.append(str(dst_file.relative_to(target_path)))
+                print(f"   [CRIADO]   {dst_file.relative_to(target_path)}")
 
     # requirements.txt
     req_src = template_docs_dir / "requirements.txt"
     req_dst = target_docs_dir / "requirements.txt"
-    if not req_dst.exists() or args.force:
-        shutil.copy2(req_src, req_dst)
-        created_files.append(str(req_dst.relative_to(target_path)))
-        print(f"   [CRIADO]   {req_dst.relative_to(target_path)}")
-    else:
-        print(f"   [IGNORADO] Arquivo já existe: {req_dst.relative_to(target_path)}")
+    if req_src.exists():
+        if not req_dst.exists() or args.force:
+            shutil.copy2(req_src, req_dst)
+            created_files.append(str(req_dst.relative_to(target_path)))
+            print(f"   [CRIADO]   {req_dst.relative_to(target_path)}")
+        else:
+            print(f"   [IGNORADO] Arquivo já existe: {req_dst.relative_to(target_path)}")
 
     # Workflow do GitHub Actions
     if not args.no_workflow:
@@ -139,7 +195,7 @@ def cmd_init(args: argparse.Namespace) -> int:
 
 def cmd_build(args: argparse.Namespace) -> int:
     """
-    Compila a documentação usando Sphinx e moodle-docs-theme.
+    Compila a documentação usando Sphinx e moodle-docs-theme (suporta bilíngue en e pt-br).
     """
     docs_dir = Path(args.docs_dir).resolve()
     output_dir = Path(args.output_dir).resolve()
@@ -148,17 +204,52 @@ def cmd_build(args: argparse.Namespace) -> int:
         print(f"Erro: Diretório de documentação não encontrado: '{docs_dir}'", file=sys.stderr)
         return 1
 
-    conf_file = docs_dir / "conf.py"
-    if not conf_file.exists():
-        print(f"Erro: Arquivo 'conf.py' não encontrado em: '{docs_dir}'", file=sys.stderr)
-        return 1
-
     if args.clean and output_dir.exists():
         print(f"-> Limpando diretório de saída: '{output_dir}'")
         shutil.rmtree(output_dir)
 
     output_dir.mkdir(parents=True, exist_ok=True)
 
+    en_dir = docs_dir / "en"
+    pt_dir = docs_dir / "pt-br"
+
+    if en_dir.exists() and (en_dir / "conf.py").exists() and pt_dir.exists() and (pt_dir / "conf.py").exists():
+        print(f"-> Detectada documentação bilíngue em '{docs_dir}' (en e pt-br)")
+        # Compila EN
+        en_out = output_dir / "en"
+        en_out.mkdir(parents=True, exist_ok=True)
+        cmd_en = [sys.executable, "-m", "sphinx", "-b", args.builder]
+        if args.warnings_as_errors:
+            cmd_en.append("-W")
+        cmd_en.extend([str(en_dir), str(en_out)])
+        res_en = subprocess.run(cmd_en, check=False)
+        if res_en.returncode != 0:
+            return res_en.returncode
+
+        # Compila PT-BR
+        pt_out = output_dir / "pt-br"
+        pt_out.mkdir(parents=True, exist_ok=True)
+        cmd_pt = [sys.executable, "-m", "sphinx", "-b", args.builder]
+        if args.warnings_as_errors:
+            cmd_pt.append("-W")
+        cmd_pt.extend([str(pt_dir), str(pt_out)])
+        res_pt = subprocess.run(cmd_pt, check=False)
+        if res_pt.returncode != 0:
+            return res_pt.returncode
+
+        # Copia roteador index.html se existir
+        index_html = docs_dir / "index.html"
+        if index_html.exists():
+            shutil.copy2(index_html, output_dir / "index.html")
+
+        print(f"\nDocumentação bilíngue gerada com sucesso em: {output_dir}")
+        return 0
+
+    conf_file = docs_dir / "conf.py"
+    if not conf_file.exists():
+        print(f"Erro: Arquivo 'conf.py' não encontrado em: '{docs_dir}'", file=sys.stderr)
+        return 1
+
     sphinx_cmd = [
         sys.executable,
         "-m",
@@ -244,6 +335,19 @@ def build_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Sobrescreve arquivos existentes caso já estejam presentes.",
     )
+    init_parser.add_argument(
+        "--single-lang",
+        action="store_true",
+        help="Gera template em idioma único na raiz de docs/ (modo legado). Por padrão, gera estrutura bilíngue (en e pt-br).",
+    )
+    init_parser.add_argument(
+        "--tagline-en",
+        help="Tagline em inglês para a documentação.",
+    )
+    init_parser.add_argument(
+        "--tagline-pt",
+        help="Tagline em português para a documentação.",
+    )
     init_parser.add_argument(
         "--no-workflow",
         action="store_true",

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/layout.html

@@ -77,6 +77,47 @@
 
       {# Right-side tools: Header Search & Dark Mode Toggle #}
       <div class="moodle-header-tools">
+        {# Seletor de Idioma Bilíngue (Bandeiras EUA e Brasil) #}
+        {% if theme_enable_language_selector is not defined or theme_enable_language_selector|tobool %}
+        <div class="moodle-lang-selector" aria-label="Seletor de idioma / Language selector">
+          {% set current_l = language if language else 'en' %}
+          {% set is_en = current_l.lower().startswith('en') %}
+          {% set page_slug = pagename.split('/')[-1] %}
+          <a href="{% if is_en %}#{% else %}../en/{{ page_slug }}.html{% endif %}"
+             class="moodle-lang-btn {% if is_en %}active{% endif %}"
+             data-lang="en"
+             title="English"
+             aria-label="English">
+            <svg class="moodle-flag-icon" viewBox="0 0 24 16" width="22" height="15" aria-hidden="true">
+              <rect width="24" height="16" fill="#b22234" rx="2" />
+              <path d="M0 2.46h24M0 4.92h24M0 7.38h24M0 9.84h24M0 12.3h24M0 14.76h24" stroke="#fff" stroke-width="1.23" />
+              <rect width="10" height="8.62" fill="#3c3b6e" rx="1" />
+              <circle cx="2.5" cy="2.15" r="0.6" fill="#fff" />
+              <circle cx="5.0" cy="2.15" r="0.6" fill="#fff" />
+              <circle cx="7.5" cy="2.15" r="0.6" fill="#fff" />
+              <circle cx="3.75" cy="4.31" r="0.6" fill="#fff" />
+              <circle cx="6.25" cy="4.31" r="0.6" fill="#fff" />
+              <circle cx="2.5" cy="6.46" r="0.6" fill="#fff" />
+              <circle cx="5.0" cy="6.46" r="0.6" fill="#fff" />
+              <circle cx="7.5" cy="6.46" r="0.6" fill="#fff" />
+            </svg>
+          </a>
+          <span class="moodle-lang-divider">|</span>
+          <a href="{% if not is_en %}#{% else %}../pt-br/{{ page_slug }}.html{% endif %}"
+             class="moodle-lang-btn {% if not is_en %}active{% endif %}"
+             data-lang="pt-br"
+             title="Português (Brasil)"
+             aria-label="Português (Brasil)">
+            <svg class="moodle-flag-icon" viewBox="0 0 24 16" width="22" height="15" aria-hidden="true">
+              <rect width="24" height="16" fill="#009b3a" rx="2" />
+              <path d="M12 2.2L21.5 8 12 13.8 2.5 8z" fill="#fedf00" />
+              <circle cx="12" cy="8" r="3.4" fill="#002776" />
+              <path d="M8.8 8.4a3.4 3.4 0 0 1 6.2-.8" stroke="#fff" stroke-width="0.7" fill="none" />
+            </svg>
+          </a>
+        </div>
+        {% endif %}
+
         <form action="{{ pathto('search') }}" method="get" class="moodle-header-search">
           <input type="text" name="q" placeholder="Buscar..." aria-label="Buscar na documentação" required />
           <input type="hidden" name="check_keywords" value="yes" />

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/static/css/base.css

@@ -149,6 +149,56 @@ img {
   font-size: 0.85rem;
 }
 
+/* Language Selector (Bandeiras Bilíngues) */
+.moodle-lang-selector {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  background-color: var(--moodle-search-btn-bg);
+  padding: 0.2rem 0.45rem;
+  border-radius: 6px;
+  border: 1px solid var(--moodle-border);
+}
+
+.moodle-lang-btn {
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.15rem 0.25rem;
+  border-radius: 4px;
+  transition: all 0.2s ease;
+  line-height: 1;
+  opacity: 0.55;
+  border: 1px solid transparent;
+}
+
+.moodle-lang-btn:hover {
+  opacity: 1;
+  transform: scale(1.08);
+}
+
+.moodle-lang-btn.active {
+  opacity: 1;
+  background: var(--moodle-accent-soft);
+  border-color: var(--moodle-primary);
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.15);
+}
+
+.moodle-flag-icon {
+  display: block;
+  width: 22px;
+  height: 15px;
+  border-radius: 2px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
+}
+
+.moodle-lang-divider {
+  color: var(--moodle-border);
+  font-size: 0.75rem;
+  user-select: none;
+}
+
 /* Theme Toggle Button */
 .theme-toggle-btn {
   background: var(--moodle-search-btn-bg);

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/static/js/theme.js

@@ -18,6 +18,7 @@
 
 document.addEventListener('DOMContentLoaded', () => {
   initDarkMode();
+  initLanguageSelector();
   initMobileMenu();
   initCopyCodeButtons();
   initExternalLinks();
@@ -129,3 +130,23 @@ function initExternalLinks() {
     }
   });
 }
+
+/**
+ * Initialize Language Selector behavior (persist preference)
+ */
+function initLanguageSelector() {
+  const langBtns = document.querySelectorAll('.moodle-lang-btn');
+  langBtns.forEach((btn) => {
+    btn.addEventListener('click', (e) => {
+      const targetLang = btn.getAttribute('data-lang');
+      if (targetLang) {
+        try {
+          localStorage.setItem('user_lang', targetLang);
+        } catch (err) {}
+      }
+      if (btn.classList.contains('active') || btn.getAttribute('href') === '#') {
+        e.preventDefault();
+      }
+    });
+  });
+}

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/en/conf.py.tpl

@@ -0,0 +1,42 @@
+"""
+Sphinx configuration for {{ project_name }} (English).
+Documentation generated with moodle-docs-theme.
+"""
+import os
+import sys
+import moodle_docs_theme
+
+project = "{{ project_name }}"
+copyright = "{{ year }}, KelsonCM contributions to Moodle community"
+author = "KelsonCM"
+release = "{{ version }}"
+
+extensions = [
+    "sphinx.ext.githubpages",
+    "moodle_docs_theme",
+]
+
+templates_path = []
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+language = "en"
+
+html_theme = "moodle_docs_theme"
+html_theme_path = [moodle_docs_theme.get_html_theme_path()]
+
+html_theme_options = {
+    "primary_color": "#6c336d",
+    "secondary_color": "#f98012",
+    "project_name": "{{ project_name }}",
+    "tagline": "{{ tagline_en }}",
+    "github_url": "{{ github_url }}",
+    "github_repo": "{{ github_repo }}",
+    "github_version": "main",
+    "doc_path": "docs/en/",
+    "show_edit_on_github": True,
+    "enable_dark_mode": True,
+    "enable_language_selector": True,
+    "navigation_links": "Home|index, Installation|installation, Configuration|configuration, Usage|usage",
+}
+
+html_static_path = []

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/en/configuration.rst.tpl

@@ -0,0 +1,12 @@
+Configuration
+=============
+
+General Settings
+----------------
+
+Access the administration panel:
+
+1. Go to **Site Administration** > **Plugins**.
+2. Locate **{{ project_name }}**.
+3. Adjust settings according to your institution needs.
+4. Click **Save changes**.

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/en/index.rst.tpl

@@ -0,0 +1,23 @@
+{{ project_name }}
+{{ project_underline }}
+
+{{ tagline_en }}
+
+Overview
+========
+
+**{{ project_name }}** is an open-source Moodle plugin developed for the community.
+
+Repository
+----------
+- GitHub: `{{ github_repo }} <{{ github_url }}>`_
+
+Contents
+========
+
+.. toctree::
+   :maxdepth: 2
+
+   installation
+   configuration
+   usage

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/en/installation.rst.tpl

@@ -0,0 +1,29 @@
+Installation
+============
+
+Requirements
+------------
+
+- Moodle 4.1, 4.2, 4.3, 4.4 or higher
+- PHP 8.1 or higher
+
+Installation via Git
+--------------------
+
+Clone this repository into your Moodle installation under ``{{ plugin_path }}/{{ plugin_dir_name }}``:
+
+.. code-block:: bash
+
+   cd /path/to/moodle/{{ plugin_path }}
+   git clone {{ github_url }}.git {{ plugin_dir_name }}
+
+Completing Installation
+-----------------------
+
+1. Access the Moodle admin interface as administrator.
+2. Follow the on-screen instructions to complete the plugin database upgrade.
+3. Or run the CLI upgrade script:
+
+.. code-block:: bash
+
+   php admin/cli/upgrade.php

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/en/usage.rst.tpl

@@ -0,0 +1,14 @@
+Usage
+=====
+
+Getting Started
+---------------
+
+Once installed and configured, **{{ project_name }}** is ready for use within your courses and activities.
+
+Support & Issues
+----------------
+
+Found a bug or need assistance? Open an issue on GitHub:
+
+- `{{ github_repo }} Issues <{{ github_url }}/issues>`_

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/index.html

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Documentation — Redirecting</title>
+  <script>
+    (function() {
+      // 1. Verificar preferência salva previamente pelo usuário
+      var savedLang = null;
+      try {
+        savedLang = localStorage.getItem('user_lang');
+      } catch (e) {}
+
+      if (savedLang === 'pt-br' || savedLang === 'pt_BR' || savedLang === 'pt') {
+        window.location.replace('./pt-br/');
+        return;
+      }
+      if (savedLang === 'en') {
+        window.location.replace('./en/');
+        return;
+      }
+
+      // 2. Detecção automática baseada no navegador
+      var navLang = (navigator.language || navigator.userLanguage || '').toLowerCase();
+      if (navLang.startsWith('pt')) {
+        window.location.replace('./pt-br/');
+      } else {
+        // Fallback default: English
+        window.location.replace('./en/');
+      }
+    })();
+  </script>
+</head>
+<body>
+  <p>Redirecting to documentation... <a href="./en/">Click here if not redirected</a>.</p>
+</body>
+</html>

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/pt-br/conf.py.tpl

@@ -0,0 +1,42 @@
+"""
+Sphinx configuration for {{ project_name }} (Português do Brasil).
+Documentação gerada com o template moodle-docs-theme.
+"""
+import os
+import sys
+import moodle_docs_theme
+
+project = "{{ project_name }}"
+copyright = "{{ year }}, Contribuições de KelsonCM à comunidade Moodle"
+author = "KelsonCM"
+release = "{{ version }}"
+
+extensions = [
+    "sphinx.ext.githubpages",
+    "moodle_docs_theme",
+]
+
+templates_path = []
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+language = "pt_BR"
+
+html_theme = "moodle_docs_theme"
+html_theme_path = [moodle_docs_theme.get_html_theme_path()]
+
+html_theme_options = {
+    "primary_color": "#6c336d",
+    "secondary_color": "#f98012",
+    "project_name": "{{ project_name }}",
+    "tagline": "{{ tagline_pt }}",
+    "github_url": "{{ github_url }}",
+    "github_repo": "{{ github_repo }}",
+    "github_version": "main",
+    "doc_path": "docs/pt-br/",
+    "show_edit_on_github": True,
+    "enable_dark_mode": True,
+    "enable_language_selector": True,
+    "navigation_links": "Início|index, Instalação|installation, Configuração|configuration, Uso|usage",
+}
+
+html_static_path = []

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/pt-br/configuration.rst.tpl

@@ -0,0 +1,12 @@
+Configuração
+============
+
+Configurações Gerais
+--------------------
+
+Acesse o painel de administração:
+
+1. Vá em **Administração do Site** > **Plugins**.
+2. Localize **{{ project_name }}**.
+3. Ajuste os parâmetros conforme a necessidade de sua instituição.
+4. Clique em **Salvar mudanças**.

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/pt-br/index.rst.tpl

@@ -0,0 +1,23 @@
+{{ project_name }}
+{{ project_underline }}
+
+{{ tagline_pt }}
+
+Visão Geral
+===========
+
+O **{{ project_name }}** é um projeto de código aberto desenvolvido para a comunidade Moodle.
+
+Repositório
+-----------
+- GitHub: `{{ github_repo }} <{{ github_url }}>`_
+
+Sumário
+=======
+
+.. toctree::
+   :maxdepth: 2
+
+   installation
+   configuration
+   usage

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/pt-br/installation.rst.tpl

@@ -0,0 +1,29 @@
+Instalação
+==========
+
+Requisitos
+----------
+
+- Moodle 4.1, 4.2, 4.3, 4.4 ou superior
+- PHP 8.1 ou superior
+
+Instalação via Git
+------------------
+
+Clone o repositório na sua instalação Moodle dentro do diretório ``{{ plugin_path }}/{{ plugin_dir_name }}``:
+
+.. code-block:: bash
+
+   cd /path/to/moodle/{{ plugin_path }}
+   git clone {{ github_url }}.git {{ plugin_dir_name }}
+
+Concluindo a Instalação
+-----------------------
+
+1. Acesse o Moodle com uma conta de administrador.
+2. Siga as instruções na tela para concluir a atualização do banco de dados do plugin.
+3. Ou execute o comando via terminal CLI:
+
+.. code-block:: bash
+
+   php admin/cli/upgrade.php

moodle_docs_theme-0.4.0/moodle_docs_theme/template/docs/pt-br/usage.rst.tpl

@@ -0,0 +1,14 @@
+Uso
+===
+
+Primeiros Passos
+----------------
+
+Após instalado e configurado, o **{{ project_name }}** já está pronto para utilização em seus cursos e atividades.
+
+Suporte e Problemas
+-------------------
+
+Encontrou algum problema ou precisa de suporte? Abra uma issue no GitHub:
+
+- `{{ github_repo }} Issues <{{ github_url }}/issues>`_

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/template/workflows/docs.yml

@@ -37,7 +37,15 @@ jobs:
 
       - name: Build Documentation with Sphinx
         run: |
-          sphinx-build -W -b html docs docs/_build/html
+          if [ -d "docs/en" ] && [ -d "docs/pt-br" ]; then
+            sphinx-build -W -b html docs/en docs/_build/html/en
+            sphinx-build -W -b html docs/pt-br docs/_build/html/pt-br
+            if [ -f "docs/index.html" ]; then
+              cp docs/index.html docs/_build/html/index.html
+            fi
+          else
+            sphinx-build -W -b html docs docs/_build/html
+          fi
 
       - name: Upload Pages Artifact
         if: (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master') && github.event_name != 'pull_request'

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/theme.conf

@@ -27,4 +27,5 @@ doc_path = docs/
 navigation_links =
 show_edit_on_github = True
 enable_dark_mode = True
+enable_language_selector = True
 footer_custom_text =

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme/theme.toml

@@ -28,4 +28,5 @@ doc_path = "docs/"
 navigation_links = ""
 show_edit_on_github = true
 enable_dark_mode = true
+enable_language_selector = true
 footer_custom_text = ""

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0/moodle_docs_theme.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moodle-docs-theme
-Version: 0.2.1
+Version: 0.4.0
 Summary: Um tema Sphinx reutilizável inspirado visualmente na documentação oficial do Moodle (docs.moodle.org)
 Home-page: https://github.com/moodle-by-kelsoncm/moodle-docs-theme
 Author: KelsonCM
@@ -13,15 +13,15 @@ Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: sphinx>=4.0
@@ -44,7 +44,7 @@ mantidos por organizações no GitHub. Mantém a mesma identidade visual — cab
 com faixa de destaque laranja, títulos em roxo, links em azul — em toda a documentação
 da sua organização.
 
-![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![Sphinx](https://img.shields.io/badge/sphinx-4.0%2B-green)
 ![CI & Docs](https://github.com/moodle-by-kelsoncm/moodle-docs-theme/actions/workflows/publish-pypi.yml/badge.svg)
 ![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)
@@ -56,6 +56,7 @@ da sua organização.
 - **Design inspirado no MoodleDocs**: cabeçalho claro com faixa de destaque laranja
   (`#f98012`), títulos em roxo (`#6c336d`), links em azul (`#3366cc`) — a mesma
   linguagem visual do docs.moodle.org.
+- **Internacionalização bilíngue**: suporte nativo aos idiomas Inglês (`en`, default) e Português do Brasil (`pt-br`), com seletor de bandeiras (EUA e Brasil) no cabeçalho e roteador inteligente `index.html` na raiz.
 - **Modo escuro**: alternância de tema claro/escuro com detecção de preferência do
   sistema e persistência em `localStorage`.
 - **Customização simples**: cores, logotipo, fontes e links de navegação configuráveis

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/moodle_docs_theme.egg-info/SOURCES.txt

@@ -22,13 +22,24 @@ moodle_docs_theme/static/css/base.css
 moodle_docs_theme/static/css/colors.css
 moodle_docs_theme/static/js/theme.js
 moodle_docs_theme/template/__init__.py
-moodle_docs_theme/template/__pycache__/__init__.cpython-312.pyc
+moodle_docs_theme/template/__pycache__/__init__.cpython-314.pyc
 moodle_docs_theme/template/docs/conf.py.tpl
 moodle_docs_theme/template/docs/configuration.md.tpl
+moodle_docs_theme/template/docs/index.html
 moodle_docs_theme/template/docs/index.md.tpl
 moodle_docs_theme/template/docs/installation.md.tpl
 moodle_docs_theme/template/docs/requirements.txt
 moodle_docs_theme/template/docs/usage.md.tpl
+moodle_docs_theme/template/docs/en/conf.py.tpl
+moodle_docs_theme/template/docs/en/configuration.rst.tpl
+moodle_docs_theme/template/docs/en/index.rst.tpl
+moodle_docs_theme/template/docs/en/installation.rst.tpl
+moodle_docs_theme/template/docs/en/usage.rst.tpl
+moodle_docs_theme/template/docs/pt-br/conf.py.tpl
+moodle_docs_theme/template/docs/pt-br/configuration.rst.tpl
+moodle_docs_theme/template/docs/pt-br/index.rst.tpl
+moodle_docs_theme/template/docs/pt-br/installation.rst.tpl
+moodle_docs_theme/template/docs/pt-br/usage.rst.tpl
 moodle_docs_theme/template/workflows/docs.yml
 tests/test_cli.py
 tests/test_theme.py

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "moodle-docs-theme"
-version = "0.2.1"
+version = "0.4.0"
 description = "Um tema Sphinx reutilizável inspirado visualmente na documentação oficial do Moodle (docs.moodle.org)"
 readme = "README.md"
 authors = [
     { name = "KelsonCM", email = "kelsoncm@gmail.com" }
 ]
 license = "BSD-3-Clause"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 dependencies = [
     "sphinx>=4.0",
     "myst-parser>=2.0"
@@ -22,11 +22,11 @@ classifiers = [
     "Intended Audience :: Developers",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Documentation",
     "Topic :: Documentation :: Sphinx",
     "Topic :: Software Development :: Documentation"

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="moodle-docs-theme",
-    version="0.2.1",
+    version="0.4.0",
     author="KelsonCM",
     author_email="kelsoncm@gmail.com",
     description="Um tema Sphinx reutilizável inspirado visualmente na documentação oficial do Moodle (docs.moodle.org)",
@@ -29,7 +29,8 @@ setup(
         "moodle_docs_theme": [
             "*.html", "theme.conf", "theme.toml",
             "static/css/*.css", "static/js/*.js",
-            "template/docs/*", "template/workflows/*",
+            "template/docs/*", "template/docs/en/*", "template/docs/pt-br/*",
+            "template/workflows/*",
         ],
     },
     entry_points={
@@ -46,14 +47,14 @@ setup(
         "Intended Audience :: Developers",
         "Operating System :: OS Independent",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
         "Topic :: Documentation",
         "Topic :: Documentation :: Sphinx",
         "Topic :: Software Development :: Documentation",
     ],
-    python_requires=">=3.8",
+    python_requires=">=3.10",
 )

{moodle_docs_theme-0.2.1 → moodle_docs_theme-0.4.0}/tests/test_cli.py

@@ -50,19 +50,47 @@ class TestMoodleDocsThemeCLI(unittest.TestCase):
         self.assertEqual(exit_code, 0)
 
         docs_dir = target_dir / "docs"
-        self.assertTrue((docs_dir / "conf.py").exists())
-        self.assertTrue((docs_dir / "index.md").exists())
-        self.assertTrue((docs_dir / "installation.md").exists())
-        self.assertTrue((docs_dir / "configuration.md").exists())
-        self.assertTrue((docs_dir / "usage.md").exists())
+        self.assertTrue((docs_dir / "index.html").exists())
         self.assertTrue((docs_dir / "requirements.txt").exists())
         self.assertTrue((target_dir / ".github" / "workflows" / "docs.yml").exists())
 
+        # Verifica pasta en
+        en_dir = docs_dir / "en"
+        self.assertTrue((en_dir / "conf.py").exists())
+        self.assertTrue((en_dir / "index.rst").exists())
+        self.assertTrue((en_dir / "installation.rst").exists())
+        self.assertTrue((en_dir / "configuration.rst").exists())
+        self.assertTrue((en_dir / "usage.rst").exists())
+
+        # Verifica pasta pt-br
+        pt_dir = docs_dir / "pt-br"
+        self.assertTrue((pt_dir / "conf.py").exists())
+        self.assertTrue((pt_dir / "index.rst").exists())
+        self.assertTrue((pt_dir / "installation.rst").exists())
+        self.assertTrue((pt_dir / "configuration.rst").exists())
+        self.assertTrue((pt_dir / "usage.rst").exists())
+
         # Verifica conteúdo renderizado
-        conf_content = (docs_dir / "conf.py").read_text(encoding="utf-8")
-        self.assertIn('project = "tool_sample"', conf_content)
-        self.assertIn('"github_repo": "moodle-by-kelsoncm/tool_sample"', conf_content)
-        self.assertIn('"moodle_docs_theme"', conf_content)
+        conf_en = (en_dir / "conf.py").read_text(encoding="utf-8")
+        self.assertIn('project = "tool_sample"', conf_en)
+        self.assertIn('"github_repo": "moodle-by-kelsoncm/tool_sample"', conf_en)
+        self.assertIn('language = "en"', conf_en)
+
+        conf_pt = (pt_dir / "conf.py").read_text(encoding="utf-8")
+        self.assertIn('project = "tool_sample"', conf_pt)
+        self.assertIn('language = "pt_BR"', conf_pt)
+
+    def test_cli_init_single_lang(self):
+        target_dir = Path(self.test_dir) / "tool_single"
+        target_dir.mkdir()
+
+        exit_code = main(["init", str(target_dir), "--single-lang"])
+        self.assertEqual(exit_code, 0)
+
+        docs_dir = target_dir / "docs"
+        self.assertTrue((docs_dir / "conf.py").exists())
+        self.assertTrue((docs_dir / "index.md").exists())
+        self.assertTrue((docs_dir / "requirements.txt").exists())
 
     def test_cli_init_custom_options(self):
         target_dir = Path(self.test_dir) / "atto_custom"
@@ -74,16 +102,21 @@ class TestMoodleDocsThemeCLI(unittest.TestCase):
             "--project-name", "moodle-atto_custom",
             "--repo", "moodle-by-kelsoncm/atto_custom",
             "--tagline", "Custom Atto plugin description",
+            "--tagline-en", "English description",
+            "--tagline-pt", "Descrição em português",
             "--version-str", "2.1.0",
             "--no-workflow",
         ])
         self.assertEqual(exit_code, 0)
 
         docs_dir = target_dir / "docs"
-        conf_content = (docs_dir / "conf.py").read_text(encoding="utf-8")
-        self.assertIn('project = "moodle-atto_custom"', conf_content)
-        self.assertIn('release = "2.1.0"', conf_content)
-        self.assertIn('Custom Atto plugin description', conf_content)
+        conf_en = (docs_dir / "en" / "conf.py").read_text(encoding="utf-8")
+        self.assertIn('project = "moodle-atto_custom"', conf_en)
+        self.assertIn('release = "2.1.0"', conf_en)
+        self.assertIn('English description', conf_en)
+
+        conf_pt = (docs_dir / "pt-br" / "conf.py").read_text(encoding="utf-8")
+        self.assertIn('Descrição em português', conf_pt)
 
         # Sem workflow
         self.assertFalse((target_dir / ".github" / "workflows" / "docs.yml").exists())
@@ -92,18 +125,19 @@ class TestMoodleDocsThemeCLI(unittest.TestCase):
         target_dir = Path(self.test_dir) / "existing_repo"
         target_dir.mkdir()
         docs_dir = target_dir / "docs"
-        docs_dir.mkdir()
-        (docs_dir / "conf.py").write_text("existing content", encoding="utf-8")
+        en_dir = docs_dir / "en"
+        en_dir.mkdir(parents=True)
+        (en_dir / "conf.py").write_text("existing content", encoding="utf-8")
 
         exit_code = main(["init", str(target_dir)])
         self.assertEqual(exit_code, 0)
 
-        self.assertEqual((docs_dir / "conf.py").read_text(encoding="utf-8"), "existing content")
+        self.assertEqual((en_dir / "conf.py").read_text(encoding="utf-8"), "existing content")
 
         # Com --force deve sobrescrever
         exit_code = main(["init", str(target_dir), "--force"])
         self.assertEqual(exit_code, 0)
-        self.assertIn("moodle_docs_theme", (docs_dir / "conf.py").read_text(encoding="utf-8"))
+        self.assertIn("moodle_docs_theme", (en_dir / "conf.py").read_text(encoding="utf-8"))
 
     def test_cli_build_nonexistent_directory(self):
         nonexistent = str(Path(self.test_dir) / "nao_existe")