From 25e3ed375791d48d085b434beabac10f584f5540 Mon Sep 17 00:00:00 2001 From: Ben Harris Date: Sun, 22 Sep 2019 19:41:13 -0400 Subject: [PATCH] stop tracking html build artifacts, add header permalinks --- wiki/.gitignore | 1 + wiki/Editing-your-index.html-file.html | 38 --- wiki/Finding-your-index.html-file.html | 35 --- wiki/JSON.html | 33 --- ...your-editor-view-when-chat-interrupts.html | 32 --- wiki/Safe-Scripting-the-Tilde-Way.html | 83 ------- wiki/Time-zone.html | 32 --- wiki/Usenet-news.html | 35 --- wiki/VPN-Gate.html | 31 --- wiki/archive.org.html | 29 --- wiki/build-wiki.sh | 9 +- wiki/chat.html | 46 ---- wiki/code-of-conduct.html | 98 -------- wiki/edit_index.html | 41 ---- wiki/email.html | 44 ---- wiki/faq.html | 81 ------- wiki/finding_index.html | 35 --- wiki/git.html | 64 ----- wiki/header-permalinks.lua | 6 + wiki/leafnode.html | 30 --- wiki/netiquette.html | 44 ---- wiki/screen.html | 31 --- wiki/security.html | 134 ----------- wiki/slrn.html | 31 --- wiki/ssh.html | 221 ------------------ wiki/sshfs.html | 30 --- wiki/tin.html | 32 --- wiki/tmux.html | 47 ---- wiki/tunnelblick.html | 31 --- wiki/vimrc.html | 32 --- wiki/wiki.html | 40 ---- wiki/{pandoc-template.html => wiki.tmpl} | 0 32 files changed, 15 insertions(+), 1461 deletions(-) create mode 100644 wiki/.gitignore delete mode 100644 wiki/Editing-your-index.html-file.html delete mode 100644 wiki/Finding-your-index.html-file.html delete mode 100644 wiki/JSON.html delete mode 100644 wiki/Resetting-your-editor-view-when-chat-interrupts.html delete mode 100644 wiki/Safe-Scripting-the-Tilde-Way.html delete mode 100644 wiki/Time-zone.html delete mode 100644 wiki/Usenet-news.html delete mode 100644 wiki/VPN-Gate.html delete mode 100644 wiki/archive.org.html delete mode 100644 wiki/chat.html delete mode 100644 wiki/code-of-conduct.html delete mode 100644 wiki/edit_index.html delete mode 100644 wiki/email.html delete mode 100644 wiki/faq.html delete mode 100644 wiki/finding_index.html delete mode 100644 wiki/git.html create mode 100644 wiki/header-permalinks.lua delete mode 100644 wiki/leafnode.html delete mode 100644 wiki/netiquette.html delete mode 100644 wiki/screen.html delete mode 100644 wiki/security.html delete mode 100644 wiki/slrn.html delete mode 100644 wiki/ssh.html delete mode 100644 wiki/sshfs.html delete mode 100644 wiki/tin.html delete mode 100644 wiki/tmux.html delete mode 100644 wiki/tunnelblick.html delete mode 100644 wiki/vimrc.html delete mode 100644 wiki/wiki.html rename wiki/{pandoc-template.html => wiki.tmpl} (100%) diff --git a/wiki/.gitignore b/wiki/.gitignore new file mode 100644 index 0000000..2d19fc7 --- /dev/null +++ b/wiki/.gitignore @@ -0,0 +1 @@ +*.html diff --git a/wiki/Editing-your-index.html-file.html b/wiki/Editing-your-index.html-file.html deleted file mode 100644 index 1b5741d..0000000 --- a/wiki/Editing-your-index.html-file.html +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - - Editing your index.html file - - - - - - < back to wiki home -
-

Editing your index.html file

- - -
-

Type: nano index.html to open your index.html file and begin editing

-
-screenshot of the nano editor
screenshot of the nano editor
-
-

Edit your file, willy nilly

-

When done editing, use CTRL+X to close the file

-

You’ll be asked if you want to save; say y and [return] to return to the command line

-

Refresh your tilde page in your browser to see your new website

-

Note: If at any time you feel you made a mistake in editing, you can exit and n to not save.

-

There’s more info here about the [[nano]] editor; if you’re familiar with [[emacs]] or [[vim]] they are here too.

- - - diff --git a/wiki/Finding-your-index.html-file.html b/wiki/Finding-your-index.html-file.html deleted file mode 100644 index 8e20843..0000000 --- a/wiki/Finding-your-index.html-file.html +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - Finding your index.html file - - - - - - < back to wiki home -
-

Finding your index.html file

- - -
-

There are some basic command line commands you’ll want to Google and learn, but for this tutorial you only need a few:

-

ls = list files and folders in current directory

-

cd = change directories

-

vim, emacs, nano = a text editor

-

Type: ls to see where you are; you should see a directory called “public_html”

-

Type: cd public_html to browse into that folder

-

Type: ls to see where you are; you should see your index.html file

