[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r7093 - GNUnet-docs/WWW
From: |
gnunet |
Subject: |
[GNUnet-SVN] r7093 - GNUnet-docs/WWW |
Date: |
Sun, 8 Jun 2008 15:02:43 -0600 (MDT) |
Author: grothoff
Date: 2008-06-08 15:02:43 -0600 (Sun, 08 Jun 2008)
New Revision: 7093
Modified:
GNUnet-docs/WWW/user_namespaces.php3
Log:
fixes
Modified: GNUnet-docs/WWW/user_namespaces.php3
===================================================================
--- GNUnet-docs/WWW/user_namespaces.php3 2008-06-08 20:59:38 UTC (rev
7092)
+++ GNUnet-docs/WWW/user_namespaces.php3 2008-06-08 21:02:43 UTC (rev
7093)
@@ -3,22 +3,24 @@
$title = "GNUnet Documentation: A Tutorial for Using Namespaces";
$description="How to create namespaces, add content to namespaces, update
content and search namespaces";
include("html_header.php3");
-H2("Howto Use Namespaces");
+H2("How to use namespaces");
afslogo();
ANCHOR("setup"); H3("Setup");
BP();
W("The first step to start with namespaces is to enable tracking of available
content.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-1.png",
"The 'Advanced' Tab in file-sharing",
"CENTER",615,492);
+BP();
W("This option is disabled by default since it would allow an adversary who
takes control of the current machine to determine what metadata the local user
has been exposed to.");
W("Once you are done with your namespace operation, you may want to disable
the checkbox and press the <tt>Clear</tt> button.");
W("For this tutorial, we need to enable tracking of available content:");
+EP();
IMG("screenshots/gnunet-gtk-namespace-2.png",
"The 'Advanced' Tab in file-sharing with tracking enabled",
"CENTER",615,492);
-EP();
ANCHOR("publish"); H3("Publish Content");
@@ -27,34 +29,41 @@
W("You could also add files that you did not upload yourself (and that you
only found by searching the network) to a namespace, but since you could not
know if those files were of high quality, we generally would advise against
it.");
W("The better method would be to download the content, check it and then
re-publish it.");
W("For this tutorial, we will assume that the content that you are publishing
in your namespace is content that you are sharing.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-3.png",
"The 'Publication' Tab in file-sharing",
"CENTER",615,492);
+BP();
W("As shown in the screenshot, select a file or directory from your local
disk.");
W("Any selections of the various options for publishing will work.");
W("After clicking the <tt>Publish</tt> button, you can edit the meta-data for
the content.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-4.png",
"Edit the meta-data for the publication",
"CENTER",712,482);
-P();
+BP();
W("Finally, you should switch to the <tt>Status</tt> tab and wait for your
upload to complete (blue bar full under Publications).");
+EP();
IMG("screenshots/gnunet-gtk-namespace-5.png",
"The status tab shows the progress of uploads and downloads",
"CENTER",615,492);
-EP();
ANCHOR("create"); H3("Creating the Namespace");
BP();
W("If you switch back to the <tt>Advanced</tt> tab, you should now see the
(tracked) content that you have published since enabling tracking in the
list.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-6.png",
"The 'Advanced' Tab in file-sharing with tracked content",
"CENTER",615,492);
+BP();
W("At this point, we can create our first namespace.");
W("Select <tt>New</tt> and then <tt>Namespace</tt> from the menu.");
W("A dialog will open where you can enter meta-data describing the
namespace.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-7.png",
"Dialog for entering metadata about the namespace",
"CENTER",694,459);
+BP();
W("You should at least provide a brief description, a title or an author.");
W("Those values will be used for the nickname of the namespace.");
W("If you fail to specify metadata for any of these types, your namespace will
be called 'unknown'.");
@@ -71,18 +80,20 @@
W("Note that part of the process is generating a secret key, so if your system
seems to hang, type randomly on your keyboard go generate entropy.");
P();
W("The <tt>Advanced</tt> tab should now look like this:");
+EP();
IMG("screenshots/gnunet-gtk-namespace-7.png",
"Dialog for entering metadata about the namespace",
"CENTER",615,492);
-EP();
ANCHOR("insert"); H3("Inserting into the Namespace");
BP();
W("In order to add content to your namespace, select a file or directory under
<tt>Available content</tt> and click <tt>Add</tt>.");
W("A new dialog will pop up where you need to specify an identifier for the
content.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-9.png",
"The 'Advanced' Tab in file-sharing",
"CENTER",487,177);
+BP();
W("The identifier is like a keyword, except that users need to use the
identifier in conjunction with the namespace to find the content.");
W("While not required, the first bit of content that we will publish in the
namespace will also be the root of the namespace, hence we will enter 'gpl' for
the identifier.");
W("The <tt>Next Identifier</tt> is the identifier that will be used for any
updates to the content published under <tt>Identifier</tt>.");
@@ -96,38 +107,46 @@
W("In order to demonstrate updating, we need a second available file.");
W("Following the same steps that we used for publishing the GPL, we added the
GPLv3.");
W("As a result, the <tt>Advanced</tt> tab should look like this:");
+EP();
IMG("screenshots/gnunet-gtk-namespace-10.png",
"The 'Advanced' Tab in file-sharing with GPLv3",
"CENTER",615,492);
+BP();
W("In the namespace tab, we select the original file that we want to publish
an update for (here COPYING) and in the <tt>Available Content</tt> list we
select the updated content (here gpl3.txt).");
W("We can then press the <tt>Update</tt> button to create an update.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-11.png",
"The 'Advanced' Tab in file-sharing",
"CENTER",510,137);
+BP();
W("This time, we are not prompted for an identifier -- 'gpl3' is automatically
chosen for us (since we are updating COPYING).");
W("We are given the opportunity to specify an identifier for the update to the
update.");
W("We can leave <tt>Next Identifier</tt> emtpy to express that there will
never be an update to 'gpl3'.");
W("The resulting namespace overview will then look like this:");
+EP();
IMG("screenshots/gnunet-gtk-namespace-12.png",
"The 'Advanced' Tab in file-sharing with GPLv3 inserted",
"CENTER",615,492);
-EP();
ANCHOR("search"); H3("Search");
BP();
W("Users that have discovered the namespace using a keyword search can then
select it from the drop-down list in the <tt>Search and Download</tt> tab
(behind <tt>in namespace</tt>.");
W("If a namespace is selected, the <tt>Keyword</tt> is automatically set to
the root of the namespace (here 'gpl'):");
+EP();
IMG("screenshots/gnunet-gtk-namespace-13.png",
"The 'Search and Download' Tab in file-sharing with the 'Free Software
Licenses' namespace selected",
"CENTER",615,492);
+BP();
W("The number behind the namespace identifier (here '0') can be used to assign
the namespace a 'rank'.");
W("The rank is not used by GNUnet; the idea is that users can use it to
express (and remember) which namespaces they like best.");
P();
W("Now that a namespace has been selected, the <tt>Find</tt> button can be
used to search it.");
+EP();
IMG("screenshots/gnunet-gtk-namespace-14.png",
"The 'Search and Download' Tab in file-sharing with search results for the
'Free Software Licenses' namespace",
- "CENTER",615,492);
+ "CENTER",809,691);
+BP();
W("GNUnet will first find the search result for the identifier 'gpl'.");
W("Since 'gpl' was specified with an update, GNUnet will then automatically
search for the update under the identifier 'gpl3'.");
W("All results found for 'gpl' and its (transitive) updates will be displayed
in the result list.");
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r7093 - GNUnet-docs/WWW,
gnunet <=