Strona główna

Projekt Polskiej
Dokumentacji OpenBSD

Cele projektu
Kto tworzy projekt

Dokumentacja
OpenBSD FAQ pl
OpenBSD WWW pl
Manuale pl
Nasze artykuły

Programy
Porty

Wsparcie
Jak pomagać
Jak tłumaczyć
Praca z CVS
TODO list

Strony OpenBSD
OpenBSD.org
OpenBSD Packet Filter
OpenBSD Journal

BSD w Polsce
BSDzine.org
BSDguru.org
   

CVS, a nasz projekt

Poprawki w CVS powinny być konsultowane z autorem danego tłumaczenia. Proszę nie popełniać żadnych poprawek bez wcześniejszego omówienia ich z autorem tłumaczenia.

Autorzy tłumaczeń są zobowiązani do sprawdzania, czy ewentualnie nie zaszły jakieś nieautoryzowane zmiany w dokumencie, którym się opiekują (tak na wszelki wypadek).

Jeśli nie masz jeszcze dostępu do CVS naszego projektu, a pracujesz już nad tłumaczeniem jakiegoś dokumentu, prześlij Twój username w SourceForge.net na ten adres, aby uzyskać dostęp do popełniania poprawek w drzewie CVS.

W repozytorium CVS znajduje się moduł htdocs zapewniający możliwość dokonywania samodzielnych zmian w tabelach tłumaczeń. Tabele są generowane na podstaie zawartości plików FAQ_ , WWW_ oraz MAN_ . Po założeniu konta użytkownika na sf.net i uzyskaniu statusu członka projektu OpenBSDpl, stajesz sie, drogi tłumaczu, całkowicie niezależny, tzn masz pełną kontrolę nad tłumaczeniem, którym się opiekujesz.

Kilka razy dziennie (crontab) skrypt pobiera pliki z drzewa CVS i aktualizuje strony projektu wraz z wszystkimi tłumaczeniami. Wszystko to odbywa się z konta na sf.net.


Jak popełniać poprawki w CVS

Zacznijmy od shella, jeżeli używasz sh/bash:

$ export CVS_RSH=ssh
$ export CVSROOT=twojeuserid@openbsdpl.cvs.sourceforge.net:/cvsroot/openbsdpl

jeśli używasz csh/tcsh:

$ setenv CVS_RSH ssh
$ setenv CVSROOT twojeuserid@openbsdpl.cvs.sourceforge.net:/cvsroot/openbsdpl

potem:
- checkout (ściąganie drzewa cvs na dysk):

$ cvs co www

- add (dodawanie nowego pliku):

$ cd www/do/katalogu/gdzie/siedzi/nowy/plik
$ cvs add nazwapliku
$ cvs commit nazwapliku

- commit (dodawanie nowej wersji istniejącego pliku):

$ cd www/do/katalogu/gdzie/siedzi/zmieniany/plik
$ cvs commit nazwapliku

Poza tym, polecam "CVS. Leksykon kieszonkowy" wydany przez Helion (tłum. podręcznika wydanego przez O'Reilly)

Nadesłane przez Jacka Artymiaka

Praktyczne porady dla tłumacza korzystającego z naszego CVS

Dokument, którym się opiekuję, wymaga aktualizacji... jak wygodnie i bezpiecznie go zaktualizować?

Przede wszystkim należy pamiętać o pobraniu najnowszej wersji repozytorium CVS. Procedura pobierania aktualnej wersji repozytorium jest dokładnie opisana powyżej.

Następnie można otworzyć w jednym oknie przeglądarkę internetową z otwartym jednym z diffów podanych przy naszym pliku na stronie TODO list. W drugim oknie można odpalić nasz ulubiony edytor poprawnie obsługujący kodowanie polskich znaków w ISO-8859-2. Przy pomocy mechanizmu cut&paste wycinamy z diff-a nowe fragmenty i uważnie wstawiamy je do naszego pliku w odpowiednich miejscach. Jeśli kopiujemy z czystego diff-a, usuwamy znaczki '+' z początku linii. Tłumaczymy nowo wstawiony tekst i sprawdzamy czy tworzy logiczną i spójną całość z otaczającym go tekstem.

Następnie sprawdzamy jakie zmiany wprowadziliśmy oraz czy "przypominają" one diff-a z oryginału anglojęzycznego (diff wykorzystany w przykładzie można znaleźć tutaj).

user@host:www$ cvs diff index.html
Index: index.html
===================================================================
RCS file: /cvsroot/openbsdpl/www/index.html,v
retrieving revision 1.24
diff -r1.24 index.html
137c137
< <a href="http://openbsd.hrxnet.de">[DE]</a>
---
> <a href="http://openbsd.mirrored.by.hrxnet.de">[DE]</a>
138a139
> <a href="http://openbsd.bsdberlin.org/">[DE]</a>
167c168
< Originally [OpenBSD: index.html,v 1.447 ]<br>
---
> Originally [OpenBSD: index.html,v 1.449 ]<br>
user@host:www$

Wynik polecenia cvs diff jakisplik można przekierować do jakiegoś programu sprawdzającego pisownię, jeśli nie chcemy uruchamiać go dla całego aktualizowanego pliku.

Gdy wszystko jest w porządku, możemy przystąpić do ostatniego kroku: wprowadzenia zmian w repozytorium CVS:

user@host:www$ cvs commit -m 'update 1.447->1.449' index.html 
Checking in index.html;
/cvsroot/openbsdpl/www/index.html,v  <--  index.html
new revision: 1.25; previous revision: 1.24
done
Mailing openbsdpl-cvs@lists.sourceforge.net...
Generating notification message...
Generating notification message... done.
user@host:www$

Jeśli wszystko poszło dobrze i nie pomyliliśmy się przy zwiększaniu numeru wersji w tagu (liczba spacji i pisownia jest istotna!) skrypt status2.sh powinien wygenerować nową stronę TODO list, nie zawierającą już naszego pliku w ciągu najbliższych 24 godzin.

Jeśli jesteś zapisany na listę openbsdpl-cvs@lists.sourceforge.net, otrzymasz potwierdzenie wprowadzenia nowych zmian wraz z odpowiednim diff-em.


Kilka linków, dotyczących CVS:

cvstrain - całkiem dobry przewodnik po CVS

Managing websites using Unix - to praktyczny przykład wykorzystywania CVS do manipulowania stronami www