diff --git a/docs/welcome/attributes.html b/docs/welcome/attributes.html index 37b37af449..b05fbf01b8 100644 --- a/docs/welcome/attributes.html +++ b/docs/welcome/attributes.html @@ -1,31 +1,59 @@ - - - - Attributes - - - - - - - - - - - - - - - - + + + + + + + + + +
-

Logo

-
-

dummy

-
-

-

Attributes

+ + + + File Attributes + + + + + + + + + + + + + + + + + + + + + + + + + + -
+ logo + + logo + + File Attributes +
+ logo + + logo +
  + Welcome +     + Previous: Filetypes +     + Next: Index +  
  + +
+

File Attributes

Attributes are data fields that belong to a file but aren't part of that file, e.g. they are not computed into the file size and can be copied or changed without touching the file itself. The system uses these attributes to store e.g. file size, file type or date of the last modification. This is similar to other operating systems and their filesystems.

What's different is that you can add any kind of attribute to any file and display it or make it editable in a Tracker window. You just have to define the kind of attribute you want to add to a file type (e.g. string, integer or time) and give it a name and description.

The file itself doesn't even need any contents at all. Take a look at these People files for example: @@ -132,7 +160,24 @@ More information on these commands and their options can be found by typing the command name followed by "-h" or "--help".

-
- - +
+ +		 
  + Welcome +     + Previous: Filetypes +     + Next: Index +  
+ + diff --git a/docs/welcome/deskbar.html b/docs/welcome/deskbar.html index 8ee5006111..351f642f9b 100644 --- a/docs/welcome/deskbar.html +++ b/docs/welcome/deskbar.html @@ -1,30 +1,58 @@ - - - - The Deskbar - - - - - - - - - - - - - - - - + + + + + + + + + +
-

Logo

-
-

dummy

-
-

+ + + + The Deskbar + + + + + + + + + + + + + + + + + + + + + + + + + + -
+ logo + + logo + + The Deskbar +
+ logo + + logo +
  + Welcome +     + Previous: The Tracker +     + Next: Filetypes +  
  + +

The Deskbar

The Deskbar is the little panel that by default is located in the upper right corner of the screen. It's Haiku's version of Windows' taskbar with its Start button. It contains the Deskbar menu from where you can start applications and preferences, a tray with a clock and other tools below that and a list of currently running programs at the bottom.

@@ -82,7 +110,25 @@ Here you can also launch a calendar that also appears, when you hold down the le

If you activated Expanders in the Deskbar settings, you can show/hide the list of windows directly under an application's entry.

In front of every application's windows is a symbol providing info on its state. A bright symbol means a window is visible, a dark one that it's minimized. Three lines in front of a symbol shows that it's not on the current workspace.

-
- - + +
+ +		 
  + Welcome +     + Previous: The Tracker +     + Next: Filetypes +  
+ + diff --git a/docs/welcome/filetypes.html b/docs/welcome/filetypes.html index 9de22ed6f6..7b102300eb 100644 --- a/docs/welcome/filetypes.html +++ b/docs/welcome/filetypes.html @@ -1,30 +1,58 @@ - - - - Filetypes - - - - - - - - - - - - - - - - + + + + + + + + + +
-

Logo

-
-

dummy

-
-

+ + + + Filetypes + + + + + + + + + + + + + + + + + + + + + + + + + + -
+ logo + + logo + + Filetypes +
+ logo + + logo +
  + Welcome +     + Previous: The Deskbar +     + Next: File Attributes +  
  + +

Filetypes

Other than Windows, Haiku doesn't rely on the 3-letter file extension for a file type (e.g. .txt, .jpg, .mp3). This method is only a last resort fallback. Haiku uses MIME types just like it's custom on the internet.


@@ -64,7 +92,24 @@

Then there's the list of supported filetypes. You can add (and remove) filetypes if you think the application can handle them. As a consequence, the app will appear in the menu for preferred applications or Tracker's Open with... context menu when you right-click on a file of that type.

At the bottom are version and copyright information. Like the application signature, they are filled in by the app's author and shouldn't be altered.

-
- - +
+ +		 
  + Welcome +     + Previous: The Deskbar +     + Next: File Attributes +  
+ + diff --git a/docs/welcome/gui.html b/docs/welcome/gui.html index 5b689e4859..a2eb9e8bc4 100644 --- a/docs/welcome/gui.html +++ b/docs/welcome/gui.html @@ -1,32 +1,58 @@ - - - - Haiku's GUI - - - - - - - - - - - - - - - - + + + + + + + + + +
-

Logo

-
-

dummy

-
-

+ + + + Haiku's GUI + + + + + + + + + + + + + + + + + + + + + + + + + + -
+ logo + + logo + + Haiku's GUI +
+ logo + + logo +
  + Welcome +     + Next: Workspaces +  
  + +

Haiku's GUI

-

Haiku's graphical user interface is an integral part of the system. Unlike linux-based operating systems, there's no separate windows manager and just booting into a commandline shell is not possible. Haiku's focus being on the desktop user, this is just not considered necessary. +

Haiku's graphical user interface is an integral part of the system. Unlike unix-based operating systems, there's no separate window manager and booting just into a command line shell is not possible. Haiku's focus being on the desktop user, this is just not considered necessary.

As you probably have experience with other graphical environments, let's skip over the standards like menus, right-click context menus, drag&drop etc. Let's have a look at the few unique aspects of Haiku's GUI instead.


Before we start with that, there's one more thing you'll probably run into quite quickly: By default, Haiku's option key, to invoke commands from menus for example, is not the usual CTRL key, but ALT instead. This has historical reasons, because the BeOS was inspired somewhat by MacOS. After you get used to it, it actually feels better as e.g. ALT+C and ALT+V is reached more conveniently on the keyboard and these commands seemlessly integrate into the bash shell of the Terminal. @@ -42,11 +68,27 @@ There are only a few things in Haiku's GUI that aren't obvious and deserve an ex

  • You minimize a window with a double-click on its tab. A such hidden window can be accessed by its entry in the Deskbar or the Twitcher.
  • You can send a window to the back with a right-click on its tab (or its border).
    • [3] The close button.
    -[4] The maximise button.
    +[4] The "alternative size" button (expands window to full screen in most applications).
    [5] The resize button. Dragging anywhere else on a window's border will move the window.

    That's pretty much all there is to Haiku's GUI widgets in general. You'll find more information in Getting to know the system.

    -
    - - + +
    + +    		 
      + Welcome +     + Next: Workspaces +
    + + diff --git a/docs/welcome/index.html b/docs/welcome/index.html index 9319bab2f8..95d84b959a 100644 --- a/docs/welcome/index.html +++ b/docs/welcome/index.html @@ -1,29 +1,57 @@ - - - - The Index - - - - - - - - - - - - - - - - + + + + + + + + + +
    -

    Logo

    -
    -

    dummy

    -
    + + + + The Index + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + The Index +
    + logo + + logo +
      + Welcome +     + Previous: File Attributes +     + Next: Queries +  
      +

    The Index

    @@ -110,7 +138,23 @@ INDEX_NAME is the name of a file attribute. If no volume is specified, the volume of the current directory is assumed. -

    - - + +    		 
      + Welcome +     + Previous: File Attributes +     + Next: Queries +  
    + + diff --git a/docs/welcome/queries.html b/docs/welcome/queries.html index deebc06d51..6db9036608 100644 --- a/docs/welcome/queries.html +++ b/docs/welcome/queries.html @@ -1,32 +1,58 @@ - - - - Queries - - - - - - - - - - - - - - - - + + + + + + + + + +
    -

    Logo

    -
    -

    dummy

    -
    -

    + + + + Queries + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + Queries +
    + logo + + logo +
      + Welcome +     + Previous: The Index +  
      + +

    Queries

    -

    A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in "/boot/home/queries" and by default last seven days before being purged. Note, that these aren't static result list of your search, but are the query formulas which trigger a new search whenever you open them. +

    A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in "/boot/home/queries" and by default last seven days before being purged. Note, that these aren't static result lists of your search, but are the query formulas which trigger a new search whenever you open them.


    The Find window

    @@ -111,7 +137,23 @@ realtime.

    Open /boot/home/config/settings/Tracker/DefaultQueryTemplates, create a new folder and rename it to group/filetype, replacing slashes with underscores, e.g."audio_x-mp3". Open the new folder and paste in the layout with Attributes | Paste Attributes.

    -
    - - + +
    + +    		 
      + Welcome +     + Previous: The Index +  
    + + diff --git a/docs/welcome/tracker.html b/docs/welcome/tracker.html index a1e4e75622..a3b08093a8 100644 --- a/docs/welcome/tracker.html +++ b/docs/welcome/tracker.html @@ -1,30 +1,58 @@ - - - - The Tracker - - - - - - - - - - - - - - - - + + + + + + + + + +
    -

    Logo

    -
    -

    dummy

    -
    -

    + + + + The Tracker + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + The Tracker +
    + logo + + logo +
      + Welcome +     + Previous: The Twitcher +     + Next: The Deskbar +  
      + +

    The Tracker

    The Tracker is the graphical interface to all your files. It let's you create new files and folders or find, launch or rename as well as copy or delete existing ones.

    Being an application like any other (the Desktop with its icons is really just a fullscreen window in the background), Tracker appears with its windows in the Deskbar and can be quit and restarted. The easiest way to quit and restart a e.g. crashed or frozen Tracker is to call the TeamManager with CTRL+ALT+DEL to kill Tracker and then click the Restart Desktop... button. The same brings back a wayward Deskbar. @@ -73,9 +101,9 @@ This is also true for...

    Tracker windows offer three different viewing modes from the Window menu:

    • Icon View (ALT+1) - Big icons, you can change the size from the submenu.
    • Mini Icon View (ALT+2) - Small icons.
      • -
    • List View (ALT+3) - A detailed list of your files enabling you to show/hide available attributes.
    +
  • List View (ALT+3) - A detailed list of your files enabling you to show/hide available attributes. (See topic File Attributes.)

    • The Window menu offers a number of other functions: -

    • Resize Window (ALT+Y) - Resizes the window to its ideal size
      • +
      • Resize Window (ALT+Y) - Resizes the window to its ideal size.
      • Clean Up (ALT+K) - Aligns all icons to an invisible grid. Hold down SHIFT and the menu becomes Clean Up All which additionally sorts all icons alphabetically.
      • Select... (SHIFT+ALT+A) - Select files according to a regular expression.
      @@ -83,14 +111,14 @@ This is also true for...


      Tracker preferences

      -

      Window | Preferences... opens a panel that offers a number of setting that, where not obvious, should become clear once tried out. Since all settings a re applied live, you'll immediately see the changes. +

      Window | Preferences... opens a panel that offers a number of setting that, where not obvious, should become clear once tried out. Since all settings are applied live, you'll immediately see the changes.
      So, in short, the not so obvious settings:

      • Desktop - Decide if all mounted disks appear directly on the Desktop or in a window after clicking a single Disk icon sitting on the Desktop.
        • -
      • Windows - You can set Single Window Navigation, i.e. a double-clicked folder doesn't open in its own window, but inside its parent instead. This is not the same as clicking while holding the WIN key, as described above, because you'll lose the per window saved position and size. -
        +
      • Windows - You can set Single Window Navigation, i.e. a double-clicked folder doesn't open in its own window, but inside the already open window instead, replacing the view of it's parent folder. This is not the same as clicking while holding the WIN key, as described above, because you'll lose the per window saved position and size. +

        tracker-preferences-navigator.png

        -On the other hand, single window browsing offers a Navigator where you can enter or copy&paste a path name and use back, forward and up buttons.

        • +Before you switch Tracker to Single Window Navigation mode, because that may feel more familiar to you, we recommend giving the menu based browsing a try first, as that may actually work much faster for you after getting used to. On the other hand, single window browsing offers a Navigator where you can enter or copy&paste a path name and use back, forward and up buttons.

      • Date and Time - Set date and time formats.
      • Trash - Set the behaviour when deleting a file.
      • Volume Icons - Set the colour of an optional indicator of free space that's shown besides a disk's icon.
        • @@ -101,7 +129,7 @@ On the other hand, single window browsing offers a Navigator where you ca

        When invoked on a selected file, the File menu offers about the same options as when you open a context menu by right-clicking the file. Exceptions are commands that don't specifically target a selected file, like Find.. or New....

        As usual the usage of the commands is pretty clear, so we'll concentrate on the niftier parts.

        • Find... - Find a file or folder. See topic Query for more info.
          • -
        • New... - Create a new folder or any other file after a template. +
        • New... - Create a new folder or any other file based on a template.

          new-menu.png

          Choosing Edit Templates... opens the folder /boot/home/config/settings/Tracker/Tracker New Templates. Creating a file in that folder will offer its filetype with the file's name and other attributes as template in the New... menu. Here, there's a file "Text" with the filetype text/plain. See topic Filetypes for more info.

          • @@ -111,8 +139,24 @@ On the other hand, single window browsing offers a Navigator where you ca

          The preferred application that would open the file when double-clicked, is checkmarked. In this submenu are only those applications listed that deal with the exact filetype, in this case it's a text file, the type text/plain. If you don't click on an app in the submenu, but on Open With... a panel opens:

          open-with-preferred -

          -

    - - +

    + +    		 
      + Welcome +     + Previous: The Twitcher +     + Next: The Deskbar +  
    + + diff --git a/docs/welcome/twitcher.html b/docs/welcome/twitcher.html index c4381f5518..eaf84bc241 100644 --- a/docs/welcome/twitcher.html +++ b/docs/welcome/twitcher.html @@ -1,29 +1,57 @@ - - - - The Twitcher - - - - - - - - - - - - - - - - + + + +
    -

    Logo

    -
    -

    dummy

    -
    + + + + The Twitcher + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + The Twitcher +
    + logo + + logo +
      + Welcome +     + Previous: Workspaces +     + Next: The Tracker +  
      +

    The Twitcher

    The Twitcher is a task switcher to jump between running applications and their windows.

    @@ -33,7 +61,13 @@

    Just tap CTRL+TAB quickly to switch between the current and the last application/window. Or press CTRL+TAB and hold the CTRL key to go through all running applications by repeatedly hitting TAB or CURSOR LEFT/RIGHT. If you need to get to a specific window of a program, move to its icon as described and then go through its open windows with the CURSOR UP/DOWN keys.

    It's also possible to invoke the Twitcher with CTRL+TAB and then use the mouse to choose the application/window you'll jump to when releasing the CTRL key.

    -
    - - + +
    + +    		 
    + + diff --git a/docs/welcome/welcome-images/dummy.png b/docs/welcome/welcome-images/dummy.png deleted file mode 100644 index 17281cfaad..0000000000 Binary files a/docs/welcome/welcome-images/dummy.png and /dev/null differ diff --git a/docs/welcome/welcome-images/logo_lb.png b/docs/welcome/welcome-images/logo_lb.png new file mode 100644 index 0000000000..1b5654f53e Binary files /dev/null and b/docs/welcome/welcome-images/logo_lb.png differ diff --git a/docs/welcome/welcome-images/logo_lt.png b/docs/welcome/welcome-images/logo_lt.png new file mode 100644 index 0000000000..cc1e490723 Binary files /dev/null and b/docs/welcome/welcome-images/logo_lt.png differ diff --git a/docs/welcome/welcome-images/logo_rb.png b/docs/welcome/welcome-images/logo_rb.png new file mode 100644 index 0000000000..5e91ee2b25 Binary files /dev/null and b/docs/welcome/welcome-images/logo_rb.png differ diff --git a/docs/welcome/welcome-images/logo_rt.png b/docs/welcome/welcome-images/logo_rt.png new file mode 100644 index 0000000000..932423107a Binary files /dev/null and b/docs/welcome/welcome-images/logo_rt.png differ diff --git a/docs/welcome/welcome-images/shijin-logo.png b/docs/welcome/welcome-images/shijin-logo.png deleted file mode 100644 index 3c1bd41923..0000000000 Binary files a/docs/welcome/welcome-images/shijin-logo.png and /dev/null differ diff --git a/docs/welcome/welcome.html b/docs/welcome/welcome.html index 9271a243b4..8d0c221da9 100644 --- a/docs/welcome/welcome.html +++ b/docs/welcome/welcome.html @@ -1,89 +1,137 @@ - - - - Welcome to Haiku! - - - - - - - - - - - - - - - - + + + + + + + + + +
    -

    Logo

    -
    -

    dummy

    -
    -

    -

    Welcome to Haiku

    -We were working very hard to fix all possibly show stopping bugs, however, being an alpha release, there are bound to be plenty left undiscovered. We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.
    -This alpha release doesn't yet offer all the features and well-rounded end-user experience planned for the final R1 version. It's only the first step to get there and is therefore addressing foremost developers that want to have a look or help out. + + + + Welcome to Haiku! + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + Welcome to Haiku! +
    + logo + + logo +
      + Next: Haiku's GUI +  
      +
    +

    Welcome to Haiku!

    +Thank you very much for checking out Haiku! This is our first public release. We hope to attract new developers to our project and give future users a chance to check out Haiku. We realize that this alpha release does not yet fully live up to the goals that we have set for ourselves and doesn't offer all the features and well-rounded end-user experience planned for the final R1 version. However, we are hoping that this release will let you discover the great potential in Haiku and share with us in the excitement.


    -

    Getting to know the system

    + +

    Beware of Bugs

    +

    +We were working very hard to fix all possibly show stopping bugs, however, being an alpha release, there are bound to be plenty left undiscovered. We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed. +

    +

    +One of the main reasons for releasing an alpha version is to attract more people to test the system and discover bugs or provide suggestions for future enhancements. Please file bugs and enhancements in our bug tracker after using its search function to avoid duplicates. +

    + + +

    + +

    Getting to know the system

    The first release(s) of Haiku will be very much like the BeOS R5, the OS it is reimplementing.
    -If you never experienced it, there are a few short introductions to some of its features: - +If you never experienced it, here are a few short introductions to some of its features: + +

    -

    Getting to know the API

    -Since Haiku is a reimplementation, the API is still the same as for BeOS R5 for the most part. Therefore the documentation in the BeBook is still a valid resource. Thanks to ACCESS, who own the rights to former Be Inc. property, we are allowed to provide a copy of the BeBook.
    -There are additional resources that should help you getting started: - -

    -

    Reporting bugs

    -The main reason for releasing an alpha version is to get more people to test the system and discover bugs or provide suggestions for future enhancements. Please file bugs and enhancements in our bug tracker after using its search function to avoid duplicates. - -

    -

    Getting in contact

    -Get in contact with other developers and users and join the discussions in our forums or mailing lists. - -

    -

    3rd party software

    -Because of our binary and source compatibility to BeOS, many applications still run on Haiku. After downloading a package, simply unzip it to a folder in /boot/apps/ and start the binary from there.
    + +

    Installing more software

    +Because of our binary and source compatibility to BeOS, many BeOS applications run on Haiku. After downloading a package, simply unzip it (double clicking should open Expander) to a folder in /boot/apps/ and start the application from there.
    Popular software repositories are: - -
    - - + + +

    + +

    Getting to know the API

    +Since Haiku is a reimplementation, the API is still the same as for BeOS R5 (with some additions). Therefore the documentation in the BeBook is still a valid resource. Thanks to ACCESS, who own the rights to former Be Inc. property, we are allowed to provide a copy of the BeBook.
    +There are additional resources that should help you getting started: + + +

    + +

    Getting in contact

    +Get in contact with other developers and users and join the discussions in our forums or mailing lists. + + +    		 
      + Next: Haiku's GUI +  
    + + diff --git a/docs/welcome/workshop-filetypes+attributes.html b/docs/welcome/workshop-filetypes+attributes.html index 7ce8ef00e3..b6a9ef57eb 100644 --- a/docs/welcome/workshop-filetypes+attributes.html +++ b/docs/welcome/workshop-filetypes+attributes.html @@ -99,15 +99,14 @@ To that we add a couple of attributes. Here we have to decide if we want to quer

    Now, insert all the info for our attributes:

    - - - - - - - - - + + + + + + + +
    Internal NameAttribute typeindexed?Description
    DVDdb:title text yes Movie title
    DVDdb:genre text yes Genre
    DVDdb:url text no URL
    DVDdb:cast text yes Director/Cast
    DVDdb:plot text no Plot
    DVDdb:rating int-32 yes Rating 1 to 10
    DVDdb:coord text no Shelf
    DVDdb:lent text yes Lent to
    DVDdb:title text yes Movie title
    DVDdb:genre text yes Genre
    DVDdb:url text no URL
    DVDdb:cast text yes Director/Cast
    DVDdb:plot text no Plot
    DVDdb:rating int-32 yes Rating 1 to 10
    DVDdb:coord text no Shelf
    DVDdb:lent text yes Lent to

    Indexing

    diff --git a/docs/welcome/workspaces.html b/docs/welcome/workspaces.html index 51e94d0682..6025eac1fd 100644 --- a/docs/welcome/workspaces.html +++ b/docs/welcome/workspaces.html @@ -1,29 +1,57 @@ - - - - Workspaces - - - - - - - - - - - - - - - - + + + + + + + + + +
    -

    Logo

    -
    -

    dummy

    -
    + + + + Workspaces + + + + + + + + + + + + + + + + + + + + + + + + + + -
    + logo + + logo + + Workspaces +
    + logo + + logo +
      + Welcome +     + Previous: Haiku's GUI +     + Next: The Twitcher +  
      +

    Workspaces

    Workspaces are virtual desktops, complete with their own resolution, colour depth and background. Up to 32 of these workspaces can be set from the Screen preferences. @@ -34,13 +62,30 @@

    The Workspaces applet shows a miniature version of all workspaces. There are several options available from the context menu of the applet's window, which are all pretty self-explaining. Since the applet is a Replicant, you can resize the window as desired and then drag&drop it by its handle onto the desktop (make sure "Show Replicants" is activated in the Deskbar menu).


    Switching workspaces

    -

    You can switch between workspaces by either clicking into the Workspaces applet or by using the keyboard shortcut ALT+Fx, where "x" is the workspace number. Also, clicking on an application or one of its windows in the Deskbar will send you to the workspace it resides in. +

    You can switch between workspaces by either clicking into the Workspaces applet or by using the keyboard shortcut ALT+Fx, where "x" is the workspace number. Also, clicking on an application or one of its windows in the Deskbar will send you to the workspace it resides in.


    Moving windows between workspaces

    -

    To move a window, you grab it in the Workspaces applet and simply drag it to another workspace. This has the advantage, that you can move it without leaving your current desktop. Of course, that only works well when there aren't too many windows on a workspace and your target isn't obscured by other windows. Another possibility is to grab a window by its tab and just holding on to it while switching workspaces with ALT+Fx. +

    To move a window, you grab it in the Workspaces applet and simply drag it to another workspace. This has the advantage, that you can move it without leaving your current desktop. Of course, that only works well when there aren't too many windows on a workspace and your target isn't obscured by other windows. Another possibility is to grab a window by its tab and just holding on to it while switching workspaces with ALT+Fx.

    -
    - - +
    + +    		 
      + Welcome +     + Previous: Haiku's GUI +     + Next: The Twitcher +  
    + +