refactoring old guides, adding wine guide

8 months ago · 7964ab15b4
5 changed files with 143 additions and 129 deletions
--- a/applications/calendar.md
+++ b/applications/calendar.md
@ -1,54 +1,47 @@
 # Calendar
 To use a terminal calendar the following programs are needed.

 | programm   | description             |
 | ---------- | ----------------------- |
 | khal       | terminal calendar       |
 | vdirsyncer | sync tool for calendars |
 `khal` is a calendar you can use in your terminal.
 To sync calendars you'll need `vdirsyncer` aswell.

 ## Installation and configuration
 To configure vdirsyncer edit a file in ```~/.config/vdirsyncer/config```.

 ```
 [general]
 status_path = "~/.cache/vdirsyncer/status"

 #calendar
 [pair private_calendar]
 a = "private_calendar_local"
 b = "private_calendar_remote"
 collections = ["from a", "from b"]
 metadata = ["color"]

 [storage private_calendar_local]
 type = "filesystem"
 path = "~/.local/share/pim/calendars/private_calendar"
 fileext = ".ics"

 [storage private_calendar_remote]
 type = "caldav"
 url = "https://<url>"
 auth = "basic"
 username = "<username>"
 password = "<password>"

 ```

 After that initialize vdirsyncer.

 ```vdirsyncer discover && vdirsyncer metasync```

 And keep regularly syncing your data (crontab).
 The command to sync is the following.

 ```vdirsyncer sync```

 Finally add a ```~/.config/khal/config``` and you're ready to go.

 ```
 [calendars]

 [[calendars]]
 path = ~/.local/share/pim/calendars/*/*
 type = discover
 ```
 - `pacman -S khal vdirsyncer` - Install needed packages

 - To configure vdirsyncer edit a file in `~/.config/vdirsyncer/config`.

 	```
 	[general]
 	status_path = "~/.cache/vdirsyncer/status"

 	#calendar
 	[pair private_calendar]
 	a = "private_calendar_local"
 	b = "private_calendar_remote"
 	collections = ["from a", "from b"]
 	metadata = ["color"]

 	[storage private_calendar_local]
 	type = "filesystem"
 	path = "~/.local/share/pim/calendars/private_calendar"
 	fileext = ".ics"

 	[storage private_calendar_remote]
 	type = "caldav"
 	url = "https://<url>"
 	auth = "basic"
 	username = "<username>"
 	password = "<password>"

 	```

 - `vdirsyncer discober && vdirsyncer metasync` - After that initialize vdirsyncer.
 - `vdirsyncer sync` - Synchronize your data (put it in a crontab to run periodically)
 - Edit the `~/.config/khal/config`
 	-	Insert the following lines
 		```
 		[calendars]

 		[[calendars]]
 		path = ~/.local/share/pim/calendars/*/*
 		type = discover
 		```
