From cbef40f96bfd754b25f999f3fad084fe04a47187 Mon Sep 17 00:00:00 2001 From: Marius Peter Date: Sat, 25 Sep 2021 18:49:17 -0700 Subject: Misc. --- smart-documents.org | 37 ++++++++++++++++++++++++++++--------- 1 file 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 -- cgit v1.2.3