Language Agnostic Instructional Protocol

From Open Source Ecology
Jump to: navigation, search


Below you will see several routes to LAI (Language Agnostic Instructionals) creations. Different routes are:

  1. IKEA-Style Build Diagrams - a well-known concept for conveying build instructions with pictures. Critique of IKEA is that sometimes it is not at all clear. This is where formal quality control protocols are needed.
  2. Google Slides-generated instructionals, such as the CEB press below.
  3. FreeCAD-Inkscape toolchain - an advanced workflow, learnable easily by novices. See below.

We also have Fabrication Diagram methods of visual communication.

Instructional Video

You can download the macro in the video description.


  1. Use a Google Presentation - use Template at Instructionals Cover Page
  2. Draw out a complete fabrication procedure as best you can - without using words.
  3. Embed in a wiki page titled Machine/Module Name - Language Agnostic Instructionals. See Embedding Google Docs in the Wiki.


This refers to language-agnostic instructionals. See Example of brick press frame:


(see overall documentation from this build in our blog -

Protocol Working Document


Extracting Black and White Isometric Drawings from FreeCAD

Before you work with a file, make sure that the file is approved according to OSE CAD Standards.

GIMP + FreeCAD Macro

  • Here is a method from Laszlo to export FreeCAD's view to black and white with a macro and GIMP. Video

Inkscape + FreeCAD Macro

Roberto Isometric view workflow. This method works fine for parts with regular surfaces (most). It also works for wires.

  1. Install this Macro. How to install macros in FreeCAD.
  2. Open a FreeCAD file with the part you want to extract the isometric view from.(If the wanted part is separated in several smaller parts, go to Part Workbench, select all of these parts and use the tool "Make compound" in the top dropdown menu).
  3. Select the wanted part, by double clicking over it.
  4. Execute the Macro.
  5. Double click in the new drawing page called "AutoDrawing".
  6. You can change position and scale for each drawing in the combo view data tab (after selecting the wanted drawing).
  7. Use the tool: "Export a page to a SVG file"(in Drawing Workbench).
  8. Open the SVG file with Inkscape.
  9. Make required fixes to the image.
  10. Export PNG image.


Short Idler LAI


Examples of OSE Machines