44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# Gemini & Titan mode
|
|
|
|
This uses [Elpher](https://thelambdalab.xyz/elpher/) to browse Gemini
|
|
sites and [Gemini Mode](https://git.carcosa.net/jmcbray/gemini.el) to
|
|
*edit* them using the [Titan](https://communitywiki.org/wiki/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:
|
|
|
|
* [The Transjovian Council](gemini://transjovian.org) and all it's
|
|
wiki spaces
|
|
|
|
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
|
|
```
|