Merge 731f3cd496 into 784b320e49

8 years ago · 77188da7d5
--- a/Documentation:Repository:Meta-Packages.php
+++ b/Documentation:Repository:Meta-Packages.php
@@ -1,59 +1,134 @@
 <?php
 $PAGE_TITLE    = "KXStudio : Documentation";
 $PAGE_TYPE     = "NONKXSTUDIO";
 $PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:Meta-Packages");
 $PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "Meta-Packages");
 $PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:Upgrade");
 $PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "Upgrade");
 include_once("includes/header.php");
 ?>

 <p>
    This section describes all the meta-packages available in the KXStudio-Team Ubuntu repositories, splitted by type.
    This section describes how to upgrade from a regular Ubuntu 14.04 install (or variants), to a cool and fresh KXStudio Desktop.<br />
    <span style="color:#fa3a3a;">This method has been tested to work in Ubuntu 14.04 based systems</span>.
 </p>

 <h5><span class="mw-headline" id="MainMetaPackages">Main Meta-Packages</span></h5>
 <p><br/></p>

 <h5><span class="mw-headline" id="Step1">Step 1 - Enable the repositories</span></h5>
 <p>
    The main meta-packages will simply install Audio, Graphic or Video applications.<br />
    The Audio meta-package is also split into plugin categories, for anyone that wants more plugins, but not actually more applications.<br />
    It's not like your KXStudio system will get slower with a bit more applications though...
    Open up the 'Terminal' (found in the applications), and run these commands<br/>
    <code>
    	sudo apt-get install software-properties-common wget<br/>
    	sudo add-apt-repository ppa:kxstudio-debian/kxstudio
    </code>
 </p>
 <p>
    The main meta-packages are:
    KXStudio officially supports KDE4. You can still install KXStudio if using any other Desktop Environment,<br/>but there's no meta-packages for them, and we'll not document the install process here.<br/>
 Create a new topic in the forums if you want support for other DEs.
 </p>

 <p>
    Next, reload the sources (method depends on the current application), and install the package 'kxstudio-repos'. Then reload the sources again.<br />
    You can do the same thing in the command-line with:<br />
    <code>
        sudo apt-get update<br/>
        sudo apt-get install kxstudio-repos<br/>
        sudo apt-get update
    </code>
 </p>

 <p><br/></p>

 <h5><span class="mw-headline" id="Step2">Step 2 - Update the system</span></h5>
 <p>
    Once you've got the repositories set-up, it's time to upgrade the system (ie, update the software, not upgrade to a newer Ubuntu release!).
 </p>
 <p>
    Simply use whatever tool your Desktop Environment provides (Ubuntu Software Center, Synaptic, Update Manager, KPackageKit, Muon, etc).<br />
    If you want to use the command-line, or if you just got too many dependency conflicts (can happen if you enabled many PPAs before upgrading to KXStudio), the command is:<br />
    <code>
        sudo apt-get dist-upgrade
    </code><br/>
    Even though it says 'dist-upgrade', it will not update the Ubuntu version. In this case, 'dist' means something like "resolve conflicts, even if some stuff gets removed".<br />
 </p>
 <p>
    This step will take some time. Some minor questions may appear while the upgrade takes place.
 </p>

 <p><br/></p>

 <h5><span class="mw-headline" id="Step3">Step 3 - Install the KXStudio Desktop</span></h5>
 <p>
    After the upgrade, it's time to install the main KXStudio packages.<br />
    Just like you did to install the 'kxstudio-repos' package, now install:
 </p>
 <ul>
    <li>kxstudio-meta-audio</li>
    <li>kxstudio-meta-audio-plugins</li>
    <li>kxstudio-meta-audio-plugins-ladspa</li>
    <li>kxstudio-meta-audio-plugins-dssi</li>
    <li>kxstudio-meta-audio-plugins-lv2</li>
    <li>kxstudio-meta-audio-plugins-vamp</li>
    <li>kxstudio-meta-audio-plugins-vst</li>
    <li>kxstudio-meta-graphics</li>
    <li>kxstudio-meta-video</li>
 </ul>
 <p>
    Some notes:<br/>
    'audio' recommends 'audio-plugins', and 'audio-plugins' depends on all it's sub-packages.<br />
    With the exception of KXStudio 12.04, 'graphics' recommends 'ubuntustudio-font-meta', which will install a nice collection of fonts.<br />
    On KXStudio 12.04, you have to install 'ubuntustudio-font-meta' manually if you want that font collection.
    <code>
    For KDE4 -&gt; 'kxstudio-desktop-kde4'<br />
    </code><br/>
    For other systems install 'kxstudio-desktop-base' and the ubuntu related package, like 'lubuntu-desktop' for LXDE<br />
 </p>

 <p><br/></p>

 <h5><span class="mw-headline" id="ExtraMetaPackages">Extra Meta-Packages</span></h5>
 <h5><span class="mw-headline" id="Step4">Step 4 - Install the Multimedia Software</span></h5>
 <p>
    The extra meta-packages are:
    This step is almost optional. Here we install the basic software for Audio, Graphics and Video.<br />
    Just like before, it's time to install some new meta-packages. They are available as listed here (following a tree view of dependencies):
 </p>
 <ul>
    <li>kxstudio-meta-codecs <i>(12.04 only)</i></li>
    <li>kxstudio-meta-all</li>
    <ul>
        <li>kxstudio-meta-audio</li>
        <ul>
            <li>kxstudio-meta-audio-plugins</li>
            <ul>
                <li>kxstudio-meta-audio-plugins-dssi</li>
                <li>kxstudio-meta-audio-plugins-ladspa</li>
                <li>kxstudio-meta-audio-plugins-lv2</li>
                <li>kxstudio-meta-audio-plugins-vamp</li>
                <li>kxstudio-meta-audio-plugins-vst</li>
            </ul>
        </ul>
        <li>kxstudio-meta-graphics</li>
        <li>kxstudio-meta-video</li>
    </ul>
    <li>kxstudio-meta-codecs</li>
    <li>kxstudio-meta-restricted-extras</li>
 </ul>
 <p>
    The 'codecs' package is self-explanatory, it will install a collection of codecs for gstreamer, sox and xine.<br />
    Install the meta-packages you want just like before (ie, search for the package and click to install, or use in command-line: <code>sudo apt-get install &lt;package-name&gt;</code>)<br />
    See <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Meta-Packages">Documentation:Ubuntu:Meta-Packages</a> for a description of these meta-packages.<br />
 </p>
 <p>
    Note - meta-all recommends restricted extras, and audio recommends audio-plugins.
 </p>

 <p><br/></p>

 <h5><span class="mw-headline" id="Step5">Step 5 - Install a Kernel (Optional)</span></h5>
 <p>
    This step is optional, and mostly useful for audio production only.<br />
    Installing a kernel in KXStudio couldn't be easier - just install this package.
 </p>
    <code>
        sudo apt-get install linux-lowlatency
    </code>

 <p><br/></p>

 <h5><span class="mw-headline" id="Step6">Step 6 - Reboot and update settings</span></h5>
 <p>
    After all this, it's time to reboot.<br />
    The next time you login, you'll see the KXStudio Welcome Screen to help you update your settings (and maybe the theme too).<br />
    You should also run 'cadence' and change your JACK settings to your preference.<br />
    Finally, if you installed 'kxstudio-desktop-kde4' logout and just re-login to kde plasma after updating the settings.
 </p>

 <p><br/></p>

 <h5><span class="mw-headline" id="Step7">Step 7 - Enjoy!</span></h5>
 <p>
    The 'restricted-extras' is simply a combination of '[k|x]ubuntu-restricted-extras', and some other minor "restricted" stuff.<br />
    (In this case, "restricted" means that it can't be installed in Ubuntu by default, but you're safe to do it afterwards).<br />
    This package recommends 'kxstudio-meta-codecs'.
    Of course, now it's time to enjoy!
 </p>

 <p><br/></p>