INSTALL AND RUN This will give you a virtual box Linux machine with Linux Mint 18 (Xfce edition) and inkscape-web (revision 1460) preinstalled. Make sure you have 20 GB of disk space available. Work on a machine that has as much RAM / CPU power as possible. 1. Install VirtualBox for your operating system from https://www.virtualbox.org/ 2. Download the virtual machine (2.9 GB) from https://sourceforge.net/projects/dodger-tools/files/vms/LM18XfceInkTrunk.ova/download . 3. Start VirtualBox. 4. Import the virtual machine: File -> Import Appliance. If necessary, adjust the RAM you want to allocate to the machine (it's currently quite a lot with 6GB). 5. Start the virtual machine. To be able to copy-paste from your desktop to the vm and back, choose Devices -> Common Clipboard -> bidirectional, and make it permanent, if you like. 6. Login, name: test, pw: test . You can change the keyboard language using the icon at the top of the login dialog, you can also change it with the flag button in the bottom right when logged in. 7. Open a terminal (computer icon at the bottom) 8. Go into directory with inkscape-web files: cd ~/Desktop/inkscape-web 9. Start local server: ./utils/manage runserver 10. Open Firefox (already comes with bookmarks and adblocker) or Chromium (modified version of google chrome, blue icon in the panel) in the VM, and navigate to localhost:8000 ==================== EDITING To edit the CSS and other files, you can either: A) make the folder on your virtual machine available to access from your host machine, see https://www.virtualbox.org/manual/ch04.html#sharedfolders (this technique: https://help.ubuntu.com/community/VirtualBox/SharedFolders might not work, because of the virtualenv which doesn't like to be moved around.) or B) install an appropriate text editor inside the virtualbox Linux machine. One that is preinstalled is Kate, but there are many others available. Browse the available apps and install new ones: Menu -> System -> Software Manager . The password is test. or C) just use Firefox's / Chromium's options for the directly accessible files (i.e. CSS, js, images). ==================== ASKING FOR YOUR CHANGES TO BE INCLUDED Option A) make your changes available as a branch on launchpad (see last section), or, if you have permissions, push directly to the main branch on launchpad. Option B) put your changes into a patch file and upload it as an attachment to a new bug report: 1. Open a terminal 2. Enter: cd ~/Desktop/inkscape-web 3. To see your changes, enter: bzr diff 4. To see a list of files you have changed, enter: bzr status 5. To give your changes a version number, enter: bzr commit -m "Your message about your changes" 6. Create a patch file with: bzr send -o ~/Desktop/mypatch.patch 7. Open browser, create bug report for inkscape-web, attach file which should be on your desktop. More infos at http://wiki.inkscape.org/wiki/index.php/WebSite. ==================== UPDATING YOUR INSTALLATION OF INKSCAPE-WEB: 1. Open a terminal 2. Enter: cd ~/Desktop/inkscape-web 3. Enter: bzr pull 4. Enter: ./utils/update ==================== EXTRAS The VM also contains a trunk version of Inkscape. Use the desktop icon to start it. To update, use the update manager (shield icon in bottom right corner in the task bar). ========================= UPLOADING YOUR CHANGES TO LAUNCHPAD If you ever want to upload your changes to launchpad, you need to do the following, so launchpad will accept your uploads: Tutorial for bzr usage: http://doc.bazaar.canonical.com/beta/en/mini-tutorial/index.html STEP 1: Generate ssh key and upload to launchpad 1. Open a terminal by clicking on the little computer screen icon at the bottom. 2. Create a new ssh key by entering: ssh-keygen 3. Confirm suggested save location. 4. Choose a safe password (> 5 characters). 5. Double-click on the 'Home' folder icon on desktop, make sure hidden files are shown: View -> Show hidden files (or Ctrl+H). 6. Navigate to .ssh 7. Double-click on the file id_rsa.pub to open it. 8. Open webbrowser (Firefox is installed, icon at the bottom) 9. Visit launchpad website (you can use the bookmark) 10. Choose to register or log in. If you register, perform all the necessary steps. 11. Visit your launchpad profile 12. Click on the little exclamation mark at 'SSH keys' 13. Paste the contents of the open file id_rsa.pub into the form. You may change the part 'test@...139...' to your own identifier (preserve the @). Save. Confirm by entering your launchpad credentials. STEP 2: Tell the version control system who you are: 1. Open a terminal (or use the one that is already open) 2. Enter: bzr whoami "Your Name " 3. Enter: bzr launchpad-login your-launchpad-username STEP 3: Commit and upload your changes: 1. Open a terminal (or use the one that is already open) 2. To see your changes, enter: bzr diff 3. To see which files you have changed, enter: bzr status 4. To give your changes a version number, enter: bzr commit -m "Your message about your changes" 5. To upload your versioned changes to your personal branch at launchpad, enter: bzr push lp:~your_launchpad_username/inkscape-web/your_branch_name 6. If you want to ask for your changes to be included into the main branch, visit launchpad website, browse to https://code.launchpad.net/inkscape-web . Click on your new branch in the list. Click on 'Propose for merging' and fill in the form to ask someone to merge / review your changes.