{"id":5137,"date":"2023-02-21T08:57:22","date_gmt":"2023-02-21T08:57:22","guid":{"rendered":"https:\/\/info.documotor.com\/?page_id=5137"},"modified":"2023-05-02T13:03:59","modified_gmt":"2023-05-02T13:03:59","slug":"reference","status":"publish","type":"page","link":"https:\/\/info.documotor.com\/?page_id=5137","title":{"rendered":"Reference"},"content":{"rendered":"\n<p>Use Reference to make internal references or links in a presentation, useful if there is a need to refer to another slide and make it easily accessible by adding a link to this slide.<\/p>\n\n\n\n<h3>Syntax<\/h3>\n\n\n\n<p>Place the <code>Reference<\/code> binding surrounding the word or sentence that should have a link\/reference to another slide. <\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">&lt;&lt;Reference:ReferencePath&gt;...&lt;Reference&gt;&gt;<\/code><\/pre>\n\n\n\n<h3><br>Parameters<\/h3>\n\n\n\n<p><strong>ReferencePath<\/strong>: Key defined in the data. The value in the JSON is used to make a connection to the slide. The value of the key needs to be a string, integer, or float value. The value <strong>must<\/strong> be unique from other <code>ReferencePath<\/code>s and will only be used as a connection ID. This also means that this value will not be visible in the presentation. The <code>ReferencePath<\/code> in the notes will be removed on generated documents.  <\/p>\n\n\n\n<p>On the slide that the link should jump to, place the <code>ReferencePath<\/code> in the &#8220;notes&#8221; section on the slide as seen below. If more references are needed, the paths should be separated with a line break. <\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">#-- DocuMotor-References --#\nReferencePath\n#-- DocuMotor-References-End --#<\/code><\/pre>\n\n\n\n<h3><br>Notes<\/h3>\n\n\n\n<p>The general logic for creating reference links to specific slides is to create a link that points to a slide with a specific ID. That means that the link should know which slide ID it is pointing to. To apply the ID to the targeted slide the <code>ReferencePath<\/code> in the notes is relevant since this is where the value from the <code>ReferencePath<\/code> is defined as the slide&#8217;s unique ID. The <code>ReferencePath<\/code> defined in the Reference binding should be the JSON path to a value that is identical to the value of the <code>ReferencePath<\/code> defined in the notes of the targeted slide. <\/p>\n\n\n\n<h4>Example<\/h4>\n\n\n\n<p>Below is an example of how a list of references link to specific slides, where both list and slides are dynamically generated with the <a href=\"https:\/\/info.documotor.com\/?page_id=5249\" data-type=\"page\" data-id=\"5249\">List<\/a> and <a href=\"https:\/\/info.documotor.com\/?page_id=648\" data-type=\"page\" data-id=\"648\">Repeat<\/a> bindings. <\/p>\n\n\n\n<p><strong>Template<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/info.documotor.com\/wp-content\/uploads\/2023\/05\/2023-05-02_14-20-33.mp4\"><\/video><\/figure>\n\n\n\n<p><strong>Output data<\/strong><\/p>\n\n\n\n<pre title=\"Output\" class=\"wp-block-code\"><code lang=\"json\" class=\"language-json line-numbers\">{\n    \"repeatedSlides\": [\n        {\n            \"title\": \"Title 1\",\n            \"slideId\": 1\n        },\n        {\n            \"title\": \"Title 2\",\n            \"slideId\": 2\n        },\n        {\n            \"title\": \"Title 3\",\n            \"slideId\": 3\n        }\n    ]\n}<\/code><\/pre>\n\n\n\n<p><strong>Generated presentation<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/info.documotor.com\/wp-content\/uploads\/2023\/05\/2023-05-02_14-08-30.mp4\"><\/video><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Use Reference to make internal references or links in a presentation, useful if there is a need to refer to another slide and make it easily accessible by adding a link to this slide. Syntax Place the Reference binding surrounding the word or sentence that should have a link\/reference to another slide. Parameters ReferencePath: Key [&hellip;]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":4603,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5137"}],"collection":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=5137"}],"version-history":[{"count":13,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5137\/revisions"}],"predecessor-version":[{"id":5523,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5137\/revisions\/5523"}],"up":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/4603"}],"wp:attachment":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}