사이트가 원박스 미리보기를 지원하는 조건은 무엇인가요?

제품 지원
1

다음 Python 프레임워크 개발자들이 우리 Discourse 인스턴스에서 onebox와 호환되도록 해달라고 요청하고 싶습니다:

https://docs.sunpy.org/en/v3.0.0/whatsnew/3.0.html

즉, 사이트가 onebox와 호환되려면 어떤 조건이 필요한가요? onebox를 검색해 이 GitHub 페이지(GitHub - discourse/onebox: (DEPRECATED) A gem for turning URLs into website previews · GitHub)를 찾았지만, 제가 언급한 프레임워크는 Sphinx를 사용하여 일부 페이지를 자동 생성하고 있습니다. 따라서 개발자들이 Sphinx 설정을 통해 페이지를 onebox와 호환되도록 만들 수 있는 설정이 있을까요?

2

만약 https://docs.sunpy.org/en/v3.0.0/whatsnew/3.0.html 링크를 단독 줄로 입력하면 다음 메시지가 표시됩니다:

죄송합니다. 다음 oEmbed / OpenGraph 태그를 찾을 수 없어 해당 웹 페이지의 미리보기를 생성할 수 없습니다: description, image

해당 페이지에는 빈 description OpenGraph 메타 태그가 포함되어 있어 임베드가 불가능합니다. 또한 image나 url 등 다른 OpenGraph 태그에는 상대 URL이 사용되고 있는데, 이것이 지원되는지 확실하지 않습니다.

3

그래서 저는 해당 정보를 SunPy 개발 팀에 전달했습니다. 그들은 이 페이지(https://sunpy--5366.org.readthedocs.build/en/5366/)에서 수정 사항을 테스트했으며, opengraph.xyz에서 모든 태그가 HTML 파일에 정의되어 있다고 확인해 주었습니다:

<!-- HTML Meta Tags -->
<title>SunPy Documentation</title>
<meta name="description" content="SunPy Documentation">

<!-- Facebook Meta Tags -->
<meta property="og:description" content="SunPy Documentation">
<meta property="og:image" content="https://raw.githubusercontent.com/sunpy/sunpy-logo/master/generated/sunpy_logo_word.png" />
<meta property="og:site_name" content="SunPy Documentation" />
<meta property="og:title" content="SunPy Documentation">
<meta property="og:type" content="website">
<meta property="og:url" content="https://docs.sunpy.org/en/stable//index.html" />

<!-- Twitter Meta Tags -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:description" content="SunPy Documentation">
<meta name="twitter:image" content="https://raw.githubusercontent.com/sunpy/sunpy-logo/master/generated/sunpy_logo_word.png">
<meta name="twitter:title" content="SunPy Documentation">
<meta property="twitter:domain" content="https://docs.sunpy.org/en/stable/">
<meta property="twitter:url" content="https://docs.sunpy.org/en/stable//index.html">

그럼에도 불구하고, 우리의 Discourse 인스턴스에서는 여전히 작동하지 않으며, 여전히 oEmbed / OpenGraph tags could not be found:description, image라는 오류가 발생합니다.

그들이 놓치고 있는 부분이 있을까요? 이 문제에 대한 우리의 GitHub 스레드입니다: onebox-compatible documentation for promoting SunPy's features and updates · Issue #5362 · sunpy/sunpy · GitHub

4

실제로 존재하는 항목인가요? 설명은 더 길어야 하며, 페이지의 실제 콘텐츠 일부를 포함해야 합니다. “SunPy Documentation” 같은 플레이스홀더는 안 됩니다.

5

설명이 제목과 동일하여 무시되고 있습니다. 설명 속성에 콘텐츠의 관련 부분을 발췌하여 입력해야 합니다.