Now actually convert the syntax to markdown :)

This commit is contained in:
Elmom 2011-01-12 14:28:23 +02:00
parent a9616c7fdf
commit 006508acde

View file

@ -10,31 +10,31 @@ See http://creativecommons.org/licenses/LGPL/2.1/ or the included file, lgpl-2.1
## Usage ## ## Usage ##
You can import these files in your scripts with "use <MCAD/*.scad>", but some You can import these files in your scripts with `use <MCAD/*.scad>`, but some
files include useful constants which will be available with "include <MCAD/*.scad>", files include useful constants which will be available with `include <MCAD/*.scad>`,
which should be safe to use on all included files (ie. no top level code should which should be safe to use on all included files (ie. no top level code should
create geometry). (There is a bug/feature that prevents including constants from create geometry). (There is a bug/feature that prevents including constants from
files that "include" other files - see the openscad mailing list archives for more files that "include" other files - see the openscad mailing list archives for more
details. Since the maintainers aren't very responsive, may have to work around this details. Since the maintainers aren't very responsive, may have to work around this
somehow) somehow)
If you host your project in git, you can do "git submodule add URL PATH" in your If you host your project in git, you can do `git submodule add URL PATH` in your
repo to import this library as a git submodule for easy usage. Then you need to do repo to import this library as a git submodule for easy usage. Then you need to do
a "git submodule update --init" after cloning. When you want to update the submodule, a `git submodule update --init` after cloning. When you want to update the submodule,
do "cd PATH; git checkout master; git pull". See "git help submodule"" for more info. do `cd PATH; git checkout master; git pull`. See `git help submodule` for more info.
Currently Provided Tools: Currently Provided Tools:
* involute_gears.scad (http://www.thingiverse.com/thing:3575): * involute_gears.scad (http://www.thingiverse.com/thing:3575):
- gear() ** gear()
- bevel_gear() ** bevel_gear()
- bevel_gear_pair() ** bevel_gear_pair()
* gears.scad (Old version): * gears.scad (Old version):
- gear(number_of_teeth, circular_pitch OR diametrial_pitch, pressure_angle OPTIONAL, clearance OPTIONAL) ** gear(number_of_teeth, circular_pitch OR diametrial_pitch, pressure_angle OPTIONAL, clearance OPTIONAL)
* motors.scad: * motors.scad:
- stepper_motor_mount(nema_standard, slide_distance OPTIONAL, mochup OPTIONAL) ** stepper_motor_mount(nema_standard, slide_distance OPTIONAL, mochup OPTIONAL)
Other tools (alpha and beta quality): Other tools (alpha and beta quality):
* nuts_and_bolts.scad: for creating metric and imperial bolt/nut holes * nuts_and_bolts.scad: for creating metric and imperial bolt/nut holes
@ -77,7 +77,7 @@ and stick to it.
### Testing ### ### Testing ###
I've started a minimal testing infrastucture for OpenSCAD code. It's written in I've started a minimal testing infrastucture for OpenSCAD code. It's written in
python and uses py.test (might be compatible with Nose also). Just type py.test python and uses py.test (might be compatible with Nose also). Just type `py.test`
inside the lib dir in a terminal and you should see a part of the tests passing inside the lib dir in a terminal and you should see a part of the tests passing
and tracebacks for failing tests. It's very simplistic still, but it should test and tracebacks for failing tests. It's very simplistic still, but it should test
that no syntax errors occur at least. that no syntax errors occur at least.