2009-06-07 14:27:07 +00:00
|
|
|
;;; org-src.el --- Source code examples in Org
|
|
|
|
;;
|
|
|
|
;; Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009
|
|
|
|
;; Free Software Foundation, Inc.
|
|
|
|
;;
|
|
|
|
;; Author: Carsten Dominik <carsten at orgmode dot org>
|
|
|
|
;; Bastien Guerry <bzg AT altern DOT org>
|
2009-10-27 18:11:09 +00:00
|
|
|
;; Dan Davison <davison at stats dot ox dot ac dot uk>
|
2009-06-07 14:27:07 +00:00
|
|
|
;; Keywords: outlines, hypermedia, calendar, wp
|
|
|
|
;; Homepage: http://orgmode.org
|
2010-01-14 22:06:55 +00:00
|
|
|
;; Version: 6.34b
|
2009-06-07 14:27:07 +00:00
|
|
|
;;
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
;;
|
|
|
|
;; GNU Emacs 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 of the License, or
|
|
|
|
;; (at your option) any later version.
|
|
|
|
|
|
|
|
;; GNU Emacs 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 GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
|
;;
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;; This file contains the code dealing with source code examples in Org-mode.
|
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
|
|
|
|
(require 'org-macs)
|
|
|
|
(require 'org-compat)
|
2009-10-29 15:34:33 +00:00
|
|
|
(eval-when-compile
|
|
|
|
(require 'cl))
|
2009-06-07 14:27:07 +00:00
|
|
|
|
2009-06-07 15:07:07 +00:00
|
|
|
(declare-function org-do-remove-indentation "org" (&optional n))
|
2009-06-11 20:18:47 +00:00
|
|
|
(declare-function org-get-indentation "org" (&optional line))
|
2009-10-29 15:34:33 +00:00
|
|
|
(declare-function org-switch-to-buffer-other-window "org" (&rest args))
|
2009-06-07 15:07:07 +00:00
|
|
|
|
2009-06-07 14:27:07 +00:00
|
|
|
(defcustom org-edit-src-region-extra nil
|
|
|
|
"Additional regexps to identify regions for editing with `org-edit-src-code'.
|
|
|
|
For examples see the function `org-edit-src-find-region-and-lang'.
|
|
|
|
The regular expression identifying the begin marker should end with a newline,
|
|
|
|
and the regexp marking the end line should start with a newline, to make sure
|
|
|
|
there are kept outside the narrowed region."
|
|
|
|
:group 'org-edit-structure
|
|
|
|
:type '(repeat
|
|
|
|
(list
|
|
|
|
(regexp :tag "begin regexp")
|
|
|
|
(regexp :tag "end regexp")
|
|
|
|
(choice :tag "language"
|
|
|
|
(string :tag "specify")
|
|
|
|
(integer :tag "from match group")
|
|
|
|
(const :tag "from `lang' element")
|
|
|
|
(const :tag "from `style' element")))))
|
|
|
|
|
|
|
|
(defcustom org-coderef-label-format "(ref:%s)"
|
|
|
|
"The default coderef format.
|
|
|
|
This format string will be used to search for coderef labels in literal
|
2009-07-23 19:48:43 +00:00
|
|
|
examples (EXAMPLE and SRC blocks). The format can be overwritten in
|
2009-06-07 14:27:07 +00:00
|
|
|
an individual literal example with the -f option, like
|
|
|
|
|
|
|
|
#+BEGIN_SRC pascal +n -r -l \"((%s))\"
|
|
|
|
...
|
|
|
|
#+END_SRC
|
|
|
|
|
|
|
|
If you want to use this for HTML export, make sure that the format does
|
|
|
|
not introduce special font-locking, and avoid the HTML special
|
|
|
|
characters `<', `>', and `&'. The reason for this restriction is that
|
|
|
|
the labels are searched for only after htmlize has done its job."
|
|
|
|
:group 'org-edit-structure ; FIXME this is not in the right group
|
|
|
|
:type 'string)
|
|
|
|
|
|
|
|
(defcustom org-edit-fixed-width-region-mode 'artist-mode
|
|
|
|
"The mode that should be used to edit fixed-width regions.
|
|
|
|
These are the regions where each line starts with a colon."
|
|
|
|
:group 'org-edit-structure
|
|
|
|
:type '(choice
|
|
|
|
(const artist-mode)
|
|
|
|
(const picture-mode)
|
|
|
|
(const fundamental-mode)
|
|
|
|
(function :tag "Other (specify)")))
|
|
|
|
|
2009-10-08 03:49:37 +00:00
|
|
|
(defcustom org-src-preserve-indentation nil
|
|
|
|
"If non-nil, leading whitespace characters in source code
|
2009-11-01 07:43:50 +00:00
|
|
|
blocks are preserved on export, and when switching between the
|
|
|
|
org buffer and the language mode edit buffer. If this variable
|
|
|
|
is nil then, after editing with \\[org-edit-src-code], the
|
|
|
|
minimum (across-lines) number of leading whitespace characters
|
|
|
|
are removed from all lines, and the code block is uniformly
|
|
|
|
indented according to the value of `org-edit-src-content-indentation'."
|
2009-10-08 03:49:37 +00:00
|
|
|
:group 'org-edit-structure
|
|
|
|
:type 'boolean)
|
|
|
|
|
2009-06-08 07:39:19 +00:00
|
|
|
(defcustom org-edit-src-content-indentation 2
|
2009-10-08 03:56:37 +00:00
|
|
|
"Indentation for the content of a source code block.
|
2009-06-08 07:39:19 +00:00
|
|
|
This should be the number of spaces added to the indentation of the #+begin
|
|
|
|
line in order to compute the indentation of the block content after
|
2009-10-08 03:49:37 +00:00
|
|
|
editing it with \\[org-edit-src-code]. Has no effect if
|
|
|
|
`org-src-preserve-indentation' is non-nil."
|
2009-06-08 07:39:19 +00:00
|
|
|
:group 'org-edit-structure
|
|
|
|
:type 'integer)
|
|
|
|
|
2009-06-07 14:27:07 +00:00
|
|
|
(defcustom org-edit-src-persistent-message t
|
|
|
|
"Non-nil means show persistent exit help message while editing src examples.
|
|
|
|
The message is shown in the header-line, which will be created in the
|
|
|
|
first line of the window showing the editing buffer.
|
|
|
|
When nil, the message will only be shown intermittently in the echo area."
|
|
|
|
:group 'org-edit-structure
|
|
|
|
:type 'boolean)
|
|
|
|
|
|
|
|
|
2009-10-27 18:11:09 +00:00
|
|
|
(defcustom org-src-window-setup 'reorganize-frame
|
|
|
|
"How the source code edit buffer should be displayed.
|
|
|
|
Possible values for this option are:
|
|
|
|
|
2009-10-27 19:36:24 +00:00
|
|
|
current-window Show edit buffer in the current window, keeping all other
|
|
|
|
windows.
|
2009-10-27 18:11:09 +00:00
|
|
|
other-window Use `switch-to-buffer-other-window' to display edit buffer.
|
|
|
|
reorganize-frame Show only two windows on the current frame, the current
|
2009-10-27 19:36:24 +00:00
|
|
|
window and the edit buffer. When exiting the edit buffer,
|
|
|
|
return to one window.
|
2009-10-27 18:11:09 +00:00
|
|
|
other-frame Use `switch-to-buffer-other-frame' to display edit buffer.
|
|
|
|
Also, when exiting the edit buffer, kill that frame."
|
|
|
|
:group 'org-edit-structure
|
|
|
|
:type '(choice
|
|
|
|
(const current-window)
|
|
|
|
(const other-frame)
|
|
|
|
(const other-window)
|
|
|
|
(const reorganize-frame)))
|
|
|
|
|
2009-06-08 06:52:25 +00:00
|
|
|
(defvar org-src-mode-hook nil
|
|
|
|
"Hook run after Org switched a source code snippet to its Emacs mode.
|
|
|
|
This hook will run
|
|
|
|
|
|
|
|
- when editing a source code snippet with \"C-c '\".
|
|
|
|
- When formatting a source code snippet for export with htmlize.
|
|
|
|
|
|
|
|
You may want to use this hook for example to turn off `outline-minor-mode'
|
|
|
|
or similar things which you want to have when editing a source code file,
|
|
|
|
but which mess up the display of a snippet in Org exported files.")
|
|
|
|
|
2009-08-23 17:31:47 +00:00
|
|
|
(defcustom org-src-lang-modes
|
2009-09-16 16:54:43 +00:00
|
|
|
'(("ocaml" . tuareg) ("elisp" . emacs-lisp) ("ditaa" . artist)
|
2009-10-14 22:03:13 +00:00
|
|
|
("asymptote" . asy) ("dot" . fundamental))
|
2009-08-23 17:31:47 +00:00
|
|
|
"Alist mapping languages to their major mode.
|
|
|
|
The key is the language name, the value is the string that should
|
|
|
|
be inserted as the name of the major mode. For many languages this is
|
|
|
|
simple, but for language where this is not the case, this variable
|
|
|
|
provides a way to simplify things on the user side.
|
|
|
|
For example, there is no ocaml-mode in Emacs, but the mode to use is
|
|
|
|
`tuareg-mode'."
|
|
|
|
:group 'org-edit-structure
|
|
|
|
:type '(repeat
|
|
|
|
(cons
|
|
|
|
(string "Language name")
|
|
|
|
(symbol "Major mode"))))
|
|
|
|
|
2009-06-07 14:27:07 +00:00
|
|
|
;;; Editing source examples
|
|
|
|
|
2009-06-09 17:23:59 +00:00
|
|
|
(defvar org-src-mode-map (make-sparse-keymap))
|
|
|
|
(define-key org-src-mode-map "\C-c'" 'org-edit-src-exit)
|
2009-06-07 14:27:07 +00:00
|
|
|
(defvar org-edit-src-force-single-line nil)
|
|
|
|
(defvar org-edit-src-from-org-mode nil)
|
|
|
|
(defvar org-edit-src-picture nil)
|
|
|
|
(defvar org-edit-src-beg-marker nil)
|
|
|
|
(defvar org-edit-src-end-marker nil)
|
|
|
|
(defvar org-edit-src-overlay nil)
|
2009-10-08 03:49:37 +00:00
|
|
|
(defvar org-edit-src-block-indentation nil)
|
2009-11-04 01:36:08 +00:00
|
|
|
(defvar org-edit-src-saved-temp-window-config nil)
|
2009-06-07 14:27:07 +00:00
|
|
|
|
2009-10-14 22:43:25 +00:00
|
|
|
(defvar org-src-ask-before-returning-to-edit-buffer t
|
|
|
|
"If nil, when org-edit-src code is used on a block that already
|
|
|
|
has an active edit buffer, it will switch to that edit buffer
|
|
|
|
immediately; otherwise it will ask whether you want to return
|
|
|
|
to the existing edit buffer.")
|
|
|
|
|
2009-06-09 17:23:59 +00:00
|
|
|
(define-minor-mode org-src-mode
|
|
|
|
"Minor mode for language major mode buffers generated by org.
|
|
|
|
This minor mode is turned on in two situations:
|
|
|
|
- when editing a source code snippet with \"C-c '\".
|
|
|
|
- When formatting a source code snippet for export with htmlize.
|
|
|
|
There is a mode hook, and keybindings for `org-edit-src-exit' and
|
|
|
|
`org-edit-src-save'")
|
2009-06-07 14:27:07 +00:00
|
|
|
|
2009-11-08 01:45:50 +00:00
|
|
|
(defun org-edit-src-code (&optional context)
|
2009-06-07 14:27:07 +00:00
|
|
|
"Edit the source code example at point.
|
|
|
|
The example is copied to a separate buffer, and that buffer is switched
|
|
|
|
to the correct language mode. When done, exit with \\[org-edit-src-exit].
|
|
|
|
This will remove the original code in the Org buffer, and replace it with
|
2009-11-08 01:45:50 +00:00
|
|
|
the edited version. Optional argument CONTEXT is used by
|
|
|
|
\\[org-edit-src-save] when calling this function."
|
2009-06-07 14:27:07 +00:00
|
|
|
(interactive)
|
2009-11-08 01:45:50 +00:00
|
|
|
(unless (eq context 'save)
|
|
|
|
(setq org-edit-src-saved-temp-window-config (current-window-configuration)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(let ((line (org-current-line))
|
2009-10-08 03:55:15 +00:00
|
|
|
(col (current-column))
|
2009-06-07 14:27:07 +00:00
|
|
|
(case-fold-search t)
|
|
|
|
(msg (substitute-command-keys
|
|
|
|
"Edit, then exit with C-c ' (C-c and single quote)"))
|
|
|
|
(info (org-edit-src-find-region-and-lang))
|
|
|
|
(org-mode-p (eq major-mode 'org-mode))
|
|
|
|
(beg (make-marker))
|
|
|
|
(end (make-marker))
|
2009-10-08 03:49:37 +00:00
|
|
|
(preserve-indentation org-src-preserve-indentation)
|
|
|
|
block-nindent total-nindent ovl lang lang-f single lfmt code begline buffer)
|
2009-06-07 14:27:07 +00:00
|
|
|
(if (not info)
|
|
|
|
nil
|
|
|
|
(setq beg (move-marker beg (nth 0 info))
|
|
|
|
end (move-marker end (nth 1 info))
|
|
|
|
code (buffer-substring-no-properties beg end)
|
2009-08-23 17:31:47 +00:00
|
|
|
lang (or (cdr (assoc (nth 2 info) org-src-lang-modes))
|
|
|
|
(nth 2 info))
|
|
|
|
lang (if (symbolp lang) (symbol-name lang) lang)
|
2009-06-07 14:27:07 +00:00
|
|
|
single (nth 3 info)
|
|
|
|
lfmt (nth 4 info)
|
2009-10-08 03:49:37 +00:00
|
|
|
block-nindent (nth 5 info)
|
2009-06-07 14:27:07 +00:00
|
|
|
lang-f (intern (concat lang "-mode"))
|
|
|
|
begline (save-excursion (goto-char beg) (org-current-line)))
|
|
|
|
(unless (functionp lang-f)
|
|
|
|
(error "No such language mode: %s" lang-f))
|
2009-08-27 08:24:09 +00:00
|
|
|
(org-goto-line line)
|
2009-06-07 14:27:07 +00:00
|
|
|
(if (and (setq buffer (org-edit-src-find-buffer beg end))
|
2009-10-25 15:06:03 +00:00
|
|
|
(if org-src-ask-before-returning-to-edit-buffer
|
|
|
|
(y-or-n-p "Return to existing edit buffer? [n] will revert changes: ") t))
|
2009-10-27 18:11:09 +00:00
|
|
|
(org-src-switch-to-buffer buffer 'return)
|
2009-06-07 14:27:07 +00:00
|
|
|
(when buffer
|
|
|
|
(with-current-buffer buffer
|
|
|
|
(if (boundp 'org-edit-src-overlay)
|
|
|
|
(org-delete-overlay org-edit-src-overlay)))
|
|
|
|
(kill-buffer buffer))
|
2009-08-24 12:47:58 +00:00
|
|
|
(setq buffer (generate-new-buffer
|
2009-09-06 05:53:21 +00:00
|
|
|
(org-src-construct-edit-buffer-name (buffer-name) lang)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(setq ovl (org-make-overlay beg end))
|
|
|
|
(org-overlay-put ovl 'edit-buffer buffer)
|
|
|
|
(org-overlay-put ovl 'help-echo "Click with mouse-1 to switch to buffer editing this segment")
|
|
|
|
(org-overlay-put ovl 'face 'secondary-selection)
|
|
|
|
(org-overlay-put ovl
|
|
|
|
'keymap
|
|
|
|
(let ((map (make-sparse-keymap)))
|
|
|
|
(define-key map [mouse-1] 'org-edit-src-continue)
|
|
|
|
map))
|
|
|
|
(org-overlay-put ovl :read-only "Leave me alone")
|
2009-10-27 18:11:09 +00:00
|
|
|
(org-src-switch-to-buffer buffer 'edit)
|
2009-10-06 16:42:24 +00:00
|
|
|
(if (eq single 'macro-definition)
|
|
|
|
(setq code (replace-regexp-in-string "\\\\n" "\n" code t t)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(insert code)
|
|
|
|
(remove-text-properties (point-min) (point-max)
|
|
|
|
'(display nil invisible nil intangible nil))
|
2009-10-08 03:49:37 +00:00
|
|
|
(unless preserve-indentation
|
|
|
|
(setq total-nindent (or (org-do-remove-indentation) 0)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(let ((org-inhibit-startup t))
|
2009-08-24 12:47:58 +00:00
|
|
|
(funcall lang-f))
|
2009-06-07 14:27:07 +00:00
|
|
|
(set (make-local-variable 'org-edit-src-force-single-line) single)
|
|
|
|
(set (make-local-variable 'org-edit-src-from-org-mode) org-mode-p)
|
2009-10-08 03:49:37 +00:00
|
|
|
(set (make-local-variable 'org-src-preserve-indentation) preserve-indentation)
|
2009-06-07 14:27:07 +00:00
|
|
|
(when lfmt
|
|
|
|
(set (make-local-variable 'org-coderef-label-format) lfmt))
|
|
|
|
(when org-mode-p
|
|
|
|
(goto-char (point-min))
|
|
|
|
(while (re-search-forward "^," nil t)
|
2009-10-12 16:13:08 +00:00
|
|
|
(if (eq (org-current-line) line) (setq total-nindent (1+ total-nindent)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(replace-match "")))
|
2009-08-27 08:24:09 +00:00
|
|
|
(org-goto-line (1+ (- line begline)))
|
2009-10-08 03:55:15 +00:00
|
|
|
(org-move-to-column
|
|
|
|
(if preserve-indentation col (max 0 (- col total-nindent))))
|
2009-06-07 14:27:07 +00:00
|
|
|
(org-set-local 'org-edit-src-beg-marker beg)
|
|
|
|
(org-set-local 'org-edit-src-end-marker end)
|
|
|
|
(org-set-local 'org-edit-src-overlay ovl)
|
2009-10-08 03:49:37 +00:00
|
|
|
(org-set-local 'org-edit-src-block-indentation block-nindent)
|
2009-08-24 12:47:58 +00:00
|
|
|
(org-src-mode)
|
|
|
|
(set-buffer-modified-p nil)
|
2009-06-07 14:27:07 +00:00
|
|
|
(and org-edit-src-persistent-message
|
|
|
|
(org-set-local 'header-line-format msg)))
|
|
|
|
(message "%s" msg)
|
|
|
|
t)))
|
|
|
|
|
|
|
|
(defun org-edit-src-continue (e)
|
|
|
|
(interactive "e")
|
|
|
|
(mouse-set-point e)
|
|
|
|
(let ((buf (get-char-property (point) 'edit-buffer)))
|
2009-10-27 18:11:09 +00:00
|
|
|
(if buf (org-src-switch-to-buffer buf 'continue)
|
2009-06-07 14:27:07 +00:00
|
|
|
(error "Something is wrong here"))))
|
|
|
|
|
2009-10-27 18:11:09 +00:00
|
|
|
(defun org-src-switch-to-buffer (buffer context)
|
|
|
|
(case org-src-window-setup
|
|
|
|
('current-window
|
|
|
|
(switch-to-buffer buffer))
|
|
|
|
('other-window
|
|
|
|
(switch-to-buffer-other-window buffer))
|
|
|
|
('other-frame
|
|
|
|
(case context
|
|
|
|
('exit
|
|
|
|
(let ((frame (selected-frame)))
|
|
|
|
(switch-to-buffer-other-frame buffer)
|
|
|
|
(delete-frame frame)))
|
|
|
|
('save
|
|
|
|
(kill-buffer (current-buffer))
|
|
|
|
(switch-to-buffer buffer))
|
|
|
|
(t
|
|
|
|
(switch-to-buffer-other-frame buffer))))
|
|
|
|
('reorganize-frame
|
|
|
|
(if (eq context 'edit) (delete-other-windows))
|
|
|
|
(org-switch-to-buffer-other-window buffer)
|
|
|
|
(if (eq context 'exit) (delete-other-windows)))
|
|
|
|
(t
|
|
|
|
(message "Invalid value %s for org-src-window-setup"
|
|
|
|
(symbol-name org-src-window-setup))
|
|
|
|
(switch-to-buffer buffer))))
|
|
|
|
|
2009-09-06 05:53:21 +00:00
|
|
|
(defun org-src-construct-edit-buffer-name (org-buffer-name lang)
|
|
|
|
"Construct the buffer name for a source editing buffer"
|
|
|
|
(concat "*Org Src " org-buffer-name "[ " lang " ]*"))
|
|
|
|
|
2009-06-07 14:27:07 +00:00
|
|
|
(defun org-edit-src-find-buffer (beg end)
|
|
|
|
"Find a source editing buffer that is already editing the region BEG to END."
|
|
|
|
(catch 'exit
|
2009-08-03 15:30:30 +00:00
|
|
|
(mapc
|
2009-06-07 14:27:07 +00:00
|
|
|
(lambda (b)
|
|
|
|
(with-current-buffer b
|
2009-09-09 13:06:42 +00:00
|
|
|
(if (and (string-match "\\`*Org Src " (buffer-name))
|
2009-06-07 14:27:07 +00:00
|
|
|
(local-variable-p 'org-edit-src-beg-marker (current-buffer))
|
|
|
|
(local-variable-p 'org-edit-src-end-marker (current-buffer))
|
|
|
|
(equal beg org-edit-src-beg-marker)
|
|
|
|
(equal end org-edit-src-end-marker))
|
|
|
|
(throw 'exit (current-buffer)))))
|
|
|
|
(buffer-list))
|
|
|
|
nil))
|
|
|
|
|
|
|
|
(defun org-edit-fixed-width-region ()
|
|
|
|
"Edit the fixed-width ascii drawing at point.
|
|
|
|
This must be a region where each line starts with a colon followed by
|
|
|
|
a space character.
|
|
|
|
An new buffer is created and the fixed-width region is copied into it,
|
|
|
|
and the buffer is switched into `artist-mode' for editing. When done,
|
|
|
|
exit with \\[org-edit-src-exit]. The edited text will then replace
|
|
|
|
the fragment in the Org-mode buffer."
|
|
|
|
(interactive)
|
|
|
|
(let ((line (org-current-line))
|
2009-10-08 03:55:15 +00:00
|
|
|
(col (current-column))
|
2009-06-07 14:27:07 +00:00
|
|
|
(case-fold-search t)
|
|
|
|
(msg (substitute-command-keys
|
|
|
|
"Edit, then exit with C-c ' (C-c and single quote)"))
|
|
|
|
(org-mode-p (eq major-mode 'org-mode))
|
|
|
|
(beg (make-marker))
|
|
|
|
(end (make-marker))
|
2009-10-08 03:49:37 +00:00
|
|
|
(preserve-indentation org-src-preserve-indentation)
|
|
|
|
block-nindent ovl beg1 end1 code begline buffer)
|
2009-06-07 14:27:07 +00:00
|
|
|
(beginning-of-line 1)
|
|
|
|
(if (looking-at "[ \t]*[^:\n \t]")
|
|
|
|
nil
|
|
|
|
(if (looking-at "[ \t]*\\(\n\\|\\'\\)")
|
|
|
|
(setq beg1 (point) end1 beg1)
|
|
|
|
(save-excursion
|
2009-06-07 21:10:36 +00:00
|
|
|
(if (re-search-backward "^[ \t]*[^: \t]" nil 'move)
|
2009-06-07 14:27:07 +00:00
|
|
|
(setq beg1 (point-at-bol 2))
|
|
|
|
(setq beg1 (point))))
|
|
|
|
(save-excursion
|
2009-06-07 21:10:36 +00:00
|
|
|
(if (re-search-forward "^[ \t]*[^: \t]" nil 'move)
|
2009-06-07 14:27:07 +00:00
|
|
|
(setq end1 (1- (match-beginning 0)))
|
|
|
|
(setq end1 (point))))
|
2009-08-27 08:24:09 +00:00
|
|
|
(org-goto-line line))
|
2009-06-07 14:27:07 +00:00
|
|
|
(setq beg (move-marker beg beg1)
|
|
|
|
end (move-marker end end1)
|
|
|
|
code (buffer-substring-no-properties beg end)
|
|
|
|
begline (save-excursion (goto-char beg) (org-current-line)))
|
|
|
|
(if (and (setq buffer (org-edit-src-find-buffer beg end))
|
|
|
|
(y-or-n-p "Return to existing edit buffer? [n] will revert changes: "))
|
|
|
|
(switch-to-buffer buffer)
|
|
|
|
(when buffer
|
|
|
|
(with-current-buffer buffer
|
|
|
|
(if (boundp 'org-edit-src-overlay)
|
|
|
|
(org-delete-overlay org-edit-src-overlay)))
|
|
|
|
(kill-buffer buffer))
|
2009-09-06 05:53:21 +00:00
|
|
|
(setq buffer (generate-new-buffer
|
|
|
|
(org-src-construct-edit-buffer-name
|
|
|
|
(buffer-name) "Fixed Width")))
|
2009-06-07 14:27:07 +00:00
|
|
|
(setq ovl (org-make-overlay beg end))
|
|
|
|
(org-overlay-put ovl 'face 'secondary-selection)
|
|
|
|
(org-overlay-put ovl 'edit-buffer buffer)
|
|
|
|
(org-overlay-put ovl 'help-echo "Click with mouse-1 to switch to buffer editing this segment")
|
|
|
|
(org-overlay-put ovl 'face 'secondary-selection)
|
|
|
|
(org-overlay-put ovl
|
|
|
|
'keymap
|
|
|
|
(let ((map (make-sparse-keymap)))
|
|
|
|
(define-key map [mouse-1] 'org-edit-src-continue)
|
|
|
|
map))
|
|
|
|
(org-overlay-put ovl :read-only "Leave me alone")
|
|
|
|
(switch-to-buffer buffer)
|
|
|
|
(insert code)
|
|
|
|
(remove-text-properties (point-min) (point-max)
|
|
|
|
'(display nil invisible nil intangible nil))
|
2009-10-08 03:49:37 +00:00
|
|
|
(setq block-nindent (or (org-do-remove-indentation) 0))
|
2009-06-07 14:27:07 +00:00
|
|
|
(cond
|
|
|
|
((eq org-edit-fixed-width-region-mode 'artist-mode)
|
|
|
|
(fundamental-mode)
|
|
|
|
(artist-mode 1))
|
|
|
|
(t (funcall org-edit-fixed-width-region-mode)))
|
|
|
|
(set (make-local-variable 'org-edit-src-force-single-line) nil)
|
|
|
|
(set (make-local-variable 'org-edit-src-from-org-mode) org-mode-p)
|
|
|
|
(set (make-local-variable 'org-edit-src-picture) t)
|
|
|
|
(goto-char (point-min))
|
|
|
|
(while (re-search-forward "^[ \t]*: ?" nil t)
|
|
|
|
(replace-match ""))
|
2009-08-27 08:24:09 +00:00
|
|
|
(org-goto-line (1+ (- line begline)))
|
2009-10-08 03:55:15 +00:00
|
|
|
(org-move-to-column (max 0 (- col block-nindent 2)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(org-set-local 'org-edit-src-beg-marker beg)
|
|
|
|
(org-set-local 'org-edit-src-end-marker end)
|
|
|
|
(org-set-local 'org-edit-src-overlay ovl)
|
2009-10-08 03:49:37 +00:00
|
|
|
(org-set-local 'org-edit-src-block-indentation block-nindent)
|
|
|
|
(org-set-local 'org-edit-src-content-indentation 0)
|
|
|
|
(org-set-local 'org-src-preserve-indentation nil)
|
2009-08-31 16:41:06 +00:00
|
|
|
(org-src-mode)
|
|
|
|
(set-buffer-modified-p nil)
|
2009-06-07 14:27:07 +00:00
|
|
|
(and org-edit-src-persistent-message
|
|
|
|
(org-set-local 'header-line-format msg)))
|
|
|
|
(message "%s" msg)
|
|
|
|
t)))
|
|
|
|
|
|
|
|
(defun org-edit-src-find-region-and-lang ()
|
|
|
|
"Find the region and language for a local edit.
|
|
|
|
Return a list with beginning and end of the region, a string representing
|
2009-10-08 03:56:37 +00:00
|
|
|
the language, a switch telling if the content should be in a single line."
|
2009-06-07 14:27:07 +00:00
|
|
|
(let ((re-list
|
|
|
|
(append
|
|
|
|
org-edit-src-region-extra
|
|
|
|
'(
|
|
|
|
("<src\\>[^<]*>[ \t]*\n?" "\n?[ \t]*</src>" lang)
|
|
|
|
("<literal\\>[^<]*>[ \t]*\n?" "\n?[ \t]*</literal>" style)
|
|
|
|
("<example>[ \t]*\n?" "\n?[ \t]*</example>" "fundamental")
|
|
|
|
("<lisp>[ \t]*\n?" "\n?[ \t]*</lisp>" "emacs-lisp")
|
|
|
|
("<perl>[ \t]*\n?" "\n?[ \t]*</perl>" "perl")
|
|
|
|
("<python>[ \t]*\n?" "\n?[ \t]*</python>" "python")
|
|
|
|
("<ruby>[ \t]*\n?" "\n?[ \t]*</ruby>" "ruby")
|
|
|
|
("^[ \t]*#\\+begin_src\\( \\([^ \t\n]+\\)\\)?.*\n" "\n[ \t]*#\\+end_src" 2)
|
|
|
|
("^[ \t]*#\\+begin_example.*\n" "\n[ \t]*#\\+end_example" "fundamental")
|
|
|
|
("^[ \t]*#\\+html:" "\n" "html" single-line)
|
|
|
|
("^[ \t]*#\\+begin_html.*\n" "\n[ \t]*#\\+end_html" "html")
|
|
|
|
("^[ \t]*#\\+latex:" "\n" "latex" single-line)
|
|
|
|
("^[ \t]*#\\+begin_latex.*\n" "\n[ \t]*#\\+end_latex" "latex")
|
|
|
|
("^[ \t]*#\\+ascii:" "\n" "fundamental" single-line)
|
|
|
|
("^[ \t]*#\\+begin_ascii.*\n" "\n[ \t]*#\\+end_ascii" "fundamental")
|
|
|
|
("^[ \t]*#\\+docbook:" "\n" "xml" single-line)
|
2009-10-06 16:42:24 +00:00
|
|
|
("^[ \t]*#\\+macro:[ \t]+\\S-+\\( \\|$\\)"
|
|
|
|
"\n" "fundamental" macro-definition)
|
2009-06-07 14:27:07 +00:00
|
|
|
("^[ \t]*#\\+begin_docbook.*\n" "\n[ \t]*#\\+end_docbook" "xml")
|
|
|
|
)))
|
|
|
|
(pos (point))
|
2009-06-07 15:07:07 +00:00
|
|
|
re1 re2 single beg end lang lfmt match-re1 ind entry)
|
2009-06-07 14:27:07 +00:00
|
|
|
(catch 'exit
|
|
|
|
(while (setq entry (pop re-list))
|
|
|
|
(setq re1 (car entry) re2 (nth 1 entry) lang (nth 2 entry)
|
|
|
|
single (nth 3 entry))
|
|
|
|
(save-excursion
|
|
|
|
(if (or (looking-at re1)
|
|
|
|
(re-search-backward re1 nil t))
|
|
|
|
(progn
|
|
|
|
(setq match-re1 (match-string 0))
|
|
|
|
(setq beg (match-end 0)
|
|
|
|
lang (org-edit-src-get-lang lang)
|
2009-06-07 21:10:36 +00:00
|
|
|
lfmt (org-edit-src-get-label-format match-re1)
|
|
|
|
ind (org-edit-src-get-indentation (match-beginning 0)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(if (and (re-search-forward re2 nil t)
|
|
|
|
(>= (match-end 0) pos))
|
|
|
|
(throw 'exit (list beg (match-beginning 0)
|
2009-06-07 21:10:36 +00:00
|
|
|
lang single lfmt ind))))
|
2009-06-07 14:27:07 +00:00
|
|
|
(if (or (looking-at re2)
|
|
|
|
(re-search-forward re2 nil t))
|
|
|
|
(progn
|
|
|
|
(setq end (match-beginning 0))
|
|
|
|
(if (and (re-search-backward re1 nil t)
|
|
|
|
(<= (match-beginning 0) pos))
|
|
|
|
(progn
|
|
|
|
(setq lfmt (org-edit-src-get-label-format
|
2009-06-07 21:10:36 +00:00
|
|
|
(match-string 0))
|
|
|
|
ind (org-edit-src-get-indentation
|
|
|
|
(match-beginning 0)))
|
2009-06-07 14:27:07 +00:00
|
|
|
(throw 'exit
|
|
|
|
(list (match-end 0) end
|
|
|
|
(org-edit-src-get-lang lang)
|
2009-06-07 21:10:36 +00:00
|
|
|
single lfmt ind))))))))))))
|
2009-06-07 14:27:07 +00:00
|
|
|
|
|
|
|
(defun org-edit-src-get-lang (lang)
|
|
|
|
"Extract the src language."
|
|
|
|
(let ((m (match-string 0)))
|
|
|
|
(cond
|
|
|
|
((stringp lang) lang)
|
|
|
|
((integerp lang) (match-string lang))
|
|
|
|
((and (eq lang 'lang)
|
|
|
|
(string-match "\\<lang=\"\\([^ \t\n\"]+\\)\"" m))
|
|
|
|
(match-string 1 m))
|
|
|
|
((and (eq lang 'style)
|
|
|
|
(string-match "\\<style=\"\\([^ \t\n\"]+\\)\"" m))
|
|
|
|
(match-string 1 m))
|
|
|
|
(t "fundamental"))))
|
|
|
|
|
|
|
|
(defun org-edit-src-get-label-format (s)
|
|
|
|
"Extract the label format."
|
|
|
|
(save-match-data
|
|
|
|
(if (string-match "-l[ \t]+\\\\?\"\\([^\t\r\n\"]+\\)\\\\?\"" s)
|
|
|
|
(match-string 1 s))))
|
|
|
|
|
2009-06-07 21:10:36 +00:00
|
|
|
(defun org-edit-src-get-indentation (pos)
|
2009-10-08 03:56:37 +00:00
|
|
|
"Count leading whitespace characters on line"
|
2009-06-07 21:10:36 +00:00
|
|
|
(save-match-data
|
|
|
|
(goto-char pos)
|
|
|
|
(org-get-indentation)))
|
|
|
|
|
2009-10-27 18:11:09 +00:00
|
|
|
(defun org-edit-src-exit (&optional context)
|
2009-06-07 14:27:07 +00:00
|
|
|
"Exit special edit and protect problematic lines."
|
|
|
|
(interactive)
|
2009-08-24 12:47:58 +00:00
|
|
|
(unless org-edit-src-from-org-mode
|
|
|
|
(error "This is not a sub-editing buffer, something is wrong..."))
|
2009-10-06 16:42:24 +00:00
|
|
|
(let* ((beg org-edit-src-beg-marker)
|
|
|
|
(end org-edit-src-end-marker)
|
|
|
|
(ovl org-edit-src-overlay)
|
|
|
|
(buffer (current-buffer))
|
|
|
|
(single (org-bound-and-true-p org-edit-src-force-single-line))
|
|
|
|
(macro (eq single 'macro-definition))
|
2009-10-08 03:49:37 +00:00
|
|
|
(total-nindent (+ (or org-edit-src-block-indentation 0)
|
|
|
|
org-edit-src-content-indentation))
|
|
|
|
(preserve-indentation org-src-preserve-indentation)
|
2009-10-12 16:13:08 +00:00
|
|
|
(delta 0) code line col indent)
|
2009-07-06 14:08:49 +00:00
|
|
|
(untabify (point-min) (point-max))
|
2009-06-09 18:19:13 +00:00
|
|
|
(save-excursion
|
|
|
|
(goto-char (point-min))
|
|
|
|
(if (looking-at "[ \t\n]*\n") (replace-match ""))
|
2009-10-06 16:42:24 +00:00
|
|
|
(unless macro
|
|
|
|
(if (re-search-forward "\n[ \t\n]*\\'" nil t) (replace-match ""))))
|
2009-06-09 18:19:13 +00:00
|
|
|
(setq line (if (org-bound-and-true-p org-edit-src-force-single-line)
|
|
|
|
1
|
2009-10-08 03:55:15 +00:00
|
|
|
(org-current-line))
|
|
|
|
col (current-column))
|
2009-10-06 16:42:24 +00:00
|
|
|
(when single
|
2009-06-09 18:19:13 +00:00
|
|
|
(goto-char (point-min))
|
2009-10-06 16:42:24 +00:00
|
|
|
(if (re-search-forward "\\s-+\\'" nil t) (replace-match ""))
|
2009-06-09 18:19:13 +00:00
|
|
|
(goto-char (point-min))
|
2009-10-06 16:42:24 +00:00
|
|
|
(let ((cnt 0))
|
|
|
|
(while (re-search-forward "\n" nil t)
|
|
|
|
(setq cnt (1+ cnt))
|
|
|
|
(replace-match (if macro "\\n" " ") t t))
|
|
|
|
(when (and macro (> cnt 0))
|
|
|
|
(goto-char (point-max)) (insert "\\n")))
|
|
|
|
(goto-char (point-min))
|
|
|
|
(if (looking-at "\\s-*") (replace-match " ")))
|
2009-06-09 18:19:13 +00:00
|
|
|
(when (org-bound-and-true-p org-edit-src-from-org-mode)
|
|
|
|
(goto-char (point-min))
|
|
|
|
(while (re-search-forward
|
|
|
|
(if (org-mode-p) "^\\(.\\)" "^\\([*]\\|[ \t]*#\\+\\)") nil t)
|
2009-10-12 16:13:08 +00:00
|
|
|
(if (eq (org-current-line) line) (setq delta (1+ delta)))
|
2009-06-09 18:19:13 +00:00
|
|
|
(replace-match ",\\1")))
|
|
|
|
(when (org-bound-and-true-p org-edit-src-picture)
|
2009-10-08 03:49:37 +00:00
|
|
|
(setq preserve-indentation nil)
|
2009-06-09 18:19:13 +00:00
|
|
|
(untabify (point-min) (point-max))
|
|
|
|
(goto-char (point-min))
|
|
|
|
(while (re-search-forward "^" nil t)
|
|
|
|
(replace-match ": ")))
|
2009-10-08 03:49:37 +00:00
|
|
|
(unless (or single preserve-indentation (= total-nindent 0))
|
|
|
|
(setq indent (make-string total-nindent ?\ ))
|
2009-06-09 18:19:13 +00:00
|
|
|
(goto-char (point-min))
|
|
|
|
(while (re-search-forward "^" nil t)
|
2009-10-08 03:49:37 +00:00
|
|
|
(replace-match indent)))
|
|
|
|
(if (org-bound-and-true-p org-edit-src-picture)
|
|
|
|
(setq total-nindent (+ total-nindent 2)))
|
2009-06-09 18:19:13 +00:00
|
|
|
(setq code (buffer-string))
|
2009-08-24 12:47:58 +00:00
|
|
|
(set-buffer-modified-p nil)
|
2009-10-27 18:11:09 +00:00
|
|
|
(org-src-switch-to-buffer (marker-buffer beg) (or context 'exit))
|
2009-06-09 18:19:13 +00:00
|
|
|
(kill-buffer buffer)
|
|
|
|
(goto-char beg)
|
|
|
|
(delete-region beg end)
|
|
|
|
(insert code)
|
|
|
|
(goto-char beg)
|
2009-10-06 16:42:24 +00:00
|
|
|
(if single (just-one-space))
|
2009-08-27 08:24:09 +00:00
|
|
|
(org-goto-line (1- (+ (org-current-line) line)))
|
2009-10-12 16:13:08 +00:00
|
|
|
(org-move-to-column (if preserve-indentation col (+ col total-nindent delta)))
|
2009-06-09 18:19:13 +00:00
|
|
|
(move-marker beg nil)
|
2009-11-04 01:36:08 +00:00
|
|
|
(move-marker end nil))
|
2009-11-08 01:45:50 +00:00
|
|
|
(unless (eq context 'save)
|
|
|
|
(when org-edit-src-saved-temp-window-config
|
|
|
|
(set-window-configuration org-edit-src-saved-temp-window-config)
|
|
|
|
(setq org-edit-src-saved-temp-window-config nil))))
|
2009-06-07 14:27:07 +00:00
|
|
|
|
|
|
|
(defun org-edit-src-save ()
|
|
|
|
"Save parent buffer with current state source-code buffer."
|
|
|
|
(interactive)
|
2009-10-25 16:33:25 +00:00
|
|
|
(let ((p (point)) (m (mark)) msg)
|
|
|
|
(save-window-excursion
|
2009-10-27 18:11:09 +00:00
|
|
|
(org-edit-src-exit 'save)
|
2009-09-06 05:53:21 +00:00
|
|
|
(save-buffer)
|
|
|
|
(setq msg (current-message))
|
2009-10-27 18:11:09 +00:00
|
|
|
(if (eq org-src-window-setup 'other-frame)
|
|
|
|
(let ((org-src-window-setup 'current-window))
|
2009-11-08 01:45:50 +00:00
|
|
|
(org-edit-src-code 'save))
|
|
|
|
(org-edit-src-code 'save)))
|
2009-10-25 16:33:25 +00:00
|
|
|
(push-mark m 'nomessage)
|
|
|
|
(goto-char (min p (point-max)))
|
|
|
|
(message (or msg ""))))
|
2009-06-07 14:27:07 +00:00
|
|
|
|
2009-08-24 12:47:58 +00:00
|
|
|
(defun org-src-mode-configure-edit-buffer ()
|
|
|
|
(when org-edit-src-from-org-mode
|
|
|
|
(setq buffer-offer-save t)
|
|
|
|
(setq buffer-file-name
|
|
|
|
(concat (buffer-file-name (marker-buffer org-edit-src-beg-marker))
|
|
|
|
"[" (buffer-name) "]"))
|
|
|
|
(set (if (featurep 'xemacs) 'write-contents-hooks 'write-contents-functions)
|
|
|
|
'(org-edit-src-save))
|
|
|
|
(org-add-hook 'kill-buffer-hook
|
|
|
|
'(lambda () (org-delete-overlay org-edit-src-overlay)) nil 'local)))
|
|
|
|
|
|
|
|
(org-add-hook 'org-src-mode-hook 'org-src-mode-configure-edit-buffer)
|
|
|
|
|
2009-06-07 14:27:07 +00:00
|
|
|
(provide 'org-src)
|
|
|
|
|
|
|
|
;; arch-tag: 6a1fc84f-dec7-47be-a416-64be56bea5d8
|
|
|
|
;;; org-src.el ends here
|