Erinevus lehekülje "DokuWiki kasutamine Debian Lenniga" redaktsioonide vahel

Allikas: Kuutõrvaja
(→‎Tarkvara paigaldamine)
(→‎Dokuwiki tarkvara uuendamine)
 
(ei näidata sama kasutaja 21 vahepealset redaktsiooni)
1. rida: 1. rida:
 
===Sissejuhatus===
 
===Sissejuhatus===
  
−
DokuWiki http://www.splitbrain.org/projects/dokuwiki on populaarne Wiki tarkvara, mida eristab paljude muude Wiki lahenduste seast asjaolu, et ta ei kasuta andmebaasi, st andmeid hoitakse ainult failisüsteemis.
+
DokuWiki http://www.splitbrain.org/projects/dokuwiki on populaarne Wiki tarkvara, mida eristavad paljude muude Wiki lahenduste hulgast sellised asjaolu
 +
 
 +
* DokuWikis on võimalik seada otsekoheselt ja toimivalt sisu erinevatele osadele ligipääsupiiranguid
 +
* DokuWiki ei kasuta andmebaasi, st andmeid hoitakse ainult failisüsteemis
  
 
===Süsteemi ettevalmistamine===
 
===Süsteemi ettevalmistamine===
  
−
TODO
+
DokuWiki kasutamiseks peab süsteemis olema kasutada
 +
 
 +
* Apache veebiserver, koos PHP toega, nt PHP5
 +
 
 +
Veebiserveri virtuaalhosti seadistuseks sobib kasutada nt kuigi see on liiga lubav
 +
 
 +
  <VirtualHost 192.168.1.4:80>
 +
    ServerName loomaaed.tartu.ee
 +
    ServerAdmin admin@loomaaed.tartu.ee
 +
    DocumentRoot /srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG/html
 +
    ErrorLog    /var/log/apache2/loomaaed.tartu.ee-error.log
 +
    LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
 +
    CustomLog /var/log/apache2/loomaaed.tartu.ee-access.log combined
 +
 
 +
  <Directory /srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG/html/wiki>
 +
    php_admin_value open_basedir "/tmp:/srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG"
 +
    php_admin_value error_log "/var/log/apache2/loomaaed.tartu.ee-php-error.log"
 +
    Options -Indexes -MultiViews +FollowSymLinks
 +
    AllowOverRide All
 +
    Order Allow,Deny
 +
    Allow from All
 +
  </Directory>
 +
 
 +
  </VirtualHost>
 +
 
 +
kus
 +
 
 +
* AllowOverRide All tuleks teha tegelikult kitsendavamalt
  
 
===Tarkvara paigaldamine===
 
===Tarkvara paigaldamine===
15. rida: 45. rida:
 
Seejärel tuleb käivitada installer aadressilt
 
Seejärel tuleb käivitada installer aadressilt
  
−
   https://wiki.loomaaed.tartu.ee/wiki/install.php
+
   https://loomaaed.tartu.ee/wiki/install.php
  
 
ning täita lahtrid sobivalt
 
ning täita lahtrid sobivalt
24. rida: 54. rida:
  
 
* wiki ligipääsuks on valitud Closed, st vaikimisi on külastajatel ligipääs wiki sisule keelatud, selleks tuleb wiki kasutajaliidesesse sisse logida
 
* wiki ligipääsuks on valitud Closed, st vaikimisi on külastajatel ligipääs wiki sisule keelatud, selleks tuleb wiki kasutajaliidesesse sisse logida
 +
 +
Peale installeri kasutamist tuleks install.php fail failisüsteemist kustutada
 +
 +
  $ rm wiki/install.php
 +
 +
Failisüsteemi õigused võiks seadistada nii
 +
 +
* kõik keelata veebiserveri kasutajale kirjutamiseks
 +
 +
  # chown -R root:root wiki
 +
 +
* lubada wiki/data kataloogi veebiserveri kasutajal kirjutada
 +
 +
  # chown -R www-data:www-data wiki/data
  
 
===Dokuwiki seadistamine===
 
===Dokuwiki seadistamine===
30. rida: 74. rida:
  
 
   admin -> Configuration Settings
 
   admin -> Configuration Settings
 +
 +
[[Pilt:Dokuwiki-3.gif]]
 +
 +
kus
 +
 +
