From cabb0b3401dbeee5ed20179340e367e93169a2b8 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Wed, 16 Aug 2023 20:25:31 +0200
Subject: Make article names shorter

---
 content/articles/modemmanager-essentials.md | 112 ---------------------------
 content/articles/modemmanager.md            | 115 ++++++++++++++++++++++++++++
 content/articles/pacman-essentials.md       |  93 ----------------------
 content/articles/pacman.md                  |  96 +++++++++++++++++++++++
 4 files changed, 211 insertions(+), 205 deletions(-)
 delete mode 100644 content/articles/modemmanager-essentials.md
 create mode 100644 content/articles/modemmanager.md
 delete mode 100644 content/articles/pacman-essentials.md
 create mode 100644 content/articles/pacman.md

(limited to 'content')

diff --git a/content/articles/modemmanager-essentials.md b/content/articles/modemmanager-essentials.md
deleted file mode 100644
index 81eae74..0000000
--- a/content/articles/modemmanager-essentials.md
+++ /dev/null
@@ -1,112 +0,0 @@
-{
-	"title": "ModemManager essentials",
-	"subtitle": "Handling modems from the Linux command line"
-}
-
-#### Introduction
-
-The software [ModemManager][4] handles modems on Linux operating systems. It
-has the `mmcli` command line utility included which exposes its functionality.
-
-It is possible to use `mmcli` to setup mobile internet connections, make phone
-calls and send SMS.
-
-This article summarizes some basic `mmcli` commands. It was written to further
-debug the issue described in [this postmarketOS issue][5].
-
-#### Get modem summary
-
-With this command a summary about the modem is printed. It assumes just one
-connected modem (`-m any`) which should be given on nearly all devices:
-
-```
-mmcli -m any
-```
-
-#### Unlock a SIM card
-
-To actually do something with the modem it might be necessary to unlock the
-inserted SIM card:
-
-```
-# this command needs appropriate polkit authentication or root permissions
-mmcli -i "/org/freedesktop/ModemManager1/SIM/0" --pin "1234"
-```
-
-Use the SIM path listed in the summary (see section above).
-
-#### Enable modem
-
-In addition to unlocking the SIM card it is required to enable the modem:
-
-```
-# this command needs appropriate polkit authentication or root permissions
-mmcli -m any -e
-```
-
-#### List calls
-
-This command lists active, ringing, terminated and other calls:
-
-```
-mmcli -m any --voice-list-calls
-```
-
-The idea is that calls are tracked with the identifiers printed by this command
-which allows to send additional commands like accept or hangup.
-
-#### Accept a call
-
-An incoming call can be accepted like this:
-
-```
-# this command needs appropriate polkit authentication or root permissions
-mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --accept
-```
-
-#### Hangup a call
-
-Any active call can be hung up like this:
-
-```
-# this command needs appropriate polkit authentication or root permissions
-mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --hangup
-```
-
-#### Create a call
-
-To create a call one can use the following command. Take care to select the
-right phone number format. Given is an example phone number with German
-international prefix `+49`.
-
-```
-mmcli -m any --voice-create-call "number=+49123456789"
-```
-
-This command just registeres a new call. To actually start it one has to get
-its identifier with listing all calls and then start it like this:
-
-```
-# this command needs appropriate polkit authentication or root permissions
-mmcli -m any -o "/org/freedesktop/ModemManager1/Call/4" --start
-```
-
-It can be hung up like incoming calls.
-
-#### Further documentation
-
-Running `mmcli --help` and the there listed help commands provide a summary of
-all the functionality ModemManager provides. This article is just a brief
-subset of it.
-
-The [SXMO modem scripts][1] from the [SXMO project][2] helped me a lot to write
-this summary aswell as the [Chromium mmcli help page][3].
-
-Of course the [ModemManager homepage][4] is the most official entry point to
-search for further documentation.
-
-[1]: https://git.sr.ht/~mil/sxmo-utils/tree/master/item/scripts/modem
-[2]: https://sxmo.org/
-[3]: https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/debugging-3g/modem-debugging-with-mmcli/
-[4]: https://www.freedesktop.org/wiki/Software/ModemManager/
-[5]: https://gitlab.com/postmarketOS/pmaports/-/issues/2113
diff --git a/content/articles/modemmanager.md b/content/articles/modemmanager.md
new file mode 100644
index 0000000..129280c
--- /dev/null
+++ b/content/articles/modemmanager.md
@@ -0,0 +1,115 @@
+{
+	"title": "modemmanager",
+	"subtitle": "Handling modems from the Linux command line",
+	"aliases": [
+		"/articles/modemmanager-essentials"
+	]
+}
+
+#### Introduction
+
+The software [ModemManager][4] handles modems on Linux operating systems. It
+has the `mmcli` command line utility included which exposes its functionality.
+
+It is possible to use `mmcli` to setup mobile internet connections, make phone
+calls and send SMS.
+
+This article summarizes some basic `mmcli` commands. It was written to further
+debug the issue described in [this postmarketOS issue][5].
+
+#### Get modem summary
+
+With this command a summary about the modem is printed. It assumes just one
+connected modem (`-m any`) which should be given on nearly all devices:
+
+```
+mmcli -m any
+```
+
+#### Unlock a SIM card
+
+To actually do something with the modem it might be necessary to unlock the
+inserted SIM card:
+
+```
+# this command needs appropriate polkit authentication or root permissions
+mmcli -i "/org/freedesktop/ModemManager1/SIM/0" --pin "1234"
+```
+
+Use the SIM path listed in the summary (see section above).
+
+#### Enable modem
+
+In addition to unlocking the SIM card it is required to enable the modem:
+
+```
+# this command needs appropriate polkit authentication or root permissions
+mmcli -m any -e
+```
+
+#### List calls
+
+This command lists active, ringing, terminated and other calls:
+
+```
+mmcli -m any --voice-list-calls
+```
+
+The idea is that calls are tracked with the identifiers printed by this command
+which allows to send additional commands like accept or hangup.
+
+#### Accept a call
+
+An incoming call can be accepted like this:
+
+```
+# this command needs appropriate polkit authentication or root permissions
+mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --accept
+```
+
+#### Hangup a call
+
+Any active call can be hung up like this:
+
+```
+# this command needs appropriate polkit authentication or root permissions
+mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --hangup
+```
+
+#### Create a call
+
+To create a call one can use the following command. Take care to select the
+right phone number format. Given is an example phone number with German
+international prefix `+49`.
+
+```
+mmcli -m any --voice-create-call "number=+49123456789"
+```
+
+This command just registeres a new call. To actually start it one has to get
+its identifier with listing all calls and then start it like this:
+
+```
+# this command needs appropriate polkit authentication or root permissions
+mmcli -m any -o "/org/freedesktop/ModemManager1/Call/4" --start
+```
+
+It can be hung up like incoming calls.
+
+#### Further documentation
+
+Running `mmcli --help` and the there listed help commands provide a summary of
+all the functionality ModemManager provides. This article is just a brief
+subset of it.
+
+The [SXMO modem scripts][1] from the [SXMO project][2] helped me a lot to write
+this summary aswell as the [Chromium mmcli help page][3].
+
+Of course the [ModemManager homepage][4] is the most official entry point to
+search for further documentation.
+
+[1]: https://git.sr.ht/~mil/sxmo-utils/tree/master/item/scripts/modem
+[2]: https://sxmo.org/
+[3]: https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/debugging-3g/modem-debugging-with-mmcli/
+[4]: https://www.freedesktop.org/wiki/Software/ModemManager/
+[5]: https://gitlab.com/postmarketOS/pmaports/-/issues/2113
diff --git a/content/articles/pacman-essentials.md b/content/articles/pacman-essentials.md
deleted file mode 100644
index d8b65bd..0000000
--- a/content/articles/pacman-essentials.md
+++ /dev/null
@@ -1,93 +0,0 @@
-{
-	"title": "Pacman essentials",
-	"subtitle": "Arch Linux package manager explained for everyday users"
-}
-
-#### Introduction
-
-The program `pacman` is the package manager of the [Arch Linux][1]
-distribution. It should be exclusively used to install, update and remove
-software on an Arch Linux system.
-
-New Arch Linux users should be able to manage the software on their system in
-most cases with an open terminal and this article.
-
-#### Full system update
-
-Use the following command to update all the software on an Arch Linux system.
-This includes the operating system aswell as applications:
-
-```
-sudo pacman -Syu
-```
-
-If this fails because of errors related to signing keys and GPG it can be fixed
-by running this command:
-
-```
-sudo pacman -Sy archlinux-keyring && sudo pacman -Su
-```
-
-This error can be avoided by updating the system regularly.
-
-#### Package search
-
-One can search for existing packages with this command:
-
-```
-pacman -Ss <keyword>
-```
-
-`<keyword>` should be replaced by keywords like `firefox`. Furthermore the
-package search on the [Arch Linux homepage][1] in the upper right corner can be
-used.
-
-The Arch Linux wiki contains also a long [list of applications][2] which is an
-excellent place to search for needed programs by category.
-
-#### Package installation
-
-Installing a package is simple:
-
-```
-sudo pacman -S <package>
-```
-
-`<package>` should be replaced by the lower case package name found with the
-package search (see above) like `firefox` or `gimp`.
-
-If this fails because the packages cannot be retrieved via the HTTP protocol
-the error can be fixed by updating the whole system first as described above.
-
-#### Package removal
-
-The recommended command to remove a package is:
-
-```
-sudo pacman -Rs <package>
-```
-
-While `R` selects removal `s` is the recursive option. This additionally
-removes packages which were needed for the selected package to work.
-
-The recursive option is smart enough to leave a dependency on the system if it
-is needed by another explicitly installed package.
-
-#### Further documentation
-
-This page is just a little cheat sheet especially targeted at new Arch Linux
-users. The following references point to the official documentation about
-pacman:
-
-- The manual page of pacman: `man pacman` (exit with `q`)
-- Arch Wiki: [pacman][3]
-- Arch Wiki: [pacman/Tips and tricks][4]
-
-They should be consulted to get further information and should be trusted more
-than this page if in conflict with its content.
-
-
-[1]: https://archlinux.org/
-[2]: https://wiki.archlinux.org/title/List_of_applications
-[3]: https://wiki.archlinux.org/title/Pacman
-[4]: https://wiki.archlinux.org/title/Pacman/Tips_and_tricks
diff --git a/content/articles/pacman.md b/content/articles/pacman.md
new file mode 100644
index 0000000..5a193d5
--- /dev/null
+++ b/content/articles/pacman.md
@@ -0,0 +1,96 @@
+{
+	"title": "pacman",
+	"subtitle": "Arch Linux package manager explained for everyday users",
+	"aliases": [
+		"/articles/pacman-essentials"
+	]
+}
+
+#### Introduction
+
+The program `pacman` is the package manager of the [Arch Linux][1]
+distribution. It should be exclusively used to install, update and remove
+software on an Arch Linux system.
+
+New Arch Linux users should be able to manage the software on their system in
+most cases with an open terminal and this article.
+
+#### Full system update
+
+Use the following command to update all the software on an Arch Linux system.
+This includes the operating system aswell as applications:
+
+```
+sudo pacman -Syu
+```
+
+If this fails because of errors related to signing keys and GPG it can be fixed
+by running this command:
+
+```
+sudo pacman -Sy archlinux-keyring && sudo pacman -Su
+```
+
+This error can be avoided by updating the system regularly.
+
+#### Package search
+
+One can search for existing packages with this command:
+
+```
+pacman -Ss <keyword>
+```
+
+`<keyword>` should be replaced by keywords like `firefox`. Furthermore the
+package search on the [Arch Linux homepage][1] in the upper right corner can be
+used.
+
+The Arch Linux wiki contains also a long [list of applications][2] which is an
+excellent place to search for needed programs by category.
+
+#### Package installation
+
+Installing a package is simple:
+
+```
+sudo pacman -S <package>
+```
+
+`<package>` should be replaced by the lower case package name found with the
+package search (see above) like `firefox` or `gimp`.
+
+If this fails because the packages cannot be retrieved via the HTTP protocol
+the error can be fixed by updating the whole system first as described above.
+
+#### Package removal
+
+The recommended command to remove a package is:
+
+```
+sudo pacman -Rs <package>
+```
+
+While `R` selects removal `s` is the recursive option. This additionally
+removes packages which were needed for the selected package to work.
+
+The recursive option is smart enough to leave a dependency on the system if it
+is needed by another explicitly installed package.
+
+#### Further documentation
+
+This page is just a little cheat sheet especially targeted at new Arch Linux
+users. The following references point to the official documentation about
+pacman:
+
+- The manual page of pacman: `man pacman` (exit with `q`)
+- Arch Wiki: [pacman][3]
+- Arch Wiki: [pacman/Tips and tricks][4]
+
+They should be consulted to get further information and should be trusted more
+than this page if in conflict with its content.
+
+
+[1]: https://archlinux.org/
+[2]: https://wiki.archlinux.org/title/List_of_applications
+[3]: https://wiki.archlinux.org/title/Pacman
+[4]: https://wiki.archlinux.org/title/Pacman/Tips_and_tricks
-- 
cgit v1.2.3-70-g09d2