LaTeXify Skill

A specialized skill for processing and formatting LaTeX documents. This skill normalizes LaTeX code to follow best practices for mathematical and general documents.

Features

LaTeX Structure Organization

• •Normalizes theorem, lemma, definition, and proof environments
• •Configurable theorem styles (classic, simple, boxed)
• •Consistent numbering and formatting

Math Expression Formatting

• •Converts $$...$$ to align/align* environments
• •Normalizes \(...\) to $...$ inline math
• •Removes \boxed{} commands with sensible alternatives

Page Layout Configuration

• •Adjustable paper size (a4, letter, b5)
• •Configurable margins
• •Line spacing control
• •Font size options

Safety Features

• •Automatic backups before modification
• •Dry-run mode for previewing changes
• •Rollback capability (keeps last 3 backups)

Installation

This skill is part of the Compound Engineering plugin collection. No additional installation required.

Usage

Command Line Interface

# Process a file with default settings
latexify input.tex

# Preview changes without saving
latexify input.tex --dry-run

# Use specific theorem style
latexify input.tex --style simple

# Remove \boxed commands
latexify input.tex --no-boxed

# Specify paper size and margins
latexify input.tex --paper a4 --margin 2.5cm

# Rollback to previous version
latexify input.tex --rollback

Arguments

Theorem Styles

Classic Style (Default)

Traditional formatting:

• •Bold theorem titles
• •Chinese full-width colon (：) as separator
• •Standard LaTeX numbering
• •Example: 定理 1.1：内容...

Simple Style

Minimal formatting for clean appearance:

• •No special title formatting
• •Standard body text
• •Clean, uncluttered look
• •Example: Theorem 1.1: Content...

Boxed Style

Enhanced visual separation:

• •Shaded background
• •Border boxes
• •Clear visual hierarchy
• •Requires framed or mdframed package

Examples

Before and After

Before:

Document was created with inconsistent math formatting.

\(a + b = c\)

$$
x^2 + y^2 = z^2
$$

\begin{theorem}
\label{th1}
给定 \(a, b, c\)，则...
\end{theorem}

Answer: \boxed{42}

After (classic style):

Document was created with inconsistent math formatting.

$a + b = c$

\begin{align}
x^2 + y^2 = z^2
\end{align}

\begin{theorem}[定理 1]
给定 $a, b, c$，则...
\end{theorem}

Answer: $42$

Integration

As a Python Module

from latex_math_competition import (
    LaTeXParser,
    LaTeXTransformer,
    InlineMathRule,
    DisplayMathRule,
    BoxedRemovalRule,
    TheoremEnvRule
)

# Parse document
parser = LaTeXParser()
parsed = parser.parse(content)

# Transform document
transformer = LaTeXTransformer(parser)
rules = [
    InlineMathRule(),
    DisplayMathRule(),
    BoxedRemovalRule(),
    TheoremEnvRule(style='classic')
]
result = transformer.transform(content, rules)

Preview Changes

preview = transformer.preview_changes(content, rules)
print(preview['preview'])
print(f"Changes: {len(preview['changes'])} lines")

Configuration Files

Theorem Styles (references/theorem-styles.json)

Predefined theorem style configurations.

Best Practices (references/latex-best-practices.md)

Comprehensive guide for LaTeX document formatting.

Templates (assets/templates/)

Ready-to-use theorem templates:

• •classic-theorem.tex - Classic Chinese style
• •simple-theorem.tex - Minimal style
• •boxed-theorem.tex - Boxed style

Best Practices

Inline Math

• •Use $...$ instead of \(...\)
• •Add space after punctuation before math: ，$x$ not ，$x$

Display Math

• •Use align for multi-line equations
• •Use equation for single-line equations
• •Avoid $$...$$ (deprecated)

Theorem Environments

• •Use consistent naming (定理, 定义, 例, 练习)
• •Include numbering by section
• •Use Chinese punctuation in titles

Avoid

• •\boxed{} for inline math
• •Mixed delimiters ($$ vs \[...\])
• •Unicode characters in math mode
• •Overusing display math for simple expressions

Error Handling

Common Issues

1. •File not found: Check the input path
2. •Invalid style: Use classic, simple, or boxed
3. •Backup errors: Check file permissions

Rollback

# List available backups
ls *.tex.*.bak

# Rollback to specific backup
latexify document.tex --rollback

Performance

• •Handles files up to 10MB efficiently
• •Linear time complexity for transformations
• •Memory efficient for large documents

Dependencies

• •Python 3.7+
• •Standard library only (no external dependencies)

License

Part of the Compound Engineering plugin collection.

Contributing

Part of the Compound Engineering plugin collection. Issues and contributions welcome through the main repository.