2
1
Fork 0
mirror of https://git.savannah.gnu.org/git/gnuboot.git synced 2025-01-05 15:57:40 +01:00
gnuboot/website/pages/docs/grub/index.md
Denis 'GNUtoo' Carikli 6e5e4f3421
Merge website and website-build.
Before being merged with the commit
dc6e1f32c1 ("Import website-build to
build the GNU Boot website."), website-build was a separate git
repository.

And so, even after the merge, until the commit
20d122e94a ("website-build: use website
from local git repository."), it still worked in the same way and
still downloaded the website from git.

This prevented merging the website and website-build directories
together as the GNU Boot repository also needed to be a valid Untitled
website repository as well.

Now after this commit, the website is built from the same git tree, so
we can simply adjust the build scripts to be able to move things
around.

In addition of making things more clear for contributors, it also
simplify the migration to haunt as with haunt we typically have the
haunt.cfg (and the autotools build code if needed) code in the top
directory and the markdown files in a subdirectory.

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Acked-by: Adrien 'neox' Bourmault <neox@gnu.org>
2024-06-11 20:29:47 +02:00

1.9 KiB

title x-unreviewed
GRUB payload true

Keymaps are stored in resources/grub/keymap/

You can use the ckbcomp program to generate a keymap, based on Xorg keymap files:

ckbcomp fr > frazerty

When you build GRUB from source, you can use the grub-mklayout program to create a special keymap file for GRUB. Learn how to build GRUB

When you've built GRUB, using lbmk (libreboot build system), take your kepmap file (generated by ckbcomp) and run it through grub-mklayout like so:

cat frazerty | ./grub/grub-mklayout -o frazerty.gkb

Place the newly created .gkb file under resources/grub/keymap in lbmk. When you build Libreboot, a ROM image with GRUB payload and your newly created keymap will be available under the bin/ directory. Learn how to build Libreboot ROM images

Many keymaps exist in the Libreboot build system, but sometimes you must manually tweak the file created by ckbcomp, adjusting the scan codes in that file, before converting to a GRUB keymap file. Therefore, it would be unwise to automatically add all keymaps in GRUB.

If you've added a keymap to lbmk, and it works, please submit a patch!