diff --git a/docs/welcome/attributes.html b/docs/welcome/attributes.html index 6e2c9c7043..64dc40dd5b 100644 --- a/docs/welcome/attributes.html +++ b/docs/welcome/attributes.html @@ -3,59 +3,26 @@ File Attributes - + - + - - - - - - - - - - - - - - - - - - + Next: Index +

+ - - - - - - - - - - - +

+ -
- logo - - logo - - File Attributes -
- logo - - logo -
  - Welcome + +
+

+ 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. @@ -163,24 +130,18 @@ 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/bugreports.html b/docs/welcome/bugreports.html index 231376b4cc..175b969484 100644 --- a/docs/welcome/bugreports.html +++ b/docs/welcome/bugreports.html @@ -2,57 +2,23 @@ - Bugreporting - + Reporting bugs + - + - - - - - - - - - - - - + +
+

+ Welcome +

+
- - - - - +
-
- - - - + + - +

+ -
- logo - - logo - - Welcome to Haiku! -
- logo - - logo -
  - Welcome -     - -  
  -

Reporting bugs

Since our developers are unable to test every hardware combination, nor every different way of interacting with the operating system, we are relying on you to give us some input on how things work at your end. Since this is a very early product, it is very likely that you will encounter bugs. We thank you for taking the time to report these.

Please follow these guidelines to create helpful bug reports:

