From 9a5c52ca0ef1b2d82f7d87b27bf957b97c6bf711 Mon Sep 17 00:00:00 2001 From: emmett1 Date: Sat, 28 Feb 2026 22:53:30 +0800 Subject: updated website --- README.md | 47 ---- buildsite.sh | 61 +++++ community.md | 4 + docs/install.md | 241 ++++++++++------- docs/packagedb.md | 330 ------------------------ docs/packagemanager.md | 160 ++++++------ docs/readme.md | 3 + docs/repos.md | 11 - donate.md | 5 + files/footer | 5 + files/header | 65 +++++ readme.md | 18 ++ website/.domains | 1 - website/assets/AliceLinux.png | Bin 550377 -> 0 bytes website/assets/AliceLinuxWhite.png | Bin 182298 -> 0 bytes website/assets/grimshot-240524-234840.png | Bin 3036116 -> 0 bytes website/build.sh | 58 ----- website/community/index.md | 4 - website/docs/header | 3 - website/docs/install.md | 320 ----------------------- website/docs/packagemanager.md | 414 ------------------------------ website/donate/donate.md | 5 - website/footer | 5 - website/header | 65 ----- website/index.md | 18 -- 25 files changed, 380 insertions(+), 1463 deletions(-) delete mode 100644 README.md create mode 100755 buildsite.sh create mode 100644 community.md delete mode 100644 docs/packagedb.md create mode 100644 docs/readme.md delete mode 100644 docs/repos.md create mode 100644 donate.md create mode 100644 files/footer create mode 100644 files/header create mode 100644 readme.md delete mode 100644 website/.domains delete mode 100644 website/assets/AliceLinux.png delete mode 100644 website/assets/AliceLinuxWhite.png delete mode 100644 website/assets/grimshot-240524-234840.png delete mode 100755 website/build.sh delete mode 100644 website/community/index.md delete mode 100644 website/docs/header delete mode 100644 website/docs/install.md delete mode 100644 website/docs/packagemanager.md delete mode 100644 website/donate/donate.md delete mode 100644 website/footer delete mode 100644 website/header delete mode 100644 website/index.md diff --git a/README.md b/README.md deleted file mode 100644 index 1618b72a..00000000 --- a/README.md +++ /dev/null @@ -1,47 +0,0 @@ -

- -

- Alice Linux is my personal daily driver minimal distro that uses musl libc, busybox as main core utilities, package manager written in POSIX shell, Wayland as the only GUI server and trying to be as minimal, lightweight and usable as possible. -

- -

Main keypoint:
-- no systemd
-- no PAM
-- no polkit
-- clang/llvm instead of gcc
-- musl instead of glibc
-- busybox instead of coreutils/util-linux/etc
-- busybox's runit instead of systemd/openrc/etc
-- libudev-zero instead of udev/eudev
-- gettext-tiny instead of gettext
-- mandoc instead of man-db
-- doas instead of sudo
-- ... (more to come)

- -

- See release page for released rootfs. -

- -

- See here for Alice live iso. -

- -

- See docs directory for installation guide and other information. -

- -

- Come join and say Hi! in here:
- Telegram -

- -

- Your cups of coffee very helpful for this project :D
- paypal | ko-fi | buymeacoffee -

