• Do not register here on develop.twiki.org, login with your twiki.org account.
• Use View topic Item7848 for generic doc work for TWiki-6.1.1. Use View topic Item7851 for doc work on extensions that are not part of a release. More... Close
• Anything you create or change in standard webs (Main, TWiki, Sandbox etc) will be automatically reverted on every SVN update.
Does this site look broken?. Use the LitterTray web for test cases.

Item5385: Update docs how to include and exclude topics

Item Form Data

AppliesTo: Component: Priority: CurrentState: WaitingFor: TargetRelease ReleasedIn
Extension PublishContrib Normal Closed TWiki:Main.CrawfordCurrie n/a  

Edit Form Data

Reported By:
Applies To:
Current State:
Waiting For:
Target Release:
Released In:


Read end of topic first.

I have a hard time to tell PublishContrib to exclude a set of topics, notably all topics that start with Web except for WebHome. Actually I don't want to exclude any topic: I just don't want the contrib to assume that I want to export all topics by default. I only want to publish topics that have a certain form.

Current behaviour:

  • the contrib will export all topics of a web when INCLUSIONS and EXCLUSIONS are both set to empty
  • unless I set EXCLUSIONS (or exclusions form field) to *, in that case it will exclude all topics


  • form param exclusions does not work as documented. When I write:
<input type="hidden" name="exclusions" value='%SEARCH{"Web" scope="topic" web="Corporate" topic="Web*" excludetopic="WebHome" nonoise="on" format="$topic" separator=","}%' />

... it does publish topics that have Web in the name.

I think the biggest bug is that all topics are published by default.

Desired behaviour:

  • The contrib will not publish any topic unless I say so
  • I can explicitly set the topics to publish as a list of topic names. For instance: INCLUSIONS=Contact,Search,WebHome,Dictionary
  • If INCLUSIONS is set with a wildcard or fed with a large result set, I can set a list of topics to exclude.

-- TWiki:Main/ArthurClemens - 22 Feb 2008

Working through the code revealed that there is a secret parameter called configtopic. Totally undocumented but essential for having any predictable behaviour. If I remove that param from the form the contrib just publishes the list of topics that are fed to param inclusions.

I am leaving this bug entry because the documentation needs to get fixed:

  • configtopic - what does it do, where do I set it and when do I leave it out
  • Specifying lists of topics: inclusions and exclusions can be fed a list of topics, for example using a SEARCH. Very useful but undocumented.
  • Skins: I found out by plug and pray: you can add any list of skins like mycompany,public,pattern (can't pass a cover however)

-- TWiki:Main.ArthurClemens - 23 Feb 2008

Summary Update docs how to include and exclude topics
ReportedBy TWiki:Main.ArthurClemens

SVN Range TWiki-5.0.0, Wed, 23 Jan 2008, build 16283
AppliesTo Extension
Component PublishContrib
Priority Normal
CurrentState Closed
WaitingFor TWiki:Main.CrawfordCurrie
Checkins TWikirev:17708 TWikirev:17709
TargetRelease n/a

Edit | Attach | Watch | Print version | History: r8 < r7 < r6 < r5 < r4 | Backlinks | Raw View |  Raw edit | More topic actions
Topic revision: r8 - 2010-10-12 - PeterThoeny
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback