357 lines
12 KiB
EmacsLisp
357 lines
12 KiB
EmacsLisp
;;; hyperref.el --- AUCTeX style for `hyperref.sty' v6.83m -*- lexical-binding: t; -*-
|
|
|
|
;; Copyright (C) 2008, 2013-2022 Free Software Foundation, Inc.
|
|
|
|
;; Author: Ralf Angeli <angeli@caeruleus.net>
|
|
;; Maintainer: auctex-devel@gnu.org
|
|
;; Created: 2008-06-21
|
|
;; Keywords: tex
|
|
|
|
;; This file is part of AUCTeX.
|
|
|
|
;; AUCTeX is free software; you can redistribute it and/or modify it
|
|
;; under the terms of the GNU General Public License as published by
|
|
;; the Free Software Foundation; either version 3, or (at your option)
|
|
;; any later version.
|
|
|
|
;; AUCTeX is distributed in the hope that it will be useful, but
|
|
;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
;; General Public License for more details.
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
|
;; along with AUCTeX; see the file COPYING. If not, write to the Free
|
|
;; Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
|
|
;; 02110-1301, USA.
|
|
|
|
;;; Commentary:
|
|
|
|
;; This file adds support for the hyperref package.
|
|
|
|
;;; Code:
|
|
|
|
(require 'tex)
|
|
(require 'latex)
|
|
|
|
;; Silence the compiler:
|
|
(declare-function font-latex-add-keywords
|
|
"font-latex"
|
|
(keywords class))
|
|
|
|
(declare-function font-latex-set-syntactic-keywords
|
|
"font-latex")
|
|
|
|
(defvar LaTeX-hyperref-package-options-list
|
|
'(;; See https://mirrors.ctan.org/macros/latex/contrib/hyperref/doc/hyperref-doc.html#x1-110005
|
|
;; General options
|
|
("draft" ("true" "false"))
|
|
("final" ("true" "false"))
|
|
("debug" ("true" "false"))
|
|
("verbose" ("true" "false"))
|
|
("implicit" ("true" "false"))
|
|
("setpagesize" ("true" "false"))
|
|
;; Options for destination names
|
|
("destlabel" ("true" "false"))
|
|
("hypertexnames" ("true" "false"))
|
|
("naturalnames" ("true" "false"))
|
|
("plainpages" ("true" "false"))
|
|
;; Configuration options
|
|
("raiselinks" ("true" "false"))
|
|
("breaklinks" ("true" "false"))
|
|
("pageanchor" ("true" "false"))
|
|
("nesting" ("true" "false"))
|
|
;; Backend drivers
|
|
("driverfallback")
|
|
("dvipdfm")
|
|
("dvipdfmx")
|
|
("dvips")
|
|
("dvipsone")
|
|
("dviwindo")
|
|
("hypertex")
|
|
("latex2html")
|
|
("nativepdf")
|
|
("pdfmark")
|
|
("pdftex")
|
|
("ps2pdf")
|
|
("tex4ht")
|
|
("textures")
|
|
("vtex")
|
|
("vtexpdfmark")
|
|
("xetex")
|
|
;; Extension options
|
|
("extension")
|
|
("hyperfigures" ("true" "false"))
|
|
("backref" ("section" "slide" "page" "none" "false"))
|
|
("pagebackref" ("true" "false"))
|
|
("hyperindex" ("true" "false"))
|
|
("hyperfootnotes" ("true" "false"))
|
|
("encap")
|
|
("linktocpage" ("true" "false"))
|
|
("breaklinks" ("true" "false"))
|
|
("colorlinks" ("true" "false"))
|
|
("linkcolor")
|
|
("anchorcolor")
|
|
("citecolor")
|
|
("filecolor")
|
|
("menucolor")
|
|
("runcolor")
|
|
("urlcolor")
|
|
("allcolors")
|
|
("frenchlinks" ("true" "false"))
|
|
("hidelinks")
|
|
;; PDF-specific display options
|
|
("bookmarks" ("true" "false"))
|
|
("bookmarksopen" ("true" "false"))
|
|
("bookmarksopenlevel")
|
|
("bookmarksnumbered" ("true" "false"))
|
|
("bookmarkstype")
|
|
("CJKbookmarks" ("true" "false"))
|
|
("pdfhighlight" ("/I" "/N" "/O" "/P"))
|
|
("citebordercolor")
|
|
("filebordercolor")
|
|
("linkbordercolor")
|
|
("menubordercolor")
|
|
("runbordercolor")
|
|
("urlbordercolor")
|
|
("allbordercolors")
|
|
("pdfborder")
|
|
;; PDF display and information options
|
|
("baseurl")
|
|
("pdfpagemode" ("UseOutlines" "UseThumbs" "FullScreen" "UseOC" "UseAttachments"))
|
|
("pdftitle")
|
|
("pdfauthor")
|
|
("pdfsubject")
|
|
("pdfcreator")
|
|
("pdfproducer")
|
|
("pdfkeywords")
|
|
("pdftrapped" ("True" "False" "Unknown"))
|
|
("pdfinfo")
|
|
("pdfview" ("XYZ" "Fit" "FitH" "FitV" "FitR" "FitB" "FitBH" "FitBV"))
|
|
("pdfstartpage")
|
|
("pdfstartview" ("XYZ" "Fit" "FitH" "FitV" "FitR" "FitB" "FitBH" "FitBV"))
|
|
("pdfremotestartview" ("XYZ" "Fit" "FitH" "FitV" "FitR" "FitB" "FitBH" "FitBV"))
|
|
("pdfpagescrop")
|
|
("pdfcenterwindow" ("true" "false"))
|
|
("pdfdirection" ("L2R" "R2L"))
|
|
("pdfdisplaydoctitle" ("true" "false"))
|
|
("pdfduplex" ("Simplex" "DuplexFlipShortEdge" "DuplexFlipLongEdge"))
|
|
("pdffitwindow" ("true" "false"))
|
|
("pdflang")
|
|
("pdfmenubar" ("true" "false"))
|
|
("pdfnewwindow" ("true" "false"))
|
|
("pdfnonfullscreenpagemode" ("UseNone" "UseOutlines" "UseThumbs" "FullScreen" "UseOC" "UseAttachments"))
|
|
("pdfnumcopies")
|
|
("pdfpagelayout" ("SinglePage" "OneColumn" "TwoColumnLeft" "TwoColumnRight" "TwoPageLeft" "TwoPageRight"))
|
|
("pdfpagelabels" ("true" "false"))
|
|
("pdfpagetransition" ("Blinds" "Box" "Dissolve" "Glitter" "Split" "Wipe"))
|
|
("pdfpicktraybypdfsize" ("true" "false"))
|
|
("pdfprintarea" ("MediaBox" "CropBox" "BleedBox" "TrimBox" "ArtBox"))
|
|
("pdfprintclip" ("MediaBox" "CropBox" "BleedBox" "TrimBox" "ArtBox"))
|
|
("pdfprintpagerange")
|
|
("pdfprintscaling" ("AppDefault" "None"))
|
|
("pdftoolbar" ("true" "false"))
|
|
("pdfviewarea" ("MediaBox" "CropBox" "BleedBox" "TrimBox" "ArtBox"))
|
|
("pdfviewclip" ("MediaBox" "CropBox" "BleedBox" "TrimBox" "ArtBox"))
|
|
("pdfwindowui" ("true" "false"))
|
|
("unicode" ("true" "false")))
|
|
"Package options for the hyperref package.")
|
|
|
|
(defvar LaTeX-hyperref-href-options
|
|
'(("pdfremotestartview" ("XYZ" "Fit" "FitH" "FitV" "FitR" "FitB" "FitBH" "FitBV"))
|
|
("pdfnewwindow" ("true" "false"))
|
|
("page")
|
|
("ismap" ("true" "false"))
|
|
("nextactionraw"))
|
|
"Key=value options for href macro of the hyperref package.")
|
|
|
|
;; See https://mirrors.ctan.org/macros/latex/contrib/hyperref/doc/hyperref-doc.html#x1-600009.2
|
|
(defvar LaTeX-hyperref-forms-options
|
|
'(("accesskey")
|
|
("align" ("0" "1" "2"))
|
|
("altname")
|
|
("backgroundcolor")
|
|
("bordercolor")
|
|
("bordersep")
|
|
("borderstyle" ("S" "D" "B" "I" "U"))
|
|
("borderwidth")
|
|
("calculate")
|
|
("charsize")
|
|
("checkboxsymbol")
|
|
("checked" ("true" "false"))
|
|
("color")
|
|
("combo" ("true" "false"))
|
|
("default")
|
|
("disabled" ("true" "false"))
|
|
("format")
|
|
("height")
|
|
("hidden" ("true" "false"))
|
|
("keystroke")
|
|
("mappingname")
|
|
("maxlen")
|
|
("menulength")
|
|
("multiline" ("true" "false"))
|
|
("name")
|
|
("onblur")
|
|
("onchange")
|
|
("onclick")
|
|
("ondblclick")
|
|
("onfocus")
|
|
("onkeydown")
|
|
("onkeypress")
|
|
("onkeyup")
|
|
("onmousedown")
|
|
("onmousemove")
|
|
("onmouseout")
|
|
("onmouseover")
|
|
("onmouseup")
|
|
("onselect")
|
|
("password" ("true" "false"))
|
|
("popdown" ("true" "false"))
|
|
("radio" ("true" "false"))
|
|
("radiosymbol")
|
|
("readonly" ("true" "false"))
|
|
("rotation")
|
|
("tabkey")
|
|
("validate")
|
|
("value")
|
|
("width"))
|
|
"Key=value options for Forms related macros of the hyperref package.")
|
|
|
|
(TeX-add-style-hook
|
|
"hyperref"
|
|
(lambda ()
|
|
;; hyperref loads nameref and url (+ some other packages which do not have
|
|
;; style hooks)
|
|
(TeX-run-style-hooks "url" "nameref")
|
|
|
|
(TeX-add-symbols
|
|
'("hypersetup" (TeX-arg-key-val LaTeX-hyperref-package-options-list))
|
|
'("href" [TeX-arg-key-val LaTeX-hyperref-href-options] "URL" "Text")
|
|
;; Completion for \url is provided via url.el. Hence the entry in
|
|
;; this style is commented:
|
|
;; '("url" "URL" ignore)
|
|
'("nolinkurl" t)
|
|
'("hyperbaseurl" t)
|
|
'("hyperimage" "Image URL" "Text")
|
|
'("hyperdef" "Category" "Name" "Text")
|
|
'("hyperref"
|
|
(TeX-arg-conditional (y-or-n-p "Insert a label and text? ")
|
|
([TeX-arg-ref] "Text")
|
|
("URL" "Category" "Name" "Text")))
|
|
'("hyperlink" "Name" "Text")
|
|
'("hypertarget" "Name" "Text")
|
|
'("phantomsection" 0)
|
|
'("autoref" TeX-arg-ref)
|
|
'("autoref*" TeX-arg-ref)
|
|
'("ref*" TeX-arg-ref)
|
|
'("pageref*" TeX-arg-ref)
|
|
'("autopageref" TeX-arg-ref)
|
|
'("autopageref*" TeX-arg-ref)
|
|
'("pdfstringdef" "Macro name" "TeX string")
|
|
'("pdfbookmark" [ "Level" ] "Text" "name")
|
|
'("currentpdfbookmark" "Text" "Name")
|
|
'("subpdfbookmark" "Text" "Name")
|
|
'("belowpdfbookmark" "Text" "Name")
|
|
'("texorpdfstring" "TeX string" "PDF string")
|
|
'("hypercalcbp" t)
|
|
'("Acrobatmenu" "Menu option" "Text")
|
|
;; The next 6 macros take Key-vals defined in
|
|
;; "LaTeX-hyperref-forms-options". For an example, see
|
|
;; https://github.com/latex3/hyperref/blob/main/test/testform.tex
|
|
'("TextField" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label")
|
|
'("CheckBox" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label")
|
|
'("ChoiceMenu" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label" "Choices")
|
|
'("PushButton" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label")
|
|
'("Submit" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label")
|
|
'("Reset" [TeX-arg-key-val LaTeX-hyperref-forms-options] "Label")
|
|
'("LayoutTextField" "Label" "Field")
|
|
'("LayoutChoiceField" "Label" "Field")
|
|
'("LayoutCheckField" "Label" "Field")
|
|
'("MakeRadioField" "Width" "Height")
|
|
'("MakeCheckField" "Width" "Height")
|
|
'("MakeTextField" "Width" "Height")
|
|
'("MakeChoiceField" "Width" "Height")
|
|
'("MakeButtonField" "Text")
|
|
;; The macro version of the 'Form' environment:
|
|
'("Form" 0))
|
|
|
|
;; Form fields must be inside a "Form"-env, one per file is allowed, cf.
|
|
;; https://mirrors.ctan.org/macros/latex/contrib/hyperref/doc/hyperref-doc.html#x1-590009.1
|
|
(LaTeX-add-environments
|
|
'("Form" LaTeX-env-args [TeX-arg-key-val (("action")
|
|
("encoding" ("html"))
|
|
("method" ("post" "get")))])
|
|
"NoHyper")
|
|
|
|
;; Do not indent the content of the "Form"-env; it is odd if the
|
|
;; whole document is indented. Append it to a local version of
|
|
;; `LaTeX-document-regexp':
|
|
(unless (string-match-p "Form" LaTeX-document-regexp)
|
|
(set (make-local-variable 'LaTeX-document-regexp)
|
|
(concat LaTeX-document-regexp "\\|" "Form")))
|
|
|
|
(add-to-list 'LaTeX-verbatim-macros-with-braces-local "nolinkurl")
|
|
(add-to-list 'LaTeX-verbatim-macros-with-braces-local "hyperbaseurl")
|
|
(add-to-list 'LaTeX-verbatim-macros-with-braces-local "hyperimage")
|
|
;; "hyperref" macros is not added here since it takes different
|
|
;; number of arguments depending on a given optional argument.
|
|
;; The first mandatory argument is not necessarily a verbatim one.
|
|
;; (add-to-list 'LaTeX-verbatim-macros-with-braces-local "hyperref")
|
|
(add-to-list 'LaTeX-verbatim-macros-with-braces-local "href")
|
|
|
|
;; In hyperref package, \url macro is redefined and \url|...| can't
|
|
;; be used, while it's possible when only url package (required by
|
|
;; hyperref) is loaded
|
|
(setq LaTeX-verbatim-macros-with-delims-local
|
|
(remove "url" LaTeX-verbatim-macros-with-delims-local))
|
|
|
|
;; Fontification
|
|
(when (and (featurep 'font-latex)
|
|
(eq TeX-install-font-lock 'font-latex-setup))
|
|
(font-latex-add-keywords '(("href" "[{{")
|
|
("nolinkurl" "{")
|
|
("hyperbaseurl" "{")
|
|
("hyperimage" "{{")
|
|
("hyperdef" "{{{")
|
|
;; Fontify only the minimum set of args:
|
|
("hyperref" "[{")
|
|
("hyperlink" "{{")
|
|
("hypertarget" "{{")
|
|
("autoref" "*{")
|
|
("ref" "*{")
|
|
("pageref" "*{")
|
|
("autopageref" "*{"))
|
|
'reference)
|
|
(font-latex-add-keywords '(("hypersetup" "{"))
|
|
'function)
|
|
;; For syntactic fontification, e.g. verbatim constructs.
|
|
(font-latex-set-syntactic-keywords))
|
|
|
|
;; Option management
|
|
(if (and (LaTeX-provided-package-options-member "hyperref" "dvipdfmx")
|
|
(not (eq TeX-engine 'xetex)))
|
|
(setq TeX-PDF-from-DVI "Dvipdfmx"))
|
|
|
|
;; Loop over the possible options and load backref.el:
|
|
(let ((opts '("backref"
|
|
"backref=section"
|
|
"backref=slide"
|
|
"backref=page"
|
|
"pagebackref"
|
|
"pagebackref=true")))
|
|
(dolist (opt opts)
|
|
(when (LaTeX-provided-package-options-member "hyperref" opt)
|
|
(TeX-run-style-hooks "backref"))))
|
|
|
|
;; Activate RefTeX reference style.
|
|
(and LaTeX-reftex-ref-style-auto-activate
|
|
(fboundp 'reftex-ref-style-activate)
|
|
(reftex-ref-style-activate "Hyperref")))
|
|
TeX-dialect)
|
|
|
|
(defun LaTeX-hyperref-package-options ()
|
|
"Read the hyperref package options from the user."
|
|
(TeX-read-key-val t LaTeX-hyperref-package-options-list))
|
|
|
|
;;; hyperref.el ends here
|