do header and footer, import old content
This commit is contained in:
parent
89a7a53758
commit
c9cf9b1e2b
|
@ -0,0 +1,5 @@
|
|||
commit 89a7a53758ca54d05a411a1b3186635d51aa7647
|
||||
Author: vilmibm <nathanielksmith@gmail.com>
|
||||
Date: Fri Sep 1 04:55:06 2017 +0000
|
||||
|
||||
some slightly less junky junk test content
|
|
@ -0,0 +1,57 @@
|
|||
Around Tilde Town
|
||||
=================
|
||||
|
||||
- [Pages updated this week](/~ags/updated.html)
|
||||
|
||||
## IRC
|
||||
|
||||
Join the chat with `irc`. Anyone can create a channel, or join an existing one:
|
||||
|
||||
- #tildetown (default)
|
||||
- #bots
|
||||
- #coding
|
||||
- #music
|
||||
- #poetry
|
||||
|
||||
### #fridaypostcard
|
||||
[View postcards](http://tilde.town/~jumblesale/fp.html)
|
||||
|
||||
To contribute: share a link to an image on IRC with the text _#fridaypostcard_. Updated every Friday.
|
||||
|
||||
### !tilde game
|
||||
[View all scores](http://tilde.town/~bear/tildescores.html)
|
||||
|
||||
To play: `/join #bots` and type _!tilde_ to get tildes.
|
||||
|
||||
To view your score: Type _!tildescore_ in #bots
|
||||
|
||||
### txtminebot
|
||||
|
||||
[current game status](http://tilde.town/~endorphant/plaintxtmines/world.html)
|
||||
|
||||
To play: `/join #bots` and type `!strike` and the bot will give you more instructions.
|
||||
|
||||
Type `!commands` for a list of valid commands.
|
||||
|
||||
## For your public_html/
|
||||
|
||||
### tilde.town ring
|
||||
[View all ~ring members](http://tilde.town/~um/tilde_ring/members.html)
|
||||
|
||||
[Join](http://tilde.town/~um/tilde_ring/join.html) the ~ring.
|
||||
|
||||
### blog on TTBP
|
||||
we have an internal command-line blogging platform. to use it, run:
|
||||
`~endorphant/bin/ttbp` while logged in to tilde.town.
|
||||
|
||||
[more info here](http://tilde.town/~endorphant/ttbp)
|
||||
|
||||
|
||||
## More
|
||||
- [Code on ~.town](/~bear/code.html)
|
||||
- [nethack empire](/~endorphant/nethackempire.html)
|
||||
- [mud.tilde.town](http://github.com/selfsame/mud.tilde.town)
|
||||
- - local server: "telnet localhost 5071"
|
||||
- [music sharing](/~desvox/music.html)
|
||||
|
||||
If you notice anything else cool and useful around town, feel free to add it here!
|
|
@ -0,0 +1,30 @@
|
|||
cndorphbot
|
||||
==========
|
||||
|
||||
owner: [~endorphant](http://tilde.town/~endorphant) | [source](http://tilde.town/~endorphant/cndorphbot.py.txt)
|
||||
|
||||
*A personal bot friend.*
|
||||
|
||||
## Features
|
||||
|
||||
* _Automatic tilde mining;_ when activated, asks for a !tilde at intervals of at least 60 minutes, and defeats the tildebot arithmetic captcha by performing some text processing.
|
||||
* _Channel haunting;_ summons the ghost of a user by loading lines from the #tildetown IRC log, then repeating them chronologically at a randomish interval. When it runs out of lines, the ghost dissipates.
|
||||
* _Internet time;_ reports the current [beat](https://en.wikipedia.org/wiki/Swatch_Internet_Time) to the nearest thousandth.
|
||||
|
||||
## Commands
|
||||
|
||||
* __!beat__ gives the current beal meridian time
|
||||
* __!tildeboard__ gives the top five !tilde scores, according to the tildebot records
|
||||
* __!leaderboard__ does the same, without triggering the tildebot
|
||||
* __!exhume *{username}* *{yyyy-mm-dd}*__ loads lines from username on given date (logs start 2014-12-29)
|
||||
* __!silphscope__ reveals current ghost
|
||||
* __!banish__ instantly ends haunting
|
||||
|
||||
Responds to the following when directly addressed ("__cndorphbot: *{message}*__")
|
||||
|
||||
* <3
|
||||
* tildeboard
|
||||
* botsnack
|
||||
* time/mark/sync (old debugging commands, left in for flavor)
|
||||
* report (calls !tildescore)
|
||||
* beg (asks for a !tilde)
|
|
@ -0,0 +1,31 @@
|
|||
IRC Bots
|
||||
========
|
||||
|
||||
## General Guidelines
|
||||
|
||||
1. Try not to spam the main channels; your bot can sit in them, but please keep as much bot chatter to #bots as possible.
|
||||
|
||||
2. Test your bot; either make your own channel, or use #bot_test, to make sure your bot is behaving well before inflicting it onto your fellow tilders.
|
||||
|
||||
3. Your bot should respond to !rollcall with a report of what it does.
|
||||
|
||||
4. Your bot should *never* respond to !rollcall with !rollcall.
|
||||
|
||||
## How-To
|
||||
|
||||
More here later.
|
||||
|
||||
But basically just snoop other people's bot scripts and ask questions in IRC.
|
||||
|
||||
## Known Bots
|
||||
|
||||
* topicbot
|
||||
* quote_bot
|
||||
* linearbot
|
||||
* tildebot
|
||||
* norrisBot
|
||||
* [cndorphbot](cndorphbot.html) ([source](http://tilde.town/~endorphant/cndorphbot.py.txt))
|
||||
* [txtminebot](txtminebot.html) ([source](https://github.com/modgethanc/plaintxtmines/tree/master))
|
||||
* sameself ([source](http://tilde.town/~selfsame/dev/sameself.py))
|
||||
* cosnok ([source](https://github.com/tahnok/cosnok) (patches welcome))
|
||||
* minerbot ([page](minerbot.html))
|
|
@ -0,0 +1,15 @@
|
|||
minerbot
|
||||
==========
|
||||
|
||||
Owner: [~minerobber](http://tilde.town/~minerobber)
|
||||
|
||||
*A burnt-spaghetti-esque mess of code.*
|
||||
|
||||
## Commands
|
||||
|
||||
* __!steven_universe__ comes up with a Markov generated Steven Universe title and episode.
|
||||
* __!twitch__ checks a given [Twitch](https://twitch.tv) channel. (i.e; "!twitch firedragon764")
|
||||
* __!choose__ chooses an option from a list given (i.e; "!choose play work sleep")
|
||||
* __!online__ gives a leet-ified list of everyone online.
|
||||
* __!note__ leaves a note for another tilder (i.e; "!note minerobber nice bot!")
|
||||
* __!getStock__ gets stock prices and changes for given stock symbols (i.e; "!getStock F NTDOY" gets the stock of Ford and Nintendo)
|
|
@ -0,0 +1,8 @@
|
|||
txtminebot
|
||||
==========
|
||||
|
||||
owner: [~endorphant](http://tilde.town/~endorphant) | [source](https://github.com/modgethanc/plaintxtmines/tree/master)
|
||||
|
||||
*A dystopian fantasy mining adventure.*
|
||||
|
||||
Commands: !init, !open, !mines, !strike {mine}, !report, !fatigue, !grovel, !rankings, !info
|
|
@ -0,0 +1,137 @@
|
|||
tilde.town code of conduct
|
||||
==========================
|
||||
|
||||
**tl;dr**: Be kind to each other. Think carefully about the words you
|
||||
use. Think carefully about what content you post and promote.
|
||||
|
||||
1. Purpose
|
||||
----------
|
||||
|
||||
A primary goal of tilde.town is to be inclusive to the largest number of
|
||||
community members, with the most varied and diverse backgrounds
|
||||
possible. As such, we are committed to providing a friendly, safe and
|
||||
welcoming environment for all, regardless of gender, sexual orientation,
|
||||
ability, ethnicity, socioeconomic status, and religion (or lack
|
||||
thereof).
|
||||
|
||||
This code of conduct outlines our expectations for all those who
|
||||
participate in our community, as well as the consequences for
|
||||
unacceptable behavior.
|
||||
|
||||
We invite all those who participate in tilde.town to help create safe
|
||||
and positive experiences for everyone.
|
||||
|
||||
2. Vision of tilde.town
|
||||
-----------------------
|
||||
|
||||
**tilde.town exists to provide a safe, non-judgemental, and fun place to
|
||||
explore creative projects and to seek intentional digital community.**
|
||||
|
||||
In a post-facebook age, it is up to small communities to gather and work
|
||||
together to provide a space outside of the advertising-laden, corporate
|
||||
mediated world of social media.
|
||||
|
||||
To that end, tilde.town strives to be a radically inclusive community
|
||||
where people of all backgrounds and all technological experience levels
|
||||
can come together for peer education, to delight in one another's
|
||||
creations and to make good conversation.
|
||||
|
||||
3. Expected Behavior
|
||||
--------------------
|
||||
|
||||
- Participate in an authentic and active way. In doing so, you
|
||||
contribute to the health and longevity of tilde.town.
|
||||
- Exercise consideration and respect in your speech and actions.
|
||||
- Attempt collaboration before conflict.
|
||||
- Refrain from demeaning, discriminatory, or harassing behavior and
|
||||
speech.
|
||||
- If anyone asks you to stop a particular kind of behavior, always err
|
||||
on the side of respecting their wishes. If you believe their request
|
||||
is unreasonable or unfair, ask an admin, but don't respond with
|
||||
hostility.
|
||||
- Be mindful of your surroundings and of your fellow participants.
|
||||
Alert community leaders if you notice a dangerous situation, someone
|
||||
in distress, or violations of this code of conduct, even if they
|
||||
seem inconsequential.
|
||||
|
||||
4. Unacceptable Behavior
|
||||
------------------------
|
||||
|
||||
Unacceptable behaviors include: intimidating, harassing, abusive,
|
||||
discriminatory, derogatory or demeaning speech or actions by any
|
||||
tilde.town user online, at any related events, or in one-on-one
|
||||
communication carried out in the conduct of tilde.town related projects.
|
||||
Community event venues--physical or digital--may be shared with members
|
||||
of the public; please be respectful to all patrons of these locations.
|
||||
|
||||
Harassment includes: harmful or prejudicial verbal or written comments
|
||||
related to gender, sexual orientation, race, religious choices,
|
||||
disability; inappropriate use of nudity and/or sexual images in public
|
||||
spaces (like your \~ html pages); deliberate intimidation, stalking, or
|
||||
following; harassing recording; sustained disruption of the work of
|
||||
others; and unwelcome sexual attention.
|
||||
|
||||
5. Consequences of Unacceptable Behavior
|
||||
----------------------------------------
|
||||
|
||||
Unacceptable behavior from any community member, including those with
|
||||
decision making authority or sudo, will not be tolerated.
|
||||
|
||||
Anyone asked to stop unacceptable behavior is expected to comply immediately.
|
||||
If a community member engages in unacceptable behavior, the tilde.town admins
|
||||
may take any action they deem appropriate, up to and including a temporary ban
|
||||
or permanent expulsion from tilde.town (meaning your user account would be
|
||||
revoked) without warning.
|
||||
|
||||
6. If You Witness or Are Subject to Unacceptable Behavior
|
||||
---------------------------------------------------------
|
||||
|
||||
If you are subject to or witness unacceptable behavior, or have any
|
||||
other concerns, please see the Contact Information section below.
|
||||
|
||||
Additionally, help engaging with law enforcement is always available.
|
||||
|
||||
7. Addressing Grievances
|
||||
------------------------
|
||||
|
||||
If you feel you have been falsely or unfairly accused of violating this
|
||||
code of conduct, use the Contact Information section below to send a
|
||||
concise description of your grievance.
|
||||
|
||||
8. Scope
|
||||
--------
|
||||
|
||||
We expect all tilde.town members to abide by this code of conduct while:
|
||||
|
||||
- engaging with other users locally on the server
|
||||
- publishing content hosted on tilde.town
|
||||
- engaging in community activities, whether in meatspace or cyberspace
|
||||
|
||||
9. Contact Information
|
||||
----------------------
|
||||
|
||||
Tilde.town admin:
|
||||
|
||||
- [~vilmibm](http://tilde.town/~vilmibm)
|
||||
✉ <nks@lambdaphil.es>
|
||||
|
||||
Volunteer / part-time admins:
|
||||
|
||||
- [~datagrok](http://tilde.town/~datagrok)
|
||||
✉ <mike@datagrok.org>
|
||||
Twitter: [@datagrok](http://twitter.com/datagrok)
|
||||
|
||||
Admins can be reached privately:
|
||||
|
||||
- on IRC using `/msg vilmibm hello`
|
||||
- via local tilde.town email, e.g. `vilmibm@tilde.town`
|
||||
- or via normal internet e-mail at the addresses listed above.
|
||||
|
||||
10. License and Attribution
|
||||
---------------------------
|
||||
|
||||
This code of conduct is based on
|
||||
[citizencodeofconduct.org](http://citizencodeofconduct.org/) under the
|
||||
terms of the [Creative Commons Attribution-ShareAlike
|
||||
license](http://creativecommons.org/licenses/by-sa/3.0/).
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
<h1><a href="http://tilde.town">tilde.town</a> faq</h1>
|
||||
<h2>is tilde.town free?</h2>
|
||||
<p>yes. tilde.town costs nothing. however, <a href="https://www.patreon.com/nathanielksmith">donations</a> are encouraged for the continued existence of tilde.town.</p>
|
||||
|
||||
<h2>do i have to know a lot about computers to use tilde.town?</h2>
|
||||
<p>tilde.town is not, at first, the easiest thing to use if you're not already familiar with certain computing concepts. however, we strive to be beginner friendly and to be a place to learn all of the things you need to participate in tilde.town.</p>
|
||||
<p>in other words, the only prerequisite for being a tilde.town user is a willingness to learn (and be bound by our <a href="/~wiki/conduct.html">code of conduct</a>).</p>
|
||||
|
||||
<h2>who runs tilde.town?</h2>
|
||||
<p>tilde.town was founded by and is primarily run
|
||||
by <a href="/~vilmibm"><strong>~vilmibm</strong>.</a></p>
|
||||
|
||||
<h2>why was tilde.town made?</h2>
|
||||
<p>
|
||||
tilde.town was initially founded on October 11th, 2014 for folks who
|
||||
could not get an account on <a href="http://tilde.club">tilde.club</a>.
|
||||
tilde.town expands on the
|
||||
mission of tilde.club--to provide a shared computer for socializing and
|
||||
making things on--with a more expansive and radical vision.
|
||||
</p>
|
||||
|
||||
<h2>i'm really confused by SSH. can you help?</h2>
|
||||
<p>sure! SSH stands for Secure Shell and is the tool users use to connect to
|
||||
and interact with tilde.town. It is a <em>command line tool</em>.</p>
|
||||
<p>check out
|
||||
this <a href="https://tilde.town/~wiki/ssh.html">SSH
|
||||
How To</a> for information on how to get started with your OS.</p>
|
||||
<p>if you want live help, you can get help via one of these means:
|
||||
<ul>
|
||||
<li>tweet at <a href="https://twitter.com/tildetown">@tildetown</a></li>
|
||||
<li>file a <a href="https://cgi.tilde.town/help/tickets">help ticket</a></li>
|
||||
<li>email tildetown AT protonmail DOT ch</li>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2>can i run servers on tilde.town?</h2>
|
||||
<p>sort of. currently, we don't open any ports for users to use; however,
|
||||
you can run simple services or cron jobs for local-only access. please be
|
||||
respectful of system resources. any admin has the right at any time to kill
|
||||
any of your processes or cron tasks if the system is overloaded.</p>
|
||||
|
||||
<h2>can i run my own tilde site?</h2>
|
||||
<p>of course, anyone can. if you'd like, the founder of tilde.town has made
|
||||
available a <a href="https://github.com/nathanielksmith/puppet-tilde">puppet
|
||||
module</a> that is a starting point for running your own tilde server. It's
|
||||
fallen into a bit of disrepair, but should be a helpful starting off point.</p>
|
|
@ -1,3 +1,40 @@
|
|||
# tilde.town wiki
|
||||
# welcome to tilde.town's wiki!
|
||||
|
||||
## lol
|
||||
the tilde.town wiki houses our server-specific documentation, pages about
|
||||
various art projects, guides on linux, fiction, and other wonderful content.
|
||||
|
||||
## how to use!
|
||||
|
||||
all users can edit this wiki. from your home directory, run:
|
||||
|
||||
wiki init
|
||||
|
||||
and follow the prompts. once it's done, you can edit the files, add new files,
|
||||
or create and populate new directories. check the changes you make with:
|
||||
|
||||
wiki preview
|
||||
w3m tilde.town/~YOU/wiki
|
||||
|
||||
where `YOU` is your username.
|
||||
|
||||
when you are happy with your changes, run
|
||||
|
||||
wiki publish
|
||||
w3m tilde.town/wiki
|
||||
|
||||
sometimes, you might get conflicts with changes other people have made. for
|
||||
now, fall back on git commands to fix it. if this is unfamiliar to you, ask in
|
||||
IRC (via the `chat` command) or in the forum (via `bbj`) and someone will
|
||||
definitely help you.
|
||||
|
||||
to view wiki pages from the command line, run
|
||||
|
||||
wiki get editors/nano
|
||||
|
||||
to list the contents of the wiki, run
|
||||
|
||||
wiki get toc
|
||||
|
||||
as always on the town, folks are here to help each other. if you run into
|
||||
problems feel free to ask for help. and maybe document the answer on the wiki
|
||||
for the next person :D
|
||||
|
|
|
@ -0,0 +1,59 @@
|
|||
irssi
|
||||
=====
|
||||
|
||||
## Setting up a mentions/hilight window for irssi.
|
||||
|
||||
If you run irssi in a screen you might miss mentions and it's time
|
||||
consuming to scroll back through logs looking for them.
|
||||
|
||||
A better way is to create a mentions or hilight window dedicated to
|
||||
any messages that contain your nickname.
|
||||
|
||||
(instructions adopted from [here](https://quadpoint.org/articles/irssi/)).
|
||||
|
||||
Install cras's hilightwin.pl:
|
||||
|
||||
```
|
||||
mkdir -p ~/.irssi/scripts/autorun
|
||||
curl -L https://github.com/irssi/scripts.irssi.org/raw/gh-pages/scripts/hilightwin.pl > ~/.irssi/scripts/autorun/hilightwin.pl
|
||||
```
|
||||
|
||||
Setup the hilight window
|
||||
|
||||
```
|
||||
/window new split
|
||||
/window name hilight
|
||||
/window size 6
|
||||
/layout save
|
||||
```
|
||||
|
||||
Load script
|
||||
|
||||
```
|
||||
/script load autorun/hilightwin.pl
|
||||
```
|
||||
|
||||
## away_screen.pl
|
||||
|
||||
`away_screen.pl` is a script for irssi which automatically sets `/away` when you detach from screen.
|
||||
It can also automatically change your nickname when you detach from screen so you can let others
|
||||
know when you're away. It will also log mentions you've received while detached.
|
||||
|
||||
### Installation
|
||||
|
||||
```
|
||||
# download screen_away.pl
|
||||
curl http://scripts.irssi.org/scripts/screen_away.pl ~/.irssi/scripts
|
||||
|
||||
# (optional) autoload it by symlinking to ~/.irssi/scripts/autorun
|
||||
# you may need to make the autorun directory first
|
||||
cd ~/.irssi/scripts/autorun && ln -sv ../screen_away.pl .
|
||||
|
||||
# restart irssi in a screen
|
||||
```
|
||||
|
||||
To automatically change your nickname when detached, run the following command from irssi:
|
||||
|
||||
```
|
||||
/set screen_away_nick YOUR_AWAY_NICKNAME
|
||||
````
|
|
@ -0,0 +1,30 @@
|
|||
#List of installed programming languages
|
||||
|
||||
*This list is incomplete, you can help by expanding it!*
|
||||
|
||||
listed by the name of their cli binary
|
||||
|
||||
* python
|
||||
* python3
|
||||
* lua
|
||||
* ruby
|
||||
* nodejs | js
|
||||
* gcc (C/C++)
|
||||
* g++ (C++)
|
||||
* ghc (haskell)
|
||||
* perl
|
||||
* perl6
|
||||
* prolog | swipl
|
||||
* bwbasic (bywater BASIC)
|
||||
* erl (erlang)
|
||||
* go (go-lang
|
||||
* rustc (rust)
|
||||
|
||||
### Lisps
|
||||
|
||||
* hy
|
||||
* racket
|
||||
* sbcl (steel bank common lisp)
|
||||
* chicken (scheme)
|
||||
* lumo (node clojurescript)
|
||||
* carp (carp-lang)
|
|
@ -0,0 +1,86 @@
|
|||
# Markdown
|
||||
|
||||
Why write HTML by hand when you can write [Markdown](http://commonmark.org/) easily on your tilde.town server?
|
||||
|
||||
Three simple steps:
|
||||
|
||||
1. write your wiki page as a markdown file and save it with a `.text` extension. eg: `markdown.text`
|
||||
2. type `make` in the shell. The `markdown.text` file + `page.theme` will be turned into `markdown.html` page.
|
||||
3. add these two files to git via `git add markdown.text markdown.html` and commit.
|
||||
4. profit!
|
||||
|
||||
## Markdown Syntax
|
||||
|
||||
Reference: [Markdown Basics](http://daringfireball.net/projects/markdown/basics)
|
||||
|
||||
Major Header
|
||||
============
|
||||
|
||||
Minor header
|
||||
------------
|
||||
|
||||
# Alternative Format Major Header
|
||||
|
||||
## Alternative Format Minor header
|
||||
|
||||
### Even more minor header
|
||||
|
||||
> Block quote
|
||||
|
||||
*italics* or _italics_
|
||||
|
||||
**bold** or __bold__
|
||||
|
||||
* Unor-
|
||||
* dered
|
||||
* List
|
||||
* (may also use + or - for bullets)
|
||||
|
||||
1. Or-
|
||||
2. dered
|
||||
3. List
|
||||
|
||||
[link text](link URI)
|
||||
|
||||
![alt text](image-URI "image title")
|
||||
|
||||
`code` (or indent paragraph four spaces or tab)
|
||||
|
||||
### Results
|
||||
|
||||
Major Header
|
||||
============
|
||||
|
||||
Minor header
|
||||
------------
|
||||
|
||||
# Alternative Format Major Header
|
||||
|
||||
## Alternative Format Minor header
|
||||
|
||||
### Even more minor header
|
||||
|
||||
> Block quote
|
||||
|
||||
*italics* or _italics_
|
||||
|
||||
**bold** or __bold__
|
||||
|
||||
* Unor-
|
||||
* dered
|
||||
* List
|
||||
* (may also use + or - for bullets)
|
||||
|
||||
1. Or-
|
||||
2. dered
|
||||
3. List
|
||||
|
||||
[link text](link URI)
|
||||
|
||||
![alt text](image-URI "image title")
|
||||
|
||||
`code` (or indent paragraph four spaces or tab)
|
||||
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
Sandbox
|
||||
=======
|
||||
|
||||
This page is for playing with the Tilde Town Git Wiki.
|
||||
|
||||
What hath God wrought?
|
||||
|
|
@ -0,0 +1,282 @@
|
|||
<!DOCTYPE html>
|
||||
<head>
|
||||
<title>ssh primer</title>
|
||||
<style type="text/css">
|
||||
body {
|
||||
background-color: #E0B0FF;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<h1>ssh primer! for tilde.town!</h1>
|
||||
<h2><em>or, how to connect to another computer and tell it to do cool things</em></h2>
|
||||
|
||||
<h3>
|
||||
**** if you just want to get right to a tutorial you can <a href="#tutorial">skip over this background info</a> ****
|
||||
</h3>
|
||||
|
||||
<p>
|
||||
While <a href="https://tilde.town">tilde.town</a> is accessible on the web
|
||||
and features lovely web pages written by its users, all of the interaction
|
||||
with tilde.town takes place <strong>inside the computer</strong> that runs
|
||||
tilde.town as opposed to via web forms that have an effect
|
||||
from <strong>outside</strong> tilde.town's computer.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
This is what sets tilde.town apart from most other online communities. You
|
||||
connect directly to another computer from yours alongside other people and
|
||||
then write your web pages, chat, and play games all via text-based
|
||||
interfaces right on tilde.town's computer.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Prior to the web (which debuted in 1995) this is how pretty much all
|
||||
computer stuff got done. You connected directly to a machine (usually over a
|
||||
direct, physical phone line) and did your work there.
|
||||
</p>
|
||||
|
||||
<p>For a long time, people used a tool called <a
|
||||
href="https://en.wikipedia.org/wiki/Telnet"><code>telnet</code></a> to
|
||||
connect to other computers. These days we use a tool called
|
||||
<strong>ssh</strong>.
|
||||
</p>
|
||||
|
||||
<p><code>ssh</code> is a text-based tool that provides a direct connection
|
||||
from your computer to another. ssh is an acronym that stands for Secure Shell.
|
||||
The <em>Shell</em> part refers to the fact that it's a text-based tool; we use
|
||||
the word shell to refer to a text-based interface that you give commands to.
|
||||
The <em>Secure</em> part refers to the fact that, when you're using ssh, no
|
||||
one can spy on your connection to another computer (unlike the
|
||||
old <code>telnet</code> command).
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<strong>why bother with all of this?</strong> passwords are really insecure
|
||||
and hard to manage. Using keys makes life easier for you, fair user (your
|
||||
account is less likely to be hacked) and for me, your humble sysadmin (less
|
||||
administration than passwords).
|
||||
</p>
|
||||
|
||||
<a name="tutorial"></a>
|
||||
<h2>ssh tutorial!</h2>
|
||||
<p>
|
||||
The end goal of this tutorial is to make a <strong>key pair</strong>. That's
|
||||
a set of two files full of numbers and letters. One file is public
|
||||
(your <em>public key</em>) and the other private (your <em>private key</em>).
|
||||
You'll be submitting the public key in the sign-up form and using the private
|
||||
key when you connect to tilde.town using ssh.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
choose your operating system:
|
||||
<a href="#windows">windows</a> |
|
||||
<a href="#osx">mac osx</a> |
|
||||
<a href="#linux">linux</a> |
|
||||
<a href="#android">android</a>
|
||||
</p>
|
||||
|
||||
|
||||
<hr>
|
||||
<a name="windows"></a>
|
||||
<h3>Windows</h3>
|
||||
|
||||
<p>
|
||||
We'll be using a tool called <a href="http://cmder.net">cmder</a>, which
|
||||
is a rather nice <a
|
||||
href="https://tilde.town/~vilmibm/images/trinity.jpg">terminal</a> that
|
||||
provides ssh stuff for you, too.
|
||||
</p>
|
||||
|
||||
<h4>generating your keypair</h4>
|
||||
<ol>
|
||||
<li>Download <a href="https://github.com/cmderdev/cmder/releases/download/v1.3.2/cmder.zip">a zipped copy of cmder</a>.</li>
|
||||
<li>Extract cmder.zip</li>
|
||||
<li>Run the extracted Cmder.exe</li>
|
||||
<li>
|
||||
You should see a <strong>Cmder</strong> terminal window that looks sort of like this:
|
||||
<p>
|
||||
<img width="600" height="400" src="https://tilde.town/~vilmibm/images/cmder.png">
|
||||
</p>
|
||||
</li>
|
||||
<li>
|
||||
copy and paste the following (paste by right clicking) into the
|
||||
<strong>Cmder</strong> window and hit <code>Enter</code>:
|
||||
<pre>
|
||||
mkdir .ssh || ssh-keygen -t rsa -b 2048 -f .ssh/tilde.town
|
||||
</pre>
|
||||
</li>
|
||||
<li>If it prompts to make a passphrase, just hit enter.</li>
|
||||
<li>
|
||||
Things should look like this:
|
||||
<p>
|
||||
<img width=600 height=400 src="https://tilde.town/~vilmibm/images/cmder_generating.png">
|
||||
</p>
|
||||
</li>
|
||||
<li>
|
||||
Copy and paste the following (paste by right clicking) into <strong>Cmder</strong>:
|
||||
<pre>
|
||||
cat ~/.ssh/tilde.town.pub
|
||||
</pre>
|
||||
</li>
|
||||
<li>Things should look like this:
|
||||
<p>
|
||||
<img width=600 height=400 src="https://tilde.town/~vilmibm/images/cmder_cat.png">
|
||||
</p>
|
||||
</li>
|
||||
<li>
|
||||
Copy the block that was output starting
|
||||
with <code>ssh-rsa</code> and paste it in the "SSH public key" field on the
|
||||
sign up form (copy by highlighting the text and pressing control + c).
|
||||
</li>
|
||||
<li>
|
||||
The other file that was generated (<code>.ssh/tilde.town</code>) is
|
||||
your private key. Treat it like a password and never share it with anyone.
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h4>using your key</h4>
|
||||
<p>
|
||||
Once <a href="https://tilde.town/~vilmibm">~vilmibm</a> or another admin
|
||||
approves your sign-up, you can connect to tilde.town.
|
||||
</p>
|
||||
<ol>
|
||||
<li>Open <strong>Cmder</strong>, which we unzipped in the last section.</li>
|
||||
<li>
|
||||
Type the following in the <strong>Cmder</strong> window and hit <code>Enter</code>:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town YOURUSERNAME@tilde.town
|
||||
</pre>
|
||||
Replace <code>YOURUSERNAME</code> with the username you signed up with. For example, if your username is <code>sharon_olds</code>, you would run this command:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town sharon_olds@tilde.town
|
||||
</pre>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<hr>
|
||||
<a name="osx"></a>
|
||||
<h3>Mac OSX</h3>
|
||||
|
||||
<h4>generating your keypair</h4>
|
||||
|
||||
<ol>
|
||||
<li>Open <strong>Terminal</strong> (in <code>/Applications/Utilities</code>).</li>
|
||||
<li>
|
||||
In the <strong>Terminal</strong> window, copy and paste the following and press <code>Enter</code>:
|
||||
<pre>
|
||||
mkdir -m 700 ~/.ssh # Create your .ssh directory
|
||||
ssh-keygen -t rsa -b 2048 -f ~/.ssh/tilde.town # Create your keys
|
||||
</pre>
|
||||
</li>
|
||||
<li>Say no when it asks if you want to set a passphrase.</li>
|
||||
<li>In the <strong>Terminal</strong> window, copy and paste the following and press <code>Enter</code>:
|
||||
<pre>
|
||||
cd ~/.ssh # Go to the .ssh folder in your home folder
|
||||
cat tilde.town.pub # Outputs the content of your public key
|
||||
</pre>
|
||||
</li>
|
||||
<li>
|
||||
Copy the block that was output in <strong>Terminal</strong> starting
|
||||
with <code>ssh-rsa</code> and paste it in the "SSH public key" field on the
|
||||
sign up form.
|
||||
</li>
|
||||
<li>The other file that was generated (<code>~/.ssh/tilde.town</code>) is
|
||||
your private key. Treat it like a password and never share it with anyone.</li>
|
||||
</ol>
|
||||
|
||||
<h4>using your keypair</h4>
|
||||
|
||||
<p>
|
||||
Once <a href="https://tilde.town/~vilmibm">~vilmibm</a> or another admin
|
||||
approves your sign-up, you can connect to tilde.town.
|
||||
</p>
|
||||
<ol>
|
||||
<li>Open <strong>Terminal</strong> (in <code>/Applications/Utilities</code>).</li>
|
||||
<li>
|
||||
Type the following in the Terminal window and hit <code>Enter</code>:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town YOURUSERNAME@tilde.town
|
||||
</pre>
|
||||
Replace <code>YOURUSERNAME</code> with the username you signed up with. For example, if your username is <code>sharon_olds</code>, you would run this command:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town sharon_olds@tilde.town
|
||||
</pre>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
|
||||
<hr>
|
||||
<a name="linux"></a>
|
||||
<h3>Linux</h3>
|
||||
|
||||
<p>
|
||||
There are lots of different Linux distributions out there but they should
|
||||
all have <code>ssh</code>, <code>ssh-keygen</code>, and a terminal program.
|
||||
</p>
|
||||
|
||||
<h4>generating your keypair</h4>
|
||||
|
||||
<ol>
|
||||
<li>Open a terminal.</li>
|
||||
<li>in the terminal window, copy and paste the following and press <code>Enter</code>:
|
||||
<pre>
|
||||
mkdir -m 700 ~/.ssh # Create a folder called .ssh. It's okay if it already exists.
|
||||
ssh-keygen -trsa -b 2048 -f ~/.ssh/tilde.town # create the keypair
|
||||
</pre>
|
||||
</li>
|
||||
<li>Say no when it asks if you want to set a passphrase</li>
|
||||
<li>
|
||||
in the terminal window, copy and paste the following and press <code>Enter</code>:
|
||||
<pre>
|
||||
cd ~/.ssh # Go to the .ssh folder in your home folder
|
||||
cat tilde.town.pub # Output the content of your public key
|
||||
</pre>
|
||||
</li>
|
||||
<li>
|
||||
Copy the block that gets output in the terminal starting with <code>ssh-rsa</code> and paste it in the <strong>SSH public key</strong> field on the signup form.
|
||||
</li>
|
||||
<li>The other file that was generated (<code>~/.ssh/tilde.town</code>) is
|
||||
your private key. Treat it like a password and never share it with anyone.</li>
|
||||
</ol>
|
||||
|
||||
<h4>using your keypair</h4>
|
||||
|
||||
<p>
|
||||
Once <a href="https://tilde.town/~vilmibm">~vilmibm</a> or another admin
|
||||
approves your sign-up, you can connect to tilde.town.
|
||||
</p>
|
||||
<ol>
|
||||
<li>Open your terminal program.</li>
|
||||
<li>
|
||||
Type the following in the terminal window and hit <code>Enter</code>:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town YOURUSERNAME@tilde.town
|
||||
</pre>
|
||||
Replace <code>YOURUSERNAME</code> with the username you signed up with.
|
||||
For example, if your username is <code>sharon_olds</code>, you would run
|
||||
this command:
|
||||
<pre>
|
||||
ssh -i ~/.ssh/tilde.town sharon_olds@tilde.town
|
||||
</pre>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<hr>
|
||||
<a name="android"></a>
|
||||
<h3>Android</h3>
|
||||
|
||||
<p>
|
||||
This is kind of a bonus round! Check out <a href="http://juicessh.com/">JuiceSSH</a>
|
||||
and <a href="http://sonelli.freshdesk.com/support/solutions/articles/187068-how-do-i-generate-an-ssh-key-within">this tutorial</a> for generating a keypair and <a href="http://sonelli.freshdesk.com/support/solutions/articles/178806-how-to-create-define-a-new-ssh">this tutorial</a> for connecting.
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
<blockquote>
|
||||
IMPORTANT! this tutorial is based on and uses parts
|
||||
of <a href="https://github.com/tildeclub/tilde.club/blob/master/docs/ssh.md">the
|
||||
tilde.club ssh primer</a>.
|
||||
</blockquote>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,4 @@
|
|||
# Text Editor Help
|
||||
- [Vim Reference Chart](http://tilde.town/~shanx/vim.html#reference)
|
||||
- [Vim Daily Tips](http://tilde.town/~shanx/vim.html#TIL)
|
||||
- [nano reference](http://tilde.town/~minerobber/nanoreference)
|
|
@ -0,0 +1,13 @@
|
|||
Tilde Town Help
|
||||
===============
|
||||
|
||||
[How to \~tilde; a n00b's
|
||||
primer](http://tilde.town/~nezvanova/etc/primer_es.html)
|
||||
|
||||
[Set Up SSH](http://tilde.town/~shanx/cli.html#ssh)
|
||||
|
||||
[Tweeting, Haiku'ing, and other fun in
|
||||
tilde.town](http://tilde.town/~shanx/other.html#tilde)
|
||||
|
||||
[How to use IRC with a client running on your own machine (via an SSH tunnel)](http://tilde.town/~nick/sshtunnel.html)
|
||||
|
|
@ -0,0 +1,4 @@
|
|||
# Unix Help
|
||||
|
||||
- [Beginner's CLI Chart & SSH Intro](http://tilde.town/~shanx/cli.html)
|
||||
|
|
@ -1 +1,9 @@
|
|||
FOOTERS ARE AWESOME RIGHT RIGHT?
|
||||
<p>
|
||||
all content written by tilde.town users and licensed CC-BY-SA unless otherwise
|
||||
noted.
|
||||
</p>
|
||||
<p>
|
||||
have a good one~
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
@ -1 +1,12 @@
|
|||
I AM A HEADER AREN'T I COOL
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>tilde.town wiki</title>
|
||||
<link rel="stylesheet" href="theme.css">
|
||||
</head>
|
||||
<body>
|
||||
# the [tilde.town](https://tilde.town) wiki
|
||||
|
||||
[index](https://tilde.town/wiki) | [table of contents](/wiki/toc.html)
|
||||
|
||||
<hr>
|
||||
|
|
Loading…
Reference in New Issue