From eaff3ec3f2494f06a3ec9370e40f96566493916c Mon Sep 17 00:00:00 2001 From: Brad Pitcher Date: Fri, 7 Feb 2014 15:26:52 -0800 Subject: [PATCH 1/4] improve README aesthetics --- README.txt => README.md | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) rename README.txt => README.md (60%) diff --git a/README.txt b/README.md similarity index 60% rename from README.txt rename to README.md index 52ca14b..e2603c5 100644 --- a/README.txt +++ b/README.md @@ -1,18 +1,20 @@ Limitations ------------ +=========== Currently only supports mendel and sturdy machine variants, the huxley version needs more work. Use ---- +=== Add the directory of the OpenScad executable to your search path. OpenSCAD-2013.06 or later is required. To get PDF versions of the sheet drawings add InkScape to your search path. To make all the files for a machine run - make_machine.py machine_name +```python +make_machine.py machine_name +``` -To make just the bom, sheets or stls run bom.py, sheets.py or stls.py machine_name. +To make just the bom, sheets or stls run bom.py, sheets.py or stls.py machine\_name. -machine_name can be mendel or sturdy. To make your own variant copy scad\conf\mendel_config.scad or scad\conf\sturdy_config.scad to yourname_config.scad. Then run make_machine yourname. +machine\_name can be mendel or sturdy. To make your own variant copy scad\conf\mendel\_config.scad or scad\conf\sturdy\_config.scad to yourname\_config.scad. Then run `make_machine yourname`. To view the model of the whole machine, open scad\main.scad. It will take several minutes to render (about about 8 minutes on my computer) but after that you can pan and zoom it at reasonable speed and changes takes less time to render. (Note: main.scad will only render correctly if conf\machine.scad exists, which is created by the make_machine.py script.) @@ -21,17 +23,17 @@ To view a sub-assembly, open the individual scad files. Set the exploded flag in To get blender renders of all the parts put blender in your search path and run render.py machine_name. Credits -------- -Fan model based on http://www.thingiverse.com/thing:8063 by MiseryBot, CC license. +======= +Fan model based on [this model](http://www.thingiverse.com/thing:8063) by MiseryBot, CC license. -Sanguinololu model http://www.thingiverse.com/thing:18606 by ax_the_b, CC license. +[Sanguinololu model](http://www.thingiverse.com/thing:18606) by ax\_the\_b, CC license. Spring taken from openscad example 20 x-end.scad and wade.scad use some elements of the Prusa ones by Josef Prusa, GPL license. -z_couplings originally based on http://www.thingiverse.com/thing:7153 by Griffin_Nicoll, GPL license. +z_couplings originally based on [this model](http://www.thingiverse.com/thing:7153) by Griffin_Nicoll, GPL license. -Bearing holders originally based on http://www.thingiverse.com/thing:7755 by Jolijar, CC license. +Bearing holders originally based on [this model](http://www.thingiverse.com/thing:7755) by Jolijar, CC license. -InkCL.py based on code from http://kaioa.com/node/42 +InkCL.py based on [this code](http://kaioa.com/node/42) From 6e155ea190be0e0f0999c9945f38f8bd1fa4757e Mon Sep 17 00:00:00 2001 From: Brad Pitcher Date: Fri, 7 Feb 2014 17:27:07 -0800 Subject: [PATCH 2/4] use code rendering for blender command --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e2603c5..8e28a16 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ To view the model of the whole machine, open scad\main.scad. It will take severa To view a sub-assembly, open the individual scad files. Set the exploded flag in config.scad to make exploded views. -To get blender renders of all the parts put blender in your search path and run render.py machine_name. +To get blender renders of all the parts put blender in your search path and run `render.py machine_name`. Credits ======= From 19b09aaa36dcf3948fe4ec1a7e0de53703577b64 Mon Sep 17 00:00:00 2001 From: Brad Pitcher Date: Fri, 7 Feb 2014 17:27:39 -0800 Subject: [PATCH 3/4] add .py extension to make_machine command --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8e28a16..11f0000 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ make_machine.py machine_name To make just the bom, sheets or stls run bom.py, sheets.py or stls.py machine\_name. -machine\_name can be mendel or sturdy. To make your own variant copy scad\conf\mendel\_config.scad or scad\conf\sturdy\_config.scad to yourname\_config.scad. Then run `make_machine yourname`. +machine\_name can be mendel or sturdy. To make your own variant copy scad\conf\mendel\_config.scad or scad\conf\sturdy\_config.scad to yourname\_config.scad. Then run `make_machine.py yourname`. To view the model of the whole machine, open scad\main.scad. It will take several minutes to render (about about 8 minutes on my computer) but after that you can pan and zoom it at reasonable speed and changes takes less time to render. (Note: main.scad will only render correctly if conf\machine.scad exists, which is created by the make_machine.py script.) From db2d7cba09514a33c8c2da2e19bf077fb01a3232 Mon Sep 17 00:00:00 2001 From: Brad Pitcher Date: Sat, 8 Feb 2014 08:24:41 -0800 Subject: [PATCH 4/4] revert to the smaller headers --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 11f0000..b6033cd 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ Limitations -=========== +----------- Currently only supports mendel and sturdy machine variants, the huxley version needs more work. Use -=== +--- Add the directory of the OpenScad executable to your search path. OpenSCAD-2013.06 or later is required. To get PDF versions of the sheet drawings add InkScape to your search path. @@ -23,7 +23,7 @@ To view a sub-assembly, open the individual scad files. Set the exploded flag in To get blender renders of all the parts put blender in your search path and run `render.py machine_name`. Credits -======= +------- Fan model based on [this model](http://www.thingiverse.com/thing:8063) by MiseryBot, CC license. [Sanguinololu model](http://www.thingiverse.com/thing:18606) by ax\_the\_b, CC license.