Added auto generated FAQ
authorPravin Shinde <pravin@black-perl.(none)>
Thu, 16 Jul 2009 08:27:00 +0000 (10:27 +0200)
committerPravin Shinde <pravin@black-perl.(none)>
Thu, 16 Jul 2009 08:27:00 +0000 (10:27 +0200)
still need to add stylesheet for that

BKOStylesteet.css
Troubleshooting.html
faq.html [new file with mode: 0644]
faq/Makefile [new file with mode: 0644]
faq/footer.txt [new file with mode: 0644]
faq/header.txt [new file with mode: 0644]
faq/makefaq.pl [new file with mode: 0755]
faq/questions.txt [new file with mode: 0644]
index.html

index c3b7820..ecf5b42 100644 (file)
@@ -2,8 +2,10 @@
        body {
                margin-left: 10%; margin-right: 10%;
                color: black; background: white;
+               
        }
-   
+
+
    download3 {
       background: #fff;
       padding: 3px;
index 92941c8..6f3ffdb 100644 (file)
@@ -38,7 +38,7 @@
         Developer
       </span>
       <span id="menulink">
-        <a href="FAQ.html">FAQ</a>      
+        <a href="faq.html">FAQ</a>      
       </span>
       <span id="menuact">
       Troubleshooting
@@ -53,7 +53,7 @@
   This page is still under development.   We are looking forward for feedback from our
   users which will give us good picture about the problems that one may face in booting with BKO. <br>
   
-  We have tried to cover most of the problems that user may face in <a href="FAQ.html">FAQ</a> page.
+  We have tried to cover most of the problems that user may face in <a href="faq.html">FAQ</a> page.
   <br/>
   <a name="customizedGpxe">
   <h2>Customized gpxe images</h2>
diff --git a/faq.html b/faq.html
new file mode 100644 (file)
index 0000000..a6ab6fa
--- /dev/null
+++ b/faq.html
@@ -0,0 +1,357 @@
+<html>
+  <head>
+  <link rel="stylesheet" type="text/css" href="BKOStylesteet.css" />
+    <title>boot.kernel.org(BKO)</title>
+  </head>
+  <body>
+    <div id="logo">
+    <table border="0" width="100%" cellpadding="0" cellspacing="0">
+    <tr>
+      <td valign="middle" align="center">
+        <img src="boot.png" width="367" height="261">
+      </td>
+      <td valign="middle" align="left">
+        <span id="logotext">
+        <p>
+        boot.kernel.org(BKO) : Booting your machine over HTTP
+        </p>
+        </span>
+      </td>
+    </tr>
+    </table>
+    </div>
+    <div id="menubox">
+
+      <span id="menulink">
+        <a href="index.html">Home</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#download">Downloads</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#screenshots">Screenshots</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#howtouse">How to Use</a>
+      </span>
+      <span id="menulink">
+        Developer
+      </span>
+      <span id="menuact">
+        FAQ      
+      </span>
+      <span id="menulink">
+      <a href="Troubleshooting.html">Troubleshooting</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#contactus">Contact US</a>
+      </span>
+    </div>
+
+    <center><h1>FAQ for BKO</h1></center>
+<ul>
+<li><a href="#whySlow"> Why it is slow?</a><br/><br/></li>
+<li><a href="#privacySecurity"> What about my privacy and security?</a><br/><br/></li>
+<li><a href="#WhyBboUsb"> Why should I create BKO enabled USB?</a><br/><br/></li>
+<li><a href="#firewallBKO"> I am behind firewall, Will BKO boot me?</a><br/><br/></li>
+<li><a href="#testBKO"> I just want to test BKO, without rebooting the system, Can I do it?</a><br/><br/></li>
+</ul>
+
+ Q. When should I use BKO for booting?
+
+ A.   <p>
+
+      We envision following usage for BKO
+
+      <ol>
+
+        <li>
+
+          To experiment with different distributions available on this site, and install one which you like most.
+
+       </li>
+
+       <li>
+
+          To save your data/system when somehow your system is messed up and you want to recover it. You can use
+
+         many of the tools available on BKO to rescue yourself.
+
+       </li>
+
+       <li>
+
+         You can do automated mass booting and automated installation for large number of workstations.
+
+         This can be done by adding specific embedded script to BKO (or by having your private BKO server).
+
+       </li>
+
+       <li>
+
+          Other than these, if you find any other use for BKO, then please share with us. we will be glad to hear from you.
+
+       </li>
+
+      </ol>
+
+    </p>
+
+
+
+<a id="whySlow"></a><div class="qbox" >
+<table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="qmrk" width="1px"><span class="question">Q.</span></td>
+<td class="qtd">
+<div class="query"> Why it is slow?
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="abox">
+<table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="amrk" width="1px"><span class="answer">A.</span></td>
+<td class="atd">
+<div class="reply">  <p>
+    <ul>
+
+      <li>
+
+       Your entire Operating System is fetched over Internet from <i>far far away server</i> and this takes time.
+
+      </li>
+
+      <li>
+
+       The delay is mostly in booting process, once the system is booted, it should work faster.
+
+      </li>
+
+      <li>
+
+        We recommend you to choose nearby mirror, which will give you <strong>much</strong> better performance.
+
+      </li>
+
+      <li>
+
+        In most of the usage scinario's mentioned above, some delay is tolerable.
+
+      </li>
+
+      <li>
+
+        We recommend you to not to run your daily system from BKO, Please install one of the system available on BKO.
+
+      </li>
+
+    </ul>
+
+  </p>
+
+
+
+
+</div>
+</td>
+</tr>
+</table>
+</div><a id="privacySecurity"></a><div class="qbox" >
+<table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="qmrk" width="1px"><span class="question">Q.</span></td>
+<td class="qtd">
+<div class="query"> What about my privacy and security?
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="abox">
+<table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="amrk" width="1px"><span class="answer">A.</span></td>
+<td class="atd">
+<div class="reply">  <p>
+    We understand your concern, following clarifications should make matter clear for you. You are free to make any decision after that.
+
+    <ul>
+
+      <li>
+
+        Your machine will only download data from server and will never send to the server. So you need not worry about privacy.
+
+      </li>
+
+      <li>
+
+        We provide unmodified ISO's of all distributions, You are always welcome to verify the checksum with actual distribution provider.
+
+      </li>
+
+      <li>
+
+        Even better, you can provide the path of the ISO directly, and your machine will use only that ISO.
+
+      </li>
+
+      <li>
+
+        We only modify InitRAMFS, which is needed to boot over HTTPFS. This modified InitRAMFS is deleted once booting is complete.
+
+       Hence, if you trust the ISO used, you can trust the system.
+
+      </li>
+
+      <li>
+
+        This is Open Source project, you are welcome to review the code.
+
+      </li>
+
+      <li>
+
+        We also plan to support HTTPS for avoiding any data-tempering on the way.
+
+      </li>
+
+    </ul>
+
+  </p>
+
+
+
+
+
+
+</div>
+</td>
+</tr>
+</table>
+</div><a id="WhyBboUsb"></a><div class="qbox" >
+<table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="qmrk" width="1px"><span class="question">Q.</span></td>
+<td class="qtd">
+<div class="query"> Why should I create BKO enabled USB?
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="abox">
+<table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="amrk" width="1px"><span class="answer">A.</span></td>
+<td class="atd">
+<div class="reply">  <p>
+    <ul>
+
+      <li>
+
+        Creating BKO enabled USB is one-time job, once it is created, you need not worry about upgradation, as it is taken care by BKO servers.
+
+       It will always let you boot with latest distributions and tools available on BKO.
+
+      </li>
+
+      <li>
+
+        You do not waste your USB as there is way to create BKO enabled USB which can be used as normal data storage device.
+
+       As BKO takes less than 1 MB of space, you have almost entire USB for data storage.
+
+      </li>
+
+      <li>
+
+        BKO enabled USB can be used to boot (almost) any system as long as there is Internet connectivity.<br/>
+
+       It is worth considering this ability against 1MB of space and few minutes for creation of BKO enabled USB.
+
+      </li>
+
+    </ul>
+
+  </p>
+
+
+
+
+</div>
+</td>
+</tr>
+</table>
+</div><a id="firewallBKO"></a><div class="qbox" >
+<table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="qmrk" width="1px"><span class="question">Q.</span></td>
+<td class="qtd">
+<div class="query"> I am behind firewall, Will BKO boot me?
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="abox">
+<table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="amrk" width="1px"><span class="answer">A.</span></td>
+<td class="atd">
+<div class="reply"> <p>
+    BKO is based on HTTPFS and it uses only valid HTTP requests.  It means, if you have HTTP access, you can boot with BKO.<br/>
+
+    Only problem that may occur is if you are behind HTTP proxy.  We plan to add support for HTTP proxy
+
+    in near future. Stay tuned till then.
+
+  </p>
+
+</li>
+
+
+
+
+</div>
+</td>
+</tr>
+</table>
+</div><a id="testBKO"></a><div class="qbox" >
+<table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="qmrk" width="1px"><span class="question">Q.</span></td>
+<td class="qtd">
+<div class="query"> I just want to test BKO, without rebooting the system, Can I do it?
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="abox">
+<table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
+<tr>
+<td class="amrk" width="1px"><span class="answer">A.</span></td>
+<td class="atd">
+<div class="reply">  <p>
+                 If you want to just test our solution without rebooting, then we will recommend you
+
+                 to download the floppy image of gpxe, and use qemu or other virtualization
+
+                 solutions to boot from gpxe you downloaded.  In case of qemu, you can use following command:
+
+                 <pre> qemu -fda gpxe.dsk</pre>
+
+  </p>
+
+
+</div>
+</td>
+</tr>
+</table>
+</div><hr/>
+</body>
+</html>
diff --git a/faq/Makefile b/faq/Makefile
new file mode 100644 (file)
index 0000000..f4679a3
--- /dev/null
@@ -0,0 +1,13 @@
+PERL    = perl
+
+GENFILES = faq.html
+
+all : $(GENFILES)
+
+clean :
+       rm -f $(GENFILES)
+
+faq.html : questions.txt header.txt footer.txt makefaq.pl
+       $(PERL) makefaq.pl > $@.new
+       mv -f $@.new ../$@
+
diff --git a/faq/footer.txt b/faq/footer.txt
new file mode 100644 (file)
index 0000000..133381d
--- /dev/null
@@ -0,0 +1,3 @@
+<hr/>
+</body>
+</html>
diff --git a/faq/header.txt b/faq/header.txt
new file mode 100644 (file)
index 0000000..7c257da
--- /dev/null
@@ -0,0 +1,52 @@
+<html>
+  <head>
+  <link rel="stylesheet" type="text/css" href="BKOStylesteet.css" />
+    <title>boot.kernel.org(BKO)</title>
+  </head>
+  <body>
+    <div id="logo">
+    <table border="0" width="100%" cellpadding="0" cellspacing="0">
+    <tr>
+      <td valign="middle" align="center">
+        <img src="boot.png" width="367" height="261">
+      </td>
+      <td valign="middle" align="left">
+        <span id="logotext">
+        <p>
+        boot.kernel.org(BKO) : Booting your machine over HTTP
+        </p>
+        </span>
+      </td>
+    </tr>
+    </table>
+    </div>
+    <div id="menubox">
+
+      <span id="menulink">
+        <a href="index.html">Home</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#download">Downloads</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#screenshots">Screenshots</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#howtouse">How to Use</a>
+      </span>
+      <span id="menulink">
+        Developer
+      </span>
+      <span id="menuact">
+        FAQ      
+      </span>
+      <span id="menulink">
+      <a href="Troubleshooting.html">Troubleshooting</a>
+      </span>
+      <span id="menulink">
+        <a href="index.html#contactus">Contact US</a>
+      </span>
+    </div>
+
+    <center><h1>FAQ for BKO</h1></center>
diff --git a/faq/makefaq.pl b/faq/makefaq.pl
new file mode 100755 (executable)
index 0000000..95e00d7
--- /dev/null
@@ -0,0 +1,79 @@
+#!/usr/bin/perl
+
+# makefaq.pl
+# Author: John "warthog9" Hawley
+# License: GPL
+# Date Created: 09/30/2005
+# Description:
+#      Basically this is just a quick slap together script I wrote
+#      to deal with the generation of the FAQ file.  This was due
+#      to the fact I wanted the questions seperate from the surrounding 
+#      page structure.  If it changes it should be a LOT easier to adjust
+#      to them.
+#
+# Changelog:
+#--------------------------------------------
+#   Date:    | Who           | Description
+#------------+---------------+---------------
+# 09/30/2005 | JH "warthog9" |  Initial Creation 
+#            |               |
+#            |               |
+#            |               |
+
+
+$questionsfile = "questions.txt";
+$headerfile = "header.txt";
+$footerfile = "footer.txt";
+
+$question_pre = "<div class=\"qbox\" >\n<table class=\"qtable\" width=\"100%\" border=\"0\" cellpadding=\"5\" cellspacing=\"0\">\n<tr>\n<td class=\"qmrk\" width=\"1px\"><span class=\"question\">Q.</span></td>\n<td class=\"qtd\">\n<div class=\"query\">";
+$question_post = "\n</div>\n</td>\n</tr>\n</table>\n</div>";
+$answer_pre = "<div class=\"abox\">\n<table class=\"atable\" width=\"100%\" border=\"0\" cellpadding=\"5\" cellspacing=\"0\">\n<tr>\n<td class=\"amrk\" width=\"1px\"><span class=\"answer\">A.</span></td>\n<td class=\"atd\">\n<div class=\"reply\">";
+$answer_post = "\n</div>\n</td>\n</tr>\n</table>\n</div>";
+
+open( FH, $headerfile ) || die "No Header file found\n";
+
+while ( <FH> ){
+       print $_;
+}
+
+close(FH);
+
+$questionindex = "";
+$qasection = "";
+undef $tagname;
+
+open( FH, $questionsfile) || die "No Question file found\n";
+$answertail = '';
+
+
+while ( <FH> ){
+       if (/^\#(\S+)/) {
+           $qasection .= $answertail;
+           $answertail = '';
+           $tagname = $1;
+           next;
+       } elsif(/^Q\.(.*)/) {
+           $q = $1;
+           $foo = $1;
+           $foo =~ s/[^a-zA-Z0-9_]/_/g;
+           $tagname = $foo unless ( defined($tagname) );
+           $questionindex .= "<li><a href=\"#$tagname\">$q</a><br/><br/></li>\n";
+           $qasection .= "<a id=\"$tagname\"></a>". $question_pre . $q . $question_post ."\n";
+           undef $tagname;
+       } elsif(/^A\.(.*)/) {
+           $qasection .= $answer_pre . $1 . "\n";
+           $answertail = $answer_post;
+       } else {
+           $qasection .= $_ . "\n";
+       }
+}
+close( FH );
+$qasection .= $answertail;
+
+print "<ul>\n". $questionindex ."</ul>\n\n". $qasection;
+
+open( FH, $footerfile ) || die "No Footer file found\n";
+while ( <FH> ){
+       print $_;
+}
+close( FH );
diff --git a/faq/questions.txt b/faq/questions.txt
new file mode 100644 (file)
index 0000000..b3525d2
--- /dev/null
@@ -0,0 +1,108 @@
+#whenBKO
+ Q. When should I use BKO for booting?
+ A.   <p>
+      We envision following usage for BKO
+      <ol>
+        <li>
+          To experiment with different distributions available on this site, and install one which you like most.
+       </li>
+       <li>
+          To save your data/system when somehow your system is messed up and you want to recover it. You can use
+         many of the tools available on BKO to rescue yourself.
+       </li>
+       <li>
+         You can do automated mass booting and automated installation for large number of workstations.
+         This can be done by adding specific embedded script to BKO (or by having your private BKO server).
+       </li>
+       <li>
+          Other than these, if you find any other use for BKO, then please share with us. we will be glad to hear from you.
+       </li>
+      </ol>
+    </p>
+
+#whySlow
+Q. Why it is slow?
+A.  <p>
+    <ul>
+      <li>
+       Your entire Operating System is fetched over Internet from <i>far far away server</i> and this takes time.
+      </li>
+      <li>
+       The delay is mostly in booting process, once the system is booted, it should work faster.
+      </li>
+      <li>
+        We recommend you to choose nearby mirror, which will give you <strong>much</strong> better performance.
+      </li>
+      <li>
+        In most of the usage scinario's mentioned above, some delay is tolerable.
+      </li>
+      <li>
+        We recommend you to not to run your daily system from BKO, Please install one of the system available on BKO.
+      </li>
+    </ul>
+  </p>
+
+#privacySecurity
+Q. What about my privacy and security?
+A.  <p>
+    We understand your concern, following clarifications should make matter clear for you. You are free to make any decision after that.
+    <ul>
+      <li>
+        Your machine will only download data from server and will never send to the server. So you need not worry about privacy.
+      </li>
+      <li>
+        We provide unmodified ISO's of all distributions, You are always welcome to verify the checksum with actual distribution provider.
+      </li>
+      <li>
+        Even better, you can provide the path of the ISO directly, and your machine will use only that ISO.
+      </li>
+      <li>
+        We only modify InitRAMFS, which is needed to boot over HTTPFS. This modified InitRAMFS is deleted once booting is complete.
+       Hence, if you trust the ISO used, you can trust the system.
+      </li>
+      <li>
+        This is Open Source project, you are welcome to review the code.
+      </li>
+      <li>
+        We also plan to support HTTPS for avoiding any data-tempering on the way.
+      </li>
+    </ul>
+  </p>
+
+
+#WhyBboUsb
+Q. Why should I create BKO enabled USB?
+A.  <p>
+    <ul>
+      <li>
+        Creating BKO enabled USB is one-time job, once it is created, you need not worry about upgradation, as it is taken care by BKO servers.
+       It will always let you boot with latest distributions and tools available on BKO.
+      </li>
+      <li>
+        You do not waste your USB as there is way to create BKO enabled USB which can be used as normal data storage device.
+       As BKO takes less than 1 MB of space, you have almost entire USB for data storage.
+      </li>
+      <li>
+        BKO enabled USB can be used to boot (almost) any system as long as there is Internet connectivity.<br/>
+       It is worth considering this ability against 1MB of space and few minutes for creation of BKO enabled USB.
+      </li>
+    </ul>
+  </p>
+
+#firewallBKO
+Q. I am behind firewall, Will BKO boot me?
+A. <p>
+    BKO is based on HTTPFS and it uses only valid HTTP requests.  It means, if you have HTTP access, you can boot with BKO.<br/>
+    Only problem that may occur is if you are behind HTTP proxy.  We plan to add support for HTTP proxy
+    in near future. Stay tuned till then.
+  </p>
+</li>
+
+#testBKO
+Q. I just want to test BKO, without rebooting the system, Can I do it?
+A.  <p>
+                 If you want to just test our solution without rebooting, then we will recommend you
+                 to download the floppy image of gpxe, and use qemu or other virtualization
+                 solutions to boot from gpxe you downloaded.  In case of qemu, you can use following command:
+                 <pre> qemu -fda gpxe.dsk</pre>
+  </p>
index dcae1af..4c1170e 100755 (executable)
@@ -13,9 +13,7 @@
       </td>
       <td valign="middle" align="left">
         <span id="logotext">
-        <p>
-        boot.kernel.org(BKO) : Booting your machine over HTTP
-        </p>
+               <p> boot.kernel.org(BKO) : Booting your machine over HTTP </p>
         </span>
       </td>
     </tr>
@@ -38,7 +36,7 @@
         Developer
       </span>
       <span id="menulink">
-        <a href="FAQ.html">FAQ</a>      
+        <a href="faq.html">FAQ</a>      
       </span>
       <span id="menulink">
       <a href="Troubleshooting.html">Troubleshooting</a>
       <tr>
       </tr>
         <td colspan="3">
-        We recommend creating <a href="FAQ.html#WhyBboUsb">BKO enabled USB</a>, which also allows you to store data, without wasting much 
-        space. You can refer <a href="FAQ.html#WhyBboUsb">why BKO enabled USB is better option</a>.
+        We recommend creating <a href="faq.html#WhyBboUsb">BKO enabled USB</a>, which also allows you to store data, without wasting much 
+        space. You can refer <a href="faq.html#WhyBboUsb">why BKO enabled USB is better option</a>.
            </td>
       <tr>
         <td colspan="3">
                get back your old system
             </li>
             <li>BKO is still under development.  If you encounter any problems anywhere, please refer
-               <a href="Troubleshooting.html">troubleshooting</a> and <a href="FAQ.html">FAQ</a> page 
+               <a href="Troubleshooting.html">troubleshooting</a> and <a href="faq.html">FAQ</a> page 
                for explanation.  If you don't find any solution to your problem, 
                then feel free to <a href="index.html#contactus">contact us</a>.  
             </li>
     <hr/>
     <a name="bootList">
     <p>
-      <h3>Tools and distributions available for boot on BKO</h3>
+      <h3> Tonight's menu on BKO </h3>
+      <h4>Linux Distributions</h4>
       <ol>
          <li>Damm Small Linux : Lightweight linux distribution with GUI.</li>
          <li>Knoppix : Knoppix 5.0.1 English.</li>
+         <li>Debian : Debian live</li>
          <li>Fedora 11 Live CD : Currently only single user mode is working. (Working on complete live CD)</li>
-         <li></li>     
+         <li>Ubuntu : Work in Progress</li>
+         <li></li>
+      </ol>
+      <h4>Tools</h4>
+      <ol>
+       <li>Hard disk utilities</li>
+       <li>NTFS utilities</li>
+       <li>Boot Managers</li>
+       
       </ol>
     </p>