From 4bbe91f85a565ddb2dec69204f22b2a79f429578 Mon Sep 17 00:00:00 2001
From: "Daniel P. Berrange" <berrange@redhat.com>
Date: Sun, 4 Oct 2009 20:42:08 +0100
Subject: [PATCH] Flesh out basic website pages a little more

---
 docs/website/Makefile.am           |  2 ++
 docs/website/bugs.html.in          | 26 ++++++++++++++++++++++++++
 docs/website/communicate.html.in   | 10 ++++++++++
 docs/website/documentation.html.in | 14 ++++++++++++++
 docs/website/download.html.in      | 10 ++++++++++
 docs/website/faq.html.in           | 38 ++++++++++++++++++++++++++++++++++++++
 docs/website/index.css             | 15 +++++++++++++--
 docs/website/index.html.in         |  5 ++---
 docs/website/manual.html.in        | 10 ++++++++++
 docs/website/navigation.html       | 10 +++++-----
 docs/website/page.html             |  2 +-
 docs/website/scm.html.in           | 23 +++++++++++++++++++++++
 docs/website/screenshots.html.in   |  7 +++++++
 docs/website/todo.html.in          | 34 ++++++++++++++++++++++++++++++++++
 14 files changed, 195 insertions(+), 11 deletions(-)
 create mode 100644 docs/website/bugs.html.in
 create mode 100644 docs/website/communicate.html.in
 create mode 100644 docs/website/documentation.html.in
 create mode 100644 docs/website/download.html.in
 create mode 100644 docs/website/faq.html.in
 create mode 100644 docs/website/manual.html.in
 create mode 100644 docs/website/scm.html.in
 create mode 100644 docs/website/screenshots.html.in
 create mode 100644 docs/website/todo.html.in

diff --git a/docs/website/Makefile.am b/docs/website/Makefile.am
index f06dae7..4293fd5 100644
--- a/docs/website/Makefile.am
+++ b/docs/website/Makefile.am
@@ -10,4 +10,6 @@ website_DATA = $(PAGES:%.html.in=%.html)
 
 CLEANFILES = $(website_DATA)
 
+GITIGNOREFILES = $(CLEANFILES)
+
 -include $(top_srcdir)/git.mk
