Re: [documentation-dev] FAQ Collaboration

[Scott Carr]

Diane Mackay wrote:
This sounds way cool.... All the suggested poison is new to me, so I 
am very
open-minded and eager to see what develops. :) If I can help somehow, 
I will try.
Definately.  I'll send an email with the script later this afternoon.
Have you played with the download tab at the OOoAuthors site? I'm 
writing about
it so that you know it is there. (Sorry if you already know.) You can 
download a
zipped HTML file of any directory in the FAQ section, which is 
generated by a
script that CPH wrote. (I don't think Con has released the script, but 
I may be
wrong.) I've played with the output file a little bit, by downloading 
the top
directory, but not enough to say too much more about it. Prior to this 
I had
chosen not to spend much time with it, but I repeatedly download it in 
hopes to
make time to play with it more.
I have, but like you, I like the format we currently have on FAQs 
better.  The individual file format lends itself well to search and 
browse both.  It also means the user is only downloading what they need.

What I am planning is creating a script that will pull down the html for 
the oooauthors site, and then spider through the various directories, 
etc, and create/modify the directory on the local machine, with a match 
to the directory on FAQ's.

This way the files won't change unless they change something on FAQ's.
So far I have the script pulling the portion of the page we need to 
start the spider.

[code name="faq_spider.pl"]
#!/bin/perl
use HTTP::Lite;
$http = new HTTP::Lite;
$req = $http->request("http://www.oooauthors.org/FAQs";);
$body = $http->body();
my ($content) = ($body =~ /div class="documentContent.*<div>(.*)<hr \/>/ms);
print $content;
[/code]
This will pull out the following:
[example]
       <h1>FAQs</h1>
       <p>This is a compilation of FAQs from various FAQ sites in the 
OOo community.</p>

       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/General";>General</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Writer";>Writer</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Calc";>Calc</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Impress";>Impress</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Draw";>Draw</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Math";>Math</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Email";>Email</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Database";>Database</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Macros";>Macros</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/Plone";>Using This Site</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/faqsetup";>Customize</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/faqinstall";>Install</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a 
href="http://oooauthors.org/FAQs/faqcompatibility";>Compatibility</a>
       </span>
       <span class="faqfolder">
            <img src="/folder.gif" />
            <a href="http://oooauthors.org/FAQs/newfaq";>New Faq Items</a>
       </span>
       <ul>
           <li>
                 <a href="http://oooauthors.org/FAQs/what";>What is the 
purpose of the FAQs project?</a>
             </li>
           <li>
                 <a href="http://oooauthors.org/FAQs/how";>How did the 
original FAQs end up at OOoAuthors.org?</a>
             </li>
           <li>
                 <a href="http://oooauthors.org/FAQs/20040314a";>How can 
I contribute to the FAQs?</a>
             </li>
         </ul>
[/example]

Now I can iterate over each of the span for the folders, and the li for 
the items.  ;-)

I wonder if we could do something similar, but end up with the 
individual faq
templates and index pages for each directory, as what exists in the 
present
doc.oo.o faq set. Maybe we could add a directory at a time, or something.
Smaller seems easier from a maintenance stand point. Anyway, I know 
nothing
about scripts and am eager to see what you develop... so I should shut 
up! :) It
will be fun to see the your ideas and scripting results.

Thank you!
No problem. 

--
Scott Carr
OpenOffice.org
Documentation Co-Lead
http://documentation.openoffice.org 

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]