Встраивание 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