Commit Graph

2349 Commits

Author SHA1 Message Date
Gerwin Klein 8095d010fa copy button: narrower CSS selector
Code highlight blocks have the form

<div class="higlight"><pre><code>...

(wrapped in another div that specifies the language). The copy-button
insertion relies on the presence of the <div>. The previous CSS selector
was too loose for that, it allowed the <pre> to be a direct descendant
of any <div> at any position, so it could be

<div> <p>..</p> etc <pre><code>

which does happen when the syntax highlighter does not recognise the
language that is passed in from the code block (```lang).

This means only code blocks with recognised language will have a copy
button.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-21 09:09:53 +01:00
doomdagadiggiedahdah c1d7a92653 seL4-deps: fix link to repo-cheatsheet
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-21 09:22:34 +10:00
Gerwin Klein f454cc4dfe sel4test: make instructions linear
As #221 points out, copy/pasting the previous instructions linearly
without closely reading the text will lead to an error state (wrong
directory). Reorganise the code blocks so that they can be copy/pasted
and run step by step without running into errors. This also makes the
initial example more concrete.

Fixes #221

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-17 18:06:03 +10:00
Gerwin Klein d8613833c4 Add xxd to dependencies
Occasionally needed by elf-loader-tool.

Closes #227

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-17 16:22:12 +10:00
Gerwin Klein 662f126a94 pc99: fix QEMU spelling
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-17 09:45:30 +10:00
Gerwin Klein 203c887bae hardware: set expectations for simulation targets
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-17 09:45:30 +10:00
Gerwin Klein 5768f64e58 hardware: split pc99 into two pages
Factor out the common text into an include, but provide two separate
hardware info pages so that the sel4test instructions and other data can
be specific.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-17 09:45:30 +10:00
Ivan Velickovic 883cd15315 hw-info: fix CMake capitalisation
Signed-off-by: Ivan Velickovic <i.velickovic@unsw.edu.au>
2025-07-16 16:18:22 +10:00
Gerwin Klein 43b7baa8f1
Fix html5 validation issue
<pre>, which might be the content of "display_text" can't be a child of
<span>. Use <div> instead.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 14:43:20 +10:00
Gerwin Klein 97b62a1b78
Makefile: explicit enumeration of tutorials
The %.md: */%.md trick does apparently not work for all versions of
make.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 13:11:47 +10:00
Gerwin Klein c11f41c622
inject_backlink: make GNU sed compatible
BSD sed allows a space after -i, GNU sed does not.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 10:05:37 +10:00
Gerwin Klein 6a3efa7f58
Update PR linkcheck ignore
This file is for PR checks of "normal" markdown files in the repo.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 5faf21411c
Add .gitattributes to mark binary files
Git doesn't recognise the microkit_flow.pdf pictures as a binary file.
Add an explicit declaration for it in .gitattributes.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 3f9df643d9
Add license info to rust gitignore
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 2af6aa62fe
Update dependencies
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein e4a5c960a9
js: remove debug output
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein b453be9452
Add copy button to code block with language set
This only works for code blocks with a declared language, because those
are wrapped in a <div> and we need that diff to anchor the button.

Putting the button into <pre> would work theoretically, but triggers a
bug in Safari when he <pre> block is too wide (scrolling) and innerHTML
of the button is being set (button text disappears).

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Nick Spinale b82056a146
rust: update links after tutorial repo move
Signed-off-by: Nick Spinale <nick@nickspinale.com>
2025-07-16 09:57:32 +10:00
Gerwin Klein fe8698fe01
camkes releases: point to local manual
Point links to local manual for target reference check where possible.
This might break links when sections are removed in the manual in the
future, but we want to introduce support for hosting multiple manual
versions anyway.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein caa6c0f007
Makefile: more careful link checking
No longer ignore non-4xx status code. This will occasionally include
timeouts that are temporary, but it catches cases where the entire
domain has disappeared (like tk1som.com).

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 1d5f32d7de
Fix tk1som link
The domain no longer exists, but Colorado Engineering still has a page
for it.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 6d3125b7a0
Remove broken link
This was not caught by the link checker, because it redirects to the
internet archive, which then doesn't find content.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 80be9133e5
Fix isabelle.in.tum.de link
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:32 +10:00
Gerwin Klein 95f7ae46fd
Replace google repo installation link
Android no longer provides repo installation instructions

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein 4b3ab94d38
Update xilinx redirect links
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein 340faa762d
Remove broken ebay links
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein 386ad70e3e
rpi3: fix more broken links, refer to rpi4
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein b1ccd768ff
Make use of note/endnote env
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein ac8e892501
Retire obsolete sel4proj references
Most of the have been moved to the seL4 org.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein 21c3fc40bf
Clean up camkes-cli
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein c3a0dc8f78
test status: bottom border for line breaks
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Gerwin Klein 36097b39ad
how-to: adjust links for upstream fixes
Adjust links for seL4/sel4-tutorials#115

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale a442c17bf0
Revert "inject_backlink: base on mdbook 0.4.36 output"
This reverts commit 773056b694a60ecda45da58c06dbb5ff079fbf66.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale 18f10a838b
rust: fix Makefile for updated tutorial
The tutorial now points to external rustdoc, so downloading Microkit is
unnecessary.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale 8a50d3381f
docker: don't download Microkit
The tutorial now points to external rustdoc, so downloading Microkit is
unnecessary.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale 536c660803
docker: remove mdbook
Now that it's downloaded in the Makefile

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale bf86b1382a
Makefile: clean both Rust tutorial destinations
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:31 +10:00
Nick Spinale fc48017f11
docker: add rsync to image
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Nick Spinale 34a1b491f6
docker: refine git safe.directory
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Nick Spinale 57322e4d3c
rust: add projects/rust/tutorial to .gitignore
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 6564361708
benchmarking-gude: language and modernisation pass
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein b2436b88d8
visual camkes: adapt images for dark mode
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 9b6edb0df6
Refactor component_list; make responsive
- Refactor component_list into the two main use case: config_list and
  compopnent_list. Roadmap items and other types are no longer used with
  component_list.

- Make the lists responsive so that they display as table on large
  screens and div lists on small screens. Use colour for status value on
  small screens to distinguish for description.

- Adjust dark mode values of text-lighter to be more readable.

- Make sure config names displayed as code do not get line wrapped.
  Remove prose style for that part, because it wants to display <pre> as
  a large code block.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 89b09cb883
cards: less x padding on small screens
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 626763063c
Fix CAmkES dockerfile link
The link was broken and also pointed to the wrong file. The packages are
listed in the camkes.sh script instead.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 729ce5123d
Use relative links for preview
Absolute links do not take site.baseurl into account.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 67e47d8f37
markdown lints
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein e5d24e34e7
rust: include source pointer for other user crates
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 0f6a193d24
card layout tweaks
Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00
Gerwin Klein 442a131669
README: mdbook installation now in Makefile
Reverts commit ec86e464ca72e7081400a85666de2a5914626f8a because mdbook
is now vendored in the Makefile install to avoid conflict with any
global version.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-16 09:57:30 +10:00