Wrap all wiki pages' markdown source
Nicer to read when viewing source. I didn't touch code of conduct tho
This commit is contained in:
parent
6d0cd75398
commit
8851ad3fa0
27
blogs.md
27
blogs.md
|
@ -1,11 +1,15 @@
|
||||||
you can create a blog that is publicly available on the web in your `public_html`.
|
you can create a blog that is publicly available on the web in your
|
||||||
if you haven't already, check out [the wiki page about editting your site](website.html) first.
|
`public_html`. if you haven't already, check out [the wiki page about editting
|
||||||
|
your site](website.html) first.
|
||||||
|
|
||||||
# bashblog
|
# 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
|
cd ~/public_html
|
||||||
|
|
||||||
|
@ -13,18 +17,21 @@ now, you can start writing your first post!
|
||||||
|
|
||||||
bb post
|
bb post
|
||||||
|
|
||||||
it opens the editor in your `$EDITOR` enviroment variable, if you're unsure, set it to `nano`
|
it opens the editor in your `$EDITOR` enviroment variable, if you're unsure,
|
||||||
first: `export EDITOR=nano`. you can put that line in your `~/.bashrc` if you'd like to keep using the
|
set it to `nano` first: `export EDITOR=nano`. you can put that line in your
|
||||||
selected editor.
|
`~/.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.
|
||||||
|
|
||||||
<!-- TODO: .config, css, rss, gemini -->
|
<!-- TODO: .config, css, rss, gemini -->
|
||||||
|
|
||||||
# ssgs
|
# 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
|
- markdown
|
||||||
|
|
15
email.md
15
email.md
|
@ -5,7 +5,8 @@ your tilde.cafe account comes with a @tilde.cafe email address
|
||||||
## checking mail
|
## checking mail
|
||||||
|
|
||||||
- `neomutt` (and `mutt`) are pre installed and should work out of the box
|
- `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:
|
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
|
## 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
|
echo myemail@example.com > ~/.forward
|
||||||
|
|
||||||
## sieve
|
## 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
|
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.
|
||||||
|
|
25
faq.md
25
faq.md
|
@ -2,20 +2,22 @@
|
||||||
|
|
||||||
## what is tilde.cafe?
|
## 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,
|
it was created in the spirit of the tildeverse. partly to get other people
|
||||||
partly for ~spider to improve his own linux skills
|
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)
|
you can sign up on the [sign up page](/signup)
|
||||||
|
|
||||||
|
|
||||||
## what is a tilde?
|
## what is a tilde?
|
||||||
|
|
||||||
a tilde character "~" followed by the username represents the user's "home" in linux.
|
a tilde character "~" followed by the username represents the user's "home" in
|
||||||
`~spider` would link to spider's home directory.
|
linux. `~spider` would link to spider's home directory.
|
||||||
|
|
||||||
a tilde in the community sense, is a home on the internet :)
|
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?
|
## what is the tildeverse?
|
||||||
|
|
||||||
the tildeverse is a "loose" association of tildes and cool services for tildes.
|
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
|
in other words, it's a collection of public access unix systems (or *pubnixes*)
|
||||||
grouped together to create a bigger community, and they share services between each other.
|
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?
|
## 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?
|
## can i get a package installed?
|
||||||
|
|
29
gemini.md
29
gemini.md
|
@ -1,7 +1,8 @@
|
||||||
<!-- this wiki page seems done -->
|
<!-- this wiki page seems done -->
|
||||||
# gemini
|
# 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:
|
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
|
the `~/public_gemini` directory is not created by default. use `mkdir
|
||||||
you can start adding index.gmi etc, it will be served at gemini://tilde.cafe/~username/ and gemini://username.tilde.cafe.
|
~/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
|
for more information about how you write gemtext, check out the [Introduction
|
||||||
[Introduction to Gemtext Markup](https://gemini.circumlunar.space/docs/gemtext.gmi),
|
to Gemtext Markup](https://gemini.circumlunar.space/docs/gemtext.gmi), there is
|
||||||
there is also a [cheatsheet](https://gemini.circumlunar.space/docs/cheatsheet.gmi).
|
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
|
## 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`**
|
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
|
#!/bin/sh
|
||||||
exec 2>/tmp/my_gemini_debug.txt
|
exec 2>/tmp/my_gemini_debug.txt
|
||||||
printf "20 text/gemini\r\n"
|
printf "20 text/gemini\r\n"
|
||||||
echo "hello world"
|
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.
|
||||||
|
|
|
@ -12,7 +12,8 @@
|
||||||
|
|
||||||
## logging in
|
## 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
|
1. open a terminal
|
||||||
* linux: usually search for "terminal" in your app menu, on KDE it's Konsole
|
* 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
|
- `ls` = list files and folders in the current directory
|
||||||
- `cp` = copy files and directories (for example `cp index.html old_index.html`)
|
- `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`)
|
- `mv` = move and rename files and directories (for example `mv example.txt
|
||||||
- `rm` = PERMANENTLY delete files and directories (use `rm -r` to delete directories), THERE IS NO UNDOING THIS
|
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
|
- `cd` = change directory
|
||||||
- `pwd` = tells you which directory you are in
|
- `pwd` = tells you which directory you are in
|
||||||
- `nano` = a command line text editor, similar to notepad
|
- `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.
|
- type `nano index.html` to open your homepage in nano.
|
||||||
|
|
||||||
edit the file as you like. when done press `ctrl + x` to quit.
|
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'll be asked if you want to save, press `y` to confirm. (or `n` to quit
|
||||||
You can also press `ctrl + s` to save without exiting, and `ctrl + o` to save as a different filename
|
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!
|
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).
|
||||||
|
|
14
irc.md
14
irc.md
|
@ -1,19 +1,23 @@
|
||||||
# IRC
|
# 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)).
|
[tilde.chat](https://tilde.chat) is an irc network for the tildeverse ([what is
|
||||||
it is available publicly at irc.tilde.chat:6697 (with ssl).
|
the tildeverse?](faq.html)). it is available publicly at irc.tilde.chat:6697
|
||||||
|
(with ssl).
|
||||||
|
|
||||||
|
|
||||||
## how to connect
|
## 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`
|
- `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.
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
todo
|
todo
|
||||||
|
|
14
website.md
14
website.md
|
@ -13,13 +13,16 @@ static content are served normally, but there are also some dynamic options:
|
||||||
|
|
||||||
- php: `.php` extension
|
- php: `.php` extension
|
||||||
- CGI scripts
|
- CGI scripts
|
||||||
CGI script have been traditionally limited to any executable file in `/cgi-bin/`.
|
|
||||||
however, we've set them to also allow running from anywhere, as long as they're executable and end in `.cgi`, `.py`, `.lua`, or `.sh` extentions
|
CGI script have been traditionally limited to any executable file in
|
||||||
|
`/cgi-bin/`. however, we've set them to also allow running from anywhere, as
|
||||||
|
long as they're executable and end in `.cgi`, `.py`, `.lua`, or `.sh`
|
||||||
|
extentions
|
||||||
|
|
||||||
<!-- TODO: add chmod in getting-started? -->
|
<!-- TODO: add chmod in getting-started? -->
|
||||||
|
|
||||||
make sure the scripts have the correct shebang, is set as executable
|
make sure the scripts have the correct shebang, is set as executable and prints
|
||||||
and prints the content type header first.
|
the content type header first.
|
||||||
|
|
||||||
|
|
||||||
### examples
|
### 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.
|
||||||
|
|
||||||
<!-- TODO: custom domains? -->
|
<!-- TODO: custom domains? -->
|
||||||
|
|
Loading…
Reference in New Issue