Skip to main content

Collapsible Sections

For documents with substantial code, a long appendix can be overwhelming. The collapsible option wraps each language section in an expandable <details> element—readers click to expand only the sections they need.

This feature requires group-by-language: true and only works in HTML output.

extensions:
  regurgitate:
    group-by-language: true
    collapsible: true

Data Processing Pipeline

We implement a simple ETL (Extract, Transform, Load) workflow using both languages.

Extract

# Simulated data extraction
raw_records = [
    {"id": 1, "value": "  42  ", "valid": True},
    {"id": 2, "value": "N/A", "valid": False},
    {"id": 3, "value": " 37", "valid": True},
    {"id": 4, "value": "51  ", "valid": True},
]
print(f"Extracted {len(raw_records)} records")
Extracted 4 records

Transform

# Data transformation in R
raw_values <- c(42, NA, 37, 51)

# Clean and transform
cleaned <- na.omit(raw_values)
normalized <- (cleaned - mean(cleaned)) / sd(cleaned)

cat("Transformed values (z-scores):\n")
Transformed values (z-scores):
print(round(normalized, 3))
[1] -0.188 -0.893  1.081
attr(,"na.action")
[1] 2
attr(,"class")
[1] "omit"

Validate

# Validation logic
def validate_record(record):
    """Check if a record meets quality criteria."""
    if not record["valid"]:
        return False, "Marked invalid"
    
    try:
        value = float(record["value"].strip())
        if value < 0 or value > 100:
            return False, "Out of range"
        return True, "OK"
    except ValueError:
        return False, "Not numeric"

for rec in raw_records:
    is_valid, reason = validate_record(rec)
    status = "✓" if is_valid else "✗"
    print(f"Record {rec['id']}: {status} ({reason})")
Record 1: ✓ (OK)
Record 2: ✗ (Marked invalid)
Record 3: ✓ (OK)
Record 4: ✓ (OK)

Load

# Final aggregation
final_data <- c(42, 37, 51)  # Validated values

summary_stats <- list(
  n = length(final_data),
  mean = mean(final_data),
  sd = sd(final_data),
  min = min(final_data),
  max = max(final_data)
)

cat("=== Load Summary ===\n")
=== Load Summary ===
cat("Records loaded:", summary_stats$n, "\n")
Records loaded: 3 
cat("Mean value:", round(summary_stats$mean, 2), "\n")
Mean value: 43.33 
cat("Std deviation:", round(summary_stats$sd, 2), "\n")
Std deviation: 7.09 

In the appendix below, click on “Python” or “R” to expand and view that language’s code. This keeps the appendix compact while still providing access to everything.


Code Appendix

Python
# Simulated data extraction
raw_records = [
    {"id": 1, "value": "  42  ", "valid": True},
    {"id": 2, "value": "N/A", "valid": False},
    {"id": 3, "value": " 37", "valid": True},
    {"id": 4, "value": "51  ", "valid": True},
]
print(f"Extracted {len(raw_records)} records")
Extracted 4 records
# Validation logic
def validate_record(record):
    """Check if a record meets quality criteria."""
    if not record["valid"]:
        return False, "Marked invalid"
    
    try:
        value = float(record["value"].strip())
        if value < 0 or value > 100:
            return False, "Out of range"
        return True, "OK"
    except ValueError:
        return False, "Not numeric"

for rec in raw_records:
    is_valid, reason = validate_record(rec)
    status = "✓" if is_valid else "✗"
    print(f"Record {rec['id']}: {status} ({reason})")
Record 1: ✓ (OK)
Record 2: ✗ (Marked invalid)
Record 3: ✓ (OK)
Record 4: ✓ (OK)
R
# Data transformation in R
raw_values <- c(42, NA, 37, 51)

# Clean and transform
cleaned <- na.omit(raw_values)
normalized <- (cleaned - mean(cleaned)) / sd(cleaned)

cat("Transformed values (z-scores):\n")
print(round(normalized, 3))
Transformed values (z-scores):
[1] -0.188 -0.893  1.081
attr(,"na.action")
[1] 2
attr(,"class")
[1] "omit"
# Final aggregation
final_data <- c(42, 37, 51)  # Validated values

summary_stats <- list(
  n = length(final_data),
  mean = mean(final_data),
  sd = sd(final_data),
  min = min(final_data),
  max = max(final_data)
)

cat("=== Load Summary ===\n")
cat("Records loaded:", summary_stats$n, "\n")
cat("Mean value:", round(summary_stats$mean, 2), "\n")
cat("Std deviation:", round(summary_stats$sd, 2), "\n")
=== Load Summary ===
Records loaded: 3 
Mean value: 43.33 
Std deviation: 7.09 
Yaml
extensions:
  regurgitate:
    group-by-language: true
    collapsible: true