From 02a0b396b499f0d645c1905b02b0686d939167b7 Mon Sep 17 00:00:00 2001 From: ahriman Date: Wed, 24 Apr 2019 23:59:58 +0000 Subject: removed old wiki --- wiki.php | 52 --------------------- wikipages/README.md | 23 --------- wikipages/bchs.wiki | 21 --------- wikipages/dcss.wiki | 46 ------------------ wikipages/finger.wiki | 42 ----------------- wikipages/gettingstartedcommands.wiki | 40 ---------------- wikipages/gopher.wiki | 74 ----------------------------- wikipages/gpg-for-ssh-auth.wiki | 28 ----------- wikipages/irc.wiki | 14 ------ wikipages/password-store.wiki | 88 ----------------------------------- wikipages/template.wiki | 19 -------- wikipages/unixprotips.wiki | 29 ------------ 12 files changed, 476 deletions(-) delete mode 100644 wiki.php delete mode 100644 wikipages/README.md delete mode 100644 wikipages/bchs.wiki delete mode 100644 wikipages/dcss.wiki delete mode 100644 wikipages/finger.wiki delete mode 100644 wikipages/gettingstartedcommands.wiki delete mode 100644 wikipages/gopher.wiki delete mode 100644 wikipages/gpg-for-ssh-auth.wiki delete mode 100644 wikipages/irc.wiki delete mode 100644 wikipages/password-store.wiki delete mode 100644 wikipages/template.wiki delete mode 100644 wikipages/unixprotips.wiki diff --git a/wiki.php b/wiki.php deleted file mode 100644 index 39d4a0e..0000000 --- a/wiki.php +++ /dev/null @@ -1,52 +0,0 @@ - - - - - - tilde.institute :: Wiki - - - - -
- - -
- - -

~institute wiki

-

Welcome to the tilde.institute wiki

- -

If you are new here, you likely want to check out the "getting started" page"

- -

If you know your way around and want to contribute to the wiki, check out the - repository and open a PR! -

- -

Pages:

-   BCHS Intro Guide
-   Dungeon Crawl Stone Soup
-   Finger
-   Getting Started With Gopher
-   GnuPG for SSH Authentication
-   IRC
-   password-store Usage Guide
-   UNIX ProTips
- -
-
- - diff --git a/wikipages/README.md b/wikipages/README.md deleted file mode 100644 index da9cf0b..0000000 --- a/wikipages/README.md +++ /dev/null @@ -1,23 +0,0 @@ -To contribute to the wiki, create a page using the same pattern as the previously existing pages and submit a pull request. - -Step-By-Step: - -Fork this repo - -git clone https://tildegit.org/your_username/site.git - -cd site - -git checkout -b my-wiki-page-etc - -cd wikipages - -Add your page following the same format as the existing pages - -git add . - -git commit -m "added page whatchamacalit to wiki" - -git push - -Then from the tildegit.org web interface, open a pull request to this repository from your fork/branch diff --git a/wikipages/bchs.wiki b/wikipages/bchs.wiki deleted file mode 100644 index de41703..0000000 --- a/wikipages/bchs.wiki +++ /dev/null @@ -1,21 +0,0 @@ - -

BCHS Guide

-

This will be a quick-and-dirty guide to getting started with the BCHS stack. More information can be found at:

- -

tilde.institute is set up to process all files with the .cgi extension via slowcgi(8). This allows for a multitude of possibilities - any compiled language can be used to develop web applications on an OpenBSD server. It's advised to use C because of the pledge(2) and unveil(2) system calls available, which allow for restricting privileges and restricted filesystem access, respectively.

-

Keep in mind that if you don't use the previously listed kcgi/ksql/kwebapp libraries, you will need to work with HTTP's eccentricities manually. For an example, here's the Hello World code from the LearnBCHS site. And here it is running as compiled CGI here at the Tilde Institute.

-

Once you've written your software to be served via CGI, be sure to statically link the executables. Sure, there's a larger file size, but the benefits outweigh that in this case - there's no relying on what I may or may not have installed on the Tilde Institute's server. For example:

-

$ cc -static -g -W -Wall -o app.cgi app.c

-

When you've completed compilation, make sure to set permissions properly (755) and move it to the public folder in your home directory. httpd(8) is set to use index as the index file, however this can be changed to index.cgi or what-have-you by contacting ahriman via IRC.

-

