diff --git a/README.md b/README.md index a558a08..2be5874 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,3 @@ # wiki -~cafe wiki pages \ No newline at end of file +~cafe wiki pages diff --git a/blogs.md b/blogs.md new file mode 100644 index 0000000..d20651a --- /dev/null +++ b/blogs.md @@ -0,0 +1,30 @@ +you can create a blog that is publicly available on the web in your `public_html`. +if you haven't already, check out [the wiki page about editting your site](website.html) first. + +# bashblog + +bashblog is a simple and quick way to create and manage your blogs, it's available system-wide as `bb` + +you can use it to manage your blog, write posts, etc, from anywhere. and your blog will be generated at `~/public_html/blog/`. if you like, you could navigate into it first. + + cd ~/public_html + +now, you can start writing your first post! + + bb post + +it opens the editor in your `$EDITOR` enviroment variable, if you're unsure, set it to `nano` +first: `export EDITOR=nano`. you can put that line in your `~/.bashrc` if you'd like to keep using the +selected editor. + +after you save and close your editor, follow the instructions and check out your live blog on your homepage! + +the process will be the same everytime you're ready to add a new entry. just run `bb post` from anywhere. + + + +# ssgs + +here is the list of static site generators (which can not only be used for blogs but others too) installed on tilde.cafe: + +- markdown diff --git a/code-of-conduct.md b/code-of-conduct.md new file mode 100644 index 0000000..ac21510 --- /dev/null +++ b/code-of-conduct.md @@ -0,0 +1,98 @@ +# code of conduct + +> **tl;dr** learn by doing and helping. be excellent to each other. have fun! + + + +## expected behavior + +the following behaviors are expected and requested of all community members: + +- participate in an authentic and active way. in doing so, you contribute to the health and longevity of this community. +- exercise consideration and respect in your speech and actions. +- attempt collaboration before conflict. +- refrain from demeaning, discriminatory, or harassing behavior and speech. +- be mindful of your surroundings and of your fellow participants. +- teach when people need help. don't do it for them. + +## unacceptable behavior + +the following behaviors are considered harassment and are unacceptable within our community: + +- violence, threats of violence or violent language directed against another person. +- sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language. +- posting or displaying sexually explicit or violent material. +- posting or threatening to post other people's personally identifying information ("doxing"). +- personal insults, particularly those related to gender, sexual orientation, race, religion, or disability. +- unwelcome sexual attention. this includes sexualized comments or jokes. +- deliberate intimidation, stalking or following. + +## 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.cafe without warning (meaning your account will be terminated and all user data deleted). + +## 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. + +## 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. + +## scope + +we expect all tilde.cafe members to abide by this code of conduct while: + +- engaging with other members +- publishing content on tilde.cafe + +## contact info + +tilde.cafe admins: + +you can also send a mail to [sudoers@tilde.cafe](mailto:sudoers@tilde.cafe) to make sure we all get it. + +- [spider](https://tilde.cafe/~spider/): + - [spider@tilde.cafe](mailto:spider@tilde.cafe) + - on irc `/query spider hello` + + + +## license and attribution + +this code of conduct is based on [citizencodeofconduct.org](http://citizencodeofconduct.org) and [tilde.town coc](http://tilde.town/wiki/conduct.html) +under the terms of the [creative commons attribution-sharealike license](http://creativecommons.org/licenses/by-sa/3.0/). + + diff --git a/email.md b/email.md new file mode 100644 index 0000000..66ba880 --- /dev/null +++ b/email.md @@ -0,0 +1,37 @@ +# email + +your tilde.cafe account comes with a @tilde.cafe email address + +## checking mail + +- `neomutt` (and `mutt`) are pre installed and should work out of the box +- there is also a webmail client at [mail.tilde.cafe](https://mail.tilde.cafe). sign in with your username and shell password + +you could also use your own client and connect with imap/smtp or pop3: + +- email address: username@tilde.cafe +- username: username (without domain) +- password: your shell password +- imap: imap.tilde.cafe + - tls: port 993 + - starttls: port 143 +- pop3: pop.tilde.cafe port 995 +- smtp: smtp.tilde.cafe + - tls: port 465 + - starttls: 587 + +## forwarding + +if you would like to forward all your mail to a different email address, put the destination email inside `~/.forward` + + echo myemail@example.com > ~/.forward + +## sieve + +we support per-user sieves. (this is like filtering a specific email address, subject containing something, etc to a particular folder, and more). + +here are some example sieves: https://wiki.dovecot.org/Pigeonhole/Sieve/Examples + +put your scripts in `~/sieve/`, and have a symlink `~/.dovecot.sieve` linking to your active script in `~/sieve/`. + +you can also manage and create your filters/sieves through our [webmail](https://mail.tilde.cafe) with a graphical user interface if you like. diff --git a/faq.md b/faq.md new file mode 100644 index 0000000..2f9da39 --- /dev/null +++ b/faq.md @@ -0,0 +1,51 @@ +# faq + +## what is tilde.cafe? + +tilde.cafe is a multi-user linux server that runs on debian, it was started at the end of 2020. + +it was created in the spirit of the tildeverse. partly to get other people familiar with linux, +partly for ~spider to improve his own linux skills + +once you have an account you can host your own files, website, blog, play games, chat to other people, work on projects together, etc + +you can sign up on the [sign up page](/signup) + + +## what is a tilde? + +a tilde character "~" followed by the username represents the user's "home" in linux. +`~spider` would link to spider's home directory. + +a tilde in the community sense, is a home on the internet :) + + +## what is the tildeverse? + +the tildeverse is a "loose" association of tildes and cool services for tildes. +in other words, it's a collection of public access unix systems (or *pubnixes*) that have been +grouped together to create a bigger community, and they share services between each other. + +you can learn more about the tildeverse on its homepage: [tildeverse.org](https://tildeverse.org). + + +## so i have an account. now what? + +welcome! there's a lot of things you can do here, check out the [getting started guide](getting-started.html). + + +## can i get a package installed? + +probably! send an email to sudoers@tilde.cafe + + +## how do i remove or rename my account? + +send an email to sudoers@tilde.cafe + + diff --git a/gemini.md b/gemini.md new file mode 100644 index 0000000..4c6a8a5 --- /dev/null +++ b/gemini.md @@ -0,0 +1,55 @@ + +# gemini + +the [gemini protocol](https://gemini.circumlunar.space/) ([http proxy](https://portal.mozz.us/)) was created in 2019. + +gemini is a new internet protocol which: + +- is heavier than gopher +- is lighter than the web +- will not replace either +- strives for maximum power to weight ratio +- takes user privacy very seriously + +--- + +the `~/public_gemini` directory is not created by default. use `mkdir ~/public_gemini` to create it, then +you can start adding index.gmi etc, it will be served at gemini://tilde.cafe/~username/ and gemini://username.tilde.cafe. + +for more information about how you write gemtext, check out the +[Introduction to Gemtext Markup](https://gemini.circumlunar.space/docs/gemtext.gmi), +there is also a [cheatsheet](https://gemini.circumlunar.space/docs/cheatsheet.gmi). + +to browse gemini content, you will need a client or a [web proxy](https://portal.mozz.us). + + +## clients + +- [`amfora`](https://github.com/makeworld-the-better-one/amfora) +- and... + + +## CGI + +make sure you set the correct **shebang** and make the file **executable**. + +then, print the status and type per the gemini spec: here's a simple example in sh + + #!/bin/sh + printf "20 text/gemini\r\n" + echo "hello world" + +note that the first line **must send `\r\n`** + +if you want to debug your script, you can redirect your stderr into a file, if you use shell scripts, you'd do it like this: + + #!/bin/sh + exec 2>/tmp/my_gemini_debug.txt + printf "20 text/gemini\r\n" + echo "hello world" + +keep in mind that all cgi scripts run under a single user ("gemini"), so it might not have permission to run scripts, or write files, that you can + +also be careful about what the scripts can write, because there's nothing preventing someone else from overwriting your files, with their scripts! + +feel free to drop by `#gemini` on [tilde.chat irc](irc.html) if you have questions diff --git a/getting-started.md b/getting-started.md new file mode 100644 index 0000000..d680083 --- /dev/null +++ b/getting-started.md @@ -0,0 +1,62 @@ +# getting started + + _______________________ + < welcome to tilde.cafe > + ----------------------- + \ ^__^ + \ (oo)\_______ + (__)\ )\/\ + ||----w | + || || + + +## logging in + +### windows 10 + +- open cmd or powershell (alternatively a 3rd party program like putty) +- `ssh username@tilde.cafe` +- enter your ssh key passphrase if needed + +if you have windows subsystem for linux (WSL), then open your wsl terminal and follow instructions above. + + +### linux + +- open a terminal +- `ssh username@tilde.cafe` +- enter your ssh key passphrase if needed + + +### mac + +- browse to applications/utilities/terminal and launch terminal (or press cmd+space, start typing terminal, and press return) +- `ssh username@tilde.cafe` +- enter your ssh key passphrase if needed + + +## basic linux commands + +below are some basic commands to get around via ssh. + +- `ls` = list files and folders in the current directory +- `cd` = change directory +- `pwd` = tells you which directory you are in +- `nano` = a command line text editor, similar to notepad + + +## editing your website + +using the commands above we can update our homepage: + +- type `ls` to see what files and folders are in your home directory +- type `cd ~/public_html` to get to your web site's directory +- type `nano index.html` to open your homepage in nano. + +edit the file as you like. when done press `ctrl + x` to quit. +you'll be asked if you want to save, press `y` to confirm. (or `n` to quit without saving) +if it asks you for a filename, press `enter` to confirm. + +now navigate to https://tilde.cafe/~your_username to see the result! + +for more information about your website, check out [the website page](website.html). diff --git a/gopher.md.todo b/gopher.md.todo new file mode 100644 index 0000000..b3849d0 --- /dev/null +++ b/gopher.md.todo @@ -0,0 +1,5 @@ +# gopher + +- public_gopher +- docs link +- clients diff --git a/index.md b/index.md new file mode 100644 index 0000000..0df8760 --- /dev/null +++ b/index.md @@ -0,0 +1 @@ +# current wiki pages diff --git a/irc.md b/irc.md new file mode 100644 index 0000000..a74a95b --- /dev/null +++ b/irc.md @@ -0,0 +1,29 @@ +# IRC + +on tilde.cafe you can hangout and chat on the `#cafe` channel of [tilde.chat](https://tilde.chat) irc. + +[tilde.chat](https://tilde.chat) is an irc network for the tildeverse ([what is the tildeverse?](faq.html)). +it is available publicly at irc.tilde.chat:6697 (with ssl). + + +## how to connect + +- the `chat` command automatically connects you to tilde.chat with `weechat` and joins the channels #meta and #cafe. +- `irssi` + +--- + +see the [tilde.chat wiki](https://tilde.chat/wiki) for info on bots and other specifics. + + diff --git a/website.md b/website.md new file mode 100644 index 0000000..2f7a8d0 --- /dev/null +++ b/website.md @@ -0,0 +1,64 @@ +# website + +your `~/public_html` directory is served at: + +- tilde.cafe/~username/ +- username.tilde.cafe +- tilde.cafe/u/username/ + + +## dynamic options + +static content are served normally, but there are also some dynamic options: + +- php: `.php` extension +- python: `.py` extension +- lua: `.lua` extension +- shell: `.sh` or `.cgi` extension +- cgi scripts: name it whatever you want and place the executable file in `cgi-bin/` + + + +make sure the scripts have the correct shebang, is set as executable +and prints the content type header first. + + +### examples + +**sh:** + + #!/usr/bin/sh + printf "Content-type:text/plain\r\n\r\n" + echo "hello!!!" + +**python:** + +(you can of course write html in your cgi script too) + + #!/usr/bin/env python3 + print("Content-type:text/html\r\n\r\n") + print("

this is a header

") + + + + +**php:** + + + + + + +

here's a header

+ + + + +--- + +you can use your `public_html` to write a blog! check out the [blogs](blogs.html) page for more info. + +