add useful meta documentation

This commit is contained in:
ben clark 2021-03-14 00:47:20 +00:00
parent 3d649ff9e4
commit 9a3e8cfde2
4 changed files with 134 additions and 2 deletions

View File

@ -103,5 +103,6 @@ pre {
code {
font-family: 'Comic Mono', monospace;
font-size: 14px;
background-color: #e4e4e4;
font-weight: 400;
}
}

View File

@ -5,6 +5,42 @@ color: blue
---
hi! welcome to the wiki. it contains some helpful info about living life on southlondon.cc.
### a table of contents
# a table of contents
## getting started
- [logging in: a guide](./login.html)
- [ssh tips and tricks](./ssh.html)
## making things
- [some things you could make](./ideas.html)
- [some good books on writing code](./howtobegoodatprogramming.html)
- [how to use git without wanting to shit your pants and kill your roommate](./git.html)
## getting on tv
- [getting your stuff on the main channels](./tv/main/)
- [sltv advertising](./tv/main/ads.html)
- [content guidelines](./tv/main/content.html)
- [making your own channel](./tv/userchannels/)
- [content guidelines](./tv/userchannels/content.html)
## living life
- [making your page exceptionally snazzy](./designtips.html)
- [hosting git repos for fun and profit](./githosting.html)
## talking to strangers
- [connect to irc](./irc.html)
- [using xmpp](./xmpp.html)
- [collecting tokens](./tokens.html)
- [fun things to say in #meta](./meta.html)
## getting help
- [help! i need help!](./help.html)
- [so you've been banned from sl](./gettingbanned.html)
- [requesting packages](./packages.html)
- [know your rights](./rights.html)
## helping out
- [how to contribute to this wiki](./contribute.html)
- [how to give us money](./donate.html)
<style>
main {max-width: 500px;}
</style>

19
wiki/meta.md Normal file
View File

@ -0,0 +1,19 @@
---
title: fun things to say in \#meta
author: cark
date: 2021-03-14
---
if #meta is too quiet for you liking, try these conversation starters to guarantee fruitful discourse.
- `・゜゜・。。・゜゜\_o< QUACK!`
- "gemini is really bad"
- anything positive about systemd
- `/quit`
- any sentance containing the phrase "time zones"
- any opinion about anton's website
- anything positive about electron
- any bot command
- mention any current event
- bruh
- hey guys i need help with this `<thing that is clearly documented in manpages>`
- why

76
wiki/ssh.md Normal file
View File

@ -0,0 +1,76 @@
---
title: ssh tips and tricks
subtitle: impress your friends and coworkers with these epic ssh tips !!!
author: cark
date: 2021-03-13
---
ssh seems really easy to use, because it is. but could it be easier to use? let's find out!
# making config files
when using ssh, you might find yourself rewriting the same command over and over again, you could press the up arrow 100+ times to find the command that you were using the other day, or you could write a config file. your personal ssh config file is stored in ~/.ssh/config.
ssh config files have this stucture:
```
Host my_server
<keyword> <value>
<keyword> <value>
<keyword> <value>
<keyword> <value>
Host my_other_server
<keyword> <value>
<keyword> <value>
Host * # applied to all connections
<keyword> <value>
```
as with most things, `*` represents a wildcard (i.e. `192.168.0.*` will match everything in the `192.168.0.0/24`) and `?` matches one character from 0-9 (i.e. `192.168.0.?` will match everything from `192.168.0.0` to `192.168.0.9`). you can read more about it in the ssh_config man page (`man ssh_config`). all possible keywords are also listed in the ssh_config man page.
okay! now, how can we apply this knowledge to something useful? let's have an example.
say you're trying to log in to `cark.website` as `giovanni` on port `24`, you would use this command:
```bash
$ ssh giovanni@cark.website -p 24
```
wow! what a pain to write! luckily we can use the config file to make this much more convenient to write. first, open up `~/.ssh/config` using your favourite editor. now, we'll define a host
```
Host site
```
now, let's add some options
```
HostName cark.website
User giovanni
Port 24
```
hopefully, all those options should be fairly easy to understand, you read the manpages, right? `HostName` is the host you want to connect to, `User` is the user you want to log in as and `Port` is the port you want to use.
now, we'll be left with this file
```
Host site
HostName cark.website
User giovanni
Port 24
```
finally, save it and let's give it a go!
```
$ ssh site
Welcome to Ubuntu 20.04.2 LTS (GNU/Linux 5.4.0-51-generic x86_64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage
System information as of Sun Mar 14 00:03:14 UTC 2021
System load: 0.0 Users logged in: 0
Usage of /: 7.7% of 24.06GB IPv4 address for eth0: 128.62.125.163
Memory usage: 24% IPv4 address for eth0: 10.16.0.6
Swap usage: 0% IPv4 address for eth1: 10.106.0.3
Processes: 110
0 updates can be installed immediately.
0 of these updates are security updates.
*** System restart required ***
Last login: Sat Mar 13 18:07:30 2021 from 91.110.54.64
giovanni@cark:~$
```
as you can see, by using the ssh config file strat, we've saved many precious frames in our ssh session, that we can use to our advantage later on.
this is only the tip of the iceberg (well, more like the middle of the iceberg, there aren't *that* many things you can do with you ssh config file), go search up some examples on the internet and enjoy the extra seconds of your life not spent typing in ssh commands.