whompmacs/README.org

80 lines
3.9 KiB
Org Mode
Raw Normal View History

2024-07-07 02:41:38 +00:00
#+BEGIN_CENTER
2024-07-07 01:17:35 +00:00
#+CAPTION: ThwapMacs: T.H.W.A.P. GNU Emacs Configuration
#+NAME: logo
2024-07-07 02:41:38 +00:00
#+ATTR_HTML: :align center
2024-07-07 01:17:35 +00:00
[[./logos/logo3.png]]
2024-07-07 02:41:38 +00:00
#+END_CENTER
2024-07-07 01:17:35 +00:00
2024-07-05 16:43:12 +00:00
* T.H.W.A.P. Emacs Configuration
I recently advised someone against rolling their own emacs configuration. Then I did it, because I'm smart like that.
As it turns out, yeah, I was wrong. The result of rolling my own is a nice fast distribution that is somewhat opinionated.
2024-07-06 18:10:53 +00:00
No doubt I've been helped along that journey by much reading and worthy YouTube Emacs content. And in that spirit I am
publishing this configuration, and endeavoring to ensure that it is well commented and documented. If you have questions,
concerns, or suggestions, feel free to start a discussion by opening an issue. If you have suggestions, and can't be asked
to interact with someone, I get it, feel free to send a PR and we can communicate through code if that works for you.
2024-07-05 16:47:38 +00:00
** Installation
Simply clone this repository as your ~/.emacs.d directory and start emacs.
#+BEGIN_SRC
2024-07-06 18:10:53 +00:00
$ test -d ~/.emacs.d && mv ~/.emacs.d ~/emacs.d
$ git clone https://github.com/fuzzy/thwapmacs ~/.emacs.d
$ emacs # start up emacs in the normal way and let it bootstrap
2024-07-05 16:47:38 +00:00
#+END_SRC
This configuration bootstraps and uses straight.el to manage all package installations.
2024-07-05 16:43:12 +00:00
2024-07-07 01:13:47 +00:00
Once you get emacs started, you will quickly find, that it is nearly as minimal as it can be. straight.el and use-package
will have been bootstrapped, along with golden-ratio. There is a handy note in the keybindings listed on the dashboard
telling you which keys to press, in order to get to the customization group. From there, you can enable and configure
all of the avaiable layers of support. That keybinding for reference, is _C-c t C-c_.
2024-07-08 06:04:09 +00:00
#+BEGIN_CENTER
2024-07-07 01:13:47 +00:00
#+CAPTION: An example of the configuration options, in console mode
#+NAME: config
2024-07-08 06:04:09 +00:00
#+ATTR_HTML: :align center
2024-07-07 01:13:47 +00:00
[[./config.png]]
2024-07-08 06:04:09 +00:00
#+END_CENTER
2024-07-07 01:13:47 +00:00
2024-07-05 16:43:12 +00:00
** Help
All keybindings set in this configuration are listed on the dashboard. Any other keybindings set by this configuration
were the recommended defaults from the package. If a non-default was chosen, it is listed in the help information on
2024-07-06 16:49:20 +00:00
the dashboard.
2024-07-06 18:10:53 +00:00
Additionally, with any custom configuration you may do, if you wish your keybindings to be added to the _thwap-map_,
you may do so with the provided _thwap/add-key-binding_ function, like so:
2024-07-06 16:49:20 +00:00
#+begin_src emacs-lisp
2024-07-06 18:10:53 +00:00
(thwap/add-key-binding
"M-s"
'org-edit-special
"Edit the source at this point, in it's native mode")
2024-07-06 16:49:20 +00:00
#+end_src
2024-07-06 18:10:53 +00:00
This will prefix it with _C-c t_ like all other T.H.W.A.P. Emacs commands, but it will also place the help message
2024-07-06 16:49:20 +00:00
into the dashboard's greeting message as a reminder.
2024-07-06 18:10:53 +00:00
** Features
T.H.W.A.P. Emacs (or thwapmacs) is configured to be minimal out of the box, however has rich support for many different
packages. All of these are off by default with *VERY* few exceptions. Below you will find a list of all the optional
packages that are natively supported. Further, we'll go over how you can add your own configuration options and take
advantage of the configuration interface.
2024-07-10 09:01:55 +00:00
*** Non-Optional/Default packages
2024-07-06 18:10:53 +00:00
1. [[https://github.com/radian-software/straight.el][straight.el]] - straight works with use-package to fetch and setup local installations.
2. [[https://github.com/jwiegley/use-package][use-package]] - use-package is a fantastic package management system for local installs.
3. [[https://github.com/roman/golden-ratio.el][golden-ratio.el]] - Window size management for split buffers. Quite handy.
4. [[https://github.com/emacs-dashboard/emacs-dashboard][emacs-dashboard]] - A nice handy startup screen, filled with fun facts and stuff.
5. [[https://github.com/joaotavora/yasnippet][yasnippet]] - A handy snippet/macro system for commonly used bits.
*** Optional packages
2024-07-10 09:01:55 +00:00
Optional packages are getting their own special home in the _doc/_ directory, so please refer to that location
for any documentation on what packages are included.