From: James Lowe Date: Tue, 8 Dec 2009 18:51:41 +0000 (+0000) Subject: Doc: Added step by step section to the Learning manual for MacOs. Included screenshot... X-Git-Tag: release/2.13.9-1~8 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=cf565950ecb4d7c86a1dd66cd7145264fd97f32f;p=lilypond.git Doc: Added step by step section to the Learning manual for MacOs. Included screenshots and wrote out the steps to open the application save the default file that is created the first time Lilypons is run and how to generate the PDF. --- diff --git a/Documentation/learning/tutorial.itely b/Documentation/learning/tutorial.itely index 61a27a404f..cfbcf46182 100644 --- a/Documentation/learning/tutorial.itely +++ b/Documentation/learning/tutorial.itely @@ -128,23 +128,58 @@ first. After this, LilyPond will be much faster!} @node MacOS X @subsection MacOS X -@warning{These instructions assume that you are using the built-in -LilyPad editor. If you are using any of the programs described in +@warning{These instructions assume that you are using the Lilypond +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 compiling a file.} +those programs if you have any problems.} +Double click the @command{LilyPond.app}, an example file will open. -If you double click @command{LilyPond.app}, it will open with an -example file. Save it, for example, to @file{test.ly} on your -Desktop, and then process it with the menu command -@w{@code{Compile > Typeset File}}. The resulting PDF file will be -displayed on your screen. +@sourceimage{Learning_Macos_welcome,,,} -For future use of LilyPond, you should begin by selecting @q{New} -or @q{Open}. You must save your file before typesetting it. If -any errors occur in processing, please see the log window. +From the menus along the top left of your screen, select +@w{@code{File > Save}}. -@c FIXME: add screenshots +@sourceimage{Learning_Macos_Save_menu,,,} + +Choose a name for your file, for example @file{test.ly}. + +@sourceimage{Learning_Macos_Save_file_with_name,,,} + +From the same menus, select +@w{@code{Compile > Tyepset}}. + +@sourceimage{Learning_Macos_Typeset_menu,,,} + +A new window will open showing a progress log of the compilation +of the file you have just saved. + +@sourceimage{Learning_Macos_Compiling_log,,,} + +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,,,} + +To create new files for Lilypond, begin by selecting +@w{@code{File > New}} + +@sourceimage{Learning_Macos_New_menu,,,} + +or @w{@code{File > Open}} to open and edit existing files you have +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 +check the window with the progress log for any errors. + +If you are not using the defualt Preview PDF viewer that comes +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 diff --git a/Documentation/pictures/Learning_Macos_Compiling_log.png b/Documentation/pictures/Learning_Macos_Compiling_log.png new file mode 100644 index 0000000000..727f2afee9 Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Compiling_log.png differ diff --git a/Documentation/pictures/Learning_Macos_New_menu.png b/Documentation/pictures/Learning_Macos_New_menu.png new file mode 100644 index 0000000000..22d9a29bbd Binary files /dev/null and b/Documentation/pictures/Learning_Macos_New_menu.png differ diff --git a/Documentation/pictures/Learning_Macos_Open_Dialog_box.png b/Documentation/pictures/Learning_Macos_Open_Dialog_box.png new file mode 100644 index 0000000000..674d7d6b1a Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Open_Dialog_box.png differ diff --git a/Documentation/pictures/Learning_Macos_Open_menu.png b/Documentation/pictures/Learning_Macos_Open_menu.png new file mode 100644 index 0000000000..6af7004228 Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Open_menu.png differ diff --git a/Documentation/pictures/Learning_Macos_Save_file_with_name.png b/Documentation/pictures/Learning_Macos_Save_file_with_name.png new file mode 100644 index 0000000000..54bdf2b15d Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Save_file_with_name.png differ diff --git a/Documentation/pictures/Learning_Macos_Save_menu.png b/Documentation/pictures/Learning_Macos_Save_menu.png new file mode 100644 index 0000000000..87df030380 Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Save_menu.png differ diff --git a/Documentation/pictures/Learning_Macos_Typeset_menu.png b/Documentation/pictures/Learning_Macos_Typeset_menu.png new file mode 100644 index 0000000000..42a247c767 Binary files /dev/null and b/Documentation/pictures/Learning_Macos_Typeset_menu.png differ diff --git a/Documentation/pictures/Learning_Macos_pdf_output.png b/Documentation/pictures/Learning_Macos_pdf_output.png new file mode 100644 index 0000000000..de14971978 Binary files /dev/null and b/Documentation/pictures/Learning_Macos_pdf_output.png differ diff --git a/Documentation/pictures/Learning_Macos_welcome.png b/Documentation/pictures/Learning_Macos_welcome.png new file mode 100644 index 0000000000..87f0dbaa3c Binary files /dev/null and b/Documentation/pictures/Learning_Macos_welcome.png differ