diff options
-rw-r--r-- | assets/wiki.md | 8 | ||||
-rw-r--r-- | pages/gcc.md | 43 | ||||
-rw-r--r-- | pages/gcc8.md | 31 | ||||
-rw-r--r-- | pages/irc.md | 26 | ||||
-rw-r--r-- | pages/jdk.md | 2 | ||||
-rw-r--r-- | pages/remote-mail.md | 48 | ||||
-rw-r--r-- | pages/todo.md | 66 | ||||
-rw-r--r-- | pages/unixtips.md | 6 | ||||
-rw-r--r-- | pages/user-repos.md | 16 |
9 files changed, 201 insertions, 45 deletions
diff --git a/assets/wiki.md b/assets/wiki.md index 6aac1de..9274f83 100644 --- a/assets/wiki.md +++ b/assets/wiki.md @@ -2,9 +2,13 @@ Welcome to the [tilde.institute](https://tilde.institute) wiki! -If you are new here, you may want to check out the [IRC](/w/irc) page. Or, if you know your way around and want to contribute to the wiki, open a PR! +If you are new here, you may want to check out the [IRC](/w/irc) page. Or, if you know your way around and want to contribute to the wiki, mail a patch to `admins@tilde.institute` or open a PR! -Repository: [git.tilde.institute/tilde/wiki](https://git.tilde.institute/tilde/wiki) +Repositories: + + * [git.tilde.institute/tilde/wiki](https://git.tilde.institute/tilde/wiki) + * [tildegit.org/institute/wiki](https://tildegit.org/institute/wiki) + * [github.com/tildeinstitute/wiki](https://github.com/tildeinstitute/wiki) ### Pages diff --git a/pages/gcc.md b/pages/gcc.md new file mode 100644 index 0000000..5b9f229 --- /dev/null +++ b/pages/gcc.md @@ -0,0 +1,43 @@ +<!-- +title: gcc and GNUstep +description: Information on using recent gcc versions +author: gbmor +--> + +# gcc + +OpenBSD includes `gcc4` in the base install, which is `gcc-4.2.1`. +If you prefer to use `gcc-11.2.0`, the names of the binaries differ. + +The following are part of `gcc-11.2.0`: + +* `/usr/local/bin/egcc` +* `/usr/local/bin/gcc` (symlink) +* `/usr/local/bin/eg++` +* `/usr/local/bin/g++` (symlink) +* `/usr/local/bin/egdb` +* `/usr/local/bin/gdb` (symlink) +* `/usr/local/bin/egfortran` +* `/usr/local/bin/gfortran` (symlink) +* `/usr/local/bin/gnat` + +The following are part of `gcc-4.2.1` + +* `/usr/bin/gcc4` +* `/usr/bin/g++4` +* `/usr/bin/gdb` + +`GNUstep` is available if you would like to develop using Objective-C. The +following should be added to `~/.kshrc`: + +``` +export GNUSTEP_MAKEFILES=/usr/local/share/GNUstep/Makefiles +. /usr/local/share/GNUstep/Makefiles/GNUstep.sh +``` + +You will also need to call `gmake` rather than `make` when building Objective-C +code. See [this StackOverflow post](https://stackoverflow.com/questions/14441852/how-to-build-gnustep-programs-on-openbsd) +for more information. + +[back](/) + diff --git a/pages/gcc8.md b/pages/gcc8.md deleted file mode 100644 index 6accfe1..0000000 --- a/pages/gcc8.md +++ /dev/null @@ -1,31 +0,0 @@ -<!-- -title: gcc-8 -description: Information on using gcc-8 -author: gbmor ---> - -# gcc-8 - -OpenBSD includes `gcc` in the base install. However, it includes `gcc-4.2.1`. -If you prefer to use `gcc-8.3.0`, the names of the binaries differ so as to not -conflict with `gcc` in base. - -* `egcc` - gcc -* `eg++` - g++ -* `egdb` - gdb -* `egfortran` - g95 / gfortran - -The exception being `gnat`. - -`GNUstep` is available if you would like to develop using Objective-C. The -following should be added to `~/.kshrc`: - -``` -export GNUSTEP_MAKEFILES=/usr/local/share/GNUstep/Makefiles -. /usr/local/share/GNUstep/Makefiles/GNUstep.sh -``` -You will also need to call `gmake` rather than `make` when building Objective-C -code. See [this StackOverflow post](https://stackoverflow.com/questions/14441852/how-to-build-gnustep-programs-on-openbsd) -for more information. - -[back](/) diff --git a/pages/irc.md b/pages/irc.md index 4e874bf..13a3a07 100644 --- a/pages/irc.md +++ b/pages/irc.md @@ -11,9 +11,12 @@ 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: -* institute.tilde.chat -* Port 6697 -* TLS / SSL +* localhost +* Port 6667 +* No TLS + +If you're using the `catgirl` client, you can just run `catgirl local`. +This uses the default system config. See `man 1 catgirl` if you want a custom config. Don't forget to `/join #institute` and `/join #meta`. @@ -24,9 +27,9 @@ Don't forget to `/join #institute` and `/join #meta`. ## Certificates -If you get an untrusted certificate error, change this line in `$HOME/.weechat/weechat.conf` +If you get an untrusted certificate error, change the weechat configs: ``` -gnutls_ca_file = "/etc/ssl/cert.pem" +/set weechat.network.gnutls_ca_file "/etc/ssl/cert.pem" ``` ## Channels @@ -74,11 +77,16 @@ And if you're using `irssi` /connect -tls -tls_verify irc.tilde.chat 6697 ``` -The tildeverse IRC network also runs an instance of `The Lounge`, a -web-based IRC client that allows you to stay connected even when you're -away. It's available at: +Or from `catgirl`: + +``` +catgirl -h institute.tilde.chat -n <nick> +``` + +The tilde.chat IRC network also runs two web clients: -* [https://web.tilde.chat](https://web.tilde.chat) +* [gamja](https://tilde.chat/gamja) +* [kiwi](https://tilde.chat/kiwi) Join us on the tildeverse IRC network and socialize with other tilde users! diff --git a/pages/jdk.md b/pages/jdk.md index b74ecfd..1f8a0f1 100644 --- a/pages/jdk.md +++ b/pages/jdk.md @@ -19,4 +19,6 @@ Afterwards, you may call `java`, `javac`, etc as expected. JDK 1.8.0 is also available by replacing `jdk-11` in the above two lines with `jdk-1.8.0` +JDK 17 is also available. + [back](/) diff --git a/pages/remote-mail.md b/pages/remote-mail.md new file mode 100644 index 0000000..800a0dc --- /dev/null +++ b/pages/remote-mail.md @@ -0,0 +1,48 @@ +<!-- +title: Remote Mail +author: Charadon +description: How to connect to your tilde.institute e-mail address remotely. +--> + +# Remote Mail Guide +tilde.institute doesn't support POP or IMAP at the moment, so we'll need to use +a little bit of a roundabout way of connecting to our mail address remotely. +All you will need for this guide is sshfs, ssh itself, and an e-mail client +that supports Maildir. + +## Known clients that support Maildir +- Gnome Evolution +- Neomutt +- Mutt + +## Sending Mail + +To send mail, all you need to do is run this command: + +``` +ssh -nNTL 25:localhost:25 yourusername@tilde.institute +``` + +And then set your SMTP server in your mail client to localhost and use port 25. +You will now be able to send mail. + +## Receiving Mail +First, you need to mount your remote Maildir folder using sshfs. You can use +this command to do that: + +``` +sshfs -v -o reconnect -o ssh_command="ssh -i ~/.ssh/id_yourkey" yourusername@tilde.institute:/home/yourusername/Maildir ~/Maildir +``` + +Then set up your mail client like you would with any other Maildir and point it +to your mounted Maildir folder. + +### Notes +1. This is not very mobile unfortunately, and as far as i'm aware, there is no +Maildir supporting e-mail client for phones. +2. The above commands assume you have a keyring installed to automatically +unlock your keys OR a passwordless key. +3. On some file managers such as Thunar, if sshfs can't connect to the remote +server, it will freeze the file manager if you navigate to the folder it's +mounted in. (In this case, since we mounted Maildir to ~/, it'll freeze in +your home folder.) diff --git a/pages/todo.md b/pages/todo.md new file mode 100644 index 0000000..49a9a6c --- /dev/null +++ b/pages/todo.md @@ -0,0 +1,66 @@ +<!-- +title: todo, a todo list manager +description: todo usage guide +author: ensa +--> + +# todo, a todo list manager + +`todo` is a todo list manager. + +`todo` manages the todo list stored in the path referred to by `$TODO`, or +`$HOME/todo` if TODO isn't set. + +## basic usage + +`todo` without arguments will print the file's +contents, with line numbers added. +example output: +``` + 1 write todo documentation + 2 water the cat + 3 do nothing +``` + +`todo -a "MSG"` +will append another line, containing MSG. +``` + 1 write todo documentation + 2 water the cat + 3 do nothing + 4 MSG +``` + +`todo -e` edits the todo file in `$EDITOR`. + +`todo -d 2` removes item 2 from the list, and archives it in `${TODO}.complete` +with a timestamp. +`todo` output after `todo -d 2`: +``` + 1 write todo documentation + 2 do nothing + 3 MSG +``` + +`todo -x` views the list archive. +example output: +``` +2020-07-16 13:37:53 - water the cat +``` + +## advanced use + +the `-n` flag specifies the line number where the line is added, pushing all +lower lines down by one. +for example, `todo` after `todo -n 3 -a 'bake pie'` will result in this. +``` + 1 write todo documentation + 2 do nothing + 3 bake pie + 4 MSG +``` + +## source repository +todo's source can be found [here](https://git.tilde.institute/ensa/todo). + +[back](/) diff --git a/pages/unixtips.md b/pages/unixtips.md index 3848e66..4b14250 100644 --- a/pages/unixtips.md +++ b/pages/unixtips.md @@ -26,6 +26,12 @@ you have un-incorporated mail, or more specifically, when your PS1="\$([-s /var/mail/`whoami` ] && echo '* ')$PS1" ``` +For maildir try this: + +``` +PS1="$(test -z "`ls -A $HOME/Maildir/new`" || 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 encourage diff --git a/pages/user-repos.md b/pages/user-repos.md index 76b4135..3fd17b6 100644 --- a/pages/user-repos.md +++ b/pages/user-repos.md @@ -15,6 +15,9 @@ bundled into `.tar.gz` archives and listed on the summary page. All repos can be viewed at [https://git.tilde.institute](https://git.tilde.institute) +**Note:** If a change doesn't appear in cgit immediately, wait a few +minutes. The cache will time out. + ## Creating the directory New users will not have to do this step. A `~/public_repos` link will @@ -51,15 +54,22 @@ Change into *that* directory and initialize a bare repo: cd foo.git; git init --bare ``` -Now that the bare repo has been created, edit the file called `config` -and append the following section: +Now that the bare repo has been created, we'll need to set some configuration +options. You may use this command from within the directory you just created: + +``` +git config --local gitweb.owner "$USER <$USER@tilde.institute>" +``` + +Or, you may manually edit the file called `config` and append the following +section: ``` [gitweb] owner = user_name <user_name@tilde.institute> ``` -Write out the text description of your repo into a file called +Then, write out the text description of your repo into a file called `description`: ``` |