Editor (main window reference)
| ANNOUNCEMENT |
|---|
| OOoLilyPond has moved to a new repository: |
| https://github.com/OOoLilyPond |
| All past/present/future development can be found at the new location. The page you are viewing right here contains all development up to V. 1.0.1, but it will no longer be maintained. |
The white editor pane at the top offers a simple text editor.
When editing an existing snippet, you will find its current LilyPond code here.
When creating a new snippet, the editor will contain some default code from the template you've chosen.
This checkbox shows if the editor still shows the unchanged default code from the selected template. The mark is removed once you apply any change to the code.
When clicking on the checkbox, you will be asked if you want to reset your code to the template's default code. Be careful: If you confirm now, your changes will be lost.
Below the editor pane there are two buttons that support the use of an external code editor (see Using an external editor):
saves the current code into a temporary file which is then opened in the external editor.
re-imports the contents of the same file back into OLy's editor.
This dropdown box lets you choose a template on which your snippet will be based.
Changing the template will complete the editor with the default code from the new template (only if you haven't yet applied changes in the editor pane).
(See Templates for more information OLy's template-based concept.)
If a template is found in a location other than the default template folder, this is indicated below the template dropdown box. This feature is described here:
Understanding templates - Include template in OLy object
Clicking this button opens a simple text editor that lets you modify the selected template or create a new one. Attention: Changes will affect every document on your system that uses this template, so be careful!
These checkboxes can "switch" sections of your template on or off.
See Understanding templates - "Option" checkboxes.
These four fields provide access to certain sections of the current template.
(See Templates for more information OLy's template-based concept.)
The "Default" checkboxes below will get unmarked once you apply changes to those fields. Clicking on them brings back the default contents.
Every time LilyPond is called, its command line output will be stored in a file. This button opens a dialogue that displays the output from the last time LilyPond has been called.
Here you can find any warnings or error messages that LilyPond has displayed.
This button opens the Configuration dialogue.
This button calls LilyPond to render the contents of the editor window into musical notation. If an image file has been created, it will be inserted into the document.
If LilyPond has reported errors or warnings, the editor will remain visible and LilyPond's messages will be displayed.
As long as there are no messages from LilyPond, the editor window will disappear.
In your office document, you should now see the musical snippet you've just created.
(only for Writer documents)
Here you can pre-configure how LibreOffice / OpenOffice will treat the resulting image inside your text document.
These options are the same as those you can apply to existing images inside the text.
If you are editing an existing OLy object, this option makes OLy remember its dimensions and settings for eventually cropped edges. The same settings will be re-applied to the image after editing.
This option can be helpful when you use the SVG file format which requires manual cropping.
If your musical snippet consists of multiple lines (systems), OLy can insert them as separate images instead of one single image for the whole score. For details see Advances features - Separate images
These fields allow specifying a first and last image number to be inserted.
When LilyPond reported errors during compilation, they are displayed at the bottom of the editor window.
The blinking cursor will be placed at the location where LilyPond has found an error.
Use the left / right arrow buttons here to switch to the previous / next error.
