Qmk_firmware: Need documentation about international layouts

[skullydazed]

We have a lot of users who come into discord to ask about how to work with international layouts. We should write a page documenting how that works.

• Short description how letters appear when you type. switch -> scancode -> computer -> language mapping -> letter on screen
• Explain that due to historical reasons US ANSI is the "default"
• Explain how to use language specific includes in quantum/keymap_extras

[ThomDietrich]

Hello,
as a fresh Ergodox owner located in Germany I have similar questions and would welcome such a page. Is a raw pile of information present somewhere?

[skullydazed]

I think the closest we have are the includes here: https://github.com/qmk/qmk_firmware/tree/master/quantum/keymap_extras

If you're working on this, or just trying to figure out how to make it happen with your own keyboard, right now the best place to get more info is discord, people there have varying levels of knowledge.

[ThomDietrich]

• https://github.com/qmk/qmk_firmware/blob/master/docs/how_keyboards_work.md

• https://github.com/qmk/qmk_firmware/issues/520
• https://www.reddit.com/r/olkb/comments/4vrie0/is_there_a_way_to_make_the_plancks_layout/

[MetalDent]

Hi, anyone working on this issue?

[stale[bot]]

This issue has been automatically marked as stale because it has not had activity in the last 90 days. It will be closed in the next 30 days unless it is tagged properly or other activity occurs.
For maintainers: Please label with bug, in progress, on hold, discussion or to do to prevent the issue from being re-flagged.

[jackhumbert]

@fauxpark is working on some docs that will help with this.

[fauxpark]

This is done as of #9194:
https://docs.qmk.fm/#/reference_keymap_extras