- - - diff --git a/wiki/JSON.html b/wiki/JSON.html deleted file mode 100644 index 67a924d..0000000 --- a/wiki/JSON.html +++ /dev/null @@ -1,33 +0,0 @@ - - - - - - - JSON - - - - - - < back to wiki home -
-

JSON

- - -
-

JSON is the “Javascript Object Notation”, basically a file format for data that’s suitable for easy processing by most modern web-based tools.

-

Several tilde.club programs expose APIs essentially by spitting out JSON as their output, including e.g. the list of recently updated home pages at

-

http://tilde.club/~delfuego/tilde.24h.json

-

If you’re looking to parse JSON from the command line with a minimum of code, the jq program may be your thing. jq is a filter that takes JSON on standard input and produces JSON on standard output. Along the way in the middle you can do various standard sorts of file munging on a field by field basis.

-

Documentation for jq is in its manual.

- - - diff --git a/wiki/Resetting-your-editor-view-when-chat-interrupts.html b/wiki/Resetting-your-editor-view-when-chat-interrupts.html deleted file mode 100644 index fe086cd..0000000 --- a/wiki/Resetting-your-editor-view-when-chat-interrupts.html +++ /dev/null @@ -1,32 +0,0 @@ - - - - - - - Resetting your editor view when chat interrupts - - - - - - < back to wiki home -
-

Resetting your editor view when chat interrupts

- - -
-

You may have been caught off guard while editing and had some random chat messages muss up your view. It didn’t actually edit your HTML page but you need to reset your editor view.

-

CTRL+L will reset your view

-

mesg n at the command prompt will turn off chat messages in that window.

-

If you don’t ever want to see wall messages on your screen, put mesg n into your startup file (details of how to do that needed here).

- - - diff --git a/wiki/Safe-Scripting-the-Tilde-Way.html b/wiki/Safe-Scripting-the-Tilde-Way.html deleted file mode 100644 index 5f88171..0000000 --- a/wiki/Safe-Scripting-the-Tilde-Way.html +++ /dev/null @@ -1,83 +0,0 @@ - - - - - - - - safe scripting the tilde way - - - - - - < back to wiki home -
-

safe scripting the tilde way

- -

authors:

-

~michaelcoyote

- -
-

Welcome to tilde.club. For many of you this may be your first multi-user host and for even more of you this may be your first host. Welcome to all of you.

-

Whether you are used to Unix, Linux and programming or a complete beginner please consider this an invitation to create and build new things.

-

It’s important when creating however that we respect the shared environment and that we respect the boundaries of others.

-

As Paul says:

-
-

no drama. be respectful. have fun.

-
-

What does that mean with respect to scripting and programming on a shared host?

- -

In short use your common sense and consider how your actions may affect others.

-

If you are unsure if something is a good idea or not, head to irc or message using the wall command and ask others what they think.

-

If you want a conclusive answer, contact one of the system operators.

-
Thinking privacy
-

Consider the source of the data.

-

E.g. We know that finger data might contain personal data such as phone numbers, and other identifying information and is not generally available without a tilde.club login.

-

Before exposing data such as this to the world, it should check for an opt in file such as the .public file file test before presenting info to the outside world.

-

Shared Resources

- - - - diff --git a/wiki/Time-zone.html b/wiki/Time-zone.html deleted file mode 100644 index ed90f06..0000000 --- a/wiki/Time-zone.html +++ /dev/null @@ -1,32 +0,0 @@ - - - - - - - time zones - - - - - - < back to wiki home -
-

time zones

- - -
-

The timezone by default on the server is UTC.

-

If you want to make it so that your shell prints out dates in localtime for you, run tzselect to find the correct timezone name that you’ll need to export as the TZ environment variable.

-

for example, if you’re in eastern time, add something like this export TZ="America/Detroit"

-

to your .bashrc .

- - - diff --git a/wiki/Usenet-news.html b/wiki/Usenet-news.html deleted file mode 100644 index e93fe77..0000000 --- a/wiki/Usenet-news.html +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - usenet news - - - - - - < back to wiki home -
-

usenet news

- - -
-

this is out of date and the netnews server is down

-

We’re working on it. You’ll need a news server to read news, and it’s up; it’s news.tilde.club.

-

[[slrn]] is a newsreader; see http://slrn.sourceforge.net/ for details.

-

[[pine]] can read news; this http://www.chebucto.ns.ca/Help/News/PineNews.html might help. You can also read the FAQ from U Washington.

-

In Pine do ‘S’ for setup, ‘C’ for config, then set ‘NNTP Server (for news)’ to news.tilde.club Then go back to the main menu, and pick Folder List, A for add, ^t for list

-

M-x gnus in [[emacs]] can read news, but you better know [[emacs]] first before you start.

-

[[lynx]] reads news, a la lynx news://news.tilde.club/tilde.general. It can even post news, but you have to design your own headers.

- - - diff --git a/wiki/VPN-Gate.html b/wiki/VPN-Gate.html deleted file mode 100644 index f3cd284..0000000 --- a/wiki/VPN-Gate.html +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - - VPN Gate - - - - - - < back to wiki home -
-

VPN Gate

- - -
-

VPN Gate is a project from U Tsukuba in Japan that allows you to evade censorship and filtering by setting up VPN tunnels. It was designed with the Great Firewall of China in mind.

