Files
amd-bc250-docs/mkdocs.yml
Naster 8961369398 linux: Alpine Setup guide (#20)
New Alpine guide covering kernel selection, AMDGPU/Vulkan stack,
extlinux/GRUB kargs, and a manual SMU governor build with an
OpenRC service + D-Bus policy. Adds nav entry, README/index
mentions, and an Alpine row in the distribution comparison.
Note: the "D-Bus AccessDenied Error" troubleshooting entry is
missing its solution paragraph will follow up in a small fix
commit after merge.

Closes #20.
2026-06-01 06:59:01 -07:00

186 lines
4.7 KiB
YAML

site_name: AMD BC250 Documentation
site_description: Comprehensive documentation for the AMD BC250 board - Linux setup, BIOS configuration, troubleshooting, and community projects
site_author: BC250 Community
site_url: https://elektricM.github.io/amd-bc250-docs/
# Repository
repo_name: amd-bc250-docs
repo_url: https://github.com/elektricM/amd-bc250-docs
edit_uri: edit/main/docs/
# Copyright
# Theme
theme:
name: material
custom_dir: overrides
palette:
# Palette toggle for automatic light/dark mode
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode
# Light mode
- media: "(prefers-color-scheme: light)"
scheme: default
primary: teal
accent: cyan
toggle:
icon: material/brightness-7
name: Switch to dark mode
# Dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: teal
accent: cyan
toggle:
icon: material/brightness-4
name: Switch to system preference
features:
- navigation.instant
- navigation.instant.prefetch
- navigation.sections
- navigation.indexes
- navigation.top
- navigation.footer
- navigation.tracking
- search.suggest
- search.highlight
- search.share
- toc.follow
- content.code.copy
- content.code.annotate
- content.tabs.link
- content.action.edit
- content.action.view
- announce.dismiss
icon:
repo: fontawesome/brands/github
logo: material/chip
# Plugins
plugins:
- search:
separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
- tags
# Extensions
markdown_extensions:
- abbr
- admonition
- attr_list
- def_list
- footnotes
- md_in_html
- toc:
permalink: true
toc_depth: 3
- pymdownx.arithmatex:
generic: true
- pymdownx.betterem:
smart_enable: all
- pymdownx.caret
- pymdownx.details
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.keys
- pymdownx.magiclink:
normalize_issue_symbols: true
repo_url_shorthand: true
- pymdownx.mark
- pymdownx.smartsymbols
- pymdownx.snippets
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tabbed:
alternate_style: true
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
# Navigation
nav:
- Home: index.md
- Contribute: contribute.md
- Getting Started:
- Introduction: getting-started/introduction.md
- Quick Start: getting-started/quick-start.md
- Prerequisites: getting-started/prerequisites.md
- Hardware:
- Specifications: hardware/specifications.md
- Pinouts: hardware/pinouts.md
- Power Requirements: hardware/power.md
- Cooling Solutions: hardware/cooling.md
- Display Connectors: hardware/display.md
- BIOS & Firmware:
- BIOS Flashing Guide: bios/flashing.md
- VRAM Configuration: bios/vram.md
- Overclocking: bios/overclocking.md
- Recovery: bios/recovery.md
- Linux Setup:
- Distribution Guide: linux/distributions.md
- Fedora Setup: linux/fedora.md
- Bazzite Setup: linux/bazzite.md
- CachyOS Setup: linux/cachyos.md
- Arch Linux Setup: linux/arch.md
- Debian Setup: linux/debian.md
- Alpine Setup: linux/alpine.md
- Kernel Configuration: linux/kernel.md
- Mesa Installation: linux/mesa.md
- Drivers & Graphics:
- RADV Driver: drivers/radv.md
- Environment Variables: drivers/environment.md
- System Configuration:
- GPU Governor: system/governor.md
- 40 CU Unlock: system/40cu-unlock.md
- Sensors & Monitoring: system/sensors.md
- Power Management: system/power.md
- Gaming & Performance:
- Game Compatibility: gaming/compatibility.md
- Troubleshooting:
- Boot Problems: troubleshooting/boot.md
- Display Issues: troubleshooting/display.md
- Performance Issues: troubleshooting/performance.md
- Stability Problems: troubleshooting/stability.md
- Community:
- Cases & Enclosures: community/cases.md
- Reference:
- Quick Reference: reference/quick-reference.md
# Extra
extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/elektricM/amd-bc250-docs
- icon: fontawesome/brands/discord
link: https://discord.com/invite/uDvkhNpxRQ
version:
provider: mike
generator: false
extra_css:
- stylesheets/extra.css