+-+-+-+-+-+-+-+-+-+-+
|S|I|M|P|L|E|T|O|N|S|
+-+-+-+-+-+-+-+-+-+-+

# Gemini for Simpletons

## host

### Log In
ssh username@r.circumlunar.space

###Transfer your local gemini text directory to the host:

rsync -zaP --delete /media/username/USBDRIVE/Documents/gemini/* username@r.circumlunar.space:~/gemini/

In this example, the gemini capsule files are kept in a usb drive (USDBDRIVE), in the /media/username/USBDRIVE/Documents/gemini/directory on a local linux device.  The command is entered into a terminal on the local device.  There may be subdirectories under the gemini directory. Any changes to the local directory will be written to the r.circumlunar.space/username/gemini/ .

### Transfer a single file to your gemini directory on the host:
scp -rv /media/username/USBDRIVE/Documents/gemini/file.gmi username@r.circumlunar.space:~/gemini/  

### Reset permissions in host ~/gemini/ directory:
find ~/gemini -type d | xargs chmod 755 && find ~/gemini -type f | xargs chmod 644


## bbs

### Read a thread in the bbs, example session:
ssh username@r.circumlunar.space
bbs
(l)ist boards
(g)oto a board, then enter board number
(m)essages, list
(t)hread, Enter thread number to read most recent thread post
(w)hole, read whole thread
<spacebar> to tab through thread
(d)one, go back to board list

### Scan the bbs for new messages since last scan/login
bbs
(s)scan

### Write a new post:
ssh username@r.circumlunar.space
bbs
(l)ist
(g)oto
Choose your board number, <Enter>
(n)ew
Subject
Body

### vi rules:
If weird things start happening, key in <Escape> i, as two keystrokes (not at the same time).
<Escape> i turns on insert mode
<Escape> :wq saves file and exits
<Escape> :q cancels the post

## amfora

Use a number key to select and go to a link.  For link numbers higher than 9, hit the spacebar and then enter the link number.

Type ? for the help page.

Tab to move through links.

Type b to go back a page.

Use the spacebar to type in a url in the bottom line.

When you find an interesting site that you want to return to, enter <Ctl>-d to bookmark it.

<Ctl>-a will show your subscriptions.

Reload page with <Ctl>-R.

Finding Content:

Gemini Search Engines
=>gemini://gus.guru Gus
=>gemini://houston.coder.town Houston

To find interesting sites, search on "directory" or the search term of your choice.

Gemini Aggregators
=>gemini://gemini.circumlunar.space/capcom/ CAPCOM
=>gemini://rawtext.club:1965/~sloum/spacewalk.gmi Spacewalk

Gemini Server List
=>gemini://gemini.circumlunar.space/servers/ Gemini Servers