From a015cca9f27f4a8df154e0a64c420c0b45ef1223 Mon Sep 17 00:00:00 2001 From: ngn Date: Thu, 22 Feb 2024 23:16:30 +0300 Subject: [PATCH] Updating wiki dates, adding the bugs page --- download.json | 2 +- wiki/install/install.json | 2 +- wiki/install/install.md | 16 ++++++++++++++++ wiki/install/post.json | 2 +- wiki/install/post.md | 34 ++++++++++++++++++++++++++++++++++ wiki/main.md | 1 + wiki/other/bugs.json | 6 ++++++ wiki/other/bugs.md | 26 ++++++++++++++++++++++++++ wiki/other/contribute.json | 2 +- wiki/other/contribute.md | 6 ++++-- wiki/pkg/mirrors.json | 2 +- wiki/pkg/pkg_man.json | 2 +- wiki/pkg/release.json | 2 +- wiki/pkg/repo.json | 2 +- 14 files changed, 95 insertions(+), 10 deletions(-) create mode 100644 wiki/other/bugs.json create mode 100644 wiki/other/bugs.md diff --git a/download.json b/download.json index 82c7b28..991558b 100644 --- a/download.json +++ b/download.json @@ -1,3 +1,3 @@ { - "title": "24.00" + "title": "24.01" } diff --git a/wiki/install/install.json b/wiki/install/install.json index a546171..1ec88a3 100644 --- a/wiki/install/install.json +++ b/wiki/install/install.json @@ -2,5 +2,5 @@ "id": "install", "title": "Installation", "author": "ngn", - "date": "17/01/24" + "date": "22/02/24" } diff --git a/wiki/install/install.md b/wiki/install/install.md index 6a9d879..df70483 100644 --- a/wiki/install/install.md +++ b/wiki/install/install.md @@ -102,6 +102,22 @@ Link `/etc/localtime` to your localtime zone. Timezones are located under # ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime ``` +### Setup Locales +List all the avaliable locales with `locale -a`, then place the locale you want into the +`/etc/locale.gen` file with the following format: +``` +full_locale_name UTF-8 +``` +For example: +``` +en_US.UTF-8 UTF-8 +``` +Then run the `locale-gen` command to generate all the locales. Lastly place the locale of your choice +into the `/etc/locale.conf` file, for example: +``` +# echo "LANG=en_US.UTF-8" > /etc/locale.conf +``` + ### Installing Important Packages After changing root, you can now start installing other base system packages that are not included in the release archive. diff --git a/wiki/install/post.json b/wiki/install/post.json index e15c264..b0b5ee9 100644 --- a/wiki/install/post.json +++ b/wiki/install/post.json @@ -2,5 +2,5 @@ "id": "post_install", "title": "Post-Installation", "author": "ngn", - "date": "19/01/24" + "date": "22/01/24" } diff --git a/wiki/install/post.md b/wiki/install/post.md index e548775..bff67b4 100644 --- a/wiki/install/post.md +++ b/wiki/install/post.md @@ -22,9 +22,43 @@ You can enable root login, by editing `/etc/ssh/sshd_config`: PermitRootLogin yes ``` +## Adding new users +To add a new user, use the `useradd` command: +``` +# useradd -m +``` +You may want to configure `doas` to provide root access to the new user. +To do this, install the `doas` package: +``` +# mp-install doas +``` +Then create a group named `wheel` for all the admin users: +``` +# groupadd wheel +``` +Add your user to the `wheel` group: +``` +# usermod -aG wheel +``` +Lastly edit the doas confiuration (`/etc/doas.conf`) to give access to the `wheel` group users: +``` +# echo "permit keepenv :wheel" > /etc/doas.conf +``` + ## Installing XORG Xorg can be installed using a simple wrapper package: ``` # mp-install xorg ``` Then you can use `startx` to start the `xorg-server`. + +## Installing a desktop +To easily install a desktop, you can use the `xcfg` tool: +``` +# mp-install xcfg +``` +You can then use the tool as a regular user, not that you will need access to the `doas` (or `sudo`) command +in order to use the tool: +``` +$ xcfg +``` diff --git a/wiki/main.md b/wiki/main.md index 6c17818..5c1fa42 100644 --- a/wiki/main.md +++ b/wiki/main.md @@ -22,4 +22,5 @@ edit a page or create a new page, make a [pull request](/wiki/contribute) to [co | -------------------------------- | ------------------------------------------------------- | | [Chat](/wiki/chat) | Learn how you can contact developers and users | | [Contributing](/wiki/contribute) | Learn how you can contribute to MatterLinux | +| [Bugs](/wiki/bugs) | Learn how you can report bugs/issues | | [Licensing](/wiki/licensing) | Licensing for the MatterLinux repositories and software | diff --git a/wiki/other/bugs.json b/wiki/other/bugs.json new file mode 100644 index 0000000..76ab103 --- /dev/null +++ b/wiki/other/bugs.json @@ -0,0 +1,6 @@ +{ + "id": "chat", + "title": "Chat", + "author": "ngn", + "date": "22/02/24" +} diff --git a/wiki/other/bugs.md b/wiki/other/bugs.md new file mode 100644 index 0000000..1ad5c0a --- /dev/null +++ b/wiki/other/bugs.md @@ -0,0 +1,26 @@ +As an user or a developer, reporting the bugs you find is really important +for the project. On this page you will find information about how you can report +bugs to the project. + +## Package bugs/issues +If you are having issues with a package/software, identify the repo contains the package. +You can use the `mp-query` command for this. + +After identifying the repo, visit the issue tracker for that specific repo: +- [issue tracker for the `base` repo](https://git.matterlinux.xyz/Matter/base/issues) +- [issue tracker for the `desktop` repo](https://git.matterlinux.xyz/Matter/desktop/issues) + +Using the search feature of the issue tracker, make sure that the issue has not been already reported. +There is no point at reporting the issue, if it has been already reported. Duplicate issues will be closed. + +If the issue has not been already reported, follow the "Registering to Gitea" section of the [contributing page](/wiki/contribute) +in order to create an account. Using this account you can create an issue, fill out all the required information, +and patiently wait for a response. You should provide additional details about the bug/issue when requested. + +## Tool bugs/issues +You may have issues using MatterLinux tools such as the MatterLinux Package Manager (`mp`). This issues should be reported +to the related issue tracker over on [Gitea](https://git.matterlinux.xyz/Matter). + +## Translation mistakes, spelling mistakes etc. +You do not need to create an issue for small issues such as little translation mistakes. Just contact maintainer/developers +on [XMPP](/wiki/chat). diff --git a/wiki/other/contribute.json b/wiki/other/contribute.json index f858245..a7c752a 100644 --- a/wiki/other/contribute.json +++ b/wiki/other/contribute.json @@ -2,5 +2,5 @@ "id": "contribute", "title": "Contributing", "author": "ngn", - "date": "12/01/24" + "date": "22/02/24" } diff --git a/wiki/other/contribute.md b/wiki/other/contribute.md index 237b822..d176668 100644 --- a/wiki/other/contribute.md +++ b/wiki/other/contribute.md @@ -8,7 +8,7 @@ contribute, you should register an account first. To prevent mass account creati page of Gitea is disabled. So in order to register an account, send a email to the [maintainer](mailto:ngn@ngn.tf) with the subject `Gitea Account`. Specify **at least** two usernames for your account (second one will be used for registration if the first one is unavailable). Then -wait for a reply containing further instructions. +wait for a reply containing further instructions. You can also contact the maintainer over on [XMPP](/wiki/chat). > **Important** > @@ -21,6 +21,8 @@ To report a bug, to ask questions or to request a feature, first find the relate Then head over to the issue tab. Label your issue and explain it with a simple title. Write a detailed description for the issue. Finally create the issue and patiently wait for a response. +To get more information about reporting bugs, check out [this wiki page](/wiki/bugs). + ## Pull Requests If you want to make changes and merge them to the project, first fork the related repository. Then clone the forked repository and make the changes you want. @@ -75,7 +77,7 @@ syntax on After making the changes, commit them using the following format: ``` -: +: ``` Do not use long commit messages, instead add a description to your commit if needed. **Make sure the email you are using for signing the commit matches with your Gitea account email.** diff --git a/wiki/pkg/mirrors.json b/wiki/pkg/mirrors.json index 2190600..7aceab8 100644 --- a/wiki/pkg/mirrors.json +++ b/wiki/pkg/mirrors.json @@ -2,5 +2,5 @@ "id": "mirrors", "title": "Mirrors", "author": "ngn", - "date": "12/01/24" + "date": "21/02/24" } diff --git a/wiki/pkg/pkg_man.json b/wiki/pkg/pkg_man.json index 185322b..6a0221e 100644 --- a/wiki/pkg/pkg_man.json +++ b/wiki/pkg/pkg_man.json @@ -2,5 +2,5 @@ "id": "package_man", "title": "Package Management", "author": "ngn", - "date": "15/01/24" + "date": "21/02/24" } diff --git a/wiki/pkg/release.json b/wiki/pkg/release.json index 53b8505..1671a7a 100644 --- a/wiki/pkg/release.json +++ b/wiki/pkg/release.json @@ -2,5 +2,5 @@ "id": "release", "title": "Releases", "author": "ngn", - "date": "15/01/24" + "date": "21/02/24" } diff --git a/wiki/pkg/repo.json b/wiki/pkg/repo.json index 067cdb3..14b084c 100644 --- a/wiki/pkg/repo.json +++ b/wiki/pkg/repo.json @@ -2,5 +2,5 @@ "id": "repo", "title": "Repo", "author": "ngn", - "date": "11/01/24" + "date": "21/02/24" }