[MapQuery] Directory layout + external libs in Git repo

[Volker Mische]

On 11/12/2010 03:31 PM, Christian Wygoda wrote:
> My personal workspace definitely will use local libs, I'm way to often
> on a train... :) If I have to have a separate directory for such demos,
> I'd be happy with it for now. Altough I'd put it in gitignore. Of
> course, once there will be a downloadable tarball/zip from a nice
> mapQuery website the included demos _must_ work out of the box after the
> download. As for offline maps - maybe we should gather something for a
> nice demo area including Tilesets, GML, KML, etc.? I find too often that
> relying on online services fires back when these services move or are
> offline.

Same here. For the moment (and probably a long time) the major audience
of MapQuery are developers. They will always have the libs locally
(probably their own checkouts). So we should make it as easy as possible
to have demos/tests work with locally installed libs.

> 
> As for resources (css, images) - everything we need to provide ourselves
> - e.g. can't be taken from jQuery UI like a nice wrench icon for a
> configure button - should live inside the src folder. Probably one css
> file (mapquery.css?) with sections for each widget and all images inside
> a src/images folder?
> 
> Offline demo maps could live inside demo/data/...

+1

> 
> How does that sound? 
> 
> On Fri, Nov 12, 2010 at 3:20 PM, Anne Blankert <anne.blankert at geodan.nl
> <mailto:anne.blankert at geodan.nl>> wrote:
> 
>     Hello All,
> 
>     About allowing offline work: then there should also be a data directory
>     for offline maps?
>     My idea was that DEMO's could have an online reference, WORK files not
>     necessarily.
>     In a train it will also be difficult to download the libs for local use.
>     In case you have taken the trouble of downloading the libs before
>     entering the train, you could also consider changing the reference to
>     the offline libs in the demos?
> 
>     Somewhere in the future there should be a mapquery  website that
>     includes the demo's online. Once those are available, there would be no
>     need for downloaded demo's that work out of the box.
> 
>     Another thing:
>     Some of the widgets to be will probably need (default) icons or other
>     images. Where will these be stored?
> 
>     Anne
> 
>     On 11/12/2010 2:26 PM, Volker Mische wrote:
>     > Hi,
>     >
>     > On 11/12/2010 12:29 PM, Anne Blankert wrote:
>     >>  In the newly proposed and improved directory layout, the demo's now
>     >> reference external libs like <script src="../lib/...></script>
>     >> I believe it is a good thing if demo's work out of the box, no
>     >> additional readme's, install.txt or conversions of .sh to .bat,
>     >> downloads etc.
>     >>
>     >> Is there a good reason for the demo's not to reference online
>     libraries?
>     >>
>     >> So instead of:
>     >>   <script src="../lib/openlayers/OpenLayers.js"
>     >> type="text/javascript"></script>
>     >>   <script src="../lib/jquery/jquery-1.4.3.js"
>     >> type="text/javascript"></script>
>     >>   <script src="../lib/jquery/ui/jquery-ui.js"
>     >> type="text/javascript"></script>
>     >>
>     >> Maybe use:
>     >> <script type="text/javascript"
>     >> src="http://openlayers.org/api/2.10/OpenLayers.js"></script>
>     >> <script type="text/javascript"
>     >>
>     src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.3/jquery.min.js"></script>
>     >> <script type="text/javascript"
>     >>
>     src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.6/jquery-ui.min.js"></script>
>     >>
>     >> ?
>     >>
>     >> From the version numbers in the path names to the libs, users can see
>     >> with wich version of the external libs MapQuery is supposed to work.
>     >>
>     >> Anne
>     >>
>     > I'm not sure about it. I know, often demos need an internet connection
>     > (e.g. for a WMS), though I'd like to get them work offline as well. We
>     > could use static files as baselayer (as TMS e.g.) and have them work
>     > completely offline.
>     >
>     > I had the situation that I wanted to do some MapQuery/OpenLayers
>     coding
>     > in the train, an the best resource are the demos. But without internet
>     > they are not that useful.
>     >
>     > Therefore I prefer the bundle version (and not referencing the JS libs
>     > through the web). You only need to download it once and you are set.
>     >
>     > Cheers,
>     >   Volker
> 
> 
>     --
>     Drs. Anne Blankert
>     Geodan Systems & Research
>     President Kennedylaan 1
>     1079 MB Amsterdam (NL)
>     =========================
>     Tel: +31 (0)20 - 5711 311
>     Fax: +31 (0)20 - 5711 333
>     =========================
>     E-mail: anne.blankert at geodan.nl <mailto:anne.blankert at geodan.nl>
>     Website: www.geodan.nl <http://www.geodan.nl>
>     Disclaimer: www.geodan.nl/disclaimer <http://www.geodan.nl/disclaimer>
> 
> 
>     _______________________________________________
>     MapQuery mailing list
>     MapQuery at lists.osgeo.org <mailto:MapQuery at lists.osgeo.org>
>     http://lists.osgeo.org/mailman/listinfo/mapquery
> 
> 
> 
> 
> _______________________________________________
> MapQuery mailing list
> MapQuery at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/mapquery