From 308773a8f79886f8492c0f1b3c0921ca15ec90db Mon Sep 17 00:00:00 2001 From: Ryan O'Leary Date: Fri, 19 Jul 2019 09:02:02 -0700 Subject: [PATCH] Better formatting for table of contents This also removes the numbers from the subdirectories until the chapter numbers are more stable. Signed-off-by: Ryan O'Leary --- README.md | 65 ++++++++++--------- {7b.UEFI_Tool_Kit => UEFI_Tool_Kit}/README.md | 2 +- .../README.md | 0 .../linux-4.19.6-linuxboot.config | 0 {14.cpu => cpu}/README.md | 0 {13.dut => dut}/README.md | 0 getting_started/README.md | 7 ++ {10.u-root => u-root}/README.md | 0 8 files changed, 42 insertions(+), 32 deletions(-) rename {7b.UEFI_Tool_Kit => UEFI_Tool_Kit}/README.md (99%) rename {11.coreboot.u-root.systemboot => coreboot.u-root.systemboot}/README.md (100%) rename {11.coreboot.u-root.systemboot => coreboot.u-root.systemboot}/linux-4.19.6-linuxboot.config (100%) rename {14.cpu => cpu}/README.md (100%) rename {13.dut => dut}/README.md (100%) create mode 100644 getting_started/README.md rename {10.u-root => u-root}/README.md (100%) diff --git a/README.md b/README.md index 1178827..eacbe5b 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,39 @@ # book -LinuxBoot book which contains the documentation in markdown format +Documentation for LinuxBoot ## Table of Contents -1. Introduction -2. Getting Started in 20mins - * apt-get install qemu ovmf - * git clone github.com/linuxboot/linuxboot - * Download existing Linux bzImage - * git clone UEFIReplace - * Shell replacement -3. LinuxBoot -4. Minimal Linux kernel -5. The Initramfs: - * HEADS - * NERF -6. UEFI - * EDKII - * OVMF -7. Tools: - * UEFITool and UEFIReplace - * [UEFI Tool Kit (Ryan O'Leary and Gan Shun)](7b.UEFI_Tool_Kit/README.md) - * LinuxBoot Scripts (Trammell Hudson) - * FMAP tool -8. TPMs -9. SecureBoot and BootGuard -10. u-root - * [U-root: A Go-based, Firmware Embeddable Root File System](10.u-root/README.md) -11. [coreboot, u-root and systemboot](11.coreboot.u-root.systemboot/README.md) -12. Arm + u-boot -13. DUT, a simple Device Under Test framework [DUT, Device Under Test framework] (13.dut/README.md) -14. CPU, an ssh style command which lets you see your files from anywhere. [CPU, wherever you go, there your files are] (14.cpu/README.md) -15. [Case Studies](case_studies/README.md) -15. Conclusion +| # | Chapter | +| --- | ------- | +| 01 | Introduction | +| 02 | [Getting Started in 20mins](getting_started/README.md) | +| 03 | LinuxBoot | +| 04 | Minimal Linux Kernel | +| 05 | The Initramfs | +| 05a | ---> HEADS | +| 05b | ---> [U-root: A Go-based, Firmware Embeddable Root File System](u-root/README.md) | +| 06 | UEFI | +| 06a | ---> EDKII | +| 06b | ---> OVMF | +| 07 | Tools | +| 07a | ---> UEFITool and UEFIReplace | +| 07b | ---> [UEFI Tool Kit](UEFI_Tool_Kit/README.md) | +| 07c | ---> LinuxBoot Scripts (Trammell Hudson) | +| 07d | ---> FMAP tool | +| 08 | TPMs | +| 09 | SecureBoot and BootGuard | +| 10 | [coreboot, u-root and systemboot](coreboot.u-root.systemboot/README.md) | +| 11 | Arm + u-boot | +| 12 | [DUT, Device Under Test framework](dut/README.md) | +| 13 | [CPU, wherever you go, there your files are](cpu/README.md) | +| 14 | [Case Studies](case_studies/README.md) | + +## Acknowledgments + +* Andrea Barberio +* Johnny Lin +* Jonathan Zhang +* Philipp Deppenwiese +* Ronald Minnich +* Ryan O'Leary diff --git a/7b.UEFI_Tool_Kit/README.md b/UEFI_Tool_Kit/README.md similarity index 99% rename from 7b.UEFI_Tool_Kit/README.md rename to UEFI_Tool_Kit/README.md index 43cd148..7f46a17 100644 --- a/7b.UEFI_Tool_Kit/README.md +++ b/UEFI_Tool_Kit/README.md @@ -1,4 +1,4 @@ -## 7b: UEFI Tool Kit +## UEFI Tool Kit Authors: Ryan O'Leary, Gan Shun Lim and Andrea Barberio diff --git a/11.coreboot.u-root.systemboot/README.md b/coreboot.u-root.systemboot/README.md similarity index 100% rename from 11.coreboot.u-root.systemboot/README.md rename to coreboot.u-root.systemboot/README.md diff --git a/11.coreboot.u-root.systemboot/linux-4.19.6-linuxboot.config b/coreboot.u-root.systemboot/linux-4.19.6-linuxboot.config similarity index 100% rename from 11.coreboot.u-root.systemboot/linux-4.19.6-linuxboot.config rename to coreboot.u-root.systemboot/linux-4.19.6-linuxboot.config diff --git a/14.cpu/README.md b/cpu/README.md similarity index 100% rename from 14.cpu/README.md rename to cpu/README.md diff --git a/13.dut/README.md b/dut/README.md similarity index 100% rename from 13.dut/README.md rename to dut/README.md diff --git a/getting_started/README.md b/getting_started/README.md new file mode 100644 index 0000000..9a1a61b --- /dev/null +++ b/getting_started/README.md @@ -0,0 +1,7 @@ +# Getting Started + + * apt-get install qemu ovmf + * git clone github.com/linuxboot/linuxboot + * Download existing Linux bzImage + * git clone UEFIReplace + * Shell replacement diff --git a/10.u-root/README.md b/u-root/README.md similarity index 100% rename from 10.u-root/README.md rename to u-root/README.md