View the DQSD CVS repository here:
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/dqsd/
Update of /cvsroot/dqsd/dqsdweb
In directory usw-pr-cvs1:/tmp/cvs-serv28108
Modified Files:
dqsdsearchwiz.jpg msnbc.jpg searchwizard.htm
wizard_toolbar.jpg
Added Files:
switches.jpg
Log Message:
--- NEW FILE: switches.jpg ---
(This appears to be a binary file; contents omitted.)
Index: dqsdsearchwiz.jpg
===================================================================
RCS file: /cvsroot/dqsd/dqsdweb/dqsdsearchwiz.jpg,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
Binary files /tmp/cvst0K8od and /tmp/cvsy9kubg differ
Index: msnbc.jpg
===================================================================
RCS file: /cvsroot/dqsd/dqsdweb/msnbc.jpg,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
Binary files /tmp/cvsa8Nfwe and /tmp/cvsyMnHKi differ
Index: searchwizard.htm
===================================================================
RCS file: /cvsroot/dqsd/dqsdweb/searchwizard.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** searchwizard.htm 12 Aug 2002 23:04:02 -0000 1.2
--- searchwizard.htm 13 Aug 2002 05:14:38 -0000 1.3
***************
*** 6,9 ****
--- 6,10 ----
li { padding-bottom: 1em }
img { margin: 5px }
+ .code { font-size: 80%; color: maroon; background: #eeeeee; border: black 1px solid;
+padding: 3px 3px }
</style>
</head>
***************
*** 31,48 ****
<hr size="1">
! <h3>What does it do?</h3>
<p>
! In a nutshell, it creates a DQSD search from the page currently displayed in your
browser.
</p>
<p>
! One of the first things you typically do when creating a new search is to view the
source for the page containing the FORM INPUT elements. It's
tedious. It's hard to find the right FORM when there are multiple FORMs in
the page. It's error-prone because I have to convert the HTML to
well-formed XML (and I always forget to close the INPUT elements with "/>").
</p>
! <h3>How do I use it?</h3>
<p>
<ol>
<li>Go to the web page with the search.</li>
<li>Click in the field you want to be receive the search string.</li>
--- 32,58 ----
<hr size="1">
! <h3>What does it do and why would I want to use it?</h3>
<p>
! In a nutshell, it generates a DQSD search from the page currently displayed in your
browser.
</p>
<p>
! If you have no desire to ever write a search for DQSD, then don't read any
further. If you do write searches from time to time, or at least want to,
then you may find the DQSD Search Wizard useful. At least I do.
</p>
! <p>
! One of the first things I typically do when creating a new search is to view the
source for the page containing the FORM INPUT elements. It's
tedious. It's hard to find the right FORM when there are multiple FORMs in
the page. It's error-prone because I have to convert the HTML to
well-formed XML (and I always forget to close the INPUT elements with "/>").
! </p>
!
! <p>
! There had to be an easier way.
! </p>
!
! <h3>OK, so how do I use it?</h3>
<p>
<ol>
+ <li><a
+href="http://sourceforge.net/project/showfiles.php?group_id=42081&release_id=104770";>Install</a>
+ the Search Wizard.</li>
<li>Go to the web page with the search.</li>
<li>Click in the field you want to be receive the search string.</li>
***************
*** 53,60 ****
</li>
<li>
! You should see a dialog that looks something like the following. Enter a
name and a title. (The name is the string that will invoke the search and
will be used name the file, so keep it short and simple.)<br/>
<center><img src="dqsdsearchwiz.jpg" align="top"></center>
</li>
<li>Hit OK and you'll be prompted to save the search file to your DQSD 'searches'
directory.</li>
</ol>
</p>
--- 63,71 ----
</li>
<li>
! You should see a dialog that looks something like the following. Some of
the fields will be automatically filled in. Enter a name and a title for
the new search. The name is the string that will invoke the search and will
be used name the file, so keep it short and simple.<br/>
<center><img src="dqsdsearchwiz.jpg" align="top"></center>
</li>
<li>Hit OK and you'll be prompted to save the search file to your DQSD 'searches'
directory.</li>
+ <li>After saving the file, it will come up in Notepad by default. (Click
+'Options...' to change the editor to something other than Notepad.)
</ol>
</p>
***************
*** 63,71 ****
<p>
! In the screenshot above, I went to <a
href="http://www.msnbc.com";>http://www.msnbc.com</a>, clicked in the search field to
make it 'active'...<br/>
<center><img src="msnbc.jpg"></center>
! Then I invoked the wizard, entered 'msnbc' for the name, and 'MSNBC News' for the
title (the title is what appears in the menu and help). All the FORM
elements in the page are listed, with the one checked that contains the 'active'
element.
</p>
</body>
--- 74,243 ----
<p>
! In the screen shot above, I went to <a
href="http://www.msnbc.com";>http://www.msnbc.com</a>, clicked in the search
field...<br/>
<center><img src="msnbc.jpg"></center>
! Then I clicked the 'DQSD Search Wizard' button. All the FORM elements in
the page are listed, with the one checked that contains the 'active'
element. I entered 'msnbc' for the name, enter 'msnbc' for the search name
and 'MSNBC News' for the title (the title is what appears in the menu and
help). Finally, I hit OK and I was prompted to save 'msnbc.xml' to the
'searches' subdirectory in the DQSD installation.
! </p>
!
! <p>
! The resulting XML file search file will look something like <a href="#searchxml">the
following</a>. And, in spite of the comment at the top of the file, this
search works as is! Woo hoo! (Well, I find it fairly
exciting.) Granted, complicated searches won't 'just work', but the wizard
will at least do a bunch of the boring work.
! </p>
!
! <a name="searchxml" />
! <div class="code">
! <xmp>
! <search function="msnbc">
! <COMMENT>
!
! This search file was initially created by Dave's Quick Search Deskbar
! Search Wizard version 0.4 (beta) on 08/12/02 at 23:09:04
!
! Even though this XML search will probably load and is a healthy start
! toward a completed search, please be aware that this search will probably
! not work as is and will require some human inspection and modification.
!
! </COMMENT>
! <name>MSNBC</name>
! <category>News</category>
! <contributor>Glenn Carr</contributor>
! <link>http://www.msnbc.com/</link>
! <email>[EMAIL PROTECTED]</email>
! <description>
! MSNBC Search
! </description>
! <form name="msnbcf"
! method="post"
! action="http://www.msnbc.com/modules/bom/findlog.asp";>
!
! <COMMENT> The following field was active (i.e. had focus) when the search was
generated. </COMMENT>
!
! <input type="hidden" name="qt" value="" />
! </form>
! <script><![CDATA[
! function msnbc(q)
! {
! if( nullArgs("msnbc", q) )
! return;
!
! if( q == "" )
! {
! openSearchWindow("http://www.msnbc.com/";);
! return;
! }
!
! // FORM variables for msnbcf
!
! // The wizard assigned the search string to this form field value because
! // this field was the active element when the search file was generated.
! // Change this to args.q if the search string is parsed with parseArgs.
! document.msnbcf.qt.value = q;
!
! submitForm(msnbcf);
! }
! ]]></script>
! </search>
! </xmp>
! </div>
!
! <h3>Switches</h3>
!
! <p>
! The 'parseArgs' utility method has become the convention for parsing switches for
searches. If you enter some switches in the 'Switches:' field of the search
wizard...<br/>
! <center><img src="switches.jpg"></center><br/>
! ...the generated search will now include basic code for parsing the switches:
</p>
+ <div class="code">
+ <xmp>
+ <search function="msnbc">
+ <COMMENT>
+
+ This search file was initially created by Dave's Quick Search Deskbar
+ Search Wizard version 0.4 (beta) on 08/12/02 at 23:38:36
+
+ Even though this XML search will probably load and is a healthy start
+ toward a completed search, please be aware that this search will probably
+ not work as is and will require some human inspection and modification.
+
+ </COMMENT>
+ <name>MSNBC</name>
+ <category>News</category>
+ <contributor>Glenn Carr</contributor>
+ <link>http://www.msnbc.com/</link>
+ <email>[EMAIL PROTECTED]</email>
+ <description>
+ MSNBC Search
+ </description>
+ <form name="msnbcf"
+ method="post"
+ action="http://www.msnbc.com/modules/bom/findlog.asp";>
+
+ <COMMENT> The following field was active (i.e. had focus) when the search was
+generated. </COMMENT>
+
+ <input type="hidden" name="qt" value="" />
+ </form>
+ <script><![CDATA[
+ function msnbc(q)
+ {
+ if( nullArgs("msnbc", q) )
+ return;
+
+ if( q == "" )
+ {
+ openSearchWindow("http://www.msnbc.com/";);
+ return;
+ }
+ </xmp><xmp style="color: red">
+ // Parse switches with parseArgs:
+
+ // parseArgs usage:
+ // Arguments:
+ // q - string from the search function
+ // expectedSwitches - list or array of the expected switch values
+ // expandSwitches - optional parameter [default = true] used to determine
+ // if the switch shortcuts should be expanded (i.e. /f
+becomes /foo)
+ // Returns an object with these properties:
+ // q - the input string with the switches removed
+ // switches - array of objects with these two properties:
+ // name: expanded name of the matched switch (i.e. foo as
+in /foo:bar)
+ // value: value of switch (i.e. bar as in /foo:bar)
+ // switch_val - associative array with the switch name as the key with the
+switch value
+ // as the value. (i.e. switch_val["foo"] = "bar" as in
+/foo:bar)
+
+ //var args = parseArgs(q, "news, sports, business");
+ //if ( args.switches.length > 0 )
+ //{
+ // switch( args.switches[0].name )
+ // {
+ // case "news":
+ // break;
+ // case "sports":
+ // break;
+ // case "business":
+ // break;
+ // default:
+ // break;
+ // } //end-switch
+ //}
+ </xmp><xmp>
+ // FORM variables for msnbcf
+
+ // The wizard assigned the search string to this form field value because
+ // this field was the active element when the search file was generated.
+ // Change this to args.q if the search string is parsed with parseArgs.
+ document.msnbcf.qt.value = q;
+
+ submitForm(msnbcf);
+ }
+ ]]></script>
+ </search>
+ </xmp>
+ </div>
+
+ <p>
+ Anyway, that's the gist of it. It needs a lot of testing, and there is
+plenty of room for improvement. It's also open source, so feel free to
+hack away.
+ <p>
+
+ Glenn Carr<br/>
+ August 13, 2002
</body>
Index: wizard_toolbar.jpg
===================================================================
RCS file: /cvsroot/dqsd/dqsdweb/wizard_toolbar.jpg,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
Binary files /tmp/cvsWBZJbf and /tmp/cvseuq65j differ
-------------------------------------------------------
This sf.net email is sponsored by: Dice - The leading online job board
for high-tech professionals. Search and apply for tech jobs today!
http://seeker.dice.com/seeker.epl?rel_code=31
_______________________________________________
DQSD-CVS mailing list
https://lists.sourceforge.net/lists/listinfo/dqsd-cvs
DQSD CVS repository:
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/dqsd/
![[DQSD-CVS] dqsdweb switches.jpg,NONE,1.1 dqsdsearchwiz.jpg,1.1,1.2 msnbc.jpg,1.1,1.2 searchwizard.htm,1.2,1.3 wizard_toolbar.jpg,1.1,1.2](/search?l=dqsd-devel@lists.sourceforge.net&q=subject:%22%5C%5BDQSD%5C-CVS%5C%5D+dqsdweb+switches.jpg%2CNONE%2C1.1+dqsdsearchwiz.jpg%2C1.1%2C1.2+msnbc.jpg%2C1.1%2C1.2+searchwizard.htm%2C1.2%2C1.3+wizard_toolbar.jpg%2C1.1%2C1.2%22&o=newest){kind=link}
