migrate from phabricator

2021-03-10 17:33:58 +00:00 · 2021-03-10 17:33:58 +00:00 · 2ec36d8557
commit 2ec36d8557
41 changed files with 557 additions and 0 deletions
--- a/coc/index.html
+++ b/coc/index.html
@ -0,0 +1,72 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset='utf-8'>
+    <meta http-equiv='X-UA-Compatible' content='IE=edge'>
+    <title>code of conduct - south london</title>
+    <meta name='viewport' content='width=device-width, initial-scale=1'>
+    <link rel='stylesheet' type='text/css' media='screen' href='/main.css'>
+    <script src='/main.js'></script>
+</head>
+<body>
+    <div class="header header-orange">
+        <p style="white-space: pre-line">code of
+        conduct</p>
+    </div>
+    <main>
+        <p style="text-align: center;"><a href="/">🌿 home</a> · <a href="/signup">🌱 signup</a> · <a href="/wetty">🌺 webterm</a> · <a href="/coc">🌷 code of conduct</a> · <a href="/wiki">🌻 wiki</a> · <a href="/faq">💐 faq</a></p>
+        hi! south london is a public access unix system that people can use to make things & interact with others on the system via irc and email. these are a few rules that you need to keep to when doing that.
+        <em>(this code of conduct is <strike>stolen</strike> based on the <a href="http://citizencodeofconduct.org/">citizen code of conduct</a> and the <a href="http://tilde.town/wiki/conduct.html">tilde.town code of conduct</a> under the terms of the <a href="https://creativecommons.org/licenses/by-sa/3.0/">creative commons attribution-sharealike license,</a>)</em>
+        <h3>expected behaviour</h3>
+        the following behaviours are expected and requested of all members of our community.
+        <ul>
+            <li>participate in an authentic and active way. in doing so, you contribute to the health and longevity of this community.</li>
+            <li>exercise consideration and respect in your speech and actions</li>
+            <li>attempt collaboration before conflict.</li>
+            <li>refrain from demeaning, discriminatory, or harassing behavior and speech.</li>
+            <li>be mindful of your surroundings and of your fellow participants.</li>
+            <li>teach when people need help. don’t do it for them.</li>
+        </ul>
+        <h3>unacceptable behavior</h3>
+        the following behaviors are considered harassment and are unacceptable within our community:
+        <ul>
+            <li>violence, threats of violence or violent language directed against another person.</li>
+            <li>sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language.</li>
+            <li>posting or displaying sexually explicit or violent material.</li>
+            <li>posting or threatening to post other people's personally identifying information ("doxing").</li>
+            <li>personal insults, particularly those related to gender, sexual orientation, race, religion, or disability.</li>
+            <li>unwelcome sexual attention. this includes sexualized comments or jokes.</li>
+            <li>deliberate intimidation, stalking or following.</li>
+        </ul>    
+        <h3>resource use</h3>
+        all users must be respectful of system resources, we are quite a small tilde for the time being. anyone using excessive amounts of storage, ram or cpu will be nicely asked to stop, then sternly asked to stop, see the next section for more details.
+        <h3>consequences of unacceptable behavior</h3>
+        unacceptable behavior from any community member, including sponsors and those with decision-making authority (sudo), will not be tolerated.
+        <br>
+        <b>anyone asked to stop unacceptable behavior is expected to comply immediately.</b>
+        <br>
+        if a community member engages in unacceptable behavior, the community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from tilde.team without warning (meaning your account will be terminated and all user data deleted).
+        <h3>reporting guidelines</h3>
+        <p>if you are subject to or witness unacceptable behavior, or have any other concerns, please contact an admin (see info below).
+        <br>
+        additionally, help engaging with law enforcement is available.</p>
+        <h3>addressing grievances</h3>
+        <p>if you feel you have been falsely or unfairly accused of violating this code of conduct, use the contact info below to send a concise description of your grievance.</p>
+        <h3>scope</h3>
+        we expect all south london members to abide by this code of conduct while:
+        <ul>
+            <li>engaging with other members</li>
+            <li>publishing content on south london</li>
+        </ul>
+        <h3>contact info</h3>
+        <p style="white-space: pre-line">send an email to:
+            root (at) southlondon (dot) cc 
+            or to benclark006 (at) outlook (dot) com</p>
+        <hr class="zig">
+        <hr class="zag">
+        this document is not all encompassing, we reserve the right to throw your account into the sun for any reason at any time.
+        <br>
+        thank you and gosh bless.
+    </main>
+</body>
+</html>
--- a/faq/index.html
+++ b/faq/index.html
@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset='utf-8'>
+    <meta http-equiv='X-UA-Compatible' content='IE=edge'>
+    <title>signup - south london</title>
+    <meta name='viewport' content='width=device-width, initial-scale=1'>
+    <link rel='stylesheet' type='text/css' media='screen' href='/main.css'>
+    <script src='/main.js'></script>
+</head>
+<body>
+    <div class="header header-blue">
+        <p style="white-space: pre-line">"frequently" asked
+        questions</p>
+    </div>
+    <main>
+        <p style="text-align: center;"><a href="/">🌿 home</a> · <a href="/signup">🌱 signup</a> · <a href="/wetty">🌺 webterm</a> · <a href="/coc">🌷 code of conduct</a> · <a href="/wiki">🌻 wiki</a> · <a href="/faq">💐 faq</a></p>
+        <h2>signing up</h2>
+        <h3>what are these ssh key whatchamacallits that you speak of?</h3>
+        <p>ssh keys are a method of authentication that the server can use to make sure you're actually you logging in, and not just some guy trying to get into your account. it works using magic and offers security that your bog-standard password simply can't provide. if you need to generate one, <a href="https://tilde.town/wiki/getting-started/ssh.html">check out this handy guide!</a> after you have one generated, you can use <code>cat ~/.ssh/id_rsa.pub</code> to get your public key that you can paste into the signup email. (note: if your keys are stored somewhere else you'll need to change the second part to the path where they're located, but you probably knew that already).</p>
+        <h3>wait, so why would i want to sign up this again?</h3>
+        <p>mostly becuase <br>
+            a) it's fun <br>
+            b) it's a good practice zone if you're new to *nix operating systems and need somewhere to play around with things<br>
+            c) we have a good community that can help you out if you're stuck.
+        </p>
+        <h2>account deletion etc.</h2>
+        <h3>how can i delete my account?</h3>
+        <p>send an email to benclark006@outlook.com using the email that you used to sign up and say you want out, and i'll delete it.</p>
+        <h3>can i request a copy of my data?</h3>
+        <p>yes! send an email to benclark006@outlook.com and i'll send you a copy of your data within 14 days.</p>
+        <h2>other</h2>
+        <h3>how are you?</h3>
+        <p>depends on when you're reading this</p>
+    </main>
+</body>
+</html>
--- a/favicon.svg
+++ b/favicon.svg
@ -0,0 +1,3 @@
+<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M39.9104 11.94C39.8104 9.86 38.1304 8.18 36.0704 8.1C34.6704 8.04 33.3304 8 32.0304 8C21.9704 8 14.9904 9.94 11.1104 13.82C3.75038 21.18 4.81038 31.62 11.2904 37.62C11.3104 37.62 11.3104 37.62 11.3104 37.62C14.3304 29.18 20.3504 23.3 26.6504 20.02C26.2304 20.38 17.2504 27.18 15.6304 40.52C17.7304 41.48 20.0304 42.02 22.3504 42.02C26.4504 42.02 30.6704 40.42 34.1904 36.92C38.5704 32.52 40.4704 24.2 39.9104 11.94Z" fill="#1B6B2D"/>
+</svg>
--- a/fonts.css
+++ b/fonts.css
@ -0,0 +1,51 @@
+/* fredoka-one-regular - latin */
+@font-face {
+    font-family: 'Fredoka One';
+    font-style: normal;
+    font-weight: 400;
+    src: url('/fonts/fredoka-one-v8-latin-regular.eot'); /* IE9 Compat Modes */
+    src: local(''),
+         url('/fonts/fredoka-one-v8-latin-regular.eot?#iefix') format('embedded-opentype'), /* IE6-IE8 */
+         url('/fonts/fredoka-one-v8-latin-regular.woff2') format('woff2'), /* Super Modern Browsers */
+         url('/fonts/fredoka-one-v8-latin-regular.woff') format('woff'), /* Modern Browsers */
+         url('/fonts/fredoka-one-v8-latin-regular.ttf') format('truetype'), /* Safari, Android, iOS */
+         url('/fonts/fredoka-one-v8-latin-regular.svg#FredokaOne') format('svg'); /* Legacy iOS */
+}
+/* manrope-regular - latin */
+@font-face {
+    font-family: 'Manrope';
+    font-style: normal;
+    font-weight: 400;
+    src: url('/fonts/manrope-v4-latin-regular.eot'); /* IE9 Compat Modes */
+    src: local(''),
+         url('/fonts/manrope-v4-latin-regular.eot?#iefix') format('embedded-opentype'), /* IE6-IE8 */
+         url('/fonts/manrope-v4-latin-regular.woff2') format('woff2'), /* Super Modern Browsers */
+         url('/fonts/manrope-v4-latin-regular.woff') format('woff'), /* Modern Browsers */
+         url('/fonts/manrope-v4-latin-regular.ttf') format('truetype'), /* Safari, Android, iOS */
+         url('/fonts/manrope-v4-latin-regular.svg#Manrope') format('svg'); /* Legacy iOS */
+  }
+  
+  /* manrope-700 - latin */
+  @font-face {
+    font-family: 'Manrope';
+    font-style: normal;
+    font-weight: 700;
+    src: url('/fonts/manrope-v4-latin-700.eot'); /* IE9 Compat Modes */
+    src: local(''),
+         url('/fonts/manrope-v4-latin-700.eot?#iefix') format('embedded-opentype'), /* IE6-IE8 */
+         url('/fonts/manrope-v4-latin-700.woff2') format('woff2'), /* Super Modern Browsers */
+         url('/fonts/manrope-v4-latin-700.woff') format('woff'), /* Modern Browsers */
+         url('/fonts/manrope-v4-latin-700.ttf') format('truetype'), /* Safari, Android, iOS */
+         url('/fonts/manrope-v4-latin-700.svg#Manrope') format('svg'); /* Legacy iOS */
+}
+    
+@font-face {
+    font-family: "Comic Mono";
+    font-weight: 400;
+    src: url("/fonts/ComicMono.ttf") format("truetype");
+}
+@font-face {
+    font-family: "Comic Mono";
+    font-weight: 700;
+    src: url("/fonts/ComicMono-Bold.ttf") format("truetype");
+}
--- a/fonts/ComicMono-Bold.ttf
+++ b/fonts/ComicMono-Bold.ttf
--- a/fonts/ComicMono.ttf
+++ b/fonts/ComicMono.ttf
--- a/fonts/fredoka-one-v8-latin-regular.ttf
+++ b/fonts/fredoka-one-v8-latin-regular.ttf
--- a/fonts/fredoka-one-v8-latin-regular.woff
+++ b/fonts/fredoka-one-v8-latin-regular.woff
--- a/fonts/fredoka-one-v8-latin-regular.woff2
+++ b/fonts/fredoka-one-v8-latin-regular.woff2
--- a/fonts/manrope-v4-latin-200.ttf
+++ b/fonts/manrope-v4-latin-200.ttf
--- a/fonts/manrope-v4-latin-200.woff
+++ b/fonts/manrope-v4-latin-200.woff
--- a/fonts/manrope-v4-latin-200.woff2
+++ b/fonts/manrope-v4-latin-200.woff2
--- a/fonts/manrope-v4-latin-300.ttf
+++ b/fonts/manrope-v4-latin-300.ttf
--- a/fonts/manrope-v4-latin-300.woff
+++ b/fonts/manrope-v4-latin-300.woff
--- a/fonts/manrope-v4-latin-300.woff2
+++ b/fonts/manrope-v4-latin-300.woff2
--- a/fonts/manrope-v4-latin-500.ttf
+++ b/fonts/manrope-v4-latin-500.ttf
--- a/fonts/manrope-v4-latin-500.woff
+++ b/fonts/manrope-v4-latin-500.woff
--- a/fonts/manrope-v4-latin-500.woff2
+++ b/fonts/manrope-v4-latin-500.woff2
--- a/fonts/manrope-v4-latin-600.ttf
+++ b/fonts/manrope-v4-latin-600.ttf
--- a/fonts/manrope-v4-latin-600.woff
+++ b/fonts/manrope-v4-latin-600.woff
--- a/fonts/manrope-v4-latin-600.woff2
+++ b/fonts/manrope-v4-latin-600.woff2
--- a/fonts/manrope-v4-latin-700.ttf
+++ b/fonts/manrope-v4-latin-700.ttf
--- a/fonts/manrope-v4-latin-700.woff
+++ b/fonts/manrope-v4-latin-700.woff
--- a/fonts/manrope-v4-latin-700.woff2
+++ b/fonts/manrope-v4-latin-700.woff2
--- a/fonts/manrope-v4-latin-800.ttf
+++ b/fonts/manrope-v4-latin-800.ttf
--- a/fonts/manrope-v4-latin-800.woff
+++ b/fonts/manrope-v4-latin-800.woff
--- a/fonts/manrope-v4-latin-800.woff2
+++ b/fonts/manrope-v4-latin-800.woff2
--- a/fonts/manrope-v4-latin-regular.ttf
+++ b/fonts/manrope-v4-latin-regular.ttf
--- a/fonts/manrope-v4-latin-regular.woff
+++ b/fonts/manrope-v4-latin-regular.woff
--- a/fonts/manrope-v4-latin-regular.woff2
+++ b/fonts/manrope-v4-latin-regular.woff2
--- a/index.php
+++ b/index.php
@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset='utf-8'>
+    <meta http-equiv='X-UA-Compatible' content='IE=edge'>
+    <title>south london</title>
+    <meta name='viewport' content='width=device-width, initial-scale=1'>
+    <link rel='stylesheet' type='text/css' media='screen' href='main.css'>
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg">
+    <script src='main.js'></script>
+</head>
+<body>
+    <div class="header">
+        <p style="white-space: pre-line">south
+            london</p>
+    </div>
+    <main>
+        <p style="text-align: center;"><a href="/">🌿 home</a> · <a href="/signup">🌱 signup</a> · <a href="/wetty">🌺 webterm</a> · <a href="/coc">🌷 code of conduct</a> · <a href="/wiki">🌻 wiki</a> · <a href="/faq">💐 faq</a></p>
+        south london is a shared computer based in the uk that you can use to make cool things and practice your unix skills. if you're new to *nix, this is a good place to start!
+        <br>
+        the main perk of using this server over any other pubnix is that
+        <ol>
+            <li>we're based in the uk, so if you're in or near there you'll get much better ping</li>
+            <li>we have a much better name than most other pubnixes</li>
+        </ol>
+        <br>
+        the server is currently in beta, so don't try to put any super-sensitive files on here <i>just in case</i> there's a security hole that hasn't been patched up yet. (if you do spot one, let me know!)
+        <br>
+
+        <hr class="zig">
+        <hr class="zag">
+        <h3>users</h3>
+        this is a list of every user page on the server.
+        <ul><?php
+        $usercount = 0;
+        foreach (glob("/home/*/public_html", GLOB_ONLYDIR) as $user):
+            $user = basename(dirname($user));
+            $usercount++; ?>
+            <li><a href="/~<?=$user?>/" class="">~<?=$user?></a></li>
+            <?php endforeach; ?></ul>
+        <hr class="zig">
+        <hr class="zag">
+        enjoy and god save the queen <br>
+        - ben / lp0 / cark
+        <em>(this site's code can be found <a href="https://code.cark.website/diffusion/4/">over here</a>)</em>
+    </main>
+</body>
+</html>
--- a/main.css
+++ b/main.css
@ -0,0 +1,107 @@
+@import url(/fonts.css);
+body {
+    background: #fff;
+    margin:0;
+    font-family: 'Manrope', sans-serif;
+}
+
+.header {
+    font-family: 'Fredoka One', cursive;
+    text-align: center;
+    font-size: 4em;
+    position: relative;
+    width: calc(100% - 16px); /* css weirdness */
+    padding: 50px 8px 100px 8px;
+    background: #B7EBCA;
+    color: #316A3A;
+    line-height: 100%;
+}
+.header-wiki {
+    padding: 80px 8px 140px 8px;
+}
+.header-wiki p {
+    margin-bottom: -20px;
+}
+
+.header:after {
+    background: linear-gradient(-45deg, #fff 16px, transparent 0), linear-gradient(45deg, #fff 16px, transparent 0);
+    background-position: left-bottom;
+    background-repeat: repeat-x;
+    background-size: 32px 32px;
+    content: " ";
+    display: block;
+    position: absolute;
+    bottom: 0px;
+    left: 0px;
+    width: 100%;
+    height: 32px;
+}
+
+main {
+    max-width: 900px;
+    margin: auto;
+    padding: 24px 10%;
+}
+
+h1,h2,h3 {
+    font-family: 'Fredoka One', cursive;
+}
+
+hr.zig, hr.zag {
+    border: none;
+    height: 30px;
+    margin: 12px 0;
+}
+hr.zig{
+background: linear-gradient(-135deg, #FFF 20px, rgba(0, 0, 0, 0) 0) 0 5px, linear-gradient(135deg, #FFF 20px, rgba(0, 0, 0, 0) 0) 0 5px;
+background-color: rgba(0, 0, 0, 0);
+background-position: center bottom;
+background-repeat: repeat-x;
+background-size: 20px 40px;
+z-index: 100;
+position: relative;
+}
+hr.zag {
+background: linear-gradient(-135deg, #b1b1b1 20px, rgba(0, 0, 0, 0) 0) 0 5px, linear-gradient(135deg, #b1b1b1 20px, #FFF 0) 0 5px;
+background-color: rgba(0, 0, 0, 0);
+background-position: center bottom;
+background-repeat: repeat-x;
+background-size: 20px 40px;
+z-index: 50;
+margin-top: -40px;
+}
+
+a {
+    color: #000;
+}
+
+/* colours */
+
+.header-red {
+    background: #f0b2b2;
+    color: #7e1616;
+}
+
+.header-orange {
+    background: #f0d5b2;
+    color: #7e3c16;
+}
+
+.header-blue {
+    background: #b2cbf0;
+    color: #26167e;
+}
+
+/* code blocks */
+
+pre {
+    width: 100%;
+    background-color: #e4e4e4;
+    padding: 12px 18px;
+    border-radius: 4px;
+}
+code {
+    font-family: 'Comic Mono', monospace;
+    font-size: 14px;
+    font-weight: 400;
+}
--- a/main.js
+++ b/main.js
--- a/signup/index.html
+++ b/signup/index.html
@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset='utf-8'>
+    <meta http-equiv='X-UA-Compatible' content='IE=edge'>
+    <title>signup - south london</title>
+    <meta name='viewport' content='width=device-width, initial-scale=1'>
+    <link rel='stylesheet' type='text/css' media='screen' href='/main.css'>
+    <script src='/main.js'></script>
+</head>
+<body>
+    <div class="header header-red">
+        <p style="white-space: pre-line">signup</p>
+    </div>
+    <main>
+        <p style="text-align: center;"><a href="/">🌿 home</a> · <a href="/signup">🌱 signup</a> · <a href="/wetty">🌺 webterm</a> · <a href="/coc">🌷 code of conduct</a> · <a href="/wiki">🌻 wiki</a> · <a href="/faq">💐 faq</a></p>
+        <p><b>shoot an email at benclark006@outlook.com.</b></p>
+        <p>
+        you'll need to include you're desired username, ssh public key (see faq for details) and a note saying you've read the code of conduct and that you're over thirteen so i don't get sued. if you prefer a specific shell over bash, you can include that on the email too.</p>
+        enjoy the tilde!
+    </main>
+</body>
+</html>
--- a/wiki/.gitignore
+++ b/wiki/.gitignore
@ -0,0 +1 @@
+*.html
--- a/wiki/Makefile
+++ b/wiki/Makefile
@ -0,0 +1,16 @@
+# stolen from https://tildegit.org/ben/club-site/src/branch/master/Makefile
+
+SRC_MD_FILES != find . -type f \( -name '*.md' ! -name 'README.md' \)
+DST_HTML_FILES := $(SRC_MD_FILES:%.md=%.html)
+
+all: $(DST_HTML_FILES)
+
+%.html: %.md
+	$(info building $@)
+	@pandoc --template html.template -so $@ $<
+
+clean:
+	$(info removing build artifacts)
+	@rm $(DST_HTML_FILES)
+
+.PHONY: clean 
--- a/wiki/contribute.md
+++ b/wiki/contribute.md
@ -0,0 +1,63 @@
+---
+title: contributing
+subtitle: how to help out
+author: cark
+date: 2021-03-05
+---
+this wiki is written with markdown and turned into html with pandoc. i store everything on my phabricator instance @ https://code.cark.website/. if you're not familiar with phabricator already, the workflow may seem a little bit strange but this doc will try to guide you through it. if you're stuck, don't hesitate to send a message on irc!
+
+0. make an account on the [phabricator instance ](https://code.cark.website/)  
+   signups require approval beforehand to reduce spam, just ping an admin on irc and they'll approve it.
+
+1. clone the repo from phabricator:
+```bash
+cark@southlondon:~$ git clone https://code.cark.website/diffusion/4/south-london.git
+Cloning into 'south-london'...
+remote: Enumerating objects: 111, done.
+remote: Counting objects: 100% (111/111), done.
+remote: Compressing objects: 100% (99/99), done.
+remote: Total 111 (delta 51), reused 0 (delta 0), pack-reused 0
+Receiving objects: 100% (111/111), 251.23 KiB | 2.03 MiB/s, done.
+Resolving deltas: 100% (51/51), done.
+```
+
+2. make your changes  
+   if you've never used markdown, you might want to have a look at [this here cheat sheet](https://www.markdownguide.org/cheat-sheet/)
+
+3. build it  
+   run `make` to build all wiki pages, you can then open up a http server and browse away!
+```bash
+cark@southlondon:~/south-london/wiki$ make
+building contribute.html
+$ python3 -m http.server 8000
+Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
+# wiki content will be served up at http://localhost:8000/wiki/
+```
+4. commit and submit a diff to phabricator  
+```bash
+cark@southlondon:~/south-london/wiki$ git diff > patch.diff
+# upload the file it spits out to https://code.cark.website/differential/diff/create/
+
+# you can also use arc for this if you have it installed
+cark@southlondon:~/south-london/wiki$ arc diff
+You have uncommitted changes in this working copy.
+
+  Working copy: /home/cark/south-london/
+
+  Unstaged changes in working copy:
+    changes.diff
+
+Uncommitted changes in working copy:
+    site/fonts/ComicMono-Bold.ttf
+    site/fonts/ComicMono.ttf
+    site/main.css
+    site/wiki/contribute.md
+
+
+    Do you want to create a new commit with these 5 change(s)? [y/N] y
+# fill in the blanks when asked
+
+```
+5. fill in the details  
+   give it a name, describe your changes, add a test plan (usually just run make and open in an http server). set south london as the tag.
+after you've submitted it, you can ping an admin on irc or just wait for someone to see it and they'll review it. keep an eye on the comments in case changes are needed.
--- a/wiki/html.template
+++ b/wiki/html.template
@ -0,0 +1,81 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="$lang$" xml:lang="$lang$"$if(dir)$ dir="$dir$"$endif$>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="pandoc" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
+$for(author-meta)$
+  <meta name="author" content="$author-meta$" />
+$endfor$
+$if(date-meta)$
+  <meta name="dcterms.date" content="$date-meta$" />
+$endif$
+$if(keywords)$
+  <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$" />
+$endif$
+  <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$ - south london</title>
+  <style type="text/css">
+      code{white-space: pre-wrap;}
+      span.smallcaps{font-variant: small-caps;}
+      span.underline{text-decoration: underline;}
+      div.column{display: inline-block; vertical-align: top; width: 50%;}
+$if(quotes)$
+      q { quotes: "“" "”" "‘" "’"; }
+$endif$
+  </style>
+$if(highlighting-css)$
+  <style type="text/css">
+$highlighting-css$
+  </style>
+$endif$
+<link rel="stylesheet" href="/main.css" />
+$if(math)$
+  $math$
+$endif$
+$for(header-includes)$
+  $header-includes$
+$endfor$
+</head>
+<body>
+$for(include-before)$
+$include-before$
+$endfor$
+$if(title)$
+<header class="header header-wiki $if(color)$ header-$color$$endif$" id="title-block-header">
+<p style="white-space: pre-line" class="title">$title$</p>
+$if(subtitle)$<span style="font-size: 24px;" class="subtitle">$subtitle$</span>$endif$
+
+</header>
+$endif$
+<main>
+$if(toc)$
+<nav id="$idprefix$TOC">
+$table-of-contents$
+</nav>
+$endif$
+$body$
+$for(include-after)$
+$include-after$
+$endfor$
+<script>
+    function backAway(){
+        //if it was the first page
+        if(history.length === 1){
+            window.location = "http://southlondon.cc/"
+        } else {
+            history.back();
+        }
+    }
+</script>
+<hr class="zig">
+<hr class="zag">
+$if(author)$this article was lovingly written by $for(author)$$author$$endfor$$endif$
+$if(date)$ and was last updated $date$<br>$endif$
+<a href="#" onClick="backAway()">← go back</a>
+<br>
+<a href="/wiki">↜ back to wiki root</a>
+<br>
+<a href="/">↞ go to the homepage</a>
+</main>
+</body>
+</html>
--- a/wiki/img/puTTYmain.png
+++ b/wiki/img/puTTYmain.png
--- a/wiki/index.md
+++ b/wiki/index.md
@ -0,0 +1,10 @@
+---
+title: wiki
+subtitle: "tech tip: computer"
+color: blue
+---
+hi! welcome to the wiki. it contains some helpful info about living life on southlondon.cc. 
+
+### a table of contents
+- [logging in: a guide](./login.html)
+- [how to contribute to this wiki](./contribute.html)
--- a/wiki/login.md
+++ b/wiki/login.md
@ -0,0 +1,45 @@
+---
+title: logging in
+subtitle: "how to get into your account"
+author: cark
+date: 2021-03-09
+color: orange
+---
+this guide is split into three parts:
+
+- [Windows](#windows)
+- [MacOS + Linux](#macos-and-linux)
+- [Using the webterm](#using-the-webterm)
+
+# Windows
+there are many many ways to connect to an SSH server on Windows, here's a sample of some of them.
+### the fastest: via powershell
+the fastest way to get started on south london using Windows is via Powershell. the latest versions of Windows 10 include an `ssh` binary that you can use to connect to servers such as southlondon.cc.
+
+to connect, just open up a powershell window and type
+```powershell
+ssh <your username>@southlondon.cc -i <ssh private key path>
+```
+if you see a warning asking you to verify the fingerprint, just type 'yes' and it'll connect you up to the server. congrats! you're now connected to south london!
+
+### the unix-y-ist: cmder + git bash
+getting cmder is pretty easy, just head on down to [cmder.net]() and click 'Download Full'. the full download includes Git Bash, which emulates the bash command line inside windows. just unzip the folder and double click `Cmder.exe`.
+
+now just run this command to connect
+```bash
+ssh <your username>@southlondon.cc -i <ssh private key path>
+```
+congrats! you're in.
+
+# macOS and linux
+crack open a terminal and run
+
+```
+ssh <your username>@southlondon.cc
+```
+if your ssh key is in a nonstandard place, you'll also need to append `-i <ssh private key path>`.  
+good job! you're in.
+
+# using the webterm
+if you're having trouble getting set up, you can use the webterm to login.
+just click webterm on the homepage and type in your username and password.