Added pip packaging notes and guide for Debian

- Included instructions for required tools, building the package, and uploading to Test PyPI and Live PyPI.
- Added comments for clarity in the notes.

Added notes on user commands and font directories in Linux notes

- Included commands to run commands as a specific user, change user shells, and switch to a user with a specific shell.
- Added instructions for managing local and global font directories.

notes/linux.md

@@ -154,6 +154,25 @@ su - postgres
 
 This command switches to the `postgres` user with root privileges.
 
+**Run command as specific user**
+
+```bash
+sudo -u www-data somecommand and arguments
+```
+
+**Change shell of a user**
+
+```bash
+chsh -s /bin/bash www-data
+chsh -s /usr/sbin/nologin www-data
+```
+
+**Change user with specific shell**
+
+```bash
+sudo -u www-data bash
+```
+
 ## System Management
 
 **Ensure hostname or add alias**
@@ -501,10 +520,25 @@ journalctl -b | grep -i "gnome-shell"
    ```
 
 3. **Copy the Font Files to the Local Fonts Directory**:
+
+   **Local font directory**
+
    ```bash
    cp -v *.ttf ~/.local/share/fonts/
    ```
 
+   **Global font directory - Package manager managed**
+
+   ```bash
+   cp -v *.ttf /usr/share/fonts
+   ```
+
+   **Global font directory - User managed**
+
+   ```bash
+   cp -v *.ttf /usr/local/share/fonts
+   ```
+
 **Update the Font Cache**
 
 **Force a Reload of the Installed Font Cache**:

notes/pip_packaging.md

@@ -0,0 +1,120 @@
+# Pip packaging
+
+## Table of Contents
+
+- [Pip packaging](#pip-packaging)
+  - [Table of Contents](#table-of-contents)
+  - [Required Tools](#required-tools)
+  - [Credentials](#credentials)
+  - [Build the package](#build-the-package)
+  - [Upload package](#upload-package)
+    - [Upload to Test PyPI](#upload-to-test-pypi)
+    - [Upload to Live PyPI](#upload-to-live-pypi)
+
+## Required Tools
+
+Ensure that you have the necessary tools (`python3-setuptools`, `python3-wheel`, and `twine`) installed on your Debian system. You can install them using `apt`:
+
+```bash
+apt update
+apt install python3-setuptools python3-wheel twine
+```
+
+## Credentials
+
+Check if your credentials for PyPI and Test PyPI are stored in `~/.pypirc`:
+
+```bash
+cat ~/.pypirc
+```
+
+Ensure you have the correct tokens and repository configurations in this file if you plan to use token-based authentication for uploads.
+
+## Build the package
+
+Navigate to your project directory (where `setup.py` is located) and build the distribution files. This will generate both a source distribution and a wheel.
+
+```bash
+python3 setup.py sdist bdist_wheel
+```
+
+The above command will create a `dist/` folder containing `.tar.gz` and `.whl` files.
+
+## Upload package
+
+### Upload to Test PyPI
+
+To upload your package to Test PyPI (a test environment that mirrors the real PyPI), use the following command:
+
+```bash
+twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+```
+
+You can also specify a particular version of your package:
+
+```bash
+twine upload --repository-url https://test.pypi.org/legacy/ dist/MediaCurator-0.0.10*
+```
+
+You can also specify the repository from ~/.pypirc:
+
+```bash
+twine upload --repository testpypi dist/MediaCurator-0.0.10*
+```
+
+You will be prompted to enter your Test PyPI username and password.
+
+**Note:**
+
+If you're having trouble remembering your credentials, you can create or manage your account at [Test PyPI](https://test.pypi.org/account/register/).
+
+**Install the Package from Test PyPI**
+
+To test the package installation from Test PyPI, you can use the following command:
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ mediacurator
+```
+
+This command first checks Test PyPI for the package and falls back to the official PyPI for dependencies.
+
+### Upload to Live PyPI
+
+Once you are confident everything works, you can upload the package to the real PyPI using:
+
+```bash
+twine upload dist/*
+```
+
+You can also specify the version:
+
+```bash
+twine upload dist/MediaCurator-0.0.10*
+```
+
+You can also specify the repository-url:
+
+```bash
+twine upload --repository-url https://test.pypi.org/legacy/ dist/MediaCurator-0.0.10*
+```
+
+You can also specify the repository from ~/.pypirc:
+
+```bash
+twine upload --repository mediacurator dist/MediaCurator-0.0.10*
+```
+
+Ensure your PyPI token is configured or provide it directly during the upload:
+
+```bash
+twine upload -u __token__ -p <your-testpypi-token> dist/MediaCurator-0.0.10*
+```
+
+You will need your credentials for your PyPI account, which you can create/manage at [PyPI](https://pypi.org/account/register/).
+
+---
+
+**Notes**
+
+- Ensure your version numbers are updated in `setup.py` before uploading a new package version.
+- Always test your package thoroughly using Test PyPI before uploading to the live PyPI to avoid breaking releases.