dokumentacja

[wrobell]

On Mon, Jun 10, 2002 at 11:00:06PM +0200, Tomasz Kłoczko wrote:
[...]
> > Tak wogóle co to jest za rozwiązanie?
> 
> Pomysł jest dość prosty.
> Poprostu frontend a www który umożliwiałby edycję tylko kawałka tekstu w
> tylu wersjach ile jest języków. Przy zatwierdzaniu zmiany w przypadku 
> zmiany tylko w jednej wersji miałbyś możliwść zaznacznia czy wymagać 
> będzie to jeszcze aktualizacji pozostałych wersji językowych.
> Frntrend umożliwiałby manipulowanie kawałkami tekstu (przenszenie,  
> wycinanie, zakładanie nowych elementów hierarhii i innych tego typu).
> W każdj chwili wybeirając edycje miałbyś dosep do sytatusu tego co należy 
> zmienić żeby synchrnizować dana wersje językową względem postaci 
> referencyjnej (angielska treść).
> Teg typu podejście nie wymagałoby bardzo minimalnego zasobu wiedzy co do 
> narzędzi. Nie wymagałby niczego ponad to w tym i znajomości docbook czy 
> innych rzeczy które dla dokumentalistów byłyby niepotrzebnym obciązeniem.

DocBook-a można się nauczyć w niecałą godzinę. Tworzenie w DocBook-u
jest prostsze niż używanie CVS-a, IMHO.

Stworzenie w/w frontendu do edycji nie ma sensu, Wszystko to można
zrobić za pomocą edytora, DocBook-a oraz odpowiednich XSLT.

Za pomocą tego co dają technologie XML-owe można zapytać, np.:

1. Jaka jest treść piątego paragrafu dla języka pl i en?
2. Jaka jest treść piątego elementu drugiej listy w rozdziale czwartym
   dla języka ru i de?
3. Jakie jest treść wszystkich tytułów rozdziałów dla języków cz i sv?
4. ...

Zamiast tworzenia frontend-u www, lepiej zrobić odpowiednie wtyczki
do vim-a, emacs-a i abiword-a, które ułatwiałyby pracę z DocBook-iem
(należy zaznaczyć, że pewne wsparcie tu już istnieje!).

Chcesz wynaleźć koło, IHMO.

[...]

    wrobell <wrobell at ite.pl>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: </mailman/pipermail/pld-devel-pl/attachments/20020611/1a1c8b35/attachment.sig>