@TITLE@

+ home / docs / development / download / community / donate +

diff --git a/community.html b/community.html new file mode 100644 index 00000000..5186cbad --- /dev/null +++ b/community.html @@ -0,0 +1,75 @@ + + + + + + Alice Linux - home + + + +

home

+ home / docs / development / download / community / donate +

Come join Alice Linux community:

telegram
irc (soon)

+ + diff --git a/community/index.html b/community/index.html deleted file mode 100644 index 5765c610..00000000 --- a/community/index.html +++ /dev/null @@ -1,75 +0,0 @@ - - - - - - Alice Linux - community - - - -

community

- home / docs / development / download / iso / community / donate -

Come join Alice Linux community:

telegram
irc (soon)

- - diff --git a/docs/index.html b/docs/index.html index e55f4364..a4949053 100644 --- a/docs/index.html +++ b/docs/index.html @@ -61,7 +61,7 @@

docs

- home / docs / development / download / iso / community / donate + home / docs / development / download / community / donate

Here lies documentation for Alice Linux.

If you found any typo or error in docs, or even wan't to contribute, feel free to open issue :D

@@ -70,7 +70,7 @@

Package Manager

diff --git a/docs/install.html b/docs/install.html index df09b883..2f967850 100644 --- a/docs/install.html +++ b/docs/install.html @@ -61,7 +61,7 @@

docs

- home / docs / development / download / iso / community / donate + home / docs / development / download / community / donate

Install Alice

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.

@@ -91,25 +91,25 @@ alicelinux-rootfs-20240525.tar.xz: OK

First, chroot into Alice. (Replace /mnt/alice with your chosen mount point)

# /mnt/alice/usr/bin/apkg-chroot /mnt/alice

Any further commands after this will be executed inside the Alice environment.

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
+# echo 'export CFLAGS="-O3 -march=x86-64 -pipe"' >> /etc/apkg.conf
 
 And use whats in CFLAGS for CXXFLAGS.
-# echo 'export CXXFLAGS="$CFLAGS"' >> /etc/apkg.conf
+# 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
+# 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
+# echo 'export NINJAJOBS="6"' >> /etc/apkg.conf
 
 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
+# 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.
@@ -133,7 +133,6 @@ alicelinux-rootfs-20240525.tar.xz: OK
 Now run reposync to sync latest package templates.
 # reposync
 
- 
 After setting up our package repos, make sure apkg can find the packages. We can use apkg -s <pattern> to search for packages.
 # apkg -s sway
 swayidle
@@ -167,8 +166,8 @@ sway
 # apkg -u $(apkg -a)
 
 
-NOTE: Add the -f flag to force rebuild of existing prebuilt package.
-NOTE: apkg -a prints all installed packages on the system.
+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 or use the one provided by Alice.
@@ -207,8 +206,8 @@ sway
 
 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/<service> to /var/service to enable it; remove the symlink to disable it.
+The runit service directory is /etc/sv.
+Create a symlink from /etc/sv/<service> to /var/service to enable it; remove the symlink to disable it.
 
 Setup user and password
 Add your user.
@@ -265,7 +264,7 @@ sway
 Run updateconf to update config files in /etc after package upgrades.
 
 	

-	Copyright (C) Alice Linux, 2024
+	Copyright (C) Alice Linux, 2024-2026


 
 
diff --git a/docs/packagemanager.html b/docs/packagemanager.html
index b4978f7b..e2947fda 100644
--- a/docs/packagemanager.html
+++ b/docs/packagemanager.html
@@ -61,7 +61,7 @@


 	docs
-	home / docs / development / download / iso / community / donate
+	home / docs / development / download / community / donate
 	
 Package Manager
 In Alice, theres two package manager used, spm and autils. Why two package manager? spm was written for generic package manager for linux distribution. And autils is written specifically for Alice and required spm.
@@ -95,12 +95,16 @@ nsxiv 32-1
 (build package)
 $ ./configure --prefix=/usr
 $ make
