Skip to content

Repository files navigation

Ipelets collection

Leia em português

A curated collection of independent extensions for the Ipe drawing editor. Each ipelet lives in its own directory with installation instructions, examples, tests, and release notes.

Featured ipelets

Circles: preview every tangent-circle candidate and click to create one

Construct, classify, inspect, and annotate editable conics.

Triangles: construct centers and derived triangle geometry

Vectors: decompose vectors and construct exact vector arithmetic

Available ipelets

Ipelet Version Description
Circles 1.0.1 Circle construction, tangencies, inversion, radical geometry, center marking, and live previews.
Conics 1.1.1 Exact and fitted conics, dual and mixed constructions, intersections, arcs, analytic features, inspection, and metadata repair.
Triangles 1.0.0 Twenty-four triangle centers, nine derived constructions, explicit reference points, live previews, and versioned metadata.
Vectors 1.0.0 Axis and oblique decomposition, connected resultants, ordered subtraction, strict topology, and atomic editable output.

Quick installation

On Linux, install an ipelet with the repository helper:

./scripts/install.sh circles

Replace circles with conics, triangles, or vectors to install another ipelet.

The helper detects the Ipe Flatpak installation and otherwise uses the standard ~/.ipe/ipelets directory. Restart Ipe after installation.

Manual installation and platform-specific details are documented inside each ipelet directory. Prebuilt archives for each ipelet are available on the GitHub releases page.

Repository layout

.
├── circles/          Circles source, documentation, examples, and tests
├── conics/           Conics source, documentation, examples, and tests
├── triangles/        Triangles source, documentation, examples, and tests
├── vectors/          Vectors source, documentation, examples, and tests
├── scripts/          Installation, validation, and packaging helpers
├── .github/          Continuous integration and contribution templates
└── LICENSE           Repository license

The installed runtime contains only the corresponding .lua file. Release archives also include the documentation, editable examples, license, and publication images when available; tests and development helpers remain outside the installed ipelet.

Validation

Run every local check with:

./scripts/validate.sh

The same checks run in GitHub Actions. They validate Lua syntax, execute the independent geometry regression suite, and verify the public runtime contract.

Releases

Ipelet Current release
Circles Circles 1.0.1
Conics Conics 1.1.1
Triangles Triangles 1.0.0
Vectors Vectors 1.0.0

Every release provides a versioned ZIP archive and a matching SHA-256 checksum.

Create a release archive with:

./scripts/package.sh circles

The generated archive and its SHA-256 checksum are written to dist/ and are intentionally not tracked by Git. The archive is self-contained: every relative link in its README files resolves inside the package. The complete publication procedure is documented in RELEASING.md.

Contributing

See CONTRIBUTING.md. Bug reports and feature requests can use the GitHub issue forms included in this repository.

License

This collection is licensed under the GNU General Public License, version 3 or any later version. See LICENSE and NOTICE.md.

About

A curated collection of standalone Lua ipelets for the Ipe drawing editor, with documentation, editable examples, and tests.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages