summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2024-04-22 11:26:35 -0500
committerCraig Jennings <c@cjennings.net>2024-04-22 11:26:35 -0500
commitcbb07175245d7b6b12b3f06ac384a0f42bedc631 (patch)
treed302a442a6ad1e796c3c1780b908f1650b3bef8f /README.md
parenta3e7ff21adce114c807781d057d88604766e2c40 (diff)
Readme Rewrite
- moved the format from markdown to org - much better text IMHO - badges and sections and pictures oh my!
Diffstat (limited to 'README.md')
-rw-r--r--README.md94
1 files changed, 0 insertions, 94 deletions
diff --git a/README.md b/README.md
deleted file mode 100644
index 78282c3..0000000
--- a/README.md
+++ /dev/null
@@ -1,94 +0,0 @@
-# wttrin.el
-
-Emacs frontend for weather web service [wttr.in](https://wttr.in).
-
-This fork has a few minor improvements:
-- It displays the date and time the weather was displayed.
-- It allows for customizing the font and font height used to display.
-- On location re-query, the original weather buffer is closed, reducing buffer clutter.
-- The license has changed from the MIT license to the GNU General Public License Version 3.
-
-In addition, this fork applies the following patches (from bcbcarl/emacs-wttrin):
-- [patch to request the return ascii instead of html](https://github.com/bcbcarl/emacs-wttrin/pull/18) from brannala
-- [patch to select the unit system](https://github.com/bcbcarl/emacs-wttrin/pull/10) from RJTK
-- [patch to use https instead of http](https://github.com/bcbcarl/emacs-wttrin/pull/15) from relrod
-
-All changes have been manually validated as working as of Monday, April 01, 2024 (not kidding). Automatic CI tests forthcoming.
-
-Bug reports and PRs are welcome. Enjoy!
-
-## USAGE
-
-Set a default cities list for completion:
-
-```elisp
-(setq wttrin-default-cities '( "Berkeley, California" "Taipei, Taiwan" "Tainan, Taiwan"))
-```
-
-You can also specify default HTTP request Header for Accept-Language:
-
-```elisp
-(setq wttrin-default-accept-language '("Accept-Language" . "zh-TW")))
-```
-
-As well as the unit system, "m" for metric and "u" for USCS/imperial (the default is to choose based on your location):
-
-```elisp
-(setq wttrin-unit-system "m")
-```
-
-If you want the weather to display in a monospaced font other than your default, you may specify it:
-
-```elisp
-(setq wttrin-font-name "Hack Nerd Font Mono")
-```
-
-You can specify the font height as well:
-
-```elisp
-(setq wttrin-font-height 120)
-```
-
-Then run `M-x wttrin` to display the weather.
-
-After the weather is displayed you may press `q` to quit the buffer or `g` to query the weather for another location.
-
-![screenshot](wttrin.png)
-
-## INSTALLATION
-
-Since the versions on Melpa and Melpa-stable are broken and abandoned versions, you should avoid installing this package from those repositories. Instead you can install manually.
-
-- Clone this repository
-- Add the following in your Emacs config file:
-
-```emacs-lisp
-(add-to-list 'load-path "/path/to/the/cloned/emacs-wttrin")
-(require 'wttrin)
-...
-```
-
-or in use-package format:
-
-```emacs-lisp
-(use-package wttrin
- :load-path ""/path/to/the/cloned/emacs-wttrin"
- ...)
-```
-
-Of if you are using straight, the recipe will be similar to:
-
-```emacs-lisp
-(straight-use-package
- '(wttrin :type git
- :host github
- :repo "bcbcarl/emacs-wttrin"
- :fork (:host github
- :repo "cjennings/emacs-wttrin")))
-```
-
-I will contact the Melpa maintainers and update this package with a working version soon.
-
-## LICENSE
-
-GPL-v3