Update cml formatting

Author: ewpratten

buildcml.py

@@ -11,7 +11,7 @@
 outfile_txt = infile.split(".")[0] + ".txt"
 
 # file buffers
-md_buffer = ""
+md_buffer = "# Controller Layouts\n"
 txt_buffer = ""
 
 with open(infile, "r") as f:
@@ -21,7 +21,7 @@
 for controller in cml:
 	print(f"Parsing {controller} controller")
 	# add data to buffers
-	md_buffer += f"# {controller}\nType: {cml[controller]['Type']}\n\nPort: {cml[controller]['Port']}\n|  |  |\n| -- | -- |\n"
+	md_buffer += f"## {controller}\nType: {cml[controller]['Type']}\n\nPort: {cml[controller]['Port']}\n|  |  |\n| -- | -- |\n"
 	txt_buffer += f"-- {controller} --\nType: {cml[controller]['Type']}\nPort: {cml[controller]['Port']}\n"
 
 	# parse through inputs
@@ -30,14 +30,14 @@
 			# Skip non iterable items
 			continue
 		# add data to buffers
-		md_buffer += f"| {input_type} |  |\n"
+		md_buffer += f"| {input_type} | -- |\n"
 		txt_buffer += f" {input_type}:\n"
 
 		# parse items
 		for item in cml[controller][input_type]:
 			# deal with extra nesting
 			if type(cml[controller][input_type][item]) == type({}):
-				md_buffer += f"| {item} |  |\n"
+				md_buffer += f"| {item} | -- |\n"
 				txt_buffer += f"  {item}:\n"
 				for subitem in cml[controller][input_type][item]:
 					md_buffer += f"| {subitem} | {cml[controller][input_type][item][subitem]} |\n"

docs/controller_layout.md

@@ -1,70 +1,71 @@
-# Driver
+# Controller Layouts
+## Driver
 Type: Xbox Controller
 
 Port: 0
 |  |  |
 | -- | -- |
-| Joysticks |  |
-| Left |  |
+| Joysticks | -- |
+| Left | -- |
 | X | Robot steering / rotation |
 | Y |  |
 | Btn |  |
-| Right |  |
+| Right | -- |
 | X |  |
 | Y |  |
 | Btn |  |
-| Dpad |  |
+| Dpad | -- |
 | Up |  |
 | Down |  |
 | Left |  |
 | Right |  |
-| Button Pad |  |
+| Button Pad | -- |
 | A | Robot vision alignment (hold) |
 | B |  |
 | X | Flip forward and backward (toggle) |
 | Y |  |
-| Triggers |  |
+| Triggers | -- |
 | Left | Robot backwards |
 | Right | Robot forwards |
-| Bumpers |  |
+| Bumpers | -- |
 | Left |  |
 | Right | Slow mode (hold) |
-| Other |  |
+| Other | -- |
 | Start |  |
 | Select |  |
 | Home |  |
-# Operator
+## Operator
 Type: Xbox Controller
 
 Port: 1
 |  |  |
 | -- | -- |
-| Joysticks |  |
-| Left |  |
+| Joysticks | -- |
+| Left | -- |
 | X |  |
 | Y |  |
 | Btn |  |
-| Right |  |
+| Right | -- |
 | X |  |
 | Y |  |
 | Btn |  |
-| Dpad |  |
+| Dpad | -- |
 | Up |  |
 | Down |  |
 | Left |  |
 | Right |  |
-| Button Pad |  |
+| Button Pad | -- |
 | A |  |
 | B |  |
 | X |  |
 | Y |  |
-| Triggers |  |
+| Triggers | -- |
 | Left |  |
 | Right |  |
-| Bumpers |  |
+| Bumpers | -- |
 | Left |  |
 | Right |  |
-| Other |  |
+| Other | -- |
 | Start |  |
 | Select |  |
 | Home |  |