+
 (install into fake directory)
 $ make DESTDIR=$PWD/fakeroot install
+
 (turn fake directory into package (package.spm))
 # spm -b $PWD/fakeroot 
+
 (mv 'package.spm' into correct format (name#version-release.spm))
 # mv package.spm pkgname#pkgversion-pkgrelease.spm
+
 (install package into system)
 # spm -i pkgname#pkgversion-pkgrelease.spm
 
@@ -141,7 +145,7 @@ SPM_FORCEINSTALL: set any value to ignore conflicted files
 # SPM_FORCEINSTALL=1 SPM_ROOT=/mnt/rootfs spm -i pkgname#pkgversion-pkgrelease.spm

autils

autils stands for alice utilitis. autils contains main package manager (apkg), utilities (apkg-<util>) and <random util script>. autils is specifically written to manage Alice packages.

autils stands for alice utilitis. autils contains main package manager (apkg), utilities (apkg-) and . autils is specifically written to manage Alice packages.

apkg

apkg is a main package manager that can solve dependencies, batch install/upgrade/remove packages, system upgrades, trigger necessary caches, and etc. apkg can be run inside or outside package template.

When running outside package template, apkg will need 'package names' as arguments, and those 'package names' will search through APKG_REPO environment. Example:

@@ -302,6 +306,7 @@ APKG_NOPROMPT defaults is empty, skip prompt, use any value

Usage:

(print out broken packages)
 $ revdep
+
 (verbosely print missing libraries)
 $ revdep -v

@@ -327,8 +332,10 @@ $ revdep -v

Usage:

(to remove old packages)
 # apkg-clean -p | xargs rm
+
 (to remove old sources)
 # apkg-clean -s | xargs rm
+
 (to remove both old packages and sources)
 # apkg-clean | xargs rm

@@ -342,6 +349,7 @@ $ revdep -v

Usage:

(print list foreign packages)
 $ apkg-foreign
+
 (remove foreign packages)
 # apkg -r $(apkg-foreign)

@@ -355,11 +363,12 @@ $ apkg-foreign

usage:

(print package contains redundant dependencies)
 $ apkg-redundantdeps
+
 (remove redundant dependencies for depends list)
 $ apkg-redundantdeps -f

diff --git a/docs/readme.html b/docs/readme.html new file mode 100644 index 00000000..b2d6bff8 --- /dev/null +++ b/docs/readme.html @@ -0,0 +1,72 @@ + + + + + + Alice Linux - docs + + + +

docs

+ home / docs / development / download / community / donate +

Here lies documentation for Alice Linux.

If you found any typo or error in docs, or even wan't to contribute, feel free to open issue :D

+ + diff --git a/donate.html b/donate.html new file mode 100644 index 00000000..758c1385 --- /dev/null +++ b/donate.html @@ -0,0 +1,76 @@ + + + + + + Alice Linux - home + + + +

home

+ home / docs / development / download / community / donate +

Your cups of coffee very helpful for this project :D

+ + diff --git a/donate/donate.html b/donate/donate.html deleted file mode 100644 index 7d1e7806..00000000 --- a/donate/donate.html +++ /dev/null @@ -1,76 +0,0 @@ - - - - - - Alice Linux - donate - - - -

donate

- home / docs / development / download / iso / community / donate -

Your cups of coffee very helpful for this project :D

- - diff --git a/index.html b/index.html index bc533809..313890ef 100644 --- a/index.html +++ b/index.html @@ -61,10 +61,10 @@

home

- home / docs / development / download / iso / community / donate + home / docs / development / download / community / donate

alicelinux

alicelinux +

Alice Linux is my personal daily driver minimal distro that used Clang/LLVM as main C compiler, musl as main standard libc library, libressl as main SSL/TLS and cryptographic libraries, busybox as main core utilities, package manager written in POSIX shell script, Wayland as the gui server and trying to be minimal, lightweight and usable as possible.

no systemd
libressl instead of openssl

-- cgit v1.2.3