* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml
@ 2010-04-28 19:17 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 5+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-04-28 19:17 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/04/28 19:17:52
Added: gorg.xml
Log:
Added gorg guide to our stuff, after finding the raw unformatted text in the cached interwebs. neysx's site is down, and this stuff is too valuable to lose. i rewrote the guideXML and cleaned it up where necessary. inspired by bug 317609.
Revision Changes Path
1.1 xml/htdocs/proj/en/gdp/doc/gorg.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.1&content-type=text/plain
Index: gorg.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header $ -->
<guide>
<title>How to Install Gorg</title>
<author title="Author">
<mail link="neysx"/>
</author>
<author title="Editor">
<mail link="nightmorph"/>
</author>
<abstract>
This guide describes how to install and configure gorg.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1</version>
<date>2010-04-28</date>
<chapter>
<title>Introduction</title>
<section>
<body>
<p>
Gorg is a back-end XSLT processor for an XML-based web site. XML source files
are transformed and served on-the-fly. Output files and their dependencies are
cached. Its main features are:
</p>
<ul>
<li>Works with apache, lighttpd or webrick (ruby's own web server) </li>
<li>Uses efficient caching</li>
<li>
Generates consistent HTTP headers when several web nodes serve the same
content
</li>
<li>
Implements its own compression (aka mod_gzip), i.e. it does not rely on the
web server to compress its output
</li>
<li>Supports client-side caching</li>
<li>Your XSL can accept and write cookies</li>
<li>
Provides its own search engine (site indexing will be substantially updated
in a later version)
</li>
</ul>
<p>
Gorg allows you to serve your own local copy of
<uri>http://www.gentoo.org</uri>. It can use either a cgi or a fastcgi script
with apache or lighttpd, or even use its own stand-alone web server. Its name is
short for <b>G</b>entoo.<b>org</b> because it was created with Gentoo's site in
mind when it was felt that a replacement for AxKit was required.
</p>
<p>
Gorg has been tested on x86, amd64, alpha, sparc, ppc, mips & hppa with the
following packages:
</p>
<pre caption="Test environment">
>=net-www/apache-2.0.55
>=www-apache/mod_fcgid-1.0.8
>=dev-lang/ruby-1.8.4
>=dev-libs/fcgi-2.4.0
>=dev-ruby/ruby-fcgi-0.8.6
>=dev-libs/libxml2-2.6.23
>=dev-libs/libxslt-1.1.15
<comment>(In the unlikely case you want to fiddle with gorg's own search engine)</comment>
>=dev-db/mysql-4.0.26 <comment>(up to and including 5.*)</comment>
>=dev-ruby/ruby-dbi-0.0.21
>=dev-ruby/mysql-ruby
</pre>
</body>
</section>
</chapter>
<chapter>
<title>Installing Gorg</title>
<section>
<body>
<p>
Define your USE flags to allow apache with or without mod_fcgi, or not depending
on how you want to use it. The <c>mysql</c> USE flag is only required for the
integrated search engine.
</p>
<impo>
You might have to keyword some dependencies for your architecture. You can
keyword the required packages or accept a foreign architecture. gorg has been
installed and tested on x86, amd64, alpha, sparc, ppc, mips & hppa.
</impo>
<pre caption="Emerging gorg">
<comment>(<b>With</b> apache support)</comment>
# <i>echo www-servers/gorg fastcgi apache -mysql >> /etc/portage/package.use</i>
<comment>(<b>Without</b> apache support)</comment>
# <i>echo www-servers/gorg -fastcgi -apache -mysql >> /etc/portage/package.use</i>
<comment>(Check dependencies are available for your architecture)</comment>
# <i>emerge -pv gorg</i>
<comment>(Install gorg)</comment>
# <i>emerge gorg</i>
</pre>
</body>
</section>
</chapter>
<chapter>
<title>Configuring Gorg</title>
<section>
<title>Configuring apache</title>
<body>
<note>
You may skip this section if you are not going to use apache at all.
</note>
<p>
If you want to use fastcgi, which you should anyway, you'll need to add <c>-D
FCGID</c> to the <c>APACHE2_OPTS</c> variable in
<path>/etc/conf.d/apache2</path>.
</p>
<p>
Then, integrate the apache configuration directives from the provided sample
file <path>/etc/gorg/vhost.sample</path> into your own vhost configs, e.g.:
<path>/etc/apache2/vhosts.d/10_gorg.conf</path>. Comments in the sample config
file will guide you.
</p>
<p>
Finally, copy or symlink the (c)cgi scripts from
<path>/usr/lib/ruby/site_ruby/<ruby-version>/gorg/fcgi-bin/gorg.fcgi</path>
and
<path>/usr/lib/ruby/site_ruby/<ruby-version>/gorg/cgi-bin/{gorg,search}.cgi</path>
into your web site (f)cgi directories and check they are executable. You
should copy <path>search.cgi</path> only if you are going to use the integrated
search engine.
</p>
</body>
</section>
<section>
<title>Configuring gorg</title>
<body>
<p>
Create a copy of the sample config file <path>/etc/gorg/gorg.conf.sample</path>
named <path>/etc/gorg/gorg.conf</path> and <b>edit</b> it. Comments will help
you define your own parameters. You need to define at least your web document
root directory.
</p>
<p>
If you do not want to use the default <path>/etc/gorg/gorg.conf</path> config
file, you'll need to define an environment variable called <c>GORG_CONF</c> that
points to the config file.
</p>
<impo>
If you use caching, and it is recommended that you do so, do make sure that the
cache directory defined in your config file has proper permissions. If you use
apache, the apache user needs full access to that directory.
</impo>
</body>
</section>
<section>
<title>Getting the missing files</title>
<body>
<p>
Assuming you'll serve your local copy of CVS, or a copy if, or symlinks to it,
you need to download some files from the <path>dyn</path> directory.
</p>
<pre caption="Get the missing files">
<comment>(Go to your htdocs directory)</comment>
$ <i>cd /path/to/your/document/root</i>
/htdocs $ <i>cd dyn</i>
/htdocs $ <i>wget -O news-index.xml http://www.gentoo.org/dyn/news-index.xml?passthru=1</i>
/htdocs $ <i>cd ..</i>
<comment>(Do the same for any other data you may need from the /dyn directory)</comment>
</pre>
<p>
You also need to make the pictures available to your browser. The
<path>images</path> directory is one level above <path>htdocs</path>. Just
define a symlink to it and you're set.
</p>
<pre caption="Make a symlink to the pictures">
/htdocs $ <i>ln -si ../images images</i>
<comment>(It should look like this:)</comment>
/htdocs $ <i>ls -l</i>
drwxr-xr-x 3 neysx users 128 Sep 14 17:45 css
drwxr-xr-x 31 neysx users 744 Oct 26 00:03 doc
drwxr-xr-x 3 neysx users 544 Nov 2 16:53 dtd
drwxr-xr-x 3 neysx users 168 Nov 3 16:24 dyn
-rw-r--r-- 1 neysx users 1406 Jun 7 2003 favicon.ico
lrwxrwxrwx 1 neysx users 10 Oct 21 22:29 images -> ../images/
-rw-r--r-- 1 neysx users 190 Nov 9 2002 index.xml
drwxr-xr-x 16 neysx users 384 Apr 1 2004 main
drwxr-xr-x 17 neysx users 6960 Nov 3 15:34 news
drwxr-xr-x 8 neysx users 192 Oct 23 14:52 proj
drwxr-xr-x 4 neysx users 96 Sep 17 14:05 security
drwxr-xr-x 3 neysx users 736 Nov 2 16:40 xsl
</pre>
<p>
Your local CVS probably shows a few more entries, but at least those mentioned
above should be available and kept up-to-date. Also remember to keep your
<path>images</path> directory current.
</p>
</body>
</section>
</chapter>
<chapter>
<title>Running Gorg</title>
<section>
<title>The stand-alone web server</title>
<body>
<p>
The easiest way to try it out is to run <c>gorg</c>. It should display something
like:
</p>
<pre caption="Run gorg">
$ <i>gorg</i>
Starting the Gorg web server on port 8008
Hit Ctrl-C or type "kill 31479" to stop it
</pre>
<p>
Point your browser to <uri>http://localhost:8008</uri> and you should see your
favorite site.
</p>
</body>
</section>
<section>
<title>With apache</title>
<body>
<p>
Restart apache (<c>/etc/init.d/apache2 restart</c>) and visit
<uri>http://localhost</uri> assuming you're installing on your own
workstation.
</p>
<p>
If you used static fastcgi servers, you should see them with <c>top -u
apache</c>.
</p>
<p>
If it doesn't work, try the stand-alone web server (type <c>gorg</c>). If this
doesn't work either, check your <path>/etc/gorg/gorg.conf</path> config file. If
it does work, please check your apache config files and your logs.
</p>
</body>
</section>
</chapter>
</guide>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml
@ 2010-11-08 22:47 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 5+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-11-08 22:47 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/11/08 22:47:11
Modified: gorg.xml
Log:
missed a colon
Revision Changes Path
1.2 xml/htdocs/proj/en/gdp/doc/gorg.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?r1=1.1&r2=1.2
Index: gorg.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- gorg.xml 28 Apr 2010 19:17:52 -0000 1.1
+++ gorg.xml 8 Nov 2010 22:47:11 -0000 1.2
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.2 2010/11/08 22:47:11 nightmorph Exp $ -->
<guide>
<title>How to Install Gorg</title>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml
@ 2012-05-07 20:40 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 5+ messages in thread
From: Joshua Saddler (nightmorph) @ 2012-05-07 20:40 UTC (permalink / raw
To: gentoo-commits
nightmorph 12/05/07 20:40:40
Modified: gorg.xml
Log:
fixed use flags
Revision Changes Path
1.3 xml/htdocs/proj/en/gdp/doc/gorg.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?r1=1.2&r2=1.3
Index: gorg.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- gorg.xml 8 Nov 2010 22:47:11 -0000 1.2
+++ gorg.xml 7 May 2012 20:40:40 -0000 1.3
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.2 2010/11/08 22:47:11 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.3 2012/05/07 20:40:40 nightmorph Exp $ -->
<guide>
<title>How to Install Gorg</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1</version>
-<date>2010-04-28</date>
+<version>2</version>
+<date>2012-05-07</date>
<chapter>
<title>Introduction</title>
@@ -103,12 +103,6 @@
</impo>
<pre caption="Emerging gorg">
-<comment>(<b>With</b> apache support)</comment>
-# <i>echo www-servers/gorg fastcgi apache -mysql >> /etc/portage/package.use</i>
-
-<comment>(<b>Without</b> apache support)</comment>
-# <i>echo www-servers/gorg -fastcgi -apache -mysql >> /etc/portage/package.use</i>
-
<comment>(Check dependencies are available for your architecture)</comment>
# <i>emerge -pv gorg</i>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml
@ 2014-08-18 8:48 Hans de Graaff (graaff)
0 siblings, 0 replies; 5+ messages in thread
From: Hans de Graaff (graaff) @ 2014-08-18 8:48 UTC (permalink / raw
To: gentoo-commits
graaff 14/08/18 08:48:04
Modified: gorg.xml
Log:
Add a deprecation notice to the gorg homepage.
Revision Changes Path
1.4 xml/htdocs/proj/en/gdp/doc/gorg.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?r1=1.3&r2=1.4
Index: gorg.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- gorg.xml 7 May 2012 20:40:40 -0000 1.3
+++ gorg.xml 18 Aug 2014 08:48:04 -0000 1.4
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.3 2012/05/07 20:40:40 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.4 2014/08/18 08:48:04 graaff Exp $ -->
<guide>
<title>How to Install Gorg</title>
@@ -28,6 +28,12 @@
<section>
<body>
+<impo>
+ Gorg is no longer maintained and its use on gentoo.org websites is
+ being phased out. Once gorg is no longer used on gentoo.org the
+ package will be masked and removed.
+</impo>
+
<p>
Gorg is a back-end XSLT processor for an XML-based web site. XML source files
are transformed and served on-the-fly. Output files and their dependencies are
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml
@ 2014-08-18 8:54 Hans de Graaff (graaff)
0 siblings, 0 replies; 5+ messages in thread
From: Hans de Graaff (graaff) @ 2014-08-18 8:54 UTC (permalink / raw
To: gentoo-commits
graaff 14/08/18 08:54:48
Modified: gorg.xml
Log:
Update version and edit date for previous change.
Revision Changes Path
1.5 xml/htdocs/proj/en/gdp/doc/gorg.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.5&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?rev=1.5&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml?r1=1.4&r2=1.5
Index: gorg.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- gorg.xml 18 Aug 2014 08:48:04 -0000 1.4
+++ gorg.xml 18 Aug 2014 08:54:48 -0000 1.5
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.4 2014/08/18 08:48:04 graaff Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/gorg.xml,v 1.5 2014/08/18 08:54:48 graaff Exp $ -->
<guide>
<title>How to Install Gorg</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2</version>
-<date>2012-05-07</date>
+<version>3</version>
+<date>2014-08-18</date>
<chapter>
<title>Introduction</title>
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2014-08-18 8:55 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-08-18 8:54 [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gdp/doc: gorg.xml Hans de Graaff (graaff)
-- strict thread matches above, loose matches on Subject: below --
2014-08-18 8:48 Hans de Graaff (graaff)
2012-05-07 20:40 Joshua Saddler (nightmorph)
2010-11-08 22:47 Joshua Saddler (nightmorph)
2010-04-28 19:17 Joshua Saddler (nightmorph)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox