• Razne teme vezane uz prilagodbu web sučelja

Prilagodba OPAC-a

• KohaCon 2009: Customizing Your OPAC

• Adding a custom header to Koha 3’s OPAC

Prevođenje i instalacija .po datoteka

Instalacija .po datoteke prikazana je na:
Prijevodi - FFZG

Prilagođavanje prikaza na web sučelju počinje s uređivanjem engleske verzije predloška. Npr. uređivanje prikaza detalja određenog zapisa:

# vim $KOHA_SRC/koha-tmpl/opac-tmpl/prog/en/modules/opac-detail.tmpl

Tada ažurirate .po datoteku:

# cd $KOHA_SRC/misc-translator
# ./tmpl_process3.pl update -r -i ../../koha-tmpl/opac-tmpl/prog/en/ -s po/hr-HR-i-opac-t-prog-v--3000000.po

.. i instalirate samo hr template:

# ./tmpl_process3.pl install -r -i /home/koha/src/koha-git-dev/koha-tmpl/opac-tmpl/prog/en/ -o /usr/share/koha/opac/htdocs/opac-tmpl/prog/hr-HR/ -s po/hr-HR-i-opac-t-prog-v--3000000.po

Engleski dio iz $KOHA_SRC/koha-tmpl/opac-tmpl/prog/en/* se može samo iskopirati.

(alen): Ispravite me ako nešto krivo radim ;)

• Koha 3.4
• Koha za Permakulturni institut http://www.zmag.hr/

• dolaze kolege s Instituta za društvena istraživanja
• http://map.knjiznica.ffzg.hr/ opis na http://blog.rot13.org/2011/04/google-map-data-layer-using-custom-tiles.html

Ova stranica će pokušati dokumentirati instalaciju kohe na najjednostavniji mogući način. Primjeri za korištenje su:

• demo instanca
• development instanca
• recovery iz backup-a ili testiranje sa zadnjom verzijom kohe iz git-a (potreban je samo dump baze)

Cijela virtualna mašina dostupna je kao ~325 Mb download: http://mjesec.ffzg.hr/~dpavlin/koha/koha-lxc-20091207.tar.bz2

Oprez: ova virtualna mašina nema root password a svi ostali passwordi su dokumentirani na ovoj stranici, tako da je mudro promjeniti ih ako je želite koristiti!!

Virtualna mašina

Instalacija u LXC (Linux containers) ali bilo koja instalacija bi trebala biti jednako dobra.

root@t61p:~# lxc-debian create
What is the name for the container ? [debian] koha-lxc
What hostname do you wish for this container ? [koha-lxc] 
What IP address do you wish for this container ? [172.20.0.21] 192.168.3.3
What is the gateway IP address ? [172.20.0.1] 192.168.3.1
What is the MTU size ? [1500] 
Specify the location of the rootfs [./rootfs.koha-lxc] /virtual/koha-lxc
Specify the location for an extra fstab file [(none)] 
Choose your architecture
1) amd64
2) i386
#? 2
Architecture i386 selected
Checking cache download ...Found.
Copying rootfs ...

...

Za locale bi bilo zgodno instalirati:

• en_US.UTF-8 UTF-8
• hr_HR.UTF-8 UTF-8

Default locale for the system environment: None

root@t61p:~# lxc-start --name koha-lxc

Naša virtualna mašina se zove koha-lxc i da bi Koha testovi prošli mora biti moguće resolvati to DNS ime. Provjerite da /etc/hosts ima zapis:

koha-lxc:/srv/koha# grep koha-lxc /etc/hosts
192.168.3.3     koha-lxc

Dodatni paketi

koha-lxc:~# apt-get install vim less openssh-server git-core dselect

Zebra

koha-lxc:/srv/koha# cat > /etc/apt/sources.list.d/indexdata.list
deb http://ftp.indexdata.dk/debian lenny main
deb-src http://ftp.indexdata.dk/debian lenny main

GIT

koha-lxc:~# cd /srv/
koha-lxc:/srv# git clone git://git.koha.org/pub/scm/koha.git
Initialized empty Git repository in /srv/koha/.git/
...

Ostatak instalacije manje-više slijedi upute od Kohe: INSTALL.debian-lenny

Lokalni branch

Napraviti lokalni branch za ovu intalaciju:

koha-lxc:/srv/koha# git checkout -b koha-lxc origin
Branch koha-lxc set up to track remote branch refs/remotes/origin/master.
Switched to a new branch "koha-lxc"

Push lokalnih promjena na drugi git server

Opcionalno dodajte svoj public git repozitorij u koji će se spremati promjene:

koha-lxc:/srv/koha# git remote add koha-dev dpavlin@koha-dev.rot13.org:/srv/koha/

Prvi push mora imati --all parametar da prebaci i novo ime branch-a a ne samo promjene:

koha-lxc:/srv/koha# git push koha-dev --all
dpavlin@koha-dev.rot13.org's password: 
Counting objects: 5, done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 339 bytes, done.
Total 3 (delta 2), reused 0 (delta 0)
To dpavlin@koha-dev.rot13.org:/srv/koha/
 * [new branch]      koha-lxc -> koha-lxc

Debian paketi

dpkg --set-selections < install_misc/debian-lenny.packages
dselect
# Install, Quit

MySQL

U jednom trenutku instalacija će pitati:

New password for the MySQL "root" user:

npr. mysqlroot

Kreirati bazu

koha-lxc:~# mysqladmin -uroot -pmysqlroot create koha

Kreirati korisnika

koha-lxc:~# mysql -uroot -pmysqlroot

mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'katikoan' ;
Query OK, 0 rows affected (0.00 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)

mysql> quit

Provjerite da se možete povezati sa kohaadmin korisnikom:

koha-lxc:/srv/koha# mysql -h localhost -ukohaadmin -pkatikoan koha

korisnik i grupa

koha-lxc:/srv/koha# addgroup koha
Adding group `koha' (GID 1000) ...
Done.

koha-lxc:/srv/koha# adduser --no-create-home --disabled-login --ingroup koha  --gecos Koha koha
Adding user `koha' ...
Adding new user `koha' (1000) with group `koha' ...
Not creating home directory `/home/koha'.

perl

Debian paketi

koha-lxc:~# apt-get install libgd-gd2-perl libgd-barcode-perl libnumber-format-perl libcache-memcached-perl libparams-util-perl libmodule-install-perl

CPAN

koha-lxc:~# cpan Algorithm::CheckDigits HTTP::OAI IPC::Cmd IPC::Cmd Memoize::Memcached PDF::API2::Simple PDF::Reuse::Barcode PDF::Table SMS::Send Storable Test::More Authen::CAS::Client

Authen::CAS::Client

Trenutna development koha ima bug zbog kojeg je CAS autorizacija po defaultu uključena, pa zahtijeva još nekoliko dodatnih modula

koha-lxc:~# apt-get install libtest-mockobject-perl

koha-lxc:~# cpan Authen::CAS::Client

SAX parser

koha-lxc:/srv/koha# apt-get remove libxml-sax-expat-perl

koha-lxc:/srv/koha# misc/sax_parser_print.pl
Koha wants something like:
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
You have:
    XML::LibXML::SAX::Parser=HASH(0x9858cc0)
Looks good.

Koha install

koha-lxc:/srv/koha# perl Makefile.PL

...

koha-lxc:/srv/koha# make test

...

koha-lxc:/srv/koha# make install
/usr/bin/perl "-Iblib/arch" "-Iblib/lib" fix-perl-path.PL blib

Koha's files have now been installed.

In order to use Koha's command-line batch jobs,
you should set the following environment variables:

export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib

Apache

ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha

Enable port 8080 for Koha intranet

koha-lxc:/srv/koha# echo 'Listen 8080' > /etc/apache2/conf.d/port-8080.conf

And finish Apache configuration:

koha-lxc:/srv/koha# a2enmod rewrite

koha-lxc:/srv/koha# a2ensite koha

koha-lxc:/srv/koha# /etc/init.d/apache2 restart

Zebra

koha-lxc:/srv/koha# ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon

koha-lxc:/srv/koha# update-rc.d koha-zebra-daemon defaults

koha-lxc:/srv/koha# /etc/init.d/koha-zebra-daemon start

Finish Koha instalation

http://192.168.3.3:8080/

• login: kohaadmin
• password: katikoan

from /etc/koha/koha.conf.xml

koha-lxc:/srv/koha# egrep '(user|pass)' /etc/koha/koha-conf.xml | tail -2
 <user>kohaadmin</user>
 <pass>katikoan</pass>

Prebacivanje postojece instalacije na cisti Squeeze i upgrade na 3.2.x

Konacno sam uhvatio vremena testirati upgrade 3.1 na 3.2.x iz Git-a (na IRB-u)

1. prebacio sam cijelu bazu i aplikaciju na virtualni server na kojem je Debian Squeeze

2. Instalirao sam sve potrebno i upogonio tu "staru" verziju KOHA-e na novom serveru
  - Squeeze sad ima gotovo sve Perl module u dostupne u paketima
  - putem CPAN-a sam instalirao samo NET::Z3950::ZOOM jer Debian paket ima neke konflikte u dependency-ima

3. gotovo sve je proradilo iz druge - bilo je naravno nekih tipfelera u apache konfiguraciji :)

4. tada sam povukao promjene iz gita, napravio rebase i mergao to u svoj branch

5. nakon toga sam napravio postupak upgrade-a kako je opisano u INSTALL.debian

6. vecina stvari je proradila ok, potrebno je u administraciji pokrenuti upgrade baze

7. LDAP nije proradio.. imam neki cudan problem i morao sam mijenjati lib/C4/Auth_with_ldap.pl

120c121
< my $res = $db->bind( $principal_name, password => $password );
---

my $res = $db->bind( "uid=$principal_name,dc=irb,dc=hr", password => $password );

  - i u koha-conf.xml sam kod ldap konfigracije morao staviti:
    <update>0</update>

Sad to radi, buduci da nije danas bilo promjena u bazi, zaswitchat cu samo IP adrese servera, promijeniti hostname i valjda ce biti ok :)

contributed by alen.vodopijevec on Jan 6 6:22am

• KohaCon 2010 videos: http://anitsirk.blip.tv/posts?view=archive

Teme za danas:

• Z39.50 screen scraping http://github.com/dpavlin/Biblio-Z3950
• popis dostupnih Z39.50 servera: http://irspy.indexdata.com/
• KohaCon 10 http://www.kohacon10.org.nz/
• <angular/> http://angularjs.org

Git sustav za praćenje promjena koji koristi Koha.

Mnogo bolje i potpunije upute: http://wiki.koha-community.org/wiki/Version_Control_Using_Git

DON'T PANIC!

podaci o korisniku

Da bi vaši commiti imali lijepo ime korisnika, morate prvo konfigurirati git

$ git config --global user.name "Dobrica Pavlinusic"
$ git config --global user.email "dpavlin@rot13.org"

Ovo je potrebno napraviti samo jednom za korisnika i primjenjuje se na svim repozitorijima na istoj mašini.

repozitoriji

Repozitoriji su jednostavno serveri koji nam omogućavaju da na njih šaljemo (push) ili sa njih vučemo (pull) promjene koje su u njima napravljene.

Kako je svaki checkout git-a potpuni repozitorij, svaki od njih može postati javni repozitorij koji može dijeliti promjene.

Upstream Koha development

• http://git.koha.org/
• git://git.koha.org/pub/scm/koha.git

Checkout (lokalna kopija)

git clone git://git.koha.org/pub/scm/koha.git

FFZG promjene

• http://git.rot13.org/?p=koha.git;a=summary
• git://git.rot13.org/koha.git
• ssh://git.rot13.org/git/koha/

promjene iz drugog repozitorija

Ako želimo povući promjene iz drugog repozitorija (npr. druge instalacije unutar KOHA CUG-a) trebamo dodati novi remote repozitorij.

Na repozitoriju koji je napravljen od upstream Koha repozitorija, imamo jedan remote repozitorij origin za push i pull:

dpavlin@t61p:/srv/koha$ git remote -v
origin  git://git.koha.org/pub/scm/koha.git (fetch)
origin  git://git.koha.org/pub/scm/koha.git (push)

Sada ćemo dodati repozitorij sa FFZG development-a koristeći običnu ssh konekciju:

dpavlin@t61p:/srv/koha$ git remote add ffzg ssh://koha-dev.rot13.org/srv/koha/
dpavlin@t61p:/srv/koha$ git remote -v
ffzg    ssh://koha-dev.rot13.org/srv/koha/ (fetch)
ffzg    ssh://koha-dev.rot13.org/srv/koha/ (push)
origin  git://git.koha.org/pub/scm/koha.git (fetch)
origin  git://git.koha.org/pub/scm/koha.git (push)

i povući sve promjene lokalno:

dpavlin@t61p:/srv/koha$ git fetch ffzg
remote: Counting objects: 2019, done.
remote: Compressing objects: 100% (1440/1440), done.
remote: Total 1790 (delta 1116), reused 587 (delta 317)
Receiving objects: 100% (1790/1790), 1.40 MiB | 1.12 MiB/s, done.
Resolving deltas: 100% (1116/1116), completed with 67 local objects.
From ssh://koha-dev.rot13.org/srv/koha
 * [new branch]      ffzg       -> ffzg/ffzg
 * [new branch]      ffzg2      -> ffzg/ffzg2
 * [new branch]      koha-lxc   -> ffzg/koha-lxc
 * [new branch]      master     -> ffzg/master
 * [new branch]      origin     -> ffzg/origin
 * [new branch]      rt-390-signatura-zatvorenog-spremista -> ffzg/rt-390-signatura-zatvorenog-spremista
From ssh://koha-dev.rot13.org/srv/koha
 * [new tag]         ffzg       -> ffzg

branches

Branches su mjesta na kojima se povjest promjena grana u dva dijela. Jedan je development koji rade upstream developeri Kohe, a drugi su naše lokalne promjene za nešto.

Nakon nekog vremena, potrebno je dva branch-a spojiti u jedan da bi preuzeli promjene. gitk nam može pokazati to kao stablo:

Promjene se mogu preuzeti (merge) iz jednog branch-a u drugi.

imenovanje

Branches nisu ništa drugo nego ime za svaku točku i kojoj se razvoj dijeli u dva toka.

Dobri nazivi za branch:

• DNS hostname produkcijske ili develpment mašine na kojoj je branch checkoutan
• veza na bug tracking (prefix-broj-kratak-opis)

pregled

dpavlin@t61p:/srv/koha$ git branch -a
* master
  remotes/ffzg/ffzg
  remotes/ffzg/ffzg2
  remotes/ffzg/koha-lxc
  remotes/ffzg/master
  remotes/ffzg/origin
  remotes/ffzg/rt-390-signatura-zatvorenog-spremista
  remotes/origin/3.0.x
  remotes/origin/HEAD -> origin/master
  remotes/origin/biblibre-acq-preview-only
  remotes/origin/biblibre-integration
  remotes/origin/biblibre-sopac
  remotes/origin/labels_recon
  remotes/origin/master
  remotes/origin/rfid-direct-tagging
  remotes/origin/sysprefs_editor

kreiranje

Pretpostavimo da želimo kreirati branch za instalaciju na koha.ffzg.hr:

dpavlin@t61p:/srv/koha$ git checkout -b koha.ffzg.hr remotes/ffzg/ffzg2
Branch koha.ffzg.hr set up to track remote branch ffzg2 from ffzg.
Switched to a new branch 'koha.ffzg.hr'

patches

format-patch

git format-patch

Naš cilj je napraviti patcheve od promjena koje smo napravili u našem branch-u:

Iz slike vidimo da smo napravili sip-debug branch iz postojećeg 3.0.x

koha-lxc:/srv/koha# git format-patch -o sip2-changes 3.0.x
sip2-changes/0001-disable-PreFork-to-enable-easy-debugging.patch
sip2-changes/0002-remove-eval-so-it-won-t-hide-errors.patch
sip2-changes/0003-warn-about-missing-institutions-entry-in-config-xm.patch

Ovo će napraviti onoliko patcheva koliko imamo commita na našem branch-u koji smo napravili od 3.0.x

am (apply mail patch)

Prvo ćemo napraviti novi branch u našem repozitoriju sip2-debug u koji ćemo importati naše patcheve:

koha-lxc:/srv/koha# git checkout -b sip2-debug master
Switched to a new branch "sip2-debug"

Nakon toga možemo applyati samo one promjene koje su nam interesantne:

koha-lxc:/srv/koha# git am sip2-changes/0001-disable-PreFork-to-enable-easy-debugging.patch
Applying disable PreFork to enable easy debugging

koha-lxc:/srv/koha# git am sip2-changes/0002-remove-eval-so-it-won-t-hide-errors.patch
Applying remove eval so it won't hide errors

koha-lxc:/srv/koha# git am sip2-changes/0003-warn-about-missing-institutions-entry-in-config-xm.patch
Applying warn about missing <institutions> entry in config xml

slanje na koha-patches listu

Koha prima patcheve preko koha-patches liste

yada, yada, nije testirano!

# create all changes against master in patches dir:
git format-patch -p patches master
git send-mail --to koha-patches@koha.org patches

# reciving side would just pull whole mbox
git am mbox

ne želim više svoje lokalne promjene!

git reset --hard

Oprez ovo će pobrisati sve promjene koje su različite od zadnjeg commit-a

Više informacija

• RailsConf Git Talk (mnogo zgodnih animacija što se dešava sa pojedinim komandama)
• Koha wiki ima upute za korištenje git-a

Javni repozitorij

Da bi drugi korisnici mogli kopirati promjene, dovoljan je samo ssh. Međutim, za anonimne korisnike treba podesiti git-daemon

Dobar savjet je prvo instalirati gitweb za overview.

git-daemon

git-daemon --verbose --export-all --base-path=/var/cache/git

U Debian-u postoji paket git-daemon-run koji koristi runit (YMMV) koji se podešava u

dpavlin@mjesec:~$ cat /etc/sv/git-daemon/run    
#!/bin/sh
exec 2>&1
echo 'git-daemon starting.'
exec git-daemon --verbose --export-all --base-path=/var/cache/git

Dodan je --export-all i popravljen --base-path (sic!)

Obradom serijskih publikacija i nakladnickih cjelina, i opcenito o pravilima katalogiziacije i standardu MARC21.