Theme Builder

from sphinxawesome_theme.builder import AwesomeHTMLBuilder

class AwesomeHTMLBuilder(StandaloneHTMLBuilder):
    """HTML builder that overrides methods related to handling CSS for Pygments."""
    
    def init_highlighter(self) -> None:
        """
        Initialize Pygments highlighters for both light and dark modes.
        
        Sets up the main highlighter based on pygments_style configuration
        and optionally creates a dark mode highlighter if pygments_style_dark
        is configured.
        """
    
    def create_pygments_style_file(self) -> None:
        """
        Create CSS file for Pygments that includes both light and dark mode styles.
        
        Generates a single pygments.css file that contains the main stylesheet
        plus dark mode styles prefixed with '.dark' selector.
        """

# Attributes set by init_highlighter
highlighter: AwesomePygmentsBridge  # Main highlighter instance
dark_highlighter: AwesomePygmentsBridge | None  # Dark mode highlighter if configured