~institute user xvetrd has written a more detailed example on kcgi than is provided on the library's site. It includes an example makefile as well. The KCGI Starter archive is available here. Simply curl -O https://tilde.institute/kcgi-start.tar.gz it to your home directory here on ~institute, untar, make, and make install to test the compilation. It installs to ~/public_html with the proper ownership and permissions. View the index.c source and the makefile to see what goes on under the hood! Feel free to adapt it your own projects!

diff --git a/wikipages/dcss.wiki b/wikipages/dcss.wiki deleted file mode 100644 index 43c04a4..0000000 --- a/wikipages/dcss.wiki +++ /dev/null @@ -1,46 +0,0 @@ - - -

Dungeon Crawl Stone Soup

- -

DCSS is a fun roguelike game that is now available on a - tildeverse server for your enjoyment. There are two ways to - play: via WebTiles for simple 2d graphics and via SSH for - a more traditional ascii interface.

- -

CTVO: https://crawl.tildeverse.org

- -

If you already have an account on tilde.institute, you can - play via the ascii interface by issuing the command dcss. - This will automatically connect to the server and present the - login/registration menu.

- -

Some users prefer graphics. For webtiles, it will be necessary - to go to https://crawl.tildeverse.org. - Click "PLAY" to open the WebTiles interface.

- -

Recorded Games

- -

All games on CTVO (the tildeverse crawl server) are recorded for - later playback. In order to review a previously recorded game, - navigate to the ttyrec directory, - select a username, and download the ttyrec file. You'll need to - have the ttyrec package installed in order to review them. Issue: - ttyplay file.ttyrec and watch as your terminal - automagically transforms into a recorded DCSS game.

- -

ttyplay is installed on tilde.institute, so feel free to download - a game to your home directory and watch it from there.

- -

Morgue Files

- -

Want to see the run-down of a game? Check out the morgue file - for it. They're sorted into username directories at: - https://crawl.tildeverse.org/morgue. - Each morgue file contains information such as how you died, your stats, - an account of monsters vanquished, among other stuff.

- -Back to Wiki diff --git a/wikipages/finger.wiki b/wikipages/finger.wiki deleted file mode 100644 index f74b1e3..0000000 --- a/wikipages/finger.wiki +++ /dev/null @@ -1,42 +0,0 @@ - - -

finger

- -

the finger protocol was created way back in 1977. its purpose was to display information about the queried user of a system, or all the users of a system.

- -

it fell out of use in the 1990s due to various security concerns. the old finger daemons were buggy and easily exploited, while the information garnered from a query could be used for social engineering attacks. nowadays, the finger daemons have been refined and are no longer so vulnerable.

- -

in the post-facebook world, new types of social networks are popping up. the latest in this movement is a resurgence of the finger protocol. what follows is a rough guide for getting yourself up to speed with finger on tilde.institute.

- -

querying

- -

the standard query for finger is simply

- -

finger user@host

- -

which displays login name, home directory, shell, real name, current login time, idle time, whether or not the user has mail, and the contents of the user's ~/.plan file. Here is an example of the output:

- -
Login: username                          Name: Bob Bobson XXII
-Directory: /home/username                Shell: /bin/bash
-On since Wed Jan  2 04:04 (EST) on pts/94 from 168.297.83.21 via mosh [6420]
-    8 minutes 26 seconds idle
-Last login Wed Jan  2 04:33 (EST) on pts/91 from 168.297.83.21
-No mail.
-Plan:
-hey hey hey everybody!
- -

.plan

- -

The ~/.plan file displayed at the end of the finger query response allows for some customization. You can put literally any text you want there. Status updates, summaries, etc. This little file allows us to use finger as a rudimentary social network.

- -

For example, say you want to use it as a personal summary, like having a blurb about what you're working on. Place the statement into ~/.plan and you're ready to go!

- -

For a more traditional social network style format, put dated and timed status updates as if you're tooting on a mastodon instance. The sky's the limit! Well, actually, text is the limit. But you get the idea. Right?

- -

hope to see you on finger soon!

- -Back to Wiki diff --git a/wikipages/gettingstartedcommands.wiki b/wikipages/gettingstartedcommands.wiki deleted file mode 100644 index 10c79bb..0000000 --- a/wikipages/gettingstartedcommands.wiki +++ /dev/null @@ -1,40 +0,0 @@ - - -

Getting Started with ~.institute

- -

Hello and welcome to tilde.institute! We hope you enjoy your new ~/home

- -

Useful commands:

- -

