general customisation guidance

[michaelssingh]

hey I have been meaning to give this a go and for the most part things look great, I have a few concerns, however, how do I control what is displayed when I hit SPC, what is the name of this package and where can I edit what appears, what is the recommended way to overwrite the built in module, in particular I want to add a few things to the clojure-mode that are missing

[abougouffa]

Hello @michaelssingh ,

You can take a look to skel/, I'm trying to keep it updated with configuration examples. The logic of user customization is explained briefly in the README file. In a nutshell, it is recommended to configure packages in with-eval-after-load blocks, or by including a use-package block inside your config.el with your extra customization. The config.el is loaded after MinEmacs modules, so it can override what has been configured before. The order of loading configuration files is described here.

Please note that MinEmacs uses straight.el to install packages, so it is recommended to use the same package manager and not mix it up with the builtin package.el. TLDR: use :straight t and not :ensure t in your use-package blocs.

[michaelssingh]

What about overwriting what you have here https://github.com/abougouffa/minemacs/blob/main/core/me-keybindings.el, I am trying to avoid forking this project.

[abougouffa]

If you want to overwrite the default keybindings you can do it using the +map! macro. This macro, among others (see elisp/+keybinding.el) are executed after general has been loaded and configured, as described here:

minemacs/core/me-keybindings.el

Lines 225 to 229 in 5c6739e

	;; HACK: This is a synchronization feature, providing `me-general-ready' tells
	;; the `+map!', `+map-local!', ... macros that `general' is ready and the
	;; definers `+minemacs--internal-map!', `+minemacs--internal-map-local!', ...
	;; are available (See the `+map!' macro definition in "elisp/+minemacs.el").
	(provide 'me-general-ready))

If you don't like how a particular package is configured and you want to disable its default configuration (provided by MinEmacs) and install it in your configuration file (config.el). You need to add it to the minemacs-disabled-packages in your modules.el file. The skel/modules.el contains some examples.

minemacs/skel/modules.el

Lines 58 to 73 in 5c6739e

	;;; List of disabled packages
	;; You can set `minemacs-disabled-packages' to disable some packages. For
	;; example, if you want to use the `me-ui' module, but you want to disable the
	;; `focus' package. You can use:
	;; (push 'focus minemacs-disabled-packages)
	;; Adding a package to `minemacs-disabled-packages' guarantees disabling its
	;; corresponding `use-package' section in MinEmacs' modules. However, please
	;; note that, if you want to completely disable a package, you need to make sure
	;; you've also disabled its dependent packages (see `M-x straight-dependents'),
	;; otherwise it will get installed as a dependency.
	;;
	;; You can also `push' (or `add-to-list') multiple packages at once (as a list).
	;; For example, to completely disable `iedit' and its dependencies
	;; `evil-multiedit' and `evil-iedit-state', you can use:
	;; (push '(iedit evil-multiedit evil-iedit-state) minemacs-disabled-packages)

I hope this answers your question!

[dorneanu]

Hi! I'm still not sure how to add additional packages and how to override some general behaviours.
This is what I have in ~/.minemacs.d/local/config.el: https://dpaste.org/9kYsP

For example I have:

(use-package embark
  :straight t
  :bind (("C-." . embark-act)
         :map embark-file-map
         ("V" . cust/vsplit-file-open)
         ("X" . cust/split-file-open))
  :config
  (define-key embark-url-map "X" #'dorneanu/embark-open-url-in-xwidget-webkit))

In general: How do I change the default keybindings (which by default use the leader SPC)? Sometimes I want to use M-c instead (for all the cape backends for example):

(use-package cape
  :straight t
  :demand t
  :hook ((prog-mode . dorneanu/set-basic-capf)
         (text-mode . dorneanu/set-basic-capf)
         (org-mode . dorneanu/set-basic-capf)
         ;; (go-ts-mode . dorneanu/set-go-capf)
         (lsp-completion-mode . dorneanu/set-lsp-capf))

  :general (:prefix "M-c"              ; I don't really use capitalize-word
                    "p" 'completion-at-point
                    "t" 'complete-tag   ; etags
                    "d" 'cape-dabbrev   ; basically `dabbrev-completion'
                    "f" 'cape-file
                    "k" 'cape-keyword
                    "s" 'cape-symbol
                    "a" 'cape-abbrev
                    "i" 'cape-ispell
                    "l" 'cape-line
                    "w" 'cape-dict
                    "\\" 'cape-tex
                    "_" 'cape-tex
                    "^" 'cape-tex
                    "&" 'cape-sgml
                    "r" 'cape-rfc1345)
  :custom
  (cape-dabbrev-min-length 1)
  :init
  ;; Add `completion-at-point-functions', used by `completion-at-point'.
  ;; (add-to-list 'completion-at-point-functions #'cape-history)
  ;; (add-to-list 'completion-at-point-functions #'cape-keyword)
  ;; (add-to-list 'completion-at-point-functions #'cape-dabbrev)
  ;; (add-to-list 'completion-at-point-functions #'cape-symbol)
  (add-to-list 'completion-at-point-functions #'cape-dabbrev)
  (add-to-list 'completion-at-point-functions #'cape-elisp-block)
  (add-to-list 'completion-at-point-functions #'cape-file)
)

The above example is from my current configuration (without minemacs).
Any advice would be helpful. Thanks in advance.