* vaikimisi kasutatav nn skin on suhteliselt jube (allpool asendatakse see Monobookiga)
 +
* vasakul all on näha, et parasjagu on sisse loginud kasutaja Mart Kask
  
 
Failisüsteemis asuvad olulised määrangud failis
 
Failisüsteemis asuvad olulised määrangud failis
37. rida: 88. rida:
 
====Kaunite URI'de kasutamine====
 
====Kaunite URI'de kasutamine====
  
−
TODO
+
  $ cd wiki
 +
  $ mv .htaccess.dist .htaccess
 +
 
 +
ning .htaccess faili sisuks on
 +
 
 +
  <Files ~ "^[\._]ht">
 +
    Order allow,deny
 +
    Deny from all
 +
    Satisfy All
 +
  </Files>
 +
 
 +
  RewriteEngine on
 +
  RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
 +
  RewriteRule ^_detail/(.*)            lib/exe/detail.php?media=$1  [QSA,L]
 +
  RewriteRule ^_export/([^/]+)/(.*)    doku.php?do=export_$1&id=$2  [QSA,L]
 +
  RewriteRule ^$                        doku.php  [L]
 +
  RewriteCond %{REQUEST_FILENAME}      !-f
 +
  RewriteCond %{REQUEST_FILENAME}      !-d
 +
  RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
 +
  RewriteRule ^index.php$              doku.php
  
 
====Template kasutamine====
 
====Template kasutamine====
48. rida: 118. rida:
  
 
   /srv/www/wiki/lib/tpl
 
   /srv/www/wiki/lib/tpl
 +
 +
* võtta Monobook kasutusele
 +
 +
  Configuration Manager -> DokuWiki Settings -> Template -> Monobook
 +
 +
====Wiki seadistamine https aadressile====
 +
 +
TODO
  
 
====Privileegisüsteem====
 
====Privileegisüsteem====
  
 
TODO
 
TODO
 +
 +
====Failide üleslaadimine====
 +
 +
Failide üleslaadimiseks peab faili nime lõpp olema kirjas failis conf/mime.conf, nt reana
 +
 +
  crt    !application/octet-stream
 +
 +
Üleslaaditud failile viitamiseks sobib kasutada nt järgnevust, tühikud on lisatud loetavuse parandamiseks
 +
 +
  { { : domeen.ee-20100206-20110206.crt } }
  
 
===Dokuwiki kasutamine===
 
===Dokuwiki kasutamine===
 +
 +
Peale Monobook sisselülitamist paistab Wiki kasutamine välja nt selline
 +
 +
[[Pilt:Dokuwiki-4.gif]]
 +
 +
===Dokuwiki tarkvara uuendamine===
 +
 +
Dokuwiki uuendamisel tuleb jälgida juhiseid Dokuwiki veebikohast http://www.dokuwiki.org/install:upgrade, üldiselt toimub selline järgnevus
 +
 +
* veenduda, et on olemas varukoopia
 +
* tutvuda changelogiga
 +
* kopeerida üle vastav osa failisüsteemist uue tarkvara versiooni tar.gz arhiivi sisuga
 +
* uuendada templated/pluginad
 +
 +
===Eesti ID-kaardiga autentimine===
  
 
TODO
 
TODO

Viimane redaktsioon: 29. august 2010, kell 22:32

Sissejuhatus

DokuWiki http://www.splitbrain.org/projects/dokuwiki on populaarne Wiki tarkvara, mida eristavad paljude muude Wiki lahenduste hulgast sellised asjaolu

  • DokuWikis on võimalik seada otsekoheselt ja toimivalt sisu erinevatele osadele ligipääsupiiranguid
  • DokuWiki ei kasuta andmebaasi, st andmeid hoitakse ainult failisüsteemis

Süsteemi ettevalmistamine

DokuWiki kasutamiseks peab süsteemis olema kasutada

  • Apache veebiserver, koos PHP toega, nt PHP5

