Skip to content

Commit

Permalink
Updated Readme for Full Release
Browse files Browse the repository at this point in the history
  • Loading branch information
Rion96 authored Mar 21, 2017
1 parent cfdf779 commit 9ad23c9
Showing 1 changed file with 15 additions and 23 deletions.
38 changes: 15 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,28 @@
# GKey

![Differences1](https://github.com/Rion96/GKey/blob/master/TOSKeyDev2.png)
![Differences](https://raw.githubusercontent.com/Rion96/GKey/master/TOSKeyDevDone.png)

As you can see, this isn't a full implementation of a German Keyboard. I was mainly going for the most essential stuff. This is partially because some parts of the German keyboard are seriously hindering when you're coding (eg. The position of the Brackets), the fact that I do most things in English (So "öäüß" are useless) and the fact that I'm honestly just not experienced enough to get AltGr-Combos and the "<>|" Key to work since they aren't present on standard US keyboards and its scan code doesn't seem to be represented in the definition tables.
GKey is a German keyboard layout for Temple OS.
Due to restrictions, GKey has no dead keys, no "´" and uses a Beta sign (β) instead of a "ß".
Instead of the usual AltGr, the right and left Alt keys will serve as both Alt and AltGr keys as Temple OS doesn't really make use of Alt combos anyway. Instead of a "§" the 3 button will print an @ instead. You are free to change that to whatever you want.

This file only changes the definition tables in Keyboard.HC.Z, so if you don't want to go through the hassle of downloading my ISO, or my modifications aren't to your liking, you are free to make these changes yourself as well. I've provided an uncompressed version my Keyboard.HC file as a reference.

# FullGKey

![Differences2](https://github.com/Rion96/GKey/blob/master/TOSKeyDevFull.png)

I've found a way to implement the "<>|" Key.
I've also noticed that there are very few ALT Key combinations in Temple OS, so now I use the ALT keys as replacement for the
AltGr Key. This means that both ALT Keys function as both ALT and AltGr keys.
With these workarounds I've managed to create a keyboard layout very similar to the standard German keyboard layout.
Temple OS doesn't have "ß" nor does it have "´", so I had to improvise. Temple OS will display a "β", which is close enough I suppose. Instead of the "´", it will just use "\`". This accent has no dead key functionality, so I don't really see a point for these anyway, but the goal of FullGKey is to emulate the German keyboard as closely as possible.
GKey changes the Keyboard.HC.Z file which is important for changing the definitions of scan code and enabling the "<>|" Key, which doesn't exist on US keyboards. To emulate AltGr functionality, GKey will also replace your HomeKeyPlugIns.HC.Z. So if you made changes to that, I recommend you back it up.

# Installation
- Mount the .ISO.C File
- Copy Keyboard.HC.Z to your "/Kernel/SerialDev" directory
- (FullGKey only) Copy the HomeKeyPlugIns.HC.Z to your "/Home" directory
- Run BootHDIns

These commands should usually get the job done:
GKey requires a Kernel recompile.
It comes with a setup script, which should make installation on a VM fairly easy.

Here is a set of commands that should allow you to install GKey:

Cd("T:");
Copy("Keyboard.HC.Z","C:/Kernel/SerialDev");
Copy("HomeKeyPlugIns.HC.Z","C:/Home"); //FullGKey only!
Cd("C:");
BootHDIns;
#include "Setup.HC.Z";

This script automates the Kernel compilation.
If you run into problems, or you want to install GKey natively, you might have to compile the Kernel yourself:


Quick Runthrough on how to do BootHDIns on a standard VM:
Quick Runthrough on how to do BootHDIns:

Harddrive:

Expand Down

0 comments on commit 9ad23c9

Please sign in to comment.