@@ -63,28 +29,21 @@ Please follow these guidelines to create helpful bug reports:

  • Include basic information such as how you are testing Haiku (on real hardware, on VMWare, on QEMU, etc.).

  • Mention which revision from SVN you are running. You can find this information in 'About This System...' from the Deskbar menu.

  • Describe the problem you are experiencing. Try to be as accurate as you can: describe the actual behavior, and the behavior you expected.

    • -
  • Describe what steps to you need to perform in order to expose the bug. This will help developers reproduce the bug.

    • +
  • Describe what steps you need to perform in order to expose the bug. This will help developers reproduce the bug.

  • Attach as much information as you have. If it is a GUI bug, or a bug in one of the applications, try to make a screen shot (the PRINT key files a PNG into /boot/home/).
    If it is a hardware problem, include a copy of the syslog file (just query for "syslog" to find it).

  • After the bug has been reported, a developer will look at your bug and try to classify it. Remember, we are all volunteers, and as such, sometimes a bug report might go unanswered for a while. Adding new information when it becomes available usually helps getting a bug picked up quicker, but do not try to 'bump' the bug up by adding non-descriptive comments.

  • Remember, reporting a bug is not something you spend a little time on and then you are done. If you reported a bug, then you are part of the Haiku development process. Developers might come up with questions while they are trying to fix your bug. Please stay around to answer these. Consider your participation 'done' when the bug is marked as 'fixed'. Together we can improve Haiku, bit by bit. -
    • -
    -    		 
    diff --git a/docs/welcome/deskbar.html b/docs/welcome/deskbar.html index 257ec614d9..f6b584d014 100644 --- a/docs/welcome/deskbar.html +++ b/docs/welcome/deskbar.html @@ -3,59 +3,26 @@ The Deskbar - + - + - - - - - - - - - - - - - - - - - - + Next: Filetypes +

    + - - - - - - - - - - - +

    + -
    - logo - - logo - - The Deskbar -
    - logo - - logo -
      - Welcome + +
    +

    + 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.

    @@ -78,7 +45,7 @@
  • Always on Top -- The Deskbar always stays above all other windows.
  • Auto Raise -- The Deskbar pops to the front if the mouse pointer touches it.
  • Sort Running Applications -- Sorts the list of running programs alphabetically.
    • -
  • Tracker always First -- Even if you sort alphabetically, the Tracker entry always stays first in the list.</i>
    • +
  • Tracker always First -- Even if you sort alphabetically, the Tracker entry always stays first in the list.
  • 24 Hour Clock -- Toggles between 24 and 12 hour clock.
  • Show Seconds -- Adds the display of seconds to the clock.
  • European Date -- Shows the date in European format: day-month-year
    • @@ -114,24 +81,17 @@ Here you can also launch a calendar that also appears, when you hold down the le

    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 6471b364fc..c6b170f37a 100644 --- a/docs/welcome/filetypes.html +++ b/docs/welcome/filetypes.html @@ -3,59 +3,26 @@ Filetypes - + - + - - - - - - - - - - - - - - - - - - + Next: File Attributes +

    + - - - - - + - - - - - +

    + -
    - logo - - logo - - Filetypes -
    - logo - - logo -
      - Welcome + +
    +

    + 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.


    @@ -97,22 +64,17 @@

    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 b0c13ddfa1..409790be7d 100644 --- a/docs/welcome/gui.html +++ b/docs/welcome/gui.html @@ -3,57 +3,24 @@ Haiku's GUI - + - + - - - - - - - - - - - - - - - - - - + Next: Workspaces +

    + - - - - - - - - - - - +

    + -
    - logo - - logo - - Haiku's GUI -
    - logo - - logo -
      - Welcome + +
    +

    + Welcome     - Next: Workspaces -

    		 
      +
    -

    Haiku's GUI

    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.

    @@ -76,22 +43,15 @@ There are only a few things in Haiku's GUI that aren't obvious and deserve an ex

    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 510d318abd..15e720b9c8 100644 --- a/docs/welcome/index.html +++ b/docs/welcome/index.html @@ -3,59 +3,26 @@ The Index - + - + - - - - - - - - - - - - - - - - - - + Next: Queries +

    + - - - - - + - - - - - +

    + -
    - logo - - logo - - The Index -
    - logo - - logo -
      - Welcome + +
    +

    + Welcome     Previous: File Attributes     - Next: Queries -

    		 
      +
    -

    The Index

    Attributes and Queries are key features of Haiku. While attributes are useful on their own, to display additional information on a file, for a query on them, they need to be indexed. It puts them into a lookup table, which in turn makes queries lightning fast.
    @@ -142,22 +109,17 @@ 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 fe6124caee..1688633426 100644 --- a/docs/welcome/queries.html +++ b/docs/welcome/queries.html @@ -3,57 +3,24 @@ Queries - + - + - - - - - - - - - - - - - - - - - - + Previous: The Index +

    + - - - - - - - - - - - +

    + -
    - logo - - logo - - Queries -
    - logo - - logo -
      - Welcome + +
    +

    + 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 lists of your search, but are the query formulas which trigger a new search whenever you open them.

    @@ -141,22 +108,15 @@ realtime. Open the new folder and paste in the layout with Attributes | Paste Attributes.

    -
    +
    -    		 
      +
    +

    Welcome     Previous: The Index -

    		 
    diff --git a/docs/welcome/tracker-images/open-with-preferred.png b/docs/welcome/tracker-images/open-with-preferred.png new file mode 100644 index 0000000000..4005ede160 Binary files /dev/null and b/docs/welcome/tracker-images/open-with-preferred.png differ diff --git a/docs/welcome/tracker-images/open-with.png b/docs/welcome/tracker-images/open-with.png index 06c4a6d2ca..064ff73196 100644 Binary files a/docs/welcome/tracker-images/open-with.png and b/docs/welcome/tracker-images/open-with.png differ diff --git a/docs/welcome/tracker.html b/docs/welcome/tracker.html index 734e66f032..32c6c96704 100644 --- a/docs/welcome/tracker.html +++ b/docs/welcome/tracker.html @@ -3,59 +3,26 @@ The Tracker - + - + - - - - - - - - - - - - - - - - - - + Next: The Deskbar +

    + - - - - - + - - - - - +

    + -
    - logo - - logo - - The Tracker -
    - logo - - logo -
      - Welcome + +
    +

    + 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. @@ -138,28 +105,24 @@ Before you switch Tracker to Single Window Navigation mode, because that may fee

    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.

  • Open With... - A submenu offers all applications that can handle this filetype.

    -open-with.png -

    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.png +

    The preferred application that would open the file when double-clicked, is checkmarked. This submenu list first those applications that can handle the exact filetype, in this case it's a text file, the type text/plain. Next come all applications that can handle that supertype in general, here text/*. Last in the list are those that can deal with any file. If you don't click on an app in the submenu, but on the Open With... entry instead, a panel opens:

    -open-with-preferred +open-with-preferred +

    Here you'll again find the programs that were listed in the submenu. By selecting one and clicking the Open and Make Preferred button, you changed the preferred application for every file of that filetype, here text/plain.

    -
    		•  
      +
    +

    Welcome     Previous: The Twitcher     Next: The Deskbar -

    		 
    diff --git a/docs/welcome/twitcher.html b/docs/welcome/twitcher.html index 0ac0df74b2..5c9e397024 100644 --- a/docs/welcome/twitcher.html +++ b/docs/welcome/twitcher.html @@ -3,74 +3,37 @@ The Twitcher - + - + - - - - - - - - - - - - - - - - - - + Next: The Tracker +

    + - - - - - - -
    - logo - - logo - - The Twitcher -
    - logo - - logo -
      - Welcome + +
    +

    + Welcome     Previous: Workspaces     - Next: The Tracker -

    		 
      +
    -

    The Twitcher

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

    twitcher.png

    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. +

    +

    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/logo.png b/docs/welcome/welcome-images/logo.png new file mode 100644 index 0000000000..dbf3be705d Binary files /dev/null and b/docs/welcome/welcome-images/logo.png differ diff --git a/docs/welcome/welcome-images/logo_lb.png b/docs/welcome/welcome-images/logo_lb.png deleted file mode 100644 index 1b5654f53e..0000000000 Binary files a/docs/welcome/welcome-images/logo_lb.png and /dev/null differ diff --git a/docs/welcome/welcome-images/logo_lt.png b/docs/welcome/welcome-images/logo_lt.png deleted file mode 100644 index cc1e490723..0000000000 Binary files a/docs/welcome/welcome-images/logo_lt.png and /dev/null differ diff --git a/docs/welcome/welcome-images/logo_rb.png b/docs/welcome/welcome-images/logo_rb.png deleted file mode 100644 index 5e91ee2b25..0000000000 Binary files a/docs/welcome/welcome-images/logo_rb.png and /dev/null differ diff --git a/docs/welcome/welcome-images/logo_rt.png b/docs/welcome/welcome-images/logo_rt.png deleted file mode 100644 index 932423107a..0000000000 Binary files a/docs/welcome/welcome-images/logo_rt.png and /dev/null differ diff --git a/docs/welcome/welcome.css b/docs/welcome/welcome.css index 30110f4ea4..d765daa6a5 100644 --- a/docs/welcome/welcome.css +++ b/docs/welcome/welcome.css @@ -1,42 +1,155 @@ /* - * Copyright 2008, Haiku. + * Copyright 2008, Haiku. All rights reserved. * Distributed under the terms of the MIT License. * * Authors: * François Revol + * Stephan Aßmus */ -body { - /* remove default borders around content */ - margin: 0em; - /* for NetSurf */ +html { + margin: 0px; + padding: 0px; +} +body { + color: #333333; + margin: 0px; padding: 0px; - - /* body colors */ - background-color: white; - color: black; } -/* link colors */ -a:link { color: #dc3c01; } -/*a:active { color: #dc3c01; }*/ -a:visited { color: #892601; } +/* link colors and text decoration */ -/* top banner elements (with the logo): td in a tr of class top-banner */ -tr.top-banner td { +a:link { + font-weight: bold; + text-decoration: none; + color: #dc3c01; +} +a:visited { + font-weight: bold; + text-decoration: none; + color: #892601; +} +a:hover, a:active { + text-decoration: underline; + color: #ff4500; +} + +/* Some headers act as anchors, don't give them a hover effect */ +h2 a:hover, a:active { + text-decoration: none; + color: #0c3762; +} + +/* basic text elements */ + +div.content { + margin-top: 50px; + margin-left: 40px; + margin-right: 40px; +} + +h1 { + font-size: 1.3em; + font-weight: normal; + color: #0c3762; + border-bottom: dotted thin #e0e0e0; +} + +h2 { + font-size: 1.2em; + font-weight: normal; + color: #0c3762; + border-bottom: dotted thin #e0e0e0; +} + +h3 { + font-size: 1.1em; + font-weight: normal; + color: #222; +} + +p { + text-align: justify; + line-height: 1.3; +} + +/* Add a space before the next header */ +* + h2 { + margin-top: 50px; +} + +* + h3 { + margin-top: 30px; +} + +li { + line-height: 1.3; +} + +/* +#logo { + background-image: url(bottom.png); + background-repeat: no-repeat; + background-position: center; + height: 200px; + width: 100%; + position: fixed; + top: 0px; + z-index: 1; +} +*/ + + +div.logo { + position:relative; + left: 0px; + top: 0px; background: #efefef; } -/* nav banner elements: td in a tr of class nav-banner */ -tr.nav-banner td { +div.logo img { + margin-left: 20px; +} + +div.title { + position: absolute; + bottom: 11px; + right: 0px; + text-align: right; + margin-right: 40px; + font-size: 1.2em; +} + +div.topnav { background: #e0e0e0; } -/* same for bottom nav banner */ -tr.bnav-banner td { - background: #e0e0e0; +div.topnav p { + margin-left: 40px; + margin-top: 0px; + margin-right: 40px; + margin-bottom: 0px; + text-align: right; + font-size: 0.8em; } -/* the tr containing the content text */ -/* tr.content { } */ +div.bottomnav { +/* + position: fixed; + bottom: 0px; + width: 100%; + z-index: 1; +*/ + + background: #efefef; +} + +div.bottomnav p { + margin-left: 40px; + margin-top: 0px; + margin-right: 40px; + margin-bottom: 0px; + text-align: right; + font-size: 0.9em; +} diff --git a/docs/welcome/welcome.html b/docs/welcome/welcome.html index b67a202367..a7e16e7119 100644 --- a/docs/welcome/welcome.html +++ b/docs/welcome/welcome.html @@ -2,71 +2,45 @@ - Welcome to Haiku! + - - - - - - - - - - - - + +
    +

    + Next: Haiku's GUI +

    +
    - - - - - +
    -
    - - - - + - - - - - +

    + -
    - 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. -


    +

    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, here are a few short introductions to some of its features: +

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

    • Filesystem layout
    • Haiku's GUI
      • @@ -79,11 +53,13 @@ If you never experienced it, here are a few short introductions to some of its f
    • Index
    • Queries
    - -

    +

    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.
    +

    +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:

    • Haikuware
      • @@ -91,11 +67,13 @@ Popular software repositories are:
    • HaikuPorts maintains patches for ported software
    • OsDrawer hosts development tools for native software
    - -

    +

    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.
    +

    +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 fe28d544f7..2994896ae3 100644 --- a/docs/welcome/workshop-filetypes+attributes.html +++ b/docs/welcome/workshop-filetypes+attributes.html @@ -3,61 +3,30 @@ Workshop: Filetypes & Attributes - + - + - - - - - - - - - - - - - - - - - - + Next: File Attributes +

    + - - - - - + - - - - - +

    + -
    - logo - - logo - - Welcome to Haiku! -
    - logo - - logo -
      - Welcome + +
    +

    + Welcome     Previous: Filetypes     - Next: File Attributes -

    		 
      -
    +
    + +

    Filetypes, Attributes and Queries

    This is a workshop to show the use of Attributes, Queries, the Index and custom Filetypes. As an example, we build a database to keep track of our DVD library.

    -
    +

    Preparations

    Let's first decide what filetype and attributes would serve our needs. Originally, I wanted to use a Bookmark file with a link to the movie's IMdB page, but Haiku doesn't have a "bookmarkable" browser like BeOS' NetPositiv at the moment, so I came up with this: The file itself will be a JPEG image for the movie cover.
    To that we add a couple of attributes. Here we have to decide if we want to query it later (then we have to add it to the index) and if so, what type of attribute it should be. Numbers (int, float) can be evaluated differently than text (/= vs. is/contains/starts with). @@ -180,22 +149,18 @@ Open the folder containing your DVDdb files and arrange the attributes how you'd query-dvddb.png

    -
    		 
      +
    +

    Welcome     Previous: Filetypes     Next: File Attributes -

    		 
    + diff --git a/docs/welcome/workspaces.html b/docs/welcome/workspaces.html index ba8bd1791d..de050ccd6e 100644 --- a/docs/welcome/workspaces.html +++ b/docs/welcome/workspaces.html @@ -3,59 +3,26 @@ Workspaces - + - + - - - - - - - - - - - - - - - - - - + Next: The Twitcher +

    + - - - - - + - - - - - +

    + -
    - logo - - logo - - Workspaces -
    - logo - - logo -
      - Welcome + +
    +

    + 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.

    @@ -71,24 +38,18 @@

    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.

    -
    -
    		 
      +
    +

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