Function generate_mdx_content

examples/generate_documentation.py:118–150

Generate MDX content with either provided or generated frontmatter.

(notebook_path, processed_content, frontmatter=None)

def generate_mdx_content(notebook_path, processed_content, frontmatter=None):
    """Generate MDX content with either provided or generated frontmatter."""
    if not frontmatter:
        # Generate new frontmatter
        folder_name = Path(notebook_path).parent.name

        # Check for title override, otherwise use default title case conversion
        if folder_name in TITLE_OVERRIDES:
            base_title = TITLE_OVERRIDES[folder_name]
        else:
            base_title = folder_name.replace("_", " ").title()

        title = f"{base_title}"

        # Extract description from first heading or use default
        description = f"{title} example using AgentOps"
        for line in processed_content.split("\n"):
            if line.startswith("# ") and len(line) > 2:
                description = line[2:].strip()
                break

        frontmatter = f"title: '{title}'\ndescription: '{description}'"

    return f"""---
{frontmatter}
---
{{/*  SOURCE_FILE: {notebook_path}  */}}

_View Notebook on <a href={{'https://github.com/AgentOps-AI/agentops/blob/main/{notebook_path}'}} target={{'_blank'}}>Github</a>_

{processed_content}

{SCRIPT_TAGS}"""


def main():