\ No newline at end of file diff --git a/buildsite.sh b/buildsite.sh new file mode 100755 index 00000000..425a147c --- /dev/null +++ b/buildsite.sh @@ -0,0 +1,61 @@ +#!/bin/sh -e + +rm -rf public +mkdir -p public + +for i in $(find . -type f -name "*.html" | sed 's|^\./||'); do + dir=${i%/*} + file=${i##*/} + title=${dir##*/} + [ "$dir" = "$file" ] && { + title=home; dir= + } + mkdir -p public/$dir + echo "copy html for $i..." + { + sed "s/@TITLE@/$title/g" files/header + cat $i + cat files/footer + } > public/$dir/$file +done + +# docs +cat docs/readme.md > docs/index.md +for f in docs/*.md; do + case $f in */readme.md|*/index.md) continue;; esac + title=$(head -n1 $f) + file=${f##*/} + echo "- [$title](./${file%.md}.html)" >> docs/index.md +done + +for i in $(find . -type f -name "*.md" | sed 's|^\./||'); do + dir=${i%/*} + file=${i##*/} + title=${dir##*/} + [ "$dir" = "$file" ] && { + title=home; dir= + } + mkdir -p public/$dir + echo "generating html for $i..." + { + sed "s/@TITLE@/$title/g" files/header + cmark $i + cat files/footer + } > public/${i%.md}.html +done + +# mv readme.html to index.html +for i in $(find public -type f -name "readme.html" | sed 's|^\./||'); do + mv -n $i ${i%/*}/index.html +done + +rm -f docs/index.md + +if [ -d files ]; then + cp -ra files public/assets +fi + +echo alicelinux.emmett1.my > public/.domains +echo alicelinux.org >> public/.domains + +exit 0 diff --git a/community.md b/community.md new file mode 100644 index 00000000..4da5966e --- /dev/null +++ b/community.md @@ -0,0 +1,4 @@ +Come join Alice Linux community: + +- [telegram](https://t.me/alicelinux) +- irc (soon) diff --git a/docs/install.md b/docs/install.md index dfcc1a4e..923d76f7 100644 --- a/docs/install.md +++ b/docs/install.md @@ -1,100 +1,121 @@ -# Install Alice +Install Alice +============= -This is a guide to install Alice Linux on your computer using the chroot method. You can do this from your existing Linux distribution or from a live environment, such as Alice Live or another Linux distribution. Make sure your chosen environment has the necessary partitioning tools, filesystem tools, and extraction tools. +Here is a guide to installing Alice Linux on your computer using the chroot method. You can do this from your existing Linux distribution or from a live environment, such as Alice Live or another Linux distribution. Make sure your chosen environment has the necessary partitioning tools, filesystem tools, and extraction tools. -### Get Alice rootfs tarball +Get Alice rootfs tarball +------------------------ Download the Alice rootfs tarball from the [release](https://codeberg.org/emmett1/alicelinux/releases) page, along with its `sha256sum` file. ``` $ curl -O $ curl -O .sha256sum ``` -Verify the checksum of the Alice rootfs tarball: + +Verify the checksum of the Alice rootfs tarball. ``` $ sha256sum -c alicelinux-rootfs-20240525.tar.xz.sha256sum -``` -Make sure it prints: -``` alicelinux-rootfs-20240525.tar.xz: OK ``` -### Prepare the partition and filesystem +Prepare the partition and filesystem +------------------------------------ -Prepare the partition and filesystem of your choice. In this guide `ext4` is used as an example. +Prepare the partition and filesystem of your choice. In this guide, I will use `ext4` as an example. ``` # cfdisk /dev/sdX # mkfs.ext4 /dev/sdXY ``` -Mount your created partition somewhere. In this guide `/mnt/alice` is used as the mount point. + +Mount your created partition somewhere. In this guide, I will use `/mnt/alice` as the mount point. ``` # mkdir /mnt/alice # mount /dev/sdXY /mnt/alice ``` -### Extract the Alice rootfs tarball +Extract the Alice rootfs tarball +-------------------------------- Extract the Alice rootfs into the mounted partition. ``` $ tar xvf alicelinux-rootfs-*.tar.xz -C /mnt/alice ``` -### Enter chroot +Enter chroot +------------ -First, chroot into Alice. Replace `/mnt/alice` with your chosen mount point. +First, chroot into Alice. (Replace `/mnt/alice` with your chosen mount point) ``` # /mnt/alice/usr/bin/apkg-chroot /mnt/alice ``` -All further commands will be executed inside the Alice environment. -### Clone Alice repos +Any further commands after this will be executed inside the Alice environment. -Fetch the Alice packages repositories somewhere. I'll fetch them inside the `/var/lib` directory to keep the system clean. -``` -# cd /var/lib -# git clone --depth=1 https://codeberg.org/emmett1/alicelinux -``` -Once we have the repositories cloned, we need to configure `apkg`. `apkg` is the Alice package build system or package manager. By default, Alice does not provide an `apkg` config file (yes, `apkg` can work without a config file), but we will create one for ease of use. The `apkg` config file should be located at `/etc/apkg.conf` by default. +Configure apkg.conf +------------------- -### Configure apkg.conf +Once we have the repositories cloned, we need to configure `apkg`. `apkg` is Alice's package build system (or package manager). By default, Alice does not provide an `apkg` config file (yes, `apkg` can work without a config file), but we need to create one. The `apkg` config file should be located at `/etc/apkg.conf` by default. Let's create one. First, we set `CFLAGS` and `CXXFLAGS`. Alice base packages are built using `-O3 -march=x86-64 -pipe`. You can use these settings or change them to your preference. ``` # echo 'export CFLAGS="-O3 -march=x86-64 -pipe"' >> /etc/apkg.conf ``` -And use what is in `CFLAGS` for `CXXFLAGS`. + +And use whats in `CFLAGS` for `CXXFLAGS`. ``` # echo 'export CXXFLAGS="$CFLAGS"' >> /etc/apkg.conf ``` + Next set `MAKEFLAGS`. I will use `6` for my `8 threads` machine. ``` # echo 'export MAKEFLAGS="-j6"' >> /etc/apkg.conf ``` + I'm also going to set `NINJAJOBS` here. Without it, `ninja` will use all threads of your machine when compiling. ``` # echo 'export NINJAJOBS="6"' >> /etc/apkg.conf ``` -Next, we need to set the package build scripts path (I'll call it `package repos`) so `apkg` can find them. The `APKG_REPO` variable can accept multiple values for multiple `package repos`. -Alice provides four (4) `package repos` (at the time of this writing): `core`, `extra`, `xorg` and `wayland`: - * `core` contains all base packages - * `extra` includes other packages beyond the base - * both `xorg` and `wayland` contain packages for the GUI and their dependencies. +Next, we need to set the package's build scripts path (I'll call it `package repos`) so `apkg` can find them. The `APKG_REPO` variable can accept multiple values for multiple `package repos`. + +Alice provides two (2) `package repos` (at the time of this writing): `core` and `extra`. `core` contains all base packages, and `extra` includes other packages beyond the base. + +I'm gonna use directory `/var/lib/repos/core` and `/var/lib/repos/extra` for `core` and `extra` repos respectively. +``` +# echo 'APKG_REPO="/var/lib/repos/core /var/lib/repos/extra"' >> /etc/apkg.conf +``` + +> NOTE: All repo paths must be declared in the APKG_REPO variable, separated by a single space. + +Next, we will set up directories for `packages`, `sources`, and `work`. By default, these directories are inside the package template, but we will change them to `/var/cache/pkg`, `/var/cache/src`, and `/var/cache/work` respectively. You can change these to any location where you want to store these files. + +First, create the directories. +``` +# mkdir -p /var/cache/pkg +# mkdir -p /var/cache/src +# mkdir -p /var/cache/work +``` -First, get the absolute path of the `package repos` where we cloned them. By the way, we are still inside the `/var/lib` directory where we cloned the repo. +Then add these paths to `/etc/apkg.conf`. +``` +# echo 'APKG_PACKAGE_DIR=/var/cache/pkg' >> /etc/apkg.conf +# echo 'APKG_SOURCE_DIR=/var/cache/src' >> /etc/apkg.conf +# echo 'APKG_WORK_DIR=/var/cache/work' >> /etc/apkg.conf +``` ->NOTE: USE TAB COMPLETION! +Configure reposync.conf +----------------------- +`reposync` is a tool to sync package templates from git repositories. Add remote repos for `core` and `extra` into `/etc/reposync.conf`. The format of remote repos in `reposync.conf` is `||`. ``` -# realpath alicelinux/repos/core -/var/lib/alicelinux/repos/core -# realpath alicelinux/repos/extra -/var/lib/alicelinux/repos/extra +# echo 'https://codeberg.org/emmett1/alicelinux|core|/var/lib/repos/core' >> /etc/reposync.conf +# echo 'https://codeberg.org/emmett1/alicelinux|extra|/var/lib/repos/extra' >> /etc/reposync.conf ``` -After we have the path of our `package repos`, add it to the `APKG_REPO` variable in `/etc/apkg.conf`. + +Now run `reposync` to sync latest package templates. ``` -# echo 'APKG_REPO="/var/lib/alicelinux/repos/core /var/lib/alicelinux/repos/extra"' >> /etc/apkg.conf +# reposync ``` ->NOTE: All repo paths must be declared in the APKG_REPO variable, seperated by a single space. After setting up our `package repos`, make sure `apkg` can find the packages. We can use `apkg -s ` to search for packages. ``` @@ -104,166 +125,196 @@ swaybg swaylock sway ``` -If the output appears, then we are good to go. -Next, we will set up directories for `packages`, `sources`, and `work`. By default, these directories are inside the package template, but we will change them to `/var/cache/pkg`, `/var/cache/src`, and `/var/cache/work` respectively. You can change these to any location where you want to store these files. - -First, create the directories: +Lets combine with `-p` flags to show path or package templates. ``` -# mkdir -p /var/cache/pkg -# mkdir -p /var/cache/src -# mkdir -p /var/cache/work +# apkg -p $(apkg -s sway) +/var/lib/repos/extra/sway +/var/lib/repos/extra/swaylock +/var/lib/repos/extra/swaybg +/var/lib/repos/extra/swayidle ``` -Then add these paths to `/etc/apkg.conf`. +If the output appears, then we are good to go. + +Full system upgrade/rebuild +--------------------------- + +On the first install, we should upgrade the system first. + +Before we do, install development packages first. ``` -# echo 'APKG_PACKAGE_DIR=/var/cache/pkg' >> /etc/apkg.conf -# echo 'APKG_SOURCE_DIR=/var/cache/src' >> /etc/apkg.conf -# echo 'APKG_WORK_DIR=/var/cache/work' >> /etc/apkg.conf +# apkg -I meson cmake pkgconf libtool automake perl ``` -### Full system upgrade/rebuild -On the first install, we should upgrade the system first. -> Use uppercase `U` for a system upgrade, and lowercase `u` to upgrade a specific package. +> NOTE: use upppercase 'i' for solve dependencies, lowecase 'i' without solve dependencies. + +Now lets upgrade our system. ``` # apkg -U ``` -If you changed `CFLAGS` and `CXXFLAGS` to something other than the default, it is a good time to perform a full rebuild first. In this case, you can skip upgrading the system, because performing a full rebuild will already use the latest version in `package repos`. -> Add the `-f` flag to force rebuild of the existing prebuilt package. -> `apkg -a` prints all installed packages on the system. +> NOTE: Use uppercase `U` for a system upgrade, and lowercase `u` to upgrade a specific package of your choice. + +If you changed `CFLAGS` and `CXXFLAGS` to something other than the default, it's a good time to perform a full rebuild first. In this case, you can skip upgrading the system because performing a full rebuild will already use the latest version in `package repos`. ``` # apkg -u $(apkg -a) ``` -### Install development packages -Before installing any additional packages, we need to install development packages. -``` -# apkg -I meson cmake pkgconf libtool automake perl -``` -### Install the kernel +> NOTE: Add the `-f` flag to force rebuild of existing prebuilt package. +> NOTE: `apkg -a` prints all installed packages on the system. + +Install kernel +-------------- You can configure your own kernel from [kernel.org](https://kernel.org/) or use the one provided by Alice. -> The provided kernel will take a lot of time to compile, because many options are enabled. -If you want to use Alice's kernel, just run: +> NOTE: The provided kernel will take a lot of time to compile because many options are enabled. + +If you want to use Alice's kernel, just run. ``` # apkg -I linux ``` -### Install firmware -If your hardware requires firmware, install it using: +Install firmware +---------------- + +If your hardware requires firmware, install it using. ``` -# apkg -I linux-firmware linux-firmware-nvidia +# apkg -I linux-firmware ``` -### Install bootloader +Install bootloader +------------------ -In this guide, I'm going to use `grub` as the bootloader. Install `grub`: +In this guide, I'm going to use `grub` as the bootloader. Install `grub`. ``` # apkg -I grub ``` -Then generate grub config: + +Then generate grub config. ``` # grub-install /dev/sdX # grub-mkconfig -o /boot/grub/grub.cfg ``` -### Hostname +Hostname +-------- Change `alice` to the hostname of your choice. ``` # echo alice > /etc/hostname ``` -### File systems table Fstab +Fstab +----- -Change the partition and filesystem of your choice below: +Change the partition and filesystem of your choice below. ``` # echo '/dev/sda1 swap swap defaults 0 1' >> /etc/fstab # echo '/dev/sda2 / ext4 defaults 0 0' >> /etc/fstab ``` -### Enable runit services -Alice uses busybox's `runit` as its main service manager. Enable the required services: +Enable runit services +--------------------- + +Alice uses busybox's `runit` as its main service manager. Enable the required services. ``` # ln -s /etc/sv/tty1 /var/service # ln -s /etc/sv/tty2 /var/service # ln -s /etc/sv/tty3 /var/service ``` -I'm enabling 3 `tty` services. `tty` is required; without it, you won't be able to log in or run any commands. + +I'm enabling 3 `tty` services. `tty` is required; without it, you won't be able to log in (or run any commands). + > The runit service directory is `/etc/sv`. > Create a symlink from `/etc/sv/` to `/var/service` to enable it; remove the symlink to disable it. -### Setup user and password +Setup user and password +----------------------- -Add your user: +Add your user. ``` # adduser ``` -Add your user to the `wheel` group: + +Add your user to the `wheel` group. ``` # adduser wheel ``` -You might need to add your user to the `input` and `video` groups to start the Wayland compositor later, and the `audio` group to have working audio: + +You might need to add your user to the `input` and `video` groups to start the Wayland compositor later, and the `audio` group to have working audio. ``` # adduser input # adduser video # adduser audio ``` -### Root password +Root password +------------- -Set the password for the `root` user: +Set the password for the `root` user. ``` # passwd ``` -### Networking +Networking +---------- -You might want to set up networking before rebooting. Use `wpa_supplicant` and `dhcpcd`. +You might want to set up networking before rebooting. For wifi connection, install `wpa_supplicant`. ``` -# apkg -I wpa_supplicant dhcpcd +# apkg -I wpa_supplicant ``` -Configure your SSID: + +Configure your SSID. ``` # wpa_passphrase >> /etc/wpa_supplicant.conf ``` -Enable the service: + +Enable the service. ``` # ln -s /etc/sv/wpa_supplicant /var/service -# ln -s /etc/sv/dhcpcd /var/service ``` -### Timezone +Then configure & enable `udhcpc` service. +``` +# vi /etc/sv/udhcpc/conf +# ln -s /etc/sv/udhcpc /var/service +``` + +Timezone +-------- -Install `tzdata`: +Install `tzdata`. ``` # apkg -I tzdata ``` -Then create a symlink for your timezone to `/etc/localtime`: + +Then create a symlink for your timezone to `/etc/localtime`. ``` # ln -s /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime ``` -Alternatively, you can copy it and then uninstall `tzdata` to keep your installed packages minimal: + +Alternatively, you can copy it and then uninstall `tzdata` to keep your installed packages minimal. ``` # cp /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime # apkg -r tzdata ``` -### Reboot and enjoy! +Reboot and enjoy! +----------------- -Exit the chroot environment and unmount the Alice partition, then reboot: +Exit the chroot environment and unmount the Alice partition, then reboot. ``` # exit # umount /mnt/alice # reboot ``` -The machine is now ready for use. -## Some important notes +Some important notes +==================== -- `Alice` uses `spm` and `apkg` as its package manager and package build system. Run with the `-h` flag to see the available options. +- `Alice` uses `spm` and `apkg` as its package manager and package build system. Run with the `-h` flag to see available options. - Additional scripts are provided with the name `apkg-