mirror of https://github.com/tLDP/LDP
Started a complete rewrite
This commit is contained in:
alba
parent
dd18c6a870
commit
bbfcfe5db8
|
|
@ -1,124 +1,77 @@
|
||||||
NOTE: Installation is being reworked, but this is how it works now:
|
2002-08-03
|
||||||
|
|
||||||
Installation from the tarball or .tar.gz, or from CVS, uses standard
|
Installation of lampadas is a bloody mess.
|
||||||
Makefiles. run `make` to build the few things that need to be built,
|
Report all problems, suggestions and flames to
|
||||||
primarily the documentation. Then run `make install` as root to install
|
|
||||||
files.
|
|
||||||
|
|
||||||
Files are installed into the following locations by default. To change
|
alexander.bartolich@gmx.at
|
||||||
them, edit the Makefiles.
|
|
||||||
|
|
||||||
binaries: /usr/local/bin
|
Tested with Red Hat 7.3, Debian 3.0r0 and SuSE 7.3.
|
||||||
man pages: /usr/share/man/man5
|
|
||||||
/usr/share/man/man8
|
|
||||||
Lampadas.pth: /usr/local/lib/site-python
|
|
||||||
python modules: /usr/local/lib/site-python/Lampadas
|
|
||||||
html, png, css: /usr/local/share/lampadas/www
|
|
||||||
SQL scripts: /usr/local/share/lampadas/sql
|
|
||||||
|
|
||||||
If you want to use other directories, edit the Makefiles before
|
=============
|
||||||
running install.
|
Documentation
|
||||||
|
=============
|
||||||
|
|
||||||
|
Directory 'doc' holds some related plain text files.
|
||||||
|
'doc/INSTALL.ancient' are the original notes from David Merill.
|
||||||
|
'doc/INSTALL.mandrake' is the diary of a successful installation
|
||||||
|
on Mandrake 8.2. (FIXME: by whom?)
|
||||||
|
|
||||||
Requirements
|
=============
|
||||||
------------
|
Outline
|
||||||
|
=============
|
||||||
|
|
||||||
Python, of course
|
The process can be summarized like this:
|
||||||
PostgreSQL (I think 6.x is okay, but have not tested it).
|
|
||||||
xsltproc for xml/xslt stylesheet processing
|
|
||||||
wt2db 0.4 or later for WikiText conversions
|
|
||||||
texi2db for Texinfo conversions
|
|
||||||
jade or openjade for LinuxDoc conversions
|
|
||||||
xmllint for SGML to XML conversions and validation
|
|
||||||
docbook-to-man for manpage generation
|
|
||||||
docbook dtds
|
|
||||||
docbook xsl stylesheets from Norm Walsh
|
|
||||||
docbook dsssl stylesheets
|
|
||||||
linuxdoc dtds
|
|
||||||
linuxdoc dsssl stylesheets
|
|
||||||
tar for .tar and .tar.gz archive support
|
|
||||||
gunzip for .gz archive support
|
|
||||||
make for publishing static content
|
|
||||||
lynx for text output support
|
|
||||||
iconv for charset encoding translations
|
|
||||||
scrollkeeper to generate series ids
|
|
||||||
|
|
||||||
|
0. Copy/extract lampadas files
|
||||||
|
|
||||||
Installation Notes on Mandrake 8.2
|
Reading this file means you somehow accomplished this step.
|
||||||
----------------------------------
|
Note that lampadas does not require compilation and copying of
|
||||||
|
resulting files to some destination directory. Move the whole
|
||||||
|
directory to the final location, e.g. /opt/lampadas.
|
||||||
|
|
||||||
Python
|
1. Install postgresql database
|
||||||
Already installed. No changes required
|
|
||||||
PostgreSQL
|
All major distributions provide pre-fabricated packages of
|
||||||
If you have chosen database packages during installation, this is installed.
|
postgresql. You still need to create user accounts and configure
|
||||||
Still have to use chkconfig to start the postgresql server automatically
|
authentication, though.
|
||||||
xsltproc
|
|
||||||
Not installed by default.
|
2. Install Apache with mod_python and python 2.x
|
||||||
It requires
|
|
||||||
libxml2, libxml2-devel, libxslt1, libxslt1-devel packages
|
FIXME
|
||||||
libxml2, libxml2-devle, libxslt1 are installed by default
|
|
||||||
Download libxslt1-devel
|
x. Install a zillion requisites.
|
||||||
wget ftp://speakeasy.rpmfind.net/linux/Mandrake/8.2/i586/Mandrake/RPMS/libxslt1-devel-1.0.12-1mdk.i586.rpm
|
./configure should help in identifying some of them.
|
||||||
Install it
|
|
||||||
rpm -i libxslt1-devel-1.0.12-1mdk.i586.rpm
|
x. Use ./configure to patch some values of your configuration.
|
||||||
Download libxslt-proc
|
Manually edit bin/setenv.sh and conf/lampadas.conf
|
||||||
wget ftp://speakeasy.rpmfind.net/linux/Mandrake/8.2/i586/Mandrake/RPMS/libxslt-proc-1.0.12-1mdk.i586.rpm
|
|
||||||
Install it
|
=============
|
||||||
rpm -i libxslt-proc-1.0.12-1mdk.i586.rpm
|
Postgresql
|
||||||
wt2db, texi2db
|
=============
|
||||||
Check http://www.tldp.org/downloads/ for the current versions.
|
|
||||||
For both the packages unpack, move to the proper directory and
|
Usually there is only one priviledged account (called 'postgres')
|
||||||
Generate Makefile
|
with access to the postmaster. You will need two other local accounts.
|
||||||
perl ./Makefile.PL
|
One for database management, one for the webserver.
|
||||||
Build the package:
|
|
||||||
make
|
To grant another local account access, do this as root (since postgres
|
||||||
Install the files in the appropriate locations:
|
has no set password).
|
||||||
make install
|
|
||||||
jade or openjade for LinuxDoc conversions
|
su - postgres -c 'createuser -A -d alba'
|
||||||
Already installed
|
|
||||||
xmllint for SGML to XML conversions and validation
|
'alba' is my account name on my machines, chose something approriate.
|
||||||
Already installed
|
You won't need root access again for the database.
|
||||||
docbook-to-man for manpage generation
|
Log in with the new account ('alba' in above example) and create a
|
||||||
Get docbook-to-man
|
database instance called 'lampadas':
|
||||||
wget http://www.oasis-open.org/docbook/tools/dtm/docbook-to-man.tar.gz
|
|
||||||
Uncompress it
|
createdb -E UNICODE lampadas
|
||||||
tar zxvf docbook-to-man.tar.gz
|
|
||||||
It doesn't compile by default.
|
Test the result:
|
||||||
Remove lines 708, 807 in file Instant/tptregexp/regexp.c
|
|
||||||
Make and install it
|
psql lampadas
|
||||||
make
|
|
||||||
su
|
=============
|
||||||
make install
|
Apache
|
||||||
Change the dtd and dcl settings in /usr/local/bin/docbook-to-man script
|
=============
|
||||||
as
|
|
||||||
ROOT=/usr
|
Please run the webserver under a separate account like 'apache',
|
||||||
SGMLS=$ROOT/share/sgml
|
not under a shared account like 'nobody'.
|
||||||
DOCBOOK=$SGMLS/docbook/sgml-dtd-3.1
|
|
||||||
..
|
|
||||||
..
|
|
||||||
CATALOG=$DOCBOOK/catalog
|
|
||||||
DECL=$DOCBOOK/docbook.dcl
|
|
||||||
docbook dtds
|
|
||||||
Version 3.1 is installed by default.
|
|
||||||
docbook xsl stylesheets from Norm Walsh
|
|
||||||
Get from docbook sourceforge site.
|
|
||||||
wget http://telia.dl.sourceforge.net/sourceforge/docbook/docbook-xsl-1.51.1.tar.gz
|
|
||||||
Uncompress and move to a proper location like /usr/share/sgml
|
|
||||||
tar zxvf docbook-xsl-1.5.1.1.tar.gz
|
|
||||||
su
|
|
||||||
mv docbook-xsl-1.5.1.1.tar.gz /usr/share/sgml/docbook
|
|
||||||
ln -s /usr/share/sgml/docbook/docbook-xsl-1.5.1.1.tar.gz
|
|
||||||
/usr/share/sgml/docbook/docbook-xsl
|
|
||||||
Change the xsl:import statement in the xsl stylesheets in xsl directory
|
|
||||||
docbook dsssl stylesheets
|
|
||||||
Already installed
|
|
||||||
linuxdoc dtds
|
|
||||||
linuxdoc dsssl stylesheets
|
|
||||||
I am not sure whether this is needed or not. I downloaded the noarch
|
|
||||||
rpm and put it in /usr/share/sgml
|
|
||||||
wget ftp://speakeasy.rpmfind.net/linux/yellowdog/old_releases/champion-1.2/ppc/YellowDog/RPMS/linuxdoc-1.0-1.noarch.rpm
|
|
||||||
tar for .tar and .tar.gz archive support
|
|
||||||
gunzip for .gz archive support
|
|
||||||
make for publishing static content
|
|
||||||
lynx for text output support
|
|
||||||
Already installed
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue