[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/org-mime 80b4e3a3b4 008/118: add readme
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/org-mime 80b4e3a3b4 008/118: add readme |
Date: |
Wed, 5 Jan 2022 07:58:41 -0500 (EST) |
branch: elpa/org-mime
commit 80b4e3a3b4826aa1bb60484119f6997fd0d5555b
Author: Chen Bin <chenbin.sh@gmail.com>
Commit: Chen Bin <chenbin.sh@gmail.com>
add readme
---
README.org | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 63 insertions(+)
diff --git a/README.org b/README.org
new file mode 100644
index 0000000000..b2f8e657a6
--- /dev/null
+++ b/README.org
@@ -0,0 +1,63 @@
+* General
+org-mime can be used to send HTML email using Org-mode HTML export.
+
+This approximates a WYSiWYG HTML mail editor from within Emacs, and can be
useful for sending tables, fontified source code, and inline images in email.
+* Setup
+#+begin_src elisp
+(require 'org-mime)
+;; for gnus – this is set by default
+(setq org-mime-library 'mml)
+;; OR for Wanderlust (WL)
+;; (setq org-mime-library 'semi)
+;; OR for VM – not yet supported
+;; (setq org-mime-library 'vm)
+#+end_src
+* Usage
+** =M-x org-mime-htmlize=
+=M-x org-mime-htmlize= from within a mail composition buffer to export either
the entire buffer or just the active region to html, and embed the results into
the buffer as a text/html mime section.
+
+Export a portion of an email body composed using `mml-mode' to html using
`org-mode'. If called with an active region only export that region, otherwise
export the entire body.
+
+Warning: There has been some concern voiced over the potential complexity of
email resulting from calling this function on an active region resulting in
multiple =multipart/alternative= sections in the same email. Please see this
email thread for a discussion of the potential pitfalls of this approach.
Speaking from personal experience this has not been a problem for the author.
+
+** =M-x org-mime-org-buffer-htmlize=
+=org-mime-org-buffer-htmlize= can be called from within an Org-mode buffer to
export either the whole buffer or the narrowed subtree or active region to
HTML, and open a new email buffer including the resulting HTML content as an
embedded mime section.
+
+Export the current org-mode buffer to HTML using =org-export-as-html= and
package the results into an email handling with appropriate MIME encoding.
+
+The following key bindings are suggested, which bind the C-c M-o key sequence
to the appropriate org-mime function in both email and Org-mode buffers,
+#+begin_src elisp
+(add-hook 'message-mode-hook
+ (lambda ()
+ (local-set-key (kbd "C-c M-o") 'org-mime-htmlize)))
+(add-hook 'org-mode-hook
+ (lambda ()
+ (local-set-key (kbd "C-c M-o") 'org-mime-org-buffer-htmlize)))
+#+end_src
+
+** CSS style customization
+Email clients will often strip all global CSS from email messages. In the case
of web-based email readers this is essential in order to protect the CSS of the
containing web site. To ensure that your CSS styles are rendered correctly they
must be included in the actual body of the elements to which they apply.
+
+The `org-mime-html-hook' allows for the insertion of these important CSS
elements into the resulting HTML before mime encoding. The following are some
possible uses of this hook.
+
+For those who use color themes with Dark backgrounds it is useful to set a
dark background for all exported code blocks and example regions. This can be
accomplished with the following,
+
+#+begin_src elisp
+(add-hook 'org-mime-html-hook
+ (lambda ()
+ (org-mime-change-element-style
+ "pre" (format "color: %s; background-color: %s; padding: 0.5em;"
+ "#E6E1DC" "#232323"))))
+
+;; the following can be used to nicely offset block quotes in email bodies
+(add-hook 'org-mime-html-hook
+ (lambda ()
+ (org-mime-change-element-style
+ "blockquote" "border-left: 2px solid gray; padding-left: 4px;")))
+#+end_src
+
+For other customization options see the org-mime customization group.
+* Credits
+org-mime was developed by Eric Schulte with much-appreciated help and
discussion from everyone on the
[[https://lists.gnu.org/archive/html/emacs-orgmode/2010-03/msg00500.html][using
orgmode to send html mail]] thread especially Eric S. Fraga for adding WL
support.
+* Licence
+Documentation from the http://orgmode.org/worg/ website (either in its HTML
format or in its Org format) is licensed under the
[[http://www.gnu.org/copyleft/fdl.html][GNU Free Documentation License version
1.3]] or later. The code examples and css stylesheets are licensed under the
[[http://www.gnu.org/licenses/gpl.html][GNU General Public License v3 or
later]].
- [nongnu] elpa/org-mime 0db41d5b4e 065/118: emergency fix of broken 0.1.4, (continued)
- [nongnu] elpa/org-mime 0db41d5b4e 065/118: emergency fix of broken 0.1.4, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 470808cc14 070/118: Added support for MAIL_FROM property, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 5132ec0586 089/118: Improve signature separator regex, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 744f5f3315 090/118: Merge pull request #49 from ahttraga/master, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime dc7ae1de85 094/118: Show individual paragraphs in gmail reply quotes, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 85c98739f3 001/118: import original org-mime, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 8d7797ea07 007/118: clean code according to org review, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime b33c96b2d0 015/118: embedded image could use absolute path, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime dd1b9881af 027/118: remove drawers when org-mime-htmlize-subtree at emacs 24.3, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 8067e76eb1 029/118: add documentation on embedded image, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 80b4e3a3b4 008/118: add readme,
ELPA Syncer <=
- [nongnu] elpa/org-mime fb265448df 038/118: Merge pull request #14 from unhammer/issue13-OPTIONS-noise, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 0752659f7a 042/118: No drawer exporting (default since Emacs 25), ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime db707a7337 040/118: Merge pull request #15 from unhammer/patch-1, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime bc61d4de7d 045/118: Merge pull request #18 from jkitchin/master, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 7e89b4b741 053/118: move cond out of the cleanup function, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 7bcb075550 060/118: CI and TDD, fixed some minor bug. bump 0.1.2, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 286330fa15 069/118: fixed: LaTeX fragment not exported correctly, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 6c7ddeaade 068/118: fixed CI, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 73c13fdd0b 075/118: Merge pull request #39 from czan/master, ELPA Syncer, 2022/01/05
- [nongnu] elpa/org-mime 1162095645 086/118: Catch signature in html convert, ELPA Syncer, 2022/01/05