The basic unix commands are fairly well documented, and you can learn more about them here: http://mally.stanford.edu/~sr/computing/basic-unix.html

-

For institute specific commands, check out below:

- - - -

Same fun games we have:

- - - -

Happy Unixing!

- -Back to Wiki diff --git a/wikipages/gopher.wiki b/wikipages/gopher.wiki deleted file mode 100644 index b265400..0000000 --- a/wikipages/gopher.wiki +++ /dev/null @@ -1,74 +0,0 @@ - - -

Getting Started With Gopher Using burrow

- -

To create a gopher hole on tilde.institute, a user can easily get started -by doing the following:

- -

1) Create the gopher directory

- -
$ mkdir public_gopher
- -

2) Create a root gophermap

- -
$ burrow gophermap
- -

Gophernicus will interpret any text you add here as information -lines unless they begin with one of gophernicus' special characters -or contains a tab. As a general rule, don't use tabs unless you're -intentionally linking something.

- -

Add a cool header to the file (check out figlet!), then somewhere near the top, paste:

- -
==== Last Updated: February 19th, 2019 ====
- -

The date doesn't matter, really. Whenever you "phlog" with burrow it will -update the date for you. How sweet is that?

- -

Now lets add a link to your phlog that you're totally going to have:

- -
1phlog[tab]phlog
- -

That [tab] should be a literal tab, though. Make sure your editor doesn't -convert it to spaces. Now, save and quit the editor.

- -

3) Create a phlog directory

- -
$ mkdir ~/public_gopher/phlog
- -

4) Now create a new phlog with burrow

- -
$ burrow phlog
- -

You'll be prompted for a title. If you hit enter and give no title then -burrow will abort.

- -

Once you hit enter after giving your title a temporary file will open in -your default $EDITOR. Don't like that editor? Be sure to change your -environment var!

- -

If you quit your phlog file without saving the post is aborted. If you -save and quit, it will create a new phlog entry, add it to your phlog -gophermap that now exists, and update the date on your root gophermap. -That's it!

- -

You have an RSS file sitting in the root of your gopher hole at rss.xml. -It will automatically generate when you phlog, like a winner. You can edit -your root gophermap at any time by using burrow's gophermap action. If you -create other folders and gophermaps in the future you can use burrow's -gophermap function to target them. For instance, to open the phlog -listings you would:

- -
$ burrow gophermap /phlog
- -

Editing gophermaps with burrow will ensure they're always saved and -formatted properly! Any other files are just text, so open them directly with your editor of -choice.

- -

That's it! Happy gophering.

- -

~tomasino

diff --git a/wikipages/gpg-for-ssh-auth.wiki b/wikipages/gpg-for-ssh-auth.wiki deleted file mode 100644 index b891ec9..0000000 --- a/wikipages/gpg-for-ssh-auth.wiki +++ /dev/null @@ -1,28 +0,0 @@ - - -

Using GPG for SSH Authentication

- -

It's a fairly simply process to have gpg-agent handle your SSH authentication. To start off, you'll need to have a private GnuPG key generated with an appropriate subkey for authentication. Once that's taken care of, open up ~/.gnupg/gpg-agent.conf

- -
$ cat ~/.gnupg/gpg-agent.conf
-enable-ssh-support
-default-cache-ttl 60
-max-cache-ttl 120
- -

Now you'll need to append the following to ~/.bashrc, or the appropriate rc file for your shell

- -
$ cat ~/.bashrc
-export GPG_TTY="$(tty)"
-export SSH_AUTH_SOCK=$(gpgconf --list-dirs agent-ssh-socket)
-gpg-connect-agent updatestartuptty /bye
- -

Once that's done, you'll need to let gpg-agent know which GnuPG subkey to use for SSH authentication. Run gpg --with-keygrip -k <email> and copy the keygrip associated with the subkey you've generated specifically for authentication only. Now, open ~/.gnupg/sshcontrol and paste the keygrip into that file. Verify that the correct keygrip has been selected by running ssh-add -L and comparing it against the output of gpg ---export-ssh-key <keyid>. If it's correct, kill off gpg-agent with killall gpg-agent, then open up a new terminal and attempt to connect to a server!

- -
- -Back to Wiki diff --git a/wikipages/irc.wiki b/wikipages/irc.wiki deleted file mode 100644 index 70ddbc3..0000000 --- a/wikipages/irc.wiki +++ /dev/null @@ -1,14 +0,0 @@ - - -

IRC

