dokumentacja

Michal Moskal malekith w pld-linux.org
Wto, 11 Cze 2002, 13:58:12 CEST


On Mon, Jun 10, 2002 at 08:07:05PM +0200, Tomasz Kłoczko wrote:
> On Mon, 10 Jun 2002, Michal Moskal wrote:
> 
> > On Mon, Jun 10, 2002 at 04:28:37PM +0200, gausus w intersec.pl wrote:
> > > Witam
> > > 
> > > Zabieram sie wlasnie za katalogowanie i gormadzenie dokumentacji do PLD.
> > > W ciagu paru dni (musze to uscislic z kloczkiem) polpenie jakis enginew
> > > w php + sql. 
> > 
> > A to docbook już jest zły? Ja rozumiem, że niektórzy tu mają różne
> > fobie, ale robienie jakiegoś php-nie-wiadomo-czego zamiast docbooka,
> > który jest:
> > 
> >   a) standardowy
> >   b) standardowy
> >   c) standardowy
> >   d) co wynika a a), b) oraz c) łatwo rendrowany do różnych formatów
> >      w tym papierowych książek
> >   e) istnieje już w nim spory kawałek dokumentacji
> 
> Michał użycie docbooka w zaden sposób nie zapeania spójności dokumentacji
> o ile ma ona kilka postaci językowych.

Uh, ale robisz problemy. Wystarczy zostawić ten sam szkielet
(PLD-Guide.xml i inne które składają się tylko z &...;) a sam tekst
trzymać w osobnym katalogu dla każdego języka. Można to nawet tak
zrobić, że jeśli nie będzie czegoś po polsku wyrendruje się wersja
angielska.

-- 
: Michal Moskal ::::: malekith/at/pld-linux.org :  GCS {C,UL}++++$ a? !tv
: PLD Linux ::::::: Wroclaw University, CS Dept :  {E-,w}-- {b++,e}>+++ h



Więcej informacji o liście dyskusyjnej pld-devel-pl