Skip to content

Commit

Permalink
Fix some outdated info
Browse files Browse the repository at this point in the history
  • Loading branch information
simula67 committed Jun 18, 2017
1 parent 37da47f commit 54ecdca
Show file tree
Hide file tree
Showing 57 changed files with 12,623 additions and 10,898 deletions.
Binary file modified build/doctrees/components.doctree
Binary file not shown.
Binary file modified build/doctrees/environment.pickle
Binary file not shown.
Binary file modified build/doctrees/goodies.doctree
Binary file not shown.
Binary file modified build/doctrees/index.doctree
Binary file not shown.
Binary file modified build/doctrees/install.doctree
Binary file not shown.
Binary file modified build/doctrees/install/freebsd.doctree
Binary file not shown.
Binary file modified build/doctrees/install/linux.doctree
Binary file not shown.
Binary file modified build/doctrees/install/netbsd.doctree
Binary file not shown.
Binary file modified build/doctrees/misc_tips.doctree
Binary file not shown.
Binary file modified build/doctrees/whatis.doctree
Binary file not shown.
4 changes: 2 additions & 2 deletions build/html/.buildinfo
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 5c62ae9c187d1cf07d4205d1dff0a34c
tags: fbb0d17656682115ca4d033fb2f83ba1
config: 23bb7c45e2c1c5733c5212f9daff616c
tags: 645f666f9bcd5a90fca523b33c5a78b7
63 changes: 63 additions & 0 deletions build/html/_sources/components.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
Components of Xfce
==================

Following are the most important components of Xfce and a short description of what is possible with them.

Xfce4 Settings Manager
----------------------

Xfce Settings Manager (*xfce4-settings-manager*) is the central point from where you can configure your whole Xfce installation.

Please be mindful to take a look under:

* Appearence

* Style (Xfce Theme)
* Icons
* Fonts

* Keyboard --> Application Shortcuts
* Window Manager --> Style
* Window Manager Tweaks


Xfce Panel
----------

Xfce Panel (*xfce4-panel*) is the panel application for Xfce. You can configure the Xfce panels using the following command

.. code-block:: none
xfce4-panel --preferences
You can also find the panel preferences at Xfce Settings Manager --> Panel.

Alternatively, you can also find panel preferences from Right Clicking on an existing panel and choosing Panel --> Panel Preferences.

.. figure:: _static/images/panel_preferences.png
:alt: Panel Preferences
:align: center

Another way to find panel preferences

Xfdesktop
---------

Xfdesktop (*xfdesktop*) manages your desktop. It displays your wallpapers, files and folders on your **Desktop** folder helps you copy and paste the file to and from your Desktop to other locations using your File Manager etc.


Xfwm4
-----

Xfwm4 (*xfmw4*) manages your windows. This application is what is usually called a Window Manager. Window Managers decorate your windows with close, minimize, restore buttons, provides title, icons and decides which windows should recieve focus based on your actions amongst many other things.

This is why it is important to choose a proper theme for xfwm4 also (on top of standard Xfce theme) if you plan to use Xfce. This can be done inside Xfce Settings Manager --> Window Manager --> Style.


Thunar
------

Thunar (*thunar*) is the file manager written for Xfce. File Managers help you organize your files, transfer files between your computer and other devices like Pen Drive, and helps you preview and easily copy also helps you perform a variety of custom actions.


17 changes: 17 additions & 0 deletions build/html/_sources/goodies.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
Some goodies available with Xfce
================================

Along with Xfce core, the developers have also prepared a number of utility software to go with Xfce under another project called xfce4-goodies.


Xfce Terminal Emulator
----------------------

Xfce Terminal Emulator (*xfce4-terminal*) is the Xfce version of the terminal emulators available for other desktop environments. A terminal emulator is a small program inside which your shell ( such as bash, zsh etc ) runs. You can use any terminal emulator of your choice with Xfce, however Xfce Terminal is very lightweight and very responsive. This means you can open tabs very easily, switch between open tabs and open large number of terminals in the blink of an eye. It is so fast and flexible that you will no longer need applications like GNU Screen.

Mousepad
--------

