결과를 HTML로 내보낸 뒤 실제 파일을 확인해 공유합니다. GitHub 노트북 화면에서는 사용자 JavaScript가 동작하지 않을 수 있지만, Plotly HTML 내보내기는 hover, zoom, 범례와 인라인 스크립트를 유지할 수 있습니다. 대신 파일이 커지고, 화면에 보이는 차트보다 많은 데이터가 들어갈 위험이 있습니다.

인터랙티브 링크를 약속하기 전에 크기를 확인합니다

익명 업로드는 1MiB(1,048,576 byte), Pro는 **10MiB(10,485,760 byte)**까지 허용합니다. 한도가 커져도 원격 스크립트나 Python 백엔드가 열리는 것은 아닙니다. 실제 연결의 한도는 get_publish_limits로 확인하세요. 화면에 표시된 Pro 가격이 결제가 가능하다는 증거는 아닙니다.

정적 보고서 예시 내려받기. UTF-8 기준 1468 byte이며, 합성 수치 A=12, B=18, C=9를 표와 인라인 SVG로 담았습니다. hover와 zoom은 없고 Plotly 내보내기 결과도 아닙니다. 고객 사례나 실제 게시 결과를 주장하지 않습니다.

직접 만든 Plotly 그림은 자체 포함 파일로 생성한 뒤 업로드 전에 UTF-8 원본 크기를 측정합니다. 다음은 각자의 Plotly 환경에서 실행할 절차이며, 여기서 측정한 결과가 아닙니다.

from pathlib import Path
import plotly.graph_objects as go

fig = go.Figure(go.Bar(x=["A", "B", "C"], y=[12, 18, 9]))
source = fig.to_html(full_html=True, include_plotlyjs=True)
size = len(source.encode("utf-8"))
print({"bytes": size, "within_anonymous_limit": size <= 1_048_576,
       "within_pro_limit": size <= 10_485_760})
Path("report.html").write_text(source, encoding="utf-8")

include_plotlyjs="cdn"은 원본 파일을 줄이지만 외부 스크립트를 요구하므로 HTML 뷰어가 차단합니다. 자체 포함 파일이 한도를 넘으면 정적 보고서나 다른 호스팅을 쓰고, 한도에 맞더라도 실제 공유된 차트의 hover, zoom, 라벨을 직접 확인합니다.

내보내기 방식을 고릅니다

방식 상호작용 주요 제약
PNG 또는 SVG 없음 작고 예측 가능하지만 hover나 필터가 없음
GitHub 노트북 제한적 GitHub은 노트북을 렌더링하지만 사용자 JavaScript는 동작하지 않을 수 있음
CDN을 쓰는 Plotly HTML 라이브러리가 로드되면 가능 외부 네트워크 요청에 의존
자체 포함 Plotly HTML 가능 Plotly 안내에 따르면 파일이 5MB를 넘을 수 있음

HTML2WEB 익명 흐름은 파일 하나, 최대 1MiB를 받고 Pro는 10MiB까지 허용합니다. 뷰어가 외부 네트워크 연결을 막으므로 CDN 의존 차트는 안정적인 선택이 아닙니다. 자체 포함 Plotly 파일은 데이터를 더하기 전에도 한도를 넘을 수 있습니다.

공유 파일을 준비합니다

  1. 필요하지 않은 노트북 출력을 다시 실행하거나 지웁니다.
  2. 접근 토큰, 로컬 경로, 사용자명, 내부 URL, 원본 질의 결과, 숨은 hover 필드를 제거합니다.
  3. 민감한 행은 집계하거나 공개 가능한 fixture 데이터로 바꿉니다.
  4. 최종 그림이나 필요한 보고서 부분만 내보냅니다.
  5. 외부 요청이 없는 인라인 코드와 스타일을 우선합니다.
  6. 파일 크기를 byte 기준으로 확인합니다.
  7. HTML을 오프라인에서 열어 상호작용을 시험합니다.
  8. 짧은 만료로 게시하고 공개 링크를 시크릿 창에서 확인합니다.

보이는 표를 지웠다고 그 데이터가 사라진 것은 아닙니다. Plotly trace, 노트북 출력, script 변수, HTML 원문에는 누군가 페이지를 들여다볼 때까지 드러나지 않는 값이 남을 수 있습니다.

한도를 넘을 때

다음 중 정직한 대안을 고릅니다.

  • 정적 SVG나 PNG를 짧은 해설과 함께 게시합니다.
  • 점 개수, 정밀도, 반복 라벨, 쓰지 않는 trace를 줄입니다.
  • 여러 차트를 담은 보고서를 목적별 페이지로 나눕니다.
  • 큰 산출물과 런타임 의존성에 맞는 환경에 애플리케이션을 올립니다.

출처를 지우거나 접근성 문구를 없애면서 크기만 맞추지 않습니다. 라이브 데이터, 인증, callback, Python 실행, 큰 라이브러리가 필요하면 단일 파일 미리보기가 아니라 애플리케이션입니다.

수신자 경험을 검증합니다

공개 URL에서 키보드 접근, 보이는 라벨, hover와 zoom, 범례, 모바일 폭, 만료, 네트워크 오류 여부를 확인합니다. 상호작용을 쓸 수 없을 때도 핵심 결과를 알 수 있도록 차트 앞에 평문 요약을 둡니다.

정리한 파일은 HTML-to-URL 도구로 게시합니다. 에이전트가 만든 보고서라면 업로드 전에 HTML 비밀정보 점검도 실행하세요.