mkdocs-ask-ai 0.3.0__tar.gz

mkdocs_ask_ai-0.3.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Ruben Khachaturov
+Copyright (c) 2024 Nok Lam Chan (original author)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mkdocs_ask_ai-0.3.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: mkdocs-ask-ai
+Version: 0.3.0
+Summary: MkDocs plugin for LLM-friendly documentation with direct markdown serving and i18n support
+Author-email: Ruben Khachaturov <mr.kha4a2rov@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mrkhachaturov/mkdocs-ask-ai
+Project-URL: Bug Reports, https://github.com/mrkhachaturov/mkdocs-ask-ai/issues
+Project-URL: Source, https://github.com/mrkhachaturov/mkdocs-ask-ai
+Keywords: mkdocs,plugin,llm,documentation,markdown,ai,llms-txt,i18n
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Documentation
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mkdocs>=1.4.0
+Dynamic: license-file
+
+# mkdocs-ask-ai
+
+MkDocs plugin for LLM-friendly documentation that provides:
+
+1. **Direct markdown serving** - Access original markdown at `page.md` URLs
+2. **llms.txt generation** - Concise index file for LLM context
+3. **llms-full.txt generation** - Complete documentation in single file
+4. **Copy-to-markdown button** - Easy copying of source markdown
+5. **i18n support** - Works with `mkdocs-static-i18n` (suffix structure)
+
+## Features
+
+- Source-first approach — works with original markdown, no HTML parsing
+- LLM optimized — token-efficient formats for AI consumption
+- Copy button — one-click markdown copying for developers
+- Dual URLs — both human-readable HTML and LLM-friendly markdown
+- Multilingual — generates separate `llms.txt` / `llms-full.txt` per locale
+
+> **Origin:** Forked from [mkdocs-llmstxt-md](https://github.com/noklam/mkdocs-llmstxt-md)
+> by Nok Lam Chan (MIT). This fork adds i18n support and will diverge
+> significantly from the upstream project.
+
+## Installation
+
+```bash
+pip install mkdocs-ask-ai
+```
+
+## Usage
+
+Add to your `mkdocs.yml`:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Getting Started":
+          - index.md: "Introduction to the project"
+          - quickstart.md
+        "API Reference":
+          - api/*.md
+```
+
+### With mkdocs-static-i18n
+
+Place the `ask-ai` plugin **before** `i18n` in the plugins list. The plugin
+automatically detects locale builds and writes `llms.txt` / `llms-full.txt`
+to each locale's output directory:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Docs":
+          - "*.md"
+  - i18n:
+      docs_structure: suffix
+      languages:
+        - locale: en
+          default: true
+          name: English
+        - locale: ru
+          name: Русский
+```
+
+This generates:
+- `site/llms.txt` — English index
+- `site/ru/llms.txt` — Russian index
+- `site/llms-full.txt` — English full docs
+- `site/ru/llms-full.txt` — Russian full docs
+
+## Configuration
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `sections` | `{}` | Dict of section names to file patterns |
+| `enable_markdown_urls` | `true` | Enable `.md` URL serving |
+| `enable_llms_txt` | `true` | Generate `llms.txt` |
+| `enable_llms_full` | `true` | Generate `llms-full.txt` |
+| `enable_copy_button` | `true` | Add copy button to pages |
+| `copy_button_text` | `"Copy Markdown"` | Text for the copy button |
+| `markdown_description` | — | Optional description in `llms.txt` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

mkdocs_ask_ai-0.3.0/README.md

@@ -0,0 +1,86 @@
+# mkdocs-ask-ai
+
+MkDocs plugin for LLM-friendly documentation that provides:
+
+1. **Direct markdown serving** - Access original markdown at `page.md` URLs
+2. **llms.txt generation** - Concise index file for LLM context
+3. **llms-full.txt generation** - Complete documentation in single file
+4. **Copy-to-markdown button** - Easy copying of source markdown
+5. **i18n support** - Works with `mkdocs-static-i18n` (suffix structure)
+
+## Features
+
+- Source-first approach — works with original markdown, no HTML parsing
+- LLM optimized — token-efficient formats for AI consumption
+- Copy button — one-click markdown copying for developers
+- Dual URLs — both human-readable HTML and LLM-friendly markdown
+- Multilingual — generates separate `llms.txt` / `llms-full.txt` per locale
+
+> **Origin:** Forked from [mkdocs-llmstxt-md](https://github.com/noklam/mkdocs-llmstxt-md)
+> by Nok Lam Chan (MIT). This fork adds i18n support and will diverge
+> significantly from the upstream project.
+
+## Installation
+
+```bash
+pip install mkdocs-ask-ai
+```
+
+## Usage
+
+Add to your `mkdocs.yml`:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Getting Started":
+          - index.md: "Introduction to the project"
+          - quickstart.md
+        "API Reference":
+          - api/*.md
+```
+
+### With mkdocs-static-i18n
+
+Place the `ask-ai` plugin **before** `i18n` in the plugins list. The plugin
+automatically detects locale builds and writes `llms.txt` / `llms-full.txt`
+to each locale's output directory:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Docs":
+          - "*.md"
+  - i18n:
+      docs_structure: suffix
+      languages:
+        - locale: en
+          default: true
+          name: English
+        - locale: ru
+          name: Русский
+```
+
+This generates:
+- `site/llms.txt` — English index
+- `site/ru/llms.txt` — Russian index
+- `site/llms-full.txt` — English full docs
+- `site/ru/llms-full.txt` — Russian full docs
+
+## Configuration
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `sections` | `{}` | Dict of section names to file patterns |
+| `enable_markdown_urls` | `true` | Enable `.md` URL serving |
+| `enable_llms_txt` | `true` | Generate `llms.txt` |
+| `enable_llms_full` | `true` | Generate `llms-full.txt` |
+| `enable_copy_button` | `true` | Add copy button to pages |
+| `copy_button_text` | `"Copy Markdown"` | Text for the copy button |
+| `markdown_description` | — | Optional description in `llms.txt` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

mkdocs_ask_ai-0.3.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mkdocs-ask-ai"
+version = "0.3.0"
+description = "MkDocs plugin for LLM-friendly documentation with direct markdown serving and i18n support"
+authors = [{ name = "Ruben Khachaturov", email = "mr.kha4a2rov@protonmail.com" }]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.9"
+keywords = ["mkdocs", "plugin", "llm", "documentation", "markdown", "ai", "llms-txt", "i18n"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "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 :: Software Development :: Documentation",
+]
+dependencies = ["mkdocs>=1.4.0"]
+
+[project.urls]
+"Homepage" = "https://github.com/mrkhachaturov/mkdocs-ask-ai"
+"Bug Reports" = "https://github.com/mrkhachaturov/mkdocs-ask-ai/issues"
+"Source" = "https://github.com/mrkhachaturov/mkdocs-ask-ai"
+
+[project.entry-points."mkdocs.plugins"]
+ask-ai = "mkdocs_ask_ai.plugin:LlmsTxtPlugin"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mkdocs_ask_ai = ["templates/*", "static/*"]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 88
+extend-exclude = ["test-site/", "build/", "dist/"]
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]
+ignore = [
+    "E501", # line too long, handled by formatter
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["mkdocs_ask_ai"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

mkdocs_ask_ai-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai/__init__.py

@@ -0,0 +1,7 @@
+"""MkDocs plugin for LLM-friendly documentation."""
+
+__version__ = "0.3.0"
+
+from .plugin import LlmsTxtPlugin
+
+__all__ = ["LlmsTxtPlugin"]

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai/config.py

@@ -0,0 +1,48 @@
+"""Configuration for the LLMsTxt plugin."""
+
+from mkdocs.config import config_options
+from mkdocs.config.base import Config
+
+
+class LLMsTxtConfig(Config):
+    """Configuration options for the LLMsTxt plugin."""
+
+    sections = config_options.Type(dict, default={})
+    """Dictionary mapping section names to lists of file patterns."""
+
+    enable_markdown_urls = config_options.Type(bool, default=True)
+    """Whether to serve original markdown at .md URLs."""
+
+    enable_llms_txt = config_options.Type(bool, default=True)
+    """Whether to generate llms.txt file."""
+
+    enable_llms_full = config_options.Type(bool, default=True)
+    """Whether to generate llms-full.txt file."""
+
+    enable_copy_button = config_options.Type(bool, default=True)
+    """Whether to add copy-to-markdown button on pages."""
+
+    copy_button_text = config_options.Type(str, default="Copy Markdown")
+    """Text for the copy button."""
+
+    copy_button_position = config_options.Type(
+        dict, default={"top": "80px", "right": "20px", "z_index": "1100"}
+    )
+    """Position and z-index settings for the copy button."""
+
+    copy_button_style = config_options.Type(
+        dict,
+        default={
+            "background": "#007acc",
+            "color": "white",
+            "border": "none",
+            "padding": "8px 16px",
+            "border_radius": "4px",
+            "font_size": "14px",
+            "box_shadow": "0 2px 4px rgba(0,0,0,0.2)",
+        },
+    )
+    """CSS styling options for the copy button."""
+
+    markdown_description = config_options.Optional(config_options.Type(str))
+    """Optional description to include in llms.txt."""

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai/plugin.py

@@ -0,0 +1,344 @@
+"""Main plugin class for LLMsTxt MkDocs plugin."""
+
+import fnmatch
+import mimetypes
+import re
+from pathlib import Path
+from typing import Any, Dict, List
+from urllib.parse import urljoin
+
+from mkdocs.config.defaults import MkDocsConfig
+from mkdocs.plugins import BasePlugin
+from mkdocs.structure.files import Files
+from mkdocs.structure.pages import Page
+
+from .config import LLMsTxtConfig
+
+# Pattern to match i18n locale suffixed files (e.g. page.ru.md, page.de.md)
+_I18N_SUFFIX_RE = re.compile(r"\.[a-z]{2,3}\.md$")
+
+
+class LlmsTxtPlugin(BasePlugin[LLMsTxtConfig]):
+    """MkDocs plugin for LLM-friendly documentation."""
+
+    def __init__(self):
+        super().__init__()
+        self.mkdocs_config: MkDocsConfig = None
+        self.pages_data: Dict[str, List[Dict[str, Any]]] = {}
+        self.source_files: Dict[str, str] = {}
+
+    def on_config(self, config: MkDocsConfig) -> MkDocsConfig:
+        """Store MkDocs configuration and validate settings."""
+        if not config.site_url:
+            raise ValueError(
+                "site_url must be set in MkDocs config for llms-txt plugin"
+            )
+
+        # Configure MIME type for .md files so they display in browser instead of downloading
+        if self.config.enable_markdown_urls:
+            mimetypes.add_type("text/plain", ".md")
+
+        self.mkdocs_config = config
+        self.pages_data = {section: [] for section in self.config.sections.keys()}
+        return config
+
+    def _is_i18n_alternate(self, src_path: str, files: Files) -> bool:
+        """Check if a file is an i18n alternate (e.g. page.ru.md).
+
+        These files are handled by the i18n plugin and should not be included
+        directly in glob results — they result in broken URLs.
+        """
+        return bool(_I18N_SUFFIX_RE.search(src_path))
+
+    def on_files(self, files: Files, *, config: MkDocsConfig) -> Files:
+        """Process files and expand glob patterns in sections."""
+        all_src_paths = [f.src_uri for f in files]
+
+        # Expand glob patterns in sections configuration
+        for section_name, file_patterns in self.config.sections.items():
+            if isinstance(file_patterns, list):
+                for pattern in file_patterns:
+                    if isinstance(pattern, dict):
+                        file_path = list(pattern.keys())[0]
+                        description = list(pattern.values())[0]
+                    else:
+                        file_path = pattern
+                        description = ""
+
+                    # Handle glob patterns
+                    if "*" in file_path:
+                        matches = fnmatch.filter(all_src_paths, file_path)
+                        for match in matches:
+                            if self._is_i18n_alternate(match, files):
+                                continue
+                            if match not in [
+                                p["src_uri"] for p in self.pages_data[section_name]
+                            ]:
+                                self.pages_data[section_name].append(
+                                    {"src_uri": match, "description": description}
+                                )
+                    else:
+                        if file_path in all_src_paths:
+                            if file_path not in [
+                                p["src_uri"] for p in self.pages_data[section_name]
+                            ]:
+                                self.pages_data[section_name].append(
+                                    {"src_uri": file_path, "description": description}
+                                )
+
+        return files
+
+    def on_page_markdown(
+        self, markdown: str, *, page: Page, config: MkDocsConfig, files: Files
+    ) -> str:
+        """Store original markdown content for later use."""
+        src_uri = page.file.src_uri
+
+        # For i18n: also try matching without locale suffix (e.g. page.ru.md -> page.md)
+        src_uri_base = _I18N_SUFFIX_RE.sub(".md", src_uri)
+
+        # Check if this page is in any of our sections
+        for _section_name, page_list in self.pages_data.items():
+            for page_data in page_list:
+                if page_data["src_uri"] in (src_uri, src_uri_base):
+                    dest_uri = page.file.dest_uri
+                    # Skip pages with no dest_uri
+                    if not dest_uri:
+                        continue
+                    self.source_files[src_uri] = markdown
+                    page_data.update(
+                        {
+                            "title": page.title or src_uri,
+                            "markdown": markdown,
+                            "dest_path": page.file.dest_path,
+                            "dest_uri": dest_uri,
+                        }
+                    )
+                    break
+
+        return markdown
+
+    def on_page_content(
+        self, html: str, *, page: Page, config: MkDocsConfig, files: Files
+    ) -> str:
+        """Inject copy button if enabled."""
+        if not self.config.enable_copy_button:
+            return html
+
+        src_uri = page.file.src_uri
+        if src_uri in self.source_files:
+            # Inject copy button HTML and JavaScript
+            copy_button_html = self._get_copy_button_html(config)
+            # Insert before closing body tag if present, otherwise at end
+            if "</body>" in html:
+                html = html.replace("</body>", f"{copy_button_html}</body>")
+            else:
+                html += copy_button_html
+
+        return html
+
+    def _detect_locale_prefix(self) -> str:
+        """Detect locale prefix from collected page dest_paths.
+
+        If pages have dest_paths like 'ru/infrastructure/index.html',
+        returns 'ru'. Returns '' for default locale (no prefix).
+        """
+        for section_pages in self.pages_data.values():
+            for page_data in section_pages:
+                dest_path = page_data.get("dest_path", "")
+                if dest_path:
+                    # Check if dest_path starts with a locale-like prefix (2-3 letter dir)
+                    parts = Path(dest_path).parts
+                    if len(parts) >= 2 and len(parts[0]) <= 3 and parts[0].isalpha():
+                        return parts[0]
+                    return ""
+        return ""
+
+    def _get_output_dir(self, config: MkDocsConfig) -> Path:
+        """Get the output directory, accounting for i18n locale subdirectories."""
+        site_dir = Path(config.site_dir)
+        locale_prefix = self._detect_locale_prefix()
+        if locale_prefix:
+            locale_dir = site_dir / locale_prefix
+            locale_dir.mkdir(parents=True, exist_ok=True)
+            return locale_dir
+        return site_dir
+
+    def on_post_build(self, *, config: MkDocsConfig) -> None:
+        """Generate llms.txt, llms-full.txt, and markdown files."""
+        output_dir = self._get_output_dir(config)
+        site_dir = Path(config.site_dir)
+
+        # Generate individual markdown files if markdown URLs are enabled
+        if self.config.enable_markdown_urls:
+            self._generate_markdown_files(site_dir)
+
+        # Generate llms.txt
+        if self.config.enable_llms_txt:
+            self._generate_llms_txt(output_dir, config)
+
+        # Generate llms-full.txt
+        if self.config.enable_llms_full:
+            self._generate_llms_full_txt(output_dir, config)
+
+    def _generate_markdown_files(self, site_dir: Path) -> None:
+        """Generate individual .md files for each page."""
+        for section_pages in self.pages_data.values():
+            for page_data in section_pages:
+                if "markdown" in page_data and "dest_path" in page_data:
+                    # Create .md version alongside HTML
+                    html_path = Path(page_data["dest_path"])
+                    md_path = site_dir / html_path.with_suffix(".md")
+
+                    # Ensure directory exists
+                    md_path.parent.mkdir(parents=True, exist_ok=True)
+
+                    # Write markdown content
+                    md_path.write_text(page_data["markdown"], encoding="utf-8")
+
+    def _generate_llms_txt(self, site_dir: Path, config: MkDocsConfig) -> None:
+        """Generate the llms.txt index file."""
+        llms_txt_path = site_dir / "llms.txt"
+
+        content = f"# {config.site_name}\n\n"
+
+        if config.site_description:
+            content += f"> {config.site_description}\n\n"
+
+        if self.config.markdown_description:
+            content += f"{self.config.markdown_description}\n\n"
+
+        base_url = config.site_url.rstrip("/")
+
+        for section_name, pages in self.pages_data.items():
+            if pages:  # Only add section if it has pages
+                content += f"## {section_name}\n\n"
+
+                for page_data in pages:
+                    dest_uri = page_data.get("dest_uri", "")
+                    if not dest_uri:
+                        continue
+                    title = page_data.get("title", page_data["src_uri"])
+                    description = page_data.get("description", "")
+
+                    # Create markdown URL
+                    md_url = urljoin(
+                        base_url + "/",
+                        dest_uri.replace(".html", ".md")
+                        if dest_uri.endswith(".html")
+                        else dest_uri + ".md",
+                    )
+
+                    desc_text = f": {description}" if description else ""
+                    content += f"- [{title}]({md_url}){desc_text}\n"
+
+                content += "\n"
+
+        llms_txt_path.write_text(content.strip(), encoding="utf-8")
+
+    def _generate_llms_full_txt(self, site_dir: Path, config: MkDocsConfig) -> None:
+        """Generate the llms-full.txt complete documentation file."""
+        llms_full_path = site_dir / "llms-full.txt"
+
+        content = f"# {config.site_name}\n\n"
+
+        if config.site_description:
+            content += f"> {config.site_description}\n\n"
+
+        if self.config.markdown_description:
+            content += f"{self.config.markdown_description}\n\n"
+
+        for section_name, pages in self.pages_data.items():
+            if pages:  # Only add section if it has pages
+                content += f"# {section_name}\n\n"
+
+                for page_data in pages:
+                    if "markdown" in page_data:
+                        title = page_data.get("title", page_data["src_uri"])
+                        content += f"## {title}\n\n"
+                        content += f"{page_data['markdown']}\n\n"
+
+        llms_full_path.write_text(content.strip(), encoding="utf-8")
+
+    def _get_theme_adjustments(self, config: MkDocsConfig) -> Dict[str, str]:
+        """Get theme-specific adjustments for copy button positioning."""
+        theme_name = (
+            config.theme.name if hasattr(config.theme, "name") else str(config.theme)
+        )
+
+        # Theme-specific defaults
+        theme_adjustments = {
+            "material": {"top": "64px", "z_index": "2000"},  # Material has tall header
+            "mkdocs": {"top": "80px", "z_index": "1100"},  # Default MkDocs theme
+            "readthedocs": {"top": "60px", "z_index": "1100"},
+            "bootstrap": {"top": "70px", "z_index": "1100"},
+            "windmill": {"top": "50px", "z_index": "1000"},
+        }
+
+        return theme_adjustments.get(theme_name, {"top": "80px", "z_index": "1100"})
+
+    def _get_copy_button_html(self, config: MkDocsConfig) -> str:
+        """Generate HTML for the copy button with inline CSS and JavaScript."""
+        # Get theme adjustments
+        theme_defaults = self._get_theme_adjustments(config)
+
+        # Get positioning configuration, with theme-aware defaults
+        position = self.config.copy_button_position
+        top = position.get("top", theme_defaults.get("top", "80px"))
+        right = position.get("right", "20px")
+        left = position.get("left", "")
+        bottom = position.get("bottom", "")
+        z_index = position.get("z_index", theme_defaults.get("z_index", "1100"))
+
+        # Build position style
+        position_style = f"position: fixed; z-index: {z_index};"
+        if top:
+            position_style += f" top: {top};"
+        if right:
+            position_style += f" right: {right};"
+        if left:
+            position_style += f" left: {left};"
+        if bottom:
+            position_style += f" bottom: {bottom};"
+
+        # Get styling configuration
+        style = self.config.copy_button_style
+        button_style = "cursor: pointer;"
+        for css_prop, value in style.items():
+            # Convert snake_case to kebab-case for CSS
+            css_property = css_prop.replace("_", "-")
+            button_style += f" {css_property}: {value};"
+
+        return rf"""
+        <div id="llms-copy-button" style="{position_style}">
+            <button onclick="copyMarkdownToClipboard()" style="{button_style}">{self.config.copy_button_text}</button>
+        </div>
+        <script>
+        async function copyMarkdownToClipboard() {{
+            try {{
+                const currentPath = window.location.pathname;
+                const mdPath = currentPath.endsWith('/') ? currentPath + 'index.md' : currentPath.replace(/\.html$/, '.md');
+
+                const response = await fetch(mdPath);
+                if (response.ok) {{
+                    const markdown = await response.text();
+                    await navigator.clipboard.writeText(markdown);
+                    // Show feedback
+                    const button = document.querySelector('#llms-copy-button button');
+                    const originalText = button.textContent;
+                    button.textContent = 'Copied!';
+                    button.style.background = '#28a745';
+                    setTimeout(() => {{
+                        button.textContent = originalText;
+                        button.style.background = '#007acc';
+                    }}, 2000);
+                }} else {{
+                    throw new Error('Markdown file not found');
+                }}
+            }} catch (err) {{
+                console.error('Failed to copy markdown:', err);
+                alert('Failed to copy markdown content');
+            }}
+        }}
+        </script>
+        """

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: mkdocs-ask-ai
+Version: 0.3.0
+Summary: MkDocs plugin for LLM-friendly documentation with direct markdown serving and i18n support
+Author-email: Ruben Khachaturov <mr.kha4a2rov@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mrkhachaturov/mkdocs-ask-ai
+Project-URL: Bug Reports, https://github.com/mrkhachaturov/mkdocs-ask-ai/issues
+Project-URL: Source, https://github.com/mrkhachaturov/mkdocs-ask-ai
+Keywords: mkdocs,plugin,llm,documentation,markdown,ai,llms-txt,i18n
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Documentation
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mkdocs>=1.4.0
+Dynamic: license-file
+
+# mkdocs-ask-ai
+
+MkDocs plugin for LLM-friendly documentation that provides:
+
+1. **Direct markdown serving** - Access original markdown at `page.md` URLs
+2. **llms.txt generation** - Concise index file for LLM context
+3. **llms-full.txt generation** - Complete documentation in single file
+4. **Copy-to-markdown button** - Easy copying of source markdown
+5. **i18n support** - Works with `mkdocs-static-i18n` (suffix structure)
+
+## Features
+
+- Source-first approach — works with original markdown, no HTML parsing
+- LLM optimized — token-efficient formats for AI consumption
+- Copy button — one-click markdown copying for developers
+- Dual URLs — both human-readable HTML and LLM-friendly markdown
+- Multilingual — generates separate `llms.txt` / `llms-full.txt` per locale
+
+> **Origin:** Forked from [mkdocs-llmstxt-md](https://github.com/noklam/mkdocs-llmstxt-md)
+> by Nok Lam Chan (MIT). This fork adds i18n support and will diverge
+> significantly from the upstream project.
+
+## Installation
+
+```bash
+pip install mkdocs-ask-ai
+```
+
+## Usage
+
+Add to your `mkdocs.yml`:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Getting Started":
+          - index.md: "Introduction to the project"
+          - quickstart.md
+        "API Reference":
+          - api/*.md
+```
+
+### With mkdocs-static-i18n
+
+Place the `ask-ai` plugin **before** `i18n` in the plugins list. The plugin
+automatically detects locale builds and writes `llms.txt` / `llms-full.txt`
+to each locale's output directory:
+
+```yaml
+plugins:
+  - ask-ai:
+      sections:
+        "Docs":
+          - "*.md"
+  - i18n:
+      docs_structure: suffix
+      languages:
+        - locale: en
+          default: true
+          name: English
+        - locale: ru
+          name: Русский
+```
+
+This generates:
+- `site/llms.txt` — English index
+- `site/ru/llms.txt` — Russian index
+- `site/llms-full.txt` — English full docs
+- `site/ru/llms-full.txt` — Russian full docs
+
+## Configuration
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `sections` | `{}` | Dict of section names to file patterns |
+| `enable_markdown_urls` | `true` | Enable `.md` URL serving |
+| `enable_llms_txt` | `true` | Generate `llms.txt` |
+| `enable_llms_full` | `true` | Generate `llms-full.txt` |
+| `enable_copy_button` | `true` | Add copy button to pages |
+| `copy_button_text` | `"Copy Markdown"` | Text for the copy button |
+| `markdown_description` | — | Optional description in `llms.txt` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/mkdocs_ask_ai/__init__.py
+src/mkdocs_ask_ai/config.py
+src/mkdocs_ask_ai/plugin.py
+src/mkdocs_ask_ai.egg-info/PKG-INFO
+src/mkdocs_ask_ai.egg-info/SOURCES.txt
+src/mkdocs_ask_ai.egg-info/dependency_links.txt
+src/mkdocs_ask_ai.egg-info/entry_points.txt
+src/mkdocs_ask_ai.egg-info/requires.txt
+src/mkdocs_ask_ai.egg-info/top_level.txt

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[mkdocs.plugins]
+ask-ai = mkdocs_ask_ai.plugin:LlmsTxtPlugin

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/requires.txt

@@ -0,0 +1 @@
+mkdocs>=1.4.0

mkdocs_ask_ai-0.3.0/src/mkdocs_ask_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+mkdocs_ask_ai