в вашем файле CSS.

ы форматируете текст в обозначенной ссылке в reStructuredText?

В частности, я хочу сгенерировать следующий HTML из моего первого:

<a href="http://docs.python.org/library/optparse.html"><tt>optparse.OptionParser</tt> documentation documentation</a>

Результат должен выглядеть так:

optparse.OptionParser документация

где часть «optparse.OptionParser» написана шрифтом фиксированной ширины.

Я пытался

```optparse.OptionParser`` <http://docs.python.org/library/optparse.html>`_

однако это дало

<tt class="docutils literal">`optparse.OptionParser</tt> documentation &lt;<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>&gt;`_

который выглядит так

`` Optparse.OptionParserdocumentation <http://docs.python.org/library/optparse.html>\_

Ответы на вопрос(3)

Взяв с той же страницы FAQ, на которую ссылается mzjn:

The "raw" directive can be used to insert raw HTML into HTML output:

Here is some |stuff|.

.. |stuff| raw:: html

   <em>emphasized text containing a
   <a href="http://example.org">hyperlink</a> and
   <tt>inline literals</tt></em>

Теоретически должно быть возможно делать сложные вещи с тем, чего нельзя сделать с помощью RST.

 Jason S15 дек. 2016 г., 16:29
это работает, но это также ломает других авторов (LaTeX, PDF и т. д.)
Решение Вопроса

Эта конструкция:

Here you have |optparse.OptionParser|_.

.. |optparse.OptionParser| replace:: ``optparse.OptionParser`` documentation
.. _optparse.OptionParser: http://docs.python.org/library/optparse.html

создает этот HTML (добавлено несколько разрывов строк):

<p>Here you have 
  <a class="reference external" href="http://docs.python.org/library/optparse.html">
  <tt class="docutils literal"><span class="pre">optparse.OptionParser</span></tt> documentation</a>.
</p>

Я понимаю, что это неименно так то, что вы просили, но, может быть, это достаточно близко. Смотрите такжеhttp://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible.

 Mad Physicist19 нояб. 2015 г., 16:57
Это действительно красиво. Я искал все виды сверхпроектированных решений, включая написание пользовательских расширений, прежде чем я нашел это.
 Cecil Curry13 авг. 2016 г., 06:52
Этоне действительно красивый. Это ужасно Все вменяемые языки разметки поддерживают неограниченное вложение встроенной разметки, потому что это 2016 год. С 1959 года анализ без контекстной обработки тривиально решается. (Хомский:«О некоторых формальных свойствах грамматик».) Неспособность синтаксического анализатора reStructuredText выполнять подлинный анализ без контекста является грубым, безобразным пороком на остальном стерлинговом фасаде. Четко определенный и расширяемый синтаксис reST заслуживает лучшего. (Кто-то должен чувствовать себя плохо по этому поводу.)

Ты пробовалаintersphinx? Используя это расширение, следующая разметка:

:py:class:`optparse.OptionParser`

производит этот HTML:

<a class="reference external" href="http://docs.python.org/2.6/library/optparse.html#optparse.OptionParser" title="(in Python v2.6)"><tt class="xref py py-class docutils literal"><span class="pre">optparse.OptionParser</span></tt></a>

Протестировано с Python 2.6 и Sphinx 1.0.5.

 gotgenes20 янв. 2011 г., 19:53
Ах, ну, я не знал об интерфинксе. Спасибо, это приятно знать. Ссылка наoptparse на самом деле просто пример. Я действительно занимаюсь форматированием текста в ссылке на любой URI.

Ваш ответ на вопрос