Plik konfiguracyjny
Przy pierwszym uruchomieniu aplikacji tworzony jest plik konfiguracyjne zawierający podstawowe ustawienia. Po zapisaniu ustawień programu (pozycja w menu głównym) zapisywane są do niego wszystkie opcje konfiguracyjne. Jeśli zajdzie potrzeba "ręcznej" modyfikacji tego pliku, istotna jest informacja o tym, że znajduje się on w następującej lokalizacji: "/home/katalog_użytkownika/.qt"1 i nosi nazwę "qtcmdrc". Poniżej opisano wszystkie możliwe sekcje pliku konfiguracyjnego aplikacji wraz z wszelkimi możliwymi opcjami dla każdej z sekcji.
- General,
- Favorites,
- FTP,
- LeftPanel,
- FilesPanel,
- FilesPanelShortcuts,
- FilesSystem,
- MyColorsScheme,
- LFS,
- Archives,
- LeftFilesPanel,
- RightPanel,
- RightFileView,
- FileView,
- FileViewShortcuts,
- TextFileView,
- SyntaxHighlighting
- Sekcje planowane
General
Sekcja zawierająca ustawienia główne, najbardziej ogólne dla aplikacji. Dostępne są tutaj następujące opcje:
- Width - aktualna szerokość okna głównego programu, maksymalna wartość dla niej to bieżąca szerokość pulpitu,
- Height - aktualna wysokość okna głównego programu, maksymalna wartość dla niej to bieżąca wysokość pulpitu,
- ShowMenuBar - wskazuje czy w oknie głównym zostanie pokazany pasek menu; "true" oznacza jego pokazanie, natomiast "false" - ukrycie,
- ShowToolBar - wskazuje czy w oknie głównym zostanie pokazany pasek narzędziowy; wartość "true" oznacza jego pokazanie, natomiast "false" - ukrycie,
- ShowButtonBar - wskazuje czy w oknie głównym zostanie pokazany pasek guzików; wartość "true" oznacza jego pokazanie, natomiast "false" - ukrycie,
- SaveSettingsWhenQuit - określa to czy przy zamknięciu aplikacji należy zapisać ustawienia; wartość "true" wymusza zapis, natomiast dla "false" nie zostaną one zapisane.
Favorites
Sekcja trzyma kolejne URL-e z nazwą i katalogiem docelowym dla listy ulubionych użytkownika.
Przykład:
"Url0=home directory\\/home/user/",
gdzie:
"Url0" - oznaczenie kolejnego URL-a (po nim musi wystąpić Url1, itd.), "home dir" - nazwa ulubionego, "\\" - separator (własny), "/home/user/" - ścieżka docelowa.
FTP
Sekcja ustawień klienta FTP. Może zawierać następujące opcje:
- UsersName - trzyma listę użytkowników oddzielonych znakiem "^e" (standardowy separator);
- StandByConnection - mówi o tym, czy podtrzymywać połączenie po minięciu czasu bezczynności na serwerze; wartość "true" włącza podtrzymywanie, przy "false" podtrzymywanie nie działa;
- NumOfTimeToRetryIfBusy - oznacza ilość powtórzeń, jeśli serwer jest zajęty; dostępne wartości zawierają się w zakresie: 0 - 999.
Poza tym, w sekcji tej mogą się znaleźć sesje FTP, które można konfigurować w menadżerze połączeń FTP. Przykładowy zapis sesji może wyglądać w niżej podany sposób:
"S01=session1\\ftp://user:password@localhost.com:21/",
gdzie:
"S01" - oznaczenie kolejnej sesji (po niej musi wystąpić S02, itd.),
"session1" - nazwa sesji,
"\\" - separator (własny),
"user" - nazwa dla logującego się użytkownika,
"passord" - hasło dla powyższego użytkownika,
"localhost.com" - adres docelowego hosta,
"21" - numer portu.
LeftPanel
Sekcja zawiera ustawienia lewego panelu.
- Width - szerokość lewego panelu. Przy czym jeśli suma szerokości lewego i prawego panelu jest większa niż szerokość okna aplikacji, to jest tu ustawiana wartość pomniejszana o szerokość prawego panelu;
- KindOfPanel - rodzaj lewego panelu, dostępne wartości:
0 - FilesPANEL (panel plików), 1 - (osadzony w panelu podgląd pliku).
FilesPanel
W sekcji umieszczone są ustawienia dla panelu plików (widoku listy).
- Columns - zawiera listę numerów kolumn z ich rozmiarami. Przykładowo lista może wyglądać w następujący sposób: "0-170^e1-70^e2-114^e3-74^e4-48^e5-46",
gdzie:
"0" - kolumna zero (pierwsza), maksymalna wartość to "5",
"170" - szerokość pierwszej kolumny,
"^e" - separator.
- ColorsScheme - zawiera nazwę schematu kolorów dla listy, która występuje jako osobna sekcja w pliku kopnfiguracyjnym oraz na liście w opcji ColorsSchemeList, np. "DefaultColors"
- ColorsSchemeList - trzyma listę schematów kolorów dla listy, przykładowo może ona wyglądać w następujący sposób: "DefaultColors^eMyColorsScheme"
- FileSizeFormat - oznacza sposób pokazywania rozmiarów plików w kolumnie pokazującej rozmiary na widoku listy; wartościami mogą być:
"1" - liczba bez spacji;
"2" - liczba ze pogrupowana w trójki, które oddziela spacja;
"3" - liczba z przyrostkiem wagowym, np. "125 KB".
- Font - opcja zawiera nazwę oraz rozmiar używanej na liście rodziny czcionki; (Helvetica,10)
- NotHiddenCursor - zawiera informacje o sposobie poruszania się kursora przy przewijaniu zawartości panelu; wartość "true" spowoduje, że kursor nie schowa sie pod (górną i dolna) krawędzią widoku, "false" mówi, że kursor będzie wtedy chowany.
- SelectFilesOnly - zawiera informację o tym, czy przy operacji "zaznacz wszystkie" zaznaczone zostaną tylko pliki lub pliki i katalogi; wartość "true" wymusza zaznaczenie tylko plików, natomiast przy "false" zaznaczane będą pliki i katalogi.
- SynchronizeColumns - trzyma informację o tym czy synchronizować rozmiary kolumn w obydwu panelach; wartość "true" spowoduje, że kolumny będą przyjmować ten sam rozmiar podczas zmiany rozmiaru w jednym z nich, natomiast "false" wyłącza synchronizację.
- ShowIcons - zawiera informację o tym czy pokazywane będą ikony przed nazwą pliku; wartość "true" wymusza ich pokazywanie, przy "false" ikony nie będzie.
- ShowHiddenFiles - trzyma informację o tym czy pokazywać ukryte pliki i katalogi; wartość nakazuje wyświetlić ukryte pliki i katalogi, "false" spowoduje ich schowanie.
- ShowDirsOnly - jej wartość określa czy pokazywać tylko katalogi; wartość "true" oznaczy pokazywanie tylko katalogów, przy "false" - pokazane będą pliki i katalogi.
FilesPanelShortcuts
Sekcja zawiera listę elementów z opisem operacji dla okna głównego i przyrównanym jej skrótem klawiszowym. Przykładowo jeden taki element może wyglądać w następujący sposób:
"Change view to list=Alt+Ctrl+L".
FilesSystem
W sekcji są obecne ogólne ustawienia dla systemu plików.
- AlwaysOverwrite - zawiera informację o tym czy przy operacji kopiowania lub przenoszenia zawsze ma nadpisywać pliki docelowe; wartość "true" oznacza nadpisywanie, "false" spowoduje pokazanie okienka ostrzegawczego;
- AlwaysSavePermission - informuje o tym czy zawsze, podczas operacji kopiowania lub przenoszenia, zachowywać atrybuty plików (data modyfikacji i prawa dostępu.); wartość "true" wymusza ich zachowywanie, przy "false" nie będą one zachowane;
- AskBeforeDelete - włącza bądź wyłącza pokazywanie okna ostrzegawczego przed usuwaniem plików i katalogów; wartość "true" oznacza pokazanie ostrzeżenia, natomiast dla "false" okienko to nie zostanie pokazane;
- AlwaysGetInToDir - zawiera informację o tym czy po utworzeniu katalogu wejść do jego wnętrza; wartość "true" wymusza wejście, "false" - bez wejścia;
- CloseProgressDlgAfterFinished - trzyma informację o tym czy chować dialog postępu po zakończeniu operacji; wartość "true" spowoduje jego schowanie, przy "false";
- CopyMoveURLs - trzyma listę miejsc docelowych dla kopiowanych lub przenoszonych plików;
- CopyMoveURLsId - zawiera numer bieżącego miejsca docelowego z powyższej listy.
- FindFileNames - trzyma listę szukanych plików lub ich wzorów; przykładowo może zawierać natępującą wartość: "jakis_plik.txt^e*.html^eplik.txt";
- FindFileNamesId - zawiera numer bieżącego miejsca docelowego z powyższej listy;
- FindLocations - trzyma listę lokalizacji w których szukano plików lub wzorców; przykładowo może zawierać następującą wartość: "/home/user/^e/home";
- FindLocationsId - zawiera numer ostatnio wybranej lokalizacji z powyższej listy;
- MakeDirNames - trzyma listę nazw utworzonych wcześniej katalogów;
- MakeDirNamesId - zawiera numer bieżącej nazwy utworzonego katalogu z powyższej listy;
- MakeLinkURLs - trzyma listę miejsc docelowych dla utworzonych linków;
- MakeLinkURLsId - zawiera numer ostatnio utworzonego linka z powyższej listy;
- TemplateSelection - trzyma listę wzorców zaznaczeń plików; przykładowo może ona wyglądać tak: "*^e*.cpp^e*.h".
MyColorsScheme
W sekcji umieszczone są ustawienia dla schematu kolorów "MyColorsScheme".
- ShowSecondBgColor - wskazuje czy pokazywać dwukolorowe tło na widoku listy; wartość "true" wymusza pokazywanie dwukolorowego tła, "false" powoduje, że tło ma jeden kolor;
- ShowGrid - zawiera informację o tym czy pokazywać siatkę; wartość "true" oznacza pokazywanie siatki, natomiast dla "false" tej siatki brak;
- TwoColorsCursor - trzyma informację o tycz będzie pokazywany kursor dwu kolorowy (w postaci ramki); wartość "true" włącza kursor dwu kolorowy, przy "false" będzie kursor jedno kolorowy (belka wypełniona kolorem);
- ItemColor - kolor nazwy elementu, przykładowa wartością może być: "010203",
gdzie:
01 - szesnastkowa wartość dla składowej "Red" koloru,
02 - szesnastkowa wartość dla składowej "Green" koloru,
03 - szesnastkowa wartość dla składowej "Blue" koloru.
- ItemColorUnderCursor - kolor nazwy elementu, na którym stoi kursor;
- SelectedItemColor - kolor zaznaczonego elementu;
- SelectedItemColorUnderCursor - kolor zaznaczonego elementu, na którym stoi kursor;
- BgColorOfSelectedItems - kolor tła dla zaznaczonego elementu;
- BgColorOfSelectedItemsUnderCursor - kolor tła dla zaznaczonego elementu, na którym stoi kursor;
- FirstBackgroundColor - pierwszy kolor tła dla widoku listy (jeśli tło jest jedno kolorowe to posiada ten kolor);
- SecondBackgroundColor - drugi kolor tła dla widoku listy;
- FullCursorColor - kolor, tzw. pełnego kursora;
- InsideFrameCursorColor - kolor wewnętrznej ramki kursora dwukolorowego;
- OutsideFrameCursorColor - kolor zewnętrznej ramki kursora dwukolorowego;
- GridColor - kolor siatki.
LFS
Sekcja zawiera ustawienia dla lokalnego systemu plików (Local Files System).
- AlwaysRemoveToTrash - włącza bądź wyłącza tzw. bezpieczne usuwanie plików i katalogów; wartość "true" włącza bezpieczne usuwanie (pliki są przenoszone do określonego katalogu "kosza"), "false" powoduje, że pliki są fizycznie usuwane;
- AlwaysWeighBeforeOperation - zawiera informację o tym czy zawsze ważyć katalog przed operacja na nim (np. kopiowania/usuwania); wartość "true" włącza ważenie katalogu, "false" oznacza, że katalog nie będzie ważony (nie zostanie wtedy pokazany postęp operacji);
- TrashDirectory - trzyma ścieżkę do katalogu "kosza".
Archives
Umieszczone są tutaj opcje wykorzystywane przy obsłudze archiwów.
- WorkingDirectory - trzyma ścieżkę do katalogu roboczego (tu będą rozpakowywane przetwarzane archiwa oraz podglądane pliki z ich wnętrza);
- RarSolidArchive - (opcja RAR-a), zawiera informację o tym czy należy tworzyć archiwum typu "Solid"; wartość "true" oznacza, że utworzone zostaną archiwa typu "Solid", "false" nie spowoduje utworzenia tego typu archiwów;
- RarSfxArchive - (opcja RAR-a), wskazuje czy tworzyć samorozpakowywalne archiwum; wartość "true" włącza tworzenie takiego archiwum, "false" oznacza zwykłe archiwum
- RarSaveLinks - (opcja RAR-a), zawiera informację o tym czy zapisywać linki zamiast plików wskazywanych przez nie; wartość "true" włącza zapisywanie linków, "false" mówi, że zapisywane będą pliki wskazywane przez linki;
- RarSaveOwnerAndGroup - (opcja RAR-a), mówi o tym, czy zapisywać dla każdego pliku informację o jego właścicielu i grupie; wartość "true" spowoduje zapisywanie tych informacji, natomiast "false" oznacza brak zapisywania właściciela i grupy;
- RarMultimediaCompression - (opcja RAR-a), włącza bądź wyłącza kompresję multimedialną (min. poprawia to kompresję plików typu "wav"); wartość "true" włącza tę kompresję, natomiast "false" spowoduje, że nie będzie ona użyta;
- RarOvrExistingFiles - (opcja RAR-a), zawiera informację o tym czy zawsze nadpisywać docelowe pliki; wartość "true" spowoduje nadpisywanie, przy "false" użytkownik zostanie spytany o sposób działania;
- ZipSfxArchive - (opcja ZIP-a), wskazuje czy tworzyć samorozpakowywalne archiwum; wartość "true" włącza tworzenie takiego archiwum, "false" oznacza zwykłe;
- ZipSaveSymbolicLinks - (opcja ZIP-a), zawiera informację o tym czy zapisywać linki zamiast plików wskazywanych przez nie; wartość "true" włącza zapisywanie linków, "false" mówi, że zapisywane będą pliki wskazywane przez linki;
- ZipDoNotSaveExtraAttrib - (opcja ZIP-a), trzyma informację o tym czy nie należy zapisywać informacji o właścicielu i grupie oraz czasów ostatniego dostępu do pliku; wartość "true" spowoduje włączenie tej opcji, przy "false" informacje te będą zapisywane;
- Bzip2FullName - wskazuje na nazwę kompresora "bzip2", wraz z absolutną ścieżką dostępu;
- GzipFullName - wskazuje na nazwę kompresora "gzip", wraz z absolutną ścieżką dostępu;
- RarFullName - wskazuje na nazwę archiwizera "rar", wraz z absolutną ścieżką dostępu;
- TarFullName - wskazuje na nazwę archiwizera "tar", wraz z absolutną ścieżką dostępu;
- ZipFullName - wskazuje na nazwę archiwizera "zip", wraz z absolutną ścieżką dostępu.
LeftFilesPanel
Zawiera ustawienia dla lewego panelu plików (podobnie mogą wyglądać dla prawego).
- DefaultFilesFilter - zawiera identyfikator (liczony od 0) dla filtru aktualnie używanego w panelach. Pierwsze pięć (0-4) to filtry standardowe, reszta to filtry użytkownika.
- KindOfView - zawiera informację o rodzaju podglądu;
dostępne wartości:
0 - widok zwykłej listy,
1 - widok drzewa.
- SortColumn - trzyma numer kolumny, po której sortowana jest lista, przykładowo wartość 0 oznacza, że po pierwszej (maksymalna wartość to 5);
- SortAscending - mieści informację o sposobie sortowania w wybranej kolumnie;
dostępne wartości:
0 - rosnący,
1 - malejący.
- NumOfCurrentURL - numer URL-a z listy wskazywanej przez opcję "URLs", który zostanie wylistowany po uruchomieniu aplikacji; dostępne są wartości z następującego zakresu: 1...liczba wszystkich URLi na liście;
- URLs - trzyma listę odwiedzonych URL-i (katalogów, archiwów, katalogów na serwerach FTP), może wyglądać w następujący sposób:
"/etc/^e//home/user/archive.tar.bz2#/subdir_arch^eftp://trolltech.com/source/"
- UserFilters - trzyma listę filtrów użytkownika (są to wzorce dopasowania)
RightPanel
Sekcja zawiera ogólne ustawienia dla prawego panelu.
- Width - szerokość prawego panelu. Przy czym jeśli suma szerokości lewego i prawego panelu jest większa niż szerokość okna aplikacji, to jest tu ustawiana wartość pomniejszana o szerokość prawego panelu;
- KindOfPanel - rodzaj prawego panelu,
dostępne wartości:
0 - FilesPANEL,
1 - FileView.
RightFileView
Sekcja używana przez podgląd pliku osadzony w panelu do trzymania nazwy pliku do otwarcia wraz z jego absolutną ścieżką, np.
"URL=/home/user/Documents/SomeFileName.html"
FileView
W tej sekcji mieszczą się ogólne ustawienia dla okna podglądu pliku.
- Size - określa rozmiar okna podglądu , przykładowa wartość to: "600, 400" (maksymalne może ona mieć wielkość pulpitu);
- FullScreen - zawiera informację o tym czy okno ma zajmować cały ekran; wartość "true" spowoduje, że podgląd zostanie otwarty w takiej wielkości oknie, przy "false" wybrany zostanie rozmiar domyślny lub wczytany z opcji "Size".
- ShowToolBar - trzyma informację o tym czy pokazane czy nie zostanie pasek narzędziowy; wartość "true" oznacza, że będzie pokazane, natomiast "false", że ukryty.
- ShowMenu - trzyma informację o tym czy pokazane czy nie zostanie pasek menu; wartość "true" oznacza, że będzie pokazane, natomiast "false", że ukryty.
- NumOfCurrentURL - numer URL-a z listy wskazywanej przez opcję "URLs", który zostanie wczytany po uruchomieniu podglądu; dostępne są wartości z następujące go zakresu: 1...liczba wszystkich URLi na liście,
- URLs - trzyma serię nazw plików, które są wstawiane na boczną listę plików okna podglądu; przykładowa wartość: "/home/plik.txt^e/home/strona.html"
FileViewShortcuts
Sekcja zawiera listę elementów z opisem operacji dla okna podglądu i przyrównanym jej skrótem klawiszowym. Przykładowo jeden taki element może wyglądać w następujący sposób:
"Toggle to Raw mode=Alt+Ctrl+R".
TextFileView
W sekcji mieszczą się opcje dla tekstowego podglądu pliku.
- Font - opcja zawiera nazwę oraz rozmiar używanej na liście rodziny czcionki; (Helvetica,10)
- TabWidth - trzyma informację o szerokości tabulatora w pliku tekstowym; zakres dostępnych wartości to: 1...8
- UseExternalEditor - opcja włącza lub wyłącza użycie zewnętrznego edytora dla pliku tekstowego; wartość "true" spowoduje, że użyty zostanie zewnętrzny program, "false" oznacza wykorzystanie edytora wewnętrznego.
- ExternalEditor - mieści nazwę programu służącego jako zewnętrzny edytor, z absolutną ścieżką dostępu.
SyntaxHighlighting
Zawarte są tutaj informacje o sposobie kolorowania plików tekstowych.
Każda opcja zawiera typ pliku do kolorowania (np. HTML), znak "/", nazwę kontekstu kolorowania z przyrównaną wartością. Przykładowo opcja taka może wyglądać następująco :
"CC++/Key word=000000,Bold,",
gdzie:
"CC++" - typ pliku do kolorowania,
"Key word" - nazwa kontekstu kolorowania (tutaj jest to słowo kluczowe),
"000000" - wartość koloru dla (szesnastkowy format RRGGBB),
"Bold" - atrybut włączający wytłuszczanie pasującego słowa
Może tu jeszcze wystąpić po przecinku atrybut "Italic" oznaczający pochylenie pasującego słowa.
Dla typu "CC++" dostępne są następujące konteksty:
"Normal" (tzw. tekst normalny),
"String" (ciąg w cudzysłowach),
"Decimal_Value" (wartość dziesiętna),
"Extentions" (rozszerzenie języka, np. connect z biblioteki Qt),
"Comment" (komentarz), "Key word" (słowo kluczowe),
"Data type" (typ danej),
"Floating point" (liczba zmiennoprzecinkowa),
"Character" (znak w apostrofach),
"Base N Integer" (liczba typu "integer"),
"Preprocesor" (wywołania preprocesora).
Drugi aktualnie obsługiwany przez aplikację typ "HTML" obejmuje następujące konteksty:
"Normal",
"String",
"Decimal_Value",
"Comment",
"Key word",
"Data type".
Sekcje planowane
W przyszłości plik konfiguracyjny zawierał będzie także następujące sekcje:
"ImageFileView" - ustawienia dla podglądu plików z grafiką (jpg, png, gif i inne),
"SoundFileView" - ustawienia dla podglądu plików z muzyką (wav, mp3, ogg i inne),
"VideoFileView" - ustawienia dla podglądu plików zawierających wideo (avi, mpeg, i inne),
"BinaryFileView" - ustawienia dla podglądu plików w trybie binarnym.