diff --git a/docs/website/bugs.html.in b/docs/website/bugs.html.in
new file mode 100644
index 0000000..3f63d0f
--- /dev/null
+++ b/docs/website/bugs.html.in
@@ -0,0 +1,26 @@
+[% SET
+   title = "Bug and feature tracking" %]
+
+[% WRAPPER page.html %]
+
+<h2>Viewing bug and feature reports</h2>
+
+<p>
+  There will be a bug tracker a
+</p>
+
+<h2>Reporting new bugs</h2>
+
+<p>
+  If the GUI is crashing then before filing a bug report, collect
+  basic debugging information using the <code>--debug-capa</code>
+  command line flag
+</p>
+
+<p>
+  If a camera is not behaving well with Capa, then before filing
+  a bug report, collect gphoto2 debugging information using the
+  <code>--debug-gphoto</code> command line flag
+</p>
+
+[% END %]
diff --git a/docs/website/communicate.html.in b/docs/website/communicate.html.in
new file mode 100644
index 0000000..241b45d
--- /dev/null
+++ b/docs/website/communicate.html.in
@@ -0,0 +1,10 @@
+[% SET
+   title = "Communicate with development team" %]
+
+[% WRAPPER page.html %]
+
+<p>
+  There will be mailing lists....
+</p>
+
+[% END %]
diff --git a/docs/website/documentation.html.in b/docs/website/documentation.html.in
new file mode 100644
index 0000000..68b2737
--- /dev/null
+++ b/docs/website/documentation.html.in
@@ -0,0 +1,14 @@
+[% SET
+   title = "Documentation" %]
+
+[% WRAPPER page.html %]
+
+<ul>
+  <li>Everyone wants to see <a href="screenshots.html">screenshots</a></li>
+  <li>To learn about using Capa try <a href="manual.html">the manual</a></li>
+  <li>Before asking a question, read the <a href="faq.html">Frequently Asked Questions</a><li>
+  <li>Look at the <a href="todo.html">Todo</a> list to see what's coming next</li>
+</ul>
+
+
+[% END %]
diff --git a/docs/website/download.html.in b/docs/website/download.html.in
new file mode 100644
index 0000000..bcb6ac1
--- /dev/null
+++ b/docs/website/download.html.in
@@ -0,0 +1,10 @@
+[% SET
+   title = "Download official releases" %]
+
+[% WRAPPER page.html %]
+
+<p>
+  At this time there are no official releases, check back soon
+</p>
+
+[% END %]
diff --git a/docs/website/faq.html.in b/docs/website/faq.html.in
new file mode 100644
index 0000000..82963ef
--- /dev/null
+++ b/docs/website/faq.html.in
@@ -0,0 +1,38 @@
+[% SET
+   title = "Frequently Asked Questions" %]
+
+[% WRAPPER page.html %]
+
+<dl>
+  <dt>Where does the name come from ?</dt>
+  <dd>
+    <p>The original desire was to have a name which met the following criteria</p>
+    <ul>
+      <li>Recursive acronym</li>
+      <li>Easily typed short format</li>
+      <li>No clashes with existing projects on <a href="http://freshmeat.net">freshmeat</a></li>
+      <li>No clashes with other photography apps <a href="http://google.com">on google</a></li>
+      <li>Derived from / related to the word 'capture'</li>
+    </ul>
+    <p>
+      After a little brainstorming the result was <code>Capa: Capa Assists Photograph Acquisition</code>.
+    </p>
+  </dd>
+  <dt>What license is the code under?</dt>
+  <dd><p>The <a href="http://www.gnu.org/copyleft/gpl.html">GNU GPL v3+</a></p></dd>
+  <dt>What does the build process depend on?</dt>
+  <dd>
+    <p>At the time of writing the required build depedancies are:</p>
+    <ul>
+      <li><a href="http://gphoto.org/">libgphoto >= 2.4.7</a></li>
+      <li><a href="http://gtk.org">glib >= 2.10.0</a></li>
+      <li><a href="http://gtk.org">gtk >= 2.12.0</a></li>
+      <li><a href="http://gtk.org">glade >= 2.6.0</a></li>
+      <li><a href="http://freedesktop.org/wiki/Software/hal">HAL >= 0.5.0</a></li>
+      <li><a href="http://freedesktop.org/wiki/Software/hal">dbus-glib >= 0.60</a></li>
+
+    </ul>
+  </dd>
+</dl>
+
+[% END %]
diff --git a/docs/website/index.css b/docs/website/index.css
index 5b0ae39..74d1bb3 100644
--- a/docs/website/index.css
+++ b/docs/website/index.css
@@ -58,7 +58,7 @@ body {
 
     /* The next <h1> spills out of header, so force this down
        to botom to avoid covering hyperlinks */
-    z-index: -100;
+    z-index: -1;
 }
 
 #header h1 {
@@ -71,6 +71,10 @@ body {
     padding: 1em;
 }
 
+#header h1 a {
+    color: inherit;
+    text-decoration: none;
+}
 
 #footer {
     color: #888;
@@ -84,7 +88,7 @@ body {
     margin: 2em;
 }
 
-#navigation a {
+#navigation a, #content a {
     color: #2c3b5f;
 }
 
@@ -161,3 +165,10 @@ li.settings {
     list-style: url(item-settings.png);
 }
 
+dl dt {
+    font-weight: bold;
+}
+
+dl dd {
+    margin-bottom: 2em;
+}
\ No newline at end of file
diff --git a/docs/website/index.html.in b/docs/website/index.html.in
index 4235016..082e529 100644
--- a/docs/website/index.html.in
+++ b/docs/website/index.html.in
@@ -20,15 +20,14 @@
 
 <p>
   With a <a href="http://nikon.com">sufficiently</a> <a href="http://canon.com">capable</a>
-  digital SLR camera Capa allows
+  digital SLR camera Capa allows:
 </p>
 
 <ul class="styled">
-  <li class="handsfree">100% hands free control of all camera settings</li>
   <li class="shoot">Trigger the shutter from the computer</li>
   <li class="preview">Preview of shots using a "LiveView" capability</li>
   <li class="download">Automatic download and display of photos as they are shot</li>
-  <li class="settings">Adjustment of camera settings to match recorded image EXIF data</li>
+  <li class="settings">Control of all camera settings from computer</li>
 </ul>
 
 <p>
diff --git a/docs/website/manual.html.in b/docs/website/manual.html.in
new file mode 100644
index 0000000..3f4d21e
--- /dev/null
+++ b/docs/website/manual.html.in
@@ -0,0 +1,10 @@
+[% SET
+   title = "User manual" %]
+
+[% WRAPPER page.html %]
+
+<p>
+  It would be a good idea if somewhere were to write a user manual :-)
+</p>
+
+[% END %]
diff --git a/docs/website/navigation.html b/docs/website/navigation.html
index aefda83..c27bc7b 100644
--- a/docs/website/navigation.html
+++ b/docs/website/navigation.html
@@ -17,13 +17,13 @@
   <h3 id="comms"><a href="communicate.html">Communicate</a></h3>
 
   <p>
