moodle-docs-theme 0.1.0__tar.gz

moodle_docs_theme-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Contribuições de KelsonCM à comunidade Moodle
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

moodle_docs_theme-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include moodle_docs_theme/theme.conf
+include moodle_docs_theme/theme.toml
+include moodle_docs_theme/*.html
+recursive-include moodle_docs_theme/static *

moodle_docs_theme-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: moodle-docs-theme
+Version: 0.1.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
+Author-email: KelsonCM <kelsoncm@gmail.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/moodle-by-kelsoncm/moodle-docs-theme
+Project-URL: Repository, https://github.com/moodle-by-kelsoncm/moodle-docs-theme
+Classifier: Development Status :: 4 - Beta
+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: Topic :: Documentation
+Classifier: Topic :: Documentation :: Sphinx
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sphinx>=4.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# moodle-docs-theme
+
+Tema sphinx baseado do Moodle Docs.
+
+Um **tema Sphinx reutilizável** inspirado visualmente na documentação oficial do Moodle
+([docs.moodle.org](https://docs.moodle.org/)), criado para temas e plugins Moodle
+mantidos por organizações no GitHub. Mantém a mesma identidade visual — cabeçalho claro
+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)
+![Sphinx](https://img.shields.io/badge/sphinx-4.0%2B-green)
+![CI & Docs](https://github.com/moodle-by-kelsoncm/moodle-docs-theme/actions/workflows/ci.yml/badge.svg)
+![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)
+
+---
+
+## Recursos principais
+
+- **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.
+- **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
+  via `conf.py`, sem editar CSS.
+- **Blocos de código interativos**: botão para copiar snippets com um clique.
+- **Editar no GitHub**: link automático para editar a página no repositório
+  correspondente.
+- **100% responsivo**: menu adaptado para dispositivos móveis e desktop.
+- **Automação GitHub Actions**: build e deploy de docs no GitHub Pages, publicação no
+  PyPI via *Trusted Publishing* a cada release.
+
+---
+
+## Instalação
+
+### Via PyPI
+
+```bash
+pip install moodle-docs-theme
+```
+
+### Instalação direta do GitHub
+
+```bash
+pip install git+https://github.com/moodle-by-kelsoncm/moodle-docs-theme.git
+```
+
+### Desenvolvimento local
+
+```bash
+git clone https://github.com/moodle-by-kelsoncm/moodle-docs-theme.git
+cd moodle-docs-theme
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+---
+
+## Configuração básica no `conf.py`
+
+No arquivo `conf.py` da documentação do seu tema ou plugin Moodle, adicione:
+
+```python
+import moodle_docs_theme
+
+html_theme = "moodle_docs_theme"
+html_theme_path = [moodle_docs_theme.get_html_theme_path()]
+
+extensions = [
+    "sphinx.ext.githubpages",
+]
+
+html_theme_options = {
+    "primary_color": "#6c336d",
+    "secondary_color": "#f98012",
+    "project_name": "Meu Plugin Moodle",
+    "logo": "logo.png",
+    "logo_height": "32px",
+    "github_url": "https://github.com/usuario/meu-plugin",
+    "github_repo": "usuario/meu-plugin",
+    "github_version": "main",
+    "doc_path": "docs/",
+    "show_edit_on_github": True,
+    "enable_dark_mode": True,
+    "navigation_links": "Início|index.html, Instalação|installation.html",
+}
+
+html_static_path = ["_static"]
+```
+
+Veja a [documentação completa](https://moodle-by-kelsoncm.github.io/moodle-docs-theme/)
+para a lista completa de opções.
+
+---
+
+## Estrutura do repositório
+
+```
+moodle-docs-theme/
+├── .github/
+│   └── workflows/
+│       ├── ci.yml             # Integração contínua e deploy no GitHub Pages
+│       └── publish-pypi.yml   # Deploy automático no PyPI via Trusted Publishing
+├── docs/                      # Documentação oficial do tema
+│   ├── conf.py
+│   ├── index.rst
+│   ├── installation.rst
+│   └── configuration.rst
+├── moodle_docs_theme/         # Código fonte do tema Sphinx
+│   ├── static/
+│   │   ├── css/
+│   │   │   ├── base.css
+│   │   │   └── colors.css
+│   │   └── js/
+│   │       └── theme.js
+│   ├── layout.html
+│   ├── page.html
+│   ├── searchbox.html
+│   ├── breadcrumbs.html
+│   ├── theme.conf
+│   ├── theme.toml
+│   └── __init__.py
+├── setup.py
+├── pyproject.toml
+├── MANIFEST.in
+├── LICENSE
+└── README.md
+```
+
+---
+
+## Compilando a documentação localmente
+
+```bash
+pip install -e .
+sphinx-build -b html docs docs/_build/html
+```
+
+---
+
+## Licença
+
+Este projeto está licenciado sob a Licença BSD 3-Clause. Consulte o arquivo
+[LICENSE](LICENSE) para mais detalhes.

moodle_docs_theme-0.1.0/README.md

@@ -0,0 +1,147 @@
+# moodle-docs-theme
+
+Tema sphinx baseado do Moodle Docs.
+
+Um **tema Sphinx reutilizável** inspirado visualmente na documentação oficial do Moodle
+([docs.moodle.org](https://docs.moodle.org/)), criado para temas e plugins Moodle
+mantidos por organizações no GitHub. Mantém a mesma identidade visual — cabeçalho claro
+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)
+![Sphinx](https://img.shields.io/badge/sphinx-4.0%2B-green)
+![CI & Docs](https://github.com/moodle-by-kelsoncm/moodle-docs-theme/actions/workflows/ci.yml/badge.svg)
+![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)
+
+---
+
+## Recursos principais
+
+- **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.
+- **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
+  via `conf.py`, sem editar CSS.
+- **Blocos de código interativos**: botão para copiar snippets com um clique.
+- **Editar no GitHub**: link automático para editar a página no repositório
+  correspondente.
+- **100% responsivo**: menu adaptado para dispositivos móveis e desktop.
+- **Automação GitHub Actions**: build e deploy de docs no GitHub Pages, publicação no
+  PyPI via *Trusted Publishing* a cada release.
+
+---
+
+## Instalação
+
+### Via PyPI
+
+```bash
+pip install moodle-docs-theme
+```
+
+### Instalação direta do GitHub
+
+```bash
+pip install git+https://github.com/moodle-by-kelsoncm/moodle-docs-theme.git
+```
+
+### Desenvolvimento local
+
+```bash
+git clone https://github.com/moodle-by-kelsoncm/moodle-docs-theme.git
+cd moodle-docs-theme
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+---
+
+## Configuração básica no `conf.py`
+
+No arquivo `conf.py` da documentação do seu tema ou plugin Moodle, adicione:
+
+```python
+import moodle_docs_theme
+
+html_theme = "moodle_docs_theme"
+html_theme_path = [moodle_docs_theme.get_html_theme_path()]
+
+extensions = [
+    "sphinx.ext.githubpages",
+]
+
+html_theme_options = {
+    "primary_color": "#6c336d",
+    "secondary_color": "#f98012",
+    "project_name": "Meu Plugin Moodle",
+    "logo": "logo.png",
+    "logo_height": "32px",
+    "github_url": "https://github.com/usuario/meu-plugin",
+    "github_repo": "usuario/meu-plugin",
+    "github_version": "main",
+    "doc_path": "docs/",
+    "show_edit_on_github": True,
+    "enable_dark_mode": True,
+    "navigation_links": "Início|index.html, Instalação|installation.html",
+}
+
+html_static_path = ["_static"]
+```
+
+Veja a [documentação completa](https://moodle-by-kelsoncm.github.io/moodle-docs-theme/)
+para a lista completa de opções.
+
+---
+
+## Estrutura do repositório
+
+```
+moodle-docs-theme/
+├── .github/
+│   └── workflows/
+│       ├── ci.yml             # Integração contínua e deploy no GitHub Pages
+│       └── publish-pypi.yml   # Deploy automático no PyPI via Trusted Publishing
+├── docs/                      # Documentação oficial do tema
+│   ├── conf.py
+│   ├── index.rst
+│   ├── installation.rst
+│   └── configuration.rst
+├── moodle_docs_theme/         # Código fonte do tema Sphinx
+│   ├── static/
+│   │   ├── css/
+│   │   │   ├── base.css
+│   │   │   └── colors.css
+│   │   └── js/
+│   │       └── theme.js
+│   ├── layout.html
+│   ├── page.html
+│   ├── searchbox.html
+│   ├── breadcrumbs.html
+│   ├── theme.conf
+│   ├── theme.toml
+│   └── __init__.py
+├── setup.py
+├── pyproject.toml
+├── MANIFEST.in
+├── LICENSE
+└── README.md
+```
+
+---
+
+## Compilando a documentação localmente
+
+```bash
+pip install -e .
+sphinx-build -b html docs docs/_build/html
+```
+
+---
+
+## Licença
+
+Este projeto está licenciado sob a Licença BSD 3-Clause. Consulte o arquivo
+[LICENSE](LICENSE) para mais detalhes.

moodle_docs_theme-0.1.0/moodle_docs_theme/__init__.py

@@ -0,0 +1,92 @@
+"""
+moodle_docs_theme - A reusable Sphinx HTML theme inspired by docs.moodle.org (MoodleDocs).
+"""
+
+import os
+from typing import Dict, Any
+
+__version__ = "0.1.0"
+
+
+def get_html_theme_path() -> str:
+    """
+    Return the absolute path to the directory containing theme.conf.
+
+    This function is maintained for backward compatibility with older Sphinx theme patterns.
+    Modern Sphinx 1.6+ discovers the theme automatically via entry points.
+    """
+    return os.path.abspath(os.path.dirname(__file__))
+
+
+def validate_github_actions_config(app: Any) -> None:
+    """
+    Validate Sphinx configuration when running inside GitHub Actions.
+
+    If GITHUB_ACTIONS == 'true', ensures that:
+    1. 'moodle_docs_theme' is present in app.config.extensions
+    2. 'sphinx.ext.githubpages' is present in app.config.extensions
+
+    Raises ExtensionError if requirements are not met.
+    """
+    is_github_actions = (
+        os.environ.get("GITHUB_ACTIONS") == "true" or "GITHUB_RUN_ID" in os.environ
+    )
+
+    if not is_github_actions:
+        return
+
+    extensions = getattr(app.config, "extensions", []) or []
+    missing_requirements = []
+
+    if "moodle_docs_theme" not in extensions:
+        missing_requirements.append(
+            "• 'moodle_docs_theme' deve estar listado em 'extensions = [...]' no seu docs/conf.py."
+        )
+
+    if "sphinx.ext.githubpages" not in extensions:
+        missing_requirements.append(
+            "• 'sphinx.ext.githubpages' deve estar listado em 'extensions = [...]' no seu docs/conf.py para gerar o arquivo .nojekyll e evitar que o GitHub Pages bloqueie a pasta _static/."
+        )
+
+    if missing_requirements:
+        error_msg = (
+            "\n"
+            "================================================================================\n"
+            "[moodle_docs_theme] ERRO DE CONFIGURAÇÃO NO GITHUB ACTIONS\n"
+            "================================================================================\n"
+            "Foi detectada a execução dentro do ambiente GitHub Actions, mas as configurações\n"
+            "obrigatórias do tema não foram encontradas no seu 'docs/conf.py':\n\n"
+            + "\n".join(missing_requirements)
+            + "\n\n"
+            "Por favor, certifique-se de atualizar o 'docs/conf.py' do seu projeto:\n\n"
+            "    extensions = [\n"
+            "        'sphinx.ext.autodoc',\n"
+            "        'sphinx.ext.githubpages',\n"
+            "        'moodle_docs_theme',\n"
+            "    ]\n\n"
+            "================================================================================\n"
+        )
+        from sphinx.errors import ExtensionError
+        raise ExtensionError(error_msg)
+
+
+def setup(app: Any) -> Dict[str, Any]:
+    """
+    Sphinx extension setup function.
+
+    Registers the theme with Sphinx when activated in conf.py.
+    """
+    theme_path = get_html_theme_path()
+    app.add_html_theme("moodle_docs_theme", theme_path)
+
+    app.add_css_file("css/colors.css")
+    app.add_css_file("css/base.css")
+    app.add_js_file("js/theme.js")
+
+    app.connect("builder-inited", validate_github_actions_config)
+
+    return {
+        "version": __version__,
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }

moodle_docs_theme-0.1.0/moodle_docs_theme/breadcrumbs.html

@@ -0,0 +1,38 @@
+{# Breadcrumbs navigation bar #}
+<div class="moodle-breadcrumbs-bar">
+  <div class="moodle-breadcrumbs-inner">
+    <nav aria-label="Breadcrumbs">
+      <ul class="moodle-breadcrumbs">
+        <li>
+          <a href="{{ pathto(master_doc) }}">{{ _('Início') }}</a>
+        </li>
+        {% for parent in parents %}
+          <li>
+            <a href="{{ parent.link|e }}">{{ parent.title }}</a>
+          </li>
+        {% endfor %}
+        {% if pagename != master_doc %}
+          <li aria-current="page">
+            <span>{{ title|striptags }}</span>
+          </li>
+        {% endif %}
+      </ul>
+    </nav>
+
+    {# Edit on GitHub link #}
+    {% if theme_show_edit_on_github|tobool and (theme_github_url or theme_github_repo) %}
+      {% set gh_repo = theme_github_repo if theme_github_repo else (theme_github_url.rstrip('/').split('/')[-2:] | join('/')) %}
+      {% set gh_version = theme_github_version if theme_github_version else 'main' %}
+      {% set gh_doc_path = theme_doc_path if theme_doc_path else 'docs/' %}
+      {% set file_ext = page_source_suffix if page_source_suffix and page_source_suffix is string else '.rst' %}
+      {% set edit_url = "https://github.com/" ~ gh_repo ~ "/edit/" ~ gh_version ~ "/" ~ gh_doc_path.rstrip('/') ~ "/" ~ pagename ~ file_ext %}
+      <a href="{{ edit_url }}" class="edit-on-github-link" target="_blank" rel="noopener noreferrer" title="Editar esta página no GitHub">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"></path>
+          <path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"></path>
+        </svg>
+        <span>Editar no GitHub</span>
+      </a>
+    {% endif %}
+  </div>
+</div>

moodle_docs_theme-0.1.0/moodle_docs_theme/layout.html

@@ -0,0 +1,179 @@
+{% extends "basic/layout.html" %}
+
+{% block doctype %}
+<!DOCTYPE html>
+{% endblock %}
+
+{% block htmltag %}
+<html lang="{{ language if language else 'pt-BR' }}">
+{% endblock %}
+
+{% block extrahead %}
+  {{ super() }}
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+
+  {# Script inline de inicialização instantânea do Dark Mode (Evita FOUC) #}
+  <script>
+    (function() {
+      try {
+        var storedTheme = localStorage.getItem('moodle-theme');
+        var systemPrefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+        var theme = storedTheme || (systemPrefersDark ? 'dark' : 'light');
+        if (theme === 'dark') {
+          document.documentElement.setAttribute('data-theme', 'dark');
+        } else {
+          document.documentElement.removeAttribute('data-theme');
+        }
+      } catch (e) {}
+    })();
+  </script>
+
+  {# Carregamento da fonte Open Sans via Google Fonts (mesma família usada no docs.moodle.org) #}
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Open+Sans:ital,wght@0,300;0,400;0,600;0,700;1,400&display=swap" rel="stylesheet">
+
+  {# Dynamic CSS Variable overrides from theme_options #}
+  <style>
+    :root {
+      {% if theme_primary_color %}--moodle-primary: {{ theme_primary_color }};{% endif %}
+      {% if theme_secondary_color %}--moodle-accent: {{ theme_secondary_color }}; --moodle-header-border: {{ theme_secondary_color }};{% endif %}
+      {% if theme_accent_color %}--moodle-sub-header-bg: {{ theme_accent_color }};{% endif %}
+      {% if theme_text_color %}--moodle-text: {{ theme_text_color }};{% endif %}
+      {% if theme_bg_color %}--moodle-bg: {{ theme_bg_color }};{% endif %}
+      {% if theme_code_bg_color %}--moodle-code-bg: {{ theme_code_bg_color }};{% endif %}
+      {% if theme_link_color %}--moodle-link: {{ theme_link_color }};{% endif %}
+      {% if theme_link_hover_color %}--moodle-link-hover: {{ theme_link_hover_color }};{% endif %}
+      {% if theme_sidebar_bg %}--moodle-sidebar-bg: {{ theme_sidebar_bg }};{% endif %}
+      {% if theme_nav_text_color %}--moodle-nav-text: {{ theme_nav_text_color }};{% endif %}
+    }
+  </style>
+{% endblock %}
+
+{% block header %}
+<div class="moodle-site-wrapper">
+  {# 1. Top Header Bar (Estilo MoodleDocs: fundo claro, marca à esquerda, faixa laranja inferior) #}
+  <header class="moodle-header">
+    <div class="moodle-header-inner">
+      {# Brand Logo & Name #}
+      <div class="moodle-brand-group">
+        <a href="{{ pathto(master_doc) }}" class="moodle-brand">
+          {% if theme_logo %}
+            <img src="{{ pathto('_static/' ~ theme_logo, 1) }}" alt="{{ project }}" class="moodle-brand-logo" style="{% if theme_logo_height %}height: {{ theme_logo_height }};{% endif %}" />
+          {% elif logo_url %}
+            <img src="{{ logo_url }}" alt="{{ project }}" class="moodle-brand-logo" />
+          {% elif logo %}
+            <img src="{{ pathto('_static/' ~ logo, 1) }}" alt="{{ project }}" class="moodle-brand-logo" />
+          {% else %}
+            <span class="moodle-brand-title">
+              {% if theme_project_name %}{{ theme_project_name }}{% else %}{{ project }}{% endif %}
+            </span>
+          {% endif %}
+        </a>
+        <span class="moodle-tagline">
+          {% if theme_tagline %}{{ theme_tagline }}{% else %}Documentação inspirada no MoodleDocs{% endif %}
+        </span>
+      </div>
+
+      {# Right-side tools: Header Search & Dark Mode Toggle #}
+      <div class="moodle-header-tools">
+        <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" />
+          <input type="hidden" name="area" value="default" />
+          <button type="submit" title="Buscar">🔍</button>
+        </form>
+
+        {% if theme_enable_dark_mode|tobool %}
+          <button id="theme-toggle" class="theme-toggle-btn" aria-label="Alternar modo claro/escuro" title="Alternar modo claro/escuro">
+            <span id="theme-toggle-icon">🌙</span>
+          </button>
+        {% endif %}
+      </div>
+    </div>
+  </header>
+
+  {# 2. Sub-Header Banner Strip (Estilo barra de contexto do MoodleDocs) #}
+  <section class="moodle-sub-header">
+    <div class="moodle-sub-header-inner">
+      <div class="moodle-sub-header-title">
+        <span>Documentação</span>
+        {% if release %}
+          <span class="moodle-version-badge">v{{ release }}</span>
+        {% endif %}
+      </div>
+      <div>
+        {% if theme_github_url %}
+          <a href="{{ theme_github_url }}" class="moodle-sub-header-link" target="_blank" rel="noopener noreferrer">Repositório no GitHub ↗</a>
+        {% endif %}
+      </div>
+    </div>
+  </section>
+{% endblock %}
+
+{% block content %}
+  {# 3. Main Layout Container (Artigo na ESQUERDA, Navegação na DIREITA, como no docs.moodle.org) #}
+  <div class="moodle-main-container">
+    {# Main Article Content (Esquerda) #}
+    <main class="moodle-content" role="main">
+      {% block body %}{% endblock %}
+    </main>
+
+    {# Sidebar Navegação (DIREITA - Estilo MoodleDocs) #}
+    {% block sidebar1 %}
+      <aside class="moodle-sidebar" id="moodle-sidebar" role="navigation" aria-label="Navegação Principal">
+        {% if theme_navigation_links %}
+          <div class="moodle-sidebar-section-title">Seções &amp; Links</div>
+          <nav>
+            <ul>
+              {% if theme_navigation_links is string %}
+                {% for item in theme_navigation_links.split(',') %}
+                  {% set parts = item.strip().split('|') %}
+                  {% set title = parts[0].strip() %}
+                  {% set target = parts[1].strip() if parts|length > 1 else master_doc %}
+                  <li class="{% if pagename in target or (target == master_doc and pagename == master_doc) %}current{% endif %}">
+                    {% if target.startswith('http://') or target.startswith('https://') %}
+                      <a href="{{ target }}" target="_blank" rel="noopener noreferrer">{{ title }} ↗</a>
+                    {% else %}
+                      {% set clean_target = target[:-5] if target.endswith('.html') else target %}
+                      <a href="{{ pathto(clean_target) }}" class="{% if pagename == clean_target %}current{% endif %}">{{ title }}</a>
+                    {% endif %}
+                  </li>
+                {% endfor %}
+              {% endif %}
+            </ul>
+          </nav>
+        {% endif %}
+      </aside>
+    {% endblock %}
+  </div>
+{% endblock %}
+
+{% block footer %}
+  {# Footer #}
+  <footer class="moodle-footer" role="contentinfo">
+    <div class="moodle-footer-inner">
+      <div>
+        {% if copyright %}
+          &copy; {{ copyright }}.
+        {% else %}
+          &copy; {{ last_updated_year if last_updated_year else '' }} {{ project }}.
+        {% endif %}
+        {% if theme_footer_custom_text %}
+          {{ theme_footer_custom_text }}
+        {% endif %}
+      </div>
+      <div>
+        Desenvolvido com inspiração na documentação oficial do
+        <a href="https://docs.moodle.org/" target="_blank" rel="noopener noreferrer">MoodleDocs</a> &amp;
+        <a href="https://www.sphinx-doc.org/" target="_blank" rel="noopener noreferrer">Sphinx</a>.
+      </div>
+      {% if theme_github_url %}
+        <div>
+          <a href="{{ theme_github_url }}" target="_blank" rel="noopener noreferrer">Ver código no GitHub</a>
+        </div>
+      {% endif %}
+    </div>
+  </footer>
+</div> {# End site wrapper #}
+{% endblock %}

moodle_docs_theme-0.1.0/moodle_docs_theme/page.html

@@ -0,0 +1,7 @@
+{% extends "layout.html" %}
+
+{% block body %}
+  <article class="moodle-page">
+    {{ body }}
+  </article>
+{% endblock %}