Встраивание HTML в реструктурированный текст на страницах пакета PyPi

В 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?

Ответ 1

Я не думаю, что вы можете использовать случайный html на pypi, и я рад, что вы не можете. Pypi должен оставаться индексом пакета Python, а не клоном geocities.

Если вам действительно нужно разместить видео Youtube на странице своего пакета, вы можете поместить изображение со ссылкой на видео Youtube с помощью стандартного реструктурированного текста:

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

Ответ 2

Точка PyPI - это индекс пакета модулей для быстрой справки и доступа к модулям и пакетам Python. Он не предназначен для настраиваемого медиа-сайта. Вы можете добавить на индексную страницу достаточное количество информации для своих модулей и пакетов, которые вы на нее накладываете, но она не предназначена для чего-либо большего, чем сайт индекса.

Если вы хотите иметь более подробную документацию с более индивидуальным чувством, используйте http://packages.python.org, который вы можете загрузить через контент через редактирование пакета page: http://pypi.python.org/pypi?%3Aaction=pkg_edit&name=YOURPACKAGE где YOURPACKAGE - это имя упакованного вами файла, загруженного в PyPI.

Ответ 3

Спецификация реструктурированного текста находится здесь:

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

Я считаю, что pypi использует пакет docutils для отображения страниц.

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

Директива

raw должна поддерживаться теоретически, если она специально не отключена.

Однако может возникнуть множество проблем, почему в PyPi не нужен произвольный HTML-код: это потенциальное отверстие безопасности XSS, позволяющее вам захватывать учетные данные PyPi от других пользователей.

Вы можете подтвердить это из исходного кода PyPi: http://wiki.python.org/moin/CheeseShopDev