PDF Creator

Branding — Cores Ciclicas do Logo Microsoft

Cada secao H2 recebe a proxima cor do logo, ciclando a cada 4 secoes:

Paleta Completa (Microsoft Brand)

4-Color Bar

Every PDF includes the Microsoft 4-color gradient bar on the cover page and as a thin line in the header:

from reportlab.lib.colors import HexColor

def draw_4color_bar(canvas, x, y, width, height=4):
    """Draw the Microsoft 4-color bar."""
    segment = width / 4
    bar_colors = [
        HexColor('#F25022'),  # Red
        HexColor('#7FBA00'),  # Green
        HexColor('#00A4EF'),  # Blue
        HexColor('#FFB900'),  # Yellow
    ]
    for i, color in enumerate(bar_colors):
        canvas.setFillColor(color)
        canvas.rect(x + i * segment, y, segment, height, fill=1, stroke=0)

Fonts

reportlab includes Helvetica by default. For Microsoft branding, register Segoe UI if available:

from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
import os

# Try to register Segoe UI (available on Windows/macOS with Office installed)
segoe_paths = [
    '/Library/Fonts/Segoe UI.ttf',
    '/System/Library/Fonts/SegoeUI.ttf',
    'C:/Windows/Fonts/segoeui.ttf',
]
FONT_NAME = 'Helvetica'  # Fallback
for path in segoe_paths:
    if os.path.exists(path):
        pdfmetrics.registerFont(TTFont('SegoeUI', path))
        FONT_NAME = 'SegoeUI'
        break

Document Structure

Page Setup

from reportlab.lib.pagesizes import A4

PAGE_WIDTH, PAGE_HEIGHT = A4
MARGIN_LEFT = 60
MARGIN_RIGHT = 60
MARGIN_TOP = 60
MARGIN_BOTTOM = 50
CONTENT_WIDTH = PAGE_WIDTH - MARGIN_LEFT - MARGIN_RIGHT

Page 1: Cover Page (Padrao Editorial)

Fundo branco, layout centralizado, estilo editorial (inspirado no padrao Super Powers @ Petrobras).

┌─────────────────────────────────────────┐
│  [4-color bar across full width - 6px]  │
│                                         │
│       [Logo Microsoft + GitHub]         │
│       (logo-msft-github-color-black)    │
│                                         │
│       DOCUMENT TITLE                    │
│       28pt Bold #2B2B2B, centered       │
│                                         │
│       Subtitle / description            │
│       11pt Regular #6E6E6E, centered    │
│                                         │
│       ● ● ● ● (4 dots MS colors)       │
│                                         │
│  ┌────────┬────────┬────────┬────────┐  │
│  │  15    │  80+   │  45+   │   4    │  │
│  │ Perfis │ Funcs  │ Prods  │ Ondas  │  │
│  └────────┴────────┴────────┴────────┘  │
│       (KPI strip with brand colors)     │
│                                         │
│     [Photo]  Paula Silva                │
│     (circle   Latam Leader, Software GBB│
│      gradient  Microsoft Americas       │
│      border)   [email protected] │
│                                         │
│  ┌──────────────────────────────────┐   │
│  │ Preparado para: CLIENT · Data ·  │   │
│  │ Versao                           │   │
│  └──────────────────────────────────┘   │
│                                         │
│  [4-color bar - 4px]                    │
│  CLIENT — Confidencial — DATE           │
└─────────────────────────────────────────┘

Elementos obrigatorios da capa:

