diff options
author | Kevin O'Connor <kevin@koconnor.net> | 2025-07-27 19:43:36 -0400 |
---|---|---|
committer | Kevin O'Connor <kevin@koconnor.net> | 2025-08-06 19:15:32 -0400 |
commit | 0026c353eb4e220af29750fcf000d48faf8d4ab3 (patch) | |
tree | 45eac6147fcc214a7abdb9975c5d40c105737dc0 | |
parent | 3a05f4fa3d38a4cfbdbd67683f6614d0df5bb015 (diff) | |
download | seabios-master.zip seabios-master.tar.gz seabios-master.tar.bz2 |
Support converting the existing SeaBIOS documentation into a website
using the mkdocs tool.
Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
-rw-r--r-- | docs/_website/README | 12 | ||||
-rw-r--r-- | docs/_website/mkdocs-requirements.txt | 10 | ||||
-rw-r--r-- | docs/_website/mkdocs.yml | 62 |
3 files changed, 84 insertions, 0 deletions
diff --git a/docs/_website/README b/docs/_website/README new file mode 100644 index 0000000..59c7c70 --- /dev/null +++ b/docs/_website/README @@ -0,0 +1,12 @@ +This directory defines the https://www.seabios.org/ website. + +To test deploy the main site locally one can use commands similar to +the following: + +virtualenv ~/mkdocs-env && ~/mkdocs-env/bin/pip install -r ~/seabios/docs/_website/mkdocs-requirements.txt +cd ~/seabios && ~/mkdocs-env/bin/mkdocs serve --config-file ~/seabios/docs/_website/mkdocs.yml -a 0.0.0.0:8000 + +To build the main html run something similar to: + +virtualenv ~/mkdocs-env && ~/mkdocs-env/bin/pip install -r ~/seabios/docs/_website/mkdocs-requirements.txt +~/mkdocs-env/bin/mkdocs build -f ~/seabios/docs/_website/mkdocs.yml -d ~/seabios-site/ diff --git a/docs/_website/mkdocs-requirements.txt b/docs/_website/mkdocs-requirements.txt new file mode 100644 index 0000000..08410b1 --- /dev/null +++ b/docs/_website/mkdocs-requirements.txt @@ -0,0 +1,10 @@ +# Python virtualenv module requirements for mkdocs +jinja2==3.1.6 +mkdocs==1.2.4 +mkdocs-material==8.1.3 +mkdocs-simple-hooks==0.1.3 +mkdocs-exclude==1.0.2 +mdx-truly-sane-lists==1.3 +mdx-breakless-lists==1.0.1 +py-gfm==2.0.0 +markdown==3.7 diff --git a/docs/_website/mkdocs.yml b/docs/_website/mkdocs.yml new file mode 100644 index 0000000..d12806b --- /dev/null +++ b/docs/_website/mkdocs.yml @@ -0,0 +1,62 @@ +# Main configuration file for mkdocs generation of www.seabios.org website + +# Site and directory configuration +site_name: SeaBIOS documentation +repo_url: https://git.seabios.org/ +use_directory_urls: False +docs_dir: '../' + +# Custom markdown dialect settings +markdown_extensions: + - toc: + permalink: True + toc_depth: 6 + - attr_list + - mdx_partial_gfm + - mdx_truly_sane_lists + - mdx_breakless_lists +plugins: + search: + lang: en + +# Website layout configuration (using mkdocs-material theme) +theme: + name: material + palette: + - media: "(prefers-color-scheme: light)" + scheme: default + primary: white + accent: blue + toggle: + icon: material/lightbulb + name: Switch to dark mode + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: grey + accent: light blue + toggle: + icon: material/lightbulb-outline + name: Switch to light mode + features: + - navigation.top + - search.suggest + - search.highlight + - search.share + language: en + +# Navigation hierarchy +nav: + - Download.md + - Releases.md + - Mailinglist.md + - Developer Documentation: + - Developer_Documentation.md + - Build_overview.md + - Memory_Model.md + - Execution_and_code_flow.md + - Linking_overview.md + - Runtime_config.md + - Debugging.md + - Contributing.md + - Developer_links.md + - SeaVGABIOS.md |