在 PyPi 包页面上的重构文本中嵌入 HTML

发布于 2024-12-25 21:47:04 字数 433 浏览 1 评论 0原文

Sphinx 中,我知道你可以做到:

.. raw:: html

    <div style="margin-top:10px;">
      <iframe width="560" height="315" src="http://www.youtube.com/embed/_EjisXtMy_Y" frameborder="0" allowfullscreen></iframe>
    </div>

pypi,有什么方法可以做到吗?

YouTube 视频怎么样?

In Sphinx I know that you can do it:

.. raw:: html

    <div style="margin-top:10px;">
      <iframe width="560" height="315" src="http://www.youtube.com/embed/_EjisXtMy_Y" frameborder="0" allowfullscreen></iframe>
    </div>

In pypi, is there some way to do it?

How about a youtube video?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(3

等风来 2025-01-01 21:47:04

我不认为你可以在 pypi 上嵌入随机 html,我很高兴你不能。 Pypi 应该保留 Python 包索引,而不是 geocity 克隆。

如果您确实需要在包页面上放置 Youtube 视频,您可以使用标准重组文本放置带有 Youtube 视频链接的图像:

.. image:: http://example.com/image-with-the-first-frame.png
   :target: http://www.youtube.com/your-video

I don't think you can embbed random html on pypi and I'm glad you can't. Pypi should remain a Python Package Index, not a geocities clone.

If you really need to put a Youtube video on your package page you can put an image with a link to the Youtube video using standard restructured text:

.. image:: http://example.com/image-with-the-first-frame.png
   :target: http://www.youtube.com/your-video
无声情话 2025-01-01 21:47:04

PyPI 的重点是模块包索引,用于快速参考和访问 Python 模块和包。它并不是一个可定制的媒体网站。您可以向索引页面添加相当多的信息,以了解您放入其中的模块和包,但它仅用于索引站点。

如果您想要更详细的文档和更定制的感觉,请使用 http://packages.python.org您可以通过包编辑页面上传内容: http://pypi.python.org/pypi?%3Aaction=pkg_edit&name=YOURPACKAGE 其中 YOURPACKAGE 是您上传到 PyPI 的包的名称。

The point of PyPI is a module package index for quick reference and access to Python modules and packages. It isn't intended to be a customizable media site. You can add a fair amount of information to the index page for your modules and packages you put onto it, but it isn't intended for anything more than an index site.

If you want to have more detailed documentation with a more customized feel, use http://packages.python.org which you can lupload content to through the package edit page: http://pypi.python.org/pypi?%3Aaction=pkg_edit&name=YOURPACKAGE where YOURPACKAGE is the name of the packaged you uploaded to PyPI.

梦在深巷 2025-01-01 21:47:04

重组文本规范位于:

http://docutils.sourceforge.net/docs/ref /rst/restructedtext.html

我相信 pypi 使用一个名为 docutils 的包来渲染页面。

http://pypi.python.org/pypi/docutils/

原始 指令。

然而,可能存在多种问题导致 PyPi 上不需要任意 HTML:这将是潜在的 XSS 安全漏洞,允许您从其他用户捕获 PyPi 凭据。

您可以从 PyPi 源代码中确认这一点: http://wiki.python.org/moin/CheeseShopDev

Restructured text specification is here:

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html

I believe pypi uses a package called docutils to render the pages.

http://pypi.python.org/pypi/docutils/

raw directive should be supported, in theory, unless specifically disabled.

However, there might be many kind of issues why arbitary HTML is not wanted on PyPi: it would be potential XSS security hole allowing you to capture PyPi credentials from other users.

You can confirm this from PyPi source code: http://wiki.python.org/moin/CheeseShopDev

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文