web2png.1
上传用户:sorock1981
上传日期:2007-01-06
资源大小:73k
文件大小:4k
源码类别:

图片显示

开发平台:

Unix_Linux

  1. .TH WEB2PNG 1 "6 October 1999"
  2. .SH NAME
  3. web2png - convert a web tree from using GIFs to using PNGs
  4. .SH SYNOPSIS
  5. web2png [-adnrv] [directory...]
  6. .SH DESCRIPTION
  7. Web2png is a front end for gif2png(1) that automatically converts
  8. entire web page hierarchies from using GIFs to using PNGs.  It does
  9. image conversion and patches IMG SRC references in web pages.
  10. The arguments to web2png must be directories; if none are given,
  11. the current directory is assumed.
  12. In each directory, web2png tries to convert every GIF to a PNG.  It
  13. leaves alone GIFs that have either multiple images or transparency,
  14. because these will not display properly in current browsers.  It also
  15. does not reconvert GIFs that already have corresponding PNGs (e.g. the
  16. same name except for the .gif file extension).  The original GIFs are
  17. left in place.
  18. Web2png tracks successful conversions.  It then looks at each HTML,
  19. secure HTML, HTML inclusion, PHP page, JavaScript program or Cascading
  20. Style Sheet under the argument directories (extensions html, shtml,
  21. .inc, .php, .js, .css). In these pages, it fixes each reference to
  22. each successful converted GIF to point at the PNG.  References in
  23. relative HREF and BACKGROUND tags are recognized by filename and fixed
  24. (any base directory declared by a BASE tag will be be prepended to the
  25. relative URL).  References that are HTTP URLs are matched against the
  26. list of convertible GIFs by basename; if there is such a match, the
  27. contents of the URL is retrieved and compared to the convertible GIF.
  28. If both basename and data match, the HTTP reference is fixed.
  29.  
  30. If the pages are under RCS version control, they're checked out for
  31. modification before being altered; otherwise, a copy of the original
  32. of each modified web page is left in the same directory, with the
  33. additional extension .bak.
  34. Two options change the behavior of the program:
  35. .TP
  36. .B -a
  37. Convert all GIF files, including those with multiple images and/or
  38. transparency.
  39. .TP
  40. .B -d
  41. Delete originals.  Removes all GIFs with corresponding PNGs, and all
  42. &.bak files.
  43. .TP
  44. .B -n
  45. Make no changes.  With this option, web2png reports on what needs to
  46. be done (and on GIFs that use transparency or have multiple images),
  47. but neither converts GIFs nor touches web pages.
  48. .TP
  49. .B -r
  50. Reverse.  Restore all HTML/SHTML/PHP pages from the .bak files created
  51. by a previous run (or, if the files were under version control, revert
  52. them).  Remove PNGs with corresponding GIFs.
  53. .TP
  54. .B -v
  55. Verbose.  Utter more trace information about the conversion process.
  56. Web2png can be run on a directory that has already been partly
  57. converted by previous runs; it will do the minimum necessary 
  58. amount of work.  The changes it makes will be fully reversible with -r 
  59. until you run it in -d mode.
  60. Web2png is written in Python.  Python 1.5.2 or better must be
  61. installed and accessible on your system in order for web2png to run.
  62. .SH NOTE
  63. Sometimes it's possible to convert transparent GIFs without altering
  64. the appearance of the page, by knowing from context that they will
  65. always place within an area of fixed and solid color.  Web2png can't 
  66. deduce when this will be, so it doesn't try; but it may be useful 
  67. to apply gif2png with the -b option by hand.
  68. .SH KNOWN PROBLEMS
  69. The algorithm for fixing HTTP URLs is not foolproof. It could be
  70. confused into incorrectly patching an HTTP URL reference to a GIF into
  71. an invalid reference to a PNG if the GIF matches a local target GIF by
  72. both basename and binary content, but actually lives on another host.
  73. This program does not automatically convert CGIs; you'll have to do
  74. that by hand.  Other dynamic-content methods (such as server-side
  75. inclusions) may also require hand-hacking.
  76. The program cannot tell converted from preexisting PNGs; if you have
  77. PNGs with the same stem name as corresponding GIFs but carrying
  78. different information, the -r mode will clobber them.
  79. .SH SEE ALSO
  80. gif2png(1)
  81. .SH AUTHORS
  82. Eric S. Raymond <esr@thyrsus.com>, October 1999.