exist-development

[Exist-development] Wikibook and xqDoc

[Chris W. <kit...@go...>]

I recently put a bit of time into restructuring the XQuery wikibook.
Amongst other changes I have built up the section on eXist to include
several of the modules and links to articles which illustrate the use of
functions in these modules.  There is much left to do but I hope its moving
in the right direction (until perhaps a move to some other platform).  Any
example code is always welcome and I will install it on my UWE server.

In the process of implementing examples of xqDoc, I couldnt find a basic
stylesheet to transform the output from the scan function to HTML - anyone
know of one?

Chris

Re: [Exist-development] Wikibook and xqDoc

[Wolfgang M. <wol...@ex...>]

> Amongst other changes I have built up the section on eXist to include
> several of the modules and links to articles which illustrate the use of
> functions in these modules.

Very useful indeed. Once we have the extended module documentation
system in place, we will use your table to link back to the wikibook
articles from the function documentation.

> In the process of implementing examples of xqDoc, I couldnt find a basic
> stylesheet to transform the output from the scan function to HTML - anyone
> know of one?

The xqDoc structure is rather simple, so we used XQuery to transform
output to HTML. For example, see Joe's module:

webapp/functions/functions.xql

Wolfgang

Re: [Exist-development] Wikibook and xqDoc

[Dan M. <dan...@gm...>]

Chris,

Thanks for taking the time to do this!  I think that having great examples
of how to do specific tasks is critical for our new users.  I think that
among all the other open source XQuery systems we are starting to get some
better documentation, especially for our beginning users.

Last week Dr. Martin Muller from Northwestern University in Illinois and a
frequent contributor to the TEI lists, challenged us to make eXist usable by
more of the non-programmers in the TEI community.  He sent us 40 Shakespeare
plays in poems in TEI format and wanted us to demonstrate how we would
create a simple system to do navigation and search.

Here is an early demo of what we need to document for the TEI community that
is building navigation and search:

http://www.syntactica.com/rest/db/org/northwestern/apps/tei/index.xq

Dr. Muller is willing to help writeup these examples (once he understand
them a bit more) so we might be creating a "Beginners Guide to TEI for
eXist" based on this work.

- Dan

On Mon, Mar 29, 2010 at 6:09 PM, Chris Wallace
<kit...@go...>wrote:

> I recently put a bit of time into restructuring the XQuery wikibook.
> Amongst other changes I have built up the section on eXist to include
> several of the modules and links to articles which illustrate the use of
> functions in these modules.  There is much left to do but I hope its moving
> in the right direction (until perhaps a move to some other platform).  Any
> example code is always welcome and I will install it on my UWE server.
>
> In the process of implementing examples of xqDoc, I couldnt find a basic
> stylesheet to transform the output from the scan function to HTML - anyone
> know of one?
>
> Chris
>
>
>
>
> ------------------------------------------------------------------------------
> Download Intel&#174; Parallel Studio Eval
> Try the new software tools for yourself. Speed compiling, find bugs
> proactively, and fine-tune applications for parallel performance.
> See why Intel Parallel Studio got high marks during beta.
> http://p.sf.net/sfu/intel-sw-dev
> _______________________________________________
> Exist-development mailing list
> Exi...@li...
> https://lists.sourceforge.net/lists/listinfo/exist-development
>
>


-- 
Dan McCreary
Semantic Solutions Architect
syntactica.com
952-460-1674
VOIP: 111@69.199.167.229

Re: [Exist-development] Wikibook and xqDoc

[Wolfgang M. <wol...@ex...>]

Dan,

> Here is an early demo of what we need to document for the TEI community that
> is building navigation and search:
>
> http://www.syntactica.com/rest/db/org/northwestern/apps/tei/index.xq

Cool. I think this will become a helpful demo. Martin has repeatedly
offered his help with writing documentation, but I'm flooded by so
many things, that I was unable to follow up in time. It is good to see
other people jump in ;-)

> Dr. Muller is willing to help writeup these examples (once he understand
> them a bit more) so we might be creating a "Beginners Guide to TEI for
> eXist" based on this work.

This would surely be a very welcome addition since many of our users
start with TEI. Will it be possible to distribute the demo for other
users to study?

Wolfgang

Re: [Exist-development] Wikibook and xqDoc

[Dan M. <dan...@gm...>]

> Will it be possible to distribute the demo for other users to study?

Yes, this is no problem for the XQuery code.  I will need to work with Dr.
Mueller to make sure that he feels comfortable with distributing the XML
markup of the Shakespeare code.  Either way, I will send the XQuery code to
anyone that is interested!

I must say that creating this demo with all of Shakespeare documents is a
great demonstration of the capabilities of the eXist system and the Lucene
search.  I only spent a bit of time on it and I am sure my code is not
"optimal" and could be cleaned up quite a bit.

One other note, I have found that there are some missing TEI tags in the
sample files that really need to be added to make the XQueries simpler.  For
example <div type="act"> and <div type="scene"> are missing.  I hope to work
with Dr. Mueller to encourage better TEI tags that make the XQueries much
simpler.  Right now they are more complex then they need to be.

- Dan

On Tue, Mar 30, 2010 at 1:09 PM, Wolfgang Meier <wol...@ex...>wrote:

> Dan,
>
> > Here is an early demo of what we need to document for the TEI community
> that
> > is building navigation and search:
> >
> > http://www.syntactica.com/rest/db/org/northwestern/apps/tei/index.xq
>
> Cool. I think this will become a helpful demo. Martin has repeatedly
> offered his help with writing documentation, but I'm flooded by so
> many things, that I was unable to follow up in time. It is good to see
> other people jump in ;-)
>
> > Dr. Muller is willing to help writeup these examples (once he understand
> > them a bit more) so we might be creating a "Beginners Guide to TEI for
> > eXist" based on this work.
>
> This would surely be a very welcome addition since many of our users
> start with TEI. Will it be possible to distribute the demo for other
> users to study?
>
> Wolfgang
>



-- 
Dan McCreary
Semantic Solutions Architect
syntactica.com
952-460-1674
VOIP: 111@69.199.167.229