Mousepad (*mousepad*) is an Xfce implementation of Windows Notepad. This will be very useful for temporarily saving small fragments of text, opening files quickly for previews or writing large amounts of text.


28 changes: 28 additions & 0 deletions build/html/_sources/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
.. Xfce: The Missing Manual documentation master file, created by
sphinx-quickstart on Fri Dec 21 23:43:59 2012.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Welcome to Xfce: The Missing Manual!
====================================

This is an unofficial user manual for `Xfce <http://www.xfce.org/>`_, the lightweight desktop environment. This document is not meant to be comprehensive, and only attempts to cover the basics to get you up and running.

Contents

.. toctree::
:maxdepth: 2

whatis
install
components
goodies
misc_tips

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

14 changes: 14 additions & 0 deletions build/html/_sources/install.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
How to install Xfce?
====================

Well, it depends on your system. Xfce is available on a plethora of Operating Systems including:


.. toctree::
:maxdepth: 2

install/linux.rst
install/freebsd.rst
install/netbsd.rst


2 changes: 2 additions & 0 deletions build/html/_sources/install/freebsd.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Installing Xfce on FreeBSD
==========================
112 changes: 112 additions & 0 deletions build/html/_sources/install/linux.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
Linux
=====

Linux needs no introduction. It is the most popular Unix based Operating System out there. Following are descriptions about installing Xfce on some of the major `Linux Distributions <http://en.wikipedia.org/wiki/Linux_distribution>`_.


Ubuntu
------

To test out Xfce in Ubuntu you can use `Xubuntu <http://xubuntu.org/getxubuntu/>`_.

Alternatively, you can download Ubuntu from `Ubuntu.com <http://www.ubuntu.com/download>`_ and type the following command into terminal

.. code-block:: none
sudo apt-get install xubuntu-desktop
If you want to use *stock* Xfce (which is highly recommended), you can use the following description.

Installing Xfce on Ubuntu 16.04 LTS involves three main steps :

1. Opening up terminal

* Click on the dash icon

.. figure:: ../_static/images/ubuntu_install/1_click_on_dash_icon.png
:alt: Click on Dash Icon
:align: center

Click on the dash icon

* Now search for the terminal software. Click on the terminal icon to open the terminal application.

.. figure:: ../_static/images/ubuntu_install/2_search_for_terminal_and_select_terminal_application.png
:alt: Search for terminal application software
:align: center

Search and find the terminal application

2. Entering the command to install Xfce

Once the terminal application opens up you need to enter the following command to install Xfce:

.. code-block:: none
sudo apt-get install xfce4 xfce4-goodies
You may be prompted to enter your pasword and authenticate your install.


.. figure:: ../_static/images/ubuntu_install/3_command_xfce_install.png
:alt: Type in command to install Xfce
:align: center

Enter the command to install Xfce


You will need to be connected to the Internet to begin the installation. Once you authenticate, Ubuntu will begin downloading and installing Xfce on your computer.

.. figure:: ../_static/images/ubuntu_install/4_downloading_xfce_hddtemp.png
:alt: Downloading and installing Xfce
:align: center

Downloading and installing Xfce

On Ubuntu 12.04 LTS, you may be prompted to answer a question about hddtemp during installation. Please do not worry about this and press ENTER to select the default "No" option.

3. Logging out, selecting and logging into Xfce

* Now, if you want to use your brand new Xfce installation, please log out.

.. figure:: ../_static/images/ubuntu_install/5_logout.png
:alt: Logout
:align: center

Logout

* Click on the Ubuntu icon.

.. figure:: ../_static/images/ubuntu_install/6_click_on_ubuntu_icon.png
:alt: Click on Ubuntu icon
:align: center

Click on Ubuntu Icon

* Click on Xfce Session

.. figure:: ../_static/images/ubuntu_install/7_click_on_xfce_session.png
:alt: Select Xfce Session
:align: center

Click on Xfce Session Icon

* Enter your password and log into Xfce

.. figure:: ../_static/images/ubuntu_install/8_sign_into_xfce.png
:alt: Login
:align: center

Log into Xfce

* When logging in, select "Use Default Configuration" to get the standard Xfce desktop.

