/ 
App-Phoebe-4.04_02
/ README.md

Phoebe Wiki

Phoebe does two and a half things:

It's a program that you run on a computer and other people connect to it using their Gemini client in order to read the pages on it.

It's a wiki, which means that people can edit the pages without needing an account. All they need is a client that speaks both Gemini and Titan, and the password. The default password is "hello". 😃

Optionally, people can also access it using a regular web browser.

Gemini itself is very simple network protocol, like Gopher or Finger, but with TLS. Gemtext is a very simple markup language, a bit like Markdown, but line oriented.

To take a look for yourself, check out the test wiki via the web or via the web.

Reading the wiki

This repository comes with a Perl script called gemini to download Gemini URLs.

Other clients can be found here:

See App::Phoebe::Web to enable reading via the web.

Editing the wiki

How do you edit a Phoebe wiki? You need to use a Titan-enabled client.

Titan is a companion protocol to Gemini: it allows clients to upload files to Gemini sites, if servers allow this. On Phoebe, you can edit "raw" pages. That is, at the bottom of a page you'll see a link to the "raw" page. If you follow it, you'll see the page content as plain text. You can submit a changed version of this text to the same URL using Titan.

Known clients:

This repository comes with a Perl script called titan to upload files.

Gemini Write is an extension for the Emacs Gopher and Gemini client Elpher.

Gemini & Titan for Bash are two shell functions that allow you to download and upload files.

Lagrange is a GUI client that is Titan enabled.

See App::Phoebe::WebEdit to enable editing via the web.

Installation

Using cpan:

cpan App::Phoebe

Manual install:

perl Makefile.PL
make
make install

Dependencies

If you are not using cpan or cpanm to install Phoebe, you'll need to install the following dependencies:

I'm going to be using curl and openssl in the Quickstart section of phoebe, so you'll need those tools as well. And finally, when people download their data, the code calls tar (available from packages with the same name on Debian derived systems).

See also