1 ;;; ox-ascii.el --- ASCII Back-End for Org Export Engine
3 ;; Copyright (C) 2012-2015 Free Software Foundation, Inc.
5 ;; Author: Nicolas Goaziou <n.goaziou at gmail dot com>
6 ;; Keywords: outlines, hypermedia, calendar, wp
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;; This library implements an ASCII back-end for Org generic exporter.
26 ;; See Org manual for more information.
30 (eval-when-compile (require 'cl
))
34 (declare-function aa2u
"ext:ascii-art-to-unicode" ())
38 ;; The following setting won't allow to modify preferred charset
39 ;; through a buffer keyword or an option item, but, since the property
40 ;; will appear in communication channel nonetheless, it allows to
41 ;; override `org-ascii-charset' variable on the fly by the ext-plist
44 ;; We also install a filter for headlines and sections, in order to
45 ;; control blank lines separating them in output string.
47 (org-export-define-backend 'ascii
48 '((bold . org-ascii-bold
)
49 (center-block . org-ascii-center-block
)
50 (clock . org-ascii-clock
)
51 (code . org-ascii-code
)
52 (comment .
(lambda (&rest args
) ""))
53 (comment-block .
(lambda (&rest args
) ""))
54 (drawer . org-ascii-drawer
)
55 (dynamic-block . org-ascii-dynamic-block
)
56 (entity . org-ascii-entity
)
57 (example-block . org-ascii-example-block
)
58 (export-block . org-ascii-export-block
)
59 (export-snippet . org-ascii-export-snippet
)
60 (fixed-width . org-ascii-fixed-width
)
61 (footnote-reference . org-ascii-footnote-reference
)
62 (headline . org-ascii-headline
)
63 (horizontal-rule . org-ascii-horizontal-rule
)
64 (inline-src-block . org-ascii-inline-src-block
)
65 (inlinetask . org-ascii-inlinetask
)
66 (inner-template . org-ascii-inner-template
)
67 (italic . org-ascii-italic
)
68 (item . org-ascii-item
)
69 (keyword . org-ascii-keyword
)
70 (latex-environment . org-ascii-latex-environment
)
71 (latex-fragment . org-ascii-latex-fragment
)
72 (line-break . org-ascii-line-break
)
73 (link . org-ascii-link
)
74 (node-property . org-ascii-node-property
)
75 (paragraph . org-ascii-paragraph
)
76 (plain-list . org-ascii-plain-list
)
77 (plain-text . org-ascii-plain-text
)
78 (planning . org-ascii-planning
)
79 (property-drawer . org-ascii-property-drawer
)
80 (quote-block . org-ascii-quote-block
)
81 (radio-target . org-ascii-radio-target
)
82 (section . org-ascii-section
)
83 (special-block . org-ascii-special-block
)
84 (src-block . org-ascii-src-block
)
85 (statistics-cookie . org-ascii-statistics-cookie
)
86 (strike-through . org-ascii-strike-through
)
87 (subscript . org-ascii-subscript
)
88 (superscript . org-ascii-superscript
)
89 (table . org-ascii-table
)
90 (table-cell . org-ascii-table-cell
)
91 (table-row . org-ascii-table-row
)
92 (target . org-ascii-target
)
93 (template . org-ascii-template
)
94 (timestamp . org-ascii-timestamp
)
95 (underline . org-ascii-underline
)
96 (verbatim . org-ascii-verbatim
)
97 (verse-block . org-ascii-verse-block
))
100 '(?t
"Export to Plain Text"
101 ((?A
"As ASCII buffer"
103 (org-ascii-export-as-ascii a s v b
'(:ascii-charset ascii
))))
106 (org-ascii-export-to-ascii a s v b
'(:ascii-charset ascii
))))
107 (?L
"As Latin1 buffer"
109 (org-ascii-export-as-ascii a s v b
'(:ascii-charset latin1
))))
112 (org-ascii-export-to-ascii a s v b
'(:ascii-charset latin1
))))
113 (?U
"As UTF-8 buffer"
115 (org-ascii-export-as-ascii a s v b
'(:ascii-charset utf-8
))))
118 (org-ascii-export-to-ascii a s v b
'(:ascii-charset utf-8
))))))
119 :filters-alist
'((:filter-headline . org-ascii-filter-headline-blank-lines
)
120 (:filter-parse-tree org-ascii-filter-paragraph-spacing
121 org-ascii-filter-comment-spacing
)
122 (:filter-section . org-ascii-filter-headline-blank-lines
))
124 '((:ascii-bullets nil nil org-ascii-bullets
)
125 (:ascii-caption-above nil nil org-ascii-caption-above
)
126 (:ascii-charset nil nil org-ascii-charset
)
127 (:ascii-global-margin nil nil org-ascii-global-margin
)
128 (:ascii-format-drawer-function nil nil org-ascii-format-drawer-function
)
129 (:ascii-format-inlinetask-function
130 nil nil org-ascii-format-inlinetask-function
)
131 (:ascii-headline-spacing nil nil org-ascii-headline-spacing
)
132 (:ascii-indented-line-width nil nil org-ascii-indented-line-width
)
133 (:ascii-inlinetask-width nil nil org-ascii-inlinetask-width
)
134 (:ascii-inner-margin nil nil org-ascii-inner-margin
)
135 (:ascii-links-to-notes nil nil org-ascii-links-to-notes
)
136 (:ascii-list-margin nil nil org-ascii-list-margin
)
137 (:ascii-paragraph-spacing nil nil org-ascii-paragraph-spacing
)
138 (:ascii-quote-margin nil nil org-ascii-quote-margin
)
139 (:ascii-table-keep-all-vertical-lines
140 nil nil org-ascii-table-keep-all-vertical-lines
)
141 (:ascii-table-use-ascii-art nil nil org-ascii-table-use-ascii-art
)
142 (:ascii-table-widen-columns nil nil org-ascii-table-widen-columns
)
143 (:ascii-text-width nil nil org-ascii-text-width
)
144 (:ascii-underline nil nil org-ascii-underline
)
145 (:ascii-verbatim-format nil nil org-ascii-verbatim-format
)))
149 ;;; User Configurable Variables
151 (defgroup org-export-ascii nil
152 "Options for exporting Org mode files to ASCII."
153 :tag
"Org Export ASCII"
156 (defcustom org-ascii-text-width
72
157 "Maximum width of exported text.
158 This number includes margin size, as set in
159 `org-ascii-global-margin'."
160 :group
'org-export-ascii
162 :package-version
'(Org .
"8.0")
165 (defcustom org-ascii-global-margin
0
166 "Width of the left margin, in number of characters."
167 :group
'org-export-ascii
169 :package-version
'(Org .
"8.0")
172 (defcustom org-ascii-inner-margin
2
173 "Width of the inner margin, in number of characters.
174 Inner margin is applied between each headline."
175 :group
'org-export-ascii
177 :package-version
'(Org .
"8.0")
180 (defcustom org-ascii-quote-margin
6
181 "Width of margin used for quoting text, in characters.
182 This margin is applied on both sides of the text."
183 :group
'org-export-ascii
185 :package-version
'(Org .
"8.0")
188 (defcustom org-ascii-list-margin
0
189 "Width of margin used for plain lists, in characters.
190 This margin applies to top level list only, not to its
192 :group
'org-export-ascii
194 :package-version
'(Org .
"8.3")
197 (defcustom org-ascii-inlinetask-width
30
198 "Width of inline tasks, in number of characters.
199 This number ignores any margin."
200 :group
'org-export-ascii
202 :package-version
'(Org .
"8.0")
205 (defcustom org-ascii-headline-spacing
'(1 .
2)
206 "Number of blank lines inserted around headlines.
208 This variable can be set to a cons cell. In that case, its car
209 represents the number of blank lines present before headline
210 contents whereas its cdr reflects the number of blank lines after
213 A nil value replicates the number of blank lines found in the
214 original Org buffer at the same place."
215 :group
'org-export-ascii
217 :package-version
'(Org .
"8.0")
219 (const :tag
"Replicate original spacing" nil
)
220 (cons :tag
"Set an uniform spacing"
221 (integer :tag
"Number of blank lines before contents")
222 (integer :tag
"Number of blank lines after contents"))))
224 (defcustom org-ascii-indented-line-width
'auto
225 "Additional indentation width for the first line in a paragraph.
226 If the value is an integer, indent the first line of each
227 paragraph by this width, unless it is located at the beginning of
228 a section, in which case indentation is removed from that line.
229 If it is the symbol `auto' preserve indentation from original
231 :group
'org-export-ascii
233 :package-version
'(Org .
"8.0")
235 (integer :tag
"Number of white spaces characters")
236 (const :tag
"Preserve original width" auto
)))
238 (defcustom org-ascii-paragraph-spacing
'auto
239 "Number of white lines between paragraphs.
240 If the value is an integer, add this number of blank lines
241 between contiguous paragraphs. If is it the symbol `auto', keep
242 the same number of blank lines as in the original document."
243 :group
'org-export-ascii
245 :package-version
'(Org .
"8.0")
247 (integer :tag
"Number of blank lines")
248 (const :tag
"Preserve original spacing" auto
)))
250 (defcustom org-ascii-charset
'ascii
251 "The charset allowed to represent various elements and objects.
253 `ascii' Only use plain ASCII characters
254 `latin1' Include Latin-1 characters
255 `utf-8' Use all UTF-8 characters"
256 :group
'org-export-ascii
258 :package-version
'(Org .
"8.0")
260 (const :tag
"ASCII" ascii
)
261 (const :tag
"Latin-1" latin1
)
262 (const :tag
"UTF-8" utf-8
)))
264 (defcustom org-ascii-underline
'((ascii ?
= ?~ ?-
)
266 (utf-8 ?═ ?─ ?╌ ?┄ ?┈
))
267 "Characters for underlining headings in ASCII export.
269 Alist whose key is a symbol among `ascii', `latin1' and `utf-8'
270 and whose value is a list of characters.
272 For each supported charset, this variable associates a sequence
273 of underline characters. In a sequence, the characters will be
274 used in order for headlines level 1, 2, ... If no character is
275 available for a given level, the headline won't be underlined."
276 :group
'org-export-ascii
278 :package-version
'(Org .
"8.0")
280 (cons :tag
"Underline characters sequence"
281 (const :tag
"ASCII charset" ascii
)
283 (cons :tag
"Underline characters sequence"
284 (const :tag
"Latin-1 charset" latin1
)
286 (cons :tag
"Underline characters sequence"
287 (const :tag
"UTF-8 charset" utf-8
)
288 (repeat character
))))
290 (defcustom org-ascii-bullets
'((ascii ?
* ?
+ ?-
)
293 "Bullet characters for headlines converted to lists in ASCII export.
295 Alist whose key is a symbol among `ascii', `latin1' and `utf-8'
296 and whose value is a list of characters.
298 The first character is used for the first level considered as low
299 level, and so on. If there are more levels than characters given
300 here, the list will be repeated.
302 Note that this variable doesn't affect plain lists
304 :group
'org-export-ascii
306 :package-version
'(Org .
"8.0")
308 (cons :tag
"Bullet characters for low level headlines"
309 (const :tag
"ASCII charset" ascii
)
311 (cons :tag
"Bullet characters for low level headlines"
312 (const :tag
"Latin-1 charset" latin1
)
314 (cons :tag
"Bullet characters for low level headlines"
315 (const :tag
"UTF-8 charset" utf-8
)
316 (repeat character
))))
318 (defcustom org-ascii-links-to-notes t
319 "Non-nil means convert links to notes before the next headline.
320 When nil, the link will be exported in place. If the line
321 becomes long in this way, it will be wrapped."
322 :group
'org-export-ascii
324 :package-version
'(Org .
"8.0")
327 (defcustom org-ascii-table-keep-all-vertical-lines nil
328 "Non-nil means keep all vertical lines in ASCII tables.
329 When nil, vertical lines will be removed except for those needed
330 for column grouping."
331 :group
'org-export-ascii
333 :package-version
'(Org .
"8.0")
336 (defcustom org-ascii-table-widen-columns t
337 "Non-nil means widen narrowed columns for export.
338 When nil, narrowed columns will look in ASCII export just like in
339 Org mode, i.e. with \"=>\" as ellipsis."
340 :group
'org-export-ascii
342 :package-version
'(Org .
"8.0")
345 (defcustom org-ascii-table-use-ascii-art nil
346 "Non-nil means table.el tables are turned into ascii-art.
348 It only makes sense when export charset is `utf-8'. It is nil by
349 default since it requires ascii-art-to-unicode.el package. You
350 can download it here:
352 http://gnuvola.org/software/j/aa2u/ascii-art-to-unicode.el."
353 :group
'org-export-ascii
355 :package-version
'(Org .
"8.0")
358 (defcustom org-ascii-caption-above nil
359 "When non-nil, place caption string before the element.
360 Otherwise, place it right after it."
361 :group
'org-export-ascii
363 :package-version
'(Org .
"8.0")
366 (defcustom org-ascii-verbatim-format
"`%s'"
367 "Format string used for verbatim text and inline code."
368 :group
'org-export-ascii
370 :package-version
'(Org .
"8.0")
373 (defcustom org-ascii-format-drawer-function
374 (lambda (name contents width
) contents
)
375 "Function called to format a drawer in ASCII.
377 The function must accept three parameters:
378 NAME the drawer name, like \"LOGBOOK\"
379 CONTENTS the contents of the drawer.
380 WIDTH the text width within the drawer.
382 The function should return either the string to be exported or
383 nil to ignore the drawer.
385 The default value simply returns the value of CONTENTS."
386 :group
'org-export-ascii
388 :package-version
'(Org .
"8.0")
391 (defcustom org-ascii-format-inlinetask-function
392 'org-ascii-format-inlinetask-default
393 "Function called to format an inlinetask in ASCII.
395 The function must accept nine parameters:
396 TODO the todo keyword, as a string
397 TODO-TYPE the todo type, a symbol among `todo', `done' and nil.
398 PRIORITY the inlinetask priority, as a string
399 NAME the inlinetask name, as a string.
400 TAGS the inlinetask tags, as a list of strings.
401 CONTENTS the contents of the inlinetask, as a string.
402 WIDTH the width of the inlinetask, as a number.
403 INLINETASK the inlinetask itself.
404 INFO the info channel.
406 The function should return either the string to be exported or
407 nil to ignore the inline task."
408 :group
'org-export-ascii
410 :package-version
'(Org .
"8.3")
415 ;;; Internal Functions
417 ;; Internal functions fall into three categories.
419 ;; The first one is about text formatting. The core functions are
420 ;; `org-ascii--current-text-width' and
421 ;; `org-ascii--current-justification', which determine, respectively,
422 ;; the current text width allowed to a given element and its expected
423 ;; justification. Once this information is known,
424 ;; `org-ascii--fill-string', `org-ascii--justify-lines',
425 ;; `org-ascii--justify-element' `org-ascii--box-string' and
426 ;; `org-ascii--indent-string' can operate on a given output string.
427 ;; In particular, justification happens at the regular (i.e.,
428 ;; non-greater) element level, which means that when the exporting
429 ;; process reaches a container (e.g., a center block) content are
430 ;; already justified.
432 ;; The second category contains functions handling elements listings,
433 ;; triggered by "#+TOC:" keyword. As such, `org-ascii--build-toc'
434 ;; returns a complete table of contents, `org-ascii--list-listings'
435 ;; returns a list of referenceable src-block elements, and
436 ;; `org-ascii--list-tables' does the same for table elements.
438 ;; The third category includes general helper functions.
439 ;; `org-ascii--build-title' creates the title for a given headline
440 ;; or inlinetask element. `org-ascii--build-caption' returns the
441 ;; caption string associated to a table or a src-block.
442 ;; `org-ascii--describe-links' creates notes about links for
443 ;; insertion at the end of a section. It uses
444 ;; `org-ascii--unique-links' to get the list of links to describe.
445 ;; Eventually, `org-ascii--translate' translates a string according
446 ;; to language and charset specification.
449 (defun org-ascii--fill-string (s text-width info
&optional justify
)
450 "Fill a string with specified text-width and return it.
452 S is the string being filled. TEXT-WIDTH is an integer
453 specifying maximum length of a line. INFO is the plist used as
454 a communication channel.
456 Optional argument JUSTIFY can specify any type of justification
457 among `left', `center', `right' or `full'. A nil value is
458 equivalent to `left'. For a justification that doesn't also fill
459 string, see `org-ascii--justify-lines' and
460 `org-ascii--justify-block'.
462 Return nil if S isn't a string."
464 (let ((double-space-p sentence-end-double-space
))
466 (let ((fill-column text-width
)
467 (use-hard-newlines t
)
468 (sentence-end-double-space double-space-p
))
469 (insert (if (plist-get info
:preserve-breaks
)
470 (replace-regexp-in-string "\n" hard-newline s
)
472 (fill-region (point-min) (point-max) justify
))
475 (defun org-ascii--justify-lines (s text-width how
)
476 "Justify all lines in string S.
477 TEXT-WIDTH is an integer specifying maximum length of a line.
478 HOW determines the type of justification: it can be `left',
479 `right', `full' or `center'."
482 (goto-char (point-min))
483 (let ((fill-column text-width
)
484 ;; Disable `adaptive-fill-mode' so it doesn't prevent
485 ;; filling lines matching `adaptive-fill-regexp'.
486 (adaptive-fill-mode nil
))
487 (while (< (point) (point-max))
488 (justify-current-line how
)
492 (defun org-ascii--justify-element (contents element info
)
493 "Justify CONTENTS of ELEMENT.
494 INFO is a plist used as a communication channel. Justification
495 is done according to the type of element. More accurately,
496 paragraphs are filled and other elements are justified as blocks,
497 that is according to the widest non blank line in CONTENTS."
498 (if (not (org-string-nw-p contents
)) contents
499 (let ((text-width (org-ascii--current-text-width element info
))
500 (how (org-ascii--current-justification element
)))
502 ((eq (org-element-type element
) 'paragraph
)
503 ;; Paragraphs are treated specially as they need to be filled.
504 (org-ascii--fill-string contents text-width info how
))
505 ((eq how
'left
) contents
)
508 (goto-char (point-min))
511 ;; Compute maximum width. Bail out if it is greater
512 ;; than page width, since no justification is
516 (unless (org-looking-at-p "[ \t]*$")
518 (let ((column (current-column)))
520 ((>= column text-width
) (throw 'exit contents
))
521 ((> column max-width
) (setq max-width column
)))))
523 ;; Justify every line according to TEXT-WIDTH and
525 (let ((offset (/ (- text-width max-width
)
526 (if (eq how
'right
) 1 2))))
527 (if (zerop offset
) (throw 'exit contents
)
529 (unless (org-looking-at-p "[ \t]*$")
530 (org-indent-to-column offset
))
532 (buffer-string))))))))
534 (defun org-ascii--indent-string (s width
)
535 "Indent string S by WIDTH white spaces.
536 Empty lines are not indented."
538 (replace-regexp-in-string
539 "\\(^\\)[ \t]*\\S-" (make-string width ?\s
) s nil nil
1)))
541 (defun org-ascii--box-string (s info
)
542 "Return string S with a partial box to its left.
543 INFO is a plist used as a communication channel."
544 (let ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
)))
545 (format (if utf8p
"┌────\n%s\n└────" ",----\n%s\n`----")
546 (replace-regexp-in-string
547 "^" (if utf8p
"│ " "| ")
548 ;; Remove last newline character.
549 (replace-regexp-in-string "\n[ \t]*\\'" "" s
)))))
551 (defun org-ascii--current-text-width (element info
)
552 "Return maximum text width for ELEMENT's contents.
553 INFO is a plist used as a communication channel."
554 (case (org-element-type element
)
555 ;; Elements with an absolute width: `headline' and `inlinetask'.
556 (inlinetask (plist-get info
:ascii-inlinetask-width
))
558 (- (plist-get info
:ascii-text-width
)
559 (let ((low-level-rank (org-export-low-level-p element info
)))
560 (if low-level-rank
(* low-level-rank
2)
561 (plist-get info
:ascii-global-margin
)))))
562 ;; Elements with a relative width: store maximum text width in
565 (let* ((genealogy (org-element-lineage element nil t
))
566 ;; Total width is determined by the presence, or not, of an
567 ;; inline task among ELEMENT parents.
569 (if (loop for parent in genealogy
570 thereis
(eq (org-element-type parent
) 'inlinetask
))
571 (plist-get info
:ascii-inlinetask-width
)
572 ;; No inlinetask: Remove global margin from text width.
573 (- (plist-get info
:ascii-text-width
)
574 (plist-get info
:ascii-global-margin
)
575 (let ((parent (org-export-get-parent-headline element
)))
576 ;; Inner margin doesn't apply to text before first
579 (let ((low-level-rank
580 (org-export-low-level-p parent info
)))
581 ;; Inner margin doesn't apply to contents of
582 ;; low level headlines, since they've got their
583 ;; own indentation mechanism.
584 (if low-level-rank
(* low-level-rank
2)
585 (plist-get info
:ascii-inner-margin
)))))))))
587 ;; Each `quote-block' and `verse-block' above narrows text
588 ;; width by twice the standard margin size.
589 (+ (* (loop for parent in genealogy
590 when
(memq (org-element-type parent
)
591 '(quote-block verse-block
))
593 2 (plist-get info
:ascii-quote-margin
))
594 ;; Apply list margin once per "top-level" plain-list
595 ;; containing current line
597 (dolist (e genealogy count
)
598 (and (eq (org-element-type e
) 'plain-list
)
599 (not (eq (org-element-type (org-export-get-parent e
))
602 (plist-get info
:ascii-list-margin
))
603 ;; Text width within a plain-list is restricted by
604 ;; indentation of current item. If that's the case,
605 ;; compute it with the help of `:structure' property from
606 ;; parent item, if any.
608 (if (eq (org-element-type element
) 'item
) element
609 (loop for parent in genealogy
610 when
(eq (org-element-type parent
) 'item
)
613 ;; Compute indentation offset of the current item,
614 ;; that is the sum of the difference between its
615 ;; indentation and the indentation of the top item in
616 ;; the list and current item bullet's length. Also
617 ;; remove checkbox length, and tag length (for
618 ;; description lists) or bullet length.
619 (let ((struct (org-element-property :structure item
))
620 (beg-item (org-element-property :begin item
)))
621 (+ (- (org-list-get-ind beg-item struct
)
623 (org-list-get-top-point struct
) struct
))
624 (string-width (or (org-ascii--checkbox item info
)
627 (let ((tag (org-element-property :tag item
)))
628 (if tag
(org-export-data tag info
)
629 (org-element-property :bullet item
))))))))))))))
631 (defun org-ascii--current-justification (element)
632 "Return expected justification for ELEMENT's contents.
633 Return value is a symbol among `left', `center', `right' and
636 (while (and (not justification
)
637 (setq element
(org-element-property :parent element
)))
638 (case (org-element-type element
)
639 (center-block (setq justification
'center
))
641 (let ((name (org-element-property :type element
)))
642 (cond ((string= name
"JUSTIFYRIGHT") (setq justification
'right
))
643 ((string= name
"JUSTIFYLEFT") (setq justification
'left
)))))))
644 (or justification
'left
)))
646 (defun org-ascii--build-title
647 (element info text-width
&optional underline notags toc
)
648 "Format ELEMENT title and return it.
650 ELEMENT is either an `headline' or `inlinetask' element. INFO is
651 a plist used as a communication channel. TEXT-WIDTH is an
652 integer representing the maximum length of a line.
654 When optional argument UNDERLINE is non-nil, underline title,
655 without the tags, according to `org-ascii-underline'
658 If optional argument NOTAGS is non-nil, no tags will be added to
661 When optional argument TOC is non-nil, use optional title if
662 possible. It doesn't apply to `inlinetask' elements."
663 (let* ((headlinep (eq (org-element-type element
) 'headline
))
665 ;; Numbering is specific to headlines.
666 (and headlinep
(org-export-numbered-headline-p element info
)
667 ;; All tests passed: build numbering string.
671 (org-export-get-headline-number element info
) ".")
676 (if (and toc headlinep
) (org-export-get-alt-title element info
)
677 (org-element-property :title element
))
680 (and (plist-get info
:with-todo-keywords
)
681 (let ((todo (org-element-property :todo-keyword element
)))
682 (and todo
(concat (org-export-data todo info
) " ")))))
683 (tags (and (not notags
)
684 (plist-get info
:with-tags
)
685 (let ((tag-list (org-export-get-tags element info
)))
688 (mapconcat 'identity tag-list
":"))))))
690 (and (plist-get info
:with-priority
)
691 (let ((char (org-element-property :priority element
)))
692 (and char
(format "(#%c) " char
)))))
693 (first-part (concat numbers todo priority text
)))
696 ;; Align tags, if any.
700 (max (- text-width
(1+ (string-width first-part
)))
701 (string-width tags
)))
703 ;; Maybe underline text, if ELEMENT type is `headline' and an
704 ;; underline character has been defined.
705 (when (and underline headlinep
)
707 (nth (1- (org-export-get-relative-level element info
))
708 (cdr (assq (plist-get info
:ascii-charset
)
709 (plist-get info
:ascii-underline
))))))
712 (make-string (/ (string-width first-part
)
713 (char-width under-char
))
716 (defun org-ascii--has-caption-p (element info
)
717 "Non-nil when ELEMENT has a caption affiliated keyword.
718 INFO is a plist used as a communication channel. This function
719 is meant to be used as a predicate for `org-export-get-ordinal'."
720 (org-element-property :caption element
))
722 (defun org-ascii--build-caption (element info
)
723 "Return caption string for ELEMENT, if applicable.
725 INFO is a plist used as a communication channel.
727 The caption string contains the sequence number of ELEMENT along
728 with its real caption. Return nil when ELEMENT has no affiliated
730 (let ((caption (org-export-get-caption element
)))
732 ;; Get sequence number of current src-block among every
733 ;; src-block with a caption.
735 (org-export-get-ordinal
736 element info nil
'org-ascii--has-caption-p
))
737 (title-fmt (org-ascii--translate
738 (case (org-element-type element
)
740 (src-block "Listing %d:"))
742 (org-ascii--fill-string
743 (concat (format title-fmt reference
)
745 (org-export-data caption info
))
746 (org-ascii--current-text-width element info
) info
)))))
748 (defun org-ascii--build-toc (info &optional n keyword local
)
749 "Return a table of contents.
751 INFO is a plist used as a communication channel.
753 Optional argument N, when non-nil, is an integer specifying the
756 Optional argument KEYWORD specifies the TOC keyword, if any, from
757 which the table of contents generation has been initiated.
759 When optional argument LOCAL is non-nil, build a table of
760 contents according to the current headline."
763 (let ((title (org-ascii--translate "Table of Contents" info
)))
767 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) ?─ ?_
))
770 (if keyword
(org-ascii--current-text-width keyword info
)
771 (- (plist-get info
:ascii-text-width
)
772 (plist-get info
:ascii-global-margin
)))))
775 (let* ((level (org-export-get-relative-level headline info
))
776 (indent (* (1- level
) 3)))
778 (unless (zerop indent
) (concat (make-string (1- indent
) ?.
) " "))
779 (org-ascii--build-title
780 headline info
(- text-width indent
) nil
781 (or (not (plist-get info
:with-tags
))
782 (eq (plist-get info
:with-tags
) 'not-in-toc
))
784 (org-export-collect-headlines info n
(and local keyword
)) "\n"))))
786 (defun org-ascii--list-listings (keyword info
)
787 "Return a list of listings.
789 KEYWORD is the keyword that initiated the list of listings
790 generation. INFO is a plist used as a communication channel."
791 (let ((title (org-ascii--translate "List of Listings" info
)))
794 (make-string (string-width title
)
795 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) ?─ ?_
))
798 (if keyword
(org-ascii--current-text-width keyword info
)
799 (- (plist-get info
:ascii-text-width
)
800 (plist-get info
:ascii-global-margin
))))
801 ;; Use a counter instead of retrieving ordinal of each
806 ;; Store initial text so its length can be computed. This is
807 ;; used to properly align caption right to it in case of
808 ;; filling (like contents of a description list item).
810 (format (org-ascii--translate "Listing %d:" info
)
812 (initial-width (string-width initial-text
)))
816 (org-ascii--indent-string
817 (org-ascii--fill-string
818 ;; Use short name in priority, if available.
819 (let ((caption (or (org-export-get-caption src-block t
)
820 (org-export-get-caption src-block
))))
821 (org-export-data caption info
))
822 (- text-width initial-width
) info
)
824 (org-export-collect-listings info
) "\n")))))
826 (defun org-ascii--list-tables (keyword info
)
827 "Return a list of tables.
829 KEYWORD is the keyword that initiated the list of tables
830 generation. INFO is a plist used as a communication channel."
831 (let ((title (org-ascii--translate "List of Tables" info
)))
834 (make-string (string-width title
)
835 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) ?─ ?_
))
838 (if keyword
(org-ascii--current-text-width keyword info
)
839 (- (plist-get info
:ascii-text-width
)
840 (plist-get info
:ascii-global-margin
))))
841 ;; Use a counter instead of retrieving ordinal of each
846 ;; Store initial text so its length can be computed. This is
847 ;; used to properly align caption right to it in case of
848 ;; filling (like contents of a description list item).
850 (format (org-ascii--translate "Table %d:" info
)
852 (initial-width (string-width initial-text
)))
856 (org-ascii--indent-string
857 (org-ascii--fill-string
858 ;; Use short name in priority, if available.
859 (let ((caption (or (org-export-get-caption table t
)
860 (org-export-get-caption table
))))
861 (org-export-data caption info
))
862 (- text-width initial-width
) info
)
864 (org-export-collect-tables info
) "\n")))))
866 (defun org-ascii--unique-links (element info
)
867 "Return a list of unique link references in ELEMENT.
868 ELEMENT is either a headline element or a section element. INFO
869 is a plist used as a communication channel."
873 ;; Return LINK if it wasn't referenced so far, or nil.
874 ;; Update SEEN links along the way.
877 ;; Normalize description in footprints.
878 (cons (org-element-property :raw-link link
)
879 (let ((contents (org-element-contents link
)))
881 (replace-regexp-in-string
884 (org-element-interpret-data contents
))))))))
885 ;; Ignore LINK if it hasn't been translated already.
886 ;; It can happen if it is located in an affiliated
887 ;; keyword that was ignored.
888 (when (and (org-string-nw-p
889 (gethash link
(plist-get info
:exported-data
)))
890 (not (member footprint seen
)))
891 (push footprint seen
) link
)))))
892 ;; If at a section, find parent headline, if any, in order to
893 ;; count links that might be in the title.
895 (if (eq (org-element-type element
) 'headline
) element
896 (or (org-export-get-parent-headline element
) element
))))
897 ;; Get all links in HEADLINE.
898 (org-element-map headline
'link
899 (lambda (l) (funcall unique-link-p l
)) info nil nil t
)))
901 (defun org-ascii--describe-links (links width info
)
902 "Return a string describing a list of links.
904 LINKS is a list of link type objects, as returned by
905 `org-ascii--unique-links'. WIDTH is the text width allowed for
906 the output string. INFO is a plist used as a communication
910 (let ((type (org-element-property :type link
))
911 (anchor (let ((desc (org-element-contents link
)))
912 (if desc
(org-export-data desc info
)
913 (org-element-property :raw-link link
)))))
915 ;; Coderefs, radio links and fuzzy links are ignored.
916 ((member type
'("coderef" "radio" "fuzzy")) nil
)
917 ;; Id and custom-id links: Headlines refer to their numbering.
918 ((member type
'("custom-id" "id"))
919 (let ((dest (org-export-resolve-id-link link info
)))
921 (org-ascii--fill-string
925 (if (not dest
) (org-ascii--translate "Unknown reference" info
)
927 (org-ascii--translate "See section %s" info
)
928 (if (org-export-numbered-headline-p dest info
)
929 (mapconcat #'number-to-string
930 (org-export-get-headline-number dest info
) ".")
931 (org-export-data (org-element-property :title dest
) info
)))))
932 width info
) "\n\n")))
933 ;; Do not add a link that cannot be resolved and doesn't have
934 ;; any description: destination is already visible in the
936 ((not (org-element-contents link
)) nil
)
937 ;; Do not add a link already handled by custom export
939 ((let ((protocol (nth 2 (assoc type org-link-protocols
)))
940 (path (org-element-property :path link
)))
941 (and (functionp protocol
)
942 (funcall protocol
(org-link-unescape path
) anchor
'ascii
)))
946 (org-ascii--fill-string
947 (format "[%s] %s" anchor
(org-element-property :raw-link link
))
952 (defun org-ascii--checkbox (item info
)
953 "Return checkbox string for ITEM or nil.
954 INFO is a plist used as a communication channel."
955 (let ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
)))
956 (case (org-element-property :checkbox item
)
957 (on (if utf8p
"☑ " "[X] "))
958 (off (if utf8p
"☐ " "[ ] "))
959 (trans (if utf8p
"☒ " "[-] ")))))
965 (defun org-ascii-template--document-title (info)
966 "Return document title, as a string.
967 INFO is a plist used as a communication channel."
968 (let* ((text-width (plist-get info
:ascii-text-width
))
969 ;; Links in the title will not be resolved later, so we make
970 ;; sure their path is located right after them.
971 (info (org-combine-plists info
'(:ascii-links-to-notes nil
)))
972 (title (if (plist-get info
:with-title
)
973 (org-export-data (plist-get info
:title
) info
)
975 (author (and (plist-get info
:with-author
)
976 (let ((auth (plist-get info
:author
)))
977 (and auth
(org-export-data auth info
)))))
978 (email (and (plist-get info
:with-email
)
979 (org-export-data (plist-get info
:email
) info
)))
980 (date (and (plist-get info
:with-date
)
981 (org-export-data (org-export-get-date info
) info
))))
982 ;; There are two types of title blocks depending on the presence
983 ;; of a title to display.
984 (if (string= title
"")
985 ;; Title block without a title. DATE is positioned at the top
986 ;; right of the document, AUTHOR to the top left and EMAIL
989 ((and (org-string-nw-p date
) (org-string-nw-p author
))
992 (make-string (- text-width
(string-width date
) (string-width author
))
995 (when (org-string-nw-p email
) (concat "\n" email
))
997 ((and (org-string-nw-p date
) (org-string-nw-p email
))
1000 (make-string (- text-width
(string-width date
) (string-width email
))
1003 ((org-string-nw-p date
)
1005 (org-ascii--justify-lines date text-width
'right
)
1007 ((and (org-string-nw-p author
) (org-string-nw-p email
))
1008 (concat author
"\n" email
"\n\n\n"))
1009 ((org-string-nw-p author
) (concat author
"\n\n\n"))
1010 ((org-string-nw-p email
) (concat email
"\n\n\n")))
1011 ;; Title block with a title. Document's TITLE, along with the
1012 ;; AUTHOR and its EMAIL are both overlined and an underlined,
1013 ;; centered. Date is just below, also centered.
1014 (let* ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
))
1015 ;; Format TITLE. It may be filled if it is too wide,
1016 ;; that is wider than the two thirds of the total width.
1017 (title-len (min (length title
) (/ (* 2 text-width
) 3)))
1018 (formatted-title (org-ascii--fill-string title title-len info
))
1021 (min (+ (max title-len
1022 (string-width (or author
""))
1023 (string-width (or email
"")))
1025 text-width
) (if utf8p ?━ ?_
))))
1026 (org-ascii--justify-lines
1029 (upcase formatted-title
)
1031 ((and (org-string-nw-p author
) (org-string-nw-p email
))
1032 (concat "\n\n" author
"\n" email
))
1033 ((org-string-nw-p author
) (concat "\n\n" author
))
1034 ((org-string-nw-p email
) (concat "\n\n" email
)))
1036 (when (org-string-nw-p date
) (concat "\n\n\n" date
))
1037 "\n\n\n") text-width
'center
)))))
1039 (defun org-ascii-inner-template (contents info
)
1040 "Return complete document string after ASCII conversion.
1041 CONTENTS is the transcoded contents string. INFO is a plist
1042 holding export options."
1043 (org-element-normalize-string
1044 (let ((global-margin (plist-get info
:ascii-global-margin
)))
1045 (org-ascii--indent-string
1047 ;; 1. Document's body.
1049 ;; 2. Footnote definitions.
1050 (let ((definitions (org-export-collect-footnote-definitions info
))
1051 ;; Insert full links right inside the footnote definition
1052 ;; as they have no chance to be inserted later.
1053 (info (org-combine-plists info
'(:ascii-links-to-notes nil
))))
1057 (let ((title (org-ascii--translate "Footnotes" info
)))
1061 (string-width title
)
1062 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) ?─ ?_
))))
1064 (let ((text-width (- (plist-get info
:ascii-text-width
)
1068 (let ((id (format "[%s] " (car ref
))))
1069 ;; Distinguish between inline definitions and
1070 ;; full-fledged definitions.
1072 (let ((def (nth 2 ref
)))
1073 (if (eq (org-element-type def
) 'org-data
)
1074 ;; Full-fledged definition: footnote ID is
1075 ;; inserted inside the first parsed
1076 ;; paragraph (FIRST), if any, to be sure
1077 ;; filling will take it into consideration.
1078 (let ((first (car (org-element-contents def
))))
1079 (if (not (eq (org-element-type first
) 'paragraph
))
1080 (concat id
"\n" (org-export-data def info
))
1081 (push id
(nthcdr 2 first
))
1082 (org-export-data def info
)))
1083 ;; Fill paragraph once footnote ID is inserted
1084 ;; in order to have a correct length for first
1086 (org-ascii--fill-string
1087 (concat id
(org-export-data def info
))
1088 text-width info
))))))
1089 definitions
"\n\n"))))))
1092 (defun org-ascii-template (contents info
)
1093 "Return complete document string after ASCII conversion.
1094 CONTENTS is the transcoded contents string. INFO is a plist
1095 holding export options."
1096 (let ((global-margin (plist-get info
:ascii-global-margin
)))
1098 ;; Build title block.
1099 (org-ascii--indent-string
1100 (concat (org-ascii-template--document-title info
)
1101 ;; 2. Table of contents.
1102 (let ((depth (plist-get info
:with-toc
)))
1105 (org-ascii--build-toc info
(and (wholenump depth
) depth
))
1110 ;; Creator. Justify it to the bottom right.
1111 (and (plist-get info
:with-creator
)
1112 (org-ascii--indent-string
1114 (- (plist-get info
:ascii-text-width
) global-margin
)))
1117 (org-ascii--fill-string
1118 (plist-get info
:creator
) text-width info
'right
)))
1121 (defun org-ascii--translate (s info
)
1122 "Translate string S according to specified language and charset.
1123 INFO is a plist used as a communication channel."
1124 (let ((charset (intern (format ":%s" (plist-get info
:ascii-charset
)))))
1125 (org-export-translate s charset info
)))
1129 ;;; Transcode Functions
1133 (defun org-ascii-bold (bold contents info
)
1134 "Transcode BOLD from Org to ASCII.
1135 CONTENTS is the text with bold markup. INFO is a plist holding
1136 contextual information."
1137 (format "*%s*" contents
))
1142 (defun org-ascii-center-block (center-block contents info
)
1143 "Transcode a CENTER-BLOCK element from Org to ASCII.
1144 CONTENTS holds the contents of the block. INFO is a plist
1145 holding contextual information."
1146 ;; Center has already been taken care of at a lower level, so
1147 ;; there's nothing left to do.
1153 (defun org-ascii-clock (clock contents info
)
1154 "Transcode a CLOCK object from Org to ASCII.
1155 CONTENTS is nil. INFO is a plist holding contextual
1157 (org-ascii--justify-element
1158 (concat org-clock-string
" "
1159 (org-timestamp-translate (org-element-property :value clock
))
1160 (let ((time (org-element-property :duration clock
)))
1165 (org-split-string time
":"))))))
1171 (defun org-ascii-code (code contents info
)
1172 "Return a CODE object from Org to ASCII.
1173 CONTENTS is nil. INFO is a plist holding contextual
1175 (format (plist-get info
:ascii-verbatim-format
)
1176 (org-element-property :value code
)))
1181 (defun org-ascii-drawer (drawer contents info
)
1182 "Transcode a DRAWER element from Org to ASCII.
1183 CONTENTS holds the contents of the block. INFO is a plist
1184 holding contextual information."
1185 (let ((name (org-element-property :drawer-name drawer
))
1186 (width (org-ascii--current-text-width drawer info
)))
1187 (funcall (plist-get info
:ascii-format-drawer-function
)
1188 name contents width
)))
1193 (defun org-ascii-dynamic-block (dynamic-block contents info
)
1194 "Transcode a DYNAMIC-BLOCK element from Org to ASCII.
1195 CONTENTS holds the contents of the block. INFO is a plist
1196 holding contextual information."
1202 (defun org-ascii-entity (entity contents info
)
1203 "Transcode an ENTITY object from Org to ASCII.
1204 CONTENTS are the definition itself. INFO is a plist holding
1205 contextual information."
1206 (org-element-property
1207 (intern (concat ":" (symbol-name (plist-get info
:ascii-charset
))))
1213 (defun org-ascii-example-block (example-block contents info
)
1214 "Transcode a EXAMPLE-BLOCK element from Org to ASCII.
1215 CONTENTS is nil. INFO is a plist holding contextual information."
1216 (org-ascii--justify-element
1217 (org-ascii--box-string
1218 (org-export-format-code-default example-block info
) info
)
1219 example-block info
))
1224 (defun org-ascii-export-snippet (export-snippet contents info
)
1225 "Transcode a EXPORT-SNIPPET object from Org to ASCII.
1226 CONTENTS is nil. INFO is a plist holding contextual information."
1227 (when (eq (org-export-snippet-backend export-snippet
) 'ascii
)
1228 (org-element-property :value export-snippet
)))
1233 (defun org-ascii-export-block (export-block contents info
)
1234 "Transcode a EXPORT-BLOCK element from Org to ASCII.
1235 CONTENTS is nil. INFO is a plist holding contextual information."
1236 (when (string= (org-element-property :type export-block
) "ASCII")
1237 (org-ascii--justify-element
1238 (org-element-property :value export-block
) export-block info
)))
1243 (defun org-ascii-fixed-width (fixed-width contents info
)
1244 "Transcode a FIXED-WIDTH element from Org to ASCII.
1245 CONTENTS is nil. INFO is a plist holding contextual information."
1246 (org-ascii--justify-element
1247 (org-ascii--box-string
1248 (org-remove-indentation
1249 (org-element-property :value fixed-width
)) info
)
1253 ;;;; Footnote Definition
1255 ;; Footnote Definitions are ignored. They are compiled at the end of
1256 ;; the document, by `org-ascii-inner-template'.
1259 ;;;; Footnote Reference
1261 (defun org-ascii-footnote-reference (footnote-reference contents info
)
1262 "Transcode a FOOTNOTE-REFERENCE element from Org to ASCII.
1263 CONTENTS is nil. INFO is a plist holding contextual information."
1264 (format "[%s]" (org-export-get-footnote-number footnote-reference info
)))
1269 (defun org-ascii-headline (headline contents info
)
1270 "Transcode a HEADLINE element from Org to ASCII.
1271 CONTENTS holds the contents of the headline. INFO is a plist
1272 holding contextual information."
1273 ;; Don't export footnote section, which will be handled at the end
1275 (unless (org-element-property :footnote-section-p headline
)
1276 (let* ((low-level-rank (org-export-low-level-p headline info
))
1277 (width (org-ascii--current-text-width headline info
))
1278 ;; Blank lines between headline and its contents.
1279 ;; `org-ascii-headline-spacing', when set, overwrites
1280 ;; original buffer's spacing.
1283 (or (car (plist-get info
:ascii-headline-spacing
))
1284 (org-element-property :pre-blank headline
))
1286 ;; Even if HEADLINE has no section, there might be some
1287 ;; links in its title that we shouldn't forget to describe.
1289 (unless (or (eq (caar (org-element-contents headline
)) 'section
))
1290 (let ((title (org-element-property :title headline
)))
1292 (org-ascii--describe-links
1293 (org-ascii--unique-links title info
) width info
))))))
1294 ;; Deep subtree: export it as a list item.
1298 (let ((bullets (cdr (assq (plist-get info
:ascii-charset
)
1299 (plist-get info
:ascii-bullets
)))))
1301 (nth (mod (1- low-level-rank
) (length bullets
)) bullets
)))
1304 (org-ascii--build-title headline info width
) "\n"
1305 ;; Contents, indented by length of bullet.
1307 (org-ascii--indent-string
1309 (when (org-string-nw-p links
) (concat "\n\n" links
)))
1311 ;; Else: Standard headline.
1313 (org-ascii--build-title headline info width
'underline
)
1315 (concat (when (org-string-nw-p links
) links
) contents
))))))
1318 ;;;; Horizontal Rule
1320 (defun org-ascii-horizontal-rule (horizontal-rule contents info
)
1321 "Transcode an HORIZONTAL-RULE object from Org to ASCII.
1322 CONTENTS is nil. INFO is a plist holding contextual
1324 (let ((text-width (org-ascii--current-text-width horizontal-rule info
))
1326 (org-export-read-attribute :attr_ascii horizontal-rule
:width
)))
1327 (org-ascii--justify-lines
1328 (make-string (if (and spec-width
(string-match "^[0-9]+$" spec-width
))
1329 (string-to-number spec-width
)
1331 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) ?― ?-
))
1332 text-width
'center
)))
1335 ;;;; Inline Src Block
1337 (defun org-ascii-inline-src-block (inline-src-block contents info
)
1338 "Transcode an INLINE-SRC-BLOCK element from Org to ASCII.
1339 CONTENTS holds the contents of the item. INFO is a plist holding
1340 contextual information."
1341 (format (plist-get info
:ascii-verbatim-format
)
1342 (org-element-property :value inline-src-block
)))
1347 (defun org-ascii-format-inlinetask-default
1348 (todo type priority name tags contents width inlinetask info
)
1349 "Format an inline task element for ASCII export.
1350 See `org-ascii-format-inlinetask-function' for a description
1352 (let* ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
))
1353 (width (or width
(plist-get info
:ascii-inlinetask-width
))))
1354 (org-ascii--indent-string
1356 ;; Top line, with an additional blank line if not in UTF-8.
1357 (make-string width
(if utf8p ?━ ?_
)) "\n"
1358 (unless utf8p
(concat (make-string width ?
) "\n"))
1359 ;; Add title. Fill it if wider than inlinetask.
1360 (let ((title (org-ascii--build-title inlinetask info width
)))
1361 (if (<= (string-width title
) width
) title
1362 (org-ascii--fill-string title width info
)))
1364 ;; If CONTENTS is not empty, insert it along with
1366 (when (org-string-nw-p contents
)
1367 (concat (make-string width
(if utf8p ?─ ?-
)) "\n" contents
))
1369 (make-string width
(if utf8p ?━ ?_
)))
1370 ;; Flush the inlinetask to the right.
1371 (- (plist-get info
:ascii-text-width
) (plist-get info
:ascii-global-margin
)
1372 (if (not (org-export-get-parent-headline inlinetask
)) 0
1373 (plist-get info
:ascii-inner-margin
))
1374 (org-ascii--current-text-width inlinetask info
)))))
1376 (defun org-ascii-inlinetask (inlinetask contents info
)
1377 "Transcode an INLINETASK element from Org to ASCII.
1378 CONTENTS holds the contents of the block. INFO is a plist
1379 holding contextual information."
1380 (let ((width (org-ascii--current-text-width inlinetask info
)))
1381 (funcall (plist-get info
:ascii-format-inlinetask-function
)
1383 (and (plist-get info
:with-todo-keywords
)
1384 (let ((todo (org-element-property
1385 :todo-keyword inlinetask
)))
1386 (and todo
(org-export-data todo info
))))
1388 (org-element-property :todo-type inlinetask
)
1390 (and (plist-get info
:with-priority
)
1391 (org-element-property :priority inlinetask
))
1393 (org-export-data (org-element-property :title inlinetask
) info
)
1395 (and (plist-get info
:with-tags
)
1396 (org-element-property :tags inlinetask
))
1397 ;; contents and width
1398 contents width inlinetask info
)))
1403 (defun org-ascii-italic (italic contents info
)
1404 "Transcode italic from Org to ASCII.
1405 CONTENTS is the text with italic markup. INFO is a plist holding
1406 contextual information."
1407 (format "/%s/" contents
))
1412 (defun org-ascii-item (item contents info
)
1413 "Transcode an ITEM element from Org to ASCII.
1414 CONTENTS holds the contents of the item. INFO is a plist holding
1415 contextual information."
1416 (let* ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
))
1417 (checkbox (org-ascii--checkbox item info
))
1418 (list-type (org-element-property :type
(org-export-get-parent item
)))
1420 ;; First parent of ITEM is always the plain-list. Get
1421 ;; `:type' property from it.
1422 (org-list-bullet-string
1426 (org-export-data (org-element-property :tag item
) info
)
1429 ;; Return correct number for ITEM, paying attention to
1431 (let* ((struct (org-element-property :structure item
))
1432 (bul (org-element-property :bullet item
))
1433 (num (number-to-string
1434 (car (last (org-list-get-item-number
1435 (org-element-property :begin item
)
1437 (org-list-prevs-alist struct
)
1438 (org-list-parents-alist struct
)))))))
1439 (replace-regexp-in-string "[0-9]+" num bul
)))
1440 (t (let ((bul (org-element-property :bullet item
)))
1441 ;; Change bullets into more visible form if UTF-8 is active.
1443 (replace-regexp-in-string
1445 (replace-regexp-in-string
1447 (replace-regexp-in-string "*" "‣" bul
))))))))))
1450 (unless (eq list-type
'descriptive
) checkbox
)
1451 ;; Contents: Pay attention to indentation. Note: check-boxes are
1452 ;; already taken care of at the paragraph level so they don't
1453 ;; interfere with indentation.
1454 (let ((contents (org-ascii--indent-string contents
(string-width bullet
))))
1455 (if (eq (org-element-type (car (org-element-contents item
))) 'paragraph
)
1457 (concat "\n" contents
))))))
1462 (defun org-ascii-keyword (keyword contents info
)
1463 "Transcode a KEYWORD element from Org to ASCII.
1464 CONTENTS is nil. INFO is a plist holding contextual
1466 (let ((key (org-element-property :key keyword
))
1467 (value (org-element-property :value keyword
)))
1469 ((string= key
"ASCII") (org-ascii--justify-element value keyword info
))
1470 ((string= key
"TOC")
1471 (org-ascii--justify-element
1472 (let ((case-fold-search t
))
1474 ((org-string-match-p "\\<headlines\\>" value
)
1475 (let ((depth (and (string-match "\\<[0-9]+\\>" value
)
1476 (string-to-number (match-string 0 value
))))
1477 (localp (org-string-match-p "\\<local\\>" value
)))
1478 (org-ascii--build-toc info depth keyword localp
)))
1479 ((org-string-match-p "\\<tables\\>" value
)
1480 (org-ascii--list-tables keyword info
))
1481 ((org-string-match-p "\\<listings\\>" value
)
1482 (org-ascii--list-listings keyword info
))))
1486 ;;;; Latex Environment
1488 (defun org-ascii-latex-environment (latex-environment contents info
)
1489 "Transcode a LATEX-ENVIRONMENT element from Org to ASCII.
1490 CONTENTS is nil. INFO is a plist holding contextual
1492 (when (plist-get info
:with-latex
)
1493 (org-ascii--justify-element
1494 (org-remove-indentation (org-element-property :value latex-environment
))
1495 latex-environment info
)))
1500 (defun org-ascii-latex-fragment (latex-fragment contents info
)
1501 "Transcode a LATEX-FRAGMENT object from Org to ASCII.
1502 CONTENTS is nil. INFO is a plist holding contextual
1504 (when (plist-get info
:with-latex
)
1505 (org-element-property :value latex-fragment
)))
1510 (defun org-ascii-line-break (line-break contents info
)
1511 "Transcode a LINE-BREAK object from Org to ASCII.
1512 CONTENTS is nil. INFO is a plist holding contextual
1513 information." hard-newline
)
1518 (defun org-ascii-link (link desc info
)
1519 "Transcode a LINK object from Org to ASCII.
1521 DESC is the description part of the link, or the empty string.
1522 INFO is a plist holding contextual information."
1523 (let ((type (org-element-property :type link
)))
1525 ((org-export-custom-protocol-maybe link desc
'ascii
))
1526 ((string= type
"coderef")
1527 (let ((ref (org-element-property :path link
)))
1528 (format (org-export-get-coderef-format ref desc
)
1529 (org-export-resolve-coderef ref info
))))
1530 ;; Do not apply a special syntax on radio links. Though, use
1531 ;; transcoded target's contents as output.
1532 ((string= type
"radio") desc
)
1533 ;; Do not apply a special syntax on fuzzy links pointing to
1535 ((string= type
"fuzzy")
1536 (let ((destination (org-export-resolve-fuzzy-link link info
)))
1537 (if (org-string-nw-p desc
) desc
1540 (org-export-get-ordinal
1541 destination info nil
'org-ascii--has-caption-p
)))
1543 (if (atom number
) (number-to-string number
)
1544 (mapconcat #'number-to-string number
"."))
1545 ;; Unnumbered headline.
1546 (when (eq 'headline
(org-element-type destination
))
1549 (org-element-property :title destination
)
1552 (let ((raw-link (org-element-property :raw-link link
)))
1553 (if (not (org-string-nw-p desc
)) (format "[%s]" raw-link
)
1554 (concat (format "[%s]" desc
)
1555 (and (not (plist-get info
:ascii-links-to-notes
))
1556 (format " (%s)" raw-link
)))))))))
1559 ;;;; Node Properties
1561 (defun org-ascii-node-property (node-property contents info
)
1562 "Transcode a NODE-PROPERTY element from Org to ASCII.
1563 CONTENTS is nil. INFO is a plist holding contextual
1566 (org-element-property :key node-property
)
1567 (let ((value (org-element-property :value node-property
)))
1568 (if value
(concat " " value
) ""))))
1573 (defun org-ascii-paragraph (paragraph contents info
)
1574 "Transcode a PARAGRAPH element from Org to ASCII.
1575 CONTENTS is the contents of the paragraph, as a string. INFO is
1576 the plist used as a communication channel."
1577 (org-ascii--justify-element
1578 (let ((indented-line-width (plist-get info
:ascii-indented-line-width
)))
1579 (if (not (wholenump indented-line-width
)) contents
1581 ;; Do not indent first paragraph in a section.
1582 (unless (and (not (org-export-get-previous-element paragraph info
))
1583 (eq (org-element-type (org-export-get-parent paragraph
))
1585 (make-string indented-line-width ?\s
))
1586 (replace-regexp-in-string "\\`[ \t]+" "" contents
))))
1592 (defun org-ascii-plain-list (plain-list contents info
)
1593 "Transcode a PLAIN-LIST element from Org to ASCII.
1594 CONTENTS is the contents of the list. INFO is a plist holding
1595 contextual information."
1596 (let ((margin (plist-get info
:ascii-list-margin
)))
1597 (if (or (< margin
1)
1598 (eq (org-element-type (org-export-get-parent plain-list
)) 'item
))
1600 (org-ascii--indent-string contents margin
))))
1605 (defun org-ascii-plain-text (text info
)
1606 "Transcode a TEXT string from Org to ASCII.
1607 INFO is a plist used as a communication channel."
1608 (let ((utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
)))
1609 (when (and utf8p
(plist-get info
:with-smart-quotes
))
1610 (setq text
(org-export-activate-smart-quotes text
:utf-8 info
)))
1611 (if (not (plist-get info
:with-special-strings
)) text
1612 (setq text
(replace-regexp-in-string "\\\\-" "" text
))
1613 (if (not utf8p
) text
1614 ;; Usual replacements in utf-8 with proper option set.
1615 (replace-regexp-in-string
1617 (replace-regexp-in-string
1619 (replace-regexp-in-string "---" "—" text
)))))))
1624 (defun org-ascii-planning (planning contents info
)
1625 "Transcode a PLANNING element from Org to ASCII.
1626 CONTENTS is nil. INFO is a plist used as a communication
1628 (org-ascii--justify-element
1632 (list (let ((closed (org-element-property :closed planning
)))
1634 (concat org-closed-string
" "
1635 (org-timestamp-translate closed
))))
1636 (let ((deadline (org-element-property :deadline planning
)))
1638 (concat org-deadline-string
" "
1639 (org-timestamp-translate deadline
))))
1640 (let ((scheduled (org-element-property :scheduled planning
)))
1642 (concat org-scheduled-string
" "
1643 (org-timestamp-translate scheduled
))))))
1648 ;;;; Property Drawer
1650 (defun org-ascii-property-drawer (property-drawer contents info
)
1651 "Transcode a PROPERTY-DRAWER element from Org to ASCII.
1652 CONTENTS holds the contents of the drawer. INFO is a plist
1653 holding contextual information."
1654 (and (org-string-nw-p contents
)
1655 (org-ascii--justify-element contents property-drawer info
)))
1660 (defun org-ascii-quote-block (quote-block contents info
)
1661 "Transcode a QUOTE-BLOCK element from Org to ASCII.
1662 CONTENTS holds the contents of the block. INFO is a plist
1663 holding contextual information."
1664 (org-ascii--indent-string contents
(plist-get info
:ascii-quote-margin
)))
1669 (defun org-ascii-radio-target (radio-target contents info
)
1670 "Transcode a RADIO-TARGET object from Org to ASCII.
1671 CONTENTS is the contents of the target. INFO is a plist holding
1672 contextual information."
1678 (defun org-ascii-section (section contents info
)
1679 "Transcode a SECTION element from Org to ASCII.
1680 CONTENTS is the contents of the section. INFO is a plist holding
1681 contextual information."
1682 (org-ascii--indent-string
1685 (when (plist-get info
:ascii-links-to-notes
)
1686 ;; Add list of links at the end of SECTION.
1687 (let ((links (org-ascii--describe-links
1688 (org-ascii--unique-links section info
)
1689 (org-ascii--current-text-width section info
) info
)))
1690 ;; Separate list of links and section contents.
1691 (when (org-string-nw-p links
) (concat "\n\n" links
)))))
1692 ;; Do not apply inner margin if parent headline is low level.
1693 (let ((headline (org-export-get-parent-headline section
)))
1694 (if (or (not headline
) (org-export-low-level-p headline info
)) 0
1695 (plist-get info
:ascii-inner-margin
)))))
1700 (defun org-ascii-special-block (special-block contents info
)
1701 "Transcode a SPECIAL-BLOCK element from Org to ASCII.
1702 CONTENTS holds the contents of the block. INFO is a plist
1703 holding contextual information."
1704 ;; "JUSTIFYLEFT" and "JUSTFYRIGHT" have already been taken care of
1705 ;; at a lower level. There is no other special block type to
1712 (defun org-ascii-src-block (src-block contents info
)
1713 "Transcode a SRC-BLOCK element from Org to ASCII.
1714 CONTENTS holds the contents of the item. INFO is a plist holding
1715 contextual information."
1716 (let ((caption (org-ascii--build-caption src-block info
))
1717 (caption-above-p (plist-get info
:ascii-caption-above
))
1718 (code (org-export-format-code-default src-block info
)))
1719 (if (equal code
"") ""
1720 (org-ascii--justify-element
1722 (and caption caption-above-p
(concat caption
"\n"))
1723 (org-ascii--box-string code info
)
1724 (and caption
(not caption-above-p
) (concat "\n" caption
)))
1728 ;;;; Statistics Cookie
1730 (defun org-ascii-statistics-cookie (statistics-cookie contents info
)
1731 "Transcode a STATISTICS-COOKIE object from Org to ASCII.
1732 CONTENTS is nil. INFO is a plist holding contextual information."
1733 (org-element-property :value statistics-cookie
))
1738 (defun org-ascii-subscript (subscript contents info
)
1739 "Transcode a SUBSCRIPT object from Org to ASCII.
1740 CONTENTS is the contents of the object. INFO is a plist holding
1741 contextual information."
1742 (if (org-element-property :use-brackets-p subscript
)
1743 (format "_{%s}" contents
)
1744 (format "_%s" contents
)))
1749 (defun org-ascii-superscript (superscript contents info
)
1750 "Transcode a SUPERSCRIPT object from Org to ASCII.
1751 CONTENTS is the contents of the object. INFO is a plist holding
1752 contextual information."
1753 (if (org-element-property :use-brackets-p superscript
)
1754 (format "^{%s}" contents
)
1755 (format "^%s" contents
)))
1760 (defun org-ascii-strike-through (strike-through contents info
)
1761 "Transcode STRIKE-THROUGH from Org to ASCII.
1762 CONTENTS is text with strike-through markup. INFO is a plist
1763 holding contextual information."
1764 (format "+%s+" contents
))
1769 (defun org-ascii-table (table contents info
)
1770 "Transcode a TABLE element from Org to ASCII.
1771 CONTENTS is the contents of the table. INFO is a plist holding
1772 contextual information."
1773 (let ((caption (org-ascii--build-caption table info
))
1774 (caption-above-p (plist-get info
:ascii-caption-above
)))
1775 (org-ascii--justify-element
1777 ;; Possibly add a caption string above.
1778 (and caption caption-above-p
(concat caption
"\n"))
1779 ;; Insert table. Note: "table.el" tables are left unmodified.
1780 (cond ((eq (org-element-property :type table
) 'org
) contents
)
1781 ((and (plist-get info
:ascii-table-use-ascii-art
)
1782 (eq (plist-get info
:ascii-charset
) 'utf-8
)
1783 (require 'ascii-art-to-unicode nil t
))
1785 (insert (org-remove-indentation
1786 (org-element-property :value table
)))
1787 (goto-char (point-min))
1789 (goto-char (point-max))
1790 (skip-chars-backward " \r\t\n")
1791 (buffer-substring (point-min) (point))))
1792 (t (org-remove-indentation (org-element-property :value table
))))
1793 ;; Possible add a caption string below.
1794 (and (not caption-above-p
) caption
))
1800 (defun org-ascii--table-cell-width (table-cell info
)
1801 "Return width of TABLE-CELL.
1803 INFO is a plist used as a communication channel.
1805 Width of a cell is determined either by a width cookie in the
1806 same column as the cell, or by the maximum cell's length in that
1809 When `org-ascii-table-widen-columns' is non-nil, width cookies
1811 (let* ((row (org-export-get-parent table-cell
))
1812 (table (org-export-get-parent row
))
1813 (col (let ((cells (org-element-contents row
)))
1814 (- (length cells
) (length (memq table-cell cells
)))))
1816 (or (plist-get info
:ascii-table-cell-width-cache
)
1817 (plist-get (setq info
1818 (plist-put info
:ascii-table-cell-width-cache
1819 (make-hash-table :test
'equal
)))
1820 :ascii-table-cell-width-cache
)))
1821 (key (cons table col
))
1822 (widenp (plist-get info
:ascii-table-widen-columns
)))
1823 (or (gethash key cache
)
1826 (let ((cookie-width (org-export-table-cell-width table-cell info
)))
1827 (or (and (not widenp
) cookie-width
)
1828 (let ((contents-width
1829 (let ((max-width 0))
1830 (org-element-map table
'table-row
1835 (org-element-contents
1836 (elt (org-element-contents row
) col
))
1841 (cond ((not cookie-width
) contents-width
)
1842 (widenp (max cookie-width contents-width
))
1843 (t cookie-width
)))))
1846 (defun org-ascii-table-cell (table-cell contents info
)
1847 "Transcode a TABLE-CELL object from Org to ASCII.
1848 CONTENTS is the cell contents. INFO is a plist used as
1849 a communication channel."
1850 ;; Determine column width. When `org-ascii-table-widen-columns'
1851 ;; is nil and some width cookie has set it, use that value.
1852 ;; Otherwise, compute the maximum width among transcoded data of
1853 ;; each cell in the column.
1854 (let ((width (org-ascii--table-cell-width table-cell info
)))
1855 ;; When contents are too large, truncate them.
1856 (unless (or (plist-get info
:ascii-table-widen-columns
)
1857 (<= (string-width (or contents
"")) width
))
1858 (setq contents
(concat (substring contents
0 (- width
2)) "=>")))
1859 ;; Align contents correctly within the cell.
1860 (let* ((indent-tabs-mode nil
)
1863 (org-ascii--justify-lines
1865 (org-export-table-cell-alignment table-cell info
)))))
1868 (make-string (- width
(string-width (or data
""))) ?\s
))))
1870 (concat (format " %s " contents
)
1871 (when (memq 'right
(org-export-table-cell-borders table-cell info
))
1872 (if (eq (plist-get info
:ascii-charset
) 'utf-8
) "│" "|")))))
1877 (defun org-ascii-table-row (table-row contents info
)
1878 "Transcode a TABLE-ROW element from Org to ASCII.
1879 CONTENTS is the row contents. INFO is a plist used as
1880 a communication channel."
1881 (when (eq (org-element-property :type table-row
) 'standard
)
1884 (lambda (lcorner horiz vert rcorner
)
1888 (org-element-map table-row
'table-cell
1890 (let ((width (org-ascii--table-cell-width cell info
))
1891 (borders (org-export-table-cell-borders cell info
)))
1893 ;; In order to know if CELL starts the row, do
1894 ;; not compare it with the first cell in the
1895 ;; row as there might be a special column.
1896 ;; Instead, compare it with first exportable
1897 ;; cell, obtained with `org-element-map'.
1898 (when (and (memq 'left borders
)
1899 (eq (org-element-map table-row
'table-cell
1903 (make-string (+ 2 width
) (string-to-char horiz
))
1905 ((not (memq 'right borders
)) nil
)
1906 ((eq (car (last (org-element-contents table-row
))) cell
)
1910 (utf8p (eq (plist-get info
:ascii-charset
) 'utf-8
))
1911 (borders (org-export-table-cell-borders
1912 (org-element-map table-row
'table-cell
'identity info t
)
1915 ((and (memq 'top borders
) (or utf8p
(memq 'above borders
)))
1916 (if utf8p
(funcall build-hline
"┍" "━" "┯" "┑")
1917 (funcall build-hline
"+" "-" "+" "+")))
1918 ((memq 'above borders
)
1919 (if utf8p
(funcall build-hline
"├" "─" "┼" "┤")
1920 (funcall build-hline
"+" "-" "+" "+"))))
1921 (when (memq 'left borders
) (if utf8p
"│" "|"))
1923 (when (and (memq 'bottom borders
) (or utf8p
(memq 'below borders
)))
1924 (if utf8p
(funcall build-hline
"┕" "━" "┷" "┙")
1925 (funcall build-hline
"+" "-" "+" "+")))))))
1930 (defun org-ascii-timestamp (timestamp contents info
)
1931 "Transcode a TIMESTAMP object from Org to ASCII.
1932 CONTENTS is nil. INFO is a plist holding contextual information."
1933 (org-ascii-plain-text (org-timestamp-translate timestamp
) info
))
1938 (defun org-ascii-underline (underline contents info
)
1939 "Transcode UNDERLINE from Org to ASCII.
1940 CONTENTS is the text with underline markup. INFO is a plist
1941 holding contextual information."
1942 (format "_%s_" contents
))
1947 (defun org-ascii-verbatim (verbatim contents info
)
1948 "Return a VERBATIM object from Org to ASCII.
1949 CONTENTS is nil. INFO is a plist holding contextual information."
1950 (format (plist-get info
:ascii-verbatim-format
)
1951 (org-element-property :value verbatim
)))
1956 (defun org-ascii-verse-block (verse-block contents info
)
1957 "Transcode a VERSE-BLOCK element from Org to ASCII.
1958 CONTENTS is verse block contents. INFO is a plist holding
1959 contextual information."
1960 (let ((verse-width (org-ascii--current-text-width verse-block info
)))
1961 (org-ascii--indent-string
1962 (org-ascii--justify-element contents verse-block info
)
1963 (plist-get info
:ascii-quote-margin
))))
1969 (defun org-ascii-filter-headline-blank-lines (headline back-end info
)
1970 "Filter controlling number of blank lines after a headline.
1972 HEADLINE is a string representing a transcoded headline.
1973 BACK-END is symbol specifying back-end used for export. INFO is
1974 plist containing the communication channel.
1976 This function only applies to `ascii' back-end. See
1977 `org-ascii-headline-spacing' for information."
1978 (let ((headline-spacing (plist-get info
:ascii-headline-spacing
)))
1979 (if (not headline-spacing
) headline
1980 (let ((blanks (make-string (1+ (cdr headline-spacing
)) ?
\n)))
1981 (replace-regexp-in-string "\n\\(?:\n[ \t]*\\)*\\'" blanks headline
)))))
1983 (defun org-ascii-filter-paragraph-spacing (tree back-end info
)
1984 "Filter controlling number of blank lines between paragraphs.
1986 TREE is the parse tree. BACK-END is the symbol specifying
1987 back-end used for export. INFO is a plist used as
1988 a communication channel.
1990 See `org-ascii-paragraph-spacing' for information."
1991 (let ((paragraph-spacing (plist-get info
:ascii-paragraph-spacing
)))
1992 (when (wholenump paragraph-spacing
)
1993 (org-element-map tree
'paragraph
1995 (when (eq (org-element-type (org-export-get-next-element p info
))
1997 (org-element-put-property p
:post-blank paragraph-spacing
))))))
2000 (defun org-ascii-filter-comment-spacing (tree backend info
)
2001 "Filter removing blank lines between comments.
2002 TREE is the parse tree. BACK-END is the symbol specifying
2003 back-end used for export. INFO is a plist used as
2004 a communication channel."
2005 (org-element-map tree
'(comment comment-block
)
2007 (when (memq (org-element-type (org-export-get-next-element c info
))
2008 '(comment comment-block
))
2009 (org-element-put-property c
:post-blank
0))))
2014 ;;; End-user functions
2017 (defun org-ascii-export-as-ascii
2018 (&optional async subtreep visible-only body-only ext-plist
)
2019 "Export current buffer to a text buffer.
2021 If narrowing is active in the current buffer, only export its
2024 If a region is active, export that region.
2026 A non-nil optional argument ASYNC means the process should happen
2027 asynchronously. The resulting buffer should be accessible
2028 through the `org-export-stack' interface.
2030 When optional argument SUBTREEP is non-nil, export the sub-tree
2031 at point, extracting information from the headline properties
2034 When optional argument VISIBLE-ONLY is non-nil, don't export
2035 contents of hidden elements.
2037 When optional argument BODY-ONLY is non-nil, strip title and
2038 table of contents from output.
2040 EXT-PLIST, when provided, is a property list with external
2041 parameters overriding Org default settings, but still inferior to
2042 file-local settings.
2044 Export is done in a buffer named \"*Org ASCII Export*\", which
2045 will be displayed when `org-export-show-temporary-export-buffer'
2048 (org-export-to-buffer 'ascii
"*Org ASCII Export*"
2049 async subtreep visible-only body-only ext-plist
(lambda () (text-mode))))
2052 (defun org-ascii-export-to-ascii
2053 (&optional async subtreep visible-only body-only ext-plist
)
2054 "Export current buffer to a text file.
2056 If narrowing is active in the current buffer, only export its
2059 If a region is active, export that region.
2061 A non-nil optional argument ASYNC means the process should happen
2062 asynchronously. The resulting file should be accessible through
2063 the `org-export-stack' interface.
2065 When optional argument SUBTREEP is non-nil, export the sub-tree
2066 at point, extracting information from the headline properties
2069 When optional argument VISIBLE-ONLY is non-nil, don't export
2070 contents of hidden elements.
2072 When optional argument BODY-ONLY is non-nil, strip title and
2073 table of contents from output.
2075 EXT-PLIST, when provided, is a property list with external
2076 parameters overriding Org default settings, but still inferior to
2077 file-local settings.
2079 Return output file's name."
2081 (let ((file (org-export-output-file-name ".txt" subtreep
)))
2082 (org-export-to-file 'ascii file
2083 async subtreep visible-only body-only ext-plist
)))
2086 (defun org-ascii-publish-to-ascii (plist filename pub-dir
)
2087 "Publish an Org file to ASCII.
2089 FILENAME is the filename of the Org file to be published. PLIST
2090 is the property list for the given project. PUB-DIR is the
2091 publishing directory.
2093 Return output file name."
2095 'ascii filename
".txt" `(:ascii-charset ascii
,@plist
) pub-dir
))
2098 (defun org-ascii-publish-to-latin1 (plist filename pub-dir
)
2099 "Publish an Org file to Latin-1.
2101 FILENAME is the filename of the Org file to be published. PLIST
2102 is the property list for the given project. PUB-DIR is the
2103 publishing directory.
2105 Return output file name."
2107 'ascii filename
".txt" `(:ascii-charset latin1
,@plist
) pub-dir
))
2110 (defun org-ascii-publish-to-utf8 (plist filename pub-dir
)
2111 "Publish an org file to UTF-8.
2113 FILENAME is the filename of the Org file to be published. PLIST
2114 is the property list for the given project. PUB-DIR is the
2115 publishing directory.
2117 Return output file name."
2119 'ascii filename
".txt" `(:ascii-charset utf-8
,@plist
) pub-dir
))
2125 ;; generated-autoload-file: "org-loaddefs.el"
2126 ;; coding: utf-8-emacs
2129 ;;; ox-ascii.el ends here