Function generate_toc_entry

bin/toc.py:78–129

Generate TOC entry for a file

(file_name, title, lang, depth, content_dir)

def generate_toc_entry(file_name, title, lang, depth, content_dir):
    """Generate TOC entry for a file"""
    entries = []
    
    # Determine URL path
    base_name = file_name.replace('.md', '')
    if lang == 'zh':
        url = f"/{base_name}"
    else:
        url = f"/{lang}/{base_name}"
    
    # Add main entry (level 1)
    entries.append({
        'level': 1,
        'text': f"[{title}]({url})",
        'raw_text': title
    })
    
    # Special case: glossary.md only shows main title (no sub-headings)
    if file_name == 'glossary.md':
        effective_depth = 0  # Don't extract any sub-headings
    else:
        effective_depth = depth - 1  # Adjust depth: user depth 1 = no extraction, 2 = extract H2, etc.
    
    # If effective_depth >= 1, extract headings from file
    if effective_depth >= 1:
        file_path = content_dir / file_name
        if file_path.exists():
            with open(file_path, 'r', encoding='utf-8') as f:
                content = f.read()
            
            headings = extract_headings(content, effective_depth)
            for heading in headings:
                # Create link with anchor
                if heading['id']:
                    anchor_url = f"{url}#{heading['id']}"
                else:
                    # Generate anchor from heading text (simplified)
                    anchor = heading['text'].lower()
                    anchor = re.sub(r'[^\w\s-]', '', anchor)
                    anchor = re.sub(r'\s+', '-', anchor)
                    anchor_url = f"{url}#{anchor}"
                
                # Adjust level: H2 becomes level 2, H3 becomes level 3, etc.
                # This ensures proper indentation under the main entry
                entries.append({
                    'level': heading['level'],
                    'text': f"[{heading['text']}]({anchor_url})",
                    'raw_text': heading['text']
                })
    
    return entries


def format_toc_entries(entries):