Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
1334 lines (1089 sloc) 43.8 KB

Updated: <2019-05-08 09:28:54>

init.org

This file must be tangled into init.el in the emacs configuration directory, ~/init.d/.

;; Tangle this file into init.el, then load it.
;; Output logged in *Messages* buffer
(message "Tangled and Loaded!\n  |- %s\n  |- %s\n  |- %s"

         ;; tangled file name
         (car
          (org-babel-tangle-file
           buffer-file-name
           (expand-file-name (concat user-emacs-directory "init.el"))
           "emacs-lisp"))

         ;; date and time of tangle
         (format-time-string "%Y-%m-%d.%H-%M-%S" (current-time))

         ;; load tangled file
         (load (concat user-emacs-directory "init.el")))

Tangle to init.el [3/4]

  • [X] Add :tangle no to the eval block
  • [X] Remove :tangle header from source blocks.
  • [X] Add date completed
  • [ ] Add prompt before overwriting init.el. OR… just do it and backup old one?

Initialize

package - REQUIRED

(package-initialize) must come before configurations of installed packages.

;; Using defaults from DOOM config https://github.com/hlissner/doom-emacs/wiki/FAQ
(setq gc-cons-threshold 402653184      ; default is 800,000 ... too small!
      gc-cons-percentage 0.6)   

;; Do not edit this file.  See "init.org"
;; This file is generated from init.org using org-babel-tangle
(setq package-enable-at-startup nil)
(package-initialize)

;; packages: use up-to-date MELPA, not ELPA
(when (>= emacs-major-version 24)
  (require 'package)
  (add-to-list
   'package-archives
   '("melpa" . "http://melpa.org/packages/")
   t)
  (package-initialize))

use-package

;; This is only needed once, near the top of the file
(eval-when-compile
  ;; Following line is not needed if use-package.el is in ~/.emacs.d
  (add-to-list 'load-path "<path where use-package is installed>")
  (require 'use-package))                ; we want this instead of 'require
            
(setq use-package-always-ensure t)      ; ensure package is installed
(setq use-package-verbose t) 		; report config loading time in *Messages*

Private

Load things that should be slightly more private.

;; ensure init_private.el is loaded
(setq init_private_loaded
      (load
       (concat user-emacs-directory
               "init_private.el")))
;; defines: my/user-dir, my/on-work-pc, my/user-name, my/computer-name, my/org-directory

Emacs - General

User - name, email

(setq user-full-name "Steven Brown")
(setq user-mail-address "steven.w.j.brown@gmail.com")

Calendar

(setq holiday-general-holidays nil)     ; Remove US defaults, add back some later

;; `calendar-holidays' initialized from multiple *holidays lists.  used in both
;; calendar and org agenda.  Once loaded, `calendar-holidays' must be modified
;; directly.
(setq holiday-local-holidays            ; Canada/BC Holidays
      '((holiday-fixed 1 1 "New Year's Day")
        (holiday-float 2 1 3 "Family Day")
        (holiday-easter-etc -2 "Good Friday")
        (holiday-easter-etc 1 "Easter Monday")
        (holiday-float 5 1 -2 "Victoria Day")
        (holiday-fixed 6 21 "Aboriginal Day")
        (holiday-fixed 7 1 "Canada Day")
        (holiday-float 8 1 1 "BC Day")
        (holiday-float 9 1 1 "Labour Day")
        (holiday-float 10 1 2 "Thanksgiving (Canadian)")
        (holiday-fixed 11 11 "Remembrance Day")
        (holiday-fixed 12 25 "Christmas")
        (holiday-fixed 12 26 "Boxing Day")))

(setq holiday-other-holidays            ; US and shared non-Stats
      '((holiday-float 1 1 3 "Martin Luther King Day (US)")
        (holiday-fixed 2 2 "Groundhog Day")
        (holiday-fixed 2 14 "Valentine's Day")
        (holiday-float 2 1 3 "President's Day (US)")
        (holiday-fixed 3 17 "St. Patrick's Day")
        (holiday-fixed 4 1 "April Fools' Day")
        (holiday-float 5 0 2 "Mother's Day")
        (holiday-float 5 1 -1 "Memorial Day (US)")
        (holiday-fixed 6 14 "Flag Day (US)")
        (holiday-float 6 0 3 "Father's Day")
        (holiday-fixed 7 4 "Independence Day (US)")
        (holiday-float 10 1 2 "Columbus Day (US)")
        (holiday-fixed 10 31 "Halloween")
        (holiday-fixed 11 11 "Veteran's Day (US)")
        (holiday-float 11 4 4 "Thanksgiving (US)")))

General - colour, lines, columns, backups, frame

(setq ansi-color-faces-vector
      [default bold shadow italic underline bold bold-italic bold])
(setq-default fill-column 80)      ; where to wrap lines; set locally with C-x f
(set-default 'truncate-lines t)    ; truncate long lines, don't wrap them
(setq column-number-mode t)        ; show column numbers in modeline
(setq inhibit-startup-screen t)    ; skip startup screen
(setq tool-bar-mode nil)           ; Remove clunky toolbar and icons
(show-paren-mode t)                ; highlight matching parentheses
(setq show-paren-delay 0)
(setq show-paren-when-point-inside-paren t)
(setq show-paren-when-point-in-periphery t)
(setq show-paren-style 'parenthesis)    ; "mixed" and "expression" is far too obnoxious for incomplete expressions
(global-hl-line-mode t)            ; highlight current line
(setq visible-bell t)              ; blink, don't bark
(setq x-stretch-cursor t)          ; cursor width will match tab character width
(set-default 'indent-tabs-mode nil)

;;(setq uniquify-buffer-name-style (quote forward) nil (uniquify))
(setq uniquify-buffer-name-style (quote post-forward-angle-brackets))

(desktop-save-mode 0)         ; save the desktop/state of emacs' frames/buffersb
(setq backup-directory-alist `(("." . ,(concat user-emacs-directory ".backups")))) ; keep in clean
(setq backup-by-copying t)              ; vs renaming
(put 'narrow-to-region 'disabled nil)   ; enable narrowing C-x n n

(toggle-scroll-bar 0)
(tool-bar-mode 0)
(global-eldoc-mode 1)                  ; highlight parameters in minibuffer
(setq reb-re-syntax 'string)           ; C-c TAB to cycle when in regexp-builder

;; see file-local variable: time-stamp-pattern, time-stamp-start, etc
(add-hook 'before-save-hook 'time-stamp) ; update timestamps of set format before saving

(setq delete-by-moving-to-trash t)     ; move files to trash instead of deleting

(add-hook 'image-mode-hook 'auto-revert-mode) ; update image buffers when files change

Fonts

list-fontsets to see available installed fonts.

Some good programming fonts here.

  1. Inconsolata
  2. Fira Mono
  3. Source Code Pro
  4. Anonymous Pro
  5. M+ 1M
  6. Hack
  7. DejaVu Sans Mono
  8. Droid Sans Mono
  9. Ubuntu Mono
  10. Bitsream Vera Sans Mono
;; Test char and monospace:
;; 0123456789abcdefghijklmnopqrstuvwxyz [] () :;,. !@#$^&*
;; 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ {} <> "'`  ~-_/|\?

;; (set-face-attribute 'default t :font "DejaVu Sans Mono" :height +1)
(setq default-font-name nil)
(cond
 ((find-font (font-spec :name "DejaVu Sans Mono"))
  (setq default-font-name "DejaVu Sans Mono")
  (setq default-font-size "12"))

 ((find-font (font-spec :name "Consolas"))
  (setq default-font-name "Consolas")
  (setq default-font-size "13"))

 ;; (set-frame-font "DejaVu Sans Mono-12"))
 ;; ((find-font (font-spec :name "Lucida Console"))
 ;;  (set-frame-font "Lucida Console-12"))
 ;; (setq default-font-name "Lucida Console"))
 ((find-font (font-spec :name "Courier New"))
  ;; (set-frame-font "Courier New-12"))
  (setq default-font-name "Courier New")
  (setq default-font-size "12"))
 )
;; (setq initial-frame-alist '((top . 1) (left . 1) (width . 80) (height . 55)))
(when default-font-name
  (add-to-list 'default-frame-alist
               (cons 'font (concat default-font-name
                                   "-"
                                   (or default-font-size "12")))))
;; (set-face-attribute 'default t :family "Monospace" :height +1)

Try a font

;; (set-frame-font "Lucida Console-14")
(set-frame-font "Consolas-13")

Look at installed fonts

(x-select-font nil t)

Themes

  • Custom Themes (not color-themes) can be loaded and stacked using load-theme.
  • Loaded themes must be unloaded individually by disable-theme.
  • Both allow tab-completion for applicable themes.
  • [ ] write script to cycle through installed themes at keypress?
;; (unless custom-enabled-themes
;;   (load-theme 'material t nil))		; load & enable theme, if nothing already set
(setq custom-theme-directory user-emacs-directory)
(load-theme 'two-fifteen t)
;; TESTING, not exported
(load-theme 'two-fifteen t)

UTF-8

(setq PYTHONIOENCODING "utf-8")        ;print utf-8 in shell
(prefer-coding-system 'utf-8)

;; Unicode characters cause some windows systems to hang obnoxiously
;; (Easily noticed in large org-mode files using org-bullets package.)
;; https://github.com/purcell/emacs.d/issues/273
(when (eq system-type 'windows-nt)
  (setq inhibit-compacting-font-caches t))

ibuffer - custom filters

(define-key global-map "\C-x\C-b" 'ibuffer) ;

(setq ibuffer-saved-filter-groups
  (quote
   (("ibuffer-filter-groups"
     ("Directories"
      (used-mode . dired-mode))
     ("Org Files"
      (used-mode . org-mode))
     ("Notebooks"
      (name . "\\*ein:.*"))
     ("Python"
      (used-mode . python-mode))
     ("Emacs Lisp"
      (used-mode . emacs-lisp-mode))
     ("Images"
      (used-mode . image-mode))
     ))))

(setq ibuffer-saved-filters
  (quote
   (("gnus"
     ((or
       (mode . message-mode)
       (mode . mail-mode)
       (mode . gnus-group-mode)
       (mode . gnus-summary-mode)
       (mode . gnus-article-mode))))
    ("programming"
     ((or
       (mode . emacs-lisp-mode)
       (mode . cperl-mode)
       (mode . c-mode)
       (mode . java-mode)
       (mode . idl-mode)
       (mode . lisp-mode)))))))

Packages

If there is a compile error, or “tar not found,” try package-refresh-contents to refresh the package database.

themes

Place to put themes 100% decided on.

(use-package material-theme :ensure t :defer t)
(use-package leuven-theme :ensure t :defer t)
;; (use-package spacemacs-theme
;;   :ensure t
;;   :defer t
;;   ;; :init (load-theme 'spacemacs-dark t)
;;   )

paredit - Intense parentheses mode (not enabled)

(use-package paredit
  :ensure t
  :defer t)

diminish

(use-package diminish :ensure t)

delight

smartparens - Minor mode to work with pairs

(use-package smartparens
  :ensure t
  :defer t
  :init
  :config
  (setq sp-smartparens-bindings "sp")
)

which-key - Comand popup

  • Gentle reminders and added discoverability.
(use-package which-key
  :ensure t
  :diminish which-key-mode
  :config
  (which-key-mode))

jedi - Auto-completion backend

This is an ac (autocomplete) backend, and we want to try company.
;; remove jedi ac package if present, we're going to use company
(when (featurep 'jedi)
    (package-delete jedi))

company - Auto-completion front-end

(use-package company
  :ensure t
  :diminish company-mode
  ;; (add-hook 'ein:connect-mode-hook 'ein:jedi-setup)
  ;; (add-hook 'ein:connect-mode-hook 'company-mode) ; Can't figure out company-jedi + ein

  :config
  (setq company-idle-delay 0.5)
  (setq company-minimum-prefix-length 1)
  (global-company-mode 1)
  )

(use-package company-quickhelp
  :ensure t
  :defer 2
  :config
  (company-quickhelp-mode 1)
  (setq company-quickhelp-delay 1.5)
  )

;; Reduce noise in candidate suggestions
(push (apply-partially
       #'cl-remove-if
       (lambda (c)
         (or (string-match-p "[^\x00-\x7F]+" c) ;non-ansii candidates
             (string-match-p "0-9+" c)        ;candidates containing numbers
             (if (equal major-mode "org")       ;
                 (>= (length c) 15))))) ; candidates >= 15 chars in org-mode
      company-transformers)

iedit - Simple refactoring

(use-package iedit
  :ensure t)

anaconda-mode - Python programming

(use-package anaconda-mode
  :ensure t
  :defer t
  :config
  (add-hook 'python-mode-hook 'anaconda-mode)        ; doc lookup, definition jump, etc
  (add-hook 'python-mode-hook 'anaconda-eldoc-mode)) ; argument prompt in mini-buffer

(use-package company-anaconda
  :ensure t
  :defer t
  :config
  (eval-after-load 'company
    '(add-to-list 'company-backends 'company-anaconda)))

esup - Emacs Start Up Profiler

Total User Startup Time: 0.285sec     Total Number of GC Pauses: 8     Total GC Time: 0.047sec
  • HOME Laptop, battery:
Total User Startup Time: 20.273sec    Total Number of GC Pauses: 12    Total GC Time: 0.511sec
ein-connect.elc:15  6.680sec   32% (x2)
gnus-sum.elc:16  1.953sec   9%
anaconda-mode.elc:16  1.742sec   8%
  • WORK Laptop:
Total User Startup Time: 81.152sec     Total Number of GC Pauses: 17     Total GC Time: 0.504sec
ein-connect.elc:15  21.581sec   26% (x2)
anaconda-mode.elc:16  15.036sec   18%
use-package.elc:15  2.944sec   3% (x2)
(use-package esup
  :ensure t)

ein - Emacs iron python notebook (Jupyter)

  • Jupyter Notebooks in emacs! Added [2017-10-19 Thu]
  • Slow. Include only when needed or designated configs
;; Jupyter python  ;added 2017-10-17
(use-package ein
  :ensure t
  :defer t
  ;; :backends ein:company-backend
  :init
  (require 'ein-connect)     ; not sure why this is needed suddenly..?

  ;; Fix Null value passed to ein:get-ipython-major-version #work pc
  ;; https://github.com/millejoh/emacs-ipython-notebook/issues/176
  ;; (ein:force-ipython-version-check)

  :config
  ;; (advice-add 'request--netscape-cookie-parse :around #'fix-request-netscape-cookie-parse)
  (setq ein:completion-backend 'ein:use-company-backend)
  )

smartscan - Simple word-instance jumping

  • easily move between like-symbols
  • NOTE: currently conflicts with ein checkpoint bindings.
(use-package smartscan
  :ensure t
  :defer 1
  ;; :bind (("M-n" . smartscan-symbol-go-forward)
  ;;        ("M-p" . smartscan-symbol-go-backward))
  )

org2blog - Blog to wordpress from org

(use-package org2blog
  :ensure t
  :defer 1
  :init
  :config
  ;; see init_private.el
  )

beacon - Highlight cursor when switching windows

  • animated indicator of cursor location when switching windows
(use-package beacon
  :ensure t
  :init
  (beacon-mode 0))                    ; causes slow updates on some comps

doom-modeline

(use-package doom-modeline
  :ensure t
  :config
  (setq doom-modeline-icon nil)
  :hook
  (after-init . doom-modeline-mode)
  )

spaceline - (Powerline) modeline

Ditched in favour of doom-modeline
(use-package spaceline
  :ensure t
  :config
  (require 'spaceline-config)
  (setq powerline-default-separator 'wave)
  (spaceline-spacemacs-theme))          ; quickly makes modeline pretty

anzu - Count isearch matches

(use-package anzu
  :ensure nil
  :config
  (global-anzu-mode +1))

origami - Code folding

(use-package origami
  :ensure t)

smex - Fuzzy M-x function matching

(use-package smex
  :ensure t
  :bind (;("M-x" . smex) replaced w/counsel
         ("M-X" . smex-major-mode-commands)
         ("C-c C-c M-x" . execute-extended-command)))

flycheck - Syntax-checking

https://github.com/flycheck/flycheck

(use-package flycheck
  :ensure t
  :defer t
  ;; :config
  ;; (global-flycheck-mode) <-- too noisy, enable when needed
  )

diff-hl - Highlight diffs

https://github.com/dgutov/diff-hl

(use-package diff-hl
  :ensure t
  :defer t
  :config
  (diff-hl-flydiff-mode)
  ;(global-diff-hl-mode)  ;; slow on lesser computers
  )

avy - Jump to visible text

https://github.com/abo-abo/avy

(use-package avy :ensure t
  :bind ("C-:" . avy-goto-char-2))

Ivy, Counsel, Swiper - Minibuffer completion suite

Suite of completion tools.

(use-package counsel                    ; requires swiper, which requires ivy
  :ensure t
  :demand
  :config
  (setq ivy-use-virtual-buffers t)
  (setq ivy-count-format "%d/%d ")      ; current/total match number
  (setq enable-recursive-minibuffers t)
  (setq ivy-re-builders-alist 
        '((t . ivy--regex-plus)))
        ;'((t . ivy--regex-fuzzy ))) ; try fuzzy matching
  ;; use ivy completion on any command using 'completing-read-function'
  (ivy-mode 1)
  (counsel-mode 1) ; use counsel equivalents of existing Emacs functions
  (diminish 'ivy-mode)
  (diminish 'counsel-mode)

  :bind (("C-s" . swiper)               ; Replace isearch-forward
         ))

rainbow-mode - Set bg to colour of #00000 string

http://elpa.gnu.org/packages/rainbow-mode.html

(use-package rainbow-mode :ensure t)

selected-packages [*has to be manually updated*]

package-selected-packages is used by ‘package-autoremove’ to decide which packages are no longer needed. But there was an issue with use-package not adding packages to package-selected-packages, so it has to be done manually..

You can use it to (re)install packages on other machines by running ‘package-install-selected-packages’.

See currently activated packages with package-activated-list.

  • [ ] Superceded by use-package?
 (setq package-selected-packages
	    (quote
	     (org-bullets tangotango-theme leuven-theme eziam-theme alect-themes
			  atom-one-dark-theme borland-blue-theme material-theme
			  helm helm-projectile expand-region org-projectile
			  projectile web-mode)))
  

expand-region - Select “up”

Example of how use-package can replace require and global-set-key.

(use-package expand-region
  :ensure t
  :defer 1
  :bind ("C-=" . er/expand-region))

wrap-region - Wrap region in matching characters

(use-package wrap-region
  :ensure t
  :config
  (wrap-region-add-wrappers
   '(("*" "*" nil org-mode)
     ("~" "~" nil org-mode)
     ("/" "/" nil org-mode)
     ("=" "=" ":" org-mode) ; Avoid conflict with expand-region, use ':'
     ("+" "+" "+" org-mode)
     ("_" "_" nil org-mode)))
     ;; ("$" "$" nil (org-mode latex-mode))
  (add-hook 'org-mode-hook 'wrap-region-mode))
(diminish 'wrap-region-mode)

projectile

(use-package projectile
  :ensure t				; ensure package is downloaded
  :defer t
  :init					; pre-load config
  (setq projectile-enable-caching t)	; resolve missing projects
  ;; (projectile-mode +1)			; global projectil mode
  :config nil				; post-load config
  )

org-bullets - Unicode org-mode bullets

https://thraxys.wordpress.com/2016/01/14/pimp-up-your-org-agenda/

(use-package org-bullets
  :ensure t
  :init
  (add-hook 'org-mode-hook (lambda () (org-bullets-mode t)))
  ;;  (setq org-bullets-bullet-list '("◉" "◎" "○" "►" "◇"))
  :config
  )

ace-window - DWIM window switcher

At the dispatcher (3 or more windows unless aw-dispatch-always = t):

  • x : delete window
  • m : swap windows
  • M : move window
  • j : select buffer
  • n : select the previous window
  • u : select buffer in the other window
  • c : split window fairly, either vertically or horizontally
  • v : split window vertically
  • b : split window horizontally
  • o : maximize current window
  • ? : show these command bindings
    (use-package ace-window
      :ensure t
      :bind ("M-o" . ace-window )           ; replace facemenu-keymap binding
      )
    (setq aw-scope 'frame)                  ; Only consider current frame's windows
        

magit - Git integration

A Git version control interface.

Recommended: ssh-keygen, add key to git host, ensure .ssh/ directory is in HOME directory (C:/Users/Username/AppData/Roaming/ on Windows 10)

(use-package magit
  :ensure t
  :defer t
  :bind ("C-x g" . magit-status)
  )

yasnippet

(use-package yasnippet
  :ensure t
)

org-gcal

https://github.com/myuhe/org-gcal.el
(use-package org-gcal
  :ensure t)
;;  See init_private.el for setup

org-gcal Usage

  • org-gcal-sync: Sync between Org and Gcal. before syncing, execute org-gcal-fetch
  • org-gcal-fetch: Fetch Google calendar events and populate org-gcal-file-alist locations. The org files in org-gcal-file-alist should be blank or all of their headlines should have timestamps.
  • org-gcal-post-at-point: Post/edit org block at point to Google calendar.
  • org-gcal-delete-at-point: Delete Gcal event at point.
  • org-gcal-refresh-token: Refresh the OAuth token. OAuth token expired in 3600 seconds, You should refresh token on a regular basis.

move-text

https://github.com/emacsfodder/move-text

M-UP and M-DOWN to move lines/regions

(use-package move-text
  :ensure t)
(move-text-default-bindings)

sdf

neotree

https://github.com/jaypei/emacs-neotree

(use-package neotree
  :ensure t
  :bind ("<f8>" . neotree-toggle)
  )

markdown-mode

Major mode for editing markdown.

(use-package markdown-mode
  :ensure t)

dictionary and thesaurus lookup

(use-package dictionary :ensure t
  :init
  :config
  ;; :bind ("" . dictionary-search)
  ;; ("" . dictionary-match-words)
  )
;; These didn't work, and I don't want any more external dependecies.
(use-package synosaurus :ensure t
  :init 
  :config
  (setq synosaurus-backend 'synosaurus-backend-openthesaurus)
  )

(use-package synonymous :ensure t)

ob-ipython - jupyter for org-mode

org-babel integration with Jupyter for evaluating code blocks.

;; INCREDIBLY slow startup time.  Disabled, run when needed.
(use-package ob-ipython
  :ensure t
  :config
  (add-hook 'ob-ipython-mode-hookp
            (lambda ()
              (company-mode 1)))
  (org-babel-do-load-languages
   'org-babel-load-languages
   '((ipython . t)
     ;; other languages..
     ))
  (add-to-list 'company-backends 'company-ob-ipython)
  )

ob-async - asynchronous execution of org-babel src blocks

https://github.com/astahlman/ob-async
;; INCREDIBLY slow startup time.  Disabled until needed.
(use-package ob-async
  :ensure t)

helpful - adding more info to emacs help

https://github.com/Wilfred/helpful

(use-package helpful
  :ensure t

  ;; replace default help functions
  :bind (("C-h f" . helpful-callable)
         ("C-h v" . helpful-variable)
         ("C-h k" . helpful-key)

         ;; additional
         ("C-c C-d" . helpful-at-point) ;
         ;; ("C-h F" . helpful-function) ; replace
         ;; ("C-h C" . helpful-command) ; 
         ))

multiple-cursors

http://stable.melpa.org/#/multiple-cursors

(use-package multiple-cursors
  :ensure t
  :defer t
  :init
  :config
  :bind (
         ("C-|" . 'mc/edit-lines)
         ("C->" . 'mc/mark-next-like-this)
         ("C-<" . 'mc/mark-previous-like-this)
         ("C-c C-<" . 'mc/mark-all-like-this)
         ("C-S-<mouse-1>" . 'mc/add-cursor-on-click)
         )
  )

pyvenv

(use-package pyvenv
:ensure t
:defer t
:init
(setenv "WORKON_HOME" (expand-file-name "~/AppData/Local/Continuum/Anaconda2/envs/"))
:config
:bind
)

org-listcruncher - Parse emacs org list contents into table

https://github.com/dfeich/org-listcruncher

gnus

erc

Dired

Let dired try to guess target (copy and rename ops) directory when two dired buffers open.

Also useful:

  • writeable dired:

-

(setq dired-dwim-target t)		; guess target directory

Org Mode

Export

(setq org-export-initial-scope 'subtree)
(setq org-use-subsuperscripts '{})      ; require {} wrapper for ^super/_sub scripts
;; postamble
(setq org-html-postamble 't)
(setq org-html-postamble-format
      '(("en" "<p class=\"author\">%a</p> <p class=\"date\">%T</p>")))

Files

  • [ ] Use platform independent home directory. (getenv “HOMEPATH”)
;; (add-to-list 'load-path "~/../or
;; my/org-directory defined in init_private.el
(setq org-agenda-files (list
			     (concat my/org-directory "/notes.org")    ; Home/Learn/Everything
			     (concat my/org-directory "/work.org")     ; Work
			     (concat my/org-directory "/agenda.org")))  ; Life Stuff - rename to 'personal'?

(setq org-default-notes-file (concat my/org-directory "/captured.org")) ; Unsorted  Notes

Capture

(setq org-capture-templates
      `(("t"				; key
         "Task (work)"                  ; description
         entry				; type
         ;; heading type and title
         (file+headline ,(concat my/org-directory "/work.org") "Inbox") ; target
         "* TODO %?\n  %i\n  %a\n"	; template
         ;; optional property list  ; properties
         :prepend t                     ; insert at head of list
         )
        ("T"				; key
         "Task (general)"               ; description
         entry				; type
         ;; heading type and title
         (file+headline org-default-notes-file "Tasks") ; target
         "* TODO %?\n  %i\n  %a\n"                      ; template
         ;; optional property list  ; properties
         :prepend t                     ; insert at head of list
         )
        ("m"				; key
         "Meeting (work)"               ; description
         entry                          ; type
         ;; heading type and title
         (file+headline ,(concat my/org-directory "/work.org") "MINUTES & MEETINGS") ; target
         "* %?\n  %^T  (entered %U from %a)\n  %i\n" ; template
         :prepend t
         )
        ("j"
         "Learning Journal"
         entry
         (file+datetree org-default-notes-file "Learning Journal")
         "* %?\n  Entered on %U\n  - Active Region: %i\n  - Created while at: %a\n" ; %a stores link, %i is active region
         )
        ))

Other

(setq org-ellipsis "")			;⤵, ▐, ►, ▽, ◿, ◹, », ↵, ≋, …, ⋞, ⊡, ⊹, ⊘

;; fontify (pretty formating) code in code blocks
(setq org-src-fontify-natively t)	; important for init.org !

;; org-refile (C-c C-w)
(setq org-refile-targets (quote ((nil :maxlevel . 5)
                                 (org-agenda-files :maxlevel . 5))))
(setq org-outline-path-complete-in-steps nil) ; prevent org interfering w/ivy
(setq org-refile-use-outline-path 'file) ; refile paths begin with the file name
(setq org-refile-allow-creating-parent-nodes 'confirm) ; confirm creation of new headings
(setq org-reverse-note-order t)         ; new notes at top of file or entry

;; org-mode customization
(setq org-log-done 'time)         ; add time stamp when task moves to DONE state
(setq org-todo-keywords           ; default TODO keywords
       '((sequence "TODO(t)" "STARTD(s)" "WAITING(w)" "|" "DONE(d)" "DELEGATED(e)" "CANCELLED(c)")))

;org-mode keybindings
(define-key global-map "\C-cc" 'org-capture)    ; todo: move to use-package :bind ?
(define-key global-map "\C-ca" 'org-agenda)     ;
(define-key global-map "\C-cl" 'org-store-link) ;

;; Add python to list of languages for org-babel to load
(org-babel-do-load-languages
 'org-babel-load-languages
 '((emacs-lisp . t)
   (python . t)
   (ipython . t)
   (ditaa . t)
   (plantuml . t)
   )
 )

;; Don't prompt before running org code blocks w/C-c C-c
(setq org-confirm-babel-evaluate nil)

;; http://cachestocaches.com/2018/6/org-literate-programming/
;; Fix an incompatibility between the ob-async and ob-ipython packages
(setq ob-async-no-async-languages-alist '("ipython"))

;; Enable single-key commands at beginning of headers
(setq org-use-speed-commands t)

;; Try org-indirect-buffer-display options
(setq org-indirect-buffer-display 'new-frame)
(setq org-src-window-setup 'other-frame)

Agenda

(setq org-agenda-skip-scheduled-if-deadline-is-shown t)

Windows

Libraries

Some things, eww (libxml), inline images (libpng) require libraries not shipped with emacs on Windows. Get those from https://sourceforge.net/projects/ezwinports/ and install them to the /emacs/bin/ directory.

External Programs

Open with default Windows app (w32-browser)

(when (eq 'windows-nt system-type)
  (defun w32-browser (doc) (w32-shell-execute 1 doc))
  ;; Ctrl-ENT to open with default application
  (eval-after-load "dired"
    '(define-key dired-mode-map [C-return]
       (lambda ()
         (interactive)
         (w32-browser (dired-replace-in-string "/" "\\" (dired-get-filename)))))))

Spelling & Dictionaries (aspell/ispell/hunspell)

(setenv "LANG" "en_CA.UTF-8")
(setq-default ispell-program-name "hunspell")
(setq ispell-dictionary "en_CA")

Cygwin

https://www.emacswiki.org/emacs/NTEmacsWithCygwin#toc2

;; Sets your shell to use cygwin's bash, if Emacs finds it's running
;; under Windows and c:\cygwin exists. Assumes that C:\cygwin\bin is
;; not already in your Windows Path (it generally should not be).
;;

(if (string-match-p (regexp-quote "steven.brown") (getenv "USERPROFILE"))
    (setq my/env "work")
  (setq my/env "personal"))


(let* ((cygwin-root (if (string-equal my/env "work")
                        "c:/Users/steven.brown/Apps/cygwin64" ; work
                      "c:/Program Files/cygwin64"))	      ; home
       (cygwin-bin (concat cygwin-root "/bin")))
  (when (and (eq 'windows-nt system-type)
             (file-readable-p cygwin-root))

    (setq exec-path (cons cygwin-bin exec-path))
    (setenv "PATH" (concat cygwin-bin ";" (getenv "PATH")))

    ;; By default use the Windows HOME. (userdir/AppData/Roaming/.emacs.d)
    ;; (setenv "HOME" (getenv "USERPROFILE"))
    ;; Otherwise, uncomment below to set a HOME
    ;;      (setenv "HOME" (concat cygwin-root "/home/eric")) ;TODO: Customize by environment

    ;; NT-emacs assumes a Windows shell. Change to bash.
    (setq shell-file-name "bash")
    (setenv "SHELL" shell-file-name)
    (setq explicit-shell-file-name shell-file-name)

    ;; This removes unsightly ^M characters that would otherwise
    ;; appear in the output of java applications.
    (add-hook 'comint-output-filter-functions 'comint-strip-ctrl-m)

    ;; explicitly set dictionary path
    (setq ispell-hunspell-dict-paths-alist
          `(("en_CA" ,(concat (file-name-as-directory cygwin-root) "usr/share/myspell/en_CA.aff"))
            ("en_US" ,(concat (file-name-as-directory cygwin-root) "usr/share/myspell/en_US.aff"))
            ("en_GB" ,(concat (file-name-as-directory cygwin-root) "usr/share/myspell/en_GB.aff"))
            ))
    ))

PlantUML & Ditaa Diagramming (Java)

Look for Java JAR files, set variables if found. Currently keep location simple across all setups. PlantUML requires graphviz, which can be installed on Cygwin on Windows.

(let* ((plantuml-filepath (expand-file-name "~/plantuml.jar"))
       (ditaa-filepath (expand-file-name "~/ditaa0_9.jar")))
  (if (file-readable-p plantuml-filepath)
      (setq org-plantuml-jar-path plantuml-filepath))
  (if (file-readable-p ditaa-filepath)
      (setq org-ditaa-jar-path ditaa-filepath))
  )

Finally

After environment setup is complete, do any remaining things like opening files and setting key maps.

;(my/disable-all-themes custom-enabled-themes) ; just in case multiple
;(my/load-theme 'two-fifteen)                  ; load starting theme

;; Open a couple files
(dired (concat my/org-directory "/*.org")) ; filter to .org files in org

(find-file (concat my/user-dir "/Projects/dotemacs/init.org"))
                                           ; directory
(if my/on-work-pc
    (find-file (concat my/org-directory "/work.org"))
  (find-file (concat my/org-directory "/private.org")))

;; Reset garbage collection threshold
(add-hook 'emacs-startup-hook
          (lambda ()
            (setq gc-cons-threshold 16777216
                  gc-cons-percentage 0.1)))

Keybindings

Navigating links and buttons easily and consistently between different special modes.

If moving this block before modes are initialized, (derived-mode-init-mode-variables 'Info-mode) should be called before each mapping.

;; l = back (last), r (reverse?) = forward

;; Info-mode
(derived-mode-init-mode-variables 'Info-mode)
(define-key Info-mode-map (kbd "u") 'Info-up)
(define-key Info-mode-map (kbd "j") 'Info-next-reference)
(define-key Info-mode-map (kbd "k") 'Info-prev-reference)

;; help-mode
(derived-mode-init-mode-variables 'help-mode)
(define-key help-mode-map (kbd "j") 'forward-button)
(define-key help-mode-map (kbd "k") 'backward-button)

;; apropos-mode
(derived-mode-init-mode-variables 'apropos-mode)
(define-key apropos-mode-map (kbd "j") 'forward-button)
(define-key apropos-mode-map (kbd "k") 'backward-button)

;; helpful-mode
(derived-mode-init-mode-variables 'helpful-mode)
(define-key helpful-mode-map (kbd "j") 'forward-button)
(define-key helpful-mode-map (kbd "k") 'backward-button)

Notes

KeyWhat
C-c ’narrow on code block in sibling window (and return)
C-c C-v ttangle
C-c C-v ftangle into specific filename, like “init.el”
C-c C-v norg-babel-next-src-block
C-c C-v porg-babel-previous-src-block

Converting from .emacs or init.el

(custom-set-variables
 '(my-variable value)
 '(column-number-mode t)
 ; ...
)

:

–>

(setq column-number-mode t)

Reference:

You can’t perform that action at this time.