mark official sites, add more github protocols
[ikiwiki.git] / docs / how_to_get_to_the_desktop / index.mdwn
index 236d081..ab8632c 100644 (file)
@@ -1,24 +1,41 @@
 # How to get a desktop on DragonFly
 
 # How to get a desktop on DragonFly
 
-This topic is wildly out of date.  It is also mostly redundant as it covers the same ground as the "installing and configuring X" topic [[here|/docs/newhandbook/X].  
+**This topic is wildly out of date for example the command pkg_radd is no longer used, and the pkg install command is used instead. **
+ It is also mostly redundant as it covers the same ground as the "installing and configuring X" topic [in the new handbook, which is located here](/docs/handbook/X).  
 
 [[!toc levels=3 ]]
 
 
 [[!toc levels=3 ]]
 
-## Prerequisites
-To get to the desktop you need a working internet connection to download pkgsrc and the packages themselves.
+##Using the recommended package tools, pkg or dports
+
+to install xorg
+
+the quickest and most simple way is
+
+    #pkg install xorg
+
+or if you have dports installed and wish to build from src
+
+    #cd /usr/dports/x11/xorg && make install clean
+
+for most hardware, typing startx at the cmd line should start X
+
+if there is a failure, review section 5.4 of the FreeBSD handbook or section 9 of the NetBSD handbook
+
+unless you need or want to use NetBSD's pkgsrc, skip everything directly below (after installing xorg) and go to "Installing a Desktop Environment"
 
 ## Dealing with pkgsrc 
 
 ### Installing pkgsrc
 The basic pkgsrc tools are already provided with every DragonFly default installation, but you still have to download the pkgsrc tree to build and install packages.
 
 
 ## Dealing with pkgsrc 
 
 ### Installing pkgsrc
 The basic pkgsrc tools are already provided with every DragonFly default installation, but you still have to download the pkgsrc tree to build and install packages.
 
-First choose a mirror next to you which provides a git repo containing the pkgsrc tree, you can find them on the [DragonFly mirrors page](http://www.dragonflybsd.org/mirrors/). Next copy the mirrors adress into the Makefile contained in /usr.
+First choose a mirror next to you which provides a git repo containing the pkgsrc tree, you can find them on the [DragonFly mirrors page](http://www.dragonflybsd.org/mirrors/). Next copy the mirrors address into the Makefile contained in /usr.
 
 Now execute as root
 
     # cd /usr && make pkgsrc-create
 
 
 Now execute as root
 
     # cd /usr && make pkgsrc-create
 
-to initally create the pkgsrc tree.
+to initially create the pkgsrc tree.
 
 ### Searching a package
 Since there are many different packages in the pkgsrc tree you can use a small tool to find the one you are looking for in a short time. For example if you are looking for the ruby package just do
 
 ### Searching a package
 Since there are many different packages in the pkgsrc tree you can use a small tool to find the one you are looking for in a short time. For example if you are looking for the ruby package just do
@@ -32,7 +49,7 @@ and you will get a list of packages containing ruby in their name. If you want t
 and you will get the path leading to the package.
 
 ### Installing a package
 and you will get the path leading to the package.
 
 ### Installing a package
-You got two possibilities to install a package. The first one is to install it from source and the second one is to install prebuild binaries. Depending on your cpu and the size of the package its faster installing binaries, but if you want to change some build options you have to install it by source.
+You got two possibilities to install a package. The first one is to install it from source and the second one is to install prebuilt binaries. Depending on your cpu and the size of the package its faster installing binaries, but if you want to change some build options you have to install it by source.
 If you want to install binaries you only have to use the pkg_radd application. For example to install the xfce4 package just do:
 
     # pkg_radd xfce4
 If you want to install binaries you only have to use the pkg_radd application. For example to install the xfce4 package just do:
 
     # pkg_radd xfce4
@@ -85,7 +102,7 @@ or if you want to install them as binaries
 
 If you know which drivers you need install them on your own needs. They can be found in /usr/pkgsrc/x11/ and are named xf86-<video or input>-<driver name>
 
 
 If you know which drivers you need install them on your own needs. They can be found in /usr/pkgsrc/x11/ and are named xf86-<video or input>-<driver name>
 
-### Other importan X related packages
+### Other important X related packages
 Now we will install other important packages for X. We will need some additional libraries
 
     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-libs && bmake install clean
 Now we will install other important packages for X. We will need some additional libraries
 
     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-libs && bmake install clean
@@ -128,20 +145,94 @@ Now you can try to start the X server by doing
 as normal user.
 If everything works well you should see a white terminal and should be able to mover your mouse. Click into the terminal and test you keyboard layout. Now type exit into the terminal and you will return to TTY. If everything worked well you can continue with installing a desktop environment, if not you have to manually edit /etc/X11/xorg.conf . Also check the X.org documentation and the DragonFly handbook, where you may find a solution to your problem.
 
 as normal user.
 If everything works well you should see a white terminal and should be able to mover your mouse. Click into the terminal and test you keyboard layout. Now type exit into the terminal and you will return to TTY. If everything worked well you can continue with installing a desktop environment, if not you have to manually edit /etc/X11/xorg.conf . Also check the X.org documentation and the DragonFly handbook, where you may find a solution to your problem.
 
+# Packages
+
 ## Installing a Desktop Environment
 
 ## Installing a Desktop Environment
 
-This part will explain how to install the desktop environments KDE and Xfce, if you prefer GNOME or a standalone windowmanager you have to read other guides or documentation.
+This part will explain how to install the desktop environments Lumina,Mate, KDE and Xfce, if you prefer GNOME or a standalone windowmanager you have to read other guides or documentation.
+
+### Lumina
+To install Lumina desktop 
+
+    # pkg install lumina 
+  (this will also install xorg if not already installed)  
+
+To start 
+    $ start-lumina-desktop
+
+from cmd line
+or in users home dir
+
+    $ echo "/usr/local/bin/start-lumina-desktop" > .xinitrc
+
+exec start-lumina-desktop in .xinitrc will also work
+
+or to start xdm
+
+    # pkg install xdm
+    $ echo "/usr/local/bin/start-lumina-desktop" > .xsession
+
+and in /etc/ttys
+change off to on in line
+
+ttyv8 " /usr/local.bin/xdm -nodaemon" xterm on secure
+
+(note: putting xdm_enable="YES"  in /etc/rc.conf does not start xdm, the above does)
+
+###LXDE
+
+    #pkg install lxde-meta
+
+add to /etc/rc.conf
+
+dbus_enable="YES"
+
+hald_enable="YES"
+
+To start from command line with startx, add to ~/.xinitrc 
+
+exec startlxde
+
+###Window Maker ( window manager ) 
+
+     #pkg install windowmaker
+
+to start from command line with startx, add to ~/.xinitrc
+
+exec wmaker
+
+### Mate
+To install Mate simply install the mate meta-packages as root
+
+    # pkg install mate
+
+Edit /etc/rc.conf
+
+    dbus_enable="YES"
+    hald_enable="YES"
+
+Edit in home user .xinitrc
+
+     exec mate-session
+
+or to start xdm
+
+    # pkg install xdm
+    $ echo "exec mate-session" > .xsession
+
 ### KDE
 ### KDE
+
 KDE stands for K Desktop Environment, its a modern desktop environment, based on Nokia's QT-Framework, with many nice applications. If your computer has less than 1Gb RAM you should better install Xfce4 described later in this guide.
 Since the KDE and QT packages are pretty huge you can save much time when using binary packages.
 There are 2 different KDE meta-packages available: KDE3 and KDE4 . KDE3 is the older, but more stable release while KDE4 has many new features but also new bugs. So it's on you to decide which one you want to install.
 KDE stands for K Desktop Environment, its a modern desktop environment, based on Nokia's QT-Framework, with many nice applications. If your computer has less than 1Gb RAM you should better install Xfce4 described later in this guide.
 Since the KDE and QT packages are pretty huge you can save much time when using binary packages.
 There are 2 different KDE meta-packages available: KDE3 and KDE4 . KDE3 is the older, but more stable release while KDE4 has many new features but also new bugs. So it's on you to decide which one you want to install.
+
 For KDE3 simply do as root
 
 For KDE3 simply do as root
 
-    # pkg_radd kde3
+    # pkg install kde3
 
 For KDE4
 
 
 For KDE4
 
-    # pkg_radd kde4
+    # pkg install kde4
 
 Now that you have installed KDE we still need to start it.
 As user edit your ~/.xinitrc and comment the exec xterm part out and add exec startkde.
 
 Now that you have installed KDE we still need to start it.
 As user edit your ~/.xinitrc and comment the exec xterm part out and add exec startkde.
@@ -150,30 +241,26 @@ Now start it with executing startx as user. If everything works well you should
 Some users may prefer a graphical log in, KDE provides it's own display manager for them: kdm. It looks better than the X display manager xdm and provides more options. To start it at boot time simply change your ttyv8 line in /etc/ttys to ttyv8 “/usr/pkg/bin/kdm -nodaemon” xterm on secure .
 
 ### Xfce4
 Some users may prefer a graphical log in, KDE provides it's own display manager for them: kdm. It looks better than the X display manager xdm and provides more options. To start it at boot time simply change your ttyv8 line in /etc/ttys to ttyv8 “/usr/pkg/bin/kdm -nodaemon” xterm on secure .
 
 ### Xfce4
-Xfce is a lightweight desktop environment using the GTK+ toolkit (like GNOME) it has less applications than KDE but if your computer isn't that good it's the better choice. 
-To install Xfce4 simply install the xfce4 and xfce4- meta-packages as root
 
 
-    # pkg_radd xfce4 && pkg_radd xfce4-extras
-or if you want to compile them yourself
+    # pkg install xfce
 
 
-    # cd /usr/pkgsrc/meta-pkgs/xfce4 && bmake install clean
-    # cd /usr/pkgsrc/meta-pkgs/xfce4-extras && bmake install clean
+then add to /etc/rc.conf
 
 
-To test if it works edit your ~/.xinitrc as user, comment the exec xterm part out and add exec startxfce4.
-Since Xfce doesnt have its own display manager for a graphical login so you have to install one yourself. You could either install xdm, kdm or gdm. Gdm is the GNOME display manager and also uses the GTK+ toolkit so it's a good choice for Xfce, too.
-Install gdm by executing
+     dbus_enable="YES"
+     hald_enable="YES"
 
 
-    # pkg_radd gdm
+To start from command line with 
+    $startx
 
 
-or
+add to ~/.xinitrc 
+exec startxfce4
 
 
-    # cd /usr/pkgsrc/x11/gdm && bmake install
+or simply enter 
 
 
-To start it at boot time you can simply add gdm_enable=”YES” to your /etc/rc.conf 
+    $startxfce4
 
 # How to continue?
 
 # How to continue?
-Now after you installed the basic desktop you may wish to add additional applications such as a browser like firefox:
+Now after you installed the basic desktop you may wish to add additional applications such as a browser like firefox
 
 
-    # pkg_radd firefox
+    # pkg install firefox 
 
 
-You are fully free what to do now and pkgsrc offers a lot of desktop packages you could install. Have fun with your desktop!