Skip to main content

이 페이지를 다른 언어로도 볼 수 있어요

GenToonGenToon

웹툰 퍼가기 안내

젠툰 웹툰을 블로그나 홈페이지에 넣으면, 읽는 사람이 젠툰에 들어오지 않아도 그 자리에서 컷을 끝까지 넘겨 볼 수 있어요.

이렇게 보여요

실제 퍼가기 플레이어예요. 옆으로 넘겨 보세요.

퍼가는 방법

  1. 게시글에서 «퍼가기»를 눌러요

    퍼가고 싶은 웹툰 게시글 아래, 공유 버튼 바로 옆에 있어요.

  2. 크기를 골라요

    작게·기본·크게 중에서 고르고, 본문 폭이 좁은 곳에 넣을 거라면 «반응형 코드»를 켜요. 고른 모습은 미리보기에서 바로 보여요.

    «보기 방식»에서 «넘겨 보기»(기본)와 «세로로 쭉 내려 보기» 중에 고를 수 있어요. 세로로 쭉 내려 보기는 첫 컷부터 보여요.

  3. «코드 복사»를 눌러 붙여 넣어요

    블로그나 홈페이지의 HTML 편집 화면에 붙여 넣으면 끝이에요.

앱에서는 게시글의 공유 버튼을 누르고 «퍼가기»를 고르면 코드가 복사돼요.

어디에 붙이면 되나요

설치형 워드프레스
게시글 링크만 붙여 넣으면 플레이어가 자동으로 펼쳐져요. 퍼가기 창의 «링크 복사»를 쓰면 돼요.
HTML 을 넣을 수 있는 블로그·홈페이지
«코드 복사»로 복사한 코드를 HTML 편집 화면에 붙여 넣어요.
주소만 넣는 칸이 있는 곳
주소만 받는 칸에는 플레이어 주소를 넣어요. 주소는 아래 모양이고, 끝의 번호는 게시글 주소 맨 끝 부분과 같아요.
https://www.gentoon.ai/embed/post/<게시글번호>
퍼가기 창의 «퍼가기 주소 복사»를 누르면 이 주소가 바로 복사돼요.

그 밖의 곳은 외부 HTML 이나 iframe 을 허용하는지에 따라 달라요. 막혀 있다면 «링크 복사»로 링크를 나눠 주세요.

알아 두세요

  • 플레이어는 쿠키를 쓰지 않고 로그인도 묻지 않아요.
  • 작가가 게시글을 지우거나 비공개로 바꾸면 퍼간 곳에서도 더는 보이지 않아요.
  • 플레이어의 버튼 글자는 읽는 사람의 언어에 맞춰 바뀌어요.
  • 작가는 퍼가기 창의 «퍼가기 성과»에서 다른 곳에서 읽힌 횟수를 볼 수 있어요.

개발자용

oEmbed 를 지원하는 서비스라면 게시글 링크만으로 플레이어를 넣을 수 있어요.

oEmbed 엔드포인트

url 에 게시글 주소를 넣어요. 형식은 json 과 xml 이고, maxwidth·maxheight 를 주면 비율을 지키며 줄여요. 게시글 페이지에는 oEmbed 발견용 link 태그가 들어 있어요.

https://www.gentoon.ai/api/oembed

GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=json
GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=xml

응답 코드: 200 정상 · 404 없는 글이거나 젠툰 게시글 주소가 아니에요 · 401 글은 있지만 퍼갈 수 없어요(비공개·앱 전용 글 등) · 501 json·xml 이 아닌 형식이에요.

<iframe src="https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315" width="400" height="644" title="웹툰 퍼가기 안내 · GenToon" frameborder="0" scrolling="no" loading="lazy" allow="clipboard-write; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen style="border:0;max-width:100%"></iframe>

플레이어 주소와 파라미터

https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315?hl=en&theme=dark&start=2&layout=scroll
hl
화면 언어를 고정해요(예: en, ja). 없으면 읽는 사람의 브라우저 언어를 따라요.
theme
dark 를 넣으면 어두운 화면으로 보여요.
start
N번째 컷부터 보여 줘요(1부터 셈).
layout
scroll 을 넣으면 컷을 세로로 이어서 읽어요. 없으면 한 컷씩 넘겨요. oEmbed 코드는 언제나 한 컷씩이에요.

전체 화면 버튼은 iframe 에 allowfullscreen 이 있을 때만 보여요(퍼가기 코드에는 들어 있어요). 워드프레스는 이 속성을 지우고 아이폰 사파리는 전체 화면을 지원하지 않아서 그곳에선 버튼이 없어요. 자막(CC) 버튼은 읽는 사람의 언어가 대사 언어와 다를 때만 보이고, 누르면 번역을 한 번 불러와요.

높이 알림(postMessage)

플레이어는 높이가 바뀌면 부모 창에 알려요. 아래 형식을 받아 iframe 높이를 맞추면 돼요.

기본 형식

{"type":"gentoon:embed:resize","postId":"9fa0016a-1192-4a72-afa8-d0ffad90c315","height":644}

Embedly·Iframely 형식

JSON.stringify({"src":"https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315","context":"iframe.resize","height":644,"domains":"all"})

워드프레스 형식(주소에 #?secret= 이 붙었을 때)

{"message":"height","value":644,"secret":"<secret>"}

플레이어 응답에는 쿠키가 없고, 검색엔진이 색인하지 않도록 noindex 로 표시돼 있어요.

문의

퍼가기가 잘 안 되거나 제휴를 원하시면 service@gentoon.ai 로 메일 주세요.

도움말로 돌아가기