Files
OrcaSlicer_WIKI/mkdocs.yml
2026-03-21 12:09:47 -03:00

231 lines
12 KiB
YAML

site_name: OrcaSlicer Wiki
site_description: Official Wiki for OrcaSlicer - A powerful open source slicer for FFF (FDM) 3D Printers
site_url: https://www.orcaslicer.com/wiki
# MkDocs requires docs_dir to be a subdirectory
# The build script will handle the file structure
docs_dir: docs
site_dir: html
# Use flat URLs (page.html) instead of directory URLs (page/index.html)
use_directory_urls: false
# Theme configuration
theme:
name: material
custom_dir: overrides
logo: assets/images/OrcaSlicer.png
favicon: assets/images/OrcaSlicer.ico
features:
- navigation.instant # Enable instant loading (SPA behavior)
- navigation.instant.progress # Show progress bar on slow connections
- navigation.instant.prefetch # Preload linked pages on hover
- navigation.instant.preview # Show page preview on hover
- content.code.copy # Enables the copy-to-clipboard button
- search.suggest
- search.highlight
- navigation.path # shows breadcumb
- navigation.top # adds back to top button
- navigation.footer # adds next and previous buttons
- navigation.indexes
palette: # Automatic light/dark mode with toggle
- media: "(prefers-color-scheme)" # Auto-detect system preference
toggle:
icon: material/brightness-auto
name: Switch to light mode
- media: "(prefers-color-scheme: light)" # Light mode
scheme: default
toggle:
icon: material/weather-sunny
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)" # Dark mode
scheme: slate
toggle:
icon: material/weather-night
name: Switch to system preference
font: false # default font only pulls font with 300, 400, 400i and 700 weight
# pulled fonts with CSS method. Fonts are pulled from Google and its same for Defaut behaviour
extra_css:
- assets/stylesheets/extra.css
- https://unpkg.com/katex@0/dist/katex.min.css
extra_javascript:
- https://unpkg.com/katex@0/dist/katex.min.js
- https://unpkg.com/katex@0/dist/contrib/auto-render.min.js
- assets/javascripts/katex.js
- assets/javascripts/icon-theme.js
plugins:
- search
- gh-admonitions # converts github annotions to admonition
#- optimize # automatically optimizes images
#- git-committers: # not works # adds committers to footer # pip install mkdocs-git-committers-plugin-2
# repository: OrcaSlicer/OrcaSlicer_WIKI
# branch: main
# Markdown extensions (using built-in extensions to avoid extra dependencies)
markdown_extensions:
- tables
- toc:
permalink: true
- attr_list
- md_in_html
- admonition
- pymdownx.details # For collapsible admonitions
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.arithmatex:
generic: true
- pymdownx.highlight:
anchor_linenums: true
use_pygments: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.superfences
extra:
generator: false # hides "Made with Material for MkDocs" from footer
social: # adds links tofooter
- icon: fontawesome/brands/github
link: https://github.com/OrcaSlicer/OrcaSlicer
- icon: fontawesome/brands/discord
link: https://discord.gg/P4VE9UY9gJ
copyright: Copyright © 2022-2026 Li Jiang. All rights reserved.
# Navigation structure based on Home.md
nav:
- Home: index.md
- Calibration:
- "Adaptive Pressure Advance": "calibration/adaptive-pressure-advance-calib.md"
- "Calibration Guide": calibration/Calibration.md
- Cornering: "calibration/cornering-calib.md"
- "Flow Ratio Calibration": "calibration/flow-ratio-calib.md"
- "Input Shaping": "calibration/input-shaping-calib.md"
- "Pressure Advance": "calibration/pressure-advance-calib.md"
- "Retraction test": "calibration/retraction-calib.md"
- "Temp Calibration": "calibration/temp-calib.md"
- "Filament Tolerance Calibration": "calibration/tolerance-calib.md"
- VFA: "calibration/vfa-calib.md"
- "Max Volumetric Speed (FlowRate) Calibration": "calibration/volumetric-speed-calib.md"
- "General Settings":
- "Import and Export": "general-settings/import_export.md"
- "Keyboard Shortcuts": "general-settings/keyboard-shortcuts.md"
- "Material Settings":
- Cooling:
- "Material Cooling": material_settings/cooling/material_cooling.md
- Filament:
- "Material Basic Information": material_settings/filament/material_basic_information.md
- "Material Flow Ratio and Pressure Advance": material_settings/filament/material_flow_ratio_and_pressure_advance.md
- "Material Temperatures": material_settings/filament/material_temperatures.md
- "Material Volumetric Speed Limitation": material_settings/filament/material_volumetric_speed_limitation.md
- Multimaterial:
- "Material Multimaterial Settings": material_settings/multimaterial/material_multimaterial.md
- "Setting Overrides":
- "Material Setting Overrides": "material_settings/setting overrides/material_setting_overrides.md"
- Advanced:
- "Advanced Material Settings": material_settings/advanced/material_advanced.md
- Dependencies:
- "Material Dependencies": material_settings/dependencies/material_dependencies.md
- "Print Prepare":
- "Prepare Toolbar": print_prepare/prepare_basic.md
- "Assembly Tools": print_prepare/prepare_assembly_tools.md
- "Auto Arrange": print_prepare/prepare_auto_arrange.md
- "Auto Orientation": print_prepare/prepare_auto_orient.md
- "Brim ears Painting": print_prepare/prepare_brim_ears_painting.md
- "Color Painting": print_prepare/prepare_color_painting.md
- "Cutting Tool": print_prepare/prepare_cutting_tool.md
- Emboss: print_prepare/prepare_emboss.md
- "Mesh Boolean": print_prepare/prepare_mesh_boolean.md
- "Object Manipulation": print_prepare/prepare_object_manipulation.md
- "Object Set": print_prepare/prepare_object_set.md
- "Paint on Fuzzy Skin": print_prepare/prepare_paint_on_fuzzy_skin.md
- "Seam Painting": print_prepare/prepare_seam_painting.md
- "STL Transformation": print_prepare/prepare_stl_transformation.md
- "Support Painting": print_prepare/prepare_support_painting.md
- "Variable Layer Height": print_prepare/prepare_variable_layer_height.md
- "Print Settings":
- Multimaterial:
- "Filament for Features": print_settings/multimaterial/multimaterial_settings_filament_for_features.md
- "Flush Options": print_settings/multimaterial/multimaterial_settings_flush_options.md
- "Ooze prevention": print_settings/multimaterial/multimaterial_settings_ooze_prevention.md
- "Prime Tower": print_settings/multimaterial/multimaterial_settings_prime_tower.md
- "Multimaterial Advanced": print_settings/multimaterial/multimaterial_settings_advanced.md
- Quality:
- Bridging: print_settings/quality/quality_settings_bridging.md
- Ironing: print_settings/quality/quality_settings_ironing.md
- "Layer Height": print_settings/quality/quality_settings_layer_height.md
- "Line Width": print_settings/quality/quality_settings_line_width.md
- Overhangs: print_settings/quality/quality_settings_overhangs.md
- Precision: print_settings/quality/quality_settings_precision.md
- Seam: print_settings/quality/quality_settings_seam.md
- "Wall and surfaces": print_settings/quality/quality_settings_wall_and_surfaces.md
- "Wall Generator": print_settings/quality/quality_settings_wall_generator.md
- Speed:
- Acceleration: print_settings/speed/speed_settings_acceleration.md
- "Initial layer speed": print_settings/speed/speed_settings_initial_layer_speed.md
- "Jerk XY": print_settings/speed/speed_settings_jerk_xy.md
- "Overhang Speed": print_settings/speed/speed_settings_overhang_speed.md
- Travel: print_settings/speed/speed_settings_travel.md
- "Speed Advanced - Extrusion Rate Smoothing": print_settings/speed/speed_settings_advanced.md
- "Other layers speed": print_settings/speed/speed_settings_other_layers_speed.md
- Strength:
- Infill: print_settings/strength/strength_settings_infill.md
- "Infill rotation template metalanguage": print_settings/strength/strength_settings_infill_rotation_template_metalanguage.md
- Patterns: print_settings/strength/strength_settings_patterns.md
- "Top and Bottom Shells": print_settings/strength/strength_settings_top_bottom_shells.md
- Walls: print_settings/strength/strength_settings_walls.md
- "Strength Advanced": print_settings/strength/strength_settings_advanced.md
- Support:
- "Support Filament": print_settings/support/support_settings_filament.md
- "Support Ironing": print_settings/support/support_settings_ironing.md
- Raft: print_settings/support/support_settings_raft.md
- Support: print_settings/support/support_settings_support.md
- "Tree Support": print_settings/support/support_settings_tree.md
- "Support Advanced": print_settings/support/support_settings_advanced.md
- Others:
- Brim: print_settings/others/others_settings_brim.md
- "Fuzzy Skin": print_settings/others/others_settings_fuzzy_skin.md
- "G-Code Output": print_settings/others/others_settings_g_code_output.md
- Notes: print_settings/others/others_settings_notes.md
- "Post-Processing Scripts": print_settings/others/others_settings_post_processing_scripts.md
- Skirt: print_settings/others/others_settings_skirt.md
- "Special Mode": print_settings/others/others_settings_special_mode.md
- "Printer Settings":
- "Basic Information":
- "Printer Accessory": "printer_settings/basic information/printer_basic_information_accessory.md"
- "Adaptive Bed Mesh": "printer_settings/basic information/printer_basic_information_adaptive_bed_mesh.md"
- "Advanced Printer Settings": "printer_settings/basic information/printer_basic_information_advanced.md"
- "Cooling Fan": "printer_settings/basic information/printer_basic_information_cooling_fan.md"
- "Extruder Clearance": "printer_settings/basic information/printer_basic_information_extruder_clearance.md"
- "Printable Space": "printer_settings/basic information/printer_basic_information_printable_space.md"
- Extruder:
- "Basic Extruder Information": printer_settings/extruder/printer_extruder_basic_information.md
- Retraction: printer_settings/extruder/printer_extruder_retraction.md
- "Z Hop": printer_settings/extruder/printer_extruder_z_hop.md
- "Machine G-Code":
- "Machine G-code": "printer_settings/machine gcode/printer_machine_gcode.md"
- "Motion Ability":
- "Motion Ability": "printer_settings/motion ability/printer_motion_ability.md"
- Multimaterial:
- "Single Extruder Multi-Material Parameters": printer_settings/multimaterial/printer_multimaterial_semm_parameters.md
- "Multimaterial setup": printer_settings/multimaterial/printer_multimaterial_setup.md
- "Wipe Tower": printer_settings/multimaterial/printer_multimaterial_wipe_tower.md
- "Advanced Multi-Material Settings": printer_settings/multimaterial/printer_multimaterial_advanced.md
- "Developer Reference":
- "Localization and translation guide": "developer-reference/Localization_guide.md"
- "Placeholders Variables": "developer-reference/Built-in-placeholders-variables.md"
- "How to Build": "developer-reference/How-to-build.md"
- "Guide: Develop Profiles for OrcaSlicer": "developer-reference/How-to-create-profiles.md"
- "How to Download Pull Requests Artifacts for Testing": "developer-reference/How-to-download-PR-artifacts.md"
- "How to Test": "developer-reference/How-to-test.md"
- "How to Contribute to the Wiki": "developer-reference/How-to-wiki.md"
- "Application Structure Overview": "developer-reference/plater-sidebar-tab-combobox.md"
- "Preset and Bundle": "developer-reference/Preset-and-bundle.md"
- "Slicing Hierarchy": "developer-reference/slicing-hierarchy.md"