about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorCase Duckworth2020-12-03 21:58:56 -0600
committerCase Duckworth2020-12-03 21:58:56 -0600
commit5a0f4403507e3d95ffd7dfd47a13e3d01a5835cb (patch)
tree5f4303e8ffb5b10c87c398f2de5b74f95ec2fef6
parentUpdate link (diff)
downloademacs-5a0f4403507e3d95ffd7dfd47a13e3d01a5835cb.tar.gz
emacs-5a0f4403507e3d95ffd7dfd47a13e3d01a5835cb.zip
Update README
-rw-r--r--README.md92
1 files changed, 89 insertions, 3 deletions
diff --git a/README.md b/README.md index 0473400..3f1adfa 100644 --- a/README.md +++ b/README.md
@@ -186,6 +186,27 @@ The one annoying thing is that this bootstrap code doesn't work on Windows for s
186 (load bootstrap-file nil 'nomessage)) 186 (load bootstrap-file nil 'nomessage))
187 187
188 188
189## … but first: override the definition of straight.el to use the `develop` branch
190
191For the KeePassXC bits later, I need the `develop` branch of straight, so I can pass a `:build` keyword. I can do this, but I have to override the recipe for `straight.el` itself. I do that here. For more information, see [the README](https://github.com/raxod502/straight.el#overriding-recipes).
192
193 (setq straight-repository-branch "develop")
194
195 (defvar bootstrap-version)
196 (let ((bootstrap-file
197 (expand-file-name "straight/repos/straight.el/bootstrap.el"
198 user-emacs-directory))
199 (bootstrap-version 5))
200 (unless (file-exists-p bootstrap-file)
201 (with-current-buffer
202 (url-retrieve-synchronously
203 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
204 'silent 'inhibit-cookies)
205 (goto-char (point-max))
206 (eval-print-last-sexp)))
207 (load bootstrap-file nil 'nomessage))
208
209
189## Use [use-package](https://jwiegley.github.io/use-package/) 210## Use [use-package](https://jwiegley.github.io/use-package/)
190 211
191Like I said, `straight.el` hooks into `use-package` easily. These two lines get the latter to use the former by default. 212Like I said, `straight.el` hooks into `use-package` easily. These two lines get the latter to use the former by default.
@@ -309,7 +330,7 @@ I also want to switch themes between night and day.
309# Simplify GUI 330# Simplify GUI
310 331
311 332
312<a id="org6553b8c"></a> 333<a id="org1f12d35"></a>
313 334
314## Frame defaults 335## Frame defaults
315 336
@@ -340,7 +361,7 @@ Of course, on the minibuffer, I want to make sure there's no scrollbar &#x2013;
340 361
341## Remove unneeded GUI elements 362## Remove unneeded GUI elements
342 363
343The [Frame Defaults](#org6553b8c) section sets up the frame to be free of visual clutter, but *this* section allows us to toggle that clutter's visibility easily, with one call to each of these functions. 364The [Frame Defaults](#org1f12d35) section sets up the frame to be free of visual clutter, but *this* section allows us to toggle that clutter's visibility easily, with one call to each of these functions.
344 365
345 (menu-bar-mode -1) 366 (menu-bar-mode -1)
346 (tool-bar-mode -1) 367 (tool-bar-mode -1)
@@ -976,6 +997,24 @@ from [zzamboni.org](https://zzamboni.org/post/beautifying-org-mode-in-emacs/)
976 "•")))))) 997 "•"))))))
977 998
978 999
1000### [org-superstar](https://github.com/integral-dw/org-superstar-mode)
1001
1002 (use-package org-superstar
1003 :custom
1004 (org-superstar-headline-bullets-list
1005 '(?❧ ?✪ ?③ ?④ ?⑤ ?⑥ ?⑦ ?⑧ ?⑨ ?●))
1006 (org-superstar-cycle-headline-bullets nil)
1007 (org-superstar-item-bullet-alist
1008 '((?* . ?★)
1009 (?+ . ?‣)
1010 (?- . ?•)))
1011 :custom-face
1012 (org-superstar-header-bullet
1013 ((t (:weight normal))))
1014 :hook
1015 (org-mode . org-superstar-mode))
1016
1017
979### Enable markdown export 1018### Enable markdown export
980 1019
981 (require 'ox-md) 1020 (require 'ox-md)
@@ -1546,6 +1585,44 @@ I've just recently started (again) using mu4e. We'll see how it goes.
1546 :branch "main")) 1585 :branch "main"))
1547 1586
1548 1587
1588<a id="orgb5347d4"></a>
1589
1590## KeePassXC integration
1591
1592I use KeePassXC, and I'd *like* to use KeePassXC to get passwords and stuff at home. So I'm trying this library out, since the secret-tool integration isn't built into the KeePassXC on Void. If this doesn't work, looks like I'll have to become a packager 😜
1593
1594 (when (eq system-type 'gnu/linux)
1595 (use-package sodium
1596 :straight (sodium
1597 :host github
1598 :repo "dakra/sodium.el"
1599 :build ("make"))
1600 :init
1601 (add-to-list 'load-path
1602 (expand-file-name "straight/repos/sodium.el"
1603 user-emacs-directory)))
1604 (use-package keepassxc
1605 :straight (keepassxc
1606 :host github
1607 :repo "dakra/keepassxc.el")
1608 :after (sodium)))
1609
1610
1611### libsodium integration
1612
1613I had to manually run `make` in the repo this time around, for some reason. Should probably look into that &#x2026; when it's not 1:00 AM.
1614
1615 (use-package sodium
1616 :straight (sodium
1617 :host github
1618 :repo "dakra/sodium.el"
1619 :build ("make"))
1620 :init
1621 (add-to-list 'load-path
1622 (expand-file-name "straight/repos/sodium.el"
1623 user-emacs-directory)))
1624
1625
1549# Appendix A: Scripts 1626# Appendix A: Scripts
1550 1627
1551 1628
@@ -1562,9 +1639,18 @@ if ! emacsclient -nc "$@" 2>/dev/null; then
1562# Appendix B: areas for further research 1639# Appendix B: areas for further research
1563 1640
1564- [ebuku](https://github.com/flexibeast/ebuku) (of course, I'd need [buku](https://github.com/jarun/buku) as well) &#x2013; bookmarks 1641- [ebuku](https://github.com/flexibeast/ebuku) (of course, I'd need [buku](https://github.com/jarun/buku) as well) &#x2013; bookmarks
1565- [KeePassXC as Secret Service](https://www.billdietrich.me/Authentication.html?expandall=1#KeePassXCandSecretService) 1642- [KeePassXC as Secret Service](https://www.billdietrich.me/Authentication.html?expandall=1#KeePassXCandSecretService) &#x2013; see [14.7](#orgb5347d4)
1566- [Ignoramus](https://github.com/rolandwalker/ignoramus) &#x2013; this might not e necessary 1643- [Ignoramus](https://github.com/rolandwalker/ignoramus) &#x2013; this might not e necessary
1567- [Dynamic fonts](https://github.com/rolandwalker/dynamic-fonts) &#x2013; take a look @ this and compare with my fonts section 1644- [Dynamic fonts](https://github.com/rolandwalker/dynamic-fonts) &#x2013; take a look @ this and compare with my fonts section
1568- [Simple clipboard integration](https://github.com/rolandwalker/simpleclip) &#x2013; test with Windows, maybe 1645- [Simple clipboard integration](https://github.com/rolandwalker/simpleclip) &#x2013; test with Windows, maybe
1569- [visible mark](https://git.sr.ht/~iank/visible-mark) &#x2013; show where the marks are &#x2026; 1646- [visible mark](https://git.sr.ht/~iank/visible-mark) &#x2013; show where the marks are &#x2026;
1570- consider this Reddit thread: [speeding up magit](https://www.reddit.com/r/emacs/comments/k3xfa1/speeding_up_magit/) 1647- consider this Reddit thread: [speeding up magit](https://www.reddit.com/r/emacs/comments/k3xfa1/speeding_up_magit/)
1648
1649
1650## export org to ODT on Windows
1651
1652Windows doesn't have `zip` natively (though it *does* have `curl` &#x2013; go figure!), so the ODT export for Org-mode won't work. There *is* a [StackOverflow discussion](https://stackoverflow.com/questions/8625306/org-mode-zip-needed-how-to-over-come) that mentions `p7zip` and a possible batch file, but I couldn't get that to work with a little testing. It might need more work.
1653
1654Something that *did* work was downloading `zip.exe` from [Info-ZIP](http://infozip.sourceforge.net/), and placing it somewhere in `exec-path` &#x2013; though of course, *then* you need `unzip.exe`, apparently in the same folder. Git Portable ships with `unzip.exe`, for example, but even though it's in `exec-path`, org-export threw an error unless `zip` and `unzip` were in the *same* folder.
1655
1656So I might either (a) have to set up computers in this way when I use new ones, or (b) include both `zip.exe` and `unzip.exe` in *this* Git repo, or &#x2026; something else. A true quandry.