From 8ae54b2a2b28ac5068d8f68af7bdd7a5bc22f329 Mon Sep 17 00:00:00 2001
From: Elizabeth Cray <liz@cray.lgbt>
Date: Tue, 28 Jun 2022 16:44:57 +0000
Subject: [PATCH] Docs & Organization

---
 tools/help.gmi         | 61 ++++++++++++++++++++++++++++++++++++++++++
 tools/hthelp           | 13 +++++++++
 tools/links.gmi        | 52 +++++++++++++++++++++++++++++++++++
 mkuser => tools/mkuser |  0
 4 files changed, 126 insertions(+)
 create mode 100644 tools/help.gmi
 create mode 100755 tools/hthelp
 create mode 100644 tools/links.gmi
 rename mkuser => tools/mkuser (100%)

diff --git a/tools/help.gmi b/tools/help.gmi
new file mode 100644
index 0000000..d507900
--- /dev/null
+++ b/tools/help.gmi
@@ -0,0 +1,61 @@
+# Hackers Town TTY Help
+Press 'q' to quit, run 'hthelp' to get back here
+
+### Contents
+* How To-s
+* Useful Tools
+* Credits
+* Useful Links
+
+## How To...
+
+### Use Amfora (The default help viewer)
+'amfora [URL]'
+The URL is optional and should be in the format: 'gemini://gemini.example.com'
+
+### Write Gemini Pages
+=> gemini://gemini.circumlunar.space/docs/gemtext.gmi Gemtext Reference
+
+## Useful Tools
+
+### Gemini Browsers
+These Links are https, and should load in w3m (ToDo)
+=> https://github.com/makeworld-the-better-one/amfora Amfora
+=> https://sr.ht/~julienxx/Asuka/ Asuka
+=> https://bombadillo.colorfield.space/ Bombadillo
+=> https://github.com/kr1sp1n/awesome-gemini Other Clients and Software
+
+### Weather
+=> https://github.com/schachmat/wego Wego: Simple weather app written in Go
+* Needs ~/.wegorc updated with your geographic position !
+
+=> https://github.com/chubin/wttr.in wttr: Web service with curl
+* 'curl wttr.in/CITY'
+
+### Editors
+=> gemini://gemini.hackers.town/docs/help.gmi Vi 8.2
+=> https://github.com/vim/vim ViM 8.2
+=> https://neovim.io/ Neovim 0.4
+=> https://www.nano-editor.org/ Nano 5.4
+
+### Viewers
+=> https://github.com/charmbracelet/glow Glow: Markdown Renderer
+=> https://github.com/atanunq/viu Viu: Terminal Image Viewer
+=> https://www.nongnu.org/fbi-improved/#docs FIM: Terminal Image Viewer
+* Run with '-o aa' to use in a terminal
+
+## Credits
+
+=> https://hackers.towm/@maddiefuzz System Managed by @maddiefuzz
+=> https://hackers.towm/@liz Automation and Documentation by @liz
+=> https://hackers.towm/@thegibson Domain and Mastodon Instance by @thegibson
+
+## Useful Links
+
+=> gemini://gemini.hackers.town/ Gemini Home
+=> gemini://gemini.hackers.town/docs/help.gmi This help doc
+=> gemini://geminispace.info Gemini Search Engine
+=> gemini://rawtext.club/~sloum/cgi/weather Weather
+=> gemini://drewdevault.com/cgi-bin/man.sh POSIX Manual Lookup
+=> gemini://rawtext.club/~sloum/cgi/othello/ Othello / Reversi
+=> gemini://gemini.hackers.town/docs/links.gmi Other Gemini Servers
diff --git a/tools/hthelp b/tools/hthelp
new file mode 100755
index 0000000..d524778
--- /dev/null
+++ b/tools/hthelp
@@ -0,0 +1,13 @@
+#!/bin/bash
+DOCE=/usr/bin/amfora
+DOC=/var/gemini/docs/help.gmi
+if [ ! -f "$DOC" ]; then
+	echo "Helpdoc missing!"
+	exit 1
+fi
+
+if [ -f "$DOCE" ]; then
+	$DOCE "gemini.hackers.town/docs/help.gmi"
+else
+	$EDITOR $DOC
+fi
diff --git a/tools/links.gmi b/tools/links.gmi
new file mode 100644
index 0000000..2807a80
--- /dev/null
+++ b/tools/links.gmi
@@ -0,0 +1,52 @@
+# This page is a WIP so it's sort of a roulette what you get with these links
+
+=> gemini://gemini.conman.org		Original Gemini Server
+=> gemini://zaibatsu.circumlunar.space		Unlabeled Link
+=> gemini://carcosa.net		Unlabeled Link
+=> gemini://heavysquare.com		Unlabeled Link
+=> gemini://mozz.us		
+=> gemini://dgold.eu		Unlabeled Link
+=> gemini://typed-hole.org		Unlabeled Link
+=> gemini://consensus.circumlunar.space		Unlabeled Link
+=> gemini://tilde.black		Unlabeled Link
+=> gemini://tilde.pink		Unlabeled Link
+=> gemini://vger.cloud		Unlabeled Link
+=> gemini://yam655.com		Unlabeled Link
+=> gemini://royniang.com		Unlabeled Link
+=> gemini://konpeito.media		Unlabeled Link
+=> gemini://gemini.68kmentat.com		Unlabeled Link
+=> gemini://gus.guru		Unlabeled Link
+=> gemini://pon.ix.tc		Unlabeled Link
+=> gemini://breadpunk.club		Unlabeled Link
+=> gemini://gem.bestalbumsintheuniverse.com		Unlabeled Link
+=> gemini://vi.rs		Unlabeled Link
+=> gemini://80h.dev		Unlabeled Link
+=> gemini://bleyble.com		Unlabeled Link
+=> gemini://gemini.digiprime.xyz		Unlabeled Link
+=> gemini://freedombone.net5		Unlabeled Link
+=> gemini://earthlight.xyz		Unlabeled Link
+=> gemini://envs.net		Unlabeled Link
+=> gemini://gemini.logfile.ch		Unlabeled Link
+=> gemini://rawtext.club		Unlabeled Link
+=> gemini://gagarin.p4g.club		Unlabeled Link
+=> gemini://gemini.mayvaneday.art (IPv6 only!)
+=> gemini://libraryoferis.org		Unlabeled Link
+=> gemini://kwiecien.us		Unlabeled Link
+=> gemini://gemini.uxq.ch		Unlabeled Link
+=> gemini://ecmelberk.com		Unlabeled Link
+=> gemini://berserk.red		Unlabeled Link
+=> gemini://park-city.club		Unlabeled Link
+=> gemini://jan.bio		
+=> gemini://magnacarta.press		Unlabeled Link
+=> gemini://x-z.se		
+=> gemini://commie.space		Unlabeled Link
+=> gemini://cybertronica.org		Unlabeled Link
+=> gemini://gemini.ucant.org		Unlabeled Link
+=> gemini://sathariel.tk		Unlabeled Link
+=> gemini://tokeniser.uk		Unlabeled Link
+=> gemini://random-projects.net		Unlabeled Link
+=> gemini://republic.circumlunar.space		Unlabeled Link
+=> gemini://cozylabs.eu		Unlabeled Link
+=> gemini://cosmic.voyage		Unlabeled Link
+=> gemini://makeworld.gq		Unlabeled Link
+=> gemini://otrn.org		Unlabeled Link
\ No newline at end of file
diff --git a/mkuser b/tools/mkuser
similarity index 100%
rename from mkuser
rename to tools/mkuser