X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~yarrgweb/git?p=ypp-sc-tools.web-live.git;a=blobdiff_plain;f=yarrg%2Fweb%2Fdevel;h=d23e5f2f441abc5d9f492a38d7a6ebc766d1e032;hp=513d50b284411f2516f3a70c0f3c3a7291cd358a;hb=0c82a742fdea92a147690f6bde067f70567c3af1;hpb=4a14caf771c3decbfd13593266872682b091b619 diff --git a/yarrg/web/devel b/yarrg/web/devel index 513d50b..d23e5f2 100755 --- a/yarrg/web/devel +++ b/yarrg/web/devel @@ -33,27 +33,16 @@ -YARRG (Yet Another Revenue Research Gatherer) - - -YARRG - - Yet Another Revenue Research Gatherer -| -development -| -introduction -| -documentation - +<& docshead &>

YARRG development, contribution and troubleshooting

Free Software (aka Open Source) licensing

YARRG is Free Software - you may share and modify it. See the licences for details. Not only the client but also the website code -is Free. The yarrg client, support files, and so forth are under -the GNU GPL (v3 or later); the website is under the GNU Affero GPL (v3 -or later).

+is Free. The yarrg client, support files, and so forth are under the +GNU GPL (v3 or later); the website and database backend is under the +GNU Affero GPL (v3 or later).

@@ -63,40 +52,73 @@ Note that there is NO WARRANTY !

Source code

+git clone git://git.yarrg.chiark.net/ypp-sc-tools.main.git
+clones the master tree through which we push most changes. +

+ git clone http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/.git/
obtains the source code of the latest version released for use as a -client, which you can also find +screenscraper client, which you can also find as an unpacked tree

Live website source code can -be downloaded, in case we have made changes but not yet pushed them +be downloaded: In case we have made changes but not yet pushed them (perhaps because we haven't done a release), and to make it easy for anyone else who runs a copy of the website to provide everyone with the source for their version, the website code itself lets you download an up-to-date of its actually-running source code. So this link gives you the source code for the pages you are now looking at. -

YARRG lookup website instances

All of the above trees are available via the +gitweb +source code and history browser. + +

Uploader

+ +The uploader is also Free Software, but under a slightly different +licence. The uploader page has +complete information on how to get its source code. + +

YARRG website code instances

+ +

Lookup website

Main released site -
Released code; testing database instance (updated with yarrg --test-servers) -
Testing version of the site code -
Testing code running against the testing database instance +
Main released site, + with source code (and + committed changes via git) +
Released code; testing database instance (updated with yarrg --test-servers) (source code as above) +
Testing version of the site code, + with source code (and + committed changes via git) +
Testing code running against the testing database instance (source code as above)

-Each of these allows you to download its own source code so you -can get both the testing and the main version of the website. -

You can add the form parameter ?debug=1 to each of the -above to get a version of the site with debugging output enabled. +website URLs above to get a version of the site with debugging output enabled. + +

Database and dictionary update receiver

+ +On the live system there are different trees, potentially with +different versions, for receiving updates and managing the database, +to the ones for displaying the website. The database management trees +are normally accessed only via the upload client but you may also +download their source directly: + +

Main production instance including uncommitted changes; or + committed changes via git +
Testing database instance including uncommitted changes; or + committed changes via git +

Data

rsync rsync.yarrg.chiark.net::yarrg/
-accesses files published for the benefit of the yarrg upload client, +accesses files published for the benefit of the old yarrg upload client +and other members of the ypp-sc-tools family.

@@ -122,10 +144,10 @@ has the specification of the mechanism and format for uploading to YARRG. If you would like to run a (perhaps modified) copy of the YARRG website it would be very easy for us to make our system send you -copies of updates submitted by users of the official YARRG client, in -the format expected by the YARRG code. Please just ask us - it's just -a matter of us adding your database instance's special email address -to our alias file. +copies of updates submitted by users of the YARRG clients including +JARRG, in the format expected by the YARRG code. Please just +ask us - at our end it's just a matter of us adding your database +instance's special email address to our alias file.

@@ -140,4 +162,6 @@ Email Ian Jackson ijackson (at) chiark.greenend.org.uk. Or talk to any Fleet Officer or above of the crew Special Circumstances on the Midnight Ocean. +

+ <& footer, isdevel => 1 &>