added postgresql

templates/program.md

@@ -4,9 +4,9 @@
 
 ## Setup
 
-The /name/ program can be installed [/via GitHub/]().
+The /name/ program can be installed from source as described [/on GitHub-the official website/]().
 Alternatively many [Linux](/wiki/linux.md) [package managers](/wiki/linux/package_manager.md) 
-package /name/ in the `/package/`.
+package /name/ in the `/package/` package.
 The software can be setup via [Docker](/wiki/docker.md) with the [/docker name/ image]().
 
 ## Usage

wiki/docker/postgres.md

@@ -1,6 +1,6 @@
 # postgres
 
-This is a [Docker](/wiki/docker.md) container for a postgresql database.
+This is a [Docker](/wiki/docker.md) container for a [postgresql database](/wiki/postgresql.md).
 The official container and documentation was made by
 [Postgres](https://hub.docker.com/_/postgres).
 The Docker container is mainly used in combination with other containers.

wiki/docker/tomsquest_-_docker-radicale.md

@@ -1,6 +1,6 @@
 # tomsquest - docker-radicale
 
-This is a [Docker](/wiki/docker.md) container for a radicale CalDAV server.
+This is a [Docker](/wiki/docker.md) container for a [Radicale](/wiki/radicale.md) server.
 The official container and documentation was made by
 [tomsquest](https://hub.docker.com/r/tomsquest/docker-radicale).
 
@@ -37,7 +37,7 @@ There are some special variables to set.
 
 | Flag          | Usage                                                                  |
 | ------------- | ---------------------------------------------------------------------- |
-| `--read-only` | make radicale read-only, caldav can still be changed and used normally |
+| `--read-only` | make Radicale read-only, caldav can still be changed and used normally |
 
 ### rebuild.sh
 

wiki/libreoffice.md

@@ -0,0 +1,34 @@
+# LibreOffice
+
+[LibreOffice](https://libreoffice.org/) is a free and open-source office suite for Windows and
+Linux-based systems.
+
+## Setup
+
+The LibreOffice program can be installed from source as described
+[on the official website](https://www.libreoffice.org/about-us/source-code/).
+Alternatively many [Linux](/wiki/linux.md) [package managers](/wiki/linux/package_manager.md) 
+package LibreOffice in the `libreoffice` package.
+
+## Usage
+
+This section addresses the usage of LibreOffice.
+
+### Enable/Disable Dark Mode 
+
+To set the dark mode open `Settings` by the `Tools` tab, select `LibreOffice` and `Appearance` and
+select the correct theme for `LibreOffice Themes`.
+Sometimes - especially on [Linux systems](/wiki/linux.md) using [Wayland](/wiki/linux/wayland.md) -
+the automatic recognition may not work and the theme has to be set manually.
+
+## Troubleshooting 
+
+This section will focus on errors and the fixing of errors of /name/.
+
+### LibreOffice Not Showing Up on First Start
+
+When first starting LibreOffice may appear not to start.
+This is because problems with hardware acceleration can occur on some systems.
+It can starting the software in safe mode, navigate to the `Settings` by the `Tools` tab.
+Then select `LibreOffice` and `View` and remove the check in `Use hardware acceleration`.
+Afterwards LibreOffice can be closed and reopened without selecting the safe mode.

wiki/linux/khal.md

@@ -1,7 +1,7 @@
 # Khal
 
 [Khal](https://github.com/pimutils/khal) is a calendar you can use in your
-[terminal](/wiki/system_console.md).
+[terminal](/wiki/linux/shell.md).
 You can sync it with [vdirsyncer](vdirsyncer.md)
 
 ## Setup

wiki/linux/pdftk.md

@@ -0,0 +1,36 @@
+# pdftk
+
+[pdftk](https://gitlab.com/pdftk-java/pdftk) is a port of
+[the original PDFtk](https://www.pdflabs.com/tools/pdftk-server/) which is a
+[command-line](/wiki/linux/shell.md) tool for scripting or processing PDFs.
+
+## Setup
+
+The pdftk program can be installed from source as described
+[on GitLab](https://gitlab.com/pdftk-java/pdftk).
+Alternatively many [Linux](/wiki/linux.md) [package managers](/wiki/linux/package_manager.md) 
+package pdftk in the `pdftk`.
+
+## Usage
+
+This section addresses the usage of pdftk.
+
+### Ommit pages at the Start or End of a PDF
+
+pdftk can be used to ommit pages at the start or end of a pdf.
+This is done by the following command.
+`<input-file>` is the input file while `<output-file>` is the path the newly generated file is
+saved to.
+`<start>` is the first page to include in the output PDF document while `<end>` is the last one.
+
+```sh 
+pdftk <input-file> cat <start>-<end> output <output-file>
+```
+
+The following command saves the content of the input file `skript.pdf` from the second to the last
+page to the output file `skript-new.pdf`.
+
+```sh 
+pdftk skript.pdf cat 2-end output skript-new.pdf
+```
+

wiki/linux/shell.md

@@ -2,6 +2,7 @@
 
 A shell is a command-line interpreter that provides a command-line interface to
 interact with the many unix-like system.
+It is usually used in the [system console](/wiki/system_console.md)
 
 ## Unix Shells
 

wiki/linux/vim.md

@@ -0,0 +1,27 @@
+# VIM
+
+[VIM](https://www.vim.org/) is a highly configurable text editor.
+There are various forks off it with the most popular being [Neovim](https://neovim.io/).
+This entry only addresses VIM but due to the similarities of the forks it still can be drawn on for
+them.
+Differences of forks to the original VIM will be addressed in specific entries for the forks.
+
+## Setup
+
+The VIM program can be installed from source as described
+[on the official website/](https://www.vim.org/download.php).
+Alternatively many [Linux](/wiki/linux.md) [package managers](/wiki/linux/package_manager.md) 
+package VIM in the `vim` package.
+
+## Usage
+
+This section addresses the usage of VIM.
+
+### Manage Folding
+
+This section is based on a
+[guide from Vim From Scratch](https://www.vimfromscratch.com/articles/vim-folding).
+VIM can hide chunks of text which is called folding.
+The basic usage is as follows.
+`zf` marks a piece of text foldable and immediately folds.
+`zo` opens up a fold - so it unfolds it - and `zc` closes a fold - so it folds.

wiki/office_suite.md

@@ -0,0 +1,20 @@
+# Office Suite
+
+An office Suite are bundled programs that usually include productivity tools like word processing,
+spreadsheet editing, presentations aswell as e-mail and calendar software.
+
+## Programs
+
+There are various office suites.
+The following is a list of programs that are popular.
+
+- Microsofts Office is arguably the original office suite.
+  It includes Microsofts Excel, Word, Powerpoint and more for [Windows](/wiki/windows.md)
+- [LibreOffice](/wiki/libreoffice.md) is a free and open-source office suite for Windows and
+  Linux-based systems.
+  LibreOffice can have problems with hardware-acceleration.
+  If it doesn't start due to it being enabled, start LibreOffice in safe mode and disable it.
+- [Apaches OpenOffice](https://www.openoffice.org/) is an open-source office suite for Windows
+  and [Linux](/wiki/linux.md).
+  Most of the time this suite is not used anymore in favor for LibreOffice due to lackluster
+  development.

wiki/postgresql.md

@@ -0,0 +1,59 @@
+# PostgreSQL
+
+[PostgreSQL](https://www.postgresql.org/) is a free and open-source relational database managment
+system. 
+
+## Setup
+
+The software can be setup via [Docker](/wiki/docker.md) with the
+[postgres image](/wiki/docker/postgres.md).
+
+## Usage
+
+This section addresses the usage of PostgreSQL.
+
+### Basic Usage
+
+This section describes the basic usage and is based on a
+[blog entry on Neon](https://neon.com/postgresql/postgresql-administration/postgresql-show-tables).
+
+The following command can be used to connect to the database and is needed to be run first. 
+`<user>` is the username and `<database>` the name of the database set up for the database.
+
+```sh
+psql -U <user> -d <database>
+```
+
+Alternatively the previous command can be run without the `-d` flag and the following command can
+be run afterwards to change the current database.
+
+```sh
+\c <database>
+```
+
+Afterwards the following command can be used to show all tables in the database.
+
+```sh
+\dt
+```
+
+By appending a `+` additional information can be shown
+
+```sh
+\dt+
+```
+
+Similar to this the following command can be used to show details of a specific table `<table>`.
+
+```sh
+\d <table>
+```
+
+Here a `+` can also be appended to gain more information.
+
+```sh
+\d+ <table>
+```
+
+Finally and most importantly classic SQL statements - for example `SELECT`-statements - can be used
+too when being logged in to a database.

wiki/radicale.md

@@ -0,0 +1,86 @@
+# Radicale
+
+[Radicale](https://radicale.org/v3.html) is a free and open-source CalDAV and CardDAV server.
+
+## Setup
+
+The software can be setup via [Docker](/wiki/docker.md) with the
+[tomsquest](/wiki/docker/tomsquest_-_docker-radicale.md).
+
+## Usage
+
+This section addresses the usage of Radicale.
+
+### Push iCal File to Radicale
+
+This section is based on a
+[Reddit comment by jbnu1l](https://www.reddit.com/r/selfhosted/comments/jbnu1l/how_would_i_push_an_ics_to_a_caldav_server/).
+To push an iCal file to the Radicale server the following command can be used.
+`<user>` and `<password>` are the username and password for Radicale, while `<radicale-calendar>`
+is the link to the calendar as found on the interface of Radicale.
+`<ical-file>` is the path of the iCal file.
+
+```sh
+curl -u <user>:<password> -X PUT <radicale-calendar> --data-binary @<ical-file>
+```
+
+Similar to this a remote iCal file can be pushed to a Radicale server.
+For this it is recommended to use a small python script like the following.
+
+```py 
+#!/usr/bin/env python3
+import requests
+from icalendar import Calendar
+
+CALDAV_URL = "<radicale-calendar>/"
+USERNAME = "<user>"
+PASSWORD = "<password>"
+
+ICS_SOURCE_URL = "<link to ics file>"
+
+def upload_event(event, base_url, auth):
+    uid = str(event.get("UID"))
+    if not uid:
+        print("Event without UID skipped")
+        return
+
+    safe_uid = "".join(c if c.isalnum() or c in "-_" else "_" for c in uid)
+
+    event_url = f"{base_url}{safe_uid}.ics"
+
+    cal = Calendar()
+    cal.add("VERSION", "2.0")
+    cal.add("PRODID", "-//Custom Import//DE")
+    cal.add_component(event)
+
+    data = cal.to_ical()
+
+    head = requests.head(event_url, auth=auth)
+    exists = head.status_code == 200
+
+    resp = requests.put(event_url, data=data, auth=auth, headers={
+        "Content-Type": "text/calendar; charset=utf-8"
+    })
+
+    if resp.status_code in (200, 201, 204):
+        action = "Update" if exists else "New"
+        print(f"Done {action}: {uid}")
+    else:
+        print(f"Error for UID {uid}: {resp.status_code} {resp.text}")
+
+def main():
+    print(f"Downloading ICS-file from {ICS_SOURCE_URL} ...")
+    r = requests.get(ICS_SOURCE_URL)
+    r.raise_for_status()
+
+    gcal = Calendar.from_ical(r.content)
+
+    for component in gcal.walk():
+        if component.name == "VEVENT":
+            upload_event(component, CALDAV_URL, (USERNAME, PASSWORD))
+
+if __name__ == "__main__":
+    main()
+```
+
+By using this and a cronjob a remote calendar can be synced to a Radicale calendar.

wiki/thunderbird.md

@@ -22,6 +22,9 @@ The following is a list of useful extensions for Thunderbird.
 - "*cloud - FileLink for Nextcloud and ownCloud" is an extension which allows the easy creation and
   sharing of file links to a custom [Nextcloud](/wiki/nextcloud.md) or
   [ownCloud](/wiki/owncloud.md) instance.
+- ["CollectAddresses"](#collect-all-addresses-of-mail-account) can be used to save all addresses in
+  an account or folder to an address book.
+  This is achieved by right-clicking the account or a folder within it.
 - "Dark Reader" is an extension similar to
   [Firefox'](/wiki/firefox.md#list-of-useful-firefox-add-ons) "Dark Reader" extension that adds
   a dark mode for websites.

wiki/work.md

@@ -1,23 +0,0 @@
-# Work
-
-Work is a human activity that supports the needs of the wider community.
-It generally is viewed as contributing towards goods or services in an economy.
-
-## Programs
-
-There are various programs that can be useful in a work setting.
-The following are program types that are generally considered useful.
-
-- Office suites are an assortment programs that are similar to Microsofts Office suite.
-  - The original office programs are Microsofts Excel, Word, Powerpoint and more for
-    [Windows](/wiki/windows.md)
-  - [Apaches OpenOffice](https://www.openoffice.org/) is an open-source office suite for Windows
-    and [Linux](/wiki/linux.md).
-  - [LibreOffice](https://libreoffice.org/) is a free and open-source office suite for Windows and
-    Linux-based systems. LibreOffice can have problems with hardware-acceleration.
-    If it doesn't start due to it being enabled start LibreOffice in safe mode and disable it.
-- Time-tracking software includes programs that allow its user to track the time they spent working
-  on a specific task or project.
-  - [Watson](/wiki/linux/watson.md) is a free and open-source time-tracker that uses
-    the [command-line interface](/wiki/linux/shell.md).
-    It is designed for Linux-based systems.