more wip
skullY
skullydazed
parent
d1c18086d2
commit
5b14456082
228
docs/_summary.md
228
docs/_summary.md
|
|
@ -1,125 +1,133 @@
|
||||||
* [Complete Newbs Guide](newbs.md)
|
* Complete Newbs Guide
|
||||||
* [Introduction](newbs_getting_started.md)
|
* [Introduction](newbs.md)
|
||||||
|
* [Getting Started](newbs_getting_started.md)
|
||||||
* [Building Your First Firmware](newbs_building_firmware.md)
|
* [Building Your First Firmware](newbs_building_firmware.md)
|
||||||
* [Flashing Firmware](newbs_flashing.md)
|
* [Flashing Firmware](newbs_flashing.md)
|
||||||
* [Testing and Debugging](newbs_testing_debugging.md)
|
* [Testing and Debugging](newbs_testing_debugging.md)
|
||||||
* [Getting Help](getting_started_getting_help.md)
|
* [Getting Help](getting_started_getting_help.md)
|
||||||
|
|
||||||
* Guides
|
* Breaking Changes
|
||||||
* [ARM Debugging Guide](arm_debugging.md)
|
* [Overview](breaking_changes.md)
|
||||||
* [Best Git Practices](newbs_git_best_practices.md)
|
|
||||||
* [Contributing to QMK](contributing.md)
|
|
||||||
* [Customizing Functionality](custom_quantum_functions.md)
|
|
||||||
* [Github Best Practices](getting_started_github.md)
|
|
||||||
* [Hand Wiring Guide](hand_wire.md)
|
|
||||||
* [ISP Flashing Guide](isp_flashing_guide.md)
|
|
||||||
* [Flashing Firmware](flashing.md)
|
|
||||||
* [Keymap Overview](keymap.md)
|
|
||||||
* [Learning Resources](newbs_learn_more_resources.md)
|
|
||||||
* [QMK CLI](cli.md)
|
|
||||||
* [Vagrant Guide](getting_started_vagrant.md)
|
|
||||||
|
|
||||||
* [Breaking Changes](breaking_changes.md)
|
|
||||||
* [My Pull Request Was Flagged](breaking_changes_instructions.md)
|
* [My Pull Request Was Flagged](breaking_changes_instructions.md)
|
||||||
* [2019 Aug 30](ChangeLog/20190830.md)
|
* History
|
||||||
|
* [2019 Aug 30](ChangeLog/20190830.md)
|
||||||
|
|
||||||
* [FAQ](faq.md)
|
* FAQs
|
||||||
* [General FAQ](faq_general.md)
|
* [General FAQ](faq_general.md)
|
||||||
* [Build/Compile QMK](faq_build.md)
|
* [Build/Compile QMK](faq_build.md)
|
||||||
* [Debugging/Troubleshooting QMK](faq_debug.md)
|
* [Debugging/Troubleshooting QMK](faq_debug.md)
|
||||||
* [Keymap](faq_keymap.md)
|
* [Keymap](faq_keymap.md)
|
||||||
* [Driver Installation with Zadig](driver_installation_zadig.md)
|
* [Driver Installation with Zadig](driver_installation_zadig.md)
|
||||||
|
|
||||||
* QMK Features
|
* Using QMK
|
||||||
* [Keycodes](keycodes.md)
|
|
||||||
* [Basic Keycodes](keycodes_basic.md)
|
|
||||||
* [US ANSI Shifted Keys](keycodes_us_ansi_shifted.md)
|
|
||||||
* [Quantum Keycodes](quantum_keycodes.md)
|
|
||||||
* [Advanced Keycodes](feature_advanced_keycodes.md)
|
|
||||||
* [Auto Shift](feature_auto_shift.md)
|
|
||||||
* Software Features
|
|
||||||
* [Combos](feature_combo.md)
|
|
||||||
* [Command](feature_command.md)
|
|
||||||
* [Debounce API](feature_debounce_type.md)
|
|
||||||
* [Dynamic Macros](feature_dynamic_macros.md)
|
|
||||||
* [Grave Escape](feature_grave_esc.md)
|
|
||||||
* [Key Lock](feature_key_lock.md)
|
|
||||||
* [Leader Key](feature_leader_key.md)
|
|
||||||
* [Macros](feature_macros.md)
|
|
||||||
* [Mouse Keys](feature_mouse_keys.md)
|
|
||||||
* [One Shot Keys](feature_advanced_keycodes.md#one-shot-keys)
|
|
||||||
* [Pointing Device](feature_pointing_device.md)
|
|
||||||
* [Space Cadet](feature_space_cadet.md)
|
|
||||||
* [Swap Hands](feature_swap_hands.md)
|
|
||||||
* [Tap Dance](feature_tap_dance.md)
|
|
||||||
* [Terminal](feature_terminal.md)
|
|
||||||
* [Unicode](feature_unicode.md)
|
|
||||||
* [Userspace](feature_userspace.md)
|
|
||||||
* Hardware Features
|
|
||||||
* [Audio](feature_audio.md)
|
|
||||||
* [Backlight](feature_backlight.md)
|
|
||||||
* [Bluetooth](feature_bluetooth.md)
|
|
||||||
* [Bootmagic](feature_bootmagic.md)
|
|
||||||
* [Custom Matrix](custom_matrix.md)
|
|
||||||
* [DIP Switch](feature_dip_switch.md)
|
|
||||||
* [Encoders](feature_encoders.md)
|
|
||||||
* [Haptic Feedback](feature_haptic_feedback.md)
|
|
||||||
* [HD44780 LCD Controller](feature_hd44780.md)
|
|
||||||
* [LED Matrix](feature_led_matrix.md)
|
|
||||||
* [OLED Driver](feature_oled_driver.md)
|
|
||||||
* [Proton C Conversion](proton_c_conversion.md)
|
|
||||||
* [PS/2 Mouse](feature_ps2_mouse.md)
|
|
||||||
* [RGB Lighting](feature_rgblight.md)
|
|
||||||
* [RGB Matrix](feature_rgb_matrix.md)
|
|
||||||
* [Split Keyboard](feature_split_keyboard.md)
|
|
||||||
* [Stenography](feature_stenography.md)
|
|
||||||
* [Thermal Printer](feature_thermal_printer.md)
|
|
||||||
* [Velocikey](feature_velocikey.md)
|
|
||||||
|
|
||||||
* QMK Reference
|
|
||||||
* [Config Options](config_options.md)
|
|
||||||
* [Make Documentation](getting_started_make_guide.md)
|
|
||||||
* [Documentation Best Practices](documentation_best_practices.md)
|
|
||||||
* [Documentation Templates](documentation_templates.md)
|
|
||||||
* [Glossary](reference_glossary.md)
|
|
||||||
* [Community Layouts](feature_layouts.md)
|
|
||||||
* [Unit Testing](unit_testing.md)
|
|
||||||
* [Useful Functions](ref_functions.md)
|
|
||||||
* [Configurator Support](reference_configurator_support.md)
|
|
||||||
* [info.json Format](reference_info_json.md)
|
|
||||||
|
|
||||||
* C Development
|
|
||||||
* [AVR Processors](hardware_avr.md)
|
|
||||||
* [Coding Conventions](coding_conventions_c.md)
|
|
||||||
* [Compatible Microcontrollers](compatible_microcontrollers.md)
|
|
||||||
* [Drivers](hardware_drivers.md)
|
|
||||||
* [ADC Driver](adc_driver.md)
|
|
||||||
* [I2C Driver](i2c_driver.md)
|
|
||||||
* [WS2812 Driver](ws2812_driver.md)
|
|
||||||
* [EEPROM Driver](eeprom_driver.md)
|
|
||||||
* [GPIO Controls](internals_gpio_control.md)
|
|
||||||
* [Keyboard Guidelines](hardware_keyboard_guidelines.md)
|
|
||||||
|
|
||||||
* Python Development
|
|
||||||
* [Coding Conventions](coding_conventions_python.md)
|
|
||||||
* [QMK CLI Config](cli_configuration.md)
|
|
||||||
* [Python CLI Development](cli_development.md)
|
|
||||||
|
|
||||||
* For a Deeper Understanding
|
|
||||||
* [How Keyboards Work](how_keyboards_work.md)
|
|
||||||
* [Understanding QMK](understanding_qmk.md)
|
|
||||||
|
|
||||||
* Other Topics
|
|
||||||
* [Using Eclipse with QMK](other_eclipse.md)
|
|
||||||
* [Using VSCode with QMK](other_vscode.md)
|
|
||||||
* [Support](support.md)
|
* [Support](support.md)
|
||||||
* [Translating the QMK Docs](translating.md)
|
* Guides
|
||||||
|
* [ARM Debugging Guide](arm_debugging.md)
|
||||||
|
* [Best Git Practices](newbs_git_best_practices.md)
|
||||||
|
* [Contributing to QMK](contributing.md)
|
||||||
|
* [Customizing Functionality](custom_quantum_functions.md)
|
||||||
|
* [Github Best Practices](getting_started_github.md)
|
||||||
|
* [Hand Wiring Guide](hand_wire.md)
|
||||||
|
* [ISP Flashing Guide](isp_flashing_guide.md)
|
||||||
|
* [Flashing Firmware](flashing.md)
|
||||||
|
* [Keymap Overview](keymap.md)
|
||||||
|
* [Learning Resources](newbs_learn_more_resources.md)
|
||||||
|
* [QMK CLI](cli.md)
|
||||||
|
* [Vagrant Guide](getting_started_vagrant.md)
|
||||||
|
|
||||||
* QMK Internals (In Progress)
|
* QMK Features
|
||||||
* [Defines](internals_defines.md)
|
* [Keycodes](keycodes.md)
|
||||||
* [Input Callback Reg](internals_input_callback_reg.md)
|
* [Basic Keycodes](keycodes_basic.md)
|
||||||
* [Midi Device](internals_midi_device.md)
|
* [US ANSI Shifted Keys](keycodes_us_ansi_shifted.md)
|
||||||
* [Midi Device Setup Process](internals_midi_device_setup_process.md)
|
* [Quantum Keycodes](quantum_keycodes.md)
|
||||||
* [Midi Util](internals_midi_util.md)
|
* [Advanced Keycodes](feature_advanced_keycodes.md)
|
||||||
* [Send Functions](internals_send_functions.md)
|
* [Auto Shift](feature_auto_shift.md)
|
||||||
* [Sysex Tools](internals_sysex_tools.md)
|
|
||||||
|
* Software Features
|
||||||
|
* [Combos](feature_combo.md)
|
||||||
|
* [Command](feature_command.md)
|
||||||
|
* [Debounce API](feature_debounce_type.md)
|
||||||
|
* [Dynamic Macros](feature_dynamic_macros.md)
|
||||||
|
* [Grave Escape](feature_grave_esc.md)
|
||||||
|
* [Key Lock](feature_key_lock.md)
|
||||||
|
* [Leader Key](feature_leader_key.md)
|
||||||
|
* [Macros](feature_macros.md)
|
||||||
|
* [Mouse Keys](feature_mouse_keys.md)
|
||||||
|
* [One Shot Keys](feature_advanced_keycodes.md#one-shot-keys)
|
||||||
|
* [Pointing Device](feature_pointing_device.md)
|
||||||
|
* [Space Cadet](feature_space_cadet.md)
|
||||||
|
* [Swap Hands](feature_swap_hands.md)
|
||||||
|
* [Tap Dance](feature_tap_dance.md)
|
||||||
|
* [Terminal](feature_terminal.md)
|
||||||
|
* [Unicode](feature_unicode.md)
|
||||||
|
* [Userspace](feature_userspace.md)
|
||||||
|
|
||||||
|
* Hardware Features
|
||||||
|
* [Audio](feature_audio.md)
|
||||||
|
* [Backlight](feature_backlight.md)
|
||||||
|
* [Bluetooth](feature_bluetooth.md)
|
||||||
|
* [Bootmagic](feature_bootmagic.md)
|
||||||
|
* [Custom Matrix](custom_matrix.md)
|
||||||
|
* [DIP Switch](feature_dip_switch.md)
|
||||||
|
* [Encoders](feature_encoders.md)
|
||||||
|
* [Haptic Feedback](feature_haptic_feedback.md)
|
||||||
|
* [HD44780 LCD Controller](feature_hd44780.md)
|
||||||
|
* [LED Matrix](feature_led_matrix.md)
|
||||||
|
* [OLED Driver](feature_oled_driver.md)
|
||||||
|
* [Proton C Conversion](proton_c_conversion.md)
|
||||||
|
* [PS/2 Mouse](feature_ps2_mouse.md)
|
||||||
|
* [RGB Lighting](feature_rgblight.md)
|
||||||
|
* [RGB Matrix](feature_rgb_matrix.md)
|
||||||
|
* [Split Keyboard](feature_split_keyboard.md)
|
||||||
|
* [Stenography](feature_stenography.md)
|
||||||
|
* [Thermal Printer](feature_thermal_printer.md)
|
||||||
|
* [Velocikey](feature_velocikey.md)
|
||||||
|
|
||||||
|
* Other Topics
|
||||||
|
* [Using Eclipse with QMK](other_eclipse.md)
|
||||||
|
* [Using VSCode with QMK](other_vscode.md)
|
||||||
|
|
||||||
|
|
||||||
|
* Developing QMK
|
||||||
|
* QMK Reference
|
||||||
|
* [Translating the QMK Docs](translating.md)
|
||||||
|
* [Config Options](config_options.md)
|
||||||
|
* [Make Documentation](getting_started_make_guide.md)
|
||||||
|
* [Documentation Best Practices](documentation_best_practices.md)
|
||||||
|
* [Documentation Templates](documentation_templates.md)
|
||||||
|
* [Glossary](reference_glossary.md)
|
||||||
|
* [Community Layouts](feature_layouts.md)
|
||||||
|
* [Unit Testing](unit_testing.md)
|
||||||
|
* [Useful Functions](ref_functions.md)
|
||||||
|
* [Configurator Support](reference_configurator_support.md)
|
||||||
|
* [info.json Format](reference_info_json.md)
|
||||||
|
|
||||||
|
* C Development
|
||||||
|
* [AVR Processors](hardware_avr.md)
|
||||||
|
* [Coding Conventions](coding_conventions_c.md)
|
||||||
|
* [Compatible Microcontrollers](compatible_microcontrollers.md)
|
||||||
|
* [Drivers](hardware_drivers.md)
|
||||||
|
* [ADC Driver](adc_driver.md)
|
||||||
|
* [I2C Driver](i2c_driver.md)
|
||||||
|
* [WS2812 Driver](ws2812_driver.md)
|
||||||
|
* [EEPROM Driver](eeprom_driver.md)
|
||||||
|
* [GPIO Controls](internals_gpio_control.md)
|
||||||
|
* [Keyboard Guidelines](hardware_keyboard_guidelines.md)
|
||||||
|
|
||||||
|
* Python Development
|
||||||
|
* [Coding Conventions](coding_conventions_python.md)
|
||||||
|
* [QMK CLI Config](cli_configuration.md)
|
||||||
|
* [Python CLI Development](cli_development.md)
|
||||||
|
|
||||||
|
* For a Deeper Understanding
|
||||||
|
* [How Keyboards Work](how_keyboards_work.md)
|
||||||
|
* [Understanding QMK](understanding_qmk.md)
|
||||||
|
|
||||||
|
* QMK Internals (In Progress)
|
||||||
|
* [Defines](internals_defines.md)
|
||||||
|
* [Input Callback Reg](internals_input_callback_reg.md)
|
||||||
|
* [Midi Device](internals_midi_device.md)
|
||||||
|
* [Midi Device Setup Process](internals_midi_device_setup_process.md)
|
||||||
|
* [Midi Util](internals_midi_util.md)
|
||||||
|
* [Send Functions](internals_send_functions.md)
|
||||||
|
* [Sysex Tools](internals_sysex_tools.md)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
# Frequently Asked Questions
|
|
||||||
|
|
||||||
* [General](faq_general.md)
|
|
||||||
* [Building or Compiling QMK](faq_build.md)
|
|
||||||
* [Debugging and Troubleshooting QMK](faq_debug.md)
|
|
||||||
* [Keymap](faq_keymap.md)
|
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
# Introduction
|
# Getting Started
|
||||||
|
|
||||||
Your computer keyboard has a processor inside of it, not unlike the one inside your computer. This processor runs software that is responsible for detecting button presses and sending reports about the state of the keyboard when buttons are pressed or released. QMK fills the role of that software, detecting button presses and passing that information on to the host computer. When you build your custom keymap, you are creating the equivalent of an executable program for your keyboard.
|
Your computer keyboard has a processor inside of it, not unlike the one inside your computer. This processor runs software that is responsible for detecting button presses and sending reports about the state of the keyboard when buttons are pressed or released. QMK fills the role of that software, detecting button presses and passing that information on to the host computer. When you build your custom keymap, you are creating the equivalent of an executable program for your keyboard.
|
||||||
|
|
||||||
QMK tries to put a lot of power into your hands by making easy things easy, and hard things possible. You don't have to know how to program to create powerful keymaps — you only have to follow a few simple syntax rules.
|
QMK tries to put a lot of power into your hands by making easy things easy, and hard things possible. You don't have to know how to program to create powerful keymaps — you only have to follow a few simple syntax rules.
|
||||||
|
|
||||||
# Getting Started
|
# Prerequisites
|
||||||
|
|
||||||
Before you can build keymaps, you need to install some software and set up your build environment. This only has to be done once no matter how many keyboards you plan to compile firmware for.
|
Before you can build keymaps, you need to install some software and set up your build environment. This only has to be done once no matter how many keyboards you plan to compile firmware for.
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue