From 2a3bf82243d719687450f26294618bb80c54ff32 Mon Sep 17 00:00:00 2001 From: Liam Waldron Date: Wed, 24 May 2023 13:19:24 -0400 Subject: [PATCH] update docs --- docs/general-recommendations.html | 29 +++++++++-- docs/home.html | 2 +- docs/intro-to-glacier.html | 6 +++ docs/mkpage.sh | 14 ++++++ docs/musl-or-glibc.html | 83 +++++++++++++++++++++++++++++++ mkpage.sh | 14 ++++++ 6 files changed, 142 insertions(+), 6 deletions(-) create mode 100755 docs/mkpage.sh create mode 100644 docs/musl-or-glibc.html create mode 100755 mkpage.sh diff --git a/docs/general-recommendations.html b/docs/general-recommendations.html index 55e92f2..d38ce45 100644 --- a/docs/general-recommendations.html +++ b/docs/general-recommendations.html @@ -60,7 +60,7 @@

3 - Boot process

3.1 Microcode

All users of AMD and Intel CPUs should install their corresponding microcode update package.

- (root)# gpkg -f world/{amd,intel}-ucode + (root)# gpkg -f {amd,intel}-ucode

3.2 Secure boot

Everest does not officially support UEFI secure boot at the moment. While you can always attempt to implement it yourself, there will most likely be pitfalls.

For most users, disabling secure boot altogether is recommended.

@@ -76,19 +76,38 @@

AMD graphics drivers are included in distribution kernels, and can be included in custom kernels when configuring. Nouveau, the open source implementation of Nvidia's graphics drivers can be included as well.

While these defaults may be adequate for running a headless machine, or just general web browsing, some users may want more performance out of their GPU.

Install mesa, which provides an open source implementation of OpenGL, Vulkan, and other APIs:

- (root)# gpkg -f world/mesa + (root)# gpkg -f mesa

Install AMD drivers:

- (root)# gpkg -f world/mesa + (root)# gpkg -f mesa

Install Nvidia drivers on a system running a distribution kernel:

- (root)# gpkg -f world/nvidia + (root)# gpkg -f nvidia

Or, install Nvidia drivers on a system running a custom kernel:

- (root)# gpkg -f world/nvidia-dkms + (root)# gpkg -f nvidia-dkms

4.3 Desktop environments

Desktop environments provide a complete graphical interface, like what's found in most Linux distributions. Users who want something that will work out of the box will most likely opt for a desktop environment.

Some popular choices include GNOME, KDE Plasma, and Xfce.

4.4 Standalone window managers

A window manager is a single program with one task - manage window position, size, etc. Users who want a lightweight, keyboard oriented workflow, and are fine with extensive customization will most likely opt for a window manager.

Some popular choices include i3, sway, bspwm, openbox, awesome, and dwm.

+

5 - Networking

+

5.1 Clock synchronization

+

NTP is a protocol for synchronizing computer clocks over the network.

+

Chrony, one implementation, is available in the package database.

+

In case it was not installed, run:

+ (root)# gpkg -f chrony +

5.2 Firewall

+

Firewalls provide an extra layer of protection.

+

The default firewall in Everest is ufw, which can be installed by running:

+ (root)# gpkg -f ufw +

6 - Input

+

6.1 Keyboard layouts

+

If your keyboard layout is non-english, or otherwise unusual, you will need to configure it, both in TTY and in Xorg.

+

Keymaps are located in /usr/share/kbd/keymaps.

+

To change the keyboard layout, edit /etc/vconsole.conf:

+ FILE: /etc/vconsole.conf +
+

KEYMAP=uk

+