PublishContrib < TWiki

TWiki Web>PublishContrib (2020-05-19, TWikiAdminUser) (raw view)
---+!! <nop>%TOPIC%
*Generates a static view of a web in the following ways: (options depend on configuration)*
%IF{"{PublishContrib}{FormatAllowed}{file}" then="   * HTML files in a directory" else=<nop>"}%
%IF{"{PublishContrib}{FormatAllowed}{zip}" then="   * a zip archive file" else=<nop>"}%
%IF{"{PublishContrib}{FormatAllowed}{tgz}" then="   * a tgz archive file" else=<nop>"}%
%IF{"{PublishContrib}{FormatAllowed}{pdf}" then="   * a =PDF=" else="<nop>"}%
%IF{"{PublishContrib}{FormatAllowed}{ftp}" then="   * HTML files uploaded directly to an FTP server" else="<nop>"}%
<!--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail the author.
   
   * Set STUB = %$STUB%
   * Set SHORTDESCRIPTION = Generate static output (HTML, PDF) for a TWiki Web and optionally upload (FTP) the output to a publishing site.
-->
<script type="text/javascript">
// <![CDATA[
function resetWeb() {
    document.publish.web.value = '';
}
function prepPublish(form) {
    var format = '';
    var options = form.format.options;
    for ( var i = 0 ; i < options.length ; i++ ) {
        if ( options[i].selected ) {
            format = options[i].text;
        }
    }
    if ( format == '' ) {
        return false;
    }
    var skin = form.publishskin.value.replace(/ /g, '');
    if ( format == 'pdf' ) {
        skin = 'text';
    }
    else if ( skin == '' ) {
        skin = 'text';
    }
    form.publishskin.value = skin;
    var web = form.web.value.replace(/ /g, '');
    if ( web == '' ) {
        options = form.webselect.options;
        for ( var i = 0 ; i < options.length ; i++ ) {
            if ( options[i].selected ) {
                web = options[i].text;
	    }
        }
    }
    form.web.value = web;
    if ( web == '' ) {
        return false;
    }
    else {
        return true;
    }
}
// ]]>
</script>

_Previously known as !GenHTMLAddOn, and then !PublishAddOn, this is the *original* publishing extension for TWiki_.

<div class="twikiAlert"> __NOTE:__ This extension is designed to work with TWiki 4.0 and later. You can use revision 1 of the attached zip file if you want to use the extension with an earlier version of TWiki, but it is missing many features and bugfixes.</div>

<img src="%ATTACHURLPATH%/publish.gif" style="float:right" />
!PublishContrib provides support for the generation of stand-alone HTML from a TWiki web. It will generate fully rendered versions of a set of TWiki pages together with any attached files.

%TOC%

When TWiki generates a view, it does so dynamically i.e. there's a CGI script that runs, processes some files, and generates HTML that is displayed by the browser. There are circumstances in which this may not be desirable or even possible. For example:
	1 TWiki is used to create documentation which has to be bundled into a product release
	1 Published versions of TWiki pages must be read-only
	1 The TWiki server is inaccessible to the audience (e.g. on the other side of a corporate firewall)

---++ Features
	* All standard TWiki tags are interpreted
	* Plugins are called
	* Unresolved links to non-existent topics are silently ignored
	* Topic links internal to the TWiki are translated to relative links
	* Powerful support for choosing what content gets published
	* Any links to the 'pub' areas of topics in the web are automatically resolved and the referenced files copied
	* Any links to images outside the TWiki are resolved, and the image is stored in the output (requires LWP)
	* Output in HTML or PDF. HTML can be compressed in different archive formats.
	* Full support for hierarchical webs
	* Multiple instances (e.g. dev, test, prod) can be specified
	* Special output format specific templates (such as viewpdf) can be used
	* Able to publish HTML and referenced files directly to a remote server via ftp
    * Complete history of what was published, and when!

---++ Usage
---+++ Publish Form
The easiest way to publish a web is from this topic, by filling in the following form.

The output is generated in a directory designated during installation. The progress messages printed during documentation generation tell you exactly where the output is, and you can use the [[%SCRIPTURLPATH{"publish"}%?control=1;skin=basic_publish][publishers control interface]] to manage your published output.

Publishing is a controlled process; before you can publish, you have to have VIEW access to the topics you want to publish, and CHANGE access to the publishing history topic.

You can also create a [[#PublishTopic][permanent topic in a web]] to help with the publishing process.

<style type="text/css" media="all">
.twikiPageForm table th,
.twikiPageForm table td {
vertical-align:top;
border-bottom:1px solid #ddd;
padding:.5em;
}
</style>

<div class="twikiPageForm">
<form method="POST" name="publish" action="%SCRIPTURL{publish}%/%URLPARAM{"web" default=""}%" onsubmit="return prepPublish(this);">
<table class="twikiTable" cellpadding="0" cellspacing="0">
<tr>
  <th colspan="3">Choose what to publish</th>
</tr>
<tr>
  <td width="200"> Web to publish </td>
  <td>
   <select name="webselect" class="twikiSelect" onchange="resetWeb();">%WEBLIST{"<option $marker value='$name'>$name</option>" webs="cancopyto" selection="%URLPARAM{"web" default="%BASEWEB%"}%"}%</select> select or enter:
   <input name="web" class="twikiInputField" size="48"/>
  </td>
  <td>
   =web=
  </td>
</tr>
<tr>
  <td> 
    Comma-separated list of [[%SCRIPTURLPATH{view}%/%BASEWEB%/%BASETOPIC%#WildcardPattern][wildcard patterns]] that match
    the names of topics to *include*.
  </td>
  <td> 
    <input type="text" name="inclusions" class="twikiInputField" value="%URLPARAM{"inclusions" default="*"}%" size="100"/><br />Use * for all topics.
    You can [[%SCRIPTURLPATH{view}%/%BASEWEB%/%BASETOPIC%#TopicOrder][specify order of topics]] using semicolon
  </td>
  <td>
   =inclusions=
  </td>
</tr>
<tr>
  <td> 
    Comma-separated list of [[%SCRIPTURLPATH{view}%/%BASEWEB%/%BASETOPIC%#WildcardPattern][wildcard patterns]] that match
    the names of topics to *exclude*.
  </td>
  <td> 
    <input type="text" name="exclusions" class="twikiInputField" value="%URLPARAM{"exclusions" default=""}%" size="50"/><br />Leave blank to include all topics.
  </td>
  <td>
   =exclusions=
  </td>
</tr>
<tr>
  <td> 
    Name of a topic that contains a TWiki table, each row of which maps a topic names to the version of that topic to publish. 
  </td>
  <td> 
    <input type="text" name="versions" class="twikiInputField" value="%URLPARAM{"versions" default=""}%" size="50"/><br />Leave blank to publish the most recent version of each topic. The table can be generated by a %SEARCH or other TWiki variable. For example: =| Web.<nop>TopicName | 1.33 |=. If a topic does not appear in the table, the most recent version will be published.
  </td>
  <td>
   =versions=
  </td>
</tr>
<tr>
  <td> 
    A [[%SCRIPTURLPATH{view}%/%BASEWEB%/%BASETOPIC%#RegularExpression][regular expression]] that will cause a topic to be
    *excluded* if the RE matches the topic content.
  </td>
  <td> 
    <input type="text" name="filter" class="twikiInputField" value="%URLPARAM{"filter" default=""}%" size="50" /><br />Leave blank to include all topics.
  </td>
  <td>
   =filter=
  </td>
</tr>
<tr %IF{"{PublishContrib}{PluginControl}" else="style='display:none'"}%>
  <td> 
    Comma-separated list of Plugins to enable during publish.
  </td>
  <td> 
    <input type="text" name="enableplugins" class="twikiInputField" value="%URLPARAM{"enableplugins" default=""}%" size="50"/><br /> Leave blank to enable all plugins. You are recommended to disable any plugins that generate buttons in the output.<br />
    The currently enabled plugins are: %ACTIVATEDPLUGINS%
  </td>
  <td>
   =enableplugins=
  </td>
</tr>
<tr>
  <th colspan="3">Output options</th>
</tr>
<tr>
  <td>Select skin for published HTML</td>
  <td>
    <input type="text" name="publishskin" class="twikiInputField" size="20" value="plain" /><br />
    The skin provides the template for how topics are published. See %TWIKIWEB%.TWikiSkins for more informations on skins.<br />
    You are recommended to pick =basic_publish=, or =plain=, or a =print= skin.
    Your installation may also offer a special =export= or =publish= skin.<br />%I% The =view= [[TWikiTemplates][template]] is used to generate published pages, so =view.%URLPARAM{"skin" default="basic_publish"}%.tmpl= is the template that will be used to generate the output. You can preview any topic in this skin simply by appending =?skin=%URLPARAM{"skin" default="basic_publish"}%= to the end of the view URL. Note that the standard =VIEW_TEMPLATE= template override still works when publishing.
  </td>
  <td>
   =publishskin=
  </td>
</tr>
<tr>
  <td>Output format</td>
  <td>
   <select name="format" class="twikiSelect">
%IF{"{PublishContrib}{FormatAllowed}{zip}" then="<option value='zip'>zip</option>" else="<nop>}%
%IF{"{PublishContrib}{FormatAllowed}{tgz}" then="<option value='tgz'>tgz</option>" else="<nop>}%
%IF{"{PublishContrib}{FormatAllowed}{file}" then="<option value='file'>file</option>" else="<nop>}%
%IF{"{PublishContrib}{FormatAllowed}{pdf}" then="<option value='pdf'>pdf</option>" else="<nop>}%
%IF{"{PublishContrib}{FormatAllowed}{ftp}" then="<option value='ftp'>ftp</option>" else="<nop>}%
   </select><br />
    The output will be generated on the server. You can manage the
    contents of the server directory from the browser using the [[%SCRIPTURLPATH{"publish"}%?control=1;skin=basic_publish][publishers control interface]]<br />
    %X% The rendered data can get pretty big, and the process itself puts
   a heavy load on the server, especially when using compression on large webs.
  </td>
  <td> =format= </td>
</tr>
<tr>
  <td>Attachment list</td>
  <td>
    <input type="checkbox" name="attachmentlist" value="1"/> Include the attachment list in the generated page if the topic has one or more attachments.<br />
    %I% By default, the attachment list is not included in the generated page.
    If you have attachment files not linked from a topic text, and you want to
    include those attachments in the published web, you need to check this.<br/>
    %IF{"{PublishContrib}{FormatAllowed}{pdf}" then="This is irrelevant for the PDF format because a generated PDF file cannot have attachment files included." else="<nop>"}%
  </td>
  <td> =attachmentlist= </td>
</tr>
<tr>
  <td>Publishing history topic</td>
  <td>
    <input type="text" name="history" class="twikiInputField" size="50" value="PublishContribHistory" /><br />
    This is where the history of your publishing is stored. Each time you publish, this topic is re-written with the log of the publishing process. You have to have "change" access to this topic. You can specify a topic in another web using the standard Web.Topic syntax.
  </td>
  <td>
   =history=
  </td>
</tr>
<!-- "file" output format options -->
<tr %IF{"{PublishContrib}{FormatAllowed}{file}" else="style='display:none'"}%>
  <th colspan="3">FILE options</th>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{file}" else="style='display:none'"}%>
  <td colspan="3"> FILE options are only relevant for the "file" output format.%BR%
  The FILE format generates a sitemap.xml, and can also generate
  default.htm, index.html and google site verification files.
  </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{file}" else="style='display:none'"}%>
  <td>Google file</td>
  <td>
    <input type="text" name="googlefile" class="twikiInputField" size="40" value="" /><br />
    generates the =HTML verification file= needed to verify your site claim.
    see <a href="http://www.google.com/webmasters/sitemaps/">Google webmaster tools</a> 
  </td>
  <td> =googlefile= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{file}" else="style='display:none'"}%>
  <td>Default topic:</td>
  <td>
    <input type="text" name="defaultpage" class="twikiInputField" size="40" value="WebHome" /><br />
    Name of topic to used to generate default.htm, index.html
  </td>
  <td> =defaultpage= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{file}" else="style='display:none'"}%>
  <td>Relative URL used in sitemap</td>
  <td>
    <input type="text" name="relativeurl" class="twikiInputField" size="40" value="/" /><br />
    the base URL that your published TWiki topics will reside at (if you are publishing to the root of your site, =/= is correct)
    see <a href="http://www.google.com/webmasters/sitemaps/">Google webmaster tools</a> 
  </td>
  <td> =relativeurl= </td>
</tr>
<!-- /"file" output format options -->
<!-- FTP options -->
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <th colspan="3">FTP options</th>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
 <td colspan="3"> FTP options are only relevant if Output format is =ftp= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <td>Destination FTP server</td>
  <td>
    <input type="text" name="destinationftpserver" class="twikiInputField" size="40" value="" /><br />
    Set to blank to proof the output prior to uploading to your site.
  </td>
  <td> =destinationftpserver= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <td>Path to upload to on server</td>
  <td>
    <input type="text" name="destinationftppath" class="twikiInputField" size="40" value="" />
  </td>
  <td> =destinationftppath= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <td>FTP username</td>
  <td>
    <input type="text" name="destinationftpusername" class="twikiInputField" size="40" value="" />
  </td>
  <td> =destinationftpusername= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <td>FTP Password</td>
  <td>
    <input type="password" name="destinationftppassword" class="twikiInputField" size="40" value="" />
  </td>
  <td> =destinationftppassword= </td>
</tr>
<tr %IF{"{PublishContrib}{FormatAllowed}{ftp}" else="style='display:none'"}%>
  <td valign="top">Fast publish</td>
  <td>
    <input type="checkbox" class="" name="fastupload" value="1" /> <br />
    Speed up the ftp publishing by only uploading modified files. This will
    store a (tiny) checksum (.md5) file on the server alongside each uploaded
    file which will be used to optimise future uploads. Recommended.
  </td>
  <td> =fastupload= </td>
</tr>   
<!-- /FTP options -->
<tr>
  <th colspan="3">Other output generator options</th>
</tr>
<tr>
  <td colspan="3">Some output generators support extra options (e.g. for =pdf=, you can add =htmldoc= command-line parameters here, such as =--linkstyle underline=)</td>
</tr>
<tr>
  <td></td>
  <td>
   <textarea name="genopt" rows="5" cols="80" class="twikiTextarea">%URLPARAM{"genopt" default=""}%</textarea>
  </td>
  <td>
   =genopt=
  </td>
</td>
</tr>
<tr>
<td colspan="3" class="twikiLast">
<input type="submit" class="twikiSubmit" value="Publish" />
</td>
</tr>
</table>
</form>
</div>
#WildcardPattern
---+++ Wildcard Patterns
Wildcard patterns are well known to people who are used to command lines on computers, but may be unfamiliar to the Windows generation. A wildcard is a special string that you can put into a filename so that it matches a whole range of files:
| *String* | *What  it does* | *Example* | *What the example matches* |
| * | Matches any string, including an empty string. | =*Cheese*= | Every topic with "Cheese" somewhere in the name (but _not_ "cheese") |
| ? | Matches any single character. | Example1? | Example10 and Example 1X but _not_ example1 |
| [...] | Matches any one of the enclosed characters.  A pair of characters separated by a hyphen denotes a range  expression; any  character that sorts between those two characters, inclusive, using the current locale's collating sequence and character set, is matched.  If the first character following the [ is a ^ then any character not enclosed is matched. A - may be matched by including it as the first or  last  character  in  the set.  A ] may be matched by including it as the first character in the set.<br /> Within  [  and ], character classes can be specified using the syntax [:class:], where class is one of the following classes defined in the POSIX.2 standard: =alnum=, =alpha=, =ascii=, =blank=, =cntrl=, =digit=, =graph=, =lower=, =print=, =punct=, =space=, =upper=, =word=, =xdigit=. A character class matches any character belonging to that class.  The =word= character class matches letters, digits, and the character _. | B[aeiou]g | Bag, Bog, Big, Beg, Bug |

#TopicOrder
---+++ Specifying topic order
You may want to specify the order of topics in a published file.
You can do it by putting inclusion pattern lists separated by semicolon.
Let's say you specify the following as inclusion pattern: %BR%
<pre>
Abc*,Def*;Ghi*
</pre>
Then, topics starting with Abc or Def are put into the output first.
Next, topics starting with Def are put into the output.

More than one pattern lists may match a topic.
Even in that case, a topic isn't included more than once in an output.
For example, the following pattern yields an output having topics starting with Abcd first, then topics starting with Ab but not Abcd because topics starting with Abcd are already included.
<pre>
Abcd*;Ab*
</pre>

#RegularExpression
---+++ Regular Expressions
A perl regular expression. You can use a simple string here, which will be matched exactly, or you can read up on perl regular expressions on the web. 

#PublishTopic
---+++ Using a Publish Topic (configtopic)
You can create a publish topic in a web that contains all the details needed to publish that web. This is just a topic with a series of standard TWiki variable settings (which correspond to the form parameters) in it. You can use the PublishWeb topic in this web as a template for your own topics.

Alternatively you can just take a copy of the form in this topic, paste it into your own topic, and change the defaults.

To use a publish topic, you must pass the =configtopic= parameter to the =publish= script set to the name of the topic to use to control publishing. You can specify a topic in another web using the standard Web.Topic syntax.

---+++ Publishing from the command line
*This is only for TWiki administrators. Not for ordinary users.*

TWiki scripts work as part of the web application while can run from command line. The =publish= script is no exception. If you have necessary permission, just =cd= to the =bin= directory, and
=./publish=. Parameters are passed as name=value pairs, for example:
<verbatim>
./publish web=Book exclusions='Web*' format=file
./publish web=Book inclusions=WebBook format=pdf genopt='--book --duplex --toclevels=5'
</verbatim>
The available parameter names are shown in the example above, in the 'Name' column.

---+++ Controlling which parts of a topic get published
You can control what gets published from a topic using =%<nop>STARTPUBLISH%= and =%<nop>STOPPUBLISH%= control tags:
   * If =%<nop>STARTPUBLISH%= is the first control tag seen in the file, everything before it will be ignored.
   * Everything between =%<nop>STOPPUBLISH%= and the next =%<nop>STARTPUBLISH%= (or the end of the topic) will be ignored.
   * =%<nop>STARTPUBLISH%= and =%<nop>STOPPUBLISH%= will be visible in the viewed topic, so you can easily see what will be published from the topic.
Note: the old &lt;nopublish> tag is deprecated and should be replaced in topics

Another good trick is to set up a special "publishing" web. Create topics in the web that %INCLUDE the topics from *other* webs that you want to publish. You can use [[%TWIKIWEB%.VarSTARTSECTION][STARTSECTION]] and [[%TWIKIWEB%.VarENDSECTION][ENDSECTION]] to highlight what you want published. This way the "publishing" web gives you a view of exactly what will be in the published output, without the need for special publishing tags.

---++ Publishing History
Every time a web is published, then the results of that publishing step are stored in a topic in the web. By default this topic is called =PublishContribHistory=, but you can choose another name (see the form, above). In order to publish a web, you have to be able to write to this topic. If you need to add access controls to the topic, then make sure you do that right at the beginning of the topic, or in the hidden preferences.

The history topics contains a list of all the parameters used, and the versions of the topics that were published, so it is very useful for tracking exactly what you publish. it is written every time you run =publish=.

---++ Links to other webs
You may wonder how inter web links are handled. Here's how.

Let's say you are publishing !WebA and !TopicA has a link to !WebB.TopicB.
Then, on the published page, the link is transformed into
<verbatim>
<a href="../WebB/TopicB">...</a>
</verbatim>

This means that you can make a link from !WebA.TopicA to !WebB.TopicB work on published files with the following steps.
   1. Publish !WebA and !WebB to zip files
   1. Unzip !WebA.zip in the !WebA folder -- if you do the operation on Windows, that's the default behavior.
   1. unzip !WebB.zip in the !WebB folder so that the folders !WebA and !WebB are in the same directory.

---++ Installation Instructions
---+++ Dependencies

Note: If you want to generate PDF files, you will need an installation of =htmldoc=. This program is available from http://www.easysw.com/htmldoc/ for free, but you are *strongly* recommended to buy the commercial version. Your support for open-source projects helps make open-source software possible.

   * For an __automated installation__, run the [[%SCRIPTURL{configure}%][configure]] script and follow "Find More Extensions" in the in the __Extensions__ section.
      * See the [[http://twiki.org/cgi-bin/view/Plugins/BuildContribInstallationSupplement][installation supplement]] on TWiki.org for more information.

   * Or, follow these __manual installation__ steps:
      * Download the ZIP file from the extension home on twiki.org (see below).
      * Unzip ==%TOPIC%.zip== in your twiki installation directory.
      * Set the ownership of the extracted directories and files to the webserver user.
      * Install the dependencies (if any).


Run =configure= and complete the installation in the *PublishContrib* section. If you can't do this for some reason, these are the settings required in !LocalSite.cfg:
%TABLE{columnwidths="300,"}%
| =$TWiki::cfg{PublishContrib}{Dir}= | File path to the directory where published files will be generated. you will normally want this to be visible via a URL, so the TWiki pub directory is a good choice. |
| =$TWiki::cfg{PublishContrib}{URL}= | URL path of the directory you defined above. |
| =$TWiki::cfg{PublishContrib}{ViewUrlBaseRegex}= | Links to other topics may be written in absolute URLs, which is not a good practice but some do anyway. There might be URLs not matching the =TWiki::getScriptURL('view')= value but still work. If you set a regular expression matching such URLs, links having those URLs are properly handled. e.g. =http://twiki(?:-\w+)?.example.com= |
| =$TWiki::cfg{PublishContrib}{FormatAllowed}{file}= | There are several output formats supported by this contrib. Depending on your situation, you provided some formats, while not providing the others. By setting true (typically 1) or false (typically 0) for these variables, you sepecify which formats are provided and which are not. |
| =$TWiki::cfg{PublishContrib}{FormatAllowed}{zip}= |^|
| =$TWiki::cfg{PublishContrib}{FormatAllowed}{tgz}= |^|
| =$TWiki::cfg{PublishContrib}{FormatAllowed}{pdf}= |^|
| =$TWiki::cfg{PublishContrib}{FormatAllowed}{ftp}= |^|
| =$TWiki::cfg{PublishContrib}{PDFCmd}= | Template command-line for the PDF generator program - for example, =htmldoc --webpage --links --linkstyle plain --outfile %FILE&#124;F% %EXTRAS&#124;U% %FILES&#124;F%'= |
| =$TWiki::cfg{PublishContrib}{PluginControl}= | This contrib has a feature to disable TWiki plugins when publishing. But the feature is harmful for Fast CGI and mod_perl. Setting a true value (typically 1) to this turns of the feature. |

---++++ =PDF= output
   1 install htmldoc from http://www.easysw.com/htmldoc/

Note that =htmldoc= can also be used to generate !PostScript by using the =-t= option in the =Other output generator options= above. See the =htmldoc= man pages for details.

---++++ =.tgz= (tar) output
   1 Install Archive::Tar and everything it depends on

---++++ =.zip= output
   1 Install Archive::Zip and everything it depends on

---++ Plugin Info
This add-on started as the TWiki:Plugins/GenHTMLAddon, written by TWiki:Main/CrawfordCurrie at Motorola. It was then rewritten by TWiki:Main/EricScouten, and then fixed and enhanced by TWiki:Main/CrawfordCurrie (http://c-dot.co.uk). It has been further extended by TWiki:Main/SvenDowideit and TWiki:Main/MartinCleaver.

%TABLE{ tablewidth="100%" columnwidths="170," }%
|  Plugin Authors: | TWiki:Main/CrawfordCurrie, TWiki:Main/EricScouten, TWiki:Main.SvenDowideit, TWiki:Main.MartinCleaver |
|  Copyright: |\
 &copy; 2001 Motorola <br />\
 &copy; 2002-2003, Eric Scouten <br />\
 &copy; 2004-2006 Crawford Currie http://c-dot.co.uk <br />\
 &copy; 2006 Martin Cleaver http://www.cleaver.org <br />\
 &copy; 2008-2017, TWiki:TWiki.TWikiContributor |
|  Sponsors: |\
 [[http://www.windriver.com][Wind River Systems]] for the 2005 functionality improvements <br />\
 [[http://www.sabiolabs.com][ =Sabio Labs= ]] for the =pdf= and =tgz= output formats |
|  License: | GPL ([[http://www.gnu.org/copyleft/gpl.html][GNU General Public License]]) |
|  Contrib Version: | 2017-05-18 |
%TWISTY{
 mode="div"
 showlink="Show Change History %ICONURL{toggleopen}%"
 hidelink="Hide Change History %ICONURL{toggleclose}% "
}%
%TABLE{ tablewidth="100%" columnwidths="170," }%
|  2017-05-18 | TWikibug:Item7784: Upgrade code for Perl up to version 5.24 -- Main.HaraldJoerg |
|  2016-01-16 | TWikibug:Item7714: PublishContrib bug fixes and enhancements 2016-01 -- Main.HideyoImazu |
|  27 Oct 2008 | TWikibug:Item5385: Fixed doc for configtopic TWikibug:Item5388: $WEB and $TOPIC were not correct in %IF statements TWikibug:Item5390: remove comments from .css before processing for included resoures TWikibug:Item5706: Improved FTP upload process for incrementally maintained webs TWikibug:Item6029: expand config topic on load to support use of searches TWikibug:Item6030: respect VIEW_TEMPLATE in published topics TWikibug:Item6092: expand common tags in configtopic TWikibug:Item6110: rename settings in config topic to avoid clashes with other plugins |
|  11 Dec 2007 | TWikibug:Item5099 fixed |
|  10 Nov 2007 | Tested on 4.2.0. TWikibug:Item4624:, TWikibug:Item4625: TWikibug:Item4830: fixed. TWikibug:Item4825: added a basic skin to avoid the confusion caused by =text= skin. TWikibug:Item4951: added interface to allow management of output files |
|  13222 | fixed ftp publish, added doco, and added enabled plugin selection funcitonality |
|  13064 | TWikibug:Item3722 worked around core attaching URL params to internal URLs |
|  12961 | TWikibug:Item3671 cannot publish without write access to history topic, so \
  security now checked early. TWikibug:Item3619 Cleaned up error handling from \
  writers. TWikibug:Item3675 added history topic to record changeset. Plus major \
  refactoring of main class to get rid of some of the cruft that had built \
  up from many authors. Item2726: uses getExternalResource now, so should \
  obey proxy settings (untested) |
|  12824 | Added support for new internal api - no user changes |
|  12708 | Added UI for FTP. Added .spec file. Fixed TWikibug:Item3515 and TWikibug:Item2725 |
|  12028 | Michael Daum - create a new TWiki object for every topic, don't reuse the current one (TWikibug:Item3139) |
|  10412 | Correction to the correction for anchors. |
|  10345 | Correction to support anchors in URLs properly |
|  10242 | Martin Cleaver - changes to allow generation of viewprint and viewxxx when specified by TEMPLATE; multiple INSTANCE (dev/test/prod); (TWikibug:Item2269) |
|  10063 | Bugfix TWikibug:Item2216 |
|  10006 | Crawford Currie - fixed problem where it was failing to remove &lt;base> tags completely (TWikibug:Item2200) |
|  9986 | Crawford Currie - added doc on usage from command line, corrected sense of topicsearch filter (TWikibug:Item2120, TWikibug:Item2121), renamed parameters (old ones are still valid), corrected handling of empty web refs (TWikibug:Item2128), deprecated nopublish html-style tag in favour of !PublishWebPlugin-compatible style (though with richer semantics) (TWikibug:Item2196) |
|  9823 | Crawford Currie - added support for hierarchical webs, and inclusion of external images. |
|  9773 | Crawford Currie - added tgz and pdf support |
|  9725 | Michael Daum - fixed rewriting urls; \
                 fixed nested resources issue; \
		 creating a new prefs object for each topic |
|  9713 | Corrected form action so it uses up the right web preferences |
|  9695 | Michael Daum - recursively archive resources imported by css files;\
      fixed several html errors in the !PublishContrib and !PublishWeb topics;\
      removed hardcoded reference to print.pattern |
|  8959 | TWiki-4 version. Also supports publishing to a file area, making TWiki easier to use as a CMS (see also TWiki:Plugins/PublishWebPlugin, which does almost the same thing :-( ) |
|  6276 | TWikibug:Item196 - bugfix for HTTP_HOST, as described in the Dev topic for the contrib |
|  5566 | Changed interface to support wildcards, and lightened the plugin by replacing a lot of files with simpler ways of doing things. |
|  5499 | Added Compress::Zlib dependency, as requested by Brad Taylor |
|  27 Apr 2005 | 1.301 Crawford Currie - fixed minor issues highlighted by Bruce Dillahunty and Scott Claridge |
|  11 Apr 2005 | 1.3 Crawford Currie - reworked the interface and code to work better |
|  13 October 2004 | 1.200 Crawford Currie - Cairo compatible |
|  7 Jan 2003 | 1.1 Initial version |
%ENDTWISTY%
%TABLE{ tablewidth="100%" columnwidths="170," }%
|  Dependencies: | <table border="1"><tr><th>Name</th><th>Version</th><th>Description</th></tr><tr><td align="left">File::Spec</td><td align="left">&gt;0</td><td align="left">Required. Used to analyse URL paths.</td></tr><tr><td align="left">File::Copy</td><td align="left">&gt;0</td><td align="left">Required. Used to move files around.</td></tr><tr><td align="left">File::Path</td><td align="left">&gt;0</td><td align="left">Required to manipulate directories.</td></tr><tr><td align="left">File::Temp</td><td align="left">&gt;0</td><td align="left">Required for temporary files.</td></tr><tr><td align="left">LWP</td><td align="left">&gt;0</td><td align="left">Optional. Used to include images referenced by absolute URLs</td></tr><tr><td align="left">Archive::Zip</td><td align="left">&gt;=0</td><td align="left">Optional. Required to generate .zip output</td></tr><tr><td align="left">Archive::Tar</td><td align="left">&gt;=0</td><td align="left">Optional. Required to generate .tgz output</td></tr><tr><td align="left">Net::FTP</td><td align="left">&gt;0</td><td align="left">Optional. Required for ftp publishing.</td></tr><tr><td align="left">htmldoc</td><td align="left"></td><td align="left">Optional. Required to generate .pdf output</td></tr><tr><td align="left">Digest::MD5</td><td align="left">&gt;0</td><td align="left">Optional. Required for fast upload to ftp servers.</td></tr></table> |
|  Contrib Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |
|  Appraisal: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal |

__Related Topics:__ %SYSTEMWEB%.TWikiPreferences, %SYSTEMWEB%.TWikiPlugins
Attachments
Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
gif	publish.gif	manage	53.3 K	2017-05-18 - 18:42	TWikiAdminUser	Saved by install script
png	wikiringlogo20x20.png	manage	1.3 K	2017-05-18 - 18:42	TWikiAdminUser	Saved by install script
Topic revision: r2 - 2020-05-19 - TWikiAdminUser
TWiki
Copyright &© 1999-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.PublishContrib.