From 3eb2b0453f2f31ab345780b2c9d8fa7e6eb01cc3 Mon Sep 17 00:00:00 2001 From: Leo Gavilieau Date: Sat, 20 May 2023 09:49:29 +0200 Subject: [PATCH] docs: Add all wiki pages Only the mastodon and pkgman guide have been transcribed so far. And we are still missing the legal webpages --- content/en/admins.md | 3 +++ content/en/email.md | 3 +++ content/en/guides/mastodon.md | 46 ++++++++++++++++++++++++++++++++++ content/en/guides/matrix.md | 3 +++ content/en/guides/pkgman.md | 36 ++++++++++++++++++++++++++ content/en/guides/register.md | 3 +++ content/en/guides/ssh.md | 3 +++ content/en/guides/usersites.md | 3 +++ content/en/mastodon.md | 3 +++ content/en/matrix.md | 3 +++ content/en/ssh.md | 3 +++ 11 files changed, 109 insertions(+) create mode 100644 content/en/admins.md create mode 100644 content/en/email.md create mode 100644 content/en/guides/mastodon.md create mode 100644 content/en/guides/matrix.md create mode 100644 content/en/guides/pkgman.md create mode 100644 content/en/guides/register.md create mode 100644 content/en/guides/ssh.md create mode 100644 content/en/guides/usersites.md create mode 100644 content/en/mastodon.md create mode 100644 content/en/matrix.md create mode 100644 content/en/ssh.md diff --git a/content/en/admins.md b/content/en/admins.md new file mode 100644 index 0000000..0fce2e0 --- /dev/null +++ b/content/en/admins.md @@ -0,0 +1,3 @@ +--- +titlte: "~vern administrators" +--- \ No newline at end of file diff --git a/content/en/email.md b/content/en/email.md new file mode 100644 index 0000000..c10b27e --- /dev/null +++ b/content/en/email.md @@ -0,0 +1,3 @@ +--- +titlte: "About ~vern's Email service" +--- \ No newline at end of file diff --git a/content/en/guides/mastodon.md b/content/en/guides/mastodon.md new file mode 100644 index 0000000..27e782f --- /dev/null +++ b/content/en/guides/mastodon.md @@ -0,0 +1,46 @@ +--- +titlte: "How to use Mastodon" +--- + +Mastodon is a decentralized open-source social networking software. Mastodon uses ActivityPub to talk to other websites, so you can install Mastodon or another ActivityPub-compatible software and those can also talk to Mastodon instances. + +Let's imagine 2 people who want to talk to each other on their own website, Bob creates a Mastodon instance over at `mastodon.bobland.bob` while Alice creates a [Pleroma](https://pleroma.org) instance over at `pleroma.aliceland.alice`. They can just follow each other and send posts to each other, but unlike say XMPP, you can send messages to No one! And just have your followers receive them. + +It's like the decentralized nature of Email with the convenience of Twitter, or Twitter without the censorship. + +Anyways, this tutorial will focus on how to use Mastodon and some basic Fediverse Etiquette + +If you haven't already then go register an account over at ~vern, there is also a guide for doing that [here](/guides/register) (Make sure to enable Mastodon as a service or [contact the ~vern administrators](/admins/) to have them create it for you) + +===== Logging in ===== + +Open up your web browser and go to [fedi.vern.cc](https://fedi.vern.cc), you will see a login screen here. Simply input the email address and password you used for registration, if you are having issues logging in then [contact the ~vern administrators](/admins/) who will help you out. + +Now you will see the main page, if you are a new user then you will not see posts here but you will see a list of people to follow. To get started with the Fediverse you need to follow others, pay attention to how some of the usernames have domain names and how they come from different places. This is ActivityPub at work! Different domains such as `mastodon.social` can talk with `fedi.vern.cc` and vice versa! + +However, this is the tedious bit, you follow as many people as you can to create a timeline that is yours! Unlike Twitter, Mastodon sorts posts by chronological order (How recent they are) so you will have to follow a lot of people to get started. + +Meanwhile you can start writing posts so that others can discover you and follow you, write a post introducing yourself or a fun fact or whatever you want just as long as it doesn't violate [our rules](https://fedi.vern.cc/about/more) + +The interface is very easy to navigate, however, once you finish setting up your Mastodon account, you are encouraged to switch to a different interface. The default Mastodon interface is very slow and very heavy on system resources and it is recommend to download a Desktop client or use a client such as [bloatFE](https://bloat.vern.cc). BloatFE is very minimalist and does not consume nearly as much resources as the default frontend but it can be hard to use. + +If you find BloatFE hard to use then don't use it! Just use whatever is comfortable for you! It is what we recommend but you can simply ignore our recommendation! + +## Fediverse Etiquette + +The Fediverse is a collection of servers that can all communicate with each other, they are federated. `fedi.vern.cc` is one server among thousands and thousands of servers. But here we must advise you with some basic Fediverse Etiquette + +1. Add information about yourself before following people + +It is highly recommend to include information about yourself in your profile before following anyone, some users do not follow those with empty profiles while others simply want to know your preferences such as what pronouns you use. + +2. Read a person's Bio or Pinned Posts before following them + +Some people however need more information or verification before they let you follow them. They might ask you to verify you are not a robot by starting a conversation with you. + +3. Make sure to add warnings to your posts + +This is a very vague rule but please add warnings to your posts, if it has gore content or NSFW content then make sure to let people know before they see it. And if someone criticizes your content warning then try to understand their criticism and make sure to learn from your mistakes! Most instances have rules against NSFW content that does not have content warnings and will often block the user from their instance. + +If you post NSFW content that does not include a content warning then you will be warned, your post might get deleted and if you keep violating this rule then you will be banned. + diff --git a/content/en/guides/matrix.md b/content/en/guides/matrix.md new file mode 100644 index 0000000..2e5bfde --- /dev/null +++ b/content/en/guides/matrix.md @@ -0,0 +1,3 @@ +--- +titlte: "How to use Matrix" +--- \ No newline at end of file diff --git a/content/en/guides/pkgman.md b/content/en/guides/pkgman.md new file mode 100644 index 0000000..582746c --- /dev/null +++ b/content/en/guides/pkgman.md @@ -0,0 +1,36 @@ +--- +titlte: "How to do Package Management on the Pubnix" +--- + +Pubnix, the virtual machine where users [SSH](/guides/ssh/) into, runs on [NixOS](https://nixos.org/) despite constant protests from the [Guix](https://guix.gnu.org) clan. Nix has a weird way of installing software, which has several pros and several cons. We are not gonna focus on these but one of the pros is that you can install software in your own local user without needing root access. + +This guide focuses on some rather basic functions that Nix can do. We won't go over anything advanced. + +## Searching for Packages +To search for packages, you would run `nix --extra-experimental-features "nix-command flakes" search nixpkgs ` (replacing <packagename> with your package of choice) + +*Note: This command takes a while to download the index (around 40 seconds), but this is only an issue the first time.* + +You could also put this into a bash alias, so you don't have to type it all the time, one such alias would be: + +```bashrc +alias nix-search="nix --extra-experimental-features "nix-command flakes" search nixpkgs $1" +``` +And with that alias, you could run `nix-search ` instead! + +## Checking what package owns a specific file +To search for a specific file in a package, you would run `nix-locate 'bin/filename'` + +*Note: this uses our global file database in /var/lib/nix-index which is updated weekly with a cronjob.* + +## Installing packages into your current environment +To install a package into your current environment, you would run `nix-env -iA nixos.` + +*Note: packages installed by this method exist only as long as the user environment does* + +## "Installing" a package but in a temporary shell +This is a quite useful feature for when you only need a command once and never again. + +To install a package in a temporary shell, you would run `nix-shell -p ` + +*Note: As soon as the shell is closed, the package will be gone from your path, though its cached so you can use it later easily.* \ No newline at end of file diff --git a/content/en/guides/register.md b/content/en/guides/register.md new file mode 100644 index 0000000..ee810e0 --- /dev/null +++ b/content/en/guides/register.md @@ -0,0 +1,3 @@ +--- +titlte: "How to register on ~vern" +--- \ No newline at end of file diff --git a/content/en/guides/ssh.md b/content/en/guides/ssh.md new file mode 100644 index 0000000..0e0df04 --- /dev/null +++ b/content/en/guides/ssh.md @@ -0,0 +1,3 @@ +--- +titlte: "How to use SSH" +--- \ No newline at end of file diff --git a/content/en/guides/usersites.md b/content/en/guides/usersites.md new file mode 100644 index 0000000..28f2791 --- /dev/null +++ b/content/en/guides/usersites.md @@ -0,0 +1,3 @@ +--- +titlte: "How to host websites on ~vern" +--- \ No newline at end of file diff --git a/content/en/mastodon.md b/content/en/mastodon.md new file mode 100644 index 0000000..ee8a3a7 --- /dev/null +++ b/content/en/mastodon.md @@ -0,0 +1,3 @@ +--- +titlte: "About ~vern's Mastodon Instance" +--- \ No newline at end of file diff --git a/content/en/matrix.md b/content/en/matrix.md new file mode 100644 index 0000000..aeab4ba --- /dev/null +++ b/content/en/matrix.md @@ -0,0 +1,3 @@ +--- +titlte: "About ~vern's Matrix Instance" +--- \ No newline at end of file diff --git a/content/en/ssh.md b/content/en/ssh.md new file mode 100644 index 0000000..c8c3b16 --- /dev/null +++ b/content/en/ssh.md @@ -0,0 +1,3 @@ +--- +titlte: "About ~vern's SSH service" +--- \ No newline at end of file