emacs/code/elpa/auctex-13.2.1/style/ntheorem.el

409 lines
16 KiB
EmacsLisp

;;; ntheorem.el --- AUCTeX style for `ntheorem.sty' (v1.33) -*- lexical-binding: t; -*-
;; Copyright (C) 2015-2023 Free Software Foundation, Inc.
;; Author: Arash Esbati <arash@gnu.org>
;; Maintainer: auctex-devel@gnu.org
;; Created: 2015-10-31
;; 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 `ntheorem.sty' (v1.33) from 2011/08/15.
;; `ntheorem.sty' is and part of TeXLive.
;; This style interacts with AUCTeX and RefTeX mechanisms for
;; inserting labels into new defined environments with "\newtheoreom".
;; AUCTeX users need to add the new environment to `LaTeX-label-alist'
;; via customize or in init-file like this:
;;
;; (add-to-list 'LaTeX-label-alist '("lemma" . "lem:"))
;;
;; RefTeX users have to add the value to both `LaTeX-label-alist' and
;; `reftex-label-alist' like this:
;;
;; (add-to-list 'LaTeX-label-alist '("lemma" . "lem:"))
;; (add-to-list 'reftex-label-alist
;; '("lemma" ?m "lem:" "~ref{%s}"
;; nil ("Lemma" "lemma") nil))
;;; Code
(require 'crm)
(require 'tex)
(require 'latex)
;; Silence the compiler:
(declare-function font-latex-add-keywords
"font-latex"
(keywords class))
(declare-function LaTeX-color-definecolor-list
"color"
())
(declare-function LaTeX-xcolor-definecolor-list
"xcolor"
())
(defvar LaTeX-ntheorem-theoremstyle-list
'(("plain") ("break") ("change") ("changebreak") ("margin")
("marginbreak") ("nonumberplain") ("nonumberbreak") ("empty"))
"List of theorem styles provided by `ntheorem.el' and new ones
defined with \"\\newtheoremstyle\".")
(defvar LaTeX-ntheorem-listtype-list
'(("all") ("allname") ("opt") ("optname"))
"List of predefined formatting options available for
\"\\theoremlisttype\" provided by `ntheorem.el' and new ones
defined with \"\\newtheoremlisttype\".")
;; Setup parsing for \newtheorem
(TeX-auto-add-type "ntheorem-newtheorem" "LaTeX")
;; Setup parsing for \newtheoremstyle
(TeX-auto-add-type "ntheorem-newtheoremstyle" "LaTeX")
;; Setup parsing for \newtheoremlisttype
(TeX-auto-add-type "ntheorem-newtheoremlisttype" "LaTeX")
(defun LaTeX-ntheorem-auto-prepare ()
"Clear `LaTeX-auto-ntheorem-newtheorem' and
`LaTeX-auto-ntheorem-newtheoremstyle' before parsing."
(setq LaTeX-auto-ntheorem-newtheorem nil)
(setq LaTeX-auto-ntheorem-newtheoremstyle nil)
(setq LaTeX-auto-ntheorem-newtheoremlisttype nil))
(defun LaTeX-ntheorem-auto-cleanup ()
"Move parsed results from `LaTeX-auto-ntheorem-newtheorem' and
make them available as new environments. Update
`LaTeX-ntheorem-theoremstyle-list' with styles defined with
\"\\newtheoremstyle\"."
(dolist (newthm (mapcar #'car (LaTeX-ntheorem-newtheorem-list)))
(LaTeX-add-environments (list newthm
#'LaTeX-env-label-args ["Heading"]))
(LaTeX-add-environments (list (concat newthm "*")
#'LaTeX-env-label-args ["Heading"])))
(dolist (newthmstyle (LaTeX-ntheorem-newtheoremstyle-list))
(add-to-list (make-local-variable 'LaTeX-ntheorem-theoremstyle-list)
newthmstyle))
(dolist (newthmlist (LaTeX-ntheorem-newtheoremlisttype-list))
(add-to-list (make-local-variable 'LaTeX-ntheorem-listtype-list)
newthmlist))
(when (LaTeX-provided-package-options-member "ntheorem" "thmmarks")
(dolist (nthm (mapcar #'car (LaTeX-ntheorem-newtheorem-list)))
(TeX-add-symbols (concat nthm "Symbol"))))
(dolist (nthm (mapcar #'car (LaTeX-ntheorem-newtheorem-list)))
(TeX-add-symbols (concat nthm "name"))))
(add-hook 'TeX-auto-prepare-hook #'LaTeX-ntheorem-auto-prepare t)
(add-hook 'TeX-auto-cleanup-hook #'LaTeX-ntheorem-auto-cleanup t)
(add-hook 'TeX-update-style-hook #'TeX-auto-parse t)
(TeX-add-style-hook
"ntheorem"
(lambda ()
(TeX-auto-add-regexp
`(,(concat "\\\\"
(regexp-opt '("newtheorem" "newframedtheorem" "newshadedtheorem"))
"{\\(" TeX-token-char "+\\)}")
1 LaTeX-auto-ntheorem-newtheorem))
(TeX-auto-add-regexp
`(,(concat "\\\\newtheoremstyle{\\(" TeX-token-char "+\\)}")
1 LaTeX-auto-ntheorem-newtheoremstyle))
(TeX-auto-add-regexp
`(,(concat "\\\\newtheoremlisttype{\\(" TeX-token-char "+\\)}")
1 LaTeX-auto-ntheorem-newtheoremlisttype))
(TeX-add-symbols
;; 2.2 Defining New Theorem Sets
;; Overrule the defintion in `latex.el':
`("newtheorem"
,(lambda (optional)
(let ((nthm (TeX-read-string
(TeX-argument-prompt optional nil "Environment"))))
(LaTeX-add-ntheorem-newtheorems nthm)
(LaTeX-add-environments (list nthm
#'LaTeX-env-label-args ["Heading"]))
(LaTeX-add-environments (list (concat nthm "*")
#'LaTeX-env-label-args ["Heading"]))
(TeX-argument-insert nthm optional)))
[ TeX-arg-environment "Numbered like" ]
"Title"
(TeX-arg-conditional (save-excursion
(skip-chars-backward (concat "^" TeX-grcl))
(backward-list)
(= (preceding-char) ?\]))
()
([TeX-arg-counter "Within counter"])))
'("renewtheorem"
(TeX-arg-completing-read (LaTeX-ntheorem-newtheorem-list)
"Environment")
[ TeX-arg-environment "Numbered like" ]
"Title"
(TeX-arg-conditional (save-excursion
(skip-chars-backward (concat "^" TeX-grcl))
(backward-list)
(= (preceding-char) ?\]))
()
([TeX-arg-counter "Within counter"])))
;; 2.3 Defining the Layout of Theorem Sets
'("theoremstyle"
(TeX-arg-completing-read LaTeX-ntheorem-theoremstyle-list "Style"))
`("theorembodyfont"
(TeX-arg-completing-read-multiple
,(lambda () (append LaTeX-font-family
LaTeX-font-series
LaTeX-font-shape
LaTeX-font-size))
"Body font" nil nil ,(regexp-quote TeX-esc) ,TeX-esc
nil nil nil nil ,TeX-esc))
'("theoremheaderfont"
(TeX-arg-completing-read-multiple
,(lambda () (append LaTeX-font-family
LaTeX-font-series
LaTeX-font-shape
LaTeX-font-size))
"Header font" nil nil ,(regexp-quote TeX-esc) ,TeX-esc
nil nil nil nil ,TeX-esc))
'("theoremnumbering"
(TeX-arg-completing-read ("arabic" "roman" "Roman" "alph" "Alph"
"greek" "Greek" "fnsymbol")
"Numbering scheme"))
'("theoremseparator" "Separator")
'("theorempreskip"
(TeX-arg-length "Skip before theorem"))
'("theorempostskip"
(TeX-arg-length "Skip after theorem"))
'("theoremindent"
(TeX-arg-free "Theorem indent"))
(when (LaTeX-provided-package-options-member "ntheorem" "thmmarks")
'("theoremsymbol" t))
'("theoremprework" t)
'("theorempostwork" t)
`("theoremclass"
(TeX-arg-completing-read ,(lambda ()
(append '(("LaTeX"))
(LaTeX-ntheorem-newtheorem-list)))
"Theorem type"))
;; 2.3.6 A Standard Set of Theorems
(when (LaTeX-provided-package-options-member "ntheorem" "standard")
(let ((env '("Theorem" "Lemma" "Proposition"
"Corollary" "Satz" "Korollar"
"Definition" "Example" "Beispiel"
"Anmerkung" "Bemerkung" "Remark"
"Proof" "Beweis")))
(dolist (elt env)
(LaTeX-add-ntheorem-newtheorems elt)
(LaTeX-add-environments (list elt
#'LaTeX-env-label-args ["Heading"]))
(LaTeX-add-environments (list (concat elt "*")
#'LaTeX-env-label-args ["Heading"])))))
;; 2.3.7 Framed and Boxed Theorems
`("newframedtheorem"
,(lambda (optional)
(let ((nthm (TeX-read-string
(TeX-argument-prompt optional nil "Environment"))))
(LaTeX-add-ntheorem-newtheorems nthm)
(LaTeX-add-environments (list nthm
#'LaTeX-env-label-args ["Heading"]))
(LaTeX-add-environments (list (concat nthm "*")
#'LaTeX-env-label-args ["Heading"]))
(TeX-argument-insert nthm optional)))
[ TeX-arg-environment "Numbered like" ]
"Title"
(TeX-arg-conditional (save-excursion
(skip-chars-backward (concat "^" TeX-grcl))
(backward-list)
(= (preceding-char) ?\]))
()
([TeX-arg-counter "Within counter"])))
`("newshadedtheorem"
,(lambda (optional)
(let ((nthm (TeX-read-string
(TeX-argument-prompt optional nil "Environment"))))
(LaTeX-add-ntheorem-newtheorems nthm)
(LaTeX-add-environments (list nthm
#'LaTeX-env-label-args ["Heading"]))
(LaTeX-add-environments (list (concat nthm "*")
#'LaTeX-env-label-args ["Heading"]))
(TeX-argument-insert nthm optional)))
[ TeX-arg-environment "Numbered like" ]
"Title"
(TeX-arg-conditional (save-excursion
(skip-chars-backward (concat "^" TeX-grcl))
(backward-list)
(= (preceding-char) ?\]))
()
([TeX-arg-counter "Within counter"])))
`("shadecolor"
(TeX-arg-conditional (TeX-member "\\`x?color\\'" (TeX-style-list) #'string-match)
((TeX-arg-completing-read ,(lambda ()
(or (and (fboundp 'LaTeX-xcolor-definecolor-list)
(LaTeX-xcolor-definecolor-list))
(and (fboundp 'LaTeX-color-definecolor-list)
(LaTeX-color-definecolor-list))))
"Color name"))
("Color name")))
'("theoremframepreskip"
(TeX-arg-length "Skip before framed theorem"))
'("theoremframepostskip"
(TeX-arg-length "Skip after framed theorem"))
'("theoreminframepreskip"
(TeX-arg-length "Skip inside framed theorem"))
'("theoreminframepostskip"
(TeX-arg-length "Skip inside framed theorem"))
;; 2.4 Generating Theoremlists
'("listtheorems"
(TeX-arg-completing-read-multiple (LaTeX-ntheorem-newtheorem-list)
"Lists"))
;; 2.4.2 Writing Extra Stuff to the Theorem File
'("addtheoremline"
(TeX-arg-completing-read (LaTeX-ntheorem-newtheorem-list)
"Environment")
t)
'("addtheoremline*"
(TeX-arg-completing-read (LaTeX-ntheorem-newtheorem-list)
"Environment")
t)
'("addtotheoremfile"
[TeX-arg-completing-read (LaTeX-ntheorem-newtheorem-list)
"Environment"]
t)
;; 2.5.1 Defining New Theorem Layouts
`("newtheoremstyle"
,(lambda (optional)
(let ((style (TeX-read-string
(TeX-argument-prompt optional nil "Style name"))))
(LaTeX-add-ntheorem-newtheoremstyles style)
(add-to-list (make-local-variable 'LaTeX-ntheorem-theoremstyle-list)
(list style))
(TeX-argument-insert style optional)))
2)
'("renewtheoremstyle"
(TeX-arg-completing-read LaTeX-ntheorem-theoremstyle-list
"Style name")
2)
;; 2.5.2 Defining New Theorem List Layouts
`("newtheoremlisttype"
,(lambda (optional)
(let ((layout (TeX-read-string
(TeX-argument-prompt optional nil "List layout name"))))
(LaTeX-add-ntheorem-newtheoremlisttypes layout)
(add-to-list (make-local-variable 'LaTeX-ntheorem-listtype-list)
(list layout))
(TeX-argument-insert layout optional)))
3)
'("renewtheoremlisttype"
(TeX-arg-completing-read LaTeX-ntheorem-listtype-list
"Style name")
3)
;; 2.6 Setting End Marks
'("qedsymbol" t)
'("NoEndMark" 0)
;; 2.7 Extended Referencing Features
(when (LaTeX-provided-package-options-member "ntheorem" "thref")
'("thref" TeX-arg-ref)) )
;; 2.6 Setting End Marks
;; ... the endmark can manually be set by just saying \<name>Symbol.
(when (LaTeX-provided-package-options-member "ntheorem" "thmmarks")
(dolist (nthm (mapcar #'car (LaTeX-ntheorem-newtheorem-list)))
(TeX-add-symbols (concat nthm "Symbol"))))
;; 2.8 Miscellaneous
;; Inside a theorem-like environment <env>, the name given as
;; optional argument is accessible by \<env>name
(dolist (nthm (mapcar #'car (LaTeX-ntheorem-newtheorem-list)))
(TeX-add-symbols (concat nthm "name")))
;; Fontification
(when (and (featurep 'font-latex)
(eq TeX-install-font-lock 'font-latex-setup))
(font-latex-add-keywords '(("newtheorem" "{[{[")
("renewtheorem" "{[{[")
("theoremstyle" "{")
("theorembodyfont" "{")
("theoremheaderfont" "{")
("theoremnumbering" "{")
("theoremseparator" "{")
("theorempreskip" "{")
("theorempostskip" "{")
("theoremsymbol" "{")
("theoremindent" "")
("theoremprework" "{")
("theorempostwork" "{")
("theoremclass" "{")
("newframedtheorem" "{[{[")
("newshadedtheorem" "*{[{[")
("shadecolor" "{")
("theoremframepreskip" "{")
("theoremframepostskip" "{")
("theoreminframepreskip" "{")
("theoreminframepostskip" "{")
("listtheorems" "{")
("addtheoremline" "*{{")
("addtotheoremfile" "[{")
("newtheoremstyle" "{{{")
("renewtheoremstyle" "{{{")
("newtheoremlisttype" "{{{{")
("renewtheoremlisttype" "{{{{"))
'function)
(font-latex-add-keywords '(("thref" "{"))
'reference)))
TeX-dialect)
(defvar LaTeX-ntheorem-package-options
'("standard" "noconfig" "framed" "thmmarks" "thref" "amsmath" "hyperref")
"Package options for the ntheorem package.")
;;; ntheorem.el ends here