--- a/applications/contacts.md
+++ b/applications/contacts.md
@ -1,53 +1,43 @@
 # Contacts
 To use a terminal addressbook the following programs are needed.

 | programm   | description             |
 | ---------- | ----------------------- |
 | khard      | terminal addressbook    |
 | vdirsyncer | sync tool for calendars |
 `khard` is a adressbook that runs in your terminal.
 To sync the data using CardDAV you'll need `vdirsyncer` aswell.

 ## Installation and configuration
 To configure vdirsyncer edit a file in ```~/.config/vdirsyncer/config```.

 ```
 [general]
 status_path = "~/.cache/vdirsyncer/status"

 #contacts
 [pair private_contacts]
 a = "private_contacts_local"
 b = "private_contacts_remote"
 collections = ["from a", "from b"]

 [storage private_contacts_local]
 type = "filesystem"
 path = "~/.local/share/pim/contacts"
 fileext = ".vcf"

 [storage private_contacts_remote]
 type = "carddav"
 url = "https://<url>"
 username = "<username>"
 password = "<password>"
 auth = "basic"
 ```

 After that initialize vdirsyncer.

 ```vdirsyncer discover && vdirsyncer metasync```

 And keep regularly syncing your data (crontab).
 The command to sync is the following.

 ```vdirsyncer sync```

 Now you just need to add and configure the config and youre done.

 ```
 mkdir ~/.config/khard
 cp /usr/share/doc/khard/khard.conf.example ~/.config/khard/khard.conf
 ```
 - `pacman -S khard vdirsyncer` - Install needed programs
 - Edit the `~/.config/vdirsyncer/config`.
 	-	Insert the following lines:
 		```
 		[general]
 		status_path = "~/.cache/vdirsyncer/status"

 		#contacts
 		[pair private_contacts]
 		a = "private_contacts_local"
 		b = "private_contacts_remote"
 		collections = ["from a", "from b"]

 		[storage private_contacts_local]
 		type = "filesystem"
 		path = "~/.local/share/pim/contacts"
 		fileext = ".vcf"

 		[storage private_contacts_remote]
 		type = "carddav"
 		url = "https://<url>"
 		username = "<username>"
 		password = "<password>"
 		auth = "basic"
 		```
 - `vdirsyncer discover && vdirsyncer metasync` - Initialize vdirsyncer
 - `vdirsyncer sync` - Synchronize the addressbook (put this into a crontab to update periodically)
 - Add and configure a config for khard
 	- `mkdir ~/.config/khard` - add a directory for the config
 	- `cp /usr/share/doc/khard/khard.conf.example ~/.config/khard/khard.conf` - Copy the example configuration
 	- Adjust `khard.conf` to your needs

 ## Mutt

 It is possible to use your khard-addressbook in mutt.
 To see how it works check out the [Mutt](/#arch/mail.md).
--- a/applications/mail.md
+++ b/applications/mail.md
@ -1,44 +1,41 @@
 # Mutt
 These are a bunch of programs to be able to use lukesmithxyz's mutt-wizard,
 which will be able to setup your neomutt acordingly.

 | program     | description           |
 | ----------- | --------------------- |
 | neomutt     | mail program          |
 | isync       | syncs mail            |
 | msmtp       | sends mail            |
 | pass        | encrypts passwords    |
 | mutt-wizard | autoconfigure neomutt |
 Neomutt is a mail program that runs in your terminal.
 It can be easily configured using mutt-wizard.

 The mutt-wizard AUR package is slightly outdated.
 Try to use the [git version](https://github.com/LukeSmithxyz/mutt-wizard) to get the latest mutt-wizard.
 ## Installation

 ## Installation and configuration
 After the basic installation you will be able to:
 - `yay -S neomutt isync msmtp pass` - Install all dependecies
 - Install mutt-wizard from [github](https://github.com/LukeSmithxyz/mutt-wizard) (AUR is not up to date)

 ``` mw add ``` to add mailaccounts
 ## Using mutt-wizard

 ``` mw ls ``` to list existing ones
 After installation you're able to use the following commands, that will guide you through configuration.

 ``` mw pass ``` to revise passwords
 `mw add` to add mailaccounts

 ``` mw delete ``` to delete accounts
 `mw ls` to list existing ones

 ``` mw purge ``` to delete all accounts and settings
 `mw pass` to revise passwords

 ``` mw cron ``` toggle a cronjob to sync mail
 `mw delete` to delete accounts

 `mw purge` to delete all accounts and settings

 `mw cron` toggle a cronjob to sync mail

 ## Use khard in mutt
 To use your khard addressbook in mutt just add the following lines to your ```~/.config/mutt/muttrc```.

 ```
 set query_command= "khard email --parsable --search-in-source-files %s"
 bind editor <Tab> complete-query
 bind editor ^T complete
 macro index,pager A \
 	"<pipe message>khard add-email<return>" \
 	"add the sender email address to khard"
 ```

 You can just tab-complete the email-addresses.
 You can also add new ones by pressing A.

 - Edit `~/.config/mutt/muttrc`
 	-	Append the following lines.
 		```
 		set query_command= "khard email --parsable --search-in-source-files %s"
 		bind editor <Tab> complete-query
 		bind editor ^T complete
 		macro index,pager A \
 			"<pipe message>khard add-email<return>" \
 			"add the sender email address to khard"
 		```
 - You should now be able to tab-complete email-addresses in neomutt
 - You can also add new ones by pressing A

--- a/applications/tablecalculation.md
+++ b/applications/tablecalculation.md
@ -1,7 +1,23 @@
 # Tablecalculation
 These are useful programs if you want to do table calculations like csv.

 | program    | description                                      |
 | ---------- | ------------------------------------------------ |
 | sc-im      | program to write and read csv data; sc improved  |
 `sc-im` is a program to view and edit tables especially in csv-format.

 ## Installation

 - `yay -S sc-im` - Install sc-im
 - `sc-im <insert-filename>.csv` - Edit files

 ## Usage

 `sc-im` uses vim keys to move.
 You can insert text to a cell with `\` and numbers using `=`.
 You can edit existing entries with `e` for text and `E` for numbers.
 You can delete (multiple (for example `3`) rows `dr`/`d3r`, yank rows `yr`/`y3r`.
 You can delete (multiple (for example `3`) columns `dc`/`d3c`, yank rows `yc`/`y3c`.
 You can insert new rows `ir`/`i3r` or columns `ic`/`i3c`.

 ### Special numbers

 There are some functions you can use when in numbers mode.

 - `=@sum(<start-cell>:<end-cell>)` - Summarize all number-entries in the range of given cells
--- a/applications/wine.md
+++ b/applications/wine.md
@ -0,0 +1,18 @@
 # Wine

 Wine is a compatibility layer to run windows programs on linux machines.

 ## Installation and Configuration

 - Enable multilib support in pacman
 	-	`vim /etc/pacman.conf` - Uncomment the following lines
 		```
 		[multilib]
 		Include = /etc/pacman.d/mirrorlist
 		```
 - `pacman -S wine winetricks` - Install wine and configuration helper
 - Set the global variable `WINEPREFIX` to your liking, standard is `$HOME/.wine`
 - `winetricks` - run the installation of basic windows dependencies to the wine directory
 - Move the program you want to run to `$WINEPREFIX/drive_c/`
 - `winetricks sandbox` - (Optional) if you don't want wine to set up directories or files into your home directory
 - `wine $WINEPREFIX/drive_c/<insert program>` - Run the program with wine