home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 January / pcwk_01_1999.iso / Top100sh / Filemng / Far152pl / PL / MULTIARC / ARCPL.HLF next >
Text File  |  1998-07-21  |  14KB  |  373 lines
  1. // Archive Support plugin help file for FAR 1.52
  2. // Polish version by Paweê Pawlak/Color7 Productions
  3. //                   (a.k.a. Morris/F4CG)
  4. //                   mailto:morris@elysium.pl
  5. //                   http://AnkH.szczecin.mtl.pl/~morris
  6. //
  7. // added a short "defining new archive type" tutorial
  8. // dodaêem krótki kurs "definiowanie nowych typów archiwów"
  9.  
  10. .Language=Polish,Polski
  11. .PluginContents=Obsêuga archiwów
  12.  
  13. @Contents
  14. $^#Obsêuga archiwów#
  15.     Ten moduê FAR'a wykonuje operacje na archiwach. Pliki w archiwum
  16. sÑ obsêugiwane w ten sam sposób jakby znajdowaêy si⌐ w zwykêym katalogu
  17. na dysku. Podczas operacji na plikach w archiwum FAR przetwarza polecenia
  18. u╛ytkownika w odpowiadajÑce im operacje wykonywane przez program
  19. archiwizujÑcy.
  20.  
  21.    ~Dodawanie plików do archiwum~@AddToArc
  22.  
  23.    ~Rozpakowywanie plików z archiwum~@ExtrFromArc
  24.  
  25.    ~Polecenia~@ArcCmd
  26.  
  27.    ~Konfiguracja~@ArcCfg
  28.  
  29.    ~Linie poleceΣ archiwizerów~@ArcSettings
  30.  
  31.    ~Definiowanie nowych formatów~@DefiniujNowyFormat
  32.  
  33.    ~...~@:Morris
  34.  
  35. @AddToArc
  36. $ #Dodawanie plików do archiwum#
  37.     To okno dialogowe pozwala na wybranie archiwizera, dodanie lub
  38. zmian⌐ parametrów polecenia archiwizera (domyÿlne parametry definiuje
  39. si⌐ w oknie dialogowym ~linie poleceΣ archiwizatorów~@ArcSettings@),
  40. wprowadzenie hasêa zabezpieczajÑcego pliki.
  41.  
  42.     Opcja #UsuΣ pliki po archiwizacji# wymusza na programie archiwizujÑcym
  43. usuni⌐cie plików po pomyÿlnej archiwizacji.
  44.  
  45.     Przycisk #Zapisz ustawienia# zapisuje bie╛Ñce ustawienia w celu
  46. pó½niejszego wykorzystania jako wartoÿci domyÿlnych tego okna.
  47.  
  48. @ExtrFromArc
  49. $ #Rozpakowywanie plików z archiwum#
  50.     Tu mo╛na wprowadziå ÿcie╛k⌐, w której zostanÑ umieszczone rozpakowane
  51. pliki oraz wpisaå hasêo umo╛liwiajÑce rozpakowanie plików.
  52.  
  53.     Opcja #Rozpakuj bez ÿcie╛ek# wymusza rozpakowanie wszystkich plików
  54. do jednego katalogu.
  55.  
  56.     Aby rozpakowaå zaznaczone pliki do bie╛Ñcego katalogu mo╛na u╛yå
  57. kombinacji klawiszy #Alt-F6#.
  58.  
  59. @ArcCmd
  60. $ #Polecenia#
  61.     Z tego menu mo╛na wybraå testowanie archiwum, dodanie opisu
  62. archiwum, opcj⌐ konwersji archiwum na SamorozpakowujÑce-Si⌐
  63. (ang. #S#el#F#-e#X#tracting - stÑd skrót SFX), mo╛na spróbowaå naprawiå
  64. uszkodzone archiwum, zabezpieczyå archiwum przed uszkodzeniami (poprzez
  65. dodanie maêych pakietów danych) lub wyêÑczyå mo╛liwoÿå modyfikowania
  66. archiwum.
  67.  
  68.     Uwagi:
  69.  
  70.     1. Aby wykonaå polecenie trzeba posiadaå odpowiedni archiwizer, który
  71. obsêuguje dane polecenie. Opcje archiwizerów mo╛na ustawiå w oknie
  72. dialogowym ~Linie poleceΣ archiwizerów~@ArcSettings@.
  73.  
  74.     2. Peêny zestaw poleceΣ obsêugiwany jest tylko dla archiwów RAR.
  75. Inne archiwizery obsêugujÑ tylko niektóre z tych poleceΣ.
  76.  
  77. @ArcCfg
  78. $ #Konfiguracja obsêugi archiwów#
  79.     To okno dialogowe pozwala zmieniå nast⌐pujÑce parametry:
  80.  
  81.  #Sposób wyÿwietlania#      WêÑczenie ukrywania komunikatów
  82.  #komunikatów archiwizera#  archiwizera powoduje, ╛e na ekranie
  83.                           nie b⌐dzie wyÿwietlane to, co generuje
  84.                           archiwizer podczas wykonywania operacji
  85.                           na archiwum
  86.  
  87.  #Przetwarzaj polecenie#    WêÑczenie tej opcji powoduje, ╛e
  88.  #Shift-F1#                 naciÿni⌐ciem kombinacji Shift-F1 mo╛na
  89.                           dodawaå pliki do archiwum. 
  90.                             WyêÑczenie tej opcji mo╛e si⌐ okazaå
  91.                           przydatne w przypadku, gdy zainstalowany
  92.                           jest inny plugin obsêugujÑcy archiwa,
  93.                           który obsêuguje kombinacj⌐ Shift-F1.
  94.  
  95.  #Nazwy plików#             Nazwy ~plików opisów~@:DescFiles@ opisujÑcych pliki
  96.  #z opisami#                znajdujÑce si⌐ w archiwum.
  97.  #oddzielone przecinkami#
  98.  
  99.  #Czytaj opisy archiwów#    Powoduje, ╛e FAR odczytuje opisy plików
  100.                           znajdujÑcych si⌐ w archiwum podczas
  101.                           wchodzenia do archiwum. Opcja ta umo╛liwia
  102.                           wyÿwietlanie opisów plików, lecz spowalnia
  103.                           odczyt archiwum.
  104.  
  105.  #Aktualizuj opisy#         Aktualizuje opisy plików znajdujÑcych si⌐
  106.  #archiwów#                 w archiwum po dodaniu lub usuni⌐ciu plików.
  107.  
  108. @ArcSettings
  109. $ #Linie poleceΣ archiwizatorów#
  110.     W tym miejscu mo╛na zmieniå linie poleceΣ archiwizerów.
  111.  
  112.     Nast⌐pujÑce zmienne mogÑ byå u╛yte:
  113.  
  114.  %%A - nazwa archiwum
  115.  
  116.  %%a - krótka nazwa archiwum
  117.  
  118.  %%W - katalog tymczasowy 
  119.        zmienna powinna zawieraå na koΣcu znak \
  120.  
  121.  %%P - hasêo
  122.  
  123.  %%L - nazwa ~listy plików~@:ListFile
  124.  
  125.  %%l - lista plików z krótkimi nazwami plików
  126.  
  127.  %%F - nazwa jednego lub kilku plików do przetworzenia. Jeÿli
  128.        wszystkie nazwy nie mogÑ byå na raz umieszczone w jednym
  129.        poleceniu, archiwizer b⌐dzie wywoêywany tyle razy, a╛
  130.        zostanÑ przetworzone wszystkie wyspecyfikowane pliki.
  131.        Domyÿlnie maksymalnÑ wielkoÿciÑ polecenia (êÑcznie z nazwÑ
  132.        archiwizera) jest 127 znaków, lecz mo╛na to zmieniå
  133.        bezpoÿrednio za zmiennÑ %%F, np. %%F512.
  134.         Zmienna %%F powinna byå u╛ywana tylko w przypadku, gdy
  135.        archiwizer nie obsêuguje ~listy plików~@:ListFile@
  136.  
  137.  %%f - nazwa pojedynczego pliku do przetworzenia. Archiwizer b⌐dzie
  138.        wywoêywany tyle razy a╛ skoΣczÑ si⌐ nazwy plików.
  139.         Ta zmienna powinna byå u╛ywana tylko w przypadku gdy 
  140.        archiwzer nie obsêuguje ~listy plików~@:ListFile@ lub wielu nazw plików
  141.        w linii poleceΣ.
  142.  
  143.  %%E<errorlevel> - maksymalna wartoÿå zmiennej #ERRORLEVEL#, która
  144.        nie jest traktowana jako bêÑd archiwizera. Na przykêad %%E2
  145.        informuje, ╛e wartoÿci zmiennej ERRORLEVEL 0, 1 oraz 2 nie
  146.        sÑ wynikiem bê⌐du. Ta zmienna mo╛e zostaå umieszczona w
  147.        dowolnym miejscu polecenia. Jeÿli jej nie b⌐dzie, wszystkie
  148.        wartoÿci zmiennej ERRORLEVEL wi⌐ksze od #0# b⌐dÑ traktowane
  149.        jako bêÑd zwrócony przez archiwizer.
  150.  
  151.     Modyfikatory zmiennych #Q#, #q#, #S#, #M#, #N#, #*#, #W#, #P# mogÑ byå u╛yte
  152. w celu modyfikacji formatu nazw plików:
  153.  
  154.    'Q' - nazwy plików zawierajÑce spacje umieÿå pomi⌐dzy znakami " "
  155.    'q' - umieÿå wszystkie nazwy pomi⌐dzy znakami " "
  156.    'S' - u╛yj '/' zamiast '\' w ÿcie╛kach
  157.    'M' - przeka╛ nazwy katalogów do archiwizera jako 
  158.          'nazwa_katalogu\*.*'
  159.    'N' - przeka╛ nazwy katalogów do archiwizera jako 'nazwa_katalogu'
  160.    '*' - u╛yj maski '*' do zaznaczenia wszystkich plików.
  161.          Ten modyfikator ma priorytet nad paremetrem
  162.          "Maska "Wszystkie pliki"" dla pojedynczego polecenia
  163.          archiwizera
  164.    'W' - tylko nazwa pliku, bez ÿcie╛ki
  165.    'P' - tylko ÿcie╛ka, bez nazwy pliku
  166.    'A' - format ANSI
  167.  
  168.     Modyfikatory mogÑ byå umieszczone bezpoÿrednio za zmiennymi %%F, %%f,
  169. %%L lub %%l (bez oddzielajÑcych spacji). Mo╛na umieÿciå kilka modyfikatorów,
  170. np. prawidêowe sÑ nast⌐pujÑce parametry: %%LMN lub %%F*QSN128. Jeÿli ╛aden
  171. z modyfikatorów 'M' lub 'N' nie zostanie u╛yty, domyÿlnie u╛yty zostanie
  172. modyfikator 'N'. Jeÿli u╛yte zostanÑ oba, do archiwizera zostanÑ przekazane
  173. zarówno 'nazwa_katalogu' jak i 'nazwa_katalogu\*.*'
  174.  
  175.     Jeÿli cz⌐ÿå polecenia zewn⌐trznego archiwizera zostanie uj⌐ta w nawiasy
  176. {  }, zostanie doêÑczona do polecenia tylko je╛eli b⌐dzie zawieraå co najmniej
  177. jednÑ niepustÑ zmiennÑ z opisanych powy╛ej.
  178.  
  179.     Jeÿli zewn⌐trzny archiwizer nie obsêuguje danego polecenia,
  180. odpowiadajÑcy mu ciÑg znaków nale╛y pozostawiå pusty.
  181.  
  182. @DefiniujNowyFormat
  183. $^#Inne formaty archiwów#
  184. $^~(opis - Paweê Pawlak/Color7 Productions)~
  185.     Mo╛na samemu zdefiniowaå nowy format archiwum. Aby tego dokonaå nale╛y:
  186.  
  187.   #1.# mieå jedno lub wi⌐cej archiwów nowego typu (takiego, którego FAR
  188.      nie obsêuguje)
  189.  
  190.   #2.# mieå program do rozpakowywania i/lub archiwizacji
  191.      cz⌐sto archiwizer potrafi rozpakowaå archiwum, które stworzy,
  192.      czasem jednak trzeba mieå dwa programy (tak jest np. w przypadku
  193.      ZIP'a - do archiwizacji sêu╛y ZIP.EXE, do rozpakowywania
  194.      UNZIP.EXE).
  195.       W tym przypadku wa╛niejsze jest posiadanie programu zdolnego
  196.      rozpakowaå dane archiwum.
  197.   
  198.     Kiedy ju╛ mamy te dwa elementy, nale╛y si⌐ dowiedzieå jakie polecenie
  199. programu wyÿwietla zawartoÿå archiwum. Nale╛y je sobie zapisaå (b⌐dzie
  200. pó½niej potrzebne). B⌐dÑ te╛ potrzebne polecenia pozwalajÑce na
  201. rozpakowanie archiwum, archiwizowanie plików itp. Czyli wszystkie
  202. operacje, jakie mo╛e wykonaå archiwizer. Nale╛y wynotowaå wszystkie
  203. opcje.
  204.  
  205.     Teraz trzeba wylistowaå archiwa i zanotowaå charakterystyczne napisy
  206. pojawiajÑce si⌐ w listingu - w którym momencie pojawiajÑ si⌐ nazwy (i
  207. ewentualne atrybuty) plików oraz jaki majÑ format. Nale╛y zanotowaå ciÑg
  208. znaków, który poprzedza nazwy plików i który je koΣczy. W przypadku
  209. archiwizera #ACB# (Associative Coder by George Buyanovsky) listing archiwum
  210. wyglÑda tak:
  211.  
  212. @-
  213. #Contents of archive  3.acb:#
  214. #Size        Date    Time   Attr  Name#
  215. #bytes     mm:dd:yy  hh:mm  ahrs#
  216.                                                       
  217. #11776     05:15:97  18:58  a...  ENFORCER\LOCKCTRL.EXE#
  218. #171008    04:10:98  21:46  a...  ENFORCER\ENFRUN.EXE#
  219. #243200    05:03:98  07:31  a...  ENFORCER\ENFSET.EXE#
  220. #169128    04:11:98  17:02  a...  ENFORCER\ENFRUN.HLP#
  221. #9824      04:11:98  17:12  a...  ENFORCER\README.TXT#
  222. #5908      07:28:96  20:35  a...  ENFORCER\BOOM.WAV#
  223. #11586     07:11:95  09:50  a...  ENFORCER\DING.WAV#
  224. #27516     07:11:95  09:50  a...  ENFORCER\TADA.WAV#
  225.                                                       
  226. #Total ... 649946 bytes ( 8 file(s) )#
  227.  
  228. @+
  229.     Charakterystyczne elementy to:
  230.  
  231.  1. nagêówek, którego ostatnia linia poprzedza listing plików. 
  232.     charakterystycznym ciÑgiem b⌐dzie np. ~hh:mm  ahrs~.
  233.  2. stopka, która wyst⌐puje po listingu plików.
  234.     charakterystycznym ciÑgiem b⌐dzie ~Total ...~
  235.  
  236.     Oba ciÑgi nale╛y sobie zanotowaå.
  237.  
  238.     Nast⌐pnie mo╛na u╛ywajÑc jakiegoÿ podglÑdu plików (np. podglÑdu FAR'a)
  239. podejrzeå pierwsze kilkadziesiÑt bajtów archiwum. UWAGA: trzeba u╛yå
  240. formatu szesnastkowego - podglÑd FAR'a przeêÑcza si⌐ w ten tryb klawiszem
  241. F4. Czego nale╛y szukaå? Jakichÿ szczególnych bajtów wyst⌐pujÑcych we
  242. wszystkich archiwach tego typu w tym samym miejscu. Mo╛e to byå jeden
  243. bajt lub wi⌐cej. Je╛eli takie znajdziemy, nale╛y je zapisaå - przydadzÑ
  244. si⌐ pó½niej. Trzeba te╛ zapisaå, w którym miejscu archiwum bajty te
  245. wystepujÑ - WA╜NE!
  246.     W naszym przykêadzie - archiwizer ACB - takim znakiem szczególnym
  247. b⌐dÑ dwie liczby #szesnastkowe# ~wyst⌐pujÑce jedna za drugÑ~ - #80# i #10#,
  248. a znajdujÑ si⌐ one od #drugiego# bajtu archiwum - czyli bajtu #numer 1#
  249. (bajty liczy si⌐ od zera - bajt pierwszy ma numer 0, drugi 1, trzeci 2 itd.).
  250.  
  251.     Zajmijmy si⌐ teraz formatem danych. Tu format jest podany w wyÿwietlonym
  252. nagêówku. I tak kolejno:
  253.  
  254. @-
  255. ~11776     05:15:97  18:58  a...  ENFORCER\LOCKCTRL.EXE~
  256. └───┬───┘ └──┬───┘  └─┬─┘  └┬─┘  └───────┬─────────────
  257.     │        │        │     │            │
  258.     │        │        │     │         #? znaków# - nazwa pliku
  259.     │        │        │     │
  260.     │        │        │  #4 znaki# - atrybuty pliku
  261.     │        │        │
  262.     │        │     #5 znaków# - czas pliku w formacie gg:mm
  263.     │        │                (godzina:minuta)
  264.     │        │
  265.     │     #8 znaków# - data pliku w formacie mm:dd:rr
  266.     │                (miesiÑc:dzieΣ:rok)
  267.     │
  268.  #9 znaków# - oryginalny rozmiar pliku (archiwizer nie podaje
  269.             rozmiaru pliku po kompresji)
  270. @+
  271.  
  272.     Podsumujmy co mamy:
  273.     1. rozszerzenie archiwum - #acb#
  274.     2. identyfikator archiwum - dwie liczby - #80 10#
  275.     3. ró╛ne polecenia archiwizatora
  276.     4. charakterystyczny ciÑg nagêówka - #hh:mm  ahrs#
  277.     5. charakterystyczny ciÑg stopki - #Total ...#
  278.     6. format listingu plików
  279.  
  280.     Teraz te wszystkie informacje trzeba zapisaå do pliku #custom.ini#
  281. znajdujÑcego si⌐ w katalogu #Plugins\MultiArc\Formats#. Plik ma pewien
  282. okreÿlony format, który nale╛y przestrzegaå.
  283.     I tak po kolei:
  284.  
  285. @-
  286.  definiujemy nowy typ. Numer typu - kolejny wolny.
  287. #[Type4]#
  288.  
  289.  nazwa typu
  290. #TypeName=ACB#
  291.  
  292.  identyfikator archiwum
  293. #ID=80 10#
  294.  
  295.  pozycja identyfikatora w archiwum
  296. #IDPos=1#
  297.  
  298.  rozszerzenie pliku
  299. #Extension=acb#
  300.  
  301.  polecenie generujÑce listing
  302. #List="acb l"#
  303.  
  304.  lista plików zaczyna si⌐ PO linii zawierajÑcej ciÑg...
  305. #Start="hh:mm  ahrs"#
  306.  
  307.  lista plików koΣczy si⌐ bezpoÿrednio PRZED liniÑ zawierajÑcÑ ciÑg...
  308. #End="^Total ..."#
  309.  ~UWAGA! Poniewa╛ ciÑg~ Total ... ~znajduje si⌐ ZAWSZE NA POCZñTKU linii~
  310.         ~parametr~ End ~zawiera znak ~#^#~ przed wêaÿciwym poszukiwanym~
  311.         ~ciÑgiem, co jest sygnaêem, ╛e ciÑg ma byå poszukiwany TYLKO~
  312.         ~od poczÑtku linii.~
  313.  
  314.  format listy plików 
  315.     Znaczenie poszczególnych znaków opisu formatu:
  316.         n   - nazwa pliku
  317.         .   - usuΣ koΣcowe spacje z nazwy pliku i doêÑcz kropk⌐
  318.         z   - rozmiar oryginalny
  319.         p   - rozmiar po kompresji
  320.         d   - dzieΣ
  321.         t   - miesiÑc
  322.         TTT - trzyliterowa nazwa miesiÑca (Jan, Feb, Mar, ...)
  323.         y   - rok
  324.         h   - godzina
  325.         H   - modyfikator godziny (a - a.m. (przed poêudniem),
  326.                                    p - p.m. (po poêudniu))
  327.         m   - minuty
  328.         s   - sekundy
  329.         a   - atrybuty
  330.         *   - pomiΣ a╛ do pierwszej spacji lub koΣca linii
  331.  
  332. #Format0="zzzzzzzzz tt:dd:yy  hh:mm  aaaa  nnnnnnnnnnnnnnnnnnnnnnnnnn"#
  333.  
  334.  i na koniec definicje poleceΣ:
  335.  (parametry majÑ takie samo znaczenie jak w oknie dialogowym
  336.   ~Linie poleceΣ archiwizerów~@ArcSettings@)
  337.      Rozpakuj
  338. #Extract=acb r{%%P} %%a#
  339.      Rozpakuj bez ÿcie╛ek
  340. #ExtractWithoutPath=acb r{%%P} %%a#
  341.      Testuj
  342. #Test=#
  343.      UsuΣ
  344. #Delete=#
  345.      Opisz archiwum
  346. #Comment=#
  347.      Opisz pliki
  348. #CommentFiles=#
  349.      Konwertuj na SFX
  350. #SFX=#
  351.      Zamknij (lock) archiwum
  352. #Lock=#
  353.      Zabezpiecz archiwum
  354. #Protect=acb p{%%P}#
  355.      Napraw archiwum
  356. #Recover=acb c{%%P}#
  357.      Dodaj pliki
  358. #Add=acb u %%a %%F#
  359.      Przenieÿ pliki
  360. #Move=#
  361.      Dodaj pliki i katalogi
  362. #AddRecurse=acb u %%a %%F#
  363.      Przenieÿ pliki i katalogi
  364. #MoveRecurse=#
  365.      Maska "Wszystkie pliki"
  366. #AllFilesMask="*.*"#
  367. @+
  368.  
  369.     Po zdefiniowaniu nowego typu nowy archiwizer pojawi si⌐ w menu
  370. ~Opcje|Konfiguracje pluginów|Obsêuga archiwów: linie poleceΣ~.
  371.     I to wszystko jeÿli chodzi o definiowanie nowych typów archiwów.
  372. Informacje o kilku innych parametrach definicji znajdujÑ si⌐ w pliku
  373. #custom.ini#.