matter/content
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New pages

Browse Source
This commit is contained in:
ngn 2024-01-16 01:14:21 +03:00
parent 9a0ff7e271
commit 71e675f283
9 changed files with 143 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
index.md
View File

@ -1,5 +1,5 @@
# A tiny GNU/Linux distribution # A tiny GNU/Linux distribution
MatterLinux is a tiny [free/libre](https://www.gnu.org/philosophy/free-sw.html) and MatterLinux is a tiny and independent [free/libre](https://www.gnu.org/philosophy/free-sw.html) and
[open source](https://opensource.com/resources/what-open-source) GNU/Linux distribution [open source](https://opensource.com/resources/what-open-source) GNU/Linux distribution
for `amd64` systems. It has its own package management system and its own package repos. for `amd64` systems. It has its own package management system and its own package repos.
All source code for MatterLinux is licensed under GPLv3 and available on the All source code for MatterLinux is licensed under GPLv3 and available on the

14
wiki/chat.md
View File

@ -1,5 +1,5 @@
If you are interested in the project and if you want to meet with other people If you are interested in the project and if you want to meet with other people
who are interested, feel free to join any of the chat rooms on the table: who are also interested, feel free to join any of the chat rooms on the table:
| Platform | Admin | Topic | Language | Link | | Platform | Admin | Topic | Language | Link |
| ------------- | ------------------------ | -------------------------- | ------------- | ------- | | ------------- | ------------------------ | -------------------------- | ------------- | ------- |
@ -8,9 +8,9 @@ who are interested, feel free to join any of the chat rooms on the table:
## Rules ## Rules
Here are the rules for all the chat rooms: Here are the rules for all the chat rooms:
1. Stay on the topic. 1. Stay on the topic
2. Be respectful to others. 2. Be respectful to others
3. No spam. 3. No spam
4. No advertising. 4. No advertising
5. No NSFW/NSFL content. 5. No NSFW/NSFL content
6. Only chat in the specified language. 6. Only chat in the specified language

6
wiki/intro.json Normal file
View File

@ -0,0 +1,6 @@
{
"id": "intro",
"title": "Introduction",
"author": "ngn",
"date": "15/01/24"
}

43
wiki/intro.md Normal file
View File

@ -0,0 +1,43 @@
So you are interested in MatterLinux? And you are 100% sure there is no
better way to spend your valuable time? Well you are in the right place!
## Related Links
- [Learn about free/libre software](https://www.gnu.org/philosophy/free-sw.html)
- [Learn about open source](https://opensource.com/resources/what-open-source)
- [Learn about GNU](https://www.gnu.org/)
- [Learn about Linux](https://kernel.org/linux.html)
## What is MatterLinux?
MatterLinux is *tiny* and independent free/libre and open source (FLOSS) GNU/Linux
distribution. It has a tiny independent packaging system and tiny independent
build tools and scripts. It supports all `amd64` (`x86_64`) systems.
## Can I install MatterLinux?
MatterLinux is a distribution designed for GNU/Linux "enthusiasts". So if you
are new to GNU/Linux, and not sure what you are doing, then you should probably
look for another distribution.
Currently it's not really possible to daily drive MatterLinux as it doesn't have
a lot of packages that you may need. Yeah, you can install it, but you cannot get
really far after the base installation. **So install MatterLinux only if**:
- ...you want to try it out
- ...you want to [contribute](/wiki/contribute)
## What do I need for the installation?
Preferably, do the installation in virtual machine. Provide the virtual machine at least
10G disk space, 1GB memory and 1 CPU. You should also have a working internet connection.
To complete the installation you need to boot from a live GNU/Linux USB/CD/DVD. To create a
live GNU/Linux USB/CD, you will need a GNU/Linux ISO. MatterLinux do provide ISOs for
installation but you can really use any GNU/Linux ISO you want.
**Note for bare metal installation:** MatterLinux ISO do **NOT** support wireless connection.
To burn the ISO to your USB/CD/DVD, you can use the `dd` command:
```
dd if=[path to ISO] of=/dev/[name of the device] bs=8M status=progress
```
## I booted from the ISO, now what?
Continue with the [installation page](/wiki/install).

15
wiki/main.md
View File

@ -7,18 +7,19 @@ don't have a link yet.
## Installation ## Installation
| Name | Description | | Name | Description |
| --------------------------- | ----------------------------------------------- | | --------------------------- | ----------------------------------------------- |
| Introduction | Learn about MatterLinux and other general stuff | | [Introduction](/wiki/intro) | Learn about MatterLinux and other general stuff |
| Installation | Learn how to install a base MatterLinux system | | Installation | Learn how to install a base MatterLinux system |
| Installation (Any% Edition) | Speedrunner edition of the Installation page | | Installation (Any% Edition) | Speedrunner edition of the Installation page |
| Post-Installation | Make your system (somewhat) usable | | Post-Installation | Make your system (somewhat) usable |
## Packaging ## Packaging
| Name | Description | | Name | Description |
| -------------------------------------- | ----------------------------------------------------- | | --------------------------------------- | ----------------------------------------------------- |
| [Repo](wiki/repo) | Learn about MatterLinux repos and how they work | | [Releases](/wiki/release) | Learn about MatterLinux release cycle |
| [Package](wiki/package) | Learn about MatterLinux packages | | [Repo](/wiki/repo) | Learn about MatterLinux repos and how they work |
| [Package Management](wiki/package_man) | Learn about MatterLinux package manager | | [Package](/wiki/package) | Learn about MatterLinux packages |
| [Mirrors](wiki/mirrors) | Discover repo mirrors and learn how you can setup one | | [Package Management](/wiki/package_man) | Learn about MatterLinux package manager |
| [Mirrors](/wiki/mirrors) | Discover repo mirrors and learn how you can setup one |
## Other ## Other
| Name | Description | | Name | Description |

2
wiki/pkg_man.json
View File

@ -2,5 +2,5 @@
"id": "package_man", "id": "package_man",
"title": "Package Management", "title": "Package Management",
"author": "ngn", "author": "ngn",
"date": "07/01/24" "date": "15/01/24"
} }

42
wiki/pkg_man.md
View File

@ -46,12 +46,12 @@ actual repo name**. Repo options are:
**IMPORTANT: DO NOT DISABLE SIGNATURE VERIFICATION IF YOU DON'T KNOW WHAT YOU ARE DOING! THERE IS NO **IMPORTANT: DO NOT DISABLE SIGNATURE VERIFICATION IF YOU DON'T KNOW WHAT YOU ARE DOING! THERE IS NO
WAY TO CONFIRM IF THE PACKAGES ARE LEGIT WITHOUT THE SIGNATURE VERIFICATION!** WAY TO CONFIRM IF THE PACKAGES ARE LEGIT WITHOUT THE SIGNATURE VERIFICATION!**
### MP\_ROOT ### Environment options
Another configuration option that you can use is the `MP_ROOT` option. Unlike the other options, `mp` also has a few other options that you specify as an environment variable.
this option is not specified in the configuration file, it's specified as an enviroment variable.
This option lets you change the target root directory. By default `mp` install all the packages to `/`, One of these is the `MP_ROOT` option. This option lets you change the target root directory.
stores all the information under the `/` etc. By changing the target root directory you can change this. By default `mp` install all the packages to `/`, stores all the information under the `/` etc.
By changing the target root directory you can change this.
For example lets say you want to install all the packages to `/tmp/testroot`. To do so, For example lets say you want to install all the packages to `/tmp/testroot`. To do so,
first you will need to setup a root file system structure inside `/tmp/testroot`: first you will need to setup a root file system structure inside `/tmp/testroot`:
@ -71,6 +71,19 @@ Now you can use `mp` with the `MP_ROOT` variable, for example:
# MP_ROOT=/tmp/testroot mp-install which # MP_ROOT=/tmp/testroot mp-install which
``` ```
Another one of these environment options is the `MP_YES` option. By default operations such as
installing packages, updating packages and removing packages will ask you to confirm the operation
using an interactive yes/no prompt. To disable this prompt and confirm all operations by default,
you can set the `MP_YES` environment variable. You can set it to whatever you want, just make sure
it's set.
`MP_NORET` is another option that you can set. By default `mp` will print the return status for each
command, you can disable this by setting `MP_NORET` to whatever you want.
The last one of these options is the `MP_QGREP` option. This option is only useful if you are using
the query command. If set, `mp` will print grep-able output for this command. Again, you can set it
to whatever you want.
### Syncing Repos ### Syncing Repos
To sync remote repo information and package lists, you can use the `mp-repo` command. After running it To sync remote repo information and package lists, you can use the `mp-repo` command. After running it
`mp` will: `mp` will:
@ -140,11 +153,26 @@ the packages, overwriting old files
overwriting the old entries. overwriting the old entries.
### Searching Packages ### Searching Packages
You can search for packages in the repos using the `mp-search` command: You can search for packages in the repos using the `mp-search` command.
For example, this command will return a list of all the packages that contain `lib`
in their name:
``` ```
# mp-search which # mp-search lib
```
After running this command, `mp` will:
1. Check all the repos for any packages that contain `lib` in the name
2. Print the package
3. Print the count of the results
### Querying packages
You can get more information about a package by querying it. For example to get
more information about the `which` package:
```
# mp-query which
``` ```
This will provide the following information about the package: This will provide the following information about the package:
- Name of the package - Name of the package
- Repo that the package is in - Repo that the package is in
- Description - Description

6
wiki/release.json Normal file
View File

@ -0,0 +1,6 @@
{
"id": "release",
"title": "Releases",
"author": "ngn",
"date": "15/01/24"
}

36
wiki/release.md Normal file
View File

@ -0,0 +1,36 @@
On this package you will find information about MatterLinux release cycle and
version numbering.
## Release Cycle
MatterLinux will make a new release once a year. A new release means every package will be updated
to a more recent version. Packages will replace the old ones,
meaning old packages will no longer be available and support for the old release will end.
If you are using an old release, you will able to update to the latest one by running a
full update using the [MatterLinux Package Manager](/wiki/package_man).
During the testing of the new release, repos for the new release will be located
at [next.matterlinux.xyz](https://next.matterlinux.xyz).
### Package Updates
Packages usually won't be updated to a more recent version during the life of a MatterLinux release,
however sometimes packages may be updated for bug fixes, security issues and minor improvements.
### ISOs and Base Archives
ISO and base archive file for a release may update before the next release to keep the
packages in these archive files and the ISOs up-to-date.
## Version Numbering
MatterLinux and all it's projects are version numbered after the year.
For example MatterLinux release for the year 2024 is versioned "MatterLinux 24".
Minor numbers may be added for other releases. For example the 2nd release of the
MatterLinux 24 ISO would be named "MatterLinux 24.01".
Similarly 15th release of the MatterLinux package manager for the year 2024
is versioned "24.14".
## Planned Release Dates
| Version | Release Date | EOL |
| -------------- | ------------ | ------- |
| MatterLinux 24 | 01/2024 | 01/2025 |
| MatterLinux 25 | 01/2025 | ??/???? |