summaryrefslogtreecommitdiff
path: root/smart-documents.org
diff options
context:
space:
mode:
authorMarius Peter <marius.peter@tutanota.com>2021-09-25 18:49:17 -0700
committerMarius Peter <marius.peter@tutanota.com>2021-09-25 18:49:17 -0700
commitcbef40f96bfd754b25f999f3fad084fe04a47187 (patch)
treea99606de6ed41d1fa9353e4ae5bed01833992757 /smart-documents.org
parentc59bffecec1de4e1e88ffdc2959d15f7cd2354a8 (diff)
Misc.
Diffstat (limited to 'smart-documents.org')
-rw-r--r--smart-documents.org37
1 files changed, 28 insertions, 9 deletions
diff --git a/smart-documents.org b/smart-documents.org
index 1a72a86..b8b0863 100644
--- a/smart-documents.org
+++ b/smart-documents.org
@@ -33,6 +33,13 @@ personal GNU Emacs customizations with a tutorial. This paper is a
** TODO Soft-coded paths
+** TODO Normalize `sd-path-' names
+
+=sd-paths= alist?
+
+** TODO Project vision/values/core objectives
+
+
* Introduction
The following sections were laid out very deliberately. When we start
@@ -221,7 +228,9 @@ All third-party resources are saved at the following location.
#+BEGIN_SRC emacs-lisp :tangle yes
(defcustom sd-path-resources
(concat user-emacs-directory "resources/")
- "Directory containing the third-party resources.")
+ "Directory containing the third-party resources.
+ Resources may be any data that is not auto-generated during Emacs
+ startup.")
#+END_SRC
**** Packages
@@ -247,6 +256,13 @@ This path, specifically, is required to be in list form.
(list (concat sd-path-resources "snippets/")))
#+END_SRC
+**** Templates
+
+#+BEGIN_SRC emacs-lisp :tangle yes
+ (setq sd-path-templates
+ (concat sd-path-resources "templates/"))
+#+END_SRC
+
**** Emojis
#+BEGIN_SRC emacs-lisp :tangle yes
@@ -1186,9 +1202,10 @@ shortcut (cf. Section [[Open Org mode document properties]]).
'(emacs-lisp-checkdoc))))
#+END_SRC
-*** COMMENT Timestamps
-
-# This is a terrible idea :-(
+*** Timestamps
+# This is a terrible idea :-( but leaving the option to the
+# reader. Long live ISO-8601!
+# https://orgmode.org/manual/Custom-time-format.html
More literary timestamps are exported to LaTeX using the following
custom format:
@@ -1388,7 +1405,8 @@ This /letter/ template completes the other default LaTeX classes.
("\\subsubsection*{%s}" . "\\subsubsection*{%s}")))
#+END_SRC
-*** Table of contents
+*** COMMENT Table of contents
+# Commented out on <2021-09-21 Tue>.
By default, body text can immediately follow the table of contents. It
is however cleaner to separate table of contents with the rest of the
@@ -1407,9 +1425,9 @@ green in Org's LaTeX exports. Very stylish, much flair!
(use-package tex
:defer t
:ensure auctex
- :ensure auctex-latexmk
- :config
- (setq TeX-auto-save t))
+ :ensure auctex-latexmk)
+ ;; :config
+ ;; (setq TeX-auto-save t))
(auctex-latexmk-setup)
#+END_SRC
@@ -1895,6 +1913,7 @@ Disable minibuffer scroll bar.
* Themes
# This is just another comment.
+
Without a carefully designed theme, our editor would become
unusable. Thus, we /describe/ two themes that were developed
*purposefully* and iteratively.
@@ -2121,7 +2140,7 @@ users.
If the following variable is set to nil, ~org-babel~ will not ask to
confirm the evaluation of source code blocks during export or
-tangling.
+tangling of this very file.
: Local Variables:
: org-confirm-babel-evaluate: t
Copyright 2019--2024 Marius PETER