Plik 'Przeczytaj mnie' programu Directory
Lister
Wersja 0.7
(C) 2000-2004 Prawa autorskie: Leszek Skorczyński
http://freeware.prv.pl
Opis programu Directory Lister
Cel programu
Directory Lister pozwala listować zawartość wybranych
katalogów na dyskach twardych, płytach CD, dyskietkach itp. do pliku tekstowego,
HTML, albo CSV. Jest to taka udoskonalona i wygodniejsza wersja polecenia 'DIR'.
Ogólne zasady
Zawartość dyskietek nie jest odczytywana podczas uruchomiania programu. Trzeba
kliknąć na dyskietce aby katalogi zostały odczytane.
Wybieranie katalogów
(Zaznaczony biały kwadrat) - listuj
zaznaczony katalog i wszystkie jego podkatalogi,
(Zaznaczony szary kwadrat) - listuj zaznaczony
katalog ale nie wszystkie jego podkatalogi (nie wszystkie może oznaczać: nie
listuj żadnego podkatalogu),
(Szary kwadrat) - listuj niektóre podkatalogi tego
katalogu, ale nie zaznaczony katalog,
(Biały kwadrat) - nie listuj tego katalogu ani
żadnego podkatalogu, który jego jest.
Podczas zapisywana pliku z wyborem katalogów zapamiętywane są tylko katalogi,
które mają zaznaczony kwadrat (biały lub szary). Dla katalogów zaznaczonych
białym kwadratem zapamiętywane są tylko te, które stoją najwyżej w hierarchii.
Podkatalogi są odczytywane podczas tworzenia listingu.
Argumenty linii poleceń
[pełna_ścieżka]DirLister.exe [/l katalogi[.dls] wynik[.
txt|.html]] [/o konfiguracja[.dlc]]
- gdzie:
- katalogi.dls - wcześniej zapisany plik z wyborem
katalogów
wynik - listing
konfiguracja.dlc - wcześniej zapisany plik z
konfiguracją użytkownika
/l - czyta plik z wyborem katalogów, tworzy listing i
zamyka aplikację
/o - czyta plik z konfiguracją użytkownika
- Przykład:
-
C:\Program Files\Directory Lister\DirLister.exe /l c:\moje
dokumenty\katalogi_ftp.dls c:\ftp\zawartosc_mojego_ftp.html /o c:\moje
dokumenty\moja_konfiguracja.dlc
- ten przykład czyta konfigurację z 'c:\moje dokumenty\moja_konfiguracja.dlc',
czyta wybór katalogów z
'c:\moje dokumenty\katalogi_ftp.dls', tworzy plik
'c:\ftp\zawartosc_mojego_ftp.html' i zamyka aplikację
(ponieważ użyto opcji '/l').
Skróty klawiszowe
F5 - odświeża drzewo katalogów
F12 - wyświetla zakładkę 'Podgląd'
Wywołanie z menu kontekstowego
Podczas instalacji Directory Listera dodawany jest
nowa pozycja w menu kontekstowym Eksploratora Windows.
Po kliknięciu prawym przyciskiem myszy na katalogu w Eksploratorze Windows oraz
wybraniu pozycji 'DirList' z menu
kontekstowego, tworzony jest listing zaznaczonego katalogu w tym katalogu.
Konfiguracja dla tego listingu jest
odczytywana z pliku 'This.dlc' znajdującego się w katalogu Directory Listera.
Plik wynikowy ma nazwę '_thisfolder' i rozszerzenie odczytane z pliku
konfiguracyjnego.
Opis opcji programu
Zakładka: Opcje
Grupa: Wyświetl
- Nazwa katalogu - pokazuje nazwy katalogów przed nazwami
plików. W listingu tekstowym, po zaznaczeniu dodatkowo opcji
'Nazwa pliku', nazwa katalogu zostanie
otoczona dwoma poziomymi liniami składającymi się ze znaków '-'.
- Liczba plików po nazwie katalogu - pokazuje liczbę plików
znajdujących się w danym katalogu. Ta informacja jest prezentowana w nawiasie,
za wyjątkiem listingu CSV, gdzie występuje
jako osobna kolumna.
- Rozmiary katalogów - pokazuje rozmiary katalogów przed
nazwami plików. Liczba ta uwzględnia nałożoną maskę na pliki, a przedstawia
całkowity rozmiar wszystkich plików znajdujących
się w wybranym katalogu i we wszystkich jego podkatalogach.
- Data katalogu - pokazuje datę katalogu.
- Czas katalogu - pokazuje czas katalogu.
- Atrybuty katalogu - pokazuje atrybuty katalogu gdzie
'r' oznacza 'Tylko do odczytu', 'a' oznacza 'Archiwalny',
'h' oznacza 'Ukryty', 's' oznacza 'Systemowy', a 'c oznacza skompresowany.
- Podkatalogi - pokazuje również podkatalogi oprócz plików.
- Numer pliku - pokazuje kolejny numer pliku przed jego nazwą.
Dla listingu CSV, ta informacja
występuje jako osobna kolumna.
- Ścieżka do pliku - pokazuje ścieżkę do plików i podkatalogów.
Dla listingu CSV, ta informacja
występuje jako osobna kolumna.
- Nazwa pliku - pokazuje nazwy plików.
- Rozszerzenie pliku - pokazuje rozszerzenia plików. Zakłada
się, że
podkatalogi nie mają rozszerzenia więc jeśli w ich nazwie występuje kropka to
dalsza część jest zawsze wyświetlana.
- Rozmiar pliku - pokazuje rozmiary plików, a dla podkatalogów
napis:
'<dir>'.
- Data pliku - pokazuje daty plików.
- Czas pliku - pokazuje czasy plików.
- Wersja pliku - pokazuje wersje plików jeśli są dostępne.
Zwykle informacja o wersji jest zapisywana w plikach wykonywalnych (exe, dll,
ocx, itp.).
- CRC32 pliku - pokazuje wartości CRC32 dla plików (takie same
jak w
archiwach zip/rar).
- Atrybuty pliku - pokazuje atrybuty plików i podkatalogów gdzie
'r' oznacza 'Tylko do odczytu', 'a' oznacza 'Archiwalny',
'h' oznacza 'Ukryty', 's' oznacza 'Systemowy', a 'c oznacza skompresowany.
Grupa: Opcje
- Maska - listuje tylko te pliki, które pasują do maski.
Można określić wiele masek oddzielając je znakiem ';' np.:
'*.avi;*.txt'
Można też stosować znaki zastępcze: ('*?') . Maska dotyczy
tylko plików, nie katalogów.
- Przykład:
-
- Pliki, których nazwy zaczynają się od 'a', mają cztery znaki i
dowolne rozszerzenie:
a???.*
- Sortuj katalogi wg - wskazuje jak sortować katalogi.
Sortowanie odbywa się najpierw po wybranym atrybucie, a
potem po nazwie.
- Sortuj katalogi malejąco - odwraca porządek sortowania
katalogów.
- Sortuj pliki wg - wskazuje jak sortować pliki. Sortowanie
odbywa się najpierw po wybranym atrybucie, a
potem po nazwie.
- Sortuj pliki malejąco - odwraca porządek sortowania plików.
- Traktuj pliki łącznie - traktuje pliki jak gdyby znajdowały
się
w jednym katalogu, tzn. sortowanie i numerowanie plików jest wykonywane razem
niezależnie od tego w jakim katalogu dany
plik się znajduje.
- Rozmiar jako - wyświetla rozmiary katalogów i plików w
bajtach, kilobajtach, megabajtach, gigabajtach lub dynamicznie - w zależności
od rozmiaru we właściwej mierze.
- Miejsca dziesiętne - określa liczbę miejsc po przecinku kiedy
opcja 'Rozmiar jako' ustawiona jest na wartość inną niż 'Bajty'.
- Separator tysięcy - określa znak używany do oddzielania
tysięcy dla rozmiarów.
- Separator dziesiętny - określa znak używany do oddzielania
miejsc dziesiętnych.
- Listing dla każdego katalogu - tworzy listing w każdym
listowanym katalogu zawierający jego zawartość i zapisuje go pod nazwą pobraną
z pola 'Nazwa:'. Rozszerzenie jest automatycznie dodawane.
Uwaga! Ten plik jest zawsze
nadpisywany, należy się zatem upewnić by nie istniały pliki o podanej nazwie.
- Ścieżka - określa jak część ścieżki będzie wyświetlana.
- Pełna - wyświetla pełną ścieżkę
- Bez litery dysku - nie wyświetla tylko litery dysku
- Od katalogu nadrzędnego - wyświetla ścieżkę poczynając od
katalogu zaznaczonego, który stoi najwyżej
w hierarchii.
- Data i czas - określa jaka data będzie prezentowana dla opcji
daty i czasu.
- Pamiętaj wybór katalogów - zapisuje plik
'DirLister.dlc' zawierający aktualny wybór katalogów podczas wychodzenia
z programu i odczytuje go podczas uruchomienia.
Zakładka: Opcje 2
Grupa: Plik wynikowy
- Tekstowy - Tworzy plik tekstowy. W tym trybie można określić
szerokość pól dla nazw, rozmiarów i wersji na zakładce 'Opcje 1'.
- HTML - Tworzy plik HTML.
- CSV - Tworzy plik CSV. Ta opcja jest użyteczna jeśli wynik ma
być wyeksportowany do Excela albo do bazy danych.
Grupa: Opcje HTML
- Generuj linki do katalogów - tworzy linki do właściwych
katalogów.
Normalnie ścieżka katalogu jest kopiowana do atrybutu 'HREF' chyba, że
zaznaczona jest opcja Wyświetlaj ścieżkę: Bez litery dysku - w tym
przypadku atrybut 'HREF' nie zawiera pierwszego znaku '\' tak, że można
skopiować listing do katalogu stojącego najwyżej w hierarchii zaznaczonych
katalogów, a następnie przeglądać jego podkatalogi.
- Generuj linki do plików - tworzy linki do właściwych plików.
Ta sama reguła obowiązuje co dla katalogów.
- Kolor tła - zmienia kolor tła strony HTML.
- Kolor tła nagłówka - zmienia kolor tła dla nagłówka strony.
- Czcionka i kolor nagłówka - zmienia czcionkę i kolor nagłówka
strony.
- Kolor tła katalogów - zmienia kolor tła dla wierszy katalogów.
- Czcionka i kolor katalogów - zmienia czcionkę i kolor dla
wierszy katalogów.
- Kolor tła nieparzystych wierszy - zmienia kolor tła dla
nieparzystych wierszy.
- Czcionka i kolor nieparzystych wierszy - zmienia czcionkę i
kolor dla nieparzystych wierszy.
- Kolor tła parzystych wierszy - zmienia kolor tła dla
parzystych wierszy.
- Czcionka i kolor parzystych wierszy - zmienia czcionkę i
kolor dla parzystych wierszy.
Grupa: Opcje CSV
- Nazwy kolumn w pierwszym wierszu - zapisuje nazwy
występujących kolumn w pierwszym wierszu pliku CSV.
- Separator - znak używany do oddzielania poszczególnych kolumn
w pliku CSV. Jeśli
separator występuje w danej kolumnie, jej zawartość zostanie zapisana w
cudzysłowie (").