Publish Cops Canvass Report Config

Version Specific Options

Web options

Relative directory Path of a directory relative to {PublishPlugin}{Dir} where you want the output generated. '/' means generate the output directly in {PublishPlugin}{Dir}.
  • Set PUBLISH_RELATIVEDIR = w/pub/Common/CopsCanvassReport/
  • {PublishPlugin}{Dir} = /var/www/vhosts/copswiki.org/httpdocs

Relative URL used in sitemap -- the base URL that your published Foswiki topics will reside at (if you are publishing to the root of your site, / is correct) See Google webmaster tools
  • #Set PUBLISH_RELATIVEURL = /

Output format. Options are file, zip, tgz, pdf, ftp. The output will be generated on the server, in the directory pointed to by the {PublishPlugin}{Dir} configuration setting. You can manage the contents of this directory from the browser using the %PUBLISHERS_CONTROL_CENTRE% macro (See Publish Plugin Control Centre).
NOTE 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.
  • Set PUBLISH_FORMAT = pdf

Generator Options - For file output, "F" means "use flat file structure (i.e. no web/subweb)

  • Set PUBLISH_GENOPT = --no-duplex --numbered --portrait --quiet --titleimage /var/www/vhosts/copswiki.org/www/w/pub/Common/PublishCopsCanvassReport/RoVReportCover.jpg --firstpage p1 --toclevels 4

# --no-links --duplex


Common Options

Web to publish
  • Set PUBLISH_WEB = Common

Inclusions. Comma-separated list of wildcard patterns that match the names of topics to include. Use * for all topics.

Exclusions Comma-separated list of wildcard patterns that match the names of topics to exclude. Leave blank to include all topics.
  • Set PUBLISH_EXCLUSIONS = Web*,Publish*

Versions Name of a topic that contains a table, each row of which maps a topic names to the version of that topic to publish. Leave blank to publish the most recent version of each topic. The table can be generated by a %SEARCH or other macro. For example: | Web.TopicName | 1.33 |. If a topic does not appear in the table, the most recent version will be published.
  • Set PUBLISH_VERSIONS =

Regex Filter A regular expression that will cause a topic to be excluded if the RE matches the topic content. Leave blank to include all topics.
  • Set PUBLISH_FILTER =

Enabled Plugins Comma-separated list of Plugins to enable during publish. Leave blank to enable all plugins. You are recommended to disable any plugins that generate buttons in the output.
  • Set PUBLISH_ENABLEPLUGINS =

Skin for published HTML. The skin provides the template for how topics are published. See Skins for more informations on skins.
You are recommended to pick basic_publish, or plain, or a print skin. Your installation may also offer a special export or publish skin.
IDEA! The view template is used to generate published pages, so view.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=basic_publish to the end of the view URL. Note that the standard VIEW_TEMPLATE template override still works when publishing.
  • Set PUBLISH_SKIN = basic_publish

Publishing history topic. 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.

  • Set PUBLISH_LISTOFALLOWEDWEBS = Common, Events

Web options

Web options are only relevant for web output formats (file and ftp) The web formats generate a sitemap.xml, and can also generate default.htm, index.html and google site verification files.

Google file. generates the HTML verification file needed to verify your site claim. See Google webmaster tools
  • Set PUBLISH_GOOGLEFILE =

Default topic Name of topic to used to generate default.htm, index.html
  • Set PUBLISH_DEFAULTPAGE = Index

Use Pub Attachments - do not worry about attachments in the pub directory, just leave them there and refer to them using absolute links.
  • Set PUBLISH_USEPUBATTACHMENTS = 0

Use Web Prefix - normally, the web/subweb prefix is added to the resulting filename.
  • Set PUBLISH_USEWEBPREFIX = 0


Topic revision: r10 - 12 Feb 2010, RaymondLutz
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Cops? Send feedback