rtudo.github.io/mkdocs.yml at dev · rtudo/rtudo.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# mkdocs.yml

# Site Information
site_name: LangGraph Tutorial with Google
site_url: https://rtudo.github.io
site_description: Technical write-ups for building ai agents with Gemini Models. Focus is on working code for langgraph within Google Ecosystem. An Alternative LangGraph Tutorial destination.
repo_url: https://github.com/rtudo/rtudo.github.io
repo_name: rtudo.github.io
copyright: Copyright &copy; 2025 @ rtudo.github.io
# Theme Configuration
theme:
  name: material
  custom_dir: overrides # Optional: for custom overrides
  features:
    # - navigation.tabs # Top-level tabs for main sections
    # - navigation.sections # Sections in the left sidebar
    - navigation.indexes # Show index.md for each section
    # - toc.integrate # Integrate table of contents into main content area
    - content.code.copy # Enable copy button for code blocks
    - content.code.annotate # Enable code annotations
    - content.tabs.link # Linkable tabs in content
    - header.autohide # Header hides on scroll down, shows on scroll up
    - search.highlight # Highlight search results
    - search.suggest # Search suggestions
    - search.share # Share search results
    - sticky.tabs # Tabs stick to the top on scroll
    - content.tooltips
    # - navigation.footer
    - navigation.top
    - navigation.tracking
    - toc.follow
  palette: # Color scheme
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: teal
      accent: deep orange
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: blue grey
      accent: lime
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  font:
    text: Roboto
    code: Roboto Mono
  favicon: assets/favicon.png # Optional: Add your favicon

# Navigation (This defines your left sidebar structure)
# IMPORTANT: Adjust this to match your 'docs/' folder structure
nav:
  - Getting Started:
    # - ai/langgraph/index.md
    - Introduction: ai/langgraph/index.md
    - Setting up the Enviornment: ai/langgraph/setup.md
    - Not an Agent: ai/langgraph/not-an-agent.md
    - Still Not an Agent: ai/langgraph/still-not-an-agent.md
    - Just a Tool: ai/langgraph/just-a-tool.md
    - Agent, AI Agent: ai/langgraph/agent-007.md
    - Building an Agent: ai/langgraph/building-an-agent.md
  - Levelling Up:
    - Agent with Memory: ai/langgraph/agent-with-memory.md
    - Agent with Human Assistance: ai/langgraph/agent-with-human-assistance.md
    - Advance State Management: ai/langgraph/advance-state-management.md

# Markdown Extensions (Enhance Markdown features)
markdown_extensions:
  - attr_list # Allows adding HTML attributes to Markdown elements
  - md_in_html # Allows Markdown inside HTML
  - admonition # For callouts (notes, warnings, tips)
  - pymdownx.details # For expandable details blocks
  - pymdownx.superfences: # Enhanced code blocks
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.highlight: # Code highlighting
      anchor_linenums: true
      linenums: true # Show line numbers in code blocks
  - pymdownx.snippets # Include content from other files
  - pymdownx.tabbed: # Tabs in content
      alternate_style: true
  - pymdownx.tasklist: # Task lists (checkboxes)
      custom_checkbox: true
  - toc: # Table of Contents
      permalink: true
      toc_depth: 3 # Generate TOC up to H3
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  # - footnotes
  - meta

# Plugins (Add extra functionality)
plugins:
  - search # Built-in search
  - social # Generate social media cards
  - privacy # Privacy features (e.g., for embeds)
  # - redirects:
  #     redirect_maps:
  #       'ai/langgraph': 'ai/langgraph/intro'
  #       'ai/': '404.html'
  #       '/': '404.html'
  - minify:
      minify_html: true
      minify_js: true
      minify_css: true
      htmlmin_opts:
          remove_comments: true
      cache_safe: true
      js_files:
          - ai/langgraph/js/tooltip.js
      css_files:
          - ai/langgraph/stylesheets/extra.css
# Extra CSS/JavaScript (for custom styles if needed)
extra_css:
  - ai/langgraph/stylesheets/extra.css # Optional: Create this file for custom CSS

extra_javascript:
  - ai/langgraph/js/tooltip.js


# Extra files (e.g., images, favicons, custom CSS)
# extra_templates:
  # - custom_template.html # Optional: For highly custom overrides if custom_dir is set

use_directory_urls: true

# Extra configuration for static files
extra:
  generator: false
  static_verification_files:
    - google1934369b7ae8746a.html
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/rtudo/rtudo.github.io
      name: GitHub
  analytics:
    provider: google
    property: G-RCP3K9WFF4