From 8851ad3fa0f12ab66d495302c1d30977bfc1bf01 Mon Sep 17 00:00:00 2001 From: Hedy Li Date: Tue, 12 Oct 2021 16:40:29 +0800 Subject: [PATCH] Wrap all wiki pages' markdown source Nicer to read when viewing source. I didn't touch code of conduct tho --- blogs.md | 27 +++++++++++++++++---------- email.md | 15 ++++++++++----- faq.md | 25 +++++++++++++++---------- gemini.md | 29 ++++++++++++++++++----------- getting-started.md | 21 ++++++++++++++------- irc.md | 14 +++++++++----- website.md | 14 +++++++++----- 7 files changed, 92 insertions(+), 53 deletions(-) diff --git a/blogs.md b/blogs.md index d20651a..881f95d 100644 --- a/blogs.md +++ b/blogs.md @@ -1,11 +1,15 @@ -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. +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` +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. +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 @@ -13,18 +17,21 @@ 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. +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! +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. +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: +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/email.md b/email.md index 66ba880..6512a86 100644 --- a/email.md +++ b/email.md @@ -5,7 +5,8 @@ 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 +- 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: @@ -22,16 +23,20 @@ you could also use your own client and connect with imap/smtp or pop3: ## forwarding -if you would like to forward all your mail to a different email address, put the destination email inside `~/.forward` +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). +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/`. +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. +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 index 2f9da39..b592c59 100644 --- a/faq.md +++ b/faq.md @@ -2,20 +2,22 @@ ## what is tilde.cafe? -tilde.cafe is a multi-user linux server that runs on debian, it was started at the end of 2020. +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 +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 +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 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 :) @@ -23,15 +25,18 @@ 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. +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). +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). +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? diff --git a/gemini.md b/gemini.md index 8e53e8e..2f86e64 100644 --- a/gemini.md +++ b/gemini.md @@ -1,7 +1,8 @@ # gemini -the [gemini protocol](https://gemini.circumlunar.space/) ([http proxy](https://portal.mozz.us/)) was created in 2019. +the [gemini protocol](https://gemini.circumlunar.space/) ([http +proxy](https://portal.mozz.us/)) was created in 2019. gemini is a new internet protocol which: @@ -13,14 +14,16 @@ gemini is a new internet protocol which: --- -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. +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). +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). +to browse gemini content, you will need a client or a [web +proxy](https://portal.mozz.us). ## clients @@ -40,15 +43,19 @@ then, print the status and type per the gemini spec: here's a simple example in 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: +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 +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! +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 +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 index 74af017..da4faf2 100644 --- a/getting-started.md +++ b/getting-started.md @@ -12,7 +12,8 @@ ## logging in -if you have windows subsystem for linux (WSL), then open your wsl terminal and follow instructions below. +if you have windows subsystem for linux (WSL), then open your wsl terminal and +follow instructions below. 1. open a terminal * linux: usually search for "terminal" in your app menu, on KDE it's Konsole @@ -29,8 +30,10 @@ below are some basic commands to get around via ssh. - `ls` = list files and folders in the current directory - `cp` = copy files and directories (for example `cp index.html old_index.html`) -- `mv` = move and rename files and directories (for example `mv example.txt poem.txt` effectively renames `example.txt` into `poem.txt`) -- `rm` = PERMANENTLY delete files and directories (use `rm -r` to delete directories), THERE IS NO UNDOING THIS +- `mv` = move and rename files and directories (for example `mv example.txt + poem.txt` effectively renames `example.txt` into `poem.txt`) +- `rm` = PERMANENTLY delete files and directories (use `rm -r` to delete + directories), THERE IS NO UNDOING THIS - `cd` = change directory - `pwd` = tells you which directory you are in - `nano` = a command line text editor, similar to notepad @@ -45,10 +48,14 @@ using the commands above we can update our homepage: - 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. -You can also press `ctrl + s` to save without exiting, and `ctrl + o` to save as a different filename + +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. + +You can also press `ctrl + s` to save without exiting, and `ctrl + o` to save +as a different filename 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). +for more information about your website, check out [the website +page](website.html). diff --git a/irc.md b/irc.md index a74a95b..1ed8589 100644 --- a/irc.md +++ b/irc.md @@ -1,19 +1,23 @@ # IRC -on tilde.cafe you can hangout and chat on the `#cafe` channel of [tilde.chat](https://tilde.chat) 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). +[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. +- 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. +see the [tilde.chat wiki](https://tilde.chat/wiki) for info on bots and other +specifics. -make sure the scripts have the correct shebang, is set as executable -and prints the content type header first. +make sure the scripts have the correct shebang, is set as executable and prints +the content type header first. ### examples @@ -58,6 +61,7 @@ TODO: seems lua has both cgi and also this thing called Lua Page? --- -you can use your `public_html` to write a blog! check out the [blogs](blogs.html) page for more info. +you can use your `public_html` to write a blog! check out the +[blogs](blogs.html) page for more info.