2020-06-09 19:40:04 +00:00
# tildetown-handbook
2020-06-09 20:06:22 +00:00
This handbook aims to provide people with referenceable, educational
material related to interactions with
[tilde.town ](https://tilde.town ).
2020-06-09 20:09:19 +00:00
This handbook is for people with less of a technical background who
want to learn more about the interactions you can have while using
tilde.town.
2020-06-09 20:06:22 +00:00
2021-02-25 00:24:15 +00:00
## Table of contents
2020-06-09 20:11:50 +00:00
- [Requirements ](#requirements )
2020-06-09 21:52:12 +00:00
- [Conventions used in this handbook ](#conventions-used-in-this-handbook )
- [Getting started ](#getting-started )
- [For macOS users ](#for-macos-users )
- [For Windows Subsystem for Linux users ](#for-windows-subsystem-for-linux-users )
- [For Ubuntu users ](#for-ubuntu-users )
- [For cmdr users ](#for-cmdr-users )
- [For PuTTY users ](#for-putty-users )
- [Testing out your command line interface ](#testing-out-your-command-line-interface )
2020-06-11 15:30:23 +00:00
- [Understanding UNIX-related concepts ](#understanding-unix-related-concepts )
- [Understanding your home directory ](#understanding-your-home-directory )
- [Understanding directory and file permissions ](#understanding-directory-and-file-permissions )
- [Understanding commands ](#understanding-commands )
- [Understanding package managers ](#understanding-package-managers )
2020-06-09 23:37:17 +00:00
- [Basic UNIX commands ](#basic-unix-commands )
2021-02-25 00:24:15 +00:00
## Requirements
2020-06-09 20:06:22 +00:00
* Basic understanding of files and directories
* A UNIX-like environment, such as:
* [Ubuntu ](https://ubuntu.com/ )
* [Linux Mint ](https://linuxmint.com/ )
* [Manjaro ](https://manjaro.org/ )
* [Windows Subsystem for Linux ](https://docs.microsoft.com/en-us/windows/wsl/install-win10 )
* [macOS ](https://www.apple.com/macos/ )
* [Homebrew ](https://brew.sh/ )
* [scoop.sh ](https://scoop.sh/ )
* [Chocolatey ](https://chocolatey.org/ )
* [cmdr ](https://cmder.net/ )
* [Cygwin ](https://www.cygwin.com/ )
* [PuTTY ](https://www.chiark.greenend.org.uk/~sgtatham/putty/ )
* [and many more ](https://distrowatch.com/ )
2020-06-09 20:32:53 +00:00
2021-02-25 00:24:15 +00:00
## Conventions used in this handbook
2020-06-09 20:32:53 +00:00
* **Notes** signify additional information.
2020-06-11 18:15:09 +00:00
* **Tips** signify alternative methods to procedures. * * *Examples** provide a visual reference of how a procedure would be carried out in the real world.
2020-06-09 20:32:53 +00:00
* **Monospaced font** signifies directory names, file names, file contents, and commands.
2021-02-25 00:24:15 +00:00
## Getting started
2020-06-09 20:32:53 +00:00
One of tilde.town's goals is to transform the command line from a
scary-looking technical tool into a tool for creating beautiful
things.
2020-06-09 23:15:41 +00:00
Because of this, you will need to open your UNIX-like environment's
2020-06-09 20:34:20 +00:00
command line interface. For me, it's a little icon on my desktop that
2020-06-09 23:15:41 +00:00
looks like a blank, black screen, but it may be different for you.
I will list off how you can find your command line interface for a few
UNIX-like environments in the sections listed below, and then we will
2020-06-09 23:16:10 +00:00
test the environment to make sure everything is working.
2020-06-09 23:15:41 +00:00
- [For macOS users ](#for-macos-users )
- [For Windows Subsystem for Linux users ](#for-windows-subsystem-for-linux-users )
- [For Ubuntu users ](#for-ubuntu-users )
- [For cmdr users ](#for-cmdr-users )
- [For PuTTY users ](#for-putty-users )
- [Testing out your command line interface ](#testing-out-your-command-line-interface )
2020-06-09 21:48:48 +00:00
2021-02-25 00:24:15 +00:00
### For macOS users
2020-06-09 21:52:12 +00:00
You can use one of the following procedures below for finding the
built-in app called "Terminal":
2020-06-09 21:48:48 +00:00
* Open the Spotlight app and search for the word "terminal"
* Open your `Applications > Utilities` directory and double-click the Terminal app
2021-02-25 00:24:15 +00:00
### For Windows Subsystem for Linux users
2020-06-09 21:52:12 +00:00
* Open your start menu and search for the word "Ubuntu"
2020-06-09 21:48:48 +00:00
**Note**: The steps above assumed you chose Ubuntu as the Linux
distribution for Windows Subsystem for Linux during your installation.
2021-02-25 00:24:15 +00:00
### For Ubuntu users
2020-06-09 21:52:12 +00:00
You can use one of the following procedures below for finding the
built-in terminal application:
2020-06-09 21:48:48 +00:00
* Type `Ctrl+Shift+t`
* Click the Ubuntu icon and search for the word "terminal"
2021-02-25 00:24:15 +00:00
### For cmdr users
2020-06-09 21:52:12 +00:00
* Open the cmdr application
2021-02-25 00:24:15 +00:00
### For PuTTY users
2020-06-09 21:52:12 +00:00
* PuTTY isn't a command line interface itself, but it acts as a tool
to connect to other computers, so you can use their command line
interface. This will be covered in the
[Connecting to tilde.town ](#connecting-to-tildetown ) section.
2020-06-09 21:48:48 +00:00
2021-02-25 00:24:15 +00:00
### Testing out your command line interface
2020-06-09 21:48:48 +00:00
After you think you have found your environment's command line
interface, you'll be using it in the rest of this handbook.
2020-06-09 20:35:03 +00:00
2020-06-09 21:56:27 +00:00
**Note**: I'll be calling the command line a "terminal" from now on.
2020-06-09 20:32:53 +00:00
As a test for good measure, let's try running our first command. Try
typing the following line into your terminal:
```
ls
```
2020-06-09 23:31:26 +00:00
That should "return" several items. For me, it returned:
2020-06-09 20:32:53 +00:00
```
Desktop Downloads Documents Images Videos Music
```
2020-06-09 21:52:12 +00:00
If `ls` returned what seems to be the files or directories on your
computer, then you have everything you need!
2020-06-09 20:32:53 +00:00
2020-09-25 21:30:39 +00:00
**Note**: "return" is technical jargon used to describe how something on a computer sends data
somewhere. In this case, the text representing your files and directories is the data, and that text
is being sent to your screen.
2020-06-09 23:34:39 +00:00
2021-02-25 00:24:15 +00:00
## Understanding UNIX-related concepts
2020-06-11 15:30:23 +00:00
2020-06-11 18:15:09 +00:00
This section will teach you the concepts required to follow further
sections in this handbook.
This section consists of the following subsections:
- [Understanding your home directory ](#understanding-your-home-directory )
- [Understanding directory and file permissions ](#understanding-directory-and-file-permissions )
- [Understanding commands ](#understanding-commands )
- [Understanding package managers ](#understanding-package-managers )
2021-02-25 00:24:15 +00:00
### Understanding your home directory
2020-06-11 15:30:23 +00:00
2021-02-25 00:24:15 +00:00
### Understanding directory and file permissions
2020-06-09 23:37:17 +00:00
2021-02-25 00:24:15 +00:00
### Understanding commands
2020-06-09 23:37:17 +00:00
2021-02-25 00:24:15 +00:00
### Understanding package managers
2020-06-09 23:37:17 +00:00
2021-02-25 00:24:15 +00:00
## Basic UNIX commands