-    Join the <a href="">capa-devel</a> mailing list or try
+    Join the <a href="communicate.html#mail">capa-devel</a> mailing list or try
     the IRC channel #capa on <a href="http://oftc.net">OFTC</a>
   </p>
 </div>
 
 <div class="section">
-  <h3 id="docs"><a href="documentation.hml">Documentation</a></h3>
+  <h3 id="docs"><a href="documentation.html">Documentation</a></h3>
 
   <p>
     View <a href="screenshots.html">screenshots</a> of the application
@@ -40,15 +40,15 @@
   <h3 id="bugs"><a href="bugs.html">Bug reporting</a></h3>
 
   <p>
-    View <a href="">known</a> bugs
+    View <a href="bugs.html#view">known</a> bugs
   </p>
   <p>
-    <a href="">Report</a> a new bug
+    <a href="bugs.html#report">Report</a> a new bug
   </p>
 </div>
 
 <div class="section">
-  <h3 id="scm"><a href="">Code repository</a></h3>
+  <h3 id="scm"><a href="scm.html">Code repository</a></h3>
 
   <p>
     The code is <a href="http://gitorious.org/capa/capa">browseable</a> online.
diff --git a/docs/website/page.html b/docs/website/page.html
index 2123514..7036a1d 100644
--- a/docs/website/page.html
+++ b/docs/website/page.html
@@ -7,7 +7,7 @@
   </head>
   <body>
     <div id="header">
-      <h1>CAPA: [% title %]</h1>
+      <h1><a href="index.html">CAPA:</a> [% title %]</h1>
     </div>
 
     <div id="main">
diff --git a/docs/website/scm.html.in b/docs/website/scm.html.in
new file mode 100644
index 0000000..b2ac0d5
--- /dev/null
+++ b/docs/website/scm.html.in
@@ -0,0 +1,23 @@
+[% SET
+   title = "Source code management" %]
+
+[% WRAPPER page.html %]
+
+<p>
+  Capa uses GIT for managing source code. Don't be afraid.
+</p>
+
+<p>
+  The code is browseable</a> online
+</p>
+<pre>
+  <a href="http://gitorious.org/capa/capa">http://gitorious.org/capa/capa</a>
+</pre>
+<p>
+  Or get a direct local checkout using
+</p>
+<pre>
+  # git clone git://gitorious.org/capa/capa.git
+</pre>
+
+[% END %]
diff --git a/docs/website/screenshots.html.in b/docs/website/screenshots.html.in
new file mode 100644
index 0000000..7bc4cca
--- /dev/null
+++ b/docs/website/screenshots.html.in
@@ -0,0 +1,7 @@
+[% SET
+   title = "Screenshots" %]
+
+[% WRAPPER page.html %]
+
+
+[% END %]
diff --git a/docs/website/todo.html.in b/docs/website/todo.html.in
new file mode 100644
index 0000000..b11b005
--- /dev/null
+++ b/docs/website/todo.html.in
@@ -0,0 +1,34 @@
+[% SET
+   title = "Todo items &amp; ideas for future work" %]
+
+[% WRAPPER page.html %]
+
+<h2>Core planned, but missing functionality</h2>
+
+<ul>
+  <li>New/open/close of sessions</li>
+  <li>Custimizable camera setting control layouts</li>
+  <li>Handle disconnect &amp; re-connect of camera while manager is open</li>
+  <li>Automatic refresh of settings from camera to track changes</li>
+  <li>Preferences dialog w/ gconf(?) backend</li>
+  <li>Track camera based off serial number + model</li>
+</ul>
+
+<h2>Important scalability work</h2>
+
+<ul>
+  <li>Load all images in background threads</li>
+  <li>Use the freedesktop thumbnail spec for caching thumbnails</li>
+</ul>
+
+<h2>Ideas for future "cool stuff"</h2>
+
+<ul>
+  <li>Ability to configure camera settings from image EXIF tags</li>
+  <li>Add support for libgudev as option instead of HAL</li>
+  <li>Automatically unmount gvfs volumes to allow camera use</li>
+  <li>Allow tear-off windows for thumbnails to allow larger comparisons</li>
+  <li>Real fullscreen mode where menus, settings, thumbnails &amp; toolbar are hidden</li>
+</ul>
+
+[% END %]
-- 
2.1.4