]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/index.htm
update from Laurent
[wxWidgets.git] / docs / index.htm
index 11d57a67666a54434497b2d754928c719bf08385..9156c14cf4b7ed4f8a96bf034b9d8151e3f16d3c 100644 (file)
-<HTML>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
 
-<HEAD>
-<TITLE>Welcome to wxWidgets</TITLE>
+<!--
+  Name:        index.htm
+  Purpose:     Gateway to wxWidgets Documentation and Resources
+  Author:      wxWidgets team
+  RCS-ID:      $Id$
+  Licence:     wxWindows license
+-->
 
-</HEAD>
+<head>
+  <title>wxWidgets Documentation</title>
+  <style type="text/css">
+  <!--
+    body { font-family: sans-serif; }
+       h1 { font-size: 140%; }
+    li { line-height: 150%; }
+  -->
+  </style>
+</head>
 
-<BODY BGCOLOR="#FFFFFF" TEXT=#000000 LINK=#FF0000 VLINK=#000000>
+<body>
 
-<font face="Arial, Lucida Sans, Helvetica">
+  <a name="top"/>
 
-<a name="top"></a>
+  <p><center>
+    <img src="doxygen/images/main_wxlogo.png" alt="wxWidgets: Cross-Platform GUI Toolkit" />
+  </center></p>
 
-<table width=100% border=4 cellpadding=5 cellspacing=0>
-<tr>
-<td bgcolor="#660000">
-<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
-Welcome to wxWidgets
-</font>
-</td>
-</tr>
-</table>
+  <!-- INSTALLATION AND RELEASE NOTES -->
 
-<P>
+  <h1>Installation and Release Notes</h1>
 
