#!/usr/bin/env python3
"""
Comprehensive Hip Bone PDF Generator
Uses ReportLab for rich formatting with highlights, diagrams, and mnemonics
"""

import requests
import io
import os
from reportlab.lib.pagesizes import A4
from reportlab.lib import colors
from reportlab.lib.units import mm, cm
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.enums import TA_LEFT, TA_CENTER, TA_JUSTIFY
from reportlab.platypus import (SimpleDocTemplate, Paragraph, Spacer, Table,
                                 TableStyle, Image, HRFlowable, PageBreak,
                                 KeepTogether, ListFlowable, ListItem)
from reportlab.platypus.flowables import Flowable
from reportlab.graphics.shapes import Drawing, Rect, String
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from PIL import Image as PILImage
import urllib.request
import traceback

# ── Colors ──────────────────────────────────────────────────────────────────
C_DEEP_BLUE   = colors.HexColor('#1a3a5c')
C_MED_BLUE    = colors.HexColor('#2e6da4')
C_LIGHT_BLUE  = colors.HexColor('#d6e8f7')
C_HIGHLIGHT_Y = colors.HexColor('#fff3b0')   # yellow highlight
C_HIGHLIGHT_G = colors.HexColor('#d4f0d4')   # green highlight
C_HIGHLIGHT_P = colors.HexColor('#ede0f7')   # purple highlight
C_HIGHLIGHT_O = colors.HexColor('#ffe5cc')   # orange highlight
C_MNEMONIC    = colors.HexColor('#fff0d9')
C_BORDER      = colors.HexColor('#2e6da4')
C_SECTION_BG  = colors.HexColor('#eaf3fb')
C_RED_LIGHT   = colors.HexColor('#fde8e8')
C_DARK_TEXT   = colors.HexColor('#1a1a2e')
C_GRAY        = colors.HexColor('#6c757d')
C_GREEN_DARK  = colors.HexColor('#1e6b3c')
C_ORANGE_DARK = colors.HexColor('#8b4513')

PAGE_W, PAGE_H = A4

