summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex')
-rw-r--r--Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex204
1 files changed, 0 insertions, 204 deletions
diff --git a/Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex b/Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex
deleted file mode 100644
index a5caf2c0bdf..00000000000
--- a/Master/texmf-dist/doc/context/sources/general/manuals/interaction/interaction-actions.tex
+++ /dev/null
@@ -1,204 +0,0 @@
-% language=uk
-
-\environment interaction-style
-
-\usemodule[references-identify]
-
-\startcomponent interaction-actions
-
-\startchapter[title=Actions]
-
-The reference mechanism not only deals with the more traditional cross
-references, but also takes care of navigation, launching applications (although
-that is often limited by viewers), running \JAVASCRIPT, etc. By integrating these
-features in one mechanism, we limit the number of commands needed for hyperlinks,
-menus and buttons. Normally such actions are driven by the \type {\goto} command,
-but you can also use buttons:
-
-\starttyping
-\goto[inner reference]
-\goto[outer reference::]
-\goto[outer reference::inner reference]
-\stoptyping
-
-The inner reference is normally a user defined one, for instance a reference to a
-named location like a chapter or figure. The outer reference refers to a file or
-\URL and is normally defined at the document level and is accessed by the \type
-{::}. By using symbolic names updating them becomes easier.
-
-There are also predefined references, like \type {nextpage} to go to the next
-page or \type {forward} to cycle, \type {nextcontents} for the next level table
-of contents in a linked list of such tables, etc. Some keywords are actually
-shortcuts to actions that are delegated to the viewer. Here you need to keep in
-mind that nowadays we're talking of \PDF\ viewers, but originally (\MKII) we also
-supported \DVI\ viewers. A special class of references are the viewer control
-ones, like \type {CloseDocument} or \type {PreviousJump}. They can be recognized
-by their capitals.
-
-When we speak of a reference, we actually refer to a whole bunch of possible
-references. We already mentioned inner and outer references, but special actions
-are also possible. These are actually plugins. Examples are the \JAVASCRIPT\ and
-\URL\ plugins. The interface evolved a bit over a few decades but most has been
-there right from the start, which is why we keep it as is. Actually, there is not
-that much new functionality added in \MKIV, although the implementation was
-mostly rewritten. Here is a overview of the syntax, just to give you an idea.
-
-\starttyping
-\goto[inner]
-\goto[inner(foo,bar)]
-\goto[inner{argument,argument}]
-\goto[inner{argument}]
-\goto[outer::]
-\goto[outer::inner]
-\goto[outer::special(operation{argument,argument})]
-\goto[outer::special(operation)]
-\goto[outer::special()]
-\goto[outer::inner{argument}]
-\goto[special(operation{argument})]
-\goto[special(operation{argument,argument})]
-\goto[special(operation)]
-\goto[special(outer::operation)]
-\goto[special(operation)]
-\goto[special(operation(whatever))]
-\goto[special(operation{argument,argument{whatever}})]
-\goto[special(operation{argument{whatever}})]
-\stoptyping
-
-There can be multiple actions, separated by a comma, think of: go to the page
-with label \quote {foo} and start video \quote {bar}.
-
-\showsetup{goto}
-
-Examples of operations are \type {page}, \type {program}, \type {action}, \type
-{url} and \type {JS}. \footnote {There are a few more operations but not all make
-sense at the user level.} The \type {page} operation accepts a pagenumber as
-well as relevant keywords. One can prefix a pagenumber by a file or \URL\ tag.
-The \type {program} operation starts up a program. It is an example of an old
-feature that has proven to be unstable, simply because viewers change behaviour
-over time.
-
-\showsetup{definereference}
-
-The built|-|in actions are interfaces via shortcuts with camelcase names. In most
-cases the name is a good indication of what to expect:
-
-\starttyping
-\definereference [CloseDocument] [action(close)]
-\definereference [ExitViewer] [action(exit)]
-\definereference [FirstPage] [action(first)]
-\definereference [LastPage] [action(last)]
-\definereference [NextJump] [action(forward)]
-\definereference [NextPage] [action(next)]
-\definereference [PauseMovie] [action(pausemovie)]
-\definereference [PauseSound] [action(pausesound)]
-\definereference [PauseRendering] [action(pauserendering)]
-\definereference [PreviousJump] [action(backward)]
-\definereference [PreviousPage] [action(previous)]
-\definereference [PrintDocument] [action(print)]
-\definereference [SaveForm] [action(exportform)]
-\definereference [LoadForm] [action(importform)]
-\definereference [ResetForm] [action(resetform)]
-\definereference [ResumeMovie] [action(resumemovie)]
-\definereference [ResumeSound] [action(resumesound)]
-\definereference [ResumeRendering] [action(resumerendering)]
-\definereference [SaveDocument] [action(save)]
-\definereference [SaveNamedDocument][action(savenamed)]
-\definereference [OpenNamedDocument][action(opennamed)]
-\definereference [SearchDocument] [action(search)]
-\definereference [SearchAgain] [action(searchagain)]
-\definereference [StartMovie] [action(startmovie)]
-\definereference [StartSound] [action(startsound)]
-\definereference [StartRendering] [action(startrendering)]
-\definereference [StopMovie] [action(stopmovie)]
-\definereference [StopSound] [action(stopsound)]
-\definereference [StopRendering] [action(stoprendering)]
-\definereference [SubmitForm] [action(submitform)]
-\definereference [ToggleViewer] [action(toggle)]
-\definereference [ViewerHelp] [action(help)]
-\definereference [HideField] [action(hide)]
-\definereference [ShowField] [action(show)]
-\definereference [GotoPage] [action(gotopage)]
-\definereference [Query] [action(query)]
-\definereference [QueryAgain] [action(queryagain)]
-\definereference [FitWidth] [action(fitwidth)]
-\definereference [FitHeight] [action(fitheight)]
-\definereference [ShowThumbs] [action(thumbnails)]
-\definereference [ShowBookmarks] [action(bookmarks)]
-\definereference [HideLayer] [action(hidelayer)]
-\definereference [VideLayer] [action(videlayer)]
-\definereference [ToggleLayer] [action(togglelayer)]
-\stoptyping
-
-In the \type {java-imp-*.mkiv} files you will find examples of similar shortcuts,
-for instance:
-
-\starttyping
-\definereference [SetupStepper] [JS(SetupStepper{step,50})]
-\definereference [ResetStepper] [JS(ResetStepper)]
-\definereference [CheckStepper] [JS(CheckStepper{\StepCounter})]
-\definereference [InvokeStepper] [JS(InvokeStepper)]
-\stoptyping
-
-Other examples of redefined references are:
-
-\starttyping
-\definereference [firstpage] [page(firstpage)]
-\definereference [previouspage] [page(previouspage)]
-\definereference [nextpage] [page(nextpage)]
-\definereference [lastpage] [page(lastpage)]
-\definereference [forward] [page(forward)]
-\definereference [backward] [page(backward)]
-\definereference [firstsubpage] [page(firstsubpage)]
-\definereference [previoussubpage] [page(previoussubpage)]
-\definereference [nextsubpage] [page(nextsubpage)]
-\definereference [lastsubpage] [page(lastsubpage)]
-\stoptyping
-
-Some of these actions expect arguments, for instance:
-
-\starttyping
-\goto{start}[StartMovie{mymovie}]
-\stoptyping
-
-You can load the module \type {references-identify} which gives you
-a command:
-
-\startbuffer
-\showreference[page(123),StartMovie{mymovie}]
-\stopbuffer
-
-\typebuffer \getbuffer
-
-\startbuffer
-\showreference[JS(Forget_Changes),CloseDocument]
-\stopbuffer
-
-\typebuffer \getbuffer
-
-\startbuffer
-\showreference[manual::contents]
-\stopbuffer
-
-\typebuffer \getbuffer
-
-You should be careful with colons in references. This gives you an idea how
-\CONTEXT\ interprets what you requested.
-
-\starttabulate[|T|p|]
-\NC prefix:whatever \NC The \type {prefix} creates a namespace. When references are
- resolved and there is no hit a lookup without prefix
- takes place. \NC \NR
-\NC document::whatever \NC The \type {document} is a symbolic reference to an external
- resource. This is explained elsewhere. \NC \NR
-\NC component:::whatever \NC The \type {component} is a symbolic reference to a component in
- a product. References defined in such a component are loaded on
- demand. \NC \NR
-\stoptabulate
-
-% url(http://a,b.c)
-% url(http://a,b.c)
-% url(http://a.b.c)
-
-\stopchapter
-
-\stopcomponent