Документация

Создайте цель ссылки

Чтобы задать цель ссылки для объекта 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.