Veebiserveri virtuaalhosti seadistuseks sobib kasutada nt kuigi see on liiga lubav 

 <VirtualHost 192.168.1.4:80>
   ServerName loomaaed.tartu.ee
   ServerAdmin admin@loomaaed.tartu.ee
   DocumentRoot /srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG/html
   ErrorLog     /var/log/apache2/loomaaed.tartu.ee-error.log
   LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
   CustomLog /var/log/apache2/loomaaed.tartu.ee-access.log combined
 
 <Directory /srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG/html/wiki>
   php_admin_value open_basedir "/tmp:/srv/loomaaed.tartu.ee/loomaaed_4YurBg6tG"
   php_admin_value error_log "/var/log/apache2/loomaaed.tartu.ee-php-error.log"
   Options -Indexes -MultiViews +FollowSymLinks
   AllowOverRide All
   Order Allow,Deny
   Allow from All
 </Directory>
 
 </VirtualHost>

kus

  • AllowOverRide All tuleks teha tegelikult kitsendavamalt

Tarkvara paigaldamine

Kopeerida viimane Dokuwiki stabiilne versioon, nt 

 $ wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-02-14b.tgz

Seejärel tuleb käivitada installer aadressilt 

 https://loomaaed.tartu.ee/wiki/install.php

ning täita lahtrid sobivalt

Dokuwiki-1.gif

kus

  • wiki ligipääsuks on valitud Closed, st vaikimisi on külastajatel ligipääs wiki sisule keelatud, selleks tuleb wiki kasutajaliidesesse sisse logida

Peale installeri kasutamist tuleks install.php fail failisüsteemist kustutada 

 $ rm wiki/install.php

Failisüsteemi õigused võiks seadistada nii

  • kõik keelata veebiserveri kasutajale kirjutamiseks
 # chown -R root:root wiki
  • lubada wiki/data kataloogi veebiserveri kasutajal kirjutada
 # chown -R www-data:www-data wiki/data

Dokuwiki seadistamine

Veebipõhise kasutajaliidese kaudu Dokuwiki seadistamine toimub peale privilegeeritud kasutajana sisselogimist valides 

 admin -> Configuration Settings

Dokuwiki-3.gif

kus

  • vaikimisi kasutatav nn skin on suhteliselt jube (allpool asendatakse see Monobookiga)
  • vasakul all on näha, et parasjagu on sisse loginud kasutaja Mart Kask

Failisüsteemis asuvad olulised määrangud failis 

 conf/dokuwiki.php

Kaunite URI'de kasutamine

 $ cd wiki
 $ mv .htaccess.dist .htaccess

ning .htaccess faili sisuks on 

 <Files ~ "^[\._]ht">
   Order allow,deny
   Deny from all
   Satisfy All
 </Files>

 RewriteEngine on
 RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
 RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
 RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
 RewriteRule ^$                        doku.php  [L]
 RewriteCond %{REQUEST_FILENAME}       !-f
 RewriteCond %{REQUEST_FILENAME}       !-d
 RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
 RewriteRule ^index.php$               doku.php

Template kasutamine

  • Kopeerida meelepärane template aadressilt
 http://www.dokuwiki.org/template
  • Pakkida template lahti kataloogi, nii et tekib template nimeline alamkataloog tpl kataloogi alla
 /srv/www/wiki/lib/tpl
  • võtta Monobook kasutusele
 Configuration Manager -> DokuWiki Settings -> Template -> Monobook

Wiki seadistamine https aadressile

TODO

Privileegisüsteem

TODO

Failide üleslaadimine

Failide üleslaadimiseks peab faili nime lõpp olema kirjas failis conf/mime.conf, nt reana 

 crt     !application/octet-stream

Üleslaaditud failile viitamiseks sobib kasutada nt järgnevust, tühikud on lisatud loetavuse parandamiseks 

 { { : domeen.ee-20100206-20110206.crt } }

Dokuwiki kasutamine

Peale Monobook sisselülitamist paistab Wiki kasutamine välja nt selline

Dokuwiki-4.gif

Dokuwiki tarkvara uuendamine

Dokuwiki uuendamisel tuleb jälgida juhiseid Dokuwiki veebikohast http://www.dokuwiki.org/install:upgrade, üldiselt toimub selline järgnevus

  • veenduda, et on olemas varukoopia
  • tutvuda changelogiga
  • kopeerida üle vastav osa failisüsteemist uue tarkvara versiooni tar.gz arhiivi sisuga
  • uuendada templated/pluginad

Eesti ID-kaardiga autentimine

TODO

Kasulikud lisamaterjalid

Pärit leheküljelt "https://kuutorvaja.eenet.ee/w/index.php?title=DokuWiki_kasutamine_Debian_Lenniga&oldid=21777"