From f4835e53151ce1a69a7b2c5d08bd6d7b3e60258c Mon Sep 17 00:00:00 2001 From: Albert Engelbrecht Date: Sun, 18 Oct 2020 12:08:01 -0500 Subject: [PATCH] Added example configuration from Absolum project. After some feedback from @mrzealot pulled the Absolum configuration into the reference documentation. While I was at it, fixed some capitalization and minor wording. --- docs/reference.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/reference.md b/docs/reference.md index cf3c7cc..82e2166 100644 --- a/docs/reference.md +++ b/docs/reference.md @@ -1,6 +1,6 @@ ## Overview -The whole ergogen config is a single YAML file. +The whole Ergogen config is a single YAML file. If you prefer JSON over YAML, feel free to use it, conversion is trivial and the generator will detect the input format. The important thing is that the data should contain the following keys: @@ -17,7 +17,7 @@ The `cases` section details how the case outlines are to be 3D-ized to form a 3D Finally, the `pcbs` section is used to configure KiCAD PCB templates. In the following, we'll have an in-depth discussion about each of these. -Of course, if the declarative nature of the config causes unnecessary repetition (despite the built-in YAML references, and the ergogen-based inheritance detailed below), there's nothing stopping you from writing code that generates the config. +Of course, if the declarative nature of the config causes unnecessary repetition (despite the built-in YAML references, and the Ergogen-based inheritance detailed below), there's nothing stopping you from writing code that generates the config. It brings the game to yet another abstraction level higher, so that you can use branching, loops, and parametric functions to compose a "drier" keyboard definition. @@ -570,10 +570,11 @@ Currently, the following footprint types are supported: ## Phew, that's it. *Theoretically*, you should know everything to start making your own dream keyboard. -*Realistically*, tho, this might have been a bit dense, to say the least. -But hey, this is the full reference, what did you expect? +*Realistically* though, this might have been a bit dense, to say the least. But hey, this is the full reference, what did you expect? + +If you want to look at an example that leverages the full power of Ergogen, you can find [the Absolem project](https://github.com/mrzealot/absolem/) and its [configuration file here.](https://github.com/mrzealot/absolem/blob/master/absolem.yaml) If you'd like to get your feet wet with easier examples, and get gradually more hard-core, let me suggest the other tutorials in the docs folder (as they become available). -Alternatively, if you'd like to talk to a certified ergogen representative, come join us [on Discord](https://discord.gg/nbKcAZB)! +Alternatively, if you'd like to talk to a certified Ergogen representative, come join us [on Discord](https://discord.gg/nbKcAZB)! It's also a great place to get in touch if you are already somewhat familiar with this whole shebang, and would like to contribute examples, tests, features, whatever. -See you there! \ No newline at end of file +See you there!