-

To connect to the tildeverse IRC network and begin chatting while logged on to tilde.institute, simply use the command chat! If you prefer to use a different IRC client than the default, such as irssi, the following server information will apply:

- -

Don't forget to /join #institute and /join #meta

-

Join us on the tildeverse IRC network and socialize with other tilde users!

-

tilde.institute is now peering with the larger tildeverse IRC network! Our specific node can be connected remotely via institute.tilde.chat, port 6697, with SSL enabled.

diff --git a/wikipages/password-store.wiki b/wikipages/password-store.wiki deleted file mode 100644 index c9de846..0000000 --- a/wikipages/password-store.wiki +++ /dev/null @@ -1,88 +0,0 @@ - - -

pass, cli password manager

- -

pass is a command line utility to manage your passwords.

-

-It creates a simple file/folder structure under your $PASSWORD_STORE_DIR (by default ~/.password-store) where every file is encrypted with your gpg key. -

- -

-You can organize that hierarchy as you see fit. For instance something like sites/tilde.news/myusername is a common way of doing it. -

- -

-Those files are not limited to contain simply a password, they can contain anything. But is recommended that the password goes alone in the first line, so you can benefit from the -c option which copies that to the clipboard directly. -

- -

-There is bash, zsh and fish command line completion available and all can be tracked using git. So it's really convenient. -

- -

setup

-

This is simple, just one command (assuming you have your GnuPG key ready). GPG-ID is the hex id of your key.

-
-$ pass init GPG-ID
-mkdir: created directory ‘/home/user/.password-store’
-Password store initialized for GPG-ID
-
- - -

basic usage

- -

-list all passwords "tree" style -

-
-$ pass
-Password Store
-├── sites
-│   ├── tilde.zone
-│   │   ├── myUserName
-│   │   ├── secondAccount
-...
-
-

find a password

-
-$ pass find tilde.zone
-Search Terms: tilde.zone
-└── sites
-    └── tilde.zone
-        └── myUserName@tilde.zone
-
-

See the content of a file

-
- $ pass email/tilde.institute/myAccount
- supersecret
-
-

Copy the first line to the clipboard. Clear time can be configured with $PASSWORD_STORE_CLIP_TIME

-
- $ pass -c email/tilde.institute/myAccount
- Copied email/tilde.institute/myAccount to clipboard. Will clear in 45 seconds.
-
-

Insert a new password. It can be multiline with -m. Remember to put the password on the first line if you want to use the clipboard function

-
- $ pass insert sites/foo.com/blah
- Enter password for sites/foo.com/blah:
-
-

Generate a 32 chars random password and store it. You can define the default length with $PASSWORD_STORE_GENERATED_LENGTH. With -n the password will not include symbols, but alphanumeric characters only. With -c it gets copied to the clipboard as usual.

-
- $ pass generate sites/foo.com/abcd 32
- The generated password to sites/foo.com/abcd is:
- $(-QF&Q=IN2nFBx)
-
- -

take a look at the --help option or the complete documentation on their website.

- -

-references: -

-

- -Back to Wiki diff --git a/wikipages/template.wiki b/wikipages/template.wiki deleted file mode 100644 index 1f8a0d3..0000000 --- a/wikipages/template.wiki +++ /dev/null @@ -1,19 +0,0 @@ - - -

Page Title

- -

paragraph content

- -inline filesystem paths, commands, etc - -
code blockquote
- - - -Back to Wiki diff --git a/wikipages/unixprotips.wiki b/wikipages/unixprotips.wiki deleted file mode 100644 index 6d9e9a0..0000000 --- a/wikipages/unixprotips.wiki +++ /dev/null @@ -1,29 +0,0 @@ - - -

UNIX ProTips

-

I realized today I wasn't getting mail notifications, and I hadn't -set them up on this shell. So here are some things I do on my -local machine that work here:

-

To get the shell to tell you when you have new mail, after command -executions, add this to your .profile

- -

export MAILCHECK=0

- -

And, if you want, you can have a persistent notification when you -have un-incorporated mail, or more specifically, when your -/var/mail/<username> isn't empty.

- -

PS1="\$([-s /var/mail/`whoami` ] && echo '* ')$PS1"

- -

This works in /bin/ksh, I can't speak for other shells.

- -

If anybody else has some quick tips they would like to share, I -encorage them to edit this page.

- -

Happy Unixing!

- -Back to Wiki -- cgit 1.4.1-2-gfad0