Date: Wed, 04 Feb 2015 04:14:49 -0500 Subject: Documentation: implement theme, drastically improve readability --- (limited to 'docs/grub/index.html') diff --git a/docs/grub/index.html b/docs/grub/index.html index e4dd8dc..8233376 100644 --- a/docs/grub/index.html +++ b/docs/grub/index.html @@ -13,111 +13,127 @@ -

GRUB payload

- This section relates to the GRUB payload used in libreboot. -

- Or Back to main index. -

Setting font in GRUB
GRUB keyboard layouts -
- Custom keyboard layout in GRUB
- UK Dvorak keyboard layout in GRUB
-

GRUB payload

+ This section relates to the GRUB payload used in libreboot. +

+ Or Back to main index. +

Setting font in GRUB
GRUB keyboard layouts +
- Custom keyboard layout in GRUB
- UK Dvorak keyboard layout in GRUB
+

Setting font in GRUB (for reference)

You don't need to do this unless you would like to change the default font yourself. - (this is just for reference. It has already been done for you)

You don't need to do this unless you would like to change the default font yourself. + (this is just for reference. It has already been done for you)

The old font used was Unifont, and this had some missing characters: for instance, the border showed ??? characters instead of lines.

I tried DeJavu Sans Mono from this website: - dejavu-fonts.org

I tried DeJavu Sans Mono from this website: + dejavu-fonts.org

Specifically, the version that I chose was the latest at the time of writing (Saturday 21 June 2014): - this one

Specifically, the version that I chose was the latest at the time of writing (Saturday 21 June 2014): + this one

This is a free font that is also contained in GNU/Linux distributions like Trisquel or Parabola.

$ cd libreboot_src/grub
- compile grub ('build' script has the 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 ('build' script has the 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:
- $ ../../../grub/grub-mkfont -o dejavusansmono.pf2 ../../../dejavu-fonts-ttf-2.34/ttf/DejaVuSansMono.ttf

I took Dejavu Sans Mono from dejavu (included in this version of libreboot) and did:
+ $ ../../../grub/grub-mkfont -o dejavusansmono.pf2 ../../../dejavu-fonts-ttf-2.34/ttf/DejaVuSansMono.ttf

I then added the instructions to 'build' script to include resources/grub/dejavusansmono.pf2 in all of the ROM images in root of cbfs.
- I then added that instructions to the grub.cfg files (to load the font):
- loadfont (cbfsdisk)/dejavusansmono.pf2

I then added the instructions to 'build' script to include resources/grub/dejavusansmono.pf2 in all of the ROM images in root of cbfs.
+ I then added that instructions to the grub.cfg files (to load the font):
+ loadfont (cbfsdisk)/dejavusansmono.pf2

+ +

GRUB keyboard layouts (for reference)

+ +

Custom keyboard layout in GRUB (for reference)

+ Keymaps are stored in resources/utilities/grub-assemble/keymap/. +

- Keymaps are stored in resources/utilities/grub-assemble/keymap/. -

+ Example (French Azerty):
+ $ ckbcomp fr > frazerty

+ Go in grub directory:
+ cat frazerty | ./grub/grub-mklayout -o frazerty.gkb +

- 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 'keymap' can be whatever you want). +

- You must make sure that the files are named keymap and keymap.gkb (where 'keymap' can be whatever you want). -

+ Then from the above example, you would put frazerty in resources/utilities/grub-assemble/keymap/original/ and + the frazerty.gkb file goes under resources/utilities/grub-assemble/keymap/ +

- Then from the above example, you would put frazerty in resources/utilities/grub-assemble/keymap/original/ and - the frazerty.gkb file goes under resources/utilities/grub-assemble/keymap/ -

+ The scripts build and buildrom-withgrub 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. +

- The scripts build and buildrom-withgrub 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. -

+ +

UK Dvorak keyboard layout in GRUB (for reference)

+ 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 +

- 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

+ +

- Copyright © 2014 Francis Rowe <info@gluglug.org.uk>
- This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions. - A copy of the license can be found at ../license.txt. -

+ Copyright © 2014 Francis Rowe <info@gluglug.org.uk>
+ This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions. + A copy of the license can be found at ../license.txt. +

- This document is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See ../license.txt for more information. -

+ This document is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See ../license.txt for more information. +

+ +

-- cgit v0.9.1