Skip to content

JohnDTill/YAWYSIWYGEE

Repository files navigation

YAWYSIWYGEE

This story arc has reached its conclusion, but the adventure continues with YAWYSIWYGEE 2: Forscape!

Yet Another WYSIWYG Equation Editor

Yet Another What-you-see-is-what-you-get Equation Editor

Qt widget for editing documents with inline equations.

alt text

Try it in your browser!

Purpose

This project aims to create a Qt widget for inline editing of equations. The target is a code editor style rather than a document editor style (think Notepad++ with equations versus MS Word or LyX). Such an equation code editor could be used for:

  • Computer algebra systems
  • Symbolic math
  • Scientific computing languages
  • Mathematical scratchpads
  • Online use by compiling to WebAssembly
  • The next hit mobile-game which is a cross between mathematics and Pictionary ("Gauss's law! No, wait, projectile motion!")

The name is perhaps overly self-deprecating; although there are many inline equation editors, there is not an abundance of open source options, and a Qt widget should be useful.

Usage

There is an exposed widget class "TypesetEdit" which has an API similar to QTextEdit. Probably the easiest way to interact with a TypesetEdit in a separate project is to use the toMathBran() and setMathBran() methods, which use the MathBran serialization format. It is also possible to inject MathBran code into a specific part of the document, which is how the GUI buttons are implemented and how copy/paste works.

There is also an exposed class "TypesetToolbar" included in the library to make it easier to incorporate a GUI in a custom application. See the ExampleApp for a demonstration of how to use TypesetToolbar.

Design

Discussion of data structures and algorithms can be found in the project wiki. Hopefully these pages will lower the barrier of entry to modify YAWYSIWGEE source code.

Prerequisites

License

This project is licensed under the MIT License - see the LICENSE file for details

Contributing

Feel free to submit pull requests and use the issue tracker to start a discussion.

Acknowledgements

Thanks to: