safe scripting the tilde way
+ +authors:
+ + +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?
+-
+
- DOs
+
-
+
- Respect shared CPU/Disk/Network resources +
- Keep things that require a tilde.club login local to the server (don’t post publicly) :
+
-
+
- Finger info +
- local home directory files such as
~/.planand~/.profilefiles
+ - Note that exceptions could include an opt-in file or special permissions from the user. +
+ - Respect
robots.txtwhen writing web crawlers
+
+
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
+-
+
- In general
+
-
+
- Consider executing long running processes during overnight hours when fewer users are on the system +
+ - CPU
+
-
+
- Use the
nicecommand to keep intensive processes from affecting others +-
+
- The
nice -n19 -p$$placed in a script will make sure it runs at the lowest priority.
+ - Run a long command at the lowest CPU priority:
nice -n 19 ~/bin/command
+ - Change the priority of process 923 (also known as “re-nicing a process”) :
renice -17 -p923
+
+ - The
+ - Use the
- Disk
+
-
+
- On any commands that will heavily use disk, consider using the
ionicecommand so that scripts will not affect interactive users +-
+
- By adding the
ionice -c3 -p$$command to any script, it will only use disk when idle.
+ - You can also run a command or script:
ionice -c3 -t ~/bin/command
+
+ - By adding the
+ - On any commands that will heavily use disk, consider using the
setting up email
+ + +Your shiny, new tilde.club account comes with an email account you can use only between tilde.club members. pine is a command-line email application to use it, as is mutt. Good old-fashioned mail works too, although it’s a little cryptic.
pine 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.)
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 .
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.
Chatting
+ +authors:
+ + +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.
Editing your index.html file
+ +authors:
+ + +Type: nano index.html to open your index.html file and begin editing
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 new file mode 100644 index 0000000..e69395f --- /dev/null +++ b/wiki/email.html @@ -0,0 +1,34 @@ + + + + + + + +Setting up email
+ +authors:
+ + +Your shiny, new tilde.club account comes with an email account you can use between tilde.club members as well as internet email. 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: alpine 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.)
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