X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fincluded%2Fgenerating-output.itexi;h=21969bf4f0564e8c41787db1f233a8f6ce239c6c;hb=bf5e12cca7be0cf62014de7186dffaebbee13bfa;hp=7d6733d1c3e6228dfd3bac8f3a116016e2f82acc;hpb=db1ff0cd9cdb6713a16a5843f3f4965e01e32579;p=lilypond.git diff --git a/Documentation/included/generating-output.itexi b/Documentation/included/generating-output.itexi index 7d6733d1c3..21969bf4f0 100644 --- a/Documentation/included/generating-output.itexi +++ b/Documentation/included/generating-output.itexi @@ -9,8 +9,8 @@ @macro lilypadOSX @warning{These instructions assume that you are using the LilyPond application. If you are using any of the programs described in -@rweb{Easier editing}, please consult the documentation for -those programs if you have any problems.} +@rweb{Easier editing}, consult the documentation for those +programs should you have any problems.} @subsubheading Step 1. Create your @file{.ly} file @@ -32,7 +32,7 @@ Choose a name for your file, for example @file{test.ly}. @subsubheading Step 2. Compile (with LilyPad) From the same menus, select -@w{@code{Compile > Tyepset}}. +@w{@code{Compile > Typeset}}. @sourceimage{Learning_Macos_Typeset_menu,,,} @@ -64,7 +64,7 @@ saved previously. @sourceimage{Learning_Macos_Open_menu,,,} You must save any new edits you make to your file before you -@w{@code{Compile > Tyepset}} and if the PDF file is not displayed +@w{@code{Compile > Typeset}} and if the PDF file is not displayed check the window with the progress log for any errors. If you are not using the default Preview PDF viewer that comes @@ -80,89 +80,82 @@ may fail to generate an update PDF until you close the original. @macro lilypadWindows @warning{These instructions assume that you are using the built-in LilyPad editor. If you are using any of the programs described in -@rweb{Easier editing}, please consult the documentation for -those programs if you have any problems compiling a file.} +@rweb{Easier editing}, consult the documentation for those programs +should you have any problems.} @subsubheading Step 1. Create your @file{.ly} file -Double-click the LilyPond icon on your desktop, an example file will open. +Double-click the LilyPond icon on your desktop and an example file will open. -@sourceimage{Learning_Win7_Welcome_File_Whole,,,} +@sourceimage{LilyPad,,,} From the menus that appear along the top of the example file, -select @w{@code{File > Save as}}. Do not use the @w{@code{File > Save}} +select @w{@code{File > Save as}}. Do not use the @w{@code{File > Save}} for the example file as this will not work until you have given it a valid LilyPond file name. -@sourceimage{Learning_Win7_Save_Menu,,,} +@sourceimage{FileSave,,,} Choose a name for your file, for example @file{test.ly}. -@sourceimage{Learning_Win7_Save_File_With_Name,,,} +@sourceimage{SaveAs,,,} -@subsubheading Step 2a. Compile (with drag-and-drop) +@subsubheading Step 2. Compile -Depending on what you prefer, to compile your file either: +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. -Drag-and-drop the file directly onto the LilyPond icon. +1. Drag-and-drop the file directly onto the LilyPond icon on the desktop. -@sourceimage{Learning_Win7_Open_Dragndrop,,,} +@sourceimage{DragDrop,,,} -Right-click on the file and from the pop-up context menu choose -@w{@code{Open with > LilyPond}}. +Not much will seem to happen, but after a short while, you should +see two new files on your desktop -- @file{test.log} and +@file{test.pdf}. -@sourceimage{Learning_Win7_Open_Context_Menu,,,} +2. Right-click on the file and from the pop-up context menu and +choose @w{@code{Generate PDF}}. +@sourceimage{GenPDF,,,} -@subsubheading Step 2b. Compile (with double-clicking) - -Or simply double-click the @file{test.ly}. +3. Or simply double-click the @file{test.ly}. @subsubheading Step 3. View output -During the compilation of the @file{test.ly} file, a command window -will, very briefly open and then close. Three additional files will -have been created during this process. - -@sourceimage{Learning_Win7_All_Files_Created,,,} +@file{test.pdf} contains the engraved @file{test.ly} +file. Double-click it and it should open in your PDF viewer: -The PDF file contains the engraved @file{test.ly} file. - -@sourceimage{Learning_Win7_Pdf_Output,,,} +@sourceimage{PDFRead,,,} @subsubheading Other commands To create a new file, begin by selecting @w{@code{File > New}} from -within any previously created file. +within any previously created file or @w{@code{File > Open}} to open and +edit any files you have saved before. You can also edit a file by +right-clicking it and selecting @w{@code{Edit source}}. -@sourceimage{Learning_Win7_New_Menu,,,} +@sourceimage{EditFile,,,} -@noindent -or @w{@code{File > Open}} to open and edit any files you have saved -before. +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. -@sourceimage{Learning_Win7_Open_Menu,,,} - -You must save any new edits you make before you compile it and if the -PDF file is not created, check the log file that will have been created -during the compilation attempt, for any errors. - -@sourceimage{Learning_Win7_Log_File,,,} +@sourceimage{BadLog,,,} This log file is overwritten each time you compile your LilyPond file. -The PS file is used internally by LilyPond to create the PDF file and -can be ignored. It also gets overwritten each time you compile your -file. - -If you are viewing your file in a PDF viewer, then you must close the -PDF if you wish to make a new compilation as it may fail to create -the new PDF while it is still being viewed. +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. +@sourceimage{BadLog2,,,} @end macro @@ -170,10 +163,9 @@ the new PDF while it is still being viewed. @c not lilypad at all, but I ran out of names. :( @macro lilypadCommandLine @warning{These instructions assume that you are familiar with -command-line programs. If you are using any of the programs -described in @rweb{Easier editing}, please consult the -documentation for those programs if you have any problems -compiling a file.} +command-line programs. If you are using any of the programs described +in @rweb{Easier editing}, consult the documentation for those programs +should you have any problems.} @subsubheading Step 1. Create your @file{.ly} file @@ -182,9 +174,9 @@ Create a text file called @file{test.ly} and enter: @c double \\ required because this is inside a macro! @example -\\version "@w{@version{}}" +\\version "@w{@versionStable{}}" @{ - c' e' g' e' +@ @ c' e' g' e' @} @end example @@ -201,7 +193,7 @@ lilypond test.ly You will see something resembling: @example -GNU LilyPond @w{@version{}} +GNU LilyPond @w{@versionStable{}} Processing `test.ly' Parsing... Interpreting music... @@ -210,6 +202,7 @@ Solving 1 page-breaking chunks...[1: 1 pages] Drawing systems... Layout output to `test.ps'... Converting to `./test.pdf'... +Success: compilation successfully completed @end example @subsubheading Step 3. View output