File: INSTALL

package info (click to toggle)
docbookwiki 0.9.1cvs-8
  • links: PTS
  • area: non-free
  • in suites: lenny
  • size: 17,572 kB
  • ctags: 4,443
  • sloc: xml: 28,920; php: 12,012; perl: 2,274; sh: 1,900; makefile: 81; sql: 10
file content (65 lines) | stat: -rw-r--r-- 2,307 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

* Make sure that you have DocBookWiki and phpWebApp . If you have not
  downloaded any release, you can get them like this:

  bash$ cd /var/www/
  bash$ svn checkout \
        https://svn.sourceforge.net/svnroot/doc-book/books/trunk \
        books
  bash$ cd books/
  bash$ svn checkout \
        https://svn.sourceforge.net/svnroot/phpwebapp/web_app/trunk \
        web_app

* Make sure that the required packages (see README) are installed or
  install them if they are not. In RedHat/Fedora it can be done like
  this:

  bash$ rpm -q package-name
  bash# yum install package-name
  bash# apt-get install package-name

  In Debian it can be done like this:

  bash$ aptitude search package-name
  bash$ aptitude install package-name

* Manual installation of dblatex (which is used for converting to
  formats PDF and LaTeX) can be done like this:

   1. Download and untar it somewhere.
   2. Install it like this:
      bash# cd dblatex/
      bash# python ./setup.py install --prefix=/usr/local \
                             --catalogs=/etc/sgml/catalog

* To compile and install manually swish-e , follow these steps:

   1. Download it from http://swish-e.org/ and untar it somewhere.
   2. Make sure that packages libxml2 and libxml2-devel are installed.
   3. Compile with ./configure and make and make check .
   4. Install with make install . 


* Before starting the installation of DocBookWiki, create a user, e.g.
  dbwiki, that will be the owner of the application and the data:
    bash# useradd dbwiki
    bash# chown -R dbwiki /var/www/books/ 

* Edit 'books.conf' and modify any settings there, 
  such as DATA_OWNER, ADMIN_EMAIL, etc.

* Switch to root and run 'install/sudo_config.sh'.

* Go back to the user 'dbwiki' and run 'install/install.sh' .
  You will be prompted to enter the password of the root user of mysql
  (which is needed for initializing the database of webnotes).

* After installing DocBookWiki, open in browser 'admin.php' and login
  as superuser. There you can add new books in DocBookWiki and organize
  them in a menu. You can also manage the users of the system and
  their permissions. Each book should have at least one admin.

  Tip: The password of the superuser can be changed at any time 
       by the script:
       bash$ install/set_su_passwd.sh