Links
AI / Agents
gdtest-sec-with-ref
Test custom section with explicit reference config.
Custom section (Tutorials) combined with explicit reference config. Both custom nav sections and custom reference order should work.
Source files
gdtest_sec_with_ref/
__init__.py
"""Test package for custom section with reference config.""" from .core import analyze, format_output, process __all__ = ["analyze", "format_output", "process"]
core.py
"""Core process/analyze/format_output functions."""
def process(data: list) -> list:
"""Process a list of data items.
Parameters
----------
data : list
The raw data to process.
Returns
-------
list
The processed data.
Examples
--------
>>> process([1, 2, 3])
[2, 4, 6]
"""
return [x * 2 for x in data]
def analyze(data: list) -> dict:
"""Analyze a list of data and return statistics.
Parameters
----------
data : list
The data to analyze.
Returns
-------
dict
A dictionary with analysis results.
Examples
--------
>>> analyze([10, 20, 30])
{'mean': 20.0, 'count': 3}
"""
if not data:
return {"mean": 0.0, "count": 0}
return {"mean": sum(data) / len(data), "count": len(data)}
def format_output(result: dict) -> str:
"""Format an analysis result as a readable string.
Parameters
----------
result : dict
The result dictionary to format.
Returns
-------
str
A formatted string representation of the result.
Examples
--------
>>> format_output({"mean": 2.0, "count": 3})
'mean=2.0, count=3'
"""
return ", ".join(f"{k}={v}" for k, v in result.items())tutorials/
step1.qmd
--- title: Step 1 - Getting Started --- # Step 1 - Getting Started The first step in the tutorial series.
step2.qmd
--- title: Step 2 - Going Further --- # Step 2 - Going Further The second step in the tutorial series.
README.md
# gdtest-sec-with-ref Test custom section with explicit reference config.
great-docs.yml
sections:
- title: Tutorials
dir: tutorials
reference:
- title: Core
desc: Core API
contents:
- name: process
- name: analyze
- title: Helpers
desc: Helper functions
contents:
- name: format_output