From ba9935629060d4bc067724c103c6c1037c34e3aa Mon Sep 17 00:00:00 2001 From: "Erik L. Arneson" Date: Tue, 1 Nov 2022 08:14:47 -0700 Subject: [PATCH] Add a README.md because of Sourcehut Sourcehut doesn't support org-mode README files, so I made a markdown version. --- README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..19ccba8 --- /dev/null +++ b/README.md @@ -0,0 +1,58 @@ + +# Table of Contents + +1. [Installation](#orgd5b246c) +2. [Usage](#org4c0bef7) + +This package provides support for the [ddate](https://github.com/bo0ts/ddate) command. + + + + +# Installation + +This package is now available on [MELPA](https://melpa.org/), so you can install it by adding MELPA to your list of +packages and then using `use-package` like this: + + (require 'package) + (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) + (package-initialize) + + (use-package ddate + :ensure t) + +You can also install this package directly from this repository via `use-package` and +[`quelpa-use-package`](https://github.com/quelpa/quelpa-use-package). + + (use-package ddate + :ensure-system-package ddate + :quelpa (ddate :fetcher git :url "https://git.sr.ht/~earneson/emacs-ddate")) + + + + +# Usage + +Use the `ddate` and `ddate-pretty` functions to do fun things. + +I like to use it with [dashboard](https://github.com/emacs-dashboard/emacs-dashboard) like this: + + (defun ela/dashboard-insert-ddate (list-size) + "Insert the Discordian date into the dashboard." + (let ((ddate-string (ddate-pretty))) + (dashboard-center-line ddate-string) + (insert ddate-string))) + + (use-package dashboard + :init (dashboard-setup-startup-hook) + :config + ;; Add the ddate item provider to the list. + (add-to-list 'dashboard-item-generators + '(ddate . ela/dashboard-insert-ddate)) + + ;; Set up your items with ddate at the top. + (setq dashboard-items '((ddate) + (recents . 5) + (bookmarks . 5) + (registers . 5)))) + -- 2.38.5