Сфинкс документация и текст при наведении
Возможно ли с помощью sphinx иметь поля для наведения слов для слов, которые появляются внутри фрагментов кода, подобно тому, как выглядят и ведут себя поля для наведения в примерах кода на целевой странице angular.js?
2 ответа
(Для тех, кто приземлился здесь, когда искал всплывающие подсказки в обычном тексте RsT)
В :abbr:встроенная разметка создает всплывающие подсказки в HTML, например:
:abbr:`linkified text (tooltip text)`
Альтернативным полнофункциональным решением является sphinx-hoverxref расширение, которое модернизирует :ref:-подобная роль, которая извлекает содержимое всплывающей подсказки из указанного раздела, рисунка и т. д.:
К сожалению, я не думаю, что это будет поддерживаться "из коробки" (см.: https://bitbucket.org/birkenfeld/sphinx/issue/73/show-term-contents-in-a-tooltip).
Стоит также упомянуть, что целевая страница Angular - это не страница документации, а собственно веб-приложение, поэтому в настоящее время происходит множество хитростей кода и CSS-трюков.
Это возможно в качестве дополнительного шага сборки, не обращая внимания на любой ввод или расширение sphinx, поскольку фрагменты кода sphinx (как правило) очень легко распознать в выводе html, генерируемом sphinx. Таким образом, дополнительный шаг постобработки, следующий за шагом сфинкса, может легко найти их, а затем можно посыпать сверху какую-то логику, которая добавляет поля наведения по вашему предпочтению.