From ae15e0fb7444c542b0b41a82f273e3aa5b6d492b Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Sun, 13 Dec 2009 09:48:49 +0000 Subject: [PATCH] Doc: add Steps to OSX and command-line instructions. --- Documentation/learning/tutorial.itely | 35 +++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/Documentation/learning/tutorial.itely b/Documentation/learning/tutorial.itely index e5058930c6..4a719ba0ff 100644 --- a/Documentation/learning/tutorial.itely +++ b/Documentation/learning/tutorial.itely @@ -130,6 +130,9 @@ application. If you are using any of the programs described in @rweb{Alternate input}, please consult the documentation for those programs if you have any problems.} + +@subsubheading Step 1. Create your @file{.ly} file + Double click the @command{LilyPond.app}, an example file will open. @sourceimage{Learning_Macos_welcome,,,} @@ -143,6 +146,9 @@ Choose a name for your file, for example @file{test.ly}. @sourceimage{Learning_Macos_Save_file_with_name,,,} + +@subsubheading Step 2. Compile (with LilyPad) + From the same menus, select @w{@code{Compile > Tyepset}}. @@ -153,12 +159,18 @@ of the file you have just saved. @sourceimage{Learning_Macos_Compiling_log,,,} + +@subsubheading Step 3. View output + Once the compilation has finished, a PDF file will be created with the same name as the original file and will be automatically opened in the default PDF viewer and displayed on your screen. @sourceimage{Learning_Macos_pdf_output,,,} + +@subsubheading Other commands + To create new files for LilyPond, begin by selecting @w{@code{File > New}} @@ -178,6 +190,7 @@ with the Mac Operating system and you have the PDF file generated from a previous compilation open, then any further compilations may fail to generate an update PDF until you close the original. + @node Windows @subsection Windows @@ -186,6 +199,7 @@ LilyPad editor. If you are using any of the programs described in @rweb{Alternate input}, please consult the documentation for those programs if you have any problems compiling a file.} + @subsubheading Step 1. Create your @file{.ly} file Double-click the @command{LilyPond.app}, an example file will open. @@ -203,7 +217,8 @@ Choose a name for your file, for example @file{test.ly}. @sourceimage{Learning_Win7_Save_File_With_Name,,,} -@subsubheading Step 2a. Compile with drag-and-drop + +@subsubheading Step 2a. Compile (with drag-and-drop) Depending on what you prefer, to compile your file either: @@ -216,11 +231,13 @@ Right-click on the file and from the pop-up context menu choose @sourceimage{Learning_Win7_Open_Context_Menu,,,} -@subsubheading Step 2b. Compile with double-clicking + +@subsubheading Step 2b. Compile (with double-clicking) Or simply double-click the @file{test.ly}. -@subsubheading Step 3. Processing and viewing + +@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 @@ -232,6 +249,7 @@ The PDF file contains the engraved @file{test.ly} file. @sourceimage{Learning_Win7_Pdf_Output,,,} + @subsubheading Other commands To create a new file, begin by selecting @w{@code{File > New}} from @@ -266,12 +284,14 @@ the new PDF while it is still being viewed. @subsection Command-line @warning{These instructions assume that you are familiar with -common unix command-line programs. If you are using any of the -programs described in @rweb{Alternate input}, please consult the +command-line programs. If you are using any of the programs +described in @rweb{Alternate input}, please consult the documentation for those programs if you have any problems compiling a file.} +@subsubheading Step 1. Create your @file{.ly} file + Create a text file called @file{test.ly} and enter: @example @@ -280,6 +300,9 @@ Create a text file called @file{test.ly} and enter: @} @end example + +@subsubheading Step 2. Compile (with command-line) + To process @file{test.ly}, proceed as follows: @example @@ -303,6 +326,8 @@ Layout output to `test.ps'... Converting to `test.pdf'... @end example +@subsubheading Step 3. View output + You may view or print the resulting @file{text.pdf}. -- 2.39.2