fork of https://alexschroeder.ch/cgit/gemini-write, with auth-source support
Go to file
Martin Joerg a78e30fa82 Update Package-Requires to include elpher and gemini-mode
The Package-Requires header was missing some dependencies.
2021-05-06 07:19:48 +02:00
README.md Enable gemini-write to use the auth-source library 2021-01-14 16:55:52 -06:00
gemini-write.el Update Package-Requires to include elpher and gemini-mode 2021-05-06 07:19:48 +02:00

README.md

Gemini & Titan mode

This uses Elpher to browse Gemini sites and Gemini Mode to edit them using the Titan protocol.

Note: This needs Elpher 2.8. Maybe you need to get the latest version from the author's repository for it to work.

Once you have all three packages installed, use e to edit a Gemini page on a site that has Titan enabled. Use C-c C-c to save. Customize elpher-gemini-tokens to set passwords, tokens, or whatever you need in order to edit sites.

The known sites that have Titan enabled:

If you're installing all three packages from source, here's an example of how to set it all up:

(add-to-list 'load-path "/home/alex/src/elpher")
(autoload 'elpher "elpher" "Gopher and Gemini client" t)

(add-to-list 'load-path "/home/alex/src/gemini.el")
(autoload 'gemini-mode "gemini-mode" "Gemini Mode" t)

(add-to-list 'load-path "/home/alex/src/gemini-write")
(autoload 'elpher-edit "gemini-write" "Edit a Gemini page." t)
;; make sure "e" can be used to edit raw pages
(eval-after-load "elpher" '(load-library "gemini-write"))

Tokens

gemini-write can pull tokens from the elpher-gemini-tokens alist, or from the auth-source library. A gemini-write token entry in ~/.authsource should contain the host and the port, which by default is 1965, along with the token in the password field, like this:

machine example.com port 1965 password example-password