summaryrefslogtreecommitdiffstats
path: root/share/extensions/other/gcodetools/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'share/extensions/other/gcodetools/README.md')
-rw-r--r--share/extensions/other/gcodetools/README.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/share/extensions/other/gcodetools/README.md b/share/extensions/other/gcodetools/README.md
new file mode 100644
index 0000000..130faaf
--- /dev/null
+++ b/share/extensions/other/gcodetools/README.md
@@ -0,0 +1,41 @@
+# Gcodetools
+
+
+Gcodetools is a set of Inkscape extensions for generating [G-Code](https://en.wikipedia.org/wiki/G-code) and other performing computer-aided manufacturing related tasks. It serves as an interface for working with plotters, laser cutters, engravers and other CNC machines based on Inkscape.
+
+## Maintainer wanted!
+
+The extension is currently unmaintained. Help with the following tasks is greatly appreciated:
+ - Collecting feedback from maker spaces and other users
+ - Compiling documentation of the various features
+ - Fixing bugs and improving the overall code quality
+ - Adding [unit tests](#testing) and expanding the test framework
+ - Using new API functionality added since Inkscape 1.0 to improve the robustness of the extensions
+
+Do you want to contribute? Join the community on [chat.inkscape.org](chat.inkscape.org) (channel #inkscape_extensions)!
+
+## Installation
+
+These scripts should be installed with an Inkscape package already (if you have
+installed Inkscape). For packagers or people testing newer releases, you can
+install the `*.inx` and `*.py` files into `/usr/share/inkscape/extensions` or
+`~/.config/inkscape/extensions` .
+
+## Testing
+<a name="testing"></a>
+
+You must install the program `pytest` in order to run these tests. You may run all tests by omitting any other parameters or select tests by adding the test filename that you want to run.
+
+ pytest
+ pytest tests/test_gcodetools.py
+
+See [extensions/TESTING.md](https://gitlab.com/inkscape/extensions/-/blob/master/TESTING.md) for further details.
+
+Increasing the test coverage of gcodetools is one of the primary development objectives at the moment.
+## Development
+
+The gcodetools extension requires the inkex library, developed [here](https://gitlab.com/inkscape/extensions). Clone the main extensions repository and add the cloned folder to your PYTHONPATH, e.g. by creating a .pth file in your virtualenv's `site-packages`.
+
+The branches of gcodetools are parallel to the branches of inkex, i.e. the 1.1.x branch uses only functionality that is included in the inkex-1.1.x branch (corresponding to the Inkscape 1.1.x release series). This is also ensured by the CI pipeline.
+
+Apart from this, the same rules as in the main extensions repo apply with respect to code quality. \ No newline at end of file