• Fundo branco (#FFFFFF), nao azul
• Logo colorido (nao branco) centralizado
• Titulo em preto bold (#2B2B2B), centralizado
• Subtitulo em cinza (#6E6E6E), centralizado
• 4 dots decorativos nas cores Microsoft
• KPI strip com 4 metricas-chave do documento
• Foto circular da autora com borda gradiente 4 cores MS
• Nome, cargo, empresa e email da autora
• Metadata: cliente, data e versao
• Foto da autora: sources/images/paula-silva-photo.jpg

Content Pages

┌─────────────────────────────────────────┐
│  [thin 4-color bar - 2px]              │
│  Document Title          Page X of Y    │
│  ─────────────────────────────────────  │
│                                         │
│  ## Section Title                       │
│  Body text...                           │
│                                         │
│  ┌─────────────────────────────┐        │
│  │  Table with branded headers │        │
│  │  Alternating row colors     │        │
│  └─────────────────────────────┘        │
│                                         │
│  Body text continues...                 │
│                                         │
│  ─────────────────────────────────────  │
│  {{client_name}} | v{{version}} | Conf  │
└─────────────────────────────────────────┘

Closing Page (Back Cover)

Gerada automaticamente pelo script. Reutiliza as mesmas classes CSS da cover page para garantir consistencia visual.

┌─────────────────────────────────────────┐
│  [4-color bar - 12px] (cover-bar)       │
│                                         │
│         [Logo Microsoft + GitHub]       │
│            (cover-logo)                 │
│                                         │
│            Obrigada!                    │
│       Próximos passos e contato         │
│                                         │
│  ● ● ● ●  (4 dots - cover-dot)         │
│                                         │
│  [Photo ring] Paula Silva               │
│              Latam Leader, Software GBB │
│              Microsoft Americas         │
│              [email protected]   │
│  (cover-speaker / cover-speaker-av)     │
│                                         │
│  ┌─── Disclaimer (closing-meta) ────┐  │
│  │  Confidencial... max-width: 95%  │  │
│  └──────────────────────────────────┘  │
│                                         │
│  [4-color bar - 12px] (cover-footer)    │
│  CLIENT — Confidencial — DATE           │
└─────────────────────────────────────────┘

Regras da closing page:

• Reutiliza classes da cover: cover-bar, cover-logo, cover-dot, cover-speaker, cover-speaker-av, cover-speaker-photo, cover-speaker-info, cover-speaker-name, cover-speaker-title, cover-footer
• Titulo "Obrigada!" em 38pt bold (#2B2B2B), letter-spacing: -0.5pt
• Subtitulo em 12pt (#6E6E6E)
• 4 dots decorativos nas cores Microsoft (mesmo da capa)
• Bloco autora identico ao da capa (foto circular 70pt com gradiente 4 cores, nome, cargo, empresa, email)
• Disclaimer em caixa sutil (#F8F8FA, borda #E2E2E6, max-width: 95% para evitar palavras orfas)
• Footer identico ao da capa
• @page closing-page sem headers/footers (mesma regra da capa)
• Padding top de 60mm para centralizar verticalmente o conteudo

Table Formatting

from reportlab.lib import colors
from reportlab.platypus import Table, TableStyle

def create_branded_table(data, col_widths=None):
    """Create a Microsoft-branded table."""
    table = Table(data, colWidths=col_widths)
    style = TableStyle([
        # Header row
        ('BACKGROUND', (0, 0), (-1, 0), HexColor('#0078D4')),
        ('TEXTCOLOR', (0, 0), (-1, 0), colors.white),
        ('FONTNAME', (0, 0), (-1, 0), FONT_NAME),
        ('FONTSIZE', (0, 0), (-1, 0), 10),
        ('BOTTOMPADDING', (0, 0), (-1, 0), 8),
        ('TOPPADDING', (0, 0), (-1, 0), 8),

        # Body rows
        ('FONTNAME', (0, 1), (-1, -1), FONT_NAME),
        ('FONTSIZE', (0, 1), (-1, -1), 9),
        ('BOTTOMPADDING', (0, 1), (-1, -1), 6),
        ('TOPPADDING', (0, 1), (-1, -1), 6),
        ('TEXTCOLOR', (0, 1), (-1, -1), HexColor('#323130')),

        # Alternating rows
        *[('BACKGROUND', (0, i), (-1, i),
           HexColor('#F3F2F1') if i % 2 == 0 else colors.white)
          for i in range(1, len(data))],

        # Borders
        ('GRID', (0, 0), (-1, -1), 0.5, HexColor('#D2D0CE')),
        ('LINEBELOW', (0, 0), (-1, 0), 1.5, HexColor('#0078D4')),

        # Alignment
        ('ALIGN', (0, 0), (-1, 0), 'CENTER'),
        ('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),
    ])
    table.setStyle(style)
    return table

Header and Footer

def add_header_footer(canvas, doc, title, client_name, version):
    """Add branded header and footer to every page."""
    canvas.saveState()
    width, height = A4

    # Header: 4-color bar (2px)
    draw_4color_bar(canvas, 0, height - 15, width, height=2)

    # Header: title left, page number right
    canvas.setFont(FONT_NAME, 8)
    canvas.setFillColor(HexColor('#605E5C'))
    canvas.drawString(MARGIN_LEFT, height - 35, title)
    canvas.drawRightString(width - MARGIN_RIGHT, height - 35,
                          f"Page {doc.page}")

    # Footer: separator line
    canvas.setStrokeColor(HexColor('#D2D0CE'))
    canvas.line(MARGIN_LEFT, 35, width - MARGIN_RIGHT, 35)

    # Footer: text
    canvas.setFont(FONT_NAME, 7)
    canvas.setFillColor(HexColor('#605E5C'))
    canvas.drawString(MARGIN_LEFT, 22,
                     f"{client_name} | v{version} | Confidential")
    canvas.drawRightString(width - MARGIN_RIGHT, 22,
                          f"Page {doc.page}")

    canvas.restoreState()

Document Types

Callout Boxes

from reportlab.platypus import Paragraph, Spacer
from reportlab.lib.styles import ParagraphStyle

def create_callout(text, callout_type='info'):
    """Create a colored callout box."""
    colors_map = {
        'info': ('#E8F4FD', '#0078D4'),
        'warning': ('#FFF3E0', '#FFB900'),
        'success': ('#E8F5E9', '#107C10'),
        'critical': ('#FDEDED', '#E81123'),
    }
    bg, border = colors_map.get(callout_type, colors_map['info'])
    style = ParagraphStyle(
        'Callout',
        fontName=FONT_NAME,
        fontSize=9,
        leading=13,
        textColor=HexColor('#323130'),
        backColor=HexColor(bg),
        borderColor=HexColor(border),
        borderWidth=2,
        borderPadding=10,
        leftIndent=4,
        spaceBefore=8,
        spaceAfter=8,
    )
    return Paragraph(text, style)

KPI Cards

def create_kpi_card(canvas, x, y, value, label, color='#0078D4', width=120, height=70):
    """Draw a KPI card with large number and label."""
    # Background
    canvas.setFillColor(HexColor('#FFFFFF'))
    canvas.setStrokeColor(HexColor(color))
    canvas.setLineWidth(2)
    canvas.roundRect(x, y, width, height, 6, fill=1, stroke=1)

    # Value
    canvas.setFont(FONT_NAME, 28)
    canvas.setFillColor(HexColor(color))
    canvas.drawCentredString(x + width/2, y + height - 35, str(value))

    # Label
    canvas.setFont(FONT_NAME, 8)
    canvas.setFillColor(HexColor('#605E5C'))
    canvas.drawCentredString(x + width/2, y + 10, label)

Factual Integrity

• NEVER fabricate metrics, KPIs, ROI figures, market data, or statistics
• Only use data from: workspace context, user-provided materials, or credible official sources
• Every metric or market claim MUST include a source citation
• If no credible source exists, state as assumption or omit entirely
• Add a References section at the end of every document
• Use footnote-style citations: "...reduced costs by 40% [1]"

Versioning and Archiving

• Filename: {Title}_v{version}_{YYYY-MM-DD}.pdf
• Save to: output/pdf/
• Archive previous: output/pdf/archive/
• Cover page MUST show: title, version, date, author, client

Script Template

from reportlab.lib import colors
from reportlab.lib.pagesizes import A4
from reportlab.lib.colors import HexColor
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import mm, inch
from reportlab.platypus import (
    SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle,
    PageBreak, Image, KeepTogether
)
from reportlab.pdfbase import pdfmetrics
from datetime import date
import os

# === CONFIG ===
TITLE = "{{title}}"
SUBTITLE = "{{subtitle}}"
CLIENT = "{{client_name}}"
AUTHOR = "{{author_name}}"
VERSION = "{{version}}"
DATE = date.today().isoformat()

# === COLORS ===
BLUE = HexColor('#0078D4')
RED = HexColor('#F25022')
GREEN = HexColor('#7FBA00')
LIGHT_BLUE = HexColor('#00A4EF')
YELLOW = HexColor('#FFB900')
TEXT = HexColor('#323130')
TEXT_LIGHT = HexColor('#605E5C')
BG_ALT = HexColor('#F3F2F1')
BORDER = HexColor('#D2D0CE')

# === BUILD ===
filename = f"{TITLE.replace(' ', '_')}_v{VERSION}_{DATE}.pdf"
filepath = f"output/pdf/{filename}"
doc = SimpleDocTemplate(filepath, pagesize=A4,
    leftMargin=60, rightMargin=60, topMargin=60, bottomMargin=50)

story = []
# ... build content ...
doc.build(story, onFirstPage=on_cover_page, onLaterPages=on_content_page)
print(f"Created: {filepath}")

Quality Checklist

• Cover page editorial: fundo branco, logo colorido, titulo centralizado, KPI strip, foto autora circular com borda gradiente 4 cores, metadata
• All section headings use cyclic MS logo colors (Red→Green→Blue→Yellow)
• Tables have branded headers (color matches section, white text)
• Alternating row colors on all tables
• Header with doc title, version, page X/Y on every content page
• Footer with client name, confidential, date on every content page
• No orphan headings at bottom of page (heading-group wrappers applied)
• Code blocks (pre) allow page breaks inside (orphans: 4, widows: 4) — never leave blank pages
• No content orphaned at page bottom before a large block — professional editorial layout
• Callout boxes use appropriate colors (info/warning/success/critical)
• Fonts are consistent throughout (Segoe UI or Helvetica fallback)
• No fabricated data — all metrics have source citations
• References section present with all cited sources
• Filename follows {Title}_v{version}_{date}.pdf pattern
• Saved to output/pdf/ with previous version archived
• Pipeline: Markdown → HTML + CSS Paged Media → WeasyPrint (nunca reportlab direto)