🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: pl.comp.dtp.tex.gust
Article #14782

Re: [było: Dzień dobry] Dokumentacje

#14782
From: Staszek Wawrykiewicz
Date: Fri, 21 Mar 2003 03:46
121 lines
6841 bytes
On Thu, 20 Mar 2003, Piotr Strzelczyk wrote:

> Staszku -- przepraszam, ale mam wrazenie, ze  czegos nie rozumiem.
> WIEM, ze udokumentowanie zawartosci TeXLive jest straszna robota,
> ze nie da sie tego zrobic w kilka tygodni, ze uaktualnianie i pielegnacja
> takiej bazy danych jest pracochlonna -- ale negogowanie potrzeby jej
> istnienia jest DUZA przesada!!!

Piotrze, wybacz, ale Twoja wypowiedź chyba się nie odnosi do mojego
listu. *Nic* nie pisałem na temat potrzeby istnienia takiej bazy, a tym
bardziej nie mogłem tej potrzeby negować.
Wskazałem jedynie to, co jest aktualnie i gdzie.

> >> http://www.ia.pw.edu.pl/~wujek/tex/latex2e/macro/macro.html).
> >To jest też na płytce, w ramach Wirtualnej Akademii
>
> Na przyklad o tym dowiedzialem sie wlasnie dzisiaj -- a szkoda, ze nie np.
> wczoraj -- moglbym to strone polecic w czasie mojej dzisiejszej roboty
> w IOPANie. Potrzeba dostepu do takiej informacji jest ogromna!

Bardzo proszę o propozycję jak można byłoby lepiej wskazać tę informację,
niż jako odnośnik ze zwięzłego pliku dostępnego w głównym katalogu.  Po
otrzymanych uwagach owszem umieszczę w czytajto.html bezpośrednie
odnośniki do macro.html i Catalogue.

> Skad uzutkownik ma wiedziec, ze istnieje pakiet ,,floatflt'' i czym sie
> on zajmuje (a jest to doskonala odpowiedz na pytanie, z ktorym dzisiaj
> meczylem sie kilkanascie minut).

W Catalogue jest zarówno układ alfabetyczny, jak i Topical (także inne), w
ramach którego jest dział Floats, który ma dowiązania do 7
opisanych pakietów.

> >Nie bardzo wiadomo czego miałby dotyczyć ,,centralny spis''. Poza tym
> >TL to nie tylko LaTeX, także Plain, ConTeXt, systemy bibliograficzne,
> >rozmaite oprogramowanie pomocnicze itp. itd.
>
> Jak to czego?!!! Przeciez WIADOMO -- powinien zawierac informacje o funkcji
> kazdego pakietu (o jego zastosowaniu, ograniczeniach itp).
> Tylko nie mow, ze to jest w dokumentacji pakietow -- chyba, ze powiesz mi
> jak je przeszukac np. w celu znalezienia wszystkich pakietow pozwlajacych
> na oblewanie rysunkow tekstem?

Powyżej napisałem to co widać, bez żadnych dodatkowych domysłów,
sugerowania czegokolwiek, ,,mówienia'' itp.

> A jesli chodzi o inne formaty -- co one Ci przeszkadzaja w tworzeniu takiej
> bazy danych o pakietach? Przeciez w oczywisty sposob powinny byc opisane
> wszystkie pakiety (miedzy innymi wlasnie z informacja do ktorych formatow
> sa przeznaczone, a z ktorymi moga wspolpracowac).
>
> I jeszcze raz -- ja nie twierdze, ze to jest latwe, ze juz dawno powinno
> byc zrobione (a tym bardziej, ze Ty powinies to zrobic) -- ale taka
> dokumentacja NAPRAWDE jest potrzebna i twierdzenie, ze ,,Nie bardzo wiadomo
> czego miałby dotyczyc'' brzmi conajmniej podejrzanie.

Hmmm, chyba stanę przed jakąś komisją ds. .....

> A jesli komus chcialo sie:
>
> > Ja ze swojej strony zrobiłem sobie już listę pakietów od A do C w formacie
> > OpenOffice Calc, z opisami i wstępną klasyfikacją wg słów kluczowych,
>
> To nalezy go poprzec, a nie zniechecac! Taki spis jest bardzo potrzebny!
> A jesli ma nawet slowa kluczowe, to po prostu CUDOWNIE!

Ani słowem nie odniosłem się do propozycji kolegi (czy musiałem? nie mam
zdania i tyle! Napisałem tylko co jest). Insynuacja, że kogoś zniechęcam
to naprawdę brzydki faul...

> Mozna ewentualnie pytac, czy taka dokumentacja powinna byc w OpenOffice,
> w formacie TPM (dlaczego TPMy nie maja slow kluczowych?!), czy
> w RPM-ach (ktory to format ma zapieklych zwolennikow ;), czy moze
> w jakims XML-u (kto wymysli dobrego XMLa?) -- ale im wiecej takich inicjatyw
> tym lepiej.

Odpowiadam: nie wiem. Co do TPM to wielokrotnie prosiłem o pomoc w
opracowaniu parsera, którym możnaby produkować rozmaite spisy właśnie dla
potrzeb TL (alfabetyczne, tematyczne, kolekcjami itp.). Także wielokrotnie
prosiłem o pomoc w uzupełnianiu pustych pól informacyjnych. Skończyło się
na tym, że Boguś L. dostarczył mi prawie rok temu, zaraz po Bachotku, 5
(słownie pięć) takich uzupełnień i wszystko. Wobec tego sam powolutku to
dziubię.

> A w TeXLive latwo sie zagubic i bez pelnej instalacji (i nawet po
> przeczytaniu czytajto.html ;) -- i to nie tylko poczatkujacemu uzytkownikowi!

Wiem o tym, dlatego od czegoś trzeba zacząć. Pomijając kwestie
instalacyjne warto tam rzucać okiem aby (podążając za wybranymi
dowiązaniami) dowiedzieć się gdzie są dokumentacje, podstawowe
podręczniki, opis struktury katalogów, FAQ itp. Gdybyś Piotrze choć
raz tam zajrzał jest jak byk:
 link->Wirtualna Akademia TeX-owa, prowadzona w ramach polskiej Grupy
 Użytkowników Systemu TeX GUST, przedstawia system TeX, a ponadto zawiera
 opisy wielu praktycznych makr i programów.
i nie byłoby (opisanych powyżej) wczorajszych problemów w IO.

Reasumując dyskusję:
1. niestety znów zboczyła ona na tematy ,,co można/warto zrobić'',
   zamiast ,,robimy to i to, tak i tak'' (nie mówiąc o zbędnych
   podtekstach);
2. wcale nie twierdzę, że z opisami wszystko jest cacy, czemu wielokrotnie
   dawałem wyraz, oczekując odzewu, pomocy, rady itp. Odzew jeśli był,
   to raczej postulatywny (,,chciałbym..''), a nie merytoryczny
   (,,zrób to i to, popraw tamto'');
3. dla celów praktycznych, aby w ogóle ,,popchnąć'' jakiś temat do
   przodu, przyjąłem zasadę bezpośredniego nękania konkretnych osób,
   co może potwierdzić Wojtek, Grzegorz (czekam!!!), Marcin i paru innych
   sympatycznych GUSTlików.
4. ja naprawdę nie wiem jaka koncepcja dotycząca układu dokumentacji,
   jej zawartości itp. byłaby najlepsza; jest tak wiele koncepcji i prób
   realizacji jak to zrobić (prócz wymienionych Catalogue i WA, np.
   texdoctk), że sam się w tym gubię i nie ośmielam się wyrokować, że
   jakieś rozwiązanie jest ,,jedynie słuszne''. Po prostu rejestruję
   i czasem poprawiam do celów ,,używalności'' to co jest realnie
   dostępne, bez pustej gdybologii i prób wciskania komukolwiek,
   że mam absolutną rację.

--
Staszek Wawrykiewicz
StaW@gust.org.pl
Technical Details
Message-ID: <Pine.LNX.4.44.0303210216490.19673-100000@re86.internetdsl.tpnet.pl>
Path: mbox-mo1.pugleaf.net!news-archive.icm.edu.pl!mat.uni.torun.pl!news.man.torun.pl!m2n-man.torun.pl
References: <3.0.6.32.20030320190657.00920100@192.168.66.1>

Show Full Headers
Complete Article Headers
Path: mbox-mo1.pugleaf.net!news-archive.icm.edu.pl!mat.uni.torun.pl!news.man.torun.pl!m2n-man.torun.pl
From: staw@gust.org.pl (Staszek Wawrykiewicz)
Newsgroups: pl.comp.dtp.tex.gust
Subject: Re: [było: Dzień dobry] Dokumentacje
Message-ID: <Pine.LNX.4.44.0303210216490.19673-100000@re86.internetdsl.tpnet.pl>
Date: 21 Mar 03 03:46:47 GMT
References: <3.0.6.32.20030320190657.00920100@192.168.66.1>
Sender: owner-gust-l@MAN.TORUN.PL
MIME-Version: 1.0
Reply-To: Polish TeX users group discussion list <GUST-L@MAN.TORUN.PL>
Approved: mjsz@man.torun.pl
Lines: 121
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit