| [ << Introduction to contributing ] | [Top][Contents][Index][ ? ] | [ Working with source code >> ] | ||
| [ < Overview of work flow ] | [ Up : Introduction to contributing ] | [ Mentors > ] | ||
1.3 Lilybuntu
It is not possible to compile LilyPond on Windows, and extremely difficulty to compile it on MacOS X. We have therefore made a ‘remix’ of Ubuntu which includes all necessary dependencies to compile both LilyPond and the documentation. This can be run inside a virtual machine without disturbing your main operating system.
-
Install some virtualization software.
Any virtualization tool can be used, but we recommend VirtualBox Open Source Edition (lower half of the linked page):
http://www.virtualbox.org/wiki/Downloads
In virtualization terminology, your main operating system is the “host”.
-
Download the ‘lilybuntu.iso’ disk image.
http://files.lilynet.net/lilybuntu.iso
-
Install ‘lilybuntu.iso’ as the “client” operating system
on your virtualized system.
The latest version of lilybuntu is based on Ubuntu 9.04; if you encounter any difficulties installing it, search for one of the many tutorials for installing Ubuntu 9.04 as a client operating system.
If possible, use at least 700 MB of RAM (1GB would be better) for the virtual machine, and use a dynamically expanding virtual hard drive. A complete compile of everything (code, docs, regression tests) can reach 10 GB.
-
Do any extra configuration for your virtualization software.
VirtualBox has extra “guest additions” which can make the virtualization easier to use (full-screen, easy file sharing between host and client operating systems, shared clipboards, etc). Follow the normal procedures for your virtualization software with Ubuntu 9.04 as the client.
Follow instructions for Linux when reading instructions about Working with source code, or Compiling.
| [ << Introduction to contributing ] | [Top][Contents][Index][ ? ] | [ Working with source code >> ] | ||
| [ < Overview of work flow ] | [ Up : Introduction to contributing ] | [ Mentors > ] | ||