(Emacs/config)~Cleaned up some descriptions

This commit is contained in:
2024-06-11 18:35:05 +01:00
parent 6063ca78db
commit 65632113fe

View File

@@ -2207,11 +2207,16 @@ to elfeed for loading the system.
#+end_src #+end_src
** Magit ** Magit
Magit is *the* git porcelain for Emacs, which perfectly encapsulates Magit is *the* git porcelain for Emacs, which perfectly encapsulates
the git cli. In this case I just need to setup the bindings for it. the git CLI. It's so good that some people use Emacs just to use it.
As magit will definitely load after evil (as it must be run by a It's difficult to describe well without using it, in my opinion, and
binding, and evil will load after init), I can use evil-collection it integrates so well with Emacs that there is very little need to use
freely. Also, define an auto insert for commit messages so that I the git CLI ever.
don't need to write everything myself.
In this case I just need to setup the bindings for it. As magit will
definitely load after evil (as it must be run by a binding, and evil
will load after init), I can use evil-collection freely. Also, define
an auto insert for commit messages so that I don't need to write
everything myself.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package magit (use-package magit
@@ -2288,21 +2293,26 @@ Core proced config, just a few bindings and evil collection setup.
** Calculator ** Calculator
Surprise, surprise Emacs comes with a calculator. Surprise, surprise Emacs comes with a calculator.
Greater surprise, this thing is over powered. It can perform the
following (and more):
- Matrix calculations
- Generalised calculus operations
- Equation solvers for n-degree multi-variable polynomials
- Embedded mode (check below)!
~calc-mode~ is a calculator system within Emacs that provides a ~calc-mode~ is a calculator system within Emacs that provides a
diverse array of mathematical operations. It uses reverse polish diverse array of mathematical operations. It uses reverse polish
notation to do calculations (though there is a standard infix notation, but there is a standard infix algebraic notation mode so
algebraic notation mode). don't be too shocked. It can do a surprising amount of stuff, such
as:
+ finding derivatives/integrals of generic equations
+ matrix operations
+ finding solutions for equations, such as for finite degree multi
variable polynomials
Embedded mode allows computation with the current buffer as the echo It also has this thing called embedded mode. This allows one to
area. This basically means I can compute stuff within a buffer perform computation within a non ~calc-mode~ buffer. Surround any
without invoking calc directly: $1 + 2\rightarrow_{\text{calc-embed}} 3$. equation with dollar signs (such as 2^20, for example) and call
~(calc-embedded)~ with your cursor on it to compute it. It'll replace
the equation with the result it computed.
Say I want to find the 4th power of 2 cos I'm writing some bit
manipulation code and I need to set the 4th bit of some variable to 1.
Instead of computing it outside of my editor then copying the result
back in, I can just do it within Emacs. Pretty nifty, right?
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package calc (use-package calc
@@ -2881,24 +2891,33 @@ Counsel integration for projectile commands, very nice.
"K" #'devdocs-lookup)) "K" #'devdocs-lookup))
#+end_src #+end_src
* Org mode * Org mode
2023-03-30: finally decided to give org mode its own section. Org is, at its most basic, a markup language. =org-mode= is a major
mode for Emacs to interpret org buffers. org-mode provides a lot of
Org is, at its most basic, a markup language. Files use the ".org" capabilities, some are:
extension and use =org-mode= to write text, with the ability to export + A complete table based spreadsheet system, with formulas (including
to a few formats, all within Emacs. Some other features include:
+ A complete spreadsheet system, with formulas (including
[[*Calculator][calc-mode]] integration) [[*Calculator][calc-mode]] integration)
+ Evaluation of code blocks, even using the results of them in exports + Code blocks with proper syntax highlighting and editing experience
(to, say, a $\LaTeX$ or HTML document) + Evaluation
+ This includes exporting code blocks to a code file. All the + Export of code blocks to a variety of formats
emacs-lisp code blocks in this file are compiled to =config.el= + Export of code blocks to a code file (so called "tangling", which
([[file:elisp/literate.el][literate]]) is what occurs in this document)
+ Complete calendar/todo system with deadlines, scheduling and + Feature complete scheduling system with [[*Calendar][calendar]]
repeaters integration
+ A clock-in system to time tasks
+ TODO system
+ Export to a variety of formats or make your own export engine using + Export to a variety of formats or make your own export engine using
the org AST! the org AST.
+ Writing $\LaTeX$ inline, with the ability to render the fragments on + Inline $\LaTeX$, with the ability to render the fragments on
demand demand within the buffer
+ Links to a variety of formats:
+ Websites (via http or https)
+ FTP
+ SSH
+ Files (even to a specific line)
+ Info pages
I'd argue this is a bit more than a markup language. Like
[[*Magit][Magit]], some use Emacs just for this system.
** Org Essentials ** Org Essentials
Org has a ton of settings to tweak, which change your experience quite Org has a ton of settings to tweak, which change your experience quite
a bit. Here are mine, but this took a lot of just reading other a bit. Here are mine, but this took a lot of just reading other
@@ -3157,8 +3176,14 @@ a very tidy way to manage your time.
"r" #'org-agenda-redo)) "r" #'org-agenda-redo))
#+end_src #+end_src
** Org capture ** Org capture
2024-04-24: I actually need to clean this up, in particular explain Org capture provides a system for quickly "capturing" some information
what org-capture does. into an org file. A classic example is creating a new TODO in a
todo file, where the bare minimum to record one is:
+ where was it recorded?
+ when was it recorded?
+ what is it?
Org capture provides a way to do that seamlessly without opening the
todo file directly.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package org-capture (use-package org-capture
:defer t :defer t