Можно добавить эти виды ссылок на отчет:
Внешний — Ссылка на местоположение за пределами отчета, такого как страница HTML или файл PDF. Используйте объект mlreportgen.dom.ExternalLink
.
Внутренний — Ссылка на местоположения в отчете. Используйте объект mlreportgen.dom.InternalLink
.
Чтобы задать цель ссылки для объекта InternalLink
, используйте значение в свойстве Name
объекта mlreportgen.dom.LinkTarget
. Когда вы создаете объект ExternalLink
, можно использовать объект LinkTarget
значение Name
или URL.
Этот пример создает цель ссылки под названием home
и использует home
в качестве цели для внутренней ссылки.
import mlreportgen.dom.* d = Document('mydoc'); append(d,LinkTarget('home')); append(d,InternalLink('home','Go to Top')); close(d); rptview(d.OutputPath);
Используйте объект mlreportgen.dom.ExternalLink
создать внешнюю ссылку, задавая цель ссылки и текст ссылки.
import mlreportgen.dom.* d = Document('mydoc'); append(d,ExternalLink('https://www.mathworks.com/','MathWorks')); close(d); rptview('mydoc','html');
Чтобы настроить ссылки на местоположение в отчете, добавьте объект mlreportgen.dom.InternalLink
к элементу документа или документа. Используйте объект mlreportgen.dom.LinkTarget
с элементом документа, чтобы соединиться с. Например, можно включать ссылку About the Author
на раздел, который имеет направляющийся Author's Biography
.
import mlreportgen.dom.* d = Document('mydoc'); append(d,InternalLink('bio','About the Author')); h = Heading(1,LinkTarget('bio')); append(h,'Author''s Biography'); append(d,h); close(d); rptview('mydoc','html');
Чтобы добавить текст или изображение к объекту ExternalLink
или InternalLink
, используйте метод append
с тем объектом. Добавьте Text
, Image
или объект CustomElement
.
Можно создать числовую ссылку на страницу, где цель ссылки находится. Например, можно создать постраничный справочник в форме “Страница 15 See”, где цель, на которую вы ссылаетесь, находится на объекте на странице 15. Например:
import mlreportgen.dom.*; d = Document('mydoc','pdf'); open(d); % Add target to heading object and append heading and % para text to document h = Heading1(LinkTarget('mytarget')); append(h,'Referenced Head'); p = Paragraph('Here is some paragraph text.'); append(d,h); append(d,p); % Add another page and insert the page reference % to the target p1 = Paragraph('The following paragraph contains the page reference.'); p1.Style = {PageBreakBefore(true)}; p2 = Paragraph('See Page '); p2.WhiteSpace = 'preserve'; ref = PageRef('mytarget'); append(p2,ref); append(p2,'.'); append(d,p1); append(d,p2); close(d); rptview(d.OutputPath);
В вашем шаблоне PDF можно использовать элемент <pageref>
, чтобы создать этот вид ссылки. Ваша программа API DOM должна установить цель ссылки, которую использует элемент. <pageref>
использует один аргумент: <pageref target="nameoftarget>
.
Для получения дополнительной информации об этом механизме смотрите mlreportgen.dom.PageRef
.
mlreportgen.dom.ExternalLink
| mlreportgen.dom.ExternalLink.append
| mlreportgen.dom.InternalLink
| mlreportgen.dom.LinkTarget
| mlreportgen.dom.PageRef