.. figure:: ../_static/images/ubuntu_install/9_click_on_use_default_config.png
:alt: Default Xfce configuration
:align: center

Xfce Desktop.


Voila! You have entered the default Xfce desktop.

28 changes: 28 additions & 0 deletions build/html/_sources/install/netbsd.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
Installing Xfce 4.12 on NetBSD
==============================

From binaries:
--------------

# pkgin -y in xfce4 xfce4-extras

or


# pkg\_add xfce4 xfce4-extras

From `pkgsrc <http://pkgsrc.org/>`__ (source package manager for NetBSD and others):
------------------------------------------------------------------------------------

# cd /usr/pkgsrc/meta-pkg/xfce4

# make install clean

# cd /usr/pkgsrc/meta-pkg/xfce4-extras

# make install clean

Besides the meta packages, there are more xfce applications, panel
plugins, thunar plugins you can install, see the `List of xfce packages
in pkgsrc <http://pkgsrc.se/search.php?so=xfce4>`__. `More information
on xfce packages for pkgsrc <https://wiki.netbsd.org/xfce4/>`__
36 changes: 36 additions & 0 deletions build/html/_sources/misc_tips.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
Using your keyboard shortcuts wisely
====================================

Xfce provides you with an easy to use way to manage your keyboard shortcuts. You should take full advantage of this to accomplish your common chores quickly. For example, it is very easy to set up your Super ( Windows ) key to start a terminal so that you can quickly start typing in your commands.

Another common use for keyboard shortcuts is to use your media keys to control your media players. For example you can bind your "Media PLAY button" to this command :

.. code-block:: none
rhythmbox-client --play-pause
This would mean that you can use your Media PLAY button to PLAY/PAUSE your music from Rhythmbox.

Scrolling
=========

Mouse scrolling is another useful feature in Xfce. In Xfce, scrolling is largely context based. That is, what a scroll does depends on where the mouse cursor is currently positioned.

.. figure:: _static/images/scroll_example_1.png
:alt: Scroll Example 1
:align: center

Scrolling at Workspace Switcher switches between workspaces

.. figure:: _static/images/scroll_example_2.png
:alt: Scroll Example 1
:align: center

Scrolling at Tabs List inside Google Chrome switches between different open tabs

.. figure:: _static/images/scroll_example_3.png
:alt: Scroll Example 1
:align: center

Scrolling at Task List switches between different different open windows

30 changes: 30 additions & 0 deletions build/html/_sources/whatis.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
What is Xfce?
=============

Xfce is a lightweight `desktop environment <http://en.wikipedia.org/wiki/Desktop_environment>`_ built for simplicity and efficiency. Xfce takes up far less space than other desktop environments such as KDE, GNOME, Unity etc and is very responsive. Xfce philosophy is to get out of your way and let you complete your work efficiently and easily.

Xfce project has a high emphasis on stability meaning that core functionality does not change frequently causing you to re-learn your workflow.

Why not use other lightweight environments ?
============================================

You can! It is all about choice. There are a variety of reasons to use Xfce:

1. Familiar windows and other User Interface widgets.
2. Xfce is fairly powerful, despite being simple.
3. Xfce evolves slowly with bug fixes taking priority over feature addition and bloat.
4. Xfce is free, open-source and user-friendly

What is your point?
===================

Since Xfce is a fairly simple environment to set up, many folks do this on their own. There are some who use pre-configured environments such as Xubuntu. While this is a very valid choice, it is recommended that you set up your environment yourself. There may be different aspects of your system you care about and it is useful to get those right trade-offs that help you work effectively on your computer. This is actually where Xfce excells at and there are only a few environments out there that help you get them exactly right.


Caveats of this document
========================

First of all, this documentation is not in any way assosciated to the Xfce project. This is unofficial documentation. Hence, it may contain factual inaccuracies, outdated information and/or philosophical differences from Xfce and assosciated projects. Therefore, you should consult official documentation when in doubt.

Secondly, since there are a variety of configurations and environments to run Xfce on, this documentation will be based on Ubuntu 12.04 LTS installation of stock Xfce. Although the concepts explained here may be valid for other environments, it may also not be.

0 comments on commit 54ecdca

Please sign in to comment.