guide.git

guide.git/anachronauts.7.scd | 4 KB

  1 anachronauts(7) "The Anachronaut's Guide" "The Anachronaut's Guide"
  2 
  3 # NAME
  4 
  5 *anachronauts* - the state of the art in retrocomputing since the 23c
  6 
  7 
  8 # WELCOME
  9 
 10 Welcome to anachronauts.club! We are proud to offer a shared UNIX computing
 11 environment fusing retrocomputing with some of the best of modern technology,
 12 and a slower, less attention-monopolizing social experience.
 13 
 14 
 15 # DESCRIPTION
 16 
 17 This document provides an overview of the services available on
 18 anachronauts.club, as a supplement to the usual manual pages. The rest of this
 19 manual will give a brief overview of them, and pointers to pages with extended
 20 descriptions.
 21 
 22 You'll see references to other pages in the form *anachronauts*(7) on this and
 23 other pages, which denotes the page named "anachronauts" in section 7. You can
 24 access such pages by running a command like
 25 
 26 	man 7 anachronauts
 27 
 28 substituting in the appropriate manual section and page name. The *man*(1)
 29 command displays manual pages, while the *apropos*(1) command searches the
 30 manual pages for information.
 31 
 32 
 33 ## SHELL
 34 
 35 We provide *fish*(1), the Friendly Interactive Shell, as the default login
 36 shell for new users. If you are unfamiliar with it, see *fish-tutorial*(1).
 37 
 38 This can be changed using *chsh*(1) if you prefer another
 39 shell; *bash*(1) and *tcsh*(1) are also installed, and other shells are
 40 available by request.
 41 
 42 Additionally, a default per-user config file is provided at
 43 _~/.config/fish/config.fish_, specifying some useful environment variables,
 44 such as EDITOR, which is set to *nano*(1) by default. Other available editors
 45 include *vim*(1), *emacs*(1), and *kak*(1). Other editors may be available by
 46 request.
 47 
 48 
 49 ## MAIL
 50 
 51 We provide local-only email services, which can be used to send mail to other
 52 anachronauts users, but cannot send or receive email off the server. Mail is
 53 delivered to your home directory in Maildir format, which can be read using
 54 *mutt*(1). For your convenience, a global *muttrc*(5) configuration file has
 55 been installed; you can override the settings in _~/.config/mutt/muttrc_ if you
 56 like.
 57 
 58 Additionally, the default *fish*(1) configuration displays some cool frogs when
 59 you log in if you have new mail. If you change your shell, this will go away.
 60 
 61 We also have mailing lists associated with some UNIX groups. Use *mygroups*(1)
 62 to see a list of available groups/lists, and to join or leave them.
 63 
 64 
 65 ## GEMINI
 66 
 67 Our primary platform for publishing content is over the Gemini protocol. You
 68 can place files in _~/public_gemini_, and they will be available publically on
 69 _gemini://anachronauts.club_ as well as _https://anachronauts.club_, via our
 70 HTTP-to-Gemini gateway. Gemini can serve any type of file, but the native
 71 format is text/gemini, which is documented in *text-gemini*(5).
 72 
 73 We also have *amfora* and *bombadillo*(1) installed, for browsing Gemini in the
 74 terminal. Graphical browsers, such as GemiNaut and Lagrange, may be available
 75 for your platform.
 76 
 77 For more information, see *gemini*(7).
 78 
 79 
 80 ## GOPHER
 81 
 82 We also run a Gopher server, *gophernicus*, which serves content out of your
 83 _~/public_gopher_ folder. You can use *bombadillo*(1) to browse Gopher
 84 resources. (This section will be expanded at a later date.)
 85 
 86 
 87 ## DEV TOOLS
 88 
 89 The following development languages are available at time of writing:
 90 
 91 - Clang C & C++ - *clang(1)*
 92 - NASM Assembler - *nasm(1)*
 93 - cc65 toolchain
 94 - Go 1.15 - go help
 95 - Perl 5.32 - *perl*(1)
 96 - Python 3.7 & 3.9 - *python3.7*(1), *python3.9*(1)
 97 - Tcl 8.7 - *tclsh*(1)
 98 
 99 The *git*(1) version control system is installed, and we are willing to
100 publically host repositories which accept contributions from local users, and
101 which are relevant to the site. Contact a member of the wheel group
102 <root@anachronauts.club> for more information.
103 
104 
105 ## TINYMUSH
106 
107 We are in the process of setting up a TinyMUSH server. More information will be
108 available once we have finished setting it up.
109 
110 
111 ## CRAWL
112 
113 We have the roguelike game Dungeon Crawl: Stone Soup installed, as the 'crawl'
114 command. This is an experimental feature; it is rather resource-intensive, so
115 only a few people can play at a time. Please do not leave your crawl instance
116 idling.
117 
118 If we decide to keep crawl installed, we plan to implement "hearsing", where
119 ghost files are shared between user accounts.
120