lilypond-learning: Windows
1.1.3 Windows
-------------
Note: These instructions assume that you are using the
built-in LilyPad editor. If you are using any of the programs
described in (lilypond-web)Easier editing, please
consult the documentation for those programs if you have any
problems compiling a file.
Step 1. Create your ‘.ly’ file
..............................
Double-click the LilyPond icon on your desktop and an example file will
open.
[lilypond/pictures/LilyPad]
From the menus that appear along the top of the example file, select
‘File > Save as’. Do not use the ‘File > Save’ for the example file as
this will not work until you have given it a valid LilyPond file name.
[lilypond/pictures/FileSave]
Choose a name for your file, for example ‘test.ly’.
[lilypond/pictures/SaveAs]
Step 2. Compile
...............
To turn your LilyPond file into a music score, you need to compile it.
This can be done a number of ways – using drag and drop, with
right-click, double-clicking or using the command line (a DOS box).
We’ll look at the first three to start with.
1. Drag-and-drop the file directly onto the LilyPond icon on the
desktop.
[lilypond/pictures/DragDrop]
Not much will seem to happen, but after a short while, you should see
two new files on your desktop – ‘test.log’ and ‘test.pdf’.
2. Right-click on the file and from the pop-up context menu and
choose ‘Generate PDF’.
[lilypond/pictures/GenPDF]
3. Or simply double-click the ‘test.ly’.
Step 3. View output
...................
‘test.pdf’ contains the engraved ‘test.ly’ file. Double-click it and it
should open in your PDF viewer:
[lilypond/pictures/PDFRead]
Other commands
..............
To create a new file, begin by selecting ‘File > New’ from within any
previously created file or ‘File > Open’ to open and edit any files you
have saved before. You can also edit a file by right-clicking it and
selecting ‘Edit source’.
[lilypond/pictures/EditFile]
You must save any edits you make before you try to compile your file.
If the PDF file is not created or the output is not what you expected,
check the log file that will have been created during the compilation
attempt for any errors.
[lilypond/pictures/BadLog]
This log file is overwritten each time you compile your LilyPond
file.
If you are viewing your file in a PDF viewer, then you must close the
PDF if you wish to try a new compilation as it may fail to create the
new PDF while it is still being viewed.
[lilypond/pictures/BadLog2]