gemini-write/README.md

1.6 KiB

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