lequation Files

******************************************************************************
* Lequation
******************************************************************************

Features:
- Latex equation editor
- Contains latex distribution (texlive 2011)
- emphasis on simplicity
- currently two stand alone versions: win and osx
- currently one office ribbon integrated version: win-ribbon (alpha)

******************************************************************************

Stand alone installation:
- unzip and run lequation (.exe or .app)
- use 7-zip to unzip if standard windows unzip fails

Stand alone usage:
- Write to memo and click apply
- program generates image from latex commands 
  - image is copied to clipboard automatically
- paste the image where its needed

******************************************************************************

Ribbon installation:
- install python27 to c:\python27
  - note! The location must be such that you can write there without elevated 
    priviledges (admin)
- install pywin (windows COM bindings etc for python)
- install numpy (numerical python)
- install PIL (python image library)
- unzip lequation with 7-zip
- run registerLequation.py AS ADMIN

Ribbon usage:
- in word or power point, there is a lequation toolbar in addins
- in MS Word:
  - paint (select) latex commands in document
  - click lequation button
  - selected text is replaced by an equation image
  - note! the text must be selected in document base 
    (not e.g. some menu text field)
- in MS PowerPoint
  - paint (select) latex commands in text box 
  - click lequation button
  - equation image is added to slide
  - latex command is seen as an "alt text" in image
    - second click image -> format image -> alt text
  - note! the text must be selected from text box in slide 
    edit mode (not e.g. alt text box in menu)
  
******************************************************************************

Sources

- src/commandLine folder
  - latexCompiler.py:
    - usage: python latexCompiler.py <latexString> 
    - if you have white spaces in your <latexString> encapsulate it with ""
    - example: python latexCompiler.py "\frac{ \alpha }{\beta \gamma}" 
  - lequation.conf:
    - main configuration file
    - note! in Distributions the programs will be in "bin" directory.
      In sources, programs are in "src/<programName>" directory. The path to 
      "texlive" directory is relative. So, change "../../" to "../" in
      commands in lequation.conf when distributing.

- src/ribbon folder
  - ribbon control files
  - this is in alpha stage and constantly living
  - Target is: 
    - vba-scripts for office add-in buttons (ppam, docm)
    - XYZ-scripts for open office add-in buttons
    - commandLine program as backend

- src/standAlone folder
  - this will go through major revisions
    - separate frontend from backend
    - frontend can be native
    
****************************************************************************

Source usage:
- unzip zips/texlive.zip <installDir>
- cd <installDir>/src/standAlone
- python lequation.py
   
****************************************************************************

Future plans:
- add tex-to-img and img-to-tex buttons
- add history
- add pdf, svg, mathml, eps, ps, jpg, gif and dvi output support
- minimize admin installation need (to only when registering office-addin)
- tweak stand alone GUI (especially in osx)
- write plugins for osx-office and open office
- use system latex if available