-;; iso-cvt.el -- translate to ISO 8859-1 from/to net/TeX conventions
-;; Copyright © 1993 Free Software Foundation, Inc.
-;; Was formerly called gm-lingo.el.
+;;; iso-cvt.-el -- translate ISO 8859-1 from/to various encodings
+;; This file was formerly called gm-lingo.el.
+
+;; Copyright (C) 1993, 1994, 1995, 1996, 1998 Free Software Foundation, Inc.
;; Author: Michael Gschwind <mike@vlsivie.tuwien.ac.at>
;; Keywords: tex, iso, latin, i18n
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs; see the file COPYING. If not, write to
-;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+;; along with GNU Emacs; see the file COPYING. If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+;; This lisp code is a general framework for translating various
+;; representations of the same data.
+;; among other things it can be used to translate TeX, HTML, and compressed
+;; files to ISO 8859-1. It can also be used to translate different charsets
+;; such as IBM PC, Macintosh or HP Roman8.
+;; Note that many translations use the GNU recode tool to do the actual
+;; conversion. So you might want to install that tool to get the full
+;; benefit of iso-cvt.el
+;
-;;; Commentary:
+; TO DO:
+; Cover more cases for translation (There is an infinite number of ways to
+; represent accented characters in TeX)
-; Calling `iso-german' will turn the net convention f or umlauts ("a etc.)
-; into ISO latin umlaute for easy reading.
-; hooks change TeX files to Latin-1 for editing and back to TeX sequences
-; for calling TeX. An alternative is a TeX style that handles
-; 8 bit ISO files (available on ftp.vlsivie.tuwien.ac.at in /pub/8bit)
-; - but these files are difficult to transmit ... so while the net is
-; still @ 7 bit this may be useful
-
-; to do: translate buffer when displaying from GNUS,
-; use function 'german which does the Right Thing
-;
-; to do: use more general regular expressions for (g)tex2iso tables, to
-; cover more cases for translation.
+;; SEE ALSO:
+; If you are interested in questions related to using the ISO 8859-1
+; characters set (configuring emacs, Unix, etc. to use ISO), then you
+; can get the ISO 8859-1 FAQ via anonymous ftp from
+; ftp.vlsivie.tuwien.ac.at in /pub/bit/FAQ-ISO-8859-1
;;; Code:
(provide 'iso-cvt)
+(require 'format)
(defvar iso-spanish-trans-tab
'(
)
"Spanish translation table.")
-(defun iso-translate-conventions (trans-tab)
- "Use the translation table argument to translate the current buffer."
- (interactive)
+(defun iso-translate-conventions (from to trans-tab)
+ "Use the translation table TRANS-TAB to translate the current buffer."
(save-excursion
- (widen)
- (goto-char (point-min))
- (let ((work-tab trans-tab)
- (buffer-read-only nil))
- (while work-tab
- (save-excursion
- (let ((trans-this (car work-tab)))
- (while (re-search-forward (car trans-this) nil t)
- (replace-match (car (cdr trans-this)) nil nil)))
- (setq work-tab (cdr work-tab)))))))
-
-(defun iso-spanish ()
- "Translate net conventions for Spanish to ISO 8859-1."
- (interactive)
- (iso-translate-conventions iso-spanish-trans-tab))
+ (save-restriction
+ (narrow-to-region from to)
+ (goto-char from)
+ (let ((work-tab trans-tab)
+ (buffer-read-only nil)
+ (case-fold-search nil))
+ (while work-tab
+ (save-excursion
+ (let ((trans-this (car work-tab)))
+ (while (re-search-forward (car trans-this) nil t)
+ (replace-match (car (cdr trans-this)) t nil)))
+ (setq work-tab (cdr work-tab)))))
+ (point-max))))
+
+;;;###autoload
+(defun iso-spanish (from to &optional buffer)
+ "Translate net conventions for Spanish to ISO 8859-1.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-spanish-trans-tab))
(defvar iso-aggressive-german-trans-tab
'(
("\"s" "ß")
("\\\\3" "ß")
)
- "German translation table.
-This table uses an aggressive translation approach and may translate
-erroneously translate too much.")
+ "German translation table.
+This table uses an aggressive translation approach and may erroneously
+translate too much.")
(defvar iso-conservative-german-trans-tab
'(
("\\([-a-zA-Z\"`]\\)\\\\3" "\\1ß")
)
"German translation table.
-This table uses a conservative translation approach and may translate too
+This table uses a conservative translation approach and may translate too
little.")
-
-(defvar iso-german-trans-tab iso-aggressive-german-trans-tab
+(defvar iso-german-trans-tab iso-aggressive-german-trans-tab
"Currently active translation table for German.")
-(defun iso-german ()
- "Translate net conventions for German to ISO 8859-1."
- (interactive)
- (iso-translate-conventions iso-german-trans-tab))
+;;;###autoload
+(defun iso-german (from to &optional buffer)
+ "Translate net conventions for German to ISO 8859-1.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-german-trans-tab))
(defvar iso-iso2tex-trans-tab
'(
("ç" "{\\\\c c}")
("Ç" "{\\\\c C}")
("ß" "{\\\\ss}")
+ ("\306" "{\\\\AE}")
+ ("\346" "{\\\\ae}")
+ ("\305" "{\\\\AA}")
+ ("\345" "{\\\\aa}")
+ ("\251" "{\\\\copyright}")
+ ("£" "{\\\\pounds}")
+ ("¶" "{\\\\P}")
+ ("§" "{\\\\S}")
("¿" "{?`}")
("¡" "{!`}")
)
"Translation table for translating ISO 8859-1 characters to TeX sequences.")
-
-
-
-(defun iso-iso2tex ()
- "Translate ISO 8859-1 characters to TeX sequences."
- (interactive)
- (iso-translate-conventions iso-iso2tex-trans-tab))
-
+;;;###autoload
+(defun iso-iso2tex (from to &optional buffer)
+ "Translate ISO 8859-1 characters to TeX sequences.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-iso2tex-trans-tab))
(defvar iso-tex2iso-trans-tab
'(
("{\\\\~N}" "Ñ")
("{\\\\c c}" "ç")
("{\\\\c C}" "Ç")
+ ("\\\\\"a" "ä")
+ ("\\\\`a" "à")
+ ("\\\\'a" "á")
+ ("\\\\~a" "ã")
+ ("\\\\^a" "â")
+ ("\\\\\"e" "ë")
+ ("\\\\`e" "è")
+ ("\\\\'e" "é")
+ ("\\\\^e" "ê")
+ ("\\\\\"\\\\i" "ï")
+ ("\\\\`\\\\i" "ì")
+ ("\\\\'\\\\i" "í")
+ ("\\\\^\\\\i" "î")
+ ("\\\\\"i" "ï")
+ ("\\\\`i" "ì")
+ ("\\\\'i" "í")
+ ("\\\\^i" "î")
+ ("\\\\\"o" "ö")
+ ("\\\\`o" "ò")
+ ("\\\\'o" "ó")
+ ("\\\\~o" "õ")
+ ("\\\\^o" "ô")
+ ("\\\\\"u" "ü")
+ ("\\\\`u" "ù")
+ ("\\\\'u" "ú")
+ ("\\\\^u" "û")
+ ("\\\\\"A" "Ä")
+ ("\\\\`A" "À")
+ ("\\\\'A" "Á")
+ ("\\\\~A" "Ã")
+ ("\\\\^A" "Â")
+ ("\\\\\"E" "Ë")
+ ("\\\\`E" "È")
+ ("\\\\'E" "É")
+ ("\\\\^E" "Ê")
+ ("\\\\\"I" "Ï")
+ ("\\\\`I" "Ì")
+ ("\\\\'I" "Í")
+ ("\\\\^I" "Î")
+ ("\\\\\"O" "Ö")
+ ("\\\\`O" "Ò")
+ ("\\\\'O" "Ó")
+ ("\\\\~O" "Õ")
+ ("\\\\^O" "Ô")
+ ("\\\\\"U" "Ü")
+ ("\\\\`U" "Ù")
+ ("\\\\'U" "Ú")
+ ("\\\\^U" "Û")
+ ("\\\\~n" "ñ")
+ ("\\\\~N" "Ñ")
("\\\\\"{a}" "ä")
("\\\\`{a}" "à")
("\\\\'{a}" "á")
("\\\\c{c}" "ç")
("\\\\c{C}" "Ç")
("{\\\\ss}" "ß")
- ("?`" "¿")
- ("!`" "¡")
- ("{?`}" "¿")
+ ("{\\\\AE}" "\306")
+ ("{\\\\ae}" "\346")
+ ("{\\\\AA}" "\305")
+ ("{\\\\aa}" "\345")
+ ("{\\\\copyright}" "\251")
+ ("\\\\copyright{}" "\251")
+ ("{\\\\pounds}" "£" )
+ ("{\\\\P}" "¶" )
+ ("{\\\\S}" "§" )
+ ("\\\\pounds{}" "£" )
+ ("\\\\P{}" "¶" )
+ ("\\\\S{}" "§" )
+ ("{\\?`}" "¿")
("{!`}" "¡")
+ ("\\?`" "¿")
+ ("!`" "¡")
)
- "Translation table for translating TeX sequences to ISO 8859-1 characters.
-This table is not exhaustive (and due to TeX's power can never be). It only
+ "Translation table for translating TeX sequences to ISO 8859-1 characters.
+This table is not exhaustive (and due to TeX's power can never be). It only
contains commonly used sequences.")
-(defun iso-tex2iso ()
- "Translate TeX sequences to ISO 8859-1 characters."
- (interactive)
- (iso-translate-conventions iso-tex2iso-trans-tab))
+;;;###autoload
+(defun iso-tex2iso (from to &optional buffer)
+ "Translate TeX sequences to ISO 8859-1 characters.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-tex2iso-trans-tab))
(defvar iso-gtex2iso-trans-tab
'(
- ("\"a" "ä")
- ("\"A" "Ä")
- ("\"o" "ö")
- ("\"O" "Ö")
- ("\"u" "ü")
- ("\"U" "Ü")
- ("\"s" "ß")
- ("\\\\3" "ß")
("{\\\\\"a}" "ä")
("{\\\\`a}" "à")
("{\\\\'a}" "á")
("{\\\\~N}" "Ñ")
("{\\\\c c}" "ç")
("{\\\\c C}" "Ç")
+ ("\\\\\"a" "ä")
+ ("\\\\`a" "à")
+ ("\\\\'a" "á")
+ ("\\\\~a" "ã")
+ ("\\\\^a" "â")
+ ("\\\\\"e" "ë")
+ ("\\\\`e" "è")
+ ("\\\\'e" "é")
+ ("\\\\^e" "ê")
+ ("\\\\\"\\\\i" "ï")
+ ("\\\\`\\\\i" "ì")
+ ("\\\\'\\\\i" "í")
+ ("\\\\^\\\\i" "î")
+ ("\\\\\"i" "ï")
+ ("\\\\`i" "ì")
+ ("\\\\'i" "í")
+ ("\\\\^i" "î")
+ ("\\\\\"o" "ö")
+ ("\\\\`o" "ò")
+ ("\\\\'o" "ó")
+ ("\\\\~o" "õ")
+ ("\\\\^o" "ô")
+ ("\\\\\"u" "ü")
+ ("\\\\`u" "ù")
+ ("\\\\'u" "ú")
+ ("\\\\^u" "û")
+ ("\\\\\"A" "Ä")
+ ("\\\\`A" "À")
+ ("\\\\'A" "Á")
+ ("\\\\~A" "Ã")
+ ("\\\\^A" "Â")
+ ("\\\\\"E" "Ë")
+ ("\\\\`E" "È")
+ ("\\\\'E" "É")
+ ("\\\\^E" "Ê")
+ ("\\\\\"I" "Ï")
+ ("\\\\`I" "Ì")
+ ("\\\\'I" "Í")
+ ("\\\\^I" "Î")
+ ("\\\\\"O" "Ö")
+ ("\\\\`O" "Ò")
+ ("\\\\'O" "Ó")
+ ("\\\\~O" "Õ")
+ ("\\\\^O" "Ô")
+ ("\\\\\"U" "Ü")
+ ("\\\\`U" "Ù")
+ ("\\\\'U" "Ú")
+ ("\\\\^U" "Û")
+ ("\\\\~n" "ñ")
+ ("\\\\~N" "Ñ")
("\\\\\"{a}" "ä")
("\\\\`{a}" "à")
("\\\\'{a}" "á")
("\\\\c{c}" "ç")
("\\\\c{C}" "Ç")
("{\\\\ss}" "ß")
+ ("{\\\\AE}" "\306")
+ ("{\\\\ae}" "\346")
+ ("{\\\\AA}" "\305")
+ ("{\\\\aa}" "\345")
+ ("{\\\\copyright}" "\251")
+ ("\\\\copyright{}" "\251")
+ ("{\\\\pounds}" "£" )
+ ("{\\\\P}" "¶" )
+ ("{\\\\S}" "§" )
+ ("\\\\pounds{}" "£" )
+ ("\\\\P{}" "¶" )
+ ("\\\\S{}" "§" )
("?`" "¿")
("!`" "¡")
("{?`}" "¿")
("{!`}" "¡")
+ ("\"a" "ä")
+ ("\"A" "Ä")
+ ("\"o" "ö")
+ ("\"O" "Ö")
+ ("\"u" "ü")
+ ("\"U" "Ü")
+ ("\"s" "ß")
+ ("\\\\3" "ß")
)
"Translation table for translating German TeX sequences to ISO 8859-1.
This table is not exhaustive (and due to TeX's power can never be). It only
("ç" "{\\\\c c}")
("Ç" "{\\\\c C}")
("ß" "\"s")
+ ("\306" "{\\\\AE}")
+ ("\346" "{\\\\ae}")
+ ("\305" "{\\\\AA}")
+ ("\345" "{\\\\aa}")
+ ("\251" "{\\\\copyright}")
+ ("£" "{\\\\pounds}")
+ ("¶" "{\\\\P}")
+ ("§" "{\\\\S}")
("¿" "{?`}")
("¡" "{!`}")
)
"Translation table for translating ISO 8859-1 characters to German TeX.")
-(defun iso-gtex2iso ()
- "Translate German TeX sequences to ISO 8859-1 characters."
- (interactive)
- (iso-translate-conventions iso-gtex2iso-trans-tab))
-
-
-(defun iso-iso2gtex ()
- "Translate ISO 8859-1 characters to German TeX sequences."
- (interactive)
- (iso-translate-conventions iso-iso2gtex-trans-tab))
-
-
-(defun iso-german-tex-p ()
- "Check if tex buffer is German LaTeX."
- (save-excursion
- (widen)
- (goto-char (point-min))
- (re-search-forward "\\\\documentstyle\\[.*german.*\\]" nil t)))
-
-(defun iso-fix-iso2tex ()
- "Turn ISO 8859-1 (aka. ISO Latin-1) buffer into TeX sequences.
-If German TeX is used, German TeX sequences are generated."
- (if (or (equal major-mode 'latex-mode)
- (equal major-mode 'LaTeX-mode)) ; AucTeX wants this
- (if (iso-german-tex-p)
- (iso-iso2gtex)
- (iso-iso2tex)))
- (if (or (equal major-mode 'tex-mode)
- (equal major-mode 'TeX-mode)) ; AucTeX wants this
- (iso-iso2tex)))
-
-(defun iso-fix-tex2iso ()
- "Turn TeX sequences into ISO 8859-1 (aka. ISO Latin-1) characters.
-This function recognices German TeX buffers."
- (if (or (equal major-mode 'latex-mode)
- (equal major-mode 'Latex-mode)) ; AucTeX wants this
- (if (iso-german-tex-p)
- (iso-gtex2iso)
- (iso-tex2iso)))
- (if (or (equal major-mode 'tex-mode)
- (equal major-mode 'TeX-mode)) ;; AucTeX wants this
- (iso-tex2iso)))
-
-(defun iso-cvt-ffh ()
- "find-file-hook for iso-cvt-cvt.el."
- (iso-fix-tex2iso)
- (set-buffer-modified-p nil))
-
-(defun iso-cvt-wfh ()
- "write file hook for iso-cvt-cvt.el."
- (iso-fix-iso2tex))
-
-(defun iso-cvt-ash ()
- "after save hook for iso-cvt-cvt.el."
- (iso-fix-tex2iso)
- (set-buffer-modified-p nil))
-
-(add-hook 'find-file-hooks 'iso-cvt-ffh)
-(add-hook 'write-file-hooks 'iso-cvt-wfh)
-(add-hook 'after-save-hook 'iso-cvt-ash)
+;;;###autoload
+(defun iso-gtex2iso (from to &optional buffer)
+ "Translate German TeX sequences to ISO 8859-1 characters.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-gtex2iso-trans-tab))
+
+;;;###autoload
+(defun iso-iso2gtex (from to &optional buffer)
+ "Translate ISO 8859-1 characters to German TeX sequences.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-iso2gtex-trans-tab))
+
+(defvar iso-iso2duden-trans-tab
+ '(("ä" "ae")
+ ("Ä" "Ae")
+ ("ö" "oe")
+ ("Ö" "Oe")
+ ("ü" "ue")
+ ("Ü" "Ue")
+ ("ß" "ss")))
+
+;;;###autoload
+(defun iso-iso2duden (from to &optional buffer)
+ "Translate ISO 8859-1 characters to German TeX sequences.
+The region between FROM and TO is translated using the table TRANS-TAB.
+Optional arg BUFFER is ignored (so that the function can can be used in
+`format-alist')."
+ (interactive "*r")
+ (iso-translate-conventions from to iso-iso2duden-trans-tab))
+
+;;;###autoload
+(defun iso-cvt-read-only ()
+ "Warn that format is read-only."
+ (interactive)
+ (error "This format is read-only; specify another format for writing"))
+
+;;;###autoload
+(defun iso-cvt-write-only ()
+ "Warn that format is write-only."
+ (interactive)
+ (error "This format is write-only"))
+
+;;;###autoload
+(defun iso-cvt-define-menu ()
+ "Add submenus to the Files menu, to convert to and from various formats."
+ (interactive)
+
+ (define-key menu-bar-files-menu [load-as-separator] '("--"))
+
+ (define-key menu-bar-files-menu [load-as] '("Load As..." . load-as))
+ (defvar load-as-menu-map (make-sparse-keymap "Load As..."))
+ (fset 'load-as load-as-menu-map)
+
+ ;;(define-key menu-bar-files-menu [insert-as] '("Insert As..." . insert-as))
+ (defvar insert-as-menu-map (make-sparse-keymap "Insert As..."))
+ (fset 'insert-as insert-as-menu-map)
+
+ (define-key menu-bar-files-menu [write-as] '("Write As..." . write-as))
+ (defvar write-as-menu-map (make-sparse-keymap "Write As..."))
+ (fset 'write-as write-as-menu-map)
+
+ (define-key menu-bar-files-menu [translate-separator] '("--"))
+
+ (define-key menu-bar-files-menu [translate-to] '("Translate to..." . translate-to))
+ (defvar translate-to-menu-map (make-sparse-keymap "Translate to..."))
+ (fset 'translate-to translate-to-menu-map)
+
+ (define-key menu-bar-files-menu [translate-from] '("Translate from..." . translate-from))
+ (defvar translate-from-menu-map (make-sparse-keymap "Translate from..."))
+ (fset 'translate-from translate-from-menu-map)
+
+ (let ((file-types (reverse format-alist))
+ name
+ str-name)
+ (while file-types
+ (setq name (car (car file-types))
+ str-name (car (cdr (car file-types)))
+ file-types (cdr file-types))
+ (if (stringp str-name)
+ (progn
+ (define-key load-as-menu-map (vector name)
+ (cons str-name
+ (list 'lambda '(file) (list 'interactive (format "FFind file (as %s): " name))
+ (list 'format-find-file 'file (list 'quote name)))))
+ (define-key insert-as-menu-map (vector name)
+ (cons str-name
+ (list 'lambda '(file) (list 'interactive (format "FInsert file (as %s): " name))
+ (list 'format-insert-file 'file (list 'quote name)))))
+ (define-key write-as-menu-map (vector name)
+ (cons str-name
+ (list 'lambda '(file) (list 'interactive (format "FWrite file (as %s): " name))
+ (list 'format-write-file 'file (list 'quote (list name))))))
+ (define-key translate-to-menu-map (vector name)
+ (cons str-name
+ (list 'lambda '() '(interactive)
+ (list 'format-encode-buffer (list 'quote name)))))
+ (define-key translate-from-menu-map (vector name)
+ (cons str-name
+ (list 'lambda '() '(interactive)
+ (list 'format-decode-buffer (list 'quote (list name))))))
+ )))))
;;; iso-cvt.el ends here