Created karbs instruction page

This commit is contained in:
Kristofers Solo
2022-08-06 19:12:17 +03:00
parent e9ef11bc46
commit 6c00a089fc
16 changed files with 233 additions and 36 deletions

View File

@@ -0,0 +1,51 @@
{% extends 'layout.html' %}
{% load static %}
{% block title %} {{ title }} {% endblock %}
{% block meta %}
<link rel="stylesheet" href="{% static 'css/karbs.css' %}" />
{% endblock %}
{% block content %}
<h1>Kristofers Auto-Rice Bootsrapping Script (KARBS)</h1><hr>
<p>KARBS is an efficient shell script that will install a fully-featured tiling window manager-based system on any
<a href="https://archlinux.org/" target="_blank">Arch</a> or
<a href="https://artixlinux.org/" target="_blank">Artix</a>
Linux-based system, without any of the routine of manual post-install processes and configuration.</p>
<p>By default, KARBS installs and deploys
<a href="https://github.com/kristoferssolo/solorice" targer="_blank">my own personal dotfiles</a>.</p>
<h2>Installation</h2><hr>
<p>On any (preferrably fresh) install of an
<a href="https://archlinux.org/" target="_blank">Arch</a> or
<a href="https://artixlinux.org/" target="_blank">Artix</a>
Linux, make sure <code>curl</code> is installed and just run the following as the root user:</p>
<pre><code>curl -LO krisrofers.xyz/karbs.sh
sh karbs.sh</code></pre>
<p>Note that the KARBS scripts will not partition any drives or wipe anything, <strong>but</strong> when it deploys the dotfiles, it will overwrite any preexisting files: e.g. the KARBS .zshrc will replace your old .zshrc, etc.</p>
<h2>What does KARBS install?</h2><hr>
<p>You can check out the programs list that KARBS parses for installation <a href="https://github.com/kristoferssolo/karbs/blob/main/pkg-files/minimal-pkgs.txt" target="_blank">right here</a>!</p>
<p>Here is some idea of the programs installed:</p>
<aside>If you don't know any of these programs and this is all Greek to you, don't worry because it's all done automatically for you and you will learn as you use the system.</aside>
<ul class="list">
<li><a href="https://awesomewm.org/" target="_blank">awesome</a> - a highly configurable, next generation framework window manager for X</li>
<li>Minimalist and keyboard-centric programs for
<ul class="list">
<li>file management (<a href="https://github.com/gokcehan/lf" target="_blank">lf</a>),</li>
<li>video (<a href="https://mpv.io/" target="_blank">mpv</a>),</li>
<li>image viewer (<a href="https://github.com/nsxiv/nsxiv" target="_blank">nsxiv</a>),</li>
<li>pdf/djvu/epub reader (<a href="https://pwmt.org/projects/zathura/" target="_blank">zathura</a>).</li>
</ul>
<li>A well featured and configured shell (<a href="https://www.zsh.org/" target="_blank">zsh</a>) and other core programs.</li>
</li>
</ul>
<p>Note that making your own fork of KARBS is as easy as using your own dotfiles, making a programs file like the one above, and making any other direct changes to the script you want.</p>
{% endblock %}

41
templates/karbs/karbs.sh Executable file
View File

@@ -0,0 +1,41 @@
#!/bin/sh
echo 'Choose installation size: minimal or full'
read size
if pacman -Q paru; then
echo
else
sudo pacman -S --noconfirm rust
git clone 'https://aur.archlinux.org/paru-bin'
cd paru-bin
makepkg -si
cd ..
rm -rf paru-bin
fi
FILE = "pkg-files/$size-pkgs.txt"
if [[ -f "$FILE" ]]; then
paru -Syu --noconfirm --needed - <"pkg-files/$size-pkgs.txt"
else
curl -LO "https://raw.githubusercontent.com/kristoferssolo/karbs/main/pkg-files/$size-pkgs.txt"
paru -Syu --noconfirm --needed - <"$size-pkgs.txt"
rm "$size"-pkgs.txt
fi
mkdir -p "$HOME"/{repos,Downloads,Documents,Videos,Music,Pictures/screenshots}
git clone 'https://github.com/kristoferssolo/solorice' "$HOME/repos/solorice"
cp -rf "$HOME/repos/solorice/.config" "$HOME"
rm -rf "$HOME/.config/awesome/desktop"
touch "$HOME/.config/awesome/weather"
cp -rf "$HOME/repos/solorice/.local" "$HOME"
ln -rfs "$HOME/.config/zsh/.zshenv" "$HOME"
git clone 'https://github.com/streetturtle/awesome-wm-widgets' "$HOME/.config/awesome/awesome-wm-widgets"
chsh -s /bin/zsh
sudo chmod +s /usr/bin/reboot
echo
echo
echo -e '\033[1;31m For weather widget to work, enter API-key from https://openweathermap.org, latitude and logitude in `~/.config/awesome/weather` file, each on seperate line. \033[0m'