Создание постоянных ссылок на заголовок с помощью библиотеки разметки python - PullRequest
6 голосов
/ 12 апреля 2011

Мне было интересно, как с помощью библиотеки разметки python генерировать постоянные ссылки из следующей разметки:

A header
========

A paragraph

Желаемый вывод будет выглядеть примерно так:

<span id="a-header"></span>
<h1>
  A header
  <a class="headerlink" title="Permalink to this headline" href="#a-header">¶</a>
</h1>
<p>A paragraph</p>

Ответ:

Спасибо @BlaXpirit ( см. Ответ )

Используйте headerid расширение разметки Python и введите следующее:

# A header [¶](#a-header) {#a-header}

A paragraph

Это генерирует следующий вывод:

<h1 id="a-header">
  A header
  <a href="#a-header">¶</a>
</h1>

Затем используйте стили CSS, чтобы получить общий вывод, например:

h1 a{visibility:hidden;}
h1:hover a{visibility:visible;}

Ответы [ 2 ]

1 голос
/ 12 апреля 2011

Уценка в Python имеет расширение , которое делает это.
Он также позволяет вам указать id , который вам нравится для заголовка, например:

A header            {#a-header}
========
0 голосов
/ 13 апреля 2011

Pandoc ассоциирует уникальный идентификатор с каждым заголовком на основе воображаемого вами правила: id - это заголовок нижнего регистра, пробелы заменяются дефисами. Это используется для генерации необязательных оглавлений для HTML, LaTeX и других форматов вывода. В HTML он автоматически создает идентификаторы, связанные с ссылками, и, в частности, может использоваться для внутренних перекрестных ссылок; синтаксис уценки:

 See the section on [header identifiers](#header-identifiers-in-html).

как мы читаем в руководстве пользователя на http://johnmacfarlane.net/pandoc/README.html#header-identifiers-in-html

...