Article View: pl.comp.dtp.tex.gust
Article #14782Re: [było: Dzień dobry] Dokumentacje
From: Staszek Wawrykiewicz
Date: Fri, 21 Mar 2003 03:46
Date: Fri, 21 Mar 2003 03:46
121 lines
6841 bytes
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.plReferences:
<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