# ── Custom Flowables ────────────────────────────────────────────────────────
class ColorBox(Flowable):
    """A colored box with text inside (for highlight boxes)."""
    def __init__(self, text, bg_color, border_color, text_color=C_DARK_TEXT,
                 width=None, padding=8, font_size=10, bold=False):
        Flowable.__init__(self)
        self.text = text
        self.bg_color = bg_color
        self.border_color = border_color
        self.text_color = text_color
        self.box_width = width or (PAGE_W - 4*cm)
        self.padding = padding
        self.font_size = font_size
        self.bold = bold

    def wrap(self, availWidth, availHeight):
        self.box_width = availWidth
        # Approximate height
        chars_per_line = int((self.box_width - 2*self.padding) / (self.font_size * 0.55))
        lines = max(1, len(self.text) // max(1, chars_per_line) + 1)
        self.height = lines * (self.font_size + 4) + 2 * self.padding
        return (self.box_width, self.height)

    def draw(self):
        c = self.canv
        # Draw background
        c.setFillColor(self.bg_color)
        c.setStrokeColor(self.border_color)
        c.setLineWidth(1.5)
        c.roundRect(0, 0, self.box_width, self.height, 6, fill=1, stroke=1)
        # Draw text
        c.setFillColor(self.text_color)
        font_name = 'Helvetica-Bold' if self.bold else 'Helvetica'
        c.setFont(font_name, self.font_size)
        text_obj = c.beginText(self.padding, self.height - self.padding - self.font_size)
        max_width = self.box_width - 2 * self.padding
        words = self.text.split()
        line = ''
        for word in words:
            test = (line + ' ' + word).strip()
            if c.stringWidth(test, font_name, self.font_size) <= max_width:
                line = test
            else:
                if line:
                    text_obj.textLine(line)
                line = word
        if line:
            text_obj.textLine(line)
        c.drawText(text_obj)


def download_image(url, max_size=(500, 400)):
    """Download image from URL, return PIL image bytes or None."""
    try:
        req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
        with urllib.request.urlopen(req, timeout=15) as resp:
            data = resp.read()
        img = PILImage.open(io.BytesIO(data))
        img.thumbnail(max_size, PILImage.LANCZOS)
        buf = io.BytesIO()
        img.save(buf, format='PNG')
        buf.seek(0)
        return buf
    except Exception as e:
        print(f"  [WARN] Could not download {url[:60]}: {e}")
        return None


def make_img(url, width=14*cm, caption='', ref=''):
    """Return list of flowables: image + caption."""
    flowables = []
    buf = download_image(url)
    if buf:
        try:
            rl_img = Image(buf, width=width)
            rl_img.hAlign = 'CENTER'
            flowables.append(rl_img)
            if caption:
                cap_style = ParagraphStyle('Cap', fontName='Helvetica-Oblique',
                    fontSize=8.5, textColor=C_GRAY, alignment=TA_CENTER,
                    spaceAfter=4, spaceBefore=2)
                ref_text = f" <font color='#2e6da4'><b>[{ref}]</b></font>" if ref else ''
                flowables.append(Paragraph(f"<i>{caption}</i>{ref_text}", cap_style))
        except Exception as e:
            print(f"  [WARN] Could not embed image: {e}")
    return flowables


# ── Styles ───────────────────────────────────────────────────────────────────
def build_styles():
    base = getSampleStyleSheet()

    title_style = ParagraphStyle('DocTitle',
        fontName='Helvetica-Bold', fontSize=26, textColor=colors.white,
        alignment=TA_CENTER, spaceAfter=6, spaceBefore=0, leading=32)

    subtitle_style = ParagraphStyle('DocSubtitle',
        fontName='Helvetica', fontSize=13, textColor=colors.HexColor('#d6e8f7'),
        alignment=TA_CENTER, spaceAfter=4)

    h1_style = ParagraphStyle('H1',
        fontName='Helvetica-Bold', fontSize=18, textColor=colors.white,
        spaceBefore=14, spaceAfter=6, leading=22,
        backColor=C_DEEP_BLUE, leftIndent=-8, rightIndent=-8,
        borderPad=8)

    h2_style = ParagraphStyle('H2',
        fontName='Helvetica-Bold', fontSize=14, textColor=C_DEEP_BLUE,
        spaceBefore=12, spaceAfter=4, leading=18,
        borderColor=C_MED_BLUE, borderWidth=0, leftIndent=0)

    h3_style = ParagraphStyle('H3',
        fontName='Helvetica-Bold', fontSize=12, textColor=C_MED_BLUE,
        spaceBefore=8, spaceAfter=3, leading=15)

    body_style = ParagraphStyle('Body',
        fontName='Helvetica', fontSize=10, textColor=C_DARK_TEXT,
        leading=15, spaceAfter=5, alignment=TA_JUSTIFY)

    bullet_style = ParagraphStyle('Bullet',
        fontName='Helvetica', fontSize=10, textColor=C_DARK_TEXT,
        leading=14, spaceAfter=3, leftIndent=14, firstLineIndent=-14)

    highlight_y = ParagraphStyle('HighY',
        fontName='Helvetica', fontSize=10, textColor=C_DARK_TEXT,
        leading=14, spaceAfter=3, backColor=C_HIGHLIGHT_Y,
        leftIndent=6, rightIndent=6, borderPad=4)

    mnemonic_style = ParagraphStyle('Mnemonic',
        fontName='Helvetica-Bold', fontSize=11, textColor=C_ORANGE_DARK,
        leading=16, spaceAfter=3)

    ref_style = ParagraphStyle('Ref',
        fontName='Helvetica-Oblique', fontSize=8.5, textColor=C_GRAY,
        leading=12, spaceAfter=2)

    table_header = ParagraphStyle('TH',
        fontName='Helvetica-Bold', fontSize=9.5, textColor=colors.white,
        leading=13, alignment=TA_CENTER)

    table_cell = ParagraphStyle('TC',
        fontName='Helvetica', fontSize=9, textColor=C_DARK_TEXT,
        leading=12, alignment=TA_LEFT)

    return dict(title=title_style, subtitle=subtitle_style,
                h1=h1_style, h2=h2_style, h3=h3_style,
                body=body_style, bullet=bullet_style,
                highlight_y=highlight_y, mnemonic=mnemonic_style,
                ref=ref_style, th=table_header, tc=table_cell)


# ── Content builder ──────────────────────────────────────────────────────────
def build_pdf(output_path):
    doc = SimpleDocTemplate(
        output_path,
        pagesize=A4,
        rightMargin=2*cm, leftMargin=2*cm,
        topMargin=2.5*cm, bottomMargin=2.5*cm,
        title='The Hip Bone – A Complete Anatomical Guide',
        author='Compiled from Gray\'s Anatomy for Students & THIEME Atlas'
    )

    S = build_styles()
    story = []

    # ── COVER ────────────────────────────────────────────────────────────────
    def cover_page(canvas, doc):
        canvas.saveState()
        # Deep blue background
        canvas.setFillColor(C_DEEP_BLUE)
        canvas.rect(0, 0, PAGE_W, PAGE_H, fill=1, stroke=0)
        # Decorative top bar
        canvas.setFillColor(C_MED_BLUE)
        canvas.rect(0, PAGE_H - 1.5*cm, PAGE_W, 1.5*cm, fill=1, stroke=0)
        # Decorative bottom bar
        canvas.rect(0, 0, PAGE_W, 1.2*cm, fill=1, stroke=0)
        # Accent line
        canvas.setStrokeColor(colors.HexColor('#5bc0eb'))
        canvas.setLineWidth(4)
        canvas.line(2*cm, PAGE_H*0.42, PAGE_W - 2*cm, PAGE_H*0.42)
        canvas.restoreState()

    # Cover page flowables (will draw on top of background via onFirstPage)
    story.append(Spacer(1, 5.5*cm))
    story.append(Paragraph("THE HIP BONE", S['title']))
    story.append(Spacer(1, 0.3*cm))
    story.append(Paragraph("A Complete Anatomical Study Guide", S['subtitle']))
    story.append(Paragraph("with Muscle Attachments, Diagrams & Mnemonics", S['subtitle']))
    story.append(Spacer(1, 3*cm))

    cover_info = [
        ["Sources:", "Gray's Anatomy for Students (4e), Imaging Anatomy Vol.3,"],
        ["", "THIEME General Anatomy & Musculoskeletal System"],
        ["Format:", "Highlights  •  Diagrams  •  Tables  •  Mnemonics"],
    ]
    cover_table = Table(cover_info, colWidths=[3*cm, 12*cm])
    cover_table.setStyle(TableStyle([
        ('FONTNAME', (0,0), (-1,-1), 'Helvetica'),
        ('FONTSIZE', (0,0), (-1,-1), 11),
        ('TEXTCOLOR', (0,0), (-1,-1), colors.HexColor('#d6e8f7')),
        ('FONTNAME', (0,0), (0,-1), 'Helvetica-Bold'),
        ('TEXTCOLOR', (0,0), (0,-1), colors.HexColor('#5bc0eb')),
        ('ALIGN', (0,0), (-1,-1), 'LEFT'),
        ('ROWBACKGROUNDS', (0,0), (-1,-1), [None, None]),
        ('TOPPADDING', (0,0), (-1,-1), 4),
        ('BOTTOMPADDING', (0,0), (-1,-1), 4),
    ]))
    story.append(cover_table)
    story.append(PageBreak())

    # ── SECTION 1: OVERVIEW ──────────────────────────────────────────────────
    def h1(txt):
        return Paragraph(f"<font color='white'>{txt}</font>", S['h1'])

    def h2(txt):
        return Paragraph(txt, S['h2'])

    def h3(txt):
        return Paragraph(txt, S['h3'])

    def body(txt):
        return Paragraph(txt, S['body'])

    def bullet(txt):
        return Paragraph(f"• {txt}", S['bullet'])

    def ybox(txt):
        """Yellow highlight box."""
        style = ParagraphStyle('YB', fontName='Helvetica', fontSize=10,
            textColor=C_DARK_TEXT, leading=14, backColor=C_HIGHLIGHT_Y,
            leftIndent=0, rightIndent=0, spaceBefore=4, spaceAfter=4,
            borderPad=6, borderColor=colors.HexColor('#d4a017'),
            borderWidth=1.2, borderRadius=4)
        return Paragraph(txt, style)

    def gbox(txt):
        """Green highlight box."""
        style = ParagraphStyle('GB', fontName='Helvetica', fontSize=10,
            textColor=C_GREEN_DARK, leading=14, backColor=C_HIGHLIGHT_G,
            leftIndent=0, rightIndent=0, spaceBefore=4, spaceAfter=4,
            borderPad=6, borderColor=C_GREEN_DARK, borderWidth=1.2)
        return Paragraph(txt, style)

    def pbox(txt):
        """Purple highlight box."""
        style = ParagraphStyle('PB', fontName='Helvetica', fontSize=10,
            textColor=colors.HexColor('#4a0072'), leading=14, backColor=C_HIGHLIGHT_P,
            leftIndent=0, rightIndent=0, spaceBefore=4, spaceAfter=4,
            borderPad=6, borderColor=colors.HexColor('#7b2d8b'), borderWidth=1.2)
        return Paragraph(txt, style)

    def obox(txt):
        """Orange highlight box (mnemonics/clinical tips)."""
        style = ParagraphStyle('OB', fontName='Helvetica', fontSize=10,
            textColor=C_ORANGE_DARK, leading=14, backColor=C_MNEMONIC,
            leftIndent=0, rightIndent=0, spaceBefore=4, spaceAfter=4,
            borderPad=6, borderColor=colors.HexColor('#e07b39'), borderWidth=1.5)
        return Paragraph(txt, style)

    def mnemonic_box(title, content_lines):
        """Special mnemonic box."""
        rows = [[Paragraph(f"🧠 MNEMONIC: {title}", ParagraphStyle('MH',
            fontName='Helvetica-Bold', fontSize=11, textColor=colors.white,
            leading=15, alignment=TA_CENTER))]]
        for line in content_lines:
            rows.append([Paragraph(line, ParagraphStyle('ML',
                fontName='Helvetica', fontSize=10, textColor=C_DARK_TEXT,
                leading=14, spaceBefore=2))])
        t = Table(rows, colWidths=[doc.width])
        t.setStyle(TableStyle([
            ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#e07b39')),
            ('BACKGROUND', (0,1), (-1,-1), C_MNEMONIC),
            ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_MNEMONIC, colors.HexColor('#fff8ee')]),
            ('BOX', (0,0), (-1,-1), 1.5, colors.HexColor('#e07b39')),
            ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#f0c080')),
            ('TOPPADDING', (0,0), (-1,-1), 6),
            ('BOTTOMPADDING', (0,0), (-1,-1), 6),
            ('LEFTPADDING', (0,0), (-1,-1), 10),
            ('RIGHTPADDING', (0,0), (-1,-1), 10),
        ]))
        return t

    def ref_cite(text):
        return Paragraph(f"<i>{text}</i>", S['ref'])

    # ── PAGE 1: INTRODUCTION ─────────────────────────────────────────────────
    story.append(h1("1. THE HIP BONE — OVERVIEW"))
    story.append(Spacer(1, 0.3*cm))

    story.append(ybox(
        "<b>KEY FACT:</b> The hip bone (os coxae / innominate bone) is a large, "
        "irregular bone formed by the fusion of THREE bones: the <b>Ilium</b>, "
        "<b>Ischium</b>, and <b>Pubis</b>. Fusion occurs at the <b>acetabulum</b> "
        "between ages 16–18 years via the triradiate cartilage."
    ))
    story.append(Spacer(1, 0.2*cm))

    story.append(body(
        "The two hip bones, together with the sacrum and coccyx, form the "
        "<b>bony pelvis</b>. They articulate posteriorly with the sacrum at the "
        "<b>sacroiliac joints</b> and with each other anteriorly at the "
        "<b>pubic symphysis</b>, creating a stable ring for weight transmission "
        "and lower limb function."
    ))
    story.append(Spacer(1, 0.15*cm))
    story.append(ref_cite("Gray's Anatomy for Students, 4e — Chapter 5, Pelvis & Perineum, p.516–518"))
    story.append(Spacer(1, 0.2*cm))

    # Pelvis overview diagram from Imaging Anatomy
    story += make_img(
        "https://cdn.orris.care/cdss_images/fa2f388c6d72c6b2f9079247e099ad28604bf6cc3ae64f5824d5e7642d23bf4e.png",
        width=14*cm,
        caption="Fig. 8.9 — Bony pelvis overview showing triradiate cartilage (open in child, fused in adult)",
        ref="Imaging Anatomy Vol.3 — Bones, Joints, Vessels & Nerves, p.227"
    )

    # THIEME hip bone diagrams
    story += make_img(
        "https://cdn.orris.care/cdss_images/dd24b544e1701ef2919bf1f4462e08fee486cff5a719674160501a98868ae177.png",
        width=14*cm,
        caption="Right hip bone — lateral and medial surface features labeled",
        ref="THIEME General Anatomy & Musculoskeletal System, p.433"
    )

    story += make_img(
        "https://cdn.orris.care/cdss_images/e959922e5b385f765e11adfe17f39f8eeb175e49e307dd83b70b881cfab35aff.png",
        width=13*cm,
        caption="Right hip bone — anterior view with all major landmarks",
        ref="THIEME General Anatomy & Musculoskeletal System, p.433"
    )

    story.append(PageBreak())

    # ── SECTION 2: THREE COMPONENTS ──────────────────────────────────────────
    story.append(h1("2. THE THREE COMPONENTS OF THE HIP BONE"))
    story.append(Spacer(1, 0.2*cm))

    story.append(gbox(
        "<b>REMEMBER:</b> Each component contributes to the acetabulum — "
        "<b>Ilium 2/5</b>, <b>Ischium 2/5</b>, <b>Pubis 1/5</b>. "
        "The triradiate cartilage fuses at ages 14–16 years (females) and "
        "15–18 years (males)."
    ))
    story.append(Spacer(1, 0.2*cm))

    story += make_img(
        "https://cdn.orris.care/cdss_images/2ed5c3d1988b9a4954b08c276c2c2100f246258726e57c809fcaee8fddb229c0.png",
        width=11*cm,
        caption="G — Schematic of right acetabulum showing contributions of ilium, ischium, and pubis (2:2:1 ratio)",
        ref="THIEME General Anatomy & Musculoskeletal System, p.434"
    )

    story.append(Spacer(1, 0.2*cm))

    # Three-component table
    comp_data = [
        [Paragraph("<b>Component</b>", S['th']),
         Paragraph("<b>Location</b>", S['th']),
         Paragraph("<b>Key Features</b>", S['th']),
         Paragraph("<b>Acetabular %</b>", S['th'])],
        [Paragraph("ILIUM", S['tc']),
         Paragraph("Superior / largest part", S['tc']),
         Paragraph("Iliac crest, ASIS, AIIS, PSIS, PIIS, iliac fossa, gluteal surface, arcuate line", S['tc']),
         Paragraph("2/5", S['tc'])],
        [Paragraph("ISCHIUM", S['tc']),
         Paragraph("Posteroinferior", S['tc']),
         Paragraph("Ischial tuberosity, ischial spine, lesser & greater sciatic notch, ischial ramus", S['tc']),
         Paragraph("2/5", S['tc'])],
        [Paragraph("PUBIS", S['tc']),
         Paragraph("Anteroinferior", S['tc']),
         Paragraph("Pubic body, superior & inferior rami, pubic tubercle, pubic crest, pectineal line", S['tc']),
         Paragraph("1/5", S['tc'])],
    ]
    comp_table = Table(comp_data, colWidths=[2.8*cm, 3.5*cm, 7.5*cm, 2.2*cm])
    comp_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_DEEP_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_BLUE, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 6),
        ('BOTTOMPADDING', (0,0), (-1,-1), 6),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(comp_table)
    story.append(Spacer(1, 0.15*cm))
    story.append(ref_cite("Gray's Anatomy for Students, 4e, p.518"))

    story.append(Spacer(1, 0.3*cm))
    story.append(mnemonic_box(
        '"I Picked Irrelevant Stuff" = Ilium, Pubis (anterior), Ischium (posterior), Sacrum (completes ring)',
        [
            "• <b>I</b> = <b>I</b>lium (largest, superior, fan-shaped wing)",
            "• <b>S</b> = Sit on the <b>I</b>schium (ischial tuberosity = 'sitting bone')",
            "• <b>P</b> = <b>P</b>ubis meets in the midline (symphysis pubis)",
            "• Acetabulum ratio: '<b>IIP</b>' = Ilium 2, Ischium 2, Pubis 1",
            "• Fusion age: '<b>Sweet 16</b>' = triradiate cartilage fuses ~16 years",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 3: ILIUM ─────────────────────────────────────────────────────
    story.append(h1("3. THE ILIUM — DETAILED ANATOMY"))
    story.append(Spacer(1, 0.2*cm))

    story.append(ybox(
        "<b>ILIUM</b> = Most superior and largest part of the hip bone. "
        "It forms the upper part of the acetabulum (2/5). The iliac wing provides "
        "extensive muscle attachment surfaces."
    ))
    story.append(Spacer(1, 0.2*cm))

    story.append(h2("3.1 Iliac Crest"))
    story.append(body(
        "The entire superior margin of the ilium is thickened to form the prominent "
        "<b>iliac crest</b> — the site of attachment for muscles and fascia of the "
        "abdomen, back, and lower limb. It terminates as:"
    ))
    story.append(bullet("<b>Anteriorly:</b> Anterior Superior Iliac Spine (ASIS)"))
    story.append(bullet("<b>Posteriorly:</b> Posterior Superior Iliac Spine (PSIS) — marked as dimples of Venus"))
    story.append(bullet("<b>Tuberculum of iliac crest</b> — projects laterally, ~5 cm posterior to ASIS"))

    story.append(Spacer(1, 0.2*cm))

    story.append(h2("3.2 Iliac Spines (4 total)"))

    spines_data = [
        [Paragraph("<b>Spine</b>", S['th']),
         Paragraph("<b>Position</b>", S['th']),
         Paragraph("<b>Key Attachments / Significance</b>", S['th'])],
        [Paragraph("ASIS", S['tc']),
         Paragraph("Anterior superior", S['tc']),
         Paragraph("Sartorius (proximal attachment), TFL (tensor fasciae latae), inguinal ligament (lateral end)", S['tc'])],
        [Paragraph("AIIS", S['tc']),
         Paragraph("Anterior inferior", S['tc']),
         Paragraph("Rectus femoris (direct head), iliofemoral ligament (Y-ligament of Bigelow)", S['tc'])],
        [Paragraph("PSIS", S['tc']),
         Paragraph("Posterior superior", S['tc']),
         Paragraph("Sacroiliac joint level (L5/S1 disc), erector spinae, multifidus — dimple of Venus", S['tc'])],
        [Paragraph("PIIS", S['tc']),
         Paragraph("Posterior inferior", S['tc']),
         Paragraph("Forms upper margin of greater sciatic notch; sacrotuberous & sacrospinous ligaments nearby", S['tc'])],
    ]
    spines_table = Table(spines_data, colWidths=[2.5*cm, 3.5*cm, 10*cm])
    spines_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_MED_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_HIGHLIGHT_Y, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(spines_table)
    story.append(ref_cite("Gray's Anatomy for Students, 4e, p.518–520"))

    story.append(Spacer(1, 0.2*cm))

    story.append(h2("3.3 Surfaces of the Ilium"))
    story.append(gbox(
        "<b>Two key surfaces of the iliac wing:</b><br/>"
        "• <b>Iliac fossa</b> (anteromedial, concave): Origin of <b>iliacus muscle</b><br/>"
        "• <b>Gluteal surface</b> (posterolateral): Origin of gluteal muscles, divided by "
        "anterior, posterior, and inferior gluteal lines"
    ))

    story.append(Spacer(1, 0.2*cm))
    story.append(h2("3.4 Gluteal Lines (3 lines on gluteal surface)"))

    glut_data = [
        [Paragraph("<b>Line</b>", S['th']),
         Paragraph("<b>Course</b>", S['th']),
         Paragraph("<b>What lies between each pair of lines</b>", S['th'])],
        [Paragraph("Anterior gluteal line", S['tc']),
         Paragraph("From ASIS curving to posterior ilium", S['tc']),
         Paragraph("Between anterior & posterior lines → Gluteus medius origin", S['tc'])],
        [Paragraph("Posterior gluteal line", S['tc']),
         Paragraph("Short, near PSIS", S['tc']),
         Paragraph("Behind posterior line → Gluteus maximus origin", S['tc'])],
        [Paragraph("Inferior gluteal line", S['tc']),
         Paragraph("Curves above acetabulum", S['tc']),
         Paragraph("Between anterior & inferior lines → Gluteus minimus origin", S['tc'])],
    ]
    glut_table = Table(glut_data, colWidths=[4*cm, 4.5*cm, 7.5*cm])
    glut_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1e6b3c')),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_HIGHLIGHT_G, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, colors.HexColor('#1e6b3c')),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#a0d4b0')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(glut_table)
    story.append(Spacer(1, 0.2*cm))

    story.append(mnemonic_box(
        'Gluteal Lines — "Medius is in the MIDDLE, Minimus is MINIMUM (below anterior line)"',
        [
            "• <b>Posterior gluteal line</b> = Gluteus <b>MAX</b>imus behind it (MAX = biggest, most posterior)",
            "• <b>Between Ant & Post lines</b> = Gluteus <b>MED</b>ius (middle)",
            "• <b>Between Ant & Inf lines</b> = Gluteus <b>MIN</b>imus (smallest, deepest)",
            "• Trick: '<b>3 lines, 3 glutes — going back to front = Max, Med, Min</b>'",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 4: ISCHIUM ────────────────────────────────────────────────────
    story.append(h1("4. THE ISCHIUM — DETAILED ANATOMY"))
    story.append(Spacer(1, 0.2*cm))

    story.append(ybox(
        "<b>ISCHIUM</b> = Posteroinferior component of the hip bone, contributing 2/5 of the "
        "acetabulum. Contains the ischial tuberosity — the 'sitting bone' on which body weight "
        "is borne when seated."
    ))
    story.append(Spacer(1, 0.2*cm))

    story.append(h2("4.1 Key Features of the Ischium"))
    isch_features = [
        ("<b>Ischial body</b>", "Forms posteroinferior acetabulum; joins ilium above and pubis anteriorly"),
        ("<b>Ischial spine</b>", "Projects medially from posterior border; separates greater from lesser sciatic notch. Pudendal nerve passes around it. Sacrospinous ligament attaches here"),
        ("<b>Greater sciatic notch</b>", "Between PIIS and ischial spine. Converted to greater sciatic foramen by sacrospinous ligament. Transmits: sciatic nerve, superior & inferior gluteal vessels & nerves, pudendal nerve, nerve to obturator internus, nerve to quadratus femoris"),
        ("<b>Lesser sciatic notch</b>", "Between ischial spine and ischial tuberosity. Converted to lesser sciatic foramen by sacrotuberous ligament. Transmits: tendon of obturator internus, pudendal nerve & vessels (re-entering pelvis), nerve to obturator internus"),
        ("<b>Ischial tuberosity</b>", "Large bony prominence, inferior ischium. Bears body weight when sitting. Attachment: hamstrings (semimembranosus, semitendinosus, long head biceps femoris), adductor magnus (ischial part), sacrotuberous ligament"),
        ("<b>Ischial ramus</b>", "Projects forward from tuberosity to fuse with inferior pubic ramus, forming ischiopubic ramus. Attachment: ischiocavernosus, bulbospongiosus, superficial & deep perineal muscles"),
    ]
    for feat, desc in isch_features:
        story.append(Paragraph(
            f"<b>• {feat}:</b> {desc}",
            ParagraphStyle('IF', fontName='Helvetica', fontSize=10, textColor=C_DARK_TEXT,
                leading=14, spaceAfter=5, leftIndent=10, firstLineIndent=-10)
        ))

    story.append(Spacer(1, 0.2*cm))
    story.append(pbox(
        "<b>CLINICAL PEARL — Ischial tuberosity avulsion fracture:</b> Common in young athletes "
        "during forceful hamstring contraction (e.g., sprinting). The hamstrings attach to the "
        "ischial tuberosity via a broad flat tendon. Seen on X-ray as a flake of bone."
    ))

    story.append(Spacer(1, 0.3*cm))
    story.append(mnemonic_box(
        'Structures through Greater Sciatic Foramen — "Pudgy Squirrels Go Nuts In Perilous Forests"',
        [
            "<b>P</b>iriformis (exits through it)",
            "<b>S</b>uperior gluteal nerve & vessels (above piriformis)",
            "<b>G</b>luteal inferior nerve & vessels (below piriformis)",
            "<b>N</b>erve to quadratus femoris",
            "<b>I</b>nferior pudendal (pudendal nerve & internal pudendal vessels)",
            "<b>P</b>osterior cutaneous nerve of thigh",
            "<b>N</b>erve to obturator internus + <b>S</b>ciatic nerve (largest!)",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 5: PUBIS ──────────────────────────────────────────────────────
    story.append(h1("5. THE PUBIS — DETAILED ANATOMY"))
    story.append(Spacer(1, 0.2*cm))

    story.append(ybox(
        "<b>PUBIS</b> = Anteroinferior component, contributing 1/5 of the acetabulum. "
        "The two pubic bones meet at the midline cartilaginous joint — the <b>pubic symphysis</b>."
    ))
    story.append(Spacer(1, 0.2*cm))

    story.append(h2("5.1 Parts of the Pubis"))
    pubis_data = [
        [Paragraph("<b>Part</b>", S['th']),
         Paragraph("<b>Description & Attachments</b>", S['th'])],
        [Paragraph("Pubic body", S['tc']),
         Paragraph("Flat, forms pubic symphysis (with fibrocartilaginous disc). Adductor longus, gracilis and rectus abdominis attach here", S['tc'])],
        [Paragraph("Superior pubic ramus", S['tc']),
         Paragraph("Extends laterally to acetabulum. Upper surface: pectineal line (pecten pubis) — attachment of pectineus muscle and lacunar ligament. Pubic tubercle at junction with body (inguinal ligament medial end)", S['tc'])],
        [Paragraph("Inferior pubic ramus", S['tc']),
         Paragraph("Extends downward to join ischial ramus (= ischiopubic ramus). Attachment: adductor brevis, gracilis, obturator externus", S['tc'])],
        [Paragraph("Pubic crest", S['tc']),
         Paragraph("Superior surface of pubic body. Attachment: rectus abdominis, pyramidalis", S['tc'])],
        [Paragraph("Pubic tubercle", S['tc']),
         Paragraph("Important landmark — medial end of inguinal ligament attaches here; inguinal canal opens medial to it (superficial inguinal ring)", S['tc'])],
    ]
    pubis_table = Table(pubis_data, colWidths=[4*cm, 12*cm])
    pubis_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#7b2d8b')),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_HIGHLIGHT_P, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, colors.HexColor('#7b2d8b')),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#c8a0d8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(pubis_table)
    story.append(ref_cite("Gray's Anatomy for Students, 4e, p.520–522"))

    story.append(Spacer(1, 0.2*cm))
    story.append(pbox(
        "<b>CLINICAL — Pubic symphysis dysfunction (PSD):</b> Common during pregnancy due to "
        "relaxin-induced ligament laxity. Pelvic floor physiotherapy is first-line treatment. "
        "<b>Osteitis pubis</b> is an inflammatory condition of the pubic symphysis seen in "
        "athletes (runners, footballers) causing groin pain."
    ))

    story.append(Spacer(1, 0.25*cm))
    story.append(mnemonic_box(
        'Pubic Tubercle — "Public Trouble at the Inguinal Ligament"',
        [
            "• <b>Pubic tubercle</b> = medial attachment of <b>inguinal ligament</b>",
            "• <b>Superficial inguinal ring</b> is just <b>lateral and superior</b> to pubic tubercle",
            "• <b>Femoral canal</b> is just <b>lateral</b> to pubic tubercle (below inguinal ligament)",
            "• Direct hernia: medial to inferior epigastric vessels, passes through superficial ring",
            "• Indirect hernia: lateral to inferior epigastric vessels, enters deep ring",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 6: ACETABULUM ────────────────────────────────────────────────
    story.append(h1("6. THE ACETABULUM"))
    story.append(Spacer(1, 0.2*cm))

    story.append(gbox(
        "<b>ACETABULUM</b> (Latin: 'vinegar cup') = The deep hemispherical socket on the "
        "lateral surface of the hip bone that articulates with the femoral head to form "
        "the hip joint. Formed by: Ilium (2/5) + Ischium (2/5) + Pubis (1/5)."
    ))
    story.append(Spacer(1, 0.2*cm))

    acet_data = [
        [Paragraph("<b>Structure</b>", S['th']),
         Paragraph("<b>Description</b>", S['th'])],
        [Paragraph("Acetabular fossa", S['tc']),
         Paragraph("Non-articular central depression (rough, porous). Contains fat pad and ligamentum teres (round ligament of femoral head)", S['tc'])],
        [Paragraph("Lunate surface", S['tc']),
         Paragraph("C-shaped/horseshoe articular surface (smooth hyaline cartilage). Articulates with femoral head", S['tc'])],
        [Paragraph("Acetabular notch", S['tc']),
         Paragraph("Inferior gap in lunate surface, converted to foramen by transverse acetabular ligament. Transmits: acetabular branch of obturator artery, nerve to acetabulum", S['tc'])],
        [Paragraph("Acetabular labrum", S['tc']),
         Paragraph("Fibrocartilaginous rim deepening the socket by ~30%. Continuity maintained by transverse acetabular ligament inferiorly", S['tc'])],
    ]
    acet_table = Table(acet_data, colWidths=[4.5*cm, 11.5*cm])
    acet_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_DEEP_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_BLUE, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(acet_table)

    story.append(Spacer(1, 0.2*cm))
    story.append(pbox(
        "<b>CLINICAL — Acetabular fractures:</b> Usually from high-energy trauma (RTA, falls from height). "
        "Classified by Judet-Letournel system (elementary: posterior wall/column, anterior wall/column, "
        "transverse; associated: T-shaped, both columns, etc.). CT essential for classification and "
        "surgical planning."
    ))

    story.append(PageBreak())

    # ── SECTION 7: MUSCLE ATTACHMENTS ────────────────────────────────────────
    story.append(h1("7. MUSCLE ATTACHMENTS TO THE HIP BONE"))
    story.append(Spacer(1, 0.2*cm))

    # Key muscle attachment diagrams from Imaging Anatomy
    story += make_img(
        "https://cdn.orris.care/cdss_images/84d4f62ec05123b8110b6589d374d8276dfde69c6a8c416a973834b643265913.png",
        width=15*cm,
        caption="Fig. 8.11 — Muscle attachments of the pelvis and femur, anterior and posterior views "
                "(ASIS = anterior superior iliac spine; PSIS = posterior superior iliac spine)",
        ref="Imaging Anatomy Vol.3, p.228–229"
    )

    story += make_img(
        "https://cdn.orris.care/cdss_images/9c6f8e18adae796ae7019f13d074c9271066637989457669fdcebeb41911e605.png",
        width=15*cm,
        caption="Fig. 8.12 — Muscle attachments to iliac wing and pelvic floor muscles. "
                "Inguinal ligament (ASIS to pubic tubercle); iliofemoral ligament (AIIS to hip joint)",
        ref="Imaging Anatomy Vol.3, p.229"
    )

    story.append(Spacer(1, 0.2*cm))
    story.append(ybox(
        "<b>NOTE on Fig. 8.11 & 8.12:</b> The color-coded regions show distinct muscle "
        "attachment zones — anterior (iliacus, rectus femoris, sartorius, TFL, inguinal "
        "ligament), posterior (glutei, hamstrings, piriformis), medial (adductors, "
        "obturators), and perineal muscles on the inferior rami."
    ))
    story.append(Spacer(1, 0.25*cm))

    story.append(h2("7.1 ILIAC CREST — Muscle Attachments"))
    story.append(body(
        "The iliac crest has three lips (outer, intermediate, inner) with distinct muscle origins:"
    ))

    crest_data = [
        [Paragraph("<b>Lip</b>", S['th']),
         Paragraph("<b>Muscles Attaching</b>", S['th']),
         Paragraph("<b>Action</b>", S['th'])],
        [Paragraph("External (outer) lip", S['tc']),
         Paragraph("External oblique abdominis, Tensor fasciae latae (TFL), Latissimus dorsi (small part)", S['tc']),
         Paragraph("Trunk flexion/rotation, thigh abduction, trunk extension", S['tc'])],
        [Paragraph("Intermediate zone", S['tc']),
         Paragraph("Internal oblique abdominis", S['tc']),
         Paragraph("Trunk flexion/rotation", S['tc'])],
        [Paragraph("Internal (inner) lip", S['tc']),
         Paragraph("Transversus abdominis, Iliacus, Quadratus lumborum, Iliocostalis, Iliac fascia", S['tc']),
         Paragraph("Abdominal compression, hip flexion, lumbar extension", S['tc'])],
    ]
    crest_table = Table(crest_data, colWidths=[4*cm, 7*cm, 5*cm])
    crest_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_MED_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.HexColor('#e8f4f8'), colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(crest_table)
    story.append(ref_cite("Imaging Anatomy Vol.3, p.229; Gray's Anatomy for Students, 4e, p.518"))

    story.append(Spacer(1, 0.3*cm))

    story.append(h2("7.2 ANTERIOR ILIUM — Muscle Attachments"))
    ant_data = [
        [Paragraph("<b>Landmark</b>", S['th']),
         Paragraph("<b>Muscle / Structure</b>", S['th']),
         Paragraph("<b>Notes</b>", S['th'])],
        [Paragraph("ASIS", S['tc']),
         Paragraph("1. Sartorius\n2. Tensor fasciae latae (TFL)\n3. Inguinal ligament (lateral end)", S['tc']),
         Paragraph("Sartorius = longest muscle in body; ASIS avulsion common in sprinters", S['tc'])],
        [Paragraph("AIIS", S['tc']),
         Paragraph("1. Rectus femoris (direct/straight head)\n2. Iliofemoral ligament", S['tc']),
         Paragraph("Indirect head from ilium just above acetabulum; AIIS avulsion in footballers (kicking)", S['tc'])],
        [Paragraph("Iliac fossa", S['tc']),
         Paragraph("Iliacus muscle (entire concave medial surface)", S['tc']),
         Paragraph("Joins psoas major to form iliopsoas — strongest hip flexor. Inserts lesser trochanter", S['tc'])],
        [Paragraph("Pectineal line (iliopectineal)", S['tc']),
         Paragraph("Psoas major (small part), iliopectineal arch", S['tc']),
         Paragraph("Marks brim of pelvis", S['tc'])],
    ]
    ant_table = Table(ant_data, colWidths=[3.5*cm, 6.5*cm, 6*cm])
    ant_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#e07b39')),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_MNEMONIC, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, colors.HexColor('#e07b39')),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#f0c080')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
    ]))
    story.append(ant_table)

    story.append(PageBreak())

    story.append(h2("7.3 POSTERIOR ILIUM & ISCHIUM — Gluteal & Hamstring Attachments"))

    post_data = [
        [Paragraph("<b>Region / Landmark</b>", S['th']),
         Paragraph("<b>Muscle</b>", S['th']),
         Paragraph("<b>Innervation & Function</b>", S['th'])],
        [Paragraph("Posterior gluteal surface\n(behind posterior gluteal line)", S['tc']),
         Paragraph("Gluteus maximus (posterior gluteal line to PSIS/sacrum/coccyx)", S['tc']),
         Paragraph("Inferior gluteal nerve (L5,S1,S2) — extends & laterally rotates thigh", S['tc'])],
        [Paragraph("Between anterior &\nposterior gluteal lines", S['tc']),
         Paragraph("Gluteus medius", S['tc']),
         Paragraph("Superior gluteal nerve (L4,L5,S1) — abducts thigh, medially rotates in flexion; Trendelenburg if weak", S['tc'])],
        [Paragraph("Between anterior &\ninferior gluteal lines", S['tc']),
         Paragraph("Gluteus minimus", S['tc']),
         Paragraph("Superior gluteal nerve (L4,L5,S1) — abducts and medially rotates thigh", S['tc'])],
        [Paragraph("Outer surface of ilium\n(between ant & inf lines, deep)", S['tc']),
         Paragraph("Reflected tendon of rectus femoris + iliofemoral ligament", S['tc']),
         Paragraph("Just above acetabulum rim", S['tc'])],
        [Paragraph("Dorsum of ilium\n(posterior gluteal fossa)", S['tc']),
         Paragraph("Piriformis (from pelvic surface of S2-4, exits greater sciatic foramen)", S['tc']),
         Paragraph("Nerve to piriformis (S1,S2) — laterally rotates/abducts extended thigh", S['tc'])],
        [Paragraph("Ischial tuberosity", S['tc']),
         Paragraph("Semimembranosus (medial), Semitendinosus (medial), Long head Biceps femoris (medial-lateral), Adductor magnus (ischial part — most medial)", S['tc']),
         Paragraph("Sciatic nerve (tibial part for semimemb & semitend; common peroneal for biceps) — hamstrings flex knee, extend hip. Adductor magnus: also extends hip", S['tc'])],
        [Paragraph("Body of ischium\n(outer surface)", S['tc']),
         Paragraph("Obturator externus (lower part)", S['tc']),
         Paragraph("Obturator nerve (L2,L3,L4) — laterally rotates thigh", S['tc'])],
        [Paragraph("Outer surface of\nischiopubic ramus", S['tc']),
         Paragraph("Obturator externus, Adductor brevis, Adductor longus, Gracilis", S['tc']),
         Paragraph("Obturator nerve — adducts thigh", S['tc'])],
        [Paragraph("Inner surface of\nischiopubic ramus", S['tc']),
         Paragraph("Ischiocavernosus, Bulbospongiosus, Deep transverse perineal, Sphincter urethrae", S['tc']),
         Paragraph("Perineal branch of pudendal nerve — perineal muscles", S['tc'])],
    ]
    post_table = Table(post_data, colWidths=[4*cm, 5.5*cm, 6.5*cm])
    post_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_DEEP_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_BLUE, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ('FONTSIZE', (0,0), (-1,-1), 9),
    ]))
    story.append(post_table)
    story.append(ref_cite("Imaging Anatomy Vol.3, Fig. 8.11–8.13, p.228–232"))

    story.append(Spacer(1, 0.25*cm))

    story.append(mnemonic_box(
        'Hamstrings Origin — "Semi-Bros have a Long Bicep"',
        [
            "All three hamstrings originate from the <b>ischial tuberosity</b>:",
            "• <b>S</b>emitendinosus — ischial tuberosity (medial impression)",
            "• <b>S</b>emimembranosus — ischial tuberosity (lateral impression, more deeply)",
            "• <b>B</b>iceps femoris LONG head — ischial tuberosity (common tendon with semitendinosus)",
            "• Plus <b>Adductor Magnus</b> (ischial/hamstring part) = from ischial tuberosity (most medial)",
            "Mnemonic: '<b>2 Semi + Long Bicep all share the Tuber</b>'",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 8: MEDIAL / ADDUCTOR ATTACHMENTS ─────────────────────────────
    story.append(h1("8. MEDIAL (ADDUCTOR) ATTACHMENTS"))
    story.append(Spacer(1, 0.2*cm))

    story.append(gbox(
        "<b>The adductor group and medial rotators originate from the pubic bone and "
        "ischiopubic ramus.</b> They are innervated predominantly by the obturator nerve "
        "(L2-L4), except adductor magnus (also sciatic) and pectineus (also femoral nerve)."
    ))
    story.append(Spacer(1, 0.2*cm))

    add_data = [
        [Paragraph("<b>Muscle</b>", S['th']),
         Paragraph("<b>Origin on Hip Bone</b>", S['th']),
         Paragraph("<b>Insertion</b>", S['th']),
         Paragraph("<b>Nerve</b>", S['th'])],
        [Paragraph("Pectineus", S['tc']),
         Paragraph("Pectineal line (pecten pubis)", S['tc']),
         Paragraph("Pectineal line of femur", S['tc']),
         Paragraph("Femoral (L2,L3) ± obturator", S['tc'])],
        [Paragraph("Adductor longus", S['tc']),
         Paragraph("Anterior pubic body (below pubic crest)", S['tc']),
         Paragraph("Linea aspera (middle 1/3)", S['tc']),
         Paragraph("Obturator (L2,L3,L4)", S['tc'])],
        [Paragraph("Adductor brevis", S['tc']),
         Paragraph("Inferior pubic ramus (body + inferior ramus)", S['tc']),
         Paragraph("Linea aspera (upper 1/3)", S['tc']),
         Paragraph("Obturator (L2,L3)", S['tc'])],
        [Paragraph("Adductor magnus\n(adductor part)", S['tc']),
         Paragraph("Inferior pubic ramus + ischial ramus", S['tc']),
         Paragraph("Linea aspera (entire)", S['tc']),
         Paragraph("Obturator (L2,L3,L4)", S['tc'])],
        [Paragraph("Adductor magnus\n(hamstring/ischial part)", S['tc']),
         Paragraph("Ischial tuberosity", S['tc']),
         Paragraph("Adductor tubercle (medial femoral condyle)", S['tc']),
         Paragraph("Sciatic (tibial, L4)", S['tc'])],
        [Paragraph("Gracilis", S['tc']),
         Paragraph("Inferior pubic ramus + ischial ramus (medial surface)", S['tc']),
         Paragraph("Pes anserinus (medial tibia)", S['tc']),
         Paragraph("Obturator (L2,L3)", S['tc'])],
        [Paragraph("Obturator externus", S['tc']),
         Paragraph("Outer surface of obturator membrane + adjacent bone (pubis & ischium)", S['tc']),
         Paragraph("Trochanteric fossa of femur", S['tc']),
         Paragraph("Obturator (L3,L4)", S['tc'])],
        [Paragraph("Obturator internus", S['tc']),
         Paragraph("Inner surface of obturator membrane + adjacent bone", S['tc']),
         Paragraph("Medial surface of greater trochanter", S['tc']),
         Paragraph("Nerve to OI (L5,S1)", S['tc'])],
    ]
    add_table = Table(add_data, colWidths=[3.5*cm, 4.5*cm, 4.5*cm, 3.5*cm])
    add_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1e6b3c')),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_HIGHLIGHT_G, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, colors.HexColor('#1e6b3c')),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#a0d4b0')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 4),
        ('BOTTOMPADDING', (0,0), (-1,-1), 4),
        ('LEFTPADDING', (0,0), (-1,-1), 5),
        ('RIGHTPADDING', (0,0), (-1,-1), 5),
        ('FONTSIZE', (0,0), (-1,-1), 9),
    ]))
    story.append(add_table)
    story.append(ref_cite("Gray's Anatomy for Students, 4e; Imaging Anatomy Vol.3, p.228–232"))

    story.append(Spacer(1, 0.25*cm))
    story.append(mnemonic_box(
        'Adductor group — "Please Add Broccoli Graciously"',
        [
            "<b>P</b>ectineus — from pectineal line",
            "<b>A</b>dductor longus — from anterior pubic body (most anterior, easiest to palpate)",
            "<b>B</b>revis — behind longus",
            "<b>M</b>agnus — largest (2 parts: adductor from ramus, hamstring from tuberosity)",
            "<b>G</b>racilis — medial-most, crosses knee (pes anserinus with sartorius & semitendinosus)",
            "Mnemonic for pes anserinus: '<b>Say Grace before Tea</b>' = Sartorius, Gracilis, Semitendinosus",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 9: COMPLETE MUSCLE ATTACHMENT TABLE ───────────────────────────
    story.append(h1("9. COMPLETE MUSCLE ATTACHMENT QUICK-REFERENCE"))
    story.append(Spacer(1, 0.2*cm))

    story.append(body(
        "The following comprehensive table summarizes ALL muscle origins from the hip bone, "
        "organized by location for rapid revision."
    ))
    story.append(Spacer(1, 0.2*cm))

    all_muscles = [
        [Paragraph("<b>Location</b>", S['th']),
         Paragraph("<b>Muscle</b>", S['th']),
         Paragraph("<b>Nerve</b>", S['th']),
         Paragraph("<b>Action</b>", S['th'])],
        # Iliac crest
        [Paragraph("Iliac crest\n(outer lip)", S['tc']),
         Paragraph("External oblique abdominis\nTFL\nLatissimus dorsi (small slip)", S['tc']),
         Paragraph("Subcostal nerves\nSuperior gluteal\nThoracodorsal", S['tc']),
         Paragraph("Trunk rotation\nThigh abduction\nTrunk extension", S['tc'])],
        [Paragraph("Iliac crest\n(intermediate)", S['tc']),
         Paragraph("Internal oblique abdominis", S['tc']),
         Paragraph("Iliohypogastric, ilioinguinal", S['tc']),
         Paragraph("Trunk flexion/rotation", S['tc'])],
        [Paragraph("Iliac crest\n(inner lip)", S['tc']),
         Paragraph("Transversus abdominis\nIliacus\nQuadratus lumborum\nIliocostalis (part)", S['tc']),
         Paragraph("Iliohypogastric\nFemoral\nL1-L4\nDorsal rami", S['tc']),
         Paragraph("Trunk compression\nHip flexion\nLumbar lateral flexion", S['tc'])],
        # ASIS
        [Paragraph("ASIS", S['tc']),
         Paragraph("Sartorius\nTFL\nInguinal ligament (lateral)", S['tc']),
         Paragraph("Femoral (L2,L3)\nSuperior gluteal\n—", S['tc']),
         Paragraph("Hip flex/knee flex/lat rotate\nThigh abduction/flex", S['tc'])],
        # AIIS
        [Paragraph("AIIS", S['tc']),
         Paragraph("Rectus femoris (direct head)\nIliofemoral ligament", S['tc']),
         Paragraph("Femoral (L3,L4)\n—", S['tc']),
         Paragraph("Extends knee / flexes hip", S['tc'])],
        # Iliac fossa
        [Paragraph("Iliac fossa\n(medial surface)", S['tc']),
         Paragraph("Iliacus", S['tc']),
         Paragraph("Femoral (L2,L3)", S['tc']),
         Paragraph("Flexes hip (iliopsoas)", S['tc'])],
        # Gluteal surface
        [Paragraph("Behind posterior\ngluteal line", S['tc']),
         Paragraph("Gluteus maximus", S['tc']),
         Paragraph("Inferior gluteal (L5,S1,S2)", S['tc']),
         Paragraph("Extends & lat rotates hip", S['tc'])],
        [Paragraph("Between ant &\npost gluteal lines", S['tc']),
         Paragraph("Gluteus medius", S['tc']),
         Paragraph("Superior gluteal (L4,L5,S1)", S['tc']),
         Paragraph("Abducts; med rotates hip", S['tc'])],
        [Paragraph("Between ant &\ninf gluteal lines", S['tc']),
         Paragraph("Gluteus minimus", S['tc']),
         Paragraph("Superior gluteal (L4,L5,S1)", S['tc']),
         Paragraph("Abducts; med rotates hip", S['tc'])],
        # Ischial tuberosity
        [Paragraph("Ischial tuberosity", S['tc']),
         Paragraph("Semitendinosus\nSemimembranosus\nBiceps femoris (long head)\nAdductor magnus (ischial)\nSacrotuberous ligament", S['tc']),
         Paragraph("Sciatic–tibial\nSciatic–tibial\nSciatic–CF\nSciatic–tibial\n—", S['tc']),
         Paragraph("Flexes knee\nExtends hip", S['tc'])],
        # Ischiopubic ramus
        [Paragraph("Outer surface of\nischiopubic ramus", S['tc']),
         Paragraph("Adductor brevis\nAdductor longus\nAdductor magnus (add)\nGracilis\nObturator externus", S['tc']),
         Paragraph("Obturator\nObturator\nObturator\nObturator\nObturator", S['tc']),
         Paragraph("Adducts thigh", S['tc'])],
        [Paragraph("Inner surface of\nischiopubic ramus", S['tc']),
         Paragraph("Ischiocavernosus\nBulbospongiosus\nDeep transverse perineal\nExternal urethral sphincter", S['tc']),
         Paragraph("Pudendal nerve (perineal branch)", S['tc']),
         Paragraph("Perineal/erectile function", S['tc'])],
        # Pubic body
        [Paragraph("Pubic body &\nsymphysis", S['tc']),
         Paragraph("Rectus abdominis\nPyramidalis\nAdductor longus\nAdductor brevis (upper)", S['tc']),
         Paragraph("T7-T12\nT12-L1\nObturator\nObturator", S['tc']),
         Paragraph("Flexes trunk\nTenses linea alba\nAdducts thigh", S['tc'])],
        [Paragraph("Pectineal line\n(superior ramus)", S['tc']),
         Paragraph("Pectineus\nPsoas minor (variable)", S['tc']),
         Paragraph("Femoral ± obturator\nL1", S['tc']),
         Paragraph("Adducts & flexes hip\nWeak trunk flexion", S['tc'])],
        # Obturator membrane
        [Paragraph("Obturator membrane\n(internal surface)", S['tc']),
         Paragraph("Obturator internus", S['tc']),
         Paragraph("Nerve to OI (L5,S1)", S['tc']),
         Paragraph("Laterally rotates extended hip; abducts flexed hip", S['tc'])],
        [Paragraph("Obturator membrane\n(external surface)", S['tc']),
         Paragraph("Obturator externus", S['tc']),
         Paragraph("Obturator (L3,L4)", S['tc']),
         Paragraph("Laterally rotates thigh", S['tc'])],
    ]

    all_table = Table(all_muscles, colWidths=[3.5*cm, 5.5*cm, 3.5*cm, 3.5*cm])
    all_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_DEEP_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_BLUE, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 4),
        ('BOTTOMPADDING', (0,0), (-1,-1), 4),
        ('LEFTPADDING', (0,0), (-1,-1), 5),
        ('RIGHTPADDING', (0,0), (-1,-1), 5),
        ('FONTSIZE', (0,0), (-1,-1), 8.5),
    ]))
    story.append(all_table)
    story.append(ref_cite(
        "Sources: Gray's Anatomy for Students 4e (Elsevier); "
        "Imaging Anatomy Vol.3 — Bones, Joints, Vessels & Nerves (THIEME); "
        "THIEME General Anatomy & Musculoskeletal System"
    ))

    story.append(PageBreak())

    # ── SECTION 10: OBTURATOR FORAMEN ────────────────────────────────────────
    story.append(h1("10. OBTURATOR FORAMEN"))
    story.append(Spacer(1, 0.2*cm))

    story.append(gbox(
        "<b>OBTURATOR FORAMEN</b> = Large oval opening in the anteroinferior hip bone, "
        "bounded by the pubis (anterosuperiorly) and ischium (posteriorly). Almost entirely "
        "covered by the <b>obturator membrane</b>. Only the <b>obturator canal</b> "
        "(superior gap) transmits the obturator nerve & vessels from pelvis to medial thigh."
    ))
    story.append(Spacer(1, 0.2*cm))

    story.append(body(
        "The obturator foramen is the largest foramen in the skeleton. In females it is "
        "triangular; in males it is oval. It provides attachment for:"
    ))
    for m in ["Obturator membrane (covers most of the foramen)",
              "Obturator externus (outer surface of membrane)",
              "Obturator internus (inner surface of membrane)",
              "Obturator canal transmits: Obturator nerve (anterior & posterior divisions), Obturator artery & vein"]:
        story.append(bullet(m))

    story.append(Spacer(1, 0.2*cm))
    story.append(pbox(
        "<b>CLINICAL — Obturator hernia:</b> Rare but dangerous herniation through the obturator "
        "canal. More common in thin elderly women. Presents with medial thigh pain (Howship-Romberg "
        "sign — pain along obturator nerve distribution). Often presents with bowel obstruction. "
        "Difficult to diagnose clinically; CT abdomen is gold standard."
    ))

    story.append(PageBreak())

    # ── SECTION 11: PELVIC GIRDLE & JOINTS ───────────────────────────────────
    story.append(h1("11. PELVIC GIRDLE — JOINTS & LIGAMENTS"))
    story.append(Spacer(1, 0.2*cm))

    story += make_img(
        "https://cdn.orris.care/cdss_images/1c14c52bf33eb8c5147ddfdba5afad70b89d61a7466e9dd847cbe82b26488520.png",
        width=13*cm,
        caption="E — The pelvic girdle and pelvic ring (anterior view). "
                "Hip bones + sacrum form a stable ring for load transfer. "
                "Sacroiliac joints (posterior) and pubic symphysis (anterior).",
        ref="THIEME General Anatomy & Musculoskeletal System, p.434"
    )

    story += make_img(
        "https://cdn.orris.care/cdss_images/29cf0e5fe29436c3f594c81a35e636163dbdf0eabbeb275836d47583aa341768.png",
        width=13*cm,
        caption="Pelvic girdle anatomy (THIEME Atlas) — overall pelvic ring including sacroiliac joints",
        ref="THIEME General Anatomy & Musculoskeletal System, p.433"
    )

    story.append(Spacer(1, 0.2*cm))

    joints_data = [
        [Paragraph("<b>Joint</b>", S['th']),
         Paragraph("<b>Type</b>", S['th']),
         Paragraph("<b>Key Ligaments</b>", S['th']),
         Paragraph("<b>Notes</b>", S['th'])],
        [Paragraph("Sacroiliac joint", S['tc']),
         Paragraph("Synovial (anterior) + syndesmosis (posterior)", S['tc']),
         Paragraph("Anterior SI, posterior SI (strongest), interosseous SI, iliolumbar lig (L5→iliac crest)", S['tc']),
         Paragraph("Very limited motion (nutation/counternutation). 'Pain in the butt' = SIJ dysfunction", S['tc'])],
        [Paragraph("Pubic symphysis", S['tc']),
         Paragraph("Secondary cartilaginous (amphiarthrosis)", S['tc']),
         Paragraph("Superior pubic ligament, inferior arcuate pubic ligament", S['tc']),
         Paragraph("Fibrocartilaginous disc between pubic bodies. Moves ~2mm normally; increases in pregnancy", S['tc'])],
        [Paragraph("Hip joint\n(coxofemoral)", S['tc']),
         Paragraph("Synovial ball-and-socket", S['tc']),
         Paragraph("Iliofemoral (Y-lig of Bigelow — STRONGEST), pubofemoral, ischiofemoral, ligamentum teres (intracapsular)", S['tc']),
         Paragraph("Most stable joint in body. Ligamentum teres transmits artery to femoral head (obturator a.)", S['tc'])],
    ]
    joints_table = Table(joints_data, colWidths=[3*cm, 3.5*cm, 5.5*cm, 4*cm])
    joints_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), C_DEEP_BLUE),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_BLUE, colors.white]),
        ('BOX', (0,0), (-1,-1), 1, C_BORDER),
        ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('TOPPADDING', (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ('FONTSIZE', (0,0), (-1,-1), 9),
    ]))
    story.append(joints_table)

    story.append(Spacer(1, 0.25*cm))
    story.append(mnemonic_box(
        'Hip Joint Ligaments — "I Put In Ligaments"',
        [
            "<b>I</b>liofemoral (Y-ligament of Bigelow) — STRONGEST, ASIS/AIIS → intertrochanteric line",
            "<b>P</b>ubofemoral — from pectineal eminence (pubis) → iliofemoral ligament",
            "<b>I</b>schiofemoral — from ischium → greater trochanter (weakest posteriorly)",
            "<b>L</b>igamentum teres — acetabular notch → fovea capitis femori (transmits artery)",
            "Tip: Iliofemoral prevents <b>hyperextension</b> — strongest because we stand upright",
        ]
    ))

    story.append(PageBreak())

    # ── SECTION 12: CLINICAL PEARLS & RADIOLOGY ──────────────────────────────
    story.append(h1("12. CLINICAL PEARLS & RADIOLOGY"))
    story.append(Spacer(1, 0.2*cm))

    story += make_img(
        "https://cdn.orris.care/cdss_images/0ebba936b30185e09ddb4f8c60409a1f10ba683be1eb931b71a8b1739ca95413.png",
        width=14*cm,
        caption="Fig. 8.10 — Components of the pelvis and femur in anterior and posterior views",
        ref="Imaging Anatomy Vol.3 — Bones, Joints, Vessels & Nerves, p.228"
    )

    story.append(Spacer(1, 0.2*cm))

    clinical_items = [
        ("<b>ASIS avulsion fracture</b>",
         "Young athletes (sprinters). Sartorius or TFL pulls off ASIS. "
         "Conservative management; surgical fixation if >2 cm displacement."),
        ("<b>AIIS avulsion fracture</b>",
         "Footballers during powerful kicking. Rectus femoris direct head avulses AIIS. "
         "Usually conservative."),
        ("<b>Ischial tuberosity avulsion</b>",
         "Sprinters/hurdlers. Hamstring origin avulsed. MRI confirms. "
         "Usually conservative; surgical if >2 cm or chronic."),
        ("<b>Stress fracture of pubic rami</b>",
         "Elderly women with osteoporosis (insufficiency fracture). "
         "Runners (fatigue fracture). MRI more sensitive than X-ray."),
        ("<b>Hip pointer</b>",
         "Contusion of iliac crest (direct blow in contact sports). "
         "Pain with muscle contraction. Ice and rest."),
        ("<b>Trendelenburg gait</b>",
         "Weakness of gluteus medius (superior gluteal nerve). Pelvis drops to "
         "opposite side when weight-bearing on affected limb. Causes: hip OA, "
         "post-THR, gluteus medius tear, L4-L5 nerve root compression."),
        ("<b>Bone marrow biopsy</b>",
         "Posterior iliac crest (PSIS area). Most common site for trephine biopsy in "
         "haematological conditions (leukaemia, lymphoma, myeloma)."),
        ("<b>Iliac crest bone graft harvest</b>",
         "Gold standard autograft site for spinal fusion, open fracture management. "
         "Anterior crest (under general) or posterior crest (lateral position)."),
    ]

    for title_c, text_c in clinical_items:
        data = [[Paragraph(f"⚕ {title_c}", ParagraphStyle('CT',
                    fontName='Helvetica-Bold', fontSize=10, textColor=C_MED_BLUE,
                    leading=14)),
                 Paragraph(text_c, S['body'])]]
        t = Table(data, colWidths=[5*cm, 11*cm])
        t.setStyle(TableStyle([
            ('BACKGROUND', (0,0), (0,0), C_LIGHT_BLUE),
            ('BACKGROUND', (1,0), (1,0), colors.white),
            ('BOX', (0,0), (-1,-1), 0.8, C_MED_BLUE),
            ('INNERGRID', (0,0), (-1,-1), 0.5, colors.HexColor('#aacce8')),
            ('VALIGN', (0,0), (-1,-1), 'TOP'),
            ('TOPPADDING', (0,0), (-1,-1), 6),
            ('BOTTOMPADDING', (0,0), (-1,-1), 6),
            ('LEFTPADDING', (0,0), (-1,-1), 6),
            ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ]))
        story.append(t)
        story.append(Spacer(1, 0.1*cm))

    story.append(PageBreak())

    # ── SECTION 13: MNEMONICS SUMMARY ────────────────────────────────────────
    story.append(h1("13. MNEMONICS SUMMARY PAGE"))
    story.append(Spacer(1, 0.2*cm))

    all_mnemonics = [
        ("3 Bones of Hip", "'<b>I Sit Pretty</b>' = Ilium, Ischium, Pubis\n(I = Ilium=Superior; S=Ischium=Sit on it; P=Pubis=Posterior-anterior)"),
        ("Acetabulum Ratio", "'<b>IIP: 2-2-1</b>' = Ilium 2/5, Ischium 2/5, Pubis 1/5"),
        ("Triradiate fusion age", "'<b>Sweet 16</b>' = fuses ~16 years (14-18 range)"),
        ("Gluteal Lines & Muscles", "'<b>3 lines 3 glutes — MAX is back</b>'\nMaximus behind posterior line\nMedius between ant & post\nMinimus between ant & inf"),
        ("Hamstrings on ischial tuberosity", "'<b>2 Semi + Long Bicep</b>'\nSemitendinosus + Semimembranosus + long head Biceps femoris\n(+ Adductor magnus ischial part)"),
        ("Pes Anserinus", "'<b>Say Grace before Tea</b>' = Sartorius, Gracilis, Semitendinosus"),
        ("Adductors", "'<b>Please Add Broccoli Graciously</b>'\nPectineus, Adductor longus/brevis/magnus, Gracilis"),
        ("ASIS attachments", "'<b>STIG</b>' = Sartorius, TFL, Inguinal ligament, Groin"),
        ("AIIS attachments", "'<b>AIIS = Rec-fi (Rectus femoris) & Ilio-F (iliofemoral lig)</b>'"),
        ("Hip joint ligaments", "'<b>I Put In Ligaments</b>' = Iliofemoral (strongest), Pubofemoral, Ischiofemoral, Ligamentum teres"),
        ("Greater Sciatic Foramen contents", "'<b>2 above, lots below piriformis</b>'\nAbove: Superior gluteal n+v\nBelow: Sciatic, Inferior gluteal n+v, Pudendal n, Post-cut-fem n, Nerve to OI, N to QF"),
        ("Lesser Sciatic Foramen contents", "'<b>OIP</b>' = Obturator internus tendon (exits then re-enters here), Internal pudendal a+v, Pudendal nerve"),
        ("Iliac crest biopsy", "'<b>PSIS = Posterior Superior = Biopsy Site</b>'"),
        ("Obturator nerve", "'<b>Obturator = Adductors</b>' L2,L3,L4 — exits through obturator canal\nAnterior division: adductor longus, brevis, gracilis, pectineus\nPosterior division: obturator externus, adductor magnus (part)"),
    ]

    for mnem_title, mnem_text in all_mnemonics:
        rows = [
            [Paragraph(f"🧠 {mnem_title}", ParagraphStyle('MnH',
                fontName='Helvetica-Bold', fontSize=10, textColor=C_ORANGE_DARK, leading=14))],
            [Paragraph(mnem_text.replace('\n','<br/>'), ParagraphStyle('MnB',
                fontName='Helvetica', fontSize=9.5, textColor=C_DARK_TEXT, leading=14))],
        ]
        t = Table(rows, colWidths=[doc.width])
        t.setStyle(TableStyle([
            ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#fff0d9')),
            ('BACKGROUND', (0,1), (-1,1), colors.white),
            ('BOX', (0,0), (-1,-1), 1, colors.HexColor('#e07b39')),
            ('INNERGRID', (0,0), (-1,-1), 0.3, colors.HexColor('#f0c080')),
            ('TOPPADDING', (0,0), (-1,-1), 5),
            ('BOTTOMPADDING', (0,0), (-1,-1), 5),
            ('LEFTPADDING', (0,0), (-1,-1), 8),
            ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ]))
        story.append(t)
        story.append(Spacer(1, 0.12*cm))

    story.append(PageBreak())

    # ── SECTION 14: BIBLIOGRAPHY ──────────────────────────────────────────────
    story.append(h1("14. BIBLIOGRAPHY & REFERENCES"))
    story.append(Spacer(1, 0.3*cm))

    refs = [
        ("1.", "Drake RL, Vogl AW, Mitchell AWM.",
         "Gray's Anatomy for Students, 4th Edition.",
         "Philadelphia: Elsevier; 2020. Chapter 5: Pelvis & Perineum, p.516–555."),
        ("2.", "Weir J, Abrahams P, Spratt J, Salkowski L.",
         "Imaging Anatomy: Text and Atlas, Volume 3 — Bones, Joints, Vessels & Nerves.",
         "Stuttgart: THIEME; 2020. Chapter 8: Pelvis, p.225–270."),
        ("3.", "Schuenke M, Schulte E, Schumacher U.",
         "THIEME Atlas of Anatomy: General Anatomy and Musculoskeletal System, 3rd Edition.",
         "Stuttgart: THIEME; 2021. Section 1.3: Bones of the Pelvic Girdle, p.432–440."),
        ("4.", "Gray H (original), updated by Williams PL et al.",
         "Gray's Anatomy: The Anatomical Basis of Clinical Practice, 42nd Edition.",
         "Philadelphia: Elsevier; 2021. (Classic reference)"),
        ("5.", "Moore KL, Dalley AF, Agur AMR.",
         "Clinically Oriented Anatomy, 8th Edition.",
         "Philadelphia: Wolters Kluwer; 2018. Chapter 5: Pelvis & Perineum."),
    ]

    for num, authors, title_r, pub in refs:
        story.append(Paragraph(
            f"<b>{num}</b> {authors} <i>{title_r}</i> {pub}",
            ParagraphStyle('RefItem', fontName='Helvetica', fontSize=9.5,
                textColor=C_DARK_TEXT, leading=14, spaceAfter=6, leftIndent=20, firstLineIndent=-20)
        ))

    story.append(Spacer(1, 0.5*cm))
    story.append(HRFlowable(width='100%', thickness=1.5, color=C_MED_BLUE))
    story.append(Spacer(1, 0.2*cm))
    story.append(Paragraph(
        "<i>This study guide was compiled from authenticated medical textbooks "
        "available in the Orris Medical Library. All diagrams are sourced directly "
        "from the referenced textbooks. For clinical decisions, always consult the "
        "original texts and current clinical guidelines.</i>",
        ParagraphStyle('Footer', fontName='Helvetica-Oblique', fontSize=9,
            textColor=C_GRAY, alignment=TA_CENTER, leading=13)
    ))

    # ── BUILD ────────────────────────────────────────────────────────────────
    def on_page(canvas, doc):
        canvas.saveState()
        # Header bar
        canvas.setFillColor(C_DEEP_BLUE)
        canvas.rect(0, PAGE_H - 1.2*cm, PAGE_W, 1.2*cm, fill=1, stroke=0)
        canvas.setFillColor(colors.white)
        canvas.setFont('Helvetica-Bold', 9)
        canvas.drawString(2*cm, PAGE_H - 0.8*cm, "THE HIP BONE — Complete Anatomical Study Guide")
        canvas.setFont('Helvetica', 9)
        canvas.drawRightString(PAGE_W - 2*cm, PAGE_H - 0.8*cm,
            "Orris Medical Library")
        # Footer
        canvas.setFillColor(C_DEEP_BLUE)
        canvas.rect(0, 0, PAGE_W, 0.9*cm, fill=1, stroke=0)
        canvas.setFillColor(colors.white)
        canvas.setFont('Helvetica', 8)
        canvas.drawCentredString(PAGE_W/2, 0.35*cm, f"Page {doc.page}")
        canvas.restoreState()

    def on_first_page(canvas, doc):
        # Draw cover background
        canvas.saveState()
        canvas.setFillColor(C_DEEP_BLUE)
        canvas.rect(0, 0, PAGE_W, PAGE_H, fill=1, stroke=0)
        canvas.setFillColor(C_MED_BLUE)
        canvas.rect(0, PAGE_H - 1.5*cm, PAGE_W, 1.5*cm, fill=1, stroke=0)
        canvas.rect(0, 0, PAGE_W, 1.2*cm, fill=1, stroke=0)
        canvas.setStrokeColor(colors.HexColor('#5bc0eb'))
        canvas.setLineWidth(4)
        canvas.line(2*cm, PAGE_H * 0.42, PAGE_W - 2*cm, PAGE_H * 0.42)
        canvas.restoreState()

    doc.build(story,
              onFirstPage=on_first_page,
              onLaterPages=on_page)
    print(f"PDF generated: {output_path}")


if __name__ == '__main__':
    output = '/tmp/workspace/hip-bone-pdf/Hip_Bone_Complete_Guide.pdf'
    build_pdf(output)
    import os
    size = os.path.getsize(output)
    print(f"File size: {size/1024:.1f} KB")