-Welcome to wxWidgets, the premiere cross-platform GUI C++ framework.<P>
+  <p>Unless you installed a binary version of wxWidgets (e.g. under Linux
+     using your distro's package manager), you will probably have to
+     <strong>compile</strong> the wxWidgets library before you can start use
+     it.</p>
+  <p>Please read the platform-specific <tt>readme.txt</tt> and
+     <tt>install.txt</tt> for how to do this:</p>
 
-Please click on <a href="html/index.htm">docs/html/index.htm</a> to view the main document index.<P>
+  <ul>
+    <li>Readme:
+      <a href="readme.txt"><b>General ReadMe</b></a>,
+      <a href="msw/readme.txt">wxMSW</a> (<a href="msw/winxp.txt">wxMSW for WinXP</a>),
+      <a href="gtk/readme.txt">wxGTK</a>,
+      <a href="mac/readme.txt">wxMac</a>,
+      <a href="cocoa/readme.txt">wxCocoa</a>,
+      <a href="mgl/readme.txt">wxMGL</a>,
+      <a href="motif/readme.txt">wxMotif</a>,
+      <a href="x11/readme.txt">wxX11</a>,
+      <a href="univ/readme.txt">Univ</a>
+    </li>
+    <li>Installation:
+      <a href="msw/install.txt">wxMSW</a>,
+      <a href="gtk/install.txt">wxGTK</a>,
+      <a href="motif/install.txt">wxMotif</a>,
+      <a href="x11/install.txt">wxX11</a>,
+      <a href="mac/install.txt">wxMac</a>,
+      <a href="cocoa/install.txt">wxCocoa</a>,
+      <a href="mgl/install.txt">wxMGL</a>,
+      <a href="os2/install.txt">wxOS2</a>
+    </li>
+    <li><a href="changes.txt"><b>General change log</b></a></li>
+    <li>Licence:
+      <a href="preamble.txt">Preamble</a>,
+      <a href="licence.txt">Licence</a>,
+      <a href="licendoc.txt">Documentation Licence</a>,
+      <a href="lgpl.txt">L-GPL</a>,
+      <a href="gpl.txt">GPL</a>
+    </li>
+  </ul>
 
-Have fun!<P>
+  <!-- FIXME: FAQs are very out-of-date; should be moved in the wx docs or
+              to the website or to the wiki...
 
-</font>
+    <li><a href="faq.htm"><b>FAQ</b></a>:</font>
+    <ul>
+    <li><a href="faqgen.htm">General questions</a></font></li>
+    <li><a href="faqcmn.htm">Questions common to all platforms</a></font></li>
+    <li><a href="faqmsw.htm">wxWidgets for Windows</a></font></li>
+    <li><a href="faqgtk.htm">wxWidgets for GTK+</a></font></li>
+    <li><a href="faqmot.htm">wxWidgets for Motif</a></font></li>
+    <li><a href="faqx11.htm">wxWidgets for X11</a></font></li>
+    <li><a href="faqmac.htm">wxWidgets for Mac</a></font></li>
+    </ul>
+    </li>
 
-</BODY>
+  -->
 
-</HTML>
+  <!-- DOCUMENTATION -->
 
+  <h1>Documentation</h1>
+
+  <p>The wxWidgets manual is available in various formats; the availability of
+     the following formats depends on what you've downloaded from the
+     <a href="http://www.wxwidgets.org">wxWidgets website</a>:</p>
+
+  <ul>
+    <li><a href="doxygen/out/html/index.html">HTML</a></li>
+    <li><a href="doxygen/out/wx.chm">MS HTML Help (CHM)</a></li>
+    <li><a href="doxygen/out/wx.htb">wxHTML Help (HTB)</a></li>
+    <li><a href="doxygen/out/rtf/refman.rtf">Rich Text Format (RTF)</a></li>
+    <li><a href="doxygen/out/wx.pdf">Portable Document Format (PDF)</a></li>
+  </ul>
+
+  <p>To use the manual in the <b>wxHTML Help</b> format (extension
+     <tt>htb</tt>), you can use the <b>HelpView</b> application, compiling it
+     from the <tt>utils/helpview</tt> folder in the wxWidgets
+     distribution.</p>
+
+  <p>Also note that beyond the wxWidgets manual there are various other
+     <strong>resources</strong> which can help to learn wxWidgets
+     programming:</p>
+
+  <ul>
+    <li><a href="http://www.wxwidgets.org">The wxWidgets website</a>: Contains
+        FAQs, tutorials, info about the mailing lists, and in general
+        everything related to the wxWidgets world is linked here.</li>
+    <li><a href="http://wxforum.shadonet.com/">The wxWidgets forum</a>:
+        Provides a discussion board about various wxWidgets topics (contains
+        also <em>localized</em> forums).</li>
+    <li><a href="http://wiki.wxwidgets.org/">The wxWiki</a>: A user-editable
+        website with lots of tutorials, links to external tools, resources,
+        etc.</li>
+  </ul>
+
+  <!-- TECHNICAL NOTES -->
+
+  <h1>Technical Notes</h1>
+
+  <p>Technical notes contains informations useful only to wxWidgets developers
+     for the maintainance of the project:</p>
+
+  <ul>
+    <li><a href="tech/index.txt">Index of Technical Notes</a></li>
+    <li><a href="tech/">Technical Notes</a></li>
+  </ul>
+
+  <p>Todo List for wxWidgets:</p>
+
+  <ul>
+    <li><a href="http://wiki.wxwidgets.org/Development:_Todo_List">wxWiki Todo List</a></li>
+    <li><a href="doxygen/out/html/todo.html">Documentation Todo List</a></li>
+  </ul>
+
+  <!-- DEMOS -->
+
+  <h1>Demos</h1>
+
+  <p>The following are fully-fledged applications which demonstrate some
+     features of wxWidgets (for a list of the 70+ samples please look at the
+     manual):</p>
+
+  <ul>
+    <li><a href="../demos/bombs">bombs</a>: minesweeper-like game.</li>
+    <li><a href="../demos/forty">forty</a>: a great little card game by Chris Breeze.</li>
+    <li><a href="../demos/fractal">fractal</a>: fractal mountains by Andrew Davison.</li>
+    <li><a href="../demos/life">life</a>: the game of Life by J. H. Conway,
+        implemented in wxWidgets by Guillermo Rodriguez Garcia.</li>
+    <li><a href="../demos/poem">poem</a>: a little poetry display program.</li>
+  </ul>
+
+</body>
+
+<!-- kate: space-indent on; indent-width 2; indent-mode xml; -->
+
+</html>