Справочная страница в печатной документации asciidoc

Я хочу создать ссылку в asciidoc PDF для печатной книги. Правильный способ сделать это примерно так:

[[LinkUniqueCode]]
Here is the stuff I'm linking to...
Lots of document here...

Now look <<LinkUniqueCode,at the link>>.

Обычно я ожидаю, что это будет выглядеть примерно так в PDF:

Now look at the link (Page 13).

Но вместо этого я получаю ссылку, которая бесполезна в печатном PDF...

Я много искал это, но ключевые слова, которые я нашел, слишком общие, и я нашел только это.

Я пытался добавить :xrefstyle: full, но это тоже не помогло.

Я видел это как через бэкэнд fopub, так и через бэкэнд PDF. Я предполагаю, что должен быть «режим печати» для создания PDF, но я не вижу, что я здесь делаю неправильно.


person Shai Almog    schedule 28.11.2017    source источник


Ответы (2)


Хорошо, это я был глуп. Я забыл включить:

:doctype: book

Что сделало все хорошо.

person Shai Almog    schedule 28.11.2017

посмотрите: https://stackoverflow.com/questions/47312831/asciidoctor-page-number-usable

Я взял ваш пример, и это не было сделано хорошо.

Какие другие настройки, такие как xrefstyle, вы использовали?

РЕДАКТИРОВАТЬ: посмотрите здесь:

asciidoctor-pdf -v
Asciidoctor PDF 1.5.0.alpha.16 using Asciidoctor **1.5.4** [http://asciidoctor.org]
Runtime Environment (ruby 2.3.3p222 (2016-11-21) [x86_64-linux-gnu]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

Я думаю, это объясняет:

В среду, 9 августа 2017 г., в 23:23 Джереми Брессон [через Asciidoctor :: Обсуждение] ‹[скрытый адрес электронной почты]> написал:

Функция "xrefstyle" действительно великолепна (новинка в Asciidoctor 1.5.6.1, см. http://asciidoctor.org/docs/user-manual/#customizing-the-cross-reference-text )

person Hendrik Timmermann    schedule 29.11.2017
comment
Я не понимаю этот ответ? Как бы я ссылался на страницу. Я смог сослаться только на раздел, который был не очень хорош, но я могу с этим смириться. - person Shai Almog; 30.11.2017
comment
привет, привет, у меня такая же проблема. И я тоже не смог решить. Работать с xrefstyle работает только с asciidoctor 1.5.6.1 И не решит проблему получения номера страницы, но хотя бы некоторых подписей и текстов. - person Hendrik Timmermann; 30.11.2017