home *** CD-ROM | disk | FTP | other *** search
/ RComp HTML Edit Studio for RISC OS / RComp HTML Edit Studio for RISC OS.iso / MANUAL / SITEM / PUBLISH / MANUAL.TXT next >
Encoding:
Text File  |  2000-08-24  |  4.2 KB  |  122 lines
  1. !Publish v2.00 and later
  2. ========================
  3.  
  4. Please note that !Publish is a fairly technical tool, and is probably
  5. not of immediate use to users who are new to web page creation.
  6.  
  7. HTMLEdit allows you to create pages with "dynamic content", that is,
  8. pages which contain references to other files, or variable information
  9. such as version numbers, current date/time etc.  HTMLEdit includes a
  10. "publish" option which will expand this dynamic content, filling it
  11. in to produce a complete page.
  12.  
  13. !Publish is designed to do the same thing, but on a site wide basis.
  14.  
  15.  
  16. Understanding "Dynamic Content"
  17. -------------------------------
  18.  
  19. Although most customers will be using HTMLEdit to build pages, and
  20. will hence have menu options to automate this process, it is worth
  21. briefly describing what we're talking about.
  22.  
  23. The system allows pages to include information which may change on
  24. a regular basis including date, time, version and (most usefully)
  25. shared blocks of text/HTML etc.
  26.  
  27. These "dynamic" bits are included via comments in your HTML, thus
  28. each command is enclosed in <!-- and --> wrappers.
  29.  
  30. The actual dynamic commands themselves each start with an @ sign:
  31.   
  32.   @DATE   this would be replaced by the current date when published
  33.   
  34.   @TIME   this would be replaced by the current time when published
  35.   
  36.   @VERSION    this would prompt you for a version number
  37.   
  38.   @TEXT filename      The file (a RISC OS filename eg. ADFS::4.$.Text)
  39.                       would be inserted when published.
  40.                       
  41. So an example might be:
  42.   
  43.   <!-- @TEXT ADFS::4.$.WebSite.Files.MyText -->
  44.   
  45. As you can see, there's nothing magical to this, so you can create
  46. these tags yourself without HTMLEdit, but naturally HTMLEdit simplifies
  47. the process (and can also publish pages itself).
  48.  
  49.  
  50.  
  51. By sharing things across a number of pages, you can rapidly change
  52. things across the whole site just by changing one file.  Since this
  53. is done *before* uploading your pages to your web site, it will work
  54. on all browsers, and all web servers, and your users/customers will
  55. never know you are using the system!
  56.  
  57.  
  58. If you use !Publish 2 with scripts, you can also copy in (and publish
  59. at the same time) directories or files from other parts of your hard
  60. disc, or from a network, thus drawing together work that others are
  61. doing to form the complete web site.
  62.  
  63.  
  64. As we said above, this is not for those taking their first steps in
  65. Web Authoring, but when used correctly !Publish 2 is an extremely
  66. powerful tool, which adds a new level of scope and automation to
  67. the web design process.
  68.  
  69.  
  70.  
  71.  
  72. Getting started
  73. ----------------
  74.  
  75. You can drag an HTML file, a directory of files, or a script onto the
  76. !Publish icon (or double click a script) to do this.
  77.  
  78. Dragging an HTML file will publish it in much the same way HTMLEdit
  79. does.
  80.  
  81. Dragging a directory will cause each file in that directory to be
  82. "published".  For HTML files, this is just as described above.  For
  83. text files, images and archives (zips etc.), the files are copied
  84. in to the destination directory.  The exact behaviour for these files
  85. can be set in the choices.
  86.  
  87. Scripts
  88. -------
  89.  
  90. A script file (type &AB3 aka "PbScript") or text file dragged onto
  91. the icon will be parsed for "in/out pairs", allowing you to publish
  92. a whole site, merging in resources from all over your hard disc to
  93. produce the final site.  The actions applied to each "in file/directory"
  94. are exactly as if you had dragged to the iconbar, making it easy to
  95. include directories full of files for inclusion.
  96.  
  97. A script will have one or more lines, each taking the form:
  98.   
  99.   <source file/directory>  <destination file/directory>
  100.   ad infinitum...
  101.   
  102. Eg.
  103.  
  104.    ADFS::4.$.Work.TempSite ADFS::4.$.Website
  105.    ADFS::4.$.Work.Images.Temp ADFS::4.$.Website.Images
  106.    Etc.
  107.    
  108. A script of type &AB3 can be double clicked on to launch !Publish
  109. (if needed) and run the script.  This makes it easy to build a
  110. script for the whole of each site you maintain.  If you are a
  111. programmer, think of it as a "makefile" for the site.
  112.  
  113. Date and Time format
  114. --------------------
  115.  
  116. The date and time functions use the system variables HTMLEdit$dateformat
  117. and HTMLEdit$timeformat respectively.  These are set in the !Run file,
  118. and allow you to adjust the date and time formats to your own house
  119. style.
  120.    
  121.  
  122.