Skip to content

nasosi/InkRadix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

120 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

InkRadix is an Inkscape extension that enables editing equations using Radical Pie™ (https://radicalpie.com/). Radical Pie is a WYSIWYG equation editing application for Windows 10/11.

Installation

There are several ways to install InkRadix. First, make sure that Radical Pie and Inkscape are installed on your computer. Subsequently, follow any of the following options.

Option 1: Easiest (Downloads and installs)

If you have Windows version 10 1803 or later (very likely), you can install easily with:

  1. Open a Command Prompt.
  2. Copy, paste, and execute the following command:
(if exist "%temp%\InkRadixInst" rmdir /s /q "%temp%\InkRadixInst") && md "%temp%\InkRadixInst" && curl -L -o "%temp%\InkRadixInst\main.zip" "https://github.com/nasosi/InkRadix/archive/refs/heads/main.zip" && powershell -Command "Expand-Archive -Path '%temp%\InkRadixInst\main.zip' -DestinationPath '%temp%\InkRadixInst' -Force" && cd /d "%temp%\InkRadixInst\InkRadix-main\Resources" && call Install.bat && cd /d "%temp%" && rmdir /s /q "%temp%\InkRadixInst"
  1. (Re)start Inkscape to load the extension.

Option 2: From within Inkscape

  1. Download the latest release extension .zip file here.
  2. In Inkscape, select ExtensionsManage Extensions.
  3. In the Extensions window that appears, select the Install Packages tab.
  4. At the bottom of the window, select the folder icon.
  5. Navigate to the location where InkRadix-main.zip was downloaded in, select it and click Open at the bottom right of the window.
  6. Close the Extensions window and restart Inkscape.

Option 3: Installer script

  1. Download this repository here.
  2. Extract it.
  3. Execute the Install.bat script from the Resources folder.
  4. (Re)start Inkscape to load the extension.

Option 4: Manual

  1. Download the latest release extension .zip file here, and unzip it.
  2. Place the files InkRadixEdit.inx, InkRadixToggleBL.inx and InkRadix.py in the following user directory: %APPDATA%\inkscape\extensions\nasos.inkradix. Note: You can copy and paste %APPDATA%\inkscape\extensions, directly into the Windows File Explorer address bar. It will resolve to a folder similar to: C:\Users\<YourUsername>\AppData\Roaming\inkscape\extensions. Then you can create the folder nasos.inkradix.
  3. (Re)start Inkscape to load the extension.

Usage

The extension adds a submenu under ExtensionsTextRadical Pie Equation, with two commands: Create / Edit and Toggle Baseline.

  • Adding a new equation: If no objects are selected, the Create / Edit command will launch Radical Pie. After closing and saving, a new equation will be inserted into Inkscape.
  • Editing an existing equation: If an existing Radical Pie equation is selected, running the Create / Edit command will open the equation for editing. After closing and saving, the selected object will be updated with the modified content.
  • If you select multiple equations and run the Create / Edit command, only the first equation will be edited.
  • If you select one, or more objects that are not equations, and run the Create / Edit command, the newly created equation will be placed at the center of the axis-aligned bounding box of the selected objects.
  • If you have selected one or more equations and run the Toggle baseline command, the equation baseline will be toggled on or off.
  • You can paste LaTeX equations into Radical Pie, and they will be formatted automatically. You can then modify them graphically.
  • If you want a LaTeX-like appearance, you can install the NewCM-Radix font collection (https://github.com/nasosi/NewCM-Radix ), which works seamlessly with Radical Pie.
  • Use the Inkscape pivot cursor to indicate the intended alignment anchor. InkRadix will automatically reference this pivot relative to the nearest bounding box anchor of the equation object (e.g., top-left, middle-right, etc.) or the baseline characteristic points. A technical illustration of the algorithm is available here.
  • Ctrl+Alt+Shift+E works well as a keyboard shortcut for creating/editing equations. To set it up, go to EditPreferencesInterfaceKeyboard, search for Create / Edit, click on Create / Edit, and press Ctrl+Alt+Shift+E on your keyboard.
  • Ctrl+Alt+Shift+B works well as a keyboard shortcut for toggling the baseline. To set it up, go to EditPreferencesInterfaceKeyboard, search for Toggle Baseline, click on Toggle Baseline, and press Ctrl+Alt+Shift+B on your keyboard.
  • Avoid ungrouping the equation object in Inkscape, as this will make it no longer editable. If this happens by accident, you can restore it using the Undo function. Occasionally, you may need to Undo and then Redo.
  • When creating a new equation, InkRadix does not automatically load the user’s default design. To apply it, after Radical Pie starts, select SettingsLoad User Default Design from the Radical Pie menu.

Usage GIFs

Creating a new equation

newEquation

Editing an existing equation

editEquation

Using the Inkscape pivot cursor for alignment

anchors

Using the baseline for typesetting

baselineUse

Supported versions

InkRadix has been tested to work with Radical Pie versions 1.8 and 1.9, and Inkscape versions 1.0 through 1.4.

About

Editable WYSIWYG equations in Inkscape with Radical Pie™

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors