aboutsummaryrefslogtreecommitdiff
path: root/docs/grub
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-20 20:26:48 -0700
committerAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-20 20:26:48 -0700
commita62fe03d3e84150e6186f57f53029d5a9abe3d7b (patch)
tree1a1276b32fcc5388165bd42b685c0d9e83380a7b /docs/grub
parent07da8fb0c7d513bc73470b69be99f1add0cb95e5 (diff)
downloadlibrebootfr-a62fe03d3e84150e6186f57f53029d5a9abe3d7b.tar.gz
librebootfr-a62fe03d3e84150e6186f57f53029d5a9abe3d7b.zip
undo breakages
Diffstat (limited to 'docs/grub')
-rw-r--r--docs/grub/index.md58
1 files changed, 35 insertions, 23 deletions
diff --git a/docs/grub/index.md b/docs/grub/index.md
index ce3aa40a..51dbdf00 100644
--- a/docs/grub/index.md
+++ b/docs/grub/index.md
@@ -1,26 +1,32 @@
-% GRUB payload
+
+GRUB payload
+============
This section relates to the GRUB payload used in libreboot.
+
- [Changing the background image in GRUB](#grub_background)
- [Setting font in GRUB](#grub_font)
- [GRUB keyboard layouts](#grub_keyboard)
- [Custom keyboard layout in GRUB](#grub_custom_keyboard)
- [UK Dvorak keyboard layout in GRUB](#grub_ukdvorak_keyboard)
+
+
Changing the background image in GRUB {#grub_background}
=====================================
Use cbfstool from libreboot\_util, or
libreboot\_src/coreboot/util/cbfstool/ if you want to build from source.
-./cbfstool yourrom.rom remove background.png -n background.png
-
+./cbfstool yourrom.rom remove background.png -n background.png\
./cbfstool yourrom.rom add -f background.png -n background.png -t raw
When you've done this, re-flash your ROM and you should have a new
background at boot time.
+
+
Setting font in GRUB (for reference) {#grub_font}
====================================
@@ -41,42 +47,40 @@ one](http://sourceforge.net/projects/dejavu/files/dejavu/2.34/dejavu-fonts-ttf-2
This is a free font that is also contained in GNU+Linux distributions
like Debian, Devuan or Parabola.
- $ cd libreboot\_src/grub
-compile grub (the build scripts info on how to do this)
-
-come back out into libreboot\_src/resources/grub:
-
- $ cd ../libreboot\_src/resources/grub/font
+**\$ cd libreboot\_src/grub**\
+compile grub (the build scripts info on how to do this)\
+come back out into libreboot\_src/resources/grub:\
+**\$ cd ../libreboot\_src/resources/grub/font**
I took Dejavu Sans Mono from dejavu (included in this version of
-libreboot) and did:
-
+libreboot) and did:\
**\$ ../../../grub/grub-mkfont -o dejavusansmono.pf2
dejavu-fonts-ttf-2.34/ttf/DejaVuSansMono.ttf**
I then added the instructions to 'gen.sh' script in grub-assemble to
include resources/grub/dejavusansmono.pf2 in all of the ROM images, at
-the root of the GRUB memdisk.
-
+the root of the GRUB memdisk.\
I then added that instructions to the grub.cfg files (to load the
-font):
-
+font):\
**loadfont (memdisk)/dejavusansmono.pf2**
+[Back to top of page](#pagetop)
+
+
+
GRUB keyboard layouts (for reference) {#grub_keyboard}
=====================================
+
Custom keyboard layout in GRUB (for reference) {#grub_custom_keyboard}
----------------------------------------------
Keymaps are stored in resources/utilities/grub-assemble/keymap/.
-Example (French Azerty):
-
- $ ckbcomp fr > frazerty
-
-Go in grub directory:
-
+Example (French Azerty):\
+**\$ ckbcomp fr > frazerty**\
+\
+Go in grub directory:\
**cat frazerty | ./grub/grub-mklayout -o frazerty.gkb**
You must make sure that the files are named keymap and keymap.gkb (where
@@ -91,6 +95,10 @@ The build scripts will automatically see this, and automatically build
ROM images with your custom layout (given the name) and include them
under bin. Example: **libreboot\_frazerty.rom**.
+[Back to top of page](#pagetop)
+
+
+
UK Dvorak keyboard layout in GRUB (for reference) {#grub_ukdvorak_keyboard}
-------------------------------------------------
@@ -98,10 +106,14 @@ ukdvorak had to be created manually, based on usdvorak. diff them (under
resources/utilities/grub-assemble/keymap/original) to see how ukdvorak
file was created
- $ cat ukdvorak | ./grub/grub-mklayout -o ukdvorak.gkb
+**\$ cat ukdvorak | ./grub/grub-mklayout -o ukdvorak.gkb**
+
+[Back to top of page](#pagetop)
+
+
-Copyright © 2014 Leah Rowe <info@minifree.org>
+Copyright © 2014 Leah Rowe <info@minifree.org>\
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative