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
GPG Key ID:
B51B5A8D1B176372
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`.
|
||||
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.
|
||||
|
||||
<!-- TODO: .config, css, rss, gemini -->
|
||||
|
||||
# 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
|
||||
|
|
|
|||
15
email.md
15
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.
|
||||
|
|
|
|||
25
faq.md
25
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?
|
||||
|
|
|
|||
29
gemini.md
29
gemini.md
|
|
@ -1,7 +1,8 @@
|
|||
<!-- this wiki page seems done -->
|
||||
# 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.
|
||||
|
|
|
|||
|
|
@ -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).
|
||||
|
|
|
|||
14
irc.md
14
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.
|
||||
|
||||
<!--
|
||||
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
|
||||
- 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? -->
|
||||
|
||||
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.
|
||||
|
||||
<!-- TODO: custom domains? -->
|
||||
|
|
|
|||
Loading…
Reference in New Issue