lisp/muse-texinfo.el

   1 ;;; muse-texinfo.el --- publish entries to Texinfo format or PDF
   2
   3 ;; Copyright (C) 2004, 2005, 2006 Free Software Foundation, Inc.
   4
   5 ;; This file is part of Emacs Muse.  It is not part of GNU Emacs.
   6
   7 ;; Emacs Muse is free software; you can redistribute it and/or modify
   8 ;; it under the terms of the GNU General Public License as published
   9 ;; by the Free Software Foundation; either version 2, or (at your
  10 ;; option) any later version.
  11
  12 ;; Emacs Muse is distributed in the hope that it will be useful, but
  13 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
  14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 ;; General Public License for more details.
  16
  17 ;; You should have received a copy of the GNU General Public License
  18 ;; along with Emacs Muse; see the file COPYING.  If not, write to the
  19 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  20 ;; Boston, MA 02110-1301, USA.
  21
  22 ;;; Commentary:
  23
  24 ;;; Contributors:
  25
  26 ;;; Code:
  27
  28 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  29 ;;
  30 ;; Muse Texinfo Publishing
  31 ;;
  32 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  33
  34 (require 'muse-publish)
  35 (require 'muse-latex)
  36 (require 'texnfo-upd)
  37
  38 (defgroup muse-texinfo nil
  39   "Rules for marking up a Muse file as a Texinfo article."
  40   :group 'muse-publish)
  41
  42 (defcustom muse-texinfo-process-natively t
  43   "If non-nil, use the Emacs `texinfmt' module to make Info files."
  44   :type 'boolean
  45   :require 'texinfmt
  46   :group 'muse-texinfo)
  47
  48 (defcustom muse-texinfo-extension ".texi"
  49   "Default file extension for publishing Texinfo files."
  50   :type 'string
  51   :group 'muse-texinfo)
  52
  53 (defcustom muse-texinfo-info-extension ".info"
  54   "Default file extension for publishing Info files."
  55   :type 'string
  56   :group 'muse-texinfo)
  57
  58 (defcustom muse-texinfo-pdf-extension ".pdf"
  59   "Default file extension for publishing PDF files."
  60   :type 'string
  61   :group 'muse-texinfo)
  62
  63 (defcustom muse-texinfo-header
  64   "\\input texinfo  @c -*-texinfo-*-
  65
  66 @setfilename <lisp>(concat (muse-page-name) \".info\")</lisp>
  67 @settitle <lisp>(muse-publishing-directive \"title\")</lisp>
  68
  69 @documentencoding iso-8859-1
  70
  71 @iftex
  72 @finalout
  73 @end iftex
  74
  75 @titlepage
  76 @title <lisp>(muse-publishing-directive \"title\")</lisp>
  77 @author <lisp>(muse-publishing-directive \"author\")</lisp>
  78 @end titlepage
  79
  80 <lisp>(and muse-publish-generate-contents \"@contents\")</lisp>
  81
  82 @node Top, Overview, , (dir)
  83 @top Overview
  84 @c Page published by Emacs Muse begins here\n\n"
  85   "Text to prepend to a Muse page being published as Texinfo.
  86 This may be text or a filename.
  87 It may contain <lisp> markup tags."
  88   :type 'string
  89   :group 'muse-texinfo)
  90
  91 (defcustom muse-texinfo-footer
  92   "\n@c Page published by Emacs Muse ends here
  93 @bye\n"
  94   "Text to append to a Muse page being published as Texinfo.
  95 This may be text or a filename.
  96 It may contain <lisp> markup tags."
  97   :type 'string
  98   :group 'muse-texinfo)
  99
 100 (defcustom muse-texinfo-markup-regexps nil
 101   "List of markup rules for publishing a Muse page to Texinfo.
 102 For more on the structure of this list, see `muse-publish-markup-regexps'."
 103   :type '(repeat (choice
 104                   (list :tag "Markup rule"
 105                         integer
 106                         (choice regexp symbol)
 107                         integer
 108                         (choice string function symbol))
 109                   function))
 110   :group 'muse-texinfo)
 111
 112 (defcustom muse-texinfo-markup-functions
 113   '((table . muse-texinfo-markup-table))
 114   "An alist of style types to custom functions for that kind of text.
 115 For more on the structure of this list, see
 116 `muse-publish-markup-functions'."
 117   :type '(alist :key-type symbol :value-type function)
 118   :group 'muse-texinfo)
 119
 120 (defcustom muse-texinfo-markup-strings
 121   '((image-with-desc . "@image{%s}")
 122     (image-link      . "@image{%s}")
 123     (url-with-image  . "@uref{%s, %s}")
 124     (anchor-ref      . "@ref{%s, %s}")
 125     (url             . "@uref{%s, %s}")
 126     (link            . "@ref{Top, , Overview, %s, %s}")
 127     (link-and-anchor . "@ref{%2%, , %2%, %1%, %3%}")
 128     (email-addr      . "@email{%s}")
 129     (anchor          . "@anchor{%s} ")
 130     (emdash          . "---")
 131     (comment-begin   . "@ignore\n")
 132     (comment-end     . "\n@end ignore\n")
 133     (rule            . "@sp 1")
 134     (no-break-space  . "@w{ }")
 135     (enddots         . "@enddots{}")
 136     (dots            . "@dots{}")
 137     (section         . "@chapter ")
 138     (subsection      . "@section ")
 139     (subsubsection   . "@subsection ")
 140     (section-other   . "@subsubheading ")
 141     (footnote        . "@footnote{")
 142     (footnote-end    . "}")
 143     (begin-underline . "_")
 144     (end-underline   . "_")
 145     (begin-literal   . "@samp{")
 146     (end-literal     . "}")
 147     (begin-emph      . "@emph{")
 148     (end-emph        . "}")
 149     (begin-more-emph . "@strong{")
 150     (end-more-emph   . "}")
 151     (begin-most-emph . "@strong{@emph{")
 152     (end-most-emph   . "}}")
 153     (begin-verse     . "@display\n")
 154     (end-verse-line  . "")
 155     (verse-space     . "@ @ ")
 156     (end-verse       . "\n@end display")
 157     (begin-example   . "@example")
 158     (end-example     . "@end example")
 159     (begin-center    . "@quotation\n")
 160     (end-center      . "\n@end quotation")
 161     (begin-quote     . "@quotation\n")
 162     (end-quote       . "\n@end quotation")
 163     (begin-uli       . "@itemize @bullet\n")
 164     (end-uli         . "\n@end itemize")
 165     (begin-uli-item  . "@item\n")
 166     (begin-oli       . "@enumerate\n")
 167     (end-oli         . "\n@end enumerate")
 168     (begin-oli-item  . "@item\n")
 169     (begin-dl        . "@table @strong\n")
 170     (end-dl          . "\n@end table")
 171     (begin-ddt       . "@item "))
 172   "Strings used for marking up text.
 173 These cover the most basic kinds of markup, the handling of which
 174 differs little between the various styles."
 175   :type '(alist :key-type symbol :value-type string)
 176   :group 'muse-texinfo)
 177
 178 (defcustom muse-texinfo-markup-specials
 179   '((?@ . "@@")
 180     (?{ . "@{")
 181     (?} . "@}"))
 182   "A table of characters which must be represented specially."
 183   :type '(alist :key-type character :value-type string)
 184   :group 'muse-texinfo)
 185
 186 (defcustom muse-texinfo-markup-specials-url
 187   '((?@ . "@@")
 188     (?{ . "@{")
 189     (?} . "@}")
 190     (?, . "@comma{}"))
 191   "A table of characters which must be represented specially.
 192 These are applied to URLs."
 193   :type '(alist :key-type character :value-type string)
 194   :group 'muse-texinfo)
 195
 196 (defun muse-texinfo-decide-specials (context)
 197   "Determine the specials to escape, depending on CONTEXT."
 198   (cond ((eq context 'url)
 199          muse-texinfo-markup-specials-url)
 200         (t muse-texinfo-markup-specials)))
 201
 202 (defun muse-texinfo-markup-table ()
 203   (let* ((table-info (muse-publish-table-fields (match-beginning 0)
 204                                                 (match-end 0)))
 205          (row-len (car table-info))
 206          (field-list (cdr table-info)))
 207     (when table-info
 208       (muse-insert-markup "@multitable @columnfractions")
 209       (dotimes (field row-len)
 210         (muse-insert-markup " " (number-to-string (/ 1.0 row-len))))
 211       (dolist (fields field-list)
 212         (let ((type (car fields)))
 213           (setq fields (cdr fields))
 214           (muse-insert-markup "\n@item ")
 215           (insert (car fields))
 216           (setq fields (cdr fields))
 217           (dolist (field fields)
 218             (muse-insert-markup " @tab ")
 219             (insert field))))
 220       (muse-insert-markup "\n@end multitable")
 221       (insert ?\n))))
 222
 223 (defun muse-texinfo-finalize-buffer ()
 224   (goto-char (point-min))
 225   (muse-latex-fixup-dquotes)
 226   (texinfo-insert-node-lines (point-min) (point-max) t)
 227   (texinfo-all-menus-update t))
 228
 229 (defun muse-texinfo-pdf-browse-file (file)
 230   (shell-command (concat "open " file)))
 231
 232 (defun muse-texinfo-info-generate (file output-path final-target)
 233   ;; The version of `texinfmt.el' that comes with Emacs 21 doesn't
 234   ;; support @documentencoding, so hack it in.
 235   (when (and (not (featurep 'xemacs))
 236              (eq emacs-major-version 21))
 237     (put 'documentencoding 'texinfo-format
 238          'texinfo-discard-line-with-args))
 239   (muse-publish-transform-output
 240    file output-path final-target "Info"
 241    (function
 242     (lambda (file output-path)
 243       (if muse-texinfo-process-natively
 244           (save-window-excursion
 245             (save-excursion
 246               (find-file file)
 247               (let ((inhibit-read-only t))
 248                 (texinfo-format-buffer))
 249               (save-buffer)
 250               (kill-buffer (current-buffer))
 251               (let ((buf (get-file-buffer file)))
 252                 (with-current-buffer buf
 253                   (set-buffer-modified-p nil)
 254                   (kill-buffer (current-buffer))))
 255               t))
 256         (= 0 (shell-command
 257               (concat "makeinfo --enable-encoding --output="
 258                       output-path " " file))))))))
 259
 260 (defun muse-texinfo-pdf-generate (file output-path final-target)
 261   (muse-publish-transform-output
 262    file output-path final-target "PDF"
 263    (function
 264     (lambda (file output-path)
 265       (= 0 (shell-command (concat "texi2pdf -q --clean --output="
 266                                   output-path " " file)))))))
 267
 268 (unless (assoc "texi" muse-publishing-styles)
 269   (muse-define-style "texi"
 270                      :suffix    'muse-texinfo-extension
 271                      :regexps   'muse-texinfo-markup-regexps
 272                      :functions 'muse-texinfo-markup-functions
 273                      :strings   'muse-texinfo-markup-strings
 274                      :specials  'muse-texinfo-decide-specials
 275                      :after     'muse-texinfo-finalize-buffer
 276                      :header    'muse-texinfo-header
 277                      :footer    'muse-texinfo-footer
 278                      :browser   'find-file)
 279
 280   (muse-derive-style "info" "texi"
 281                      :final   'muse-texinfo-info-generate
 282                      :link-suffix 'muse-texinfo-info-extension
 283                      :osuffix 'muse-texinfo-info-extension
 284                      :browser 'info)
 285
 286   (muse-derive-style "info-pdf" "texi"
 287                      :final   'muse-texinfo-pdf-generate
 288                      :link-suffix 'muse-texinfo-pdf-extension
 289                      :osuffix 'muse-texinfo-pdf-extension
 290                      :browser 'muse-texinfo-pdf-browse-file))
 291
 292 (provide 'muse-texinfo)
 293
 294 ;;; muse-texinfo.el ends here