gardener, Interface administrators, Administrators
3,893
edits
Changes
Jump to navigation
Jump to search
m
* use {{cmd|setupinteraction}}* [[Presentation effects]] and [[Presentations]]* see in [[Using Graphics| using graphics]] how to use movies.* [[Widgets]] (interactive elements, form fields etc.) and [[Interaction and button]]* [[PDF Bookmarks and Headers]]__TOC__
== Hints ===== Link coloring ===
=== Clickable table of contents ===
=== Default focus mode ===
no edit summary
The {{cmd|setupinteraction}} command configures all interaction in the resulting PDF document. Basic interaction (meaning clickable links for references) is enabled using
</texcode>
This makes all links generated with the {{cmd|goto}} command (and indirectly the {{cmd|in}} and {{cmd|at}} commands) clickable. A page is dedicated to this system of '''[[References]]'''.
By default, the link text gets a green or red [[Color|color]], depending on whether the link is to another page or to the same page. You can change the link colors with the <tt>color</tt> (links to other pages) and <tt>contrastcolor</tt> (links to the same page) properties. For example, to disable link coloring alltogether:
</texcode>
To make table of contents items clickable, use the {{cmd|setupcombinedlist}} command.
Alternatively, you can use the <tt>textcolor</tt> property to change just the text colour, and leave the section and page numbers colored.
By default, clicking an inter-document hyperlink will switch to "fit page" mode, to override this:
</texcode>
= PDF Bookmarks = == Quick start == For the impatient (like me), here is a complete example showing typical and useful commands, which are explained below: <texcode>\setupinteraction[state=start] % don't forget this line!% make chapter, section bookmarks visible when opening document\placebookmarks[chapter,section,subsection][chapter,section]\setupinteractionscreen[option=bookmark]\starttext\startchapter[title=The beginning]Hi!\stopchapter\startchapter[title={A very, very\\long title}]Greetings!\startsection[title=Why so long]I don't know\startsubsection[title=Why not?]Good point.\stopsubsection\stopsection\stopchapter\startchapter[title=The never-ending story]Oh no.\stopchapter\startchapter[title=The never-ending story, bookmark=Forever!]Oh no.\stopchapter\stoptext</texcode> == Explanation == You need to activate the interaction handling in order to see the bookmarks using {{cmd|setupinteraction|[state=start]}}. <texcode>\setupinteraction [state=start]</texcode> The bookmarks window is usually not visible by default. To have the bookmark window open automatically when the document is opened: <texcode>\setupinteractionscreen [option=bookmark] </texcode> ''Disclaimer:'' {{cmd|setupinteraction}} works with Adobe Reader/Acrobat, but other PDF viewers behave differently. E.g. xpdf v3.01 always opens the bookmark window. To get bookmarks for chapters, sections, and subsections, use: <texcode>\placebookmarks[chapter,section,subsection]</texcode> In the bookmark window, only chapter bookmarks are visible by default.If chapter and section bookmarks should be visible: <texcode>\placebookmarks [chapter,section,subsection] [Categorychapter]</texcode> This will open the document with the bookmarks for chapters and sections visible (read as: and open up the chapter bookmarks) The [[Titles|unnumbered headings]] ({{cmd|title}}, {{cmd|subject}} etc.) do '''not''' create bookmarks, even when listed in {{cmd|placebookmarks}}. In order to create the bookmarks, you need to add <code>force=yes</code>, for example like this: <texcode>\placebookmarks [title, subject] [force=yes]</texcode> If you do not like seeing the structure numbering in the bookmarks, you can add <code>number=no</code>, like this: <texcode>\placebookmarks [chapter,section] [chapter] [number=no]</texcode> == Unwanted output == With a long heading in a huge font, you might want to add linebreaks by hand. No problem, just use <tt>\\</tt>. The bookmark code ignores <tt>\\</tt>, so the bookmark itself won't have a linebreak.For example: <texcode>\setupinteraction[state=start]\placebookmarks[chapter]\setupinteractionscreen[option=bookmark]\starttext\startchapter[title=Long\\ title]hello\stopchapter\stoptext</texcode> ConTeXt attempts to replace commands inside bookmarks with an acceptable string. However, the result is not always optimal. To tweak ConTeXts behaviour, add specific commands to {{cmd|simplifiedcommands}}. For example, to replace the <code>\CONTEXT</code> logo (which would normally become ''CONTEXT'') with a camel-cased version, use the following: <texcode> \appendtoks \def\CONTEXT{ConTeXt} \to \simplifiedcommands</texcode> A more general method, also usable for the above problem, is to use the <code>bookmark</code> option to specify the bookmark text explicitly. For example: <texcode>\setupinteraction[state=start]\placebookmarks[chapter]\setupinteractionscreen[option=bookmark]\starttext\startchapter[title=A very long chapter\\ about splines, bookmark=Splines]hello\stopchapter\stoptext</texcode> {{mkii|In mkii, such manual bookmarks used the {{cmd|bookmark}} command on a separate line following a {{cmd|chapter}} command. With the new {{cmd|startchapter}} command, this is no longer needed, nor recommended.}} == Private bookmarks == We can also place our own list of bookmarks:Presentation <texcode>\setupinteraction [state=start]\setupinteractionscreen [option=bookmark]\definelist [mylist]\placebookmarks [chapter,mylist] [chapter,mylist]\starttext \startchapter[title={My title}] \input knuth\page \bookmark[Categorymylist]{Before input zapf}\input zapf \stopchapter\stoptext</texcode> = PDF Headers = In order to add '''Author''', '''Title''', '''Keywords''', ... to PDF headers, use:Command <texcode>\setupinteraction [state=start, title={...}, author={...}, subtitle={...}, keyword={...}]</texcode> == Prevent certain characters from appearing in pdf headers == To ignore certain TeX commands in {{cmd|setupinteraction}} add them to {{cmd|simplifiedcommands}}. For example, to ignore {{cmd|quad}} in <code>pdfauthor</code>, use the following <texcode> \appendtoks \let\quad\space \to \simplifiedcommands \setupinteraction [author={Author1\quad Author2}]</texcode> {{mkii|Accented characters like ''ä'', ''č'', ... will turn into their unaccented counterparts ''a'', ''c'', ... by default. If you want to prevent that, use <texcode>\input spec-tst</texcode> For example <texcode>\enableregime[utf] \setupinteraction [state=start]\setupinteractionscreen [option=bookmark] % before \placebookmarks\input spec-tst.tex \placebookmarks [chapter,section,subsection] [chapter] ... and here is your document with accented characters in titles & bookmarks ... </texcode>}} = Further reading = * [[URL]]: typesetting of URLs references.* [[Presentations]], [[Presentation Styles]], [[SlideWithSteps]], [[Presentation effects]]* [[Widgets]] (interactive elements, form fields etc.) and [[Interactionand button]]* See in [[Using Graphics|using graphics]] how to use movies. [[Category:Interaction]]
