README.org

Pachemacs

Table of Contents

• Why
• Dependencies
• Installing
• How to remove unwanted things
• How to create new modules
• How to customise the dashboard

Why?

Why not?

Dependencies

Installing

Backup or delete your current .emacs.d directory and clone this repo:

git clone --depth=1 https://github.com/henrique-marques-vsoft/emacs.d.git ~/.emacs.d

Simple as that. But if you’re not using EXWM I recommend that you read further.

How to remove unwanted things

There’s a file called init.el where you can simply comment or delete some of the lisp/modules.

;; If you're not an EXWM enjoyer, you can remove or comment the line below
(require 'pache-ui)
(require 'pache-exwm)
;; If you're not an Evil enjoyer, you might also want to remove pache-evil below
(require 'pache-evil)
(require 'pache-misc)
(require 'pache-yas)
(require 'pache-programming)
(require 'pache-irc)

Beware that some of those modules are required to run Pachemacs. Be careful when removing it. There is a github issue to track this problem. You can check it here.

How to create new modules

Create a new file:

touch ~/.emacs.d/lisp/pache-module.el

Add the following boilerplate to the newly created module:

;;; pache-module.el --- Custom Module Settings -*- lexical-binding: t -*-
;;; Commentary:
;;; Code:


(provide 'pache-module)
;;; pache-module.el ends here

And call it in the init.el file like this:

(require 'pache-module)

How to customise the Dashboard

The settings for the Dashboard can be found at ~/.emacs.d/lisp/pache-ui.el. Search for the following block:

(use-package dashboard
  :ensure t
  :config
  (dashboard-setup-startup-hook)
  (setq dashboard-startup-banner "~/.emacs.d/img/pache-5.png"
	dashboard-banner-logo-title "P A C H E M A C S"
	dashboard-footer-messages '("\"The shrine isn't a good place for using magic.\"")
	dashboard-center-content t
	dashboard-vertically-center-content t
	dashboard-items '((recents . 8)
			  (bookmarks . 5)
			  (projects . 3)
			  (agenda . 3))))