-

http://www.vpngate.net/en/

-

You may need client side software to make this work; [[tunnelblick]] is one such service on the Mac.

- - - diff --git a/wiki/archive.org.html b/wiki/archive.org.html deleted file mode 100644 index af13eda..0000000 --- a/wiki/archive.org.html +++ /dev/null @@ -1,29 +0,0 @@ - - - - - - - archive.org - - - - - - < back to wiki home -
-

archive.org

- - -
-

archive.org has an archive of tilde.club at http://web.archive.org/web/*/http://tilde.club

- - - diff --git a/wiki/build-wiki.sh b/wiki/build-wiki.sh index d970269..3fb1efb 100755 --- a/wiki/build-wiki.sh +++ b/wiki/build-wiki.sh @@ -2,6 +2,13 @@ for page in source/*.md; do pagename=$(basename $page ".md") - pandoc --template pandoc-template.html -o "$pagename.html" "source/$pagename.md" + printf "building %s wiki article\n" "$pagename" + + pandoc \ + --template wiki.tmpl \ + --lua-filter header-permalinks.lua \ + -T "tilde.club wiki | " \ + -o "$pagename.html" \ + "source/$pagename.md" done diff --git a/wiki/chat.html b/wiki/chat.html deleted file mode 100644 index f8e358c..0000000 --- a/wiki/chat.html +++ /dev/null @@ -1,46 +0,0 @@ - - - - - - - - - Socializing and chat - - - - - - < back to wiki home -
-

Socializing and chat

- -

authors:

-

~emv

-

~benharri

- -
-

irc

-

run chat to open weechat auto-connected to our irc server.

-

other clients like irssi are available as well! just connect to localhost on port 6667 and /join #club.

-

feel free to use tilde.chat’s webchat too

-

mailing list

-

we now have an official mailing list!

-

if your account is old (pre sept 2019), you should be subscribed with the email you originally signed up with. if your account is newer (post sept 2019), then you should be subscribed with your @tilde.club address. if you don’t fit either of those categories, you can subscribe by visiting the web portal or by sending a mail to tildeclub-subscribe@lists.tildeverse.org with “subscribe” in the subject line. in either case, you can change the email you’re subscribed with on the web portal or by unsubscribing and re-subscribing from the other address.

-

list archives are available on the web here.

-

as of september 17, 2019, we’re still seeing quite a few pending mails to gmail, yahoo, and fastmail. help get our list delivered by making sure to mark list messages as not spam and adding the list address to your contacts. if you’re feeling especially motivated, please reach out to the support on your mail provider and ask them to look into why you’re not receiving the messages.

-

chat from the command line

-

Back on the command line, you may want to participate in chat. There is some great chat, likely, or you have questions.

-

Type: wall and [return] to tell Terminal you are ready to chat Type your message to the world and [return] CTRL+D to post or CTRL+C to change your mind and cancel Have fun!

-

If you’re tired of reading chats in a window, mesg n will turn it off, and mesg y will turn it back on again. And if you want to see more people, look for IRC.

- - - diff --git a/wiki/code-of-conduct.html b/wiki/code-of-conduct.html deleted file mode 100644 index 4b2ba08..0000000 --- a/wiki/code-of-conduct.html +++ /dev/null @@ -1,98 +0,0 @@ - - - - - - - - code of conduct - - - - - - < back to wiki home -
-

code of conduct

- -

authors:

-

~benharri

- -
-
-

tl;dr learn by doing and helping. be excellent to each other. have fun!

-
-

1. purpose

-

a primary goal of tilde.club is to be inclusive to the largest number of contributors, with the most varied and diverse backgrounds possible. as such, we are committed to providing a friendly, safe and welcoming environment for all.

-

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.club to help us create safe and positive experiences for everyone.

-

2. tilde.club mission

-

tilde.club exists to foster an engaged community for socializing, learning, and making cool stuff

-

in a mass-media age, it is up to small, intentional communities to gather and work together to provide a space outside of the advertising-laden, profit-seeking, corporate-owned world of social media.

-

to that end, tilde.club strives to be a radically inclusive community where people of all backgrounds and all technological experience levels can come together to learn, to teach, and to delight in one another’s creations.

-

3. expected behavior

-

the following behaviors are expected and requested of all community members:

- -

4. unacceptable behavior

-

the following behaviors are considered harassment and are unacceptable within our community:

- -

5. consequences of unacceptable behavior

-

unacceptable behavior from any community member, including sponsors and those with decision-making authority (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 community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from tilde.club without warning (meaning your account will be terminated and all user data deleted).

-

6. reporting guidelines

-

if you are subject to or witness unacceptable behavior, or have any other concerns, please contact an admin (see info below).

-

additionally, help engaging with law enforcement is available.

-

7. addressing grievances

-

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.

-

8. scope

-

we expect all tilde.club members to abide by this code of conduct while:

- -

9. contact info

-

tilde.club admins:

-

you can also send a mail to root@tilde.club to make sure we all get it.

- -

10. license and attribution

-

this code of conduct is based on citizencodeofconduct.org and tilde.town coc under the terms of the creative commons attribution-sharealike license.

- - - diff --git a/wiki/edit_index.html b/wiki/edit_index.html deleted file mode 100644 index df068c1..0000000 --- a/wiki/edit_index.html +++ /dev/null @@ -1,41 +0,0 @@ - - - - - - - - Editing your index.html file - - - - - - < back to wiki home -
-

Editing your index.html file

- -

authors:

-

~vielmetti

- -
-

Type: nano index.html to open your index.html file and begin editing

-
-screenshot of the nano editor
screenshot of the nano editor
-
-

Edit your file, willy nilly

-

When done editing, use CTRL+X to close the file

-

You’ll be asked if you want to save; say y and [return] to return to the command line

-

Refresh your tilde page in your browser to see your new website

-

Note: If at any time you feel you made a mistake in editing, you can exit and n to not save.

-

There’s more info here about the nano editor; if you’re familiar with emacs or vim they are here too.

- - - diff --git a/wiki/email.html b/wiki/email.html deleted file mode 100644 index da33019..0000000 --- a/wiki/email.html +++ /dev/null @@ -1,44 +0,0 @@ - - - - - - - - email - - - - - - < back to wiki home -
-

email

- -

authors:

-

~benharri

- -
-

Your shiny, new tilde.club account comes with an email account. alpine is a command-line email application to use it, as is mutt. Good old-fashioned mail works too, although it’s a little cryptic.

-

alpine is menu driven, and the menus are self-explanatory; it’s surprisingly easy to learn, and surprisingly powerful when you want to customize it.

-

From the command line (after logged in via SSH), type: pine and [return] Follow instructions and use the menus at the bottom and top. (Note: When you see the ^ in front of the letter it means you need to use CTRL, otherwise just use the letter.)

-

non-cli options

-

alternatively, you can use the webmail or standard imap/smtp.

-

some clients will automatically detect the right settings (tested with thunderbird).

-

connection settings: - imap.tilde.club port 993 with ssl - pop3.tilde.club port 995 with ssl - smtp.tilde.club port 587 with starttls

-

if you’d like your @tilde.club mail forwarded elsewhere, you can put an email address in a file called ~/.forward

-

sieve filtering

-

our dovecot configuration supports sieve and managesieve.

-

this means that you should put your scripts in a ~/sieve/ directory, symlink the active script to ~/.dovecot.sieve, and make sure to compile it with sievec ~/.dovecot.sieve.

-

you can find some example sieve scripts here.

-

alternately, you can use webmail’s filter settings to configure your filters.

- - - diff --git a/wiki/faq.html b/wiki/faq.html deleted file mode 100644 index 4e80023..0000000 --- a/wiki/faq.html +++ /dev/null @@ -1,81 +0,0 @@ - - - - - - - - faq - - - - - - < back to wiki home -
-

faq

- -

authors:

-

~ford

- -
- 
  _______________________________________
- / WELCOME TO TILDE.CLUB A place for web \
- \ pages                                 /
-  ---------------------------------------
-    \   ^__^
-     \  (oo)\_______
-        (__)\       )\/\
-            ||----w |
-            ||     ||
-

Looking to join? We can't wait to meet you!

-

Sign-ups will be re-launching on September 20th, 2019. Can’t wait to meet you all!

-

Several alternate sites have sprouted up

-

How did this accidentally awesome thing get started?

-

Paul wrote an explanation on Medium and you can follow along with his thinking on his tilde blog.

-

I'm on Tilde, now what?

-

Tilde has a great community culture and we're trying hard to keep it that way. We're working on some netiquette outlines for people who are new to all of this. In the meantime...

- -

Got it, don't be a jerk. But how do I, like, do things?

-

Here are some good places to start

- -

Who are all these folks and what are they up to?

- - - -

How do you pronounce "tilde"?

-

Tilde the word is pronounced TIL-duh. Tilde the community is pronounced TIL-dee.

-

We can't wait to meet you. Seriously.

-
     __         .' '.
-   _/__)        .   .       .
-  (8|)_}}- .      .        .
-   `\__)    '. . ' ' .  . '
- - - diff --git a/wiki/finding_index.html b/wiki/finding_index.html deleted file mode 100644 index 6d1152d..0000000 --- a/wiki/finding_index.html +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - finding your index.html - - - - - - < back to wiki home -
-

finding your index.html

- - -
-

There are some basic command line commands you’ll want to Google and learn, but for this tutorial you only need a few:

-

ls = list files and folders in current directory

-

cd = change directories

-

vim, emacs, nano = a text editor

-

Type: ls to see where you are; you should see a directory called “public_html”

-

Type: cd public_html to browse into that folder

-

Type: ls to see where you are; you should see your index.html file

- - - diff --git a/wiki/git.html b/wiki/git.html deleted file mode 100644 index 5f7a982..0000000 --- a/wiki/git.html +++ /dev/null @@ -1,64 +0,0 @@ - - - - - - - git usage - - - - - - < back to wiki home -
-

git usage

- - -
-

git is a version control system. It’s pretty confusing at first, but once you sort out what it can do and can’t do, it starts to get better.

-

This tutorial is pretty good: http://git-scm.com/docs/gittutorial

-

The best way to learn git is to find someone who knows git really well and sort out issues with them. Ask on [[IRC]] if you get stuck. (There should be a better buddy system for this, but until there is, we do what we can.)

-

A good introduction to git is to create a repository for your public_html directory. This will allow you to back up your public web directory.

-

First thing you will want to do is set up git.

-

If you don’t have a GitHub account, you will want one for this exercise. If you choose another Git host, you will need to work out some parts of this setup on your own.

-

Once you have a git account, you will want to set up git for your tilde.club account. Use the email address that you used to create your GitHub account. You can register multiple accounts with GitHub if needed.

-
git config --global user.name "Your Name Here"
-git config --global user.email youremail@example.org
-

You will also want to create a .gitignore file. This file defines what things you want git to ignore, such as editor temporary files or directories you may not want to keep in git such as generated files or private files you upload to a public repository. The .gitignore file can be created in your home directory, but I like to create it in the project directory.

-

Here is an example .gitignore file:

-
# files being edited
-*~
-*swp
-# Generated files
-tilde_graphs
-# Private files
-diary.txt
-

Now go create a repository on GitHub. In our examples we are using mytildeweb as the repo name, but you can choose whatever name works for you. If you do change the repository name be sure to update the commands with the proper one.

-

Now we should be ready to create and upload the repository.

-
cd public_html/
-# This will initialize public_html as a repository
-git init
-# Adds all files to the repo. "." means "the current directory" (public_html, in this case)
-# Note: you can also add files one at a time
-git add .
-# Commits files to local repo
-git commit -m "first commit of tildeweb"
-# Tells git where your remote repo is
-git remote add origin https://github.com/<yourgithubuser>/mytildeweb.git
-# Uploads to the remote repo
-git push -u origin master
-

Your files should now be on GitHub. If you make a change and you want to update, do the following after making your edits:

-
git add index.html
-git commit -m "updated blog"
-git push origin master
- - - diff --git a/wiki/header-permalinks.lua b/wiki/header-permalinks.lua new file mode 100644 index 0000000..f4b08db --- /dev/null +++ b/wiki/header-permalinks.lua @@ -0,0 +1,6 @@ +function Header(elem) + table.insert(elem.content, pandoc.Space()) + table.insert(elem.content, pandoc.Link("🔗", "#" .. elem.identifier)) + return elem +end + diff --git a/wiki/leafnode.html b/wiki/leafnode.html deleted file mode 100644 index b960b34..0000000 --- a/wiki/leafnode.html +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - Leafnode - - - - - - < back to wiki home -
-

Leafnode

- - -
-

leafnode is a news client suitable for “leaf” nodes, that is nodes that have no downstream feeds.

-

http://leafnode.sourceforge.net/

- - - diff --git a/wiki/netiquette.html b/wiki/netiquette.html deleted file mode 100644 index 7bfa228..0000000 --- a/wiki/netiquette.html +++ /dev/null @@ -1,44 +0,0 @@ - - - - - - - tilde.club netiquette - - - - - - < back to wiki home -
-

tilde.club netiquette

- - -
-

Two phrases we use a lot

- -

Details

-

First things first, explore and have fun! But remember, this is a single linux server trying to support the weight of several hundred nerds. Don’t host servers, don’t run heavy processes, don’t host giant files. In short, be gentle.

-

More about scripting netiquette here

-

Now let’s talk about drama. There is a Mary J. Blige song called “No More Drama.” If Mary J. Blige would think it was drama, it is drama. No flamewars about emacs/vi, no matter how historically accurate they may be. No guilting people, shaming them, or making them feel bad. More benefit of the doubt and less “are you kidding me?”

-

~ford’s SACRED VOWS to the community

-

I will do my best to do the following things:

-
    -

  1. I will make a weekly backup of the public_html directories so when some teen in Estonia decides to hack in and ruin everything we can bring up a new server and limp back to life.

    2. -

  2. I won’t shut things down without a month of warning and once it’s shut down I’ll make sure a file with all the public_html directories is uploaded to archive.org.

    3. -

  3. If any community forms at all (DUBIOUS BUT SURPRISE ME) I promise I won’t blow up the community without, like, first pointing everyone to some free IRC channel or something.

    4. -
- - - diff --git a/wiki/screen.html b/wiki/screen.html deleted file mode 100644 index f489fd9..0000000 --- a/wiki/screen.html +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - - terminal multiplexers - - - - - - < back to wiki home -
-

terminal multiplexers

- - -
-

screen is a unix utility that lets you manage multiple shells from within a single window. You switch between them with a few keystrokes. When you disconnect it keeps the processes alive, and you can reconnect from another login.

-

It’s pretty handy. [[tmux]] does a similar set of things.

-

a nice screen tutorial from ~jonathan will walk you through it.

- - - diff --git a/wiki/security.html b/wiki/security.html deleted file mode 100644 index a5edb3a..0000000 --- a/wiki/security.html +++ /dev/null @@ -1,134 +0,0 @@ - - - - - - - - Editing Basic UNIX Security the Tilde way - - - - - - < back to wiki home -
-

Editing Basic UNIX Security the Tilde way

- -

authors:

-

~michaelcoyote

- -
-
-

“Unix is public by default. This means that other people who use the server can see your files. You can change that on a file-by-file basis. You can also change the default behavior for you. It is totally okay to keep your stuff private. Let us show you how.”

-
-

Unix was built with a fairly open security policy. It’s the kind of system you might expect a bunch of Berkley hippies to design. That said, if it bugs you that someone might be able to look the files in your home directory and you don’t want to read any more of this document then run these commands:

-
cd ~
-chmod 711 .
-

Those will keep anyone on the system from looking at your directory while still allowing your ~youruser site to work. If you want to have more control over who can view what in your directory, then please read on. You can even come back and read this later, we’ll be here.

-

Users and Groups

-

What is a user? For starters, you are a user and so is every other person on the system. Sometimes special user accounts are used for running specific processes (such as the web server) or for handling special administrative tasks.

-

There are several attributes that define a user.

- -

For now we only need to know about the username.

-

Welcome to tilde.club, your new home (and homedir)

-

When you registered for the system, you got an email that contained many things. One of those things was a username, and another was a password. When you logged into the server you were presented with what we call a prompt, and it looked a bit like this:

-
sh-4.1$
-

That’s boring so type the command ls -l public_html/index.html

-
sh-4.1$ ls -l public_html/index.html
-rw-rw-r-- 1 youruser youruser 177 Oct 13 04:51 public_html/index.html
-

You’ll notice that your login shows up, but what does this actually show us?

-

First of all ls is a command to list files and directories. We’ve given it the command line switch -l that tells the ls command that we want a long listing of the file or directory attributes, and finally we’ve given it the filename my_file so that we can see its file attributes.

-

What does this long file listing of my_file show us?

-
-rw-rw-r--  1  youruser  youruser   177   Oct 13 04:51    my_file
----------- --- -------   --------  -----  ------------ -------------
-    |       |     |        |         |         |             |
-    |       |     |        |         |         |         File Name
-    |       |     |        |         |         +---  Modification Time
-    |       |     |        |         +-------------   Size (in bytes)
-    |       |     |        +-----------------------     Group owner
-    |       |     +--------------------------------      User owner
-    |       +--------------------------------------    Number of links
-    +----------------------------------------------   File Permissions
-

This seems like a lot to take in, but for the purpose of talking about files and security, we’ll only need three things: the file permissions, the group owner and the user owner.

- -

Basics about file and directory permissions

-
-rwxrwxrwx
-----------
-| |  |  |
-| |  |  +--- Other Read/Write/Execute permissions
-| |  +------ Group Read/Write/Execute permissions  
-| +--------- User Read/Write/Execute permissions
-+----------- Directory/Special flag
-

The first column at first glance looks like a bunch of alphabet soup, however if you look over a few of them, a pattern begins to emerge. Some lines begin with d and there are repeating instances of r, w and x. You might notice that the lines beginning with d refer to directories and that many files have rw- at the start of the column and r-- or even --- at the end of the column. These are important and indicate to the computer and to users how that file can be accessed.

-

Types of permissions

-

There are three major types of permissions (and a hand full of others) - Read Read permission is represented as an r and will allow a listing of a directory and reading a file. - Write Write permission is represented with a w and allows a file or directory to be written to or deleted. - Execute Execute permission is represented as an x and allows a file (such as a script) to be executed and it allows for a directory to be “traversed”

- -

Three classes of access permissions

- -

Changing file and directory permissions using chmod

-

Examples

- -

Basics about the finger and chfn commands

-

How to see others in the system using finger

-
Type the command `finger`
-
-Type the command `finger $USER`
-

How others see you.

-

Changing the information people see about you using chfn

-

creating a ~/.plan and ~/.project file that’s readable

-

More advanced topics

-

Let’s look at the /etc/passwd file. What is it? It’s a file that contains most of the information about users in the system.

- -

Back at our command line, lets type the command id:

-
sh-4.1$ id
-uid=501(youruser) gid=501(youruser) groups=501(youruser)`
-

The id command is a tool to show us how the system keeps track of us. From this we can see that according to the system, our user ID (or uid) is 501, and our group id is also 501.

-
- Homework
-    - Run `id` in your own directory, then run
-    - Run `id -u root`
-    - use the `grep` command to find your uid in the `/etc/passwd` file
- - - diff --git a/wiki/slrn.html b/wiki/slrn.html deleted file mode 100644 index d7b9436..0000000 --- a/wiki/slrn.html +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - - slrn - - - - - - < back to wiki home -
-

slrn

- - -
-

slrn is a news reader for [[Usenet]].

-

Documentation for slrn can be found at http://slrn.sourceforge.net

-

Tilde-specific slrn info is on http://tilde.club/~joeld/slrn.html

- - - diff --git a/wiki/ssh.html b/wiki/ssh.html deleted file mode 100644 index ca561cb..0000000 --- a/wiki/ssh.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - - ssh - - - - - - - < back to wiki home -
-

ssh

- -

authors:

-

~benharri

- -
-

or, how to tell other computers to do cool things

-
-
-

all users are required to use an ssh keypair for login, or will be required to proceed with manual account recovery

-
-

tilde.club details

-

for example, to connect to tilde.club, you can do:

-
ssh user@tilde.club
-mosh user@tilde.club
-
-

intro

-

** if you just want to get right to a tutorial you can skip over this background info**

-

while tilde.club is accessible on the web and features lovely web pages written by its users, most interaction with tilde.club takes place inside the machine that runs tilde.club as opposed to via web forms that have an effect from outside tilde.club’s computer.

-

this is what sets tilde.club 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.club’s computer.

-

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.

-

for a long time, people used a tool called telnet to connect to other computers. these days we use a tool called ssh.

-

ssh 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 shell 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 secure part refers to the fact that, when you’re using ssh, no one can spy on your connection to another computer (unlike the old telnet command).

-

why bother with all of this? 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).

-
-

how to make an ssh key

-

SSH supports a handful of types of cryptographic keys. The most used are RSA and the more modern Ed25519.

-

RSA is the de-facto standard and is supported everywhere (just choose a big enough key like 4096 bits to be secure). Ed25519 is designed to be faster and smaller withouth sacrificing security, so is best suited for embedded devices or machines with low resources. It’s supported on tilde (and really on any modern system) but you may find older systems which do not support it.

-

Below you’ll find instructions to generate either type (or both if you want).

-

Keep in mind that these instructions leave your private keys unencrypted in your local hard disk. So keep them private; never share them. A good solution is to provide a password for them at creation time, but this implies entering a password any time you used them (impractical) or use something like ssh-agent (a bit more complex)

-

pick your fighter: [mac] | [windows] | [linux]

-
-

mac

-

generating your keypair

-
    -

  1. open terminal (it’s in /Applications/Utilities)

    2. -

  2. create your .ssh directory:

    3. -
-
mkdir -m 700 ~/.ssh
-
    -
  1. create your keys:
    2. -
-

for rsa keys:

-
ssh-keygen -t rsa -b 4096
-

for dd25519 keys:

-
ssh-keygen -t ed25519 -a 100
-
    -

  1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

    2. -

  2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

    3. -

  3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to ~root if you already have an account)

    4. -
-

using your keypair

-

once an admin approves your signup, you can join the tilde.club

-
    -

  1. open terminal (it’s in /Applications/Utilities)

    2. -

  2. ssh to tilde.club:

    3. -
-
ssh username@tilde.club
-

where username is your username (~benharri would use ssh benharri@tilde.club)

-
    -
  1. profit???
    2. -
-
-

windows

-

there are a couple options for using ssh on windows these days. i like to use git bash.

-

generating your keypair

-

choose from any of the following options:

- -
    -

  1. open your new shell

    2. -

  2. create your .ssh directory

    3. -
-
mkdir .ssh
-
    -
  1. create your keypair
    2. -
-

for rsa keys:

-
ssh-keygen -t rsa -b 4096
-

for ed25519 keys:

-
ssh-keygen -t ed25519 -a 100
-
    -

  1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

    2. -

  2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

    3. -

  3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to ~root if you already have an account)

    4. -
-

using your keypair

-

once an admin approves your signup, you can join the tilde.club

-
    -

  1. open terminal (it’s in /Applications/Utilities)

    2. -

  2. ssh to tilde.club:

    3. -
-
ssh username@tilde.club
-

where username is your username (~benharri would use ssh benharri@tilde.club)

-
    -
  1. profit???
    2. -
-
-

linux

-

there are a lot of linux distros, but ssh and ssh-keygen should be available in almost all cases. if they’re not, look up how to install ssh for your distro.

-

generating your keypair

-
    -
  1. make sure you have a ~/.ssh directory
    2. -
-
mkdir -m 700 ~/.ssh
-
    -
  1. create your keys
    2. -
-

for rsa keys:

-
ssh-keygen -t rsa -b 4096
-

for ed25519 keys:

-
ssh-keygen -t ed25519 -a 100
-
    -

  1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

    2. -

  2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

    3. -

  3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to root@tilde.club if you already have an account)

    4. -
-

using your keypair

-

once an admin approves your signup, you can join the tilde.club

-
    -

  1. open a terminal (this depends on your distro)

    2. -

  2. ssh to tilde.club:

    3. -
-
ssh username@tilde.club
-

where username is your username (~benharri would use ssh benharri@tilde.club)

-
    -
  1. profit???
    2. -
-
-

this tutorial is based on and uses parts of the tilde.club ssh primer and the tilde.town ssh guide.

- - - diff --git a/wiki/sshfs.html b/wiki/sshfs.html deleted file mode 100644 index a9ef3e8..0000000 --- a/wiki/sshfs.html +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - SSHFS - - - - - - < back to wiki home -
-

SSHFS

- - -
-

With sshfs you can mount your tilde directory as a drive.

-

See http://tilde.club/~jeffbonhag/sshfs.txt for a tutorial.

- - - diff --git a/wiki/tin.html b/wiki/tin.html deleted file mode 100644 index 9b60f68..0000000 --- a/wiki/tin.html +++ /dev/null @@ -1,32 +0,0 @@ - - - - - - - tin - - - - - - < back to wiki home -
-

tin

- - -
-

tin is a threaded NNTP and spool based UseNet newsreader for a variety of platforms.

-

http://www.tin.org/

-

it’s under active development, with a last release on October 3, 2014. It is installed on tilde.club, and should be invoked as tin -r to read from the remote news spool. Use to go to the next unread article and w to write a new article.

-

if you have tin on your local box and can do [[ssh port forwarding]], you can read news using it. (details forthcoming).

- - - diff --git a/wiki/tmux.html b/wiki/tmux.html deleted file mode 100644 index a1952df..0000000 --- a/wiki/tmux.html +++ /dev/null @@ -1,47 +0,0 @@ - - - - - - - tmux - - - - - - < back to wiki home -
-

tmux

- - -
-

TMUX IS THE BEST. Here’s a super basic primer.

-

to start a new session, type tmux new -s tildemux.

-

A yellow bar will appear at the bottom of your terminal. You’re now in TMUX!

-

TMUX has sessions, windows, and panes. Each of these things will have a terminal in it. If you actually typed what I told you to earlier, you’ll be in a session named tildemux. That session has one window, 0. That window has one pane, also named 0. (Computers start counting at 0, not 1.)

-

windows

-

Your tmux bar should look like:

-

[tildemux] 0:bash*

-

…which means that you’re in a session named tildemux, which has a window 0, running the command bash. * means that window 0 is active, and the pane running bash is currently active.

-

To create a new window within this session, type PREFIX c. PREFIX?!? By default, it’s control-b. Now you should see:

-

[tildemux] 0:bash- 1:bash*

-

1:bash* means you’re in a pane running bash inside window 1. To change back to pane 0, type PREFIX 0. The * should be back on 0:bash.

-

Run a cool interactive command, such as htop (to see how many of system resources we’re eating up) or vim (to write some awesome webpages). Your tmux status bar should update to 0:<name of the current process>. So now instead of saying bash it will say htop or vim.

-

panes

-

Panes are great. TMUX panes let you run more than one terminal inside your one, actual terminal. To “split” a new pane, PREFIX ". That makes a horizontal split. You’ll notice there are now two panes open one on top of the other. PREFIX % makes a vertical split, for side-by-side panes. Did I mention that panes are great?

-

To move between panes in the current window, use PREFIX <up,down,left,right>. That’s right, the arrow keys.

-

more

-

I not the best writer or teacher. Just google anything that doesn’t make sense.

-

Or take a look at this tmux guide

-

But definitely use tmux.

- - - diff --git a/wiki/tunnelblick.html b/wiki/tunnelblick.html deleted file mode 100644 index ca82e82..0000000 --- a/wiki/tunnelblick.html +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - - Tunnelblick - - - - - - < back to wiki home -
-

Tunnelblick

- - -
-

tunnelblick is an application for your Mac that allows you to configure and manage VPN sessions. You can use this e.g. if you are connecting to tilde.club via a network that does not allow high UDP ports; with a properly configured tunnel, you can still run [[mosh]] as your shell and keep on truckin.

-

https://code.google.com/p/tunnelblick/

-

To find a VPN endpoint, see the [[VPN Gate]] project.

- - - diff --git a/wiki/vimrc.html b/wiki/vimrc.html deleted file mode 100644 index bc5a872..0000000 --- a/wiki/vimrc.html +++ /dev/null @@ -1,32 +0,0 @@ - - - - - - - .vimrc file - - - - - - < back to wiki home -
-

.vimrc file

- - -
-

The file .vimrc in your home directory has instructions for [[vim]] to load every time it runs. Customizations go there.

-

For instance, you might want to use [[Markdown]] to edit files that end in .md. The system default for some reason is to treat these as [[Modula-2]] files, though we don’t have a Modula-2 compiler running (yet). So the contents of .vimrc should read

-

au BufRead,BufNewFile *.md set filetype=markdown

-

For more suggestions in deep depth on how to set up your .vimrc please read this tutorial from Doug Black.

- - - diff --git a/wiki/wiki.html b/wiki/wiki.html deleted file mode 100644 index 5a554d2..0000000 --- a/wiki/wiki.html +++ /dev/null @@ -1,40 +0,0 @@ - - - - - - - - how to contribute to this wiki - - - - - - < back to wiki home -
-

how to contribute to this wiki

- -

authors:

-

~benharri

- -
-
    -

  1. grab a copy of the site’s source code

    -

    git clone https://github.com/tildeclub/site tilde.club && cd tilde.club/wiki

    2. -

  2. make a new article or update an existing one (only change the markdown source)

    3. -

  3. generate the wiki pages. you need to be in the wiki directory. run ./build-wiki.sh to create the html.

    4. -

  4. submit the code via a PR on github or with git-send-email(1) to root@tilde.chat see git-send-email.io for more info on how to use it. if you’re working locally on tilde.club, you won’t have to configure anything; git will use the system’s sendmail to handle the email.

    5. -

  5. profit???

    6. -
-

ask on irc if you have questions!

- - - diff --git a/wiki/pandoc-template.html b/wiki/wiki.tmpl similarity index 100% rename from wiki/pandoc-